@fitchmultz/pi-subagents 0.44.7 → 0.45.0

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 (947) hide show
  1. package/CHANGELOG.md +258 -7
  2. package/LICENSE +1 -0
  3. package/README.md +58 -1483
  4. package/agents/context-builder.md +19 -1
  5. package/agents/debugger.md +10 -3
  6. package/agents/delegate.md +1 -0
  7. package/agents/fixer.md +4 -1
  8. package/agents/oracle.md +13 -2
  9. package/agents/planner.md +14 -3
  10. package/agents/researcher.md +11 -2
  11. package/agents/reviewer-claude.md +11 -2
  12. package/agents/reviewer-gpt.md +12 -2
  13. package/agents/reviewer-ponytail.md +11 -1
  14. package/agents/reviewer-security.md +13 -2
  15. package/agents/reviewer.md +12 -3
  16. package/agents/scout.md +12 -1
  17. package/agents/ui-designer.md +10 -3
  18. package/agents/watcher.md +1 -0
  19. package/agents/worker.md +8 -2
  20. package/agents/writer.md +6 -3
  21. package/dist/agents/agent-defaults.js +9 -0
  22. package/dist/agents/agent-definition.js +196 -0
  23. package/dist/agents/agent-management.js +64 -905
  24. package/dist/agents/agent-scope.js +4 -2
  25. package/dist/agents/agent-selection.js +10 -5
  26. package/dist/agents/agent-serializer.js +55 -67
  27. package/dist/agents/agents.js +75 -716
  28. package/dist/agents/builtin-overrides.js +218 -0
  29. package/dist/agents/chain-serializer.js +3 -367
  30. package/dist/agents/config-values.js +52 -0
  31. package/dist/agents/discovery-paths.js +91 -0
  32. package/dist/agents/frontmatter.js +15 -5
  33. package/dist/agents/identity.js +25 -8
  34. package/dist/agents/json-chain.js +254 -0
  35. package/dist/agents/management-config.js +332 -0
  36. package/dist/agents/management-format.js +231 -0
  37. package/dist/agents/management-persistence.js +287 -0
  38. package/dist/agents/management-targets.js +136 -0
  39. package/dist/agents/management-warnings.js +81 -0
  40. package/dist/agents/markdown-chain.js +210 -0
  41. package/dist/agents/package-agents.js +154 -0
  42. package/dist/agents/skill-files.js +157 -0
  43. package/dist/agents/skill-search-paths.js +246 -0
  44. package/dist/agents/skill-types.js +1 -0
  45. package/dist/agents/skills.js +54 -499
  46. package/dist/extension/acceptance-schema.js +55 -0
  47. package/dist/extension/build-info.js +1 -1
  48. package/dist/extension/chain-schema.js +196 -0
  49. package/dist/extension/child-runtime.js +237 -0
  50. package/dist/extension/compact-tools.js +122 -51
  51. package/dist/extension/config-schema.js +29 -0
  52. package/dist/extension/config.js +27 -11
  53. package/dist/extension/control-notice-schema.js +37 -0
  54. package/dist/extension/control-notices.js +13 -6
  55. package/dist/extension/delegation-bridges.js +43 -0
  56. package/dist/extension/doctor.js +48 -25
  57. package/dist/extension/everyday-schemas.js +207 -0
  58. package/dist/extension/fanout-child.js +18 -319
  59. package/dist/extension/index.js +8 -563
  60. package/dist/extension/message-renderers.js +225 -0
  61. package/dist/extension/nested-control-inbox.js +154 -0
  62. package/dist/extension/parent-runtime.js +339 -0
  63. package/dist/extension/primary-tool.js +69 -0
  64. package/dist/extension/result-snapshot.js +22 -0
  65. package/dist/extension/runtime-reload.js +62 -0
  66. package/dist/extension/runtime-storage.js +43 -0
  67. package/dist/extension/schema-overrides.js +75 -0
  68. package/dist/extension/schemas.js +265 -336
  69. package/dist/extension/tool-input.js +27 -12
  70. package/dist/extension/tool-result.js +19 -4
  71. package/dist/history/answer-texts.js +57 -0
  72. package/dist/history/canonical-result.js +76 -43
  73. package/dist/history/canonical-selection.js +40 -0
  74. package/dist/history/database-generation.js +82 -0
  75. package/dist/history/database.js +57 -33
  76. package/dist/history/entry-ingestion.js +61 -0
  77. package/dist/history/index.js +242 -97
  78. package/dist/history/ingest.js +168 -331
  79. package/dist/history/output-digests.js +40 -0
  80. package/dist/history/preview.js +210 -0
  81. package/dist/history/prune.js +33 -0
  82. package/dist/history/queries.js +60 -349
  83. package/dist/history/query-scope.js +190 -0
  84. package/dist/history/rows.js +77 -0
  85. package/dist/history/run-projection.js +137 -0
  86. package/dist/history/run-queries.js +153 -0
  87. package/dist/history/schema.js +31 -0
  88. package/dist/history/search-queries.js +163 -0
  89. package/dist/history/selected-record.js +108 -0
  90. package/dist/history/source-file.js +45 -0
  91. package/dist/history/source-watches.js +141 -0
  92. package/dist/history/store.js +164 -153
  93. package/dist/history/text-chunks.js +169 -0
  94. package/dist/history/text.js +35 -0
  95. package/dist/history/transcript-queries.js +177 -0
  96. package/dist/history/types.js +5 -1
  97. package/dist/history/values.js +36 -0
  98. package/dist/history/wire-inputs.js +122 -0
  99. package/dist/history/wire-models.js +38 -0
  100. package/dist/history/worker-runtime.js +441 -0
  101. package/dist/history/worker.js +66 -462
  102. package/dist/intercom/intercom-bridge.js +48 -20
  103. package/dist/intercom/live-intercom.js +80 -23
  104. package/dist/intercom/nested-result-tree.js +163 -0
  105. package/dist/intercom/result-delivery.js +40 -0
  106. package/dist/intercom/result-intercom.js +178 -261
  107. package/dist/pi-intercom/agent-dir.js +7 -3
  108. package/dist/pi-intercom/async.js +27 -0
  109. package/dist/pi-intercom/bridge-ask.js +57 -0
  110. package/dist/pi-intercom/bridge-config.js +79 -0
  111. package/dist/pi-intercom/bridge-http.js +86 -0
  112. package/dist/pi-intercom/bridge-protocol.js +106 -0
  113. package/dist/pi-intercom/bridge-routes.js +64 -0
  114. package/dist/pi-intercom/bridge-session.js +416 -0
  115. package/dist/pi-intercom/bridge.js +182 -603
  116. package/dist/pi-intercom/broker/broker.js +236 -244
  117. package/dist/pi-intercom/broker/client.js +189 -304
  118. package/dist/pi-intercom/broker/connection.js +165 -0
  119. package/dist/pi-intercom/broker/framing.js +5 -3
  120. package/dist/pi-intercom/broker/paths.js +4 -1
  121. package/dist/pi-intercom/broker/pid.js +53 -25
  122. package/dist/pi-intercom/broker/snapshot-reader.js +78 -0
  123. package/dist/pi-intercom/broker/snapshots.js +188 -0
  124. package/dist/pi-intercom/broker/spawn.js +36 -25
  125. package/dist/pi-intercom/config.js +85 -71
  126. package/dist/pi-intercom/connection.js +297 -0
  127. package/dist/pi-intercom/identity.js +58 -0
  128. package/dist/pi-intercom/inbound-delivery.js +356 -0
  129. package/dist/pi-intercom/inbound-journal.js +303 -0
  130. package/dist/pi-intercom/inbound-record.js +113 -0
  131. package/dist/pi-intercom/inbound.js +179 -0
  132. package/dist/pi-intercom/index.js +79 -2933
  133. package/dist/pi-intercom/inspection.js +62 -0
  134. package/dist/pi-intercom/interview.js +236 -0
  135. package/dist/pi-intercom/lifecycle.js +168 -0
  136. package/dist/pi-intercom/message-format.js +69 -0
  137. package/dist/pi-intercom/outbound.js +304 -0
  138. package/dist/pi-intercom/peer-awareness.js +66 -0
  139. package/dist/pi-intercom/reply-tracker.js +62 -43
  140. package/dist/pi-intercom/reply-wait.js +201 -0
  141. package/dist/pi-intercom/runtime-types.js +3 -0
  142. package/dist/pi-intercom/session-events.js +180 -0
  143. package/dist/pi-intercom/session-targets.js +42 -34
  144. package/dist/pi-intercom/subagent-events.js +238 -0
  145. package/dist/pi-intercom/subagent-live-events.js +129 -86
  146. package/dist/pi-intercom/supervisor.js +282 -0
  147. package/dist/pi-intercom/tool-arguments.js +74 -0
  148. package/dist/pi-intercom/tool-registration.js +95 -0
  149. package/dist/pi-intercom/tool-results.js +38 -0
  150. package/dist/pi-intercom/tool-schemas.js +82 -0
  151. package/dist/pi-intercom/tools.js +51 -0
  152. package/dist/pi-intercom/topic-actions.js +177 -0
  153. package/dist/pi-intercom/topics.js +177 -92
  154. package/dist/pi-intercom/transport.js +1 -0
  155. package/dist/pi-intercom/types.js +151 -114
  156. package/dist/pi-intercom/ui/compose-paste.js +93 -0
  157. package/dist/pi-intercom/ui/compose.js +121 -143
  158. package/dist/pi-intercom/ui/inline-message.js +59 -59
  159. package/dist/pi-intercom/ui/message-renderers.js +147 -0
  160. package/dist/pi-intercom/ui/overlay.js +181 -0
  161. package/dist/pi-intercom/ui/session-format.js +124 -0
  162. package/dist/pi-intercom/ui/session-list.js +76 -43
  163. package/dist/pi-intercom/ui/tool-renderers.js +110 -0
  164. package/dist/pi-intercom/ui/topic-view.js +88 -0
  165. package/dist/pi-intercom/validation.js +59 -0
  166. package/dist/runs/background/async-chain-plan.js +265 -0
  167. package/dist/runs/background/async-control.js +134 -58
  168. package/dist/runs/background/async-execution.js +136 -633
  169. package/dist/runs/background/async-job-admission.js +40 -0
  170. package/dist/runs/background/async-job-projection.js +169 -0
  171. package/dist/runs/background/async-job-tracker.js +297 -327
  172. package/dist/runs/background/async-launch.js +216 -0
  173. package/dist/runs/background/async-plan.js +116 -0
  174. package/dist/runs/background/async-result-file.js +47 -23
  175. package/dist/runs/background/async-resume.js +195 -253
  176. package/dist/runs/background/async-run-discovery.js +213 -0
  177. package/dist/runs/background/async-run-location.js +135 -0
  178. package/dist/runs/background/async-run-record.js +1 -0
  179. package/dist/runs/background/async-run-repair.js +223 -0
  180. package/dist/runs/background/async-run-summary.js +1 -0
  181. package/dist/runs/background/async-single-plan.js +105 -0
  182. package/dist/runs/background/async-status-projection.js +155 -0
  183. package/dist/runs/background/async-status-render.js +117 -0
  184. package/dist/runs/background/async-status-validation.js +181 -0
  185. package/dist/runs/background/async-status.js +3 -442
  186. package/dist/runs/background/async-value.js +21 -0
  187. package/dist/runs/background/completion-dedupe.js +36 -12
  188. package/dist/runs/background/completion-delivery.js +211 -205
  189. package/dist/runs/background/completion-receipts.js +237 -0
  190. package/dist/runs/background/legacy-status-acceptance.js +34 -0
  191. package/dist/runs/background/notify.js +96 -48
  192. package/dist/runs/background/parallel-groups.js +36 -19
  193. package/dist/runs/background/result-payload.js +178 -0
  194. package/dist/runs/background/result-watcher.js +348 -339
  195. package/dist/runs/background/run-id-resolver.js +53 -33
  196. package/dist/runs/background/run-schemas.js +189 -0
  197. package/dist/runs/background/run-status-contracts.js +14 -0
  198. package/dist/runs/background/run-status-render.js +270 -0
  199. package/dist/runs/background/run-status.js +231 -339
  200. package/dist/runs/background/runner-attempt-output.js +155 -0
  201. package/dist/runs/background/runner-attempt.js +263 -0
  202. package/dist/runs/background/runner-child-executor.js +166 -0
  203. package/dist/runs/background/runner-child-observer.js +192 -0
  204. package/dist/runs/background/runner-completion-summary.js +71 -0
  205. package/dist/runs/background/runner-completion.js +211 -0
  206. package/dist/runs/background/runner-config.js +1 -0
  207. package/dist/runs/background/runner-contract.js +1 -0
  208. package/dist/runs/background/runner-dynamic.js +121 -0
  209. package/dist/runs/background/runner-finalization.js +149 -0
  210. package/dist/runs/background/runner-graph.js +68 -0
  211. package/dist/runs/background/runner-initial-status.js +60 -0
  212. package/dist/runs/background/runner-lifecycle.js +142 -0
  213. package/dist/runs/background/runner-monitor.js +309 -0
  214. package/dist/runs/background/runner-parallel.js +204 -0
  215. package/dist/runs/background/runner-prepare-step.js +86 -0
  216. package/dist/runs/background/runner-reporting.js +153 -0
  217. package/dist/runs/background/runner-status.js +148 -0
  218. package/dist/runs/background/runner-step-output.js +92 -0
  219. package/dist/runs/background/runner-step-record.js +45 -0
  220. package/dist/runs/background/runner-step.js +112 -0
  221. package/dist/runs/background/runner-streaming.js +173 -0
  222. package/dist/runs/background/runner-workflow.js +213 -0
  223. package/dist/runs/background/stale-run-reconciler.js +155 -292
  224. package/dist/runs/background/subagent-runner-launcher.js +33 -13
  225. package/dist/runs/background/subagent-runner.js +51 -1842
  226. package/dist/runs/background/top-level-async.js +2 -1
  227. package/dist/runs/foreground/chain-clarify.js +293 -1017
  228. package/dist/runs/foreground/clarification-draft.js +87 -0
  229. package/dist/runs/foreground/clarify-contracts.js +1 -0
  230. package/dist/runs/foreground/clarify-invocation.js +129 -38
  231. package/dist/runs/foreground/clarify-text-editor.js +210 -0
  232. package/dist/runs/foreground/clarify-view.js +167 -0
  233. package/dist/runs/foreground/execution-input.js +226 -353
  234. package/dist/runs/foreground/execution-routing.js +33 -0
  235. package/dist/runs/foreground/execution-timeout.js +81 -0
  236. package/dist/runs/foreground/foreground-control.js +222 -763
  237. package/dist/runs/foreground/foreground-memory.js +99 -0
  238. package/dist/runs/foreground/invocation-context.js +55 -0
  239. package/dist/runs/foreground/invocation-execution.js +331 -0
  240. package/dist/runs/foreground/invocation-expansion.js +48 -0
  241. package/dist/runs/foreground/management-actions.js +295 -0
  242. package/dist/runs/foreground/nested-control.js +179 -0
  243. package/dist/runs/foreground/question-continuation.js +78 -0
  244. package/dist/runs/foreground/question-control.js +155 -50
  245. package/dist/runs/foreground/resume-target.js +221 -0
  246. package/dist/runs/foreground/revival-launch-policy.js +58 -0
  247. package/dist/runs/foreground/run-async-path.js +190 -178
  248. package/dist/runs/foreground/run-interrupt.js +164 -0
  249. package/dist/runs/foreground/run-nudge.js +278 -0
  250. package/dist/runs/foreground/saved-revival.js +251 -0
  251. package/dist/runs/foreground/subagent-executor.js +135 -424
  252. package/dist/runs/foreground/subagent-params.js +67 -30
  253. package/dist/runs/foreground/wait-observation.js +104 -0
  254. package/dist/runs/foreground/wait-registration.js +17 -0
  255. package/dist/runs/foreground/wait-run.js +283 -123
  256. package/dist/runs/shared/acceptance-contract.js +193 -99
  257. package/dist/runs/shared/acceptance-defaults.js +1 -0
  258. package/dist/runs/shared/acceptance-evaluation.js +201 -181
  259. package/dist/runs/shared/acceptance-finalization.js +256 -180
  260. package/dist/runs/shared/acceptance-outcome.js +53 -0
  261. package/dist/runs/shared/acceptance-reports.js +137 -72
  262. package/dist/runs/shared/acceptance-submission.js +167 -0
  263. package/dist/runs/shared/acceptance-verification.js +100 -0
  264. package/dist/runs/shared/chain-outputs.js +80 -52
  265. package/dist/runs/shared/child-attempt-types.js +1 -0
  266. package/dist/runs/shared/child-attempt.js +314 -667
  267. package/dist/runs/shared/child-boundaries.js +173 -0
  268. package/dist/runs/shared/child-context-filter.js +44 -0
  269. package/dist/runs/shared/child-event-observer.js +390 -0
  270. package/dist/runs/shared/child-execution-cwd.js +73 -43
  271. package/dist/runs/shared/child-execution-outcome.js +72 -0
  272. package/dist/runs/shared/child-invocation.js +54 -0
  273. package/dist/runs/shared/child-message-validation.js +215 -0
  274. package/dist/runs/shared/child-native-accounting.js +106 -0
  275. package/dist/runs/shared/child-native-observation.js +69 -0
  276. package/dist/runs/shared/child-observation-spool.js +164 -0
  277. package/dist/runs/shared/child-observations.js +157 -76
  278. package/dist/runs/shared/child-presence.js +3 -0
  279. package/dist/runs/shared/child-route-env.js +119 -0
  280. package/dist/runs/shared/child-stream-observer.js +221 -0
  281. package/dist/runs/shared/child-stream-projection.js +137 -0
  282. package/dist/runs/shared/child-structured-tool.js +27 -0
  283. package/dist/runs/shared/claude-code.js +121 -158
  284. package/dist/runs/shared/claude-model.js +42 -0
  285. package/dist/runs/shared/claude-session.js +83 -0
  286. package/dist/runs/shared/claude-types.js +1 -0
  287. package/dist/runs/shared/completion-guard.js +18 -18
  288. package/dist/runs/shared/control-event-policy.js +8 -0
  289. package/dist/runs/shared/control-notification-owner.js +13 -0
  290. package/dist/runs/shared/dynamic-fanout.js +188 -173
  291. package/dist/runs/shared/dynamic-item.js +102 -0
  292. package/dist/runs/shared/history-index.js +62 -36
  293. package/dist/runs/shared/legacy-async-recovery.js +114 -0
  294. package/dist/runs/shared/legacy-output-recovery.js +148 -0
  295. package/dist/runs/shared/mcp-config-schema.js +36 -0
  296. package/dist/runs/shared/mcp-direct-tool-allowlist.js +147 -116
  297. package/dist/runs/shared/model-fallback.js +97 -38
  298. package/dist/runs/shared/mutating-tool-guard.js +128 -88
  299. package/dist/runs/shared/native-finalization-types.js +1 -0
  300. package/dist/runs/shared/native-finalization.js +155 -76
  301. package/dist/runs/shared/native-usage.js +238 -98
  302. package/dist/runs/shared/nested-control-records.js +128 -0
  303. package/dist/runs/shared/nested-events.js +8 -700
  304. package/dist/runs/shared/nested-path.js +32 -28
  305. package/dist/runs/shared/nested-projection.js +155 -0
  306. package/dist/runs/shared/nested-protocol.js +18 -0
  307. package/dist/runs/shared/nested-registry.js +191 -0
  308. package/dist/runs/shared/nested-render.js +106 -58
  309. package/dist/runs/shared/nested-route.js +220 -0
  310. package/dist/runs/shared/nested-validation.js +216 -0
  311. package/dist/runs/shared/owned-child-evidence.js +125 -0
  312. package/dist/runs/shared/owned-run-list.js +146 -0
  313. package/dist/runs/shared/owned-run-observation.js +267 -0
  314. package/dist/runs/shared/owned-run-progress.js +109 -0
  315. package/dist/runs/shared/owned-run-read-state.js +1 -0
  316. package/dist/runs/shared/owned-run-results.js +202 -0
  317. package/dist/runs/shared/owned-run-status.js +180 -0
  318. package/dist/runs/shared/owned-run-view.js +51 -0
  319. package/dist/runs/shared/owned-workflow-details.js +17 -0
  320. package/dist/runs/shared/owner-output.js +43 -0
  321. package/dist/runs/shared/parallel-utils.js +36 -28
  322. package/dist/runs/shared/parent-receipts.js +90 -32
  323. package/dist/runs/shared/parent-usage.js +169 -57
  324. package/dist/runs/shared/pi-args.js +108 -201
  325. package/dist/runs/shared/pi-launch-input.js +1 -0
  326. package/dist/runs/shared/pi-session-launch.js +86 -0
  327. package/dist/runs/shared/pi-spawn.js +35 -21
  328. package/dist/runs/shared/run-history-queries.js +126 -35
  329. package/dist/runs/shared/run-history.js +101 -35
  330. package/dist/runs/shared/run-metadata-paths.js +14 -0
  331. package/dist/runs/shared/run-metadata.js +158 -0
  332. package/dist/runs/shared/run-persistence.js +131 -0
  333. package/dist/runs/shared/run-records.js +9 -679
  334. package/dist/runs/shared/run-restoration.js +338 -0
  335. package/dist/runs/shared/run-state-owner.js +26 -0
  336. package/dist/runs/shared/session-cwd-preload.js +27 -18
  337. package/dist/runs/shared/single-output.js +148 -70
  338. package/dist/runs/shared/stable-value.js +15 -0
  339. package/dist/runs/shared/streaming-text.js +23 -12
  340. package/dist/runs/shared/structured-output.js +25 -13
  341. package/dist/runs/shared/subagent-control.js +167 -100
  342. package/dist/runs/shared/subagent-prompt-runtime.js +27 -130
  343. package/dist/runs/shared/subagent-tool-loop-guard.js +81 -52
  344. package/dist/runs/shared/supervisor-question-state.js +145 -0
  345. package/dist/runs/shared/supervisor-questions.js +185 -254
  346. package/dist/runs/shared/workflow-graph.js +259 -167
  347. package/dist/runs/shared/workflow-policy.js +120 -48
  348. package/dist/runs/shared/worktree-contract.js +1 -0
  349. package/dist/runs/shared/worktree-hook.js +138 -0
  350. package/dist/runs/shared/worktree-location.js +47 -0
  351. package/dist/runs/shared/worktree-preservation.js +8 -0
  352. package/dist/runs/shared/worktree-process.js +107 -0
  353. package/dist/runs/shared/worktree.js +183 -322
  354. package/dist/shared/agent-context-policy.js +34 -44
  355. package/dist/shared/agent-dir.js +14 -0
  356. package/dist/shared/artifacts.js +30 -12
  357. package/dist/shared/atomic-json.js +4 -1
  358. package/dist/shared/chain-files.js +72 -0
  359. package/dist/shared/concurrency.js +18 -0
  360. package/dist/shared/content-preview.js +115 -0
  361. package/dist/shared/cooperative.js +5 -2
  362. package/dist/shared/execution-cwd.js +13 -5
  363. package/dist/shared/file-coalescer.js +2 -1
  364. package/dist/shared/fork-context.js +10 -12
  365. package/dist/shared/formatters.js +45 -19
  366. package/dist/shared/journal-frames.js +164 -0
  367. package/dist/shared/journal-projections.js +121 -0
  368. package/dist/shared/journal-reader.js +6 -407
  369. package/dist/shared/json-projection.js +191 -0
  370. package/dist/shared/lazy-tools.js +19 -8
  371. package/dist/shared/message-output.js +116 -0
  372. package/dist/shared/model-info.js +31 -14
  373. package/dist/shared/native-import.js +20 -0
  374. package/dist/shared/native-journal.js +140 -0
  375. package/dist/shared/native-session.js +5 -2
  376. package/dist/shared/native-tui.js +7 -2
  377. package/dist/shared/native-typebox.js +15 -3
  378. package/dist/shared/output-page.js +63 -0
  379. package/dist/shared/post-exit-stdio-guard.js +128 -88
  380. package/dist/shared/prompt-sections.js +2 -0
  381. package/dist/shared/session-entries.js +70 -35
  382. package/dist/shared/session-identity.js +5 -3
  383. package/dist/shared/settings.js +62 -192
  384. package/dist/shared/status-format.js +97 -37
  385. package/dist/shared/task-file-policy.js +24 -0
  386. package/dist/shared/temp-root.js +44 -15
  387. package/dist/shared/types/acceptance.js +1 -0
  388. package/dist/shared/types/async.js +1 -0
  389. package/dist/shared/types/config.js +1 -0
  390. package/dist/shared/types/details.js +1 -0
  391. package/dist/shared/types/history.js +1 -0
  392. package/dist/shared/types/inputs.js +1 -0
  393. package/dist/shared/types/intercom.js +1 -0
  394. package/dist/shared/types/launch.js +1 -0
  395. package/dist/shared/types/messages.js +1 -0
  396. package/dist/shared/types/nested.js +1 -0
  397. package/dist/shared/types/owned-runs.js +1 -0
  398. package/dist/shared/types/progress.js +1 -0
  399. package/dist/shared/types/questions.js +1 -0
  400. package/dist/shared/types/results.js +1 -0
  401. package/dist/shared/types/state.js +1 -0
  402. package/dist/shared/types/usage.js +1 -0
  403. package/dist/shared/types/workflow.js +1 -0
  404. package/dist/shared/types.js +75 -30
  405. package/dist/shared/unknown.js +52 -0
  406. package/dist/shared/utils.js +54 -260
  407. package/dist/slash/command-discovery.js +82 -0
  408. package/dist/slash/command-input.js +190 -0
  409. package/dist/slash/prompt-template-bridge.js +94 -270
  410. package/dist/slash/prompt-template-contract.js +77 -0
  411. package/dist/slash/prompt-template-results.js +125 -0
  412. package/dist/slash/request-protocol.js +68 -0
  413. package/dist/slash/result-delivery.js +237 -0
  414. package/dist/slash/saved-chain.js +78 -0
  415. package/dist/slash/slash-bridge.js +123 -89
  416. package/dist/slash/slash-commands.js +101 -572
  417. package/dist/slash/slash-live-state.js +68 -47
  418. package/dist/tui/action-hints.js +50 -22
  419. package/dist/tui/activity-lines.js +32 -0
  420. package/dist/tui/agent-browser.js +290 -0
  421. package/dist/tui/agent-controls.js +289 -0
  422. package/dist/tui/agent-conversation.js +444 -0
  423. package/dist/tui/agent-dock.js +171 -0
  424. package/dist/tui/agent-history.js +50 -183
  425. package/dist/tui/agent-model.js +62 -0
  426. package/dist/tui/agent-picker.js +262 -0
  427. package/dist/tui/agent-view.js +232 -1564
  428. package/dist/tui/compact-results.js +193 -0
  429. package/dist/tui/conversation-details.js +190 -0
  430. package/dist/tui/conversation-frame.js +135 -0
  431. package/dist/tui/conversation-history.js +201 -0
  432. package/dist/tui/conversation-menu.js +78 -0
  433. package/dist/tui/conversation-notices.js +79 -0
  434. package/dist/tui/conversation-selection.js +58 -0
  435. package/dist/tui/conversation-viewport.js +129 -0
  436. package/dist/tui/direction-message.js +27 -0
  437. package/dist/tui/display.js +282 -0
  438. package/dist/tui/editor-viewport.js +18 -0
  439. package/dist/tui/expanded-content.js +87 -0
  440. package/dist/tui/expanded-multi.js +170 -0
  441. package/dist/tui/expanded-single.js +65 -0
  442. package/dist/tui/history-cards.js +216 -0
  443. package/dist/tui/history-display.js +238 -0
  444. package/dist/tui/history-json.js +16 -0
  445. package/dist/tui/history-metadata.js +152 -0
  446. package/dist/tui/history-record.js +251 -0
  447. package/dist/tui/history-text.js +34 -0
  448. package/dist/tui/indexed-history.js +116 -0
  449. package/dist/tui/nested-widget.js +120 -0
  450. package/dist/tui/picker-page.js +59 -0
  451. package/dist/tui/render.js +58 -1501
  452. package/dist/tui/result-facts.js +64 -0
  453. package/dist/tui/task-observation.js +59 -0
  454. package/dist/tui/task-store.js +366 -0
  455. package/dist/tui/text-values.js +16 -0
  456. package/dist/tui/view-connections.js +47 -0
  457. package/dist/tui/view-model.js +94 -0
  458. package/dist/tui/view-persistence.js +51 -0
  459. package/dist/tui/view-ports.js +1 -0
  460. package/dist/tui/view-session.js +37 -0
  461. package/dist/tui/widget-details.js +144 -0
  462. package/dist/tui/widget-status.js +245 -0
  463. package/dist/tui/widget.js +145 -0
  464. package/dist/tui/workflow-labels.js +223 -0
  465. package/dist/tui/workflow-outcomes.js +124 -0
  466. package/docs/code-quality.md +38 -0
  467. package/docs/development.md +99 -0
  468. package/docs/intercom-bridge.md +22 -17
  469. package/docs/intercom.md +132 -106
  470. package/docs/performance.md +19 -17
  471. package/docs/reference.md +1472 -0
  472. package/generated/RunValidators.d.ts +28 -0
  473. package/generated/RunValidators.js +2 -0
  474. package/package.json +27 -6
  475. package/prompts/parallel-cleanup.md +3 -0
  476. package/prompts/parallel-context-build.md +3 -0
  477. package/prompts/parallel-handoff-plan.md +6 -0
  478. package/prompts/parallel-research.md +4 -0
  479. package/prompts/parallel-review.md +2 -0
  480. package/prompts/review-loop.md +2 -0
  481. package/scripts/build.mjs +129 -85
  482. package/scripts/check-compat.mjs +48 -11
  483. package/scripts/compat-host.mjs +35 -7
  484. package/scripts/generate-run-schemas.mjs +210 -0
  485. package/scripts/intercom-bridge-credentials.mjs +155 -28
  486. package/scripts/intercom-remote.mjs +175 -50
  487. package/scripts/local-install-smoke.mjs +47 -37
  488. package/scripts/native-package-smoke.mjs +135 -25
  489. package/scripts/package-smoke.mjs +360 -140
  490. package/scripts/prepare.mjs +54 -34
  491. package/scripts/real-pi-processes.mjs +261 -0
  492. package/scripts/real-pi-smoke.mjs +432 -351
  493. package/scripts/run-tests.mjs +29 -15
  494. package/skills/pi-intercom/SKILL.md +11 -11
  495. package/skills/pi-intercom/references/peer-sessions.md +7 -2
  496. package/skills/pi-subagents/SKILL.md +1 -1
  497. package/skills/pi-subagents/references/full-orchestration-guide.md +254 -112
  498. package/src/agents/agent-defaults.ts +13 -0
  499. package/src/agents/agent-definition.ts +253 -0
  500. package/src/agents/agent-management.ts +111 -808
  501. package/src/agents/agent-scope.ts +7 -3
  502. package/src/agents/agent-selection.ts +26 -16
  503. package/src/agents/agent-serializer.ts +84 -93
  504. package/src/agents/agents.ts +199 -906
  505. package/src/agents/builtin-overrides.ts +297 -0
  506. package/src/agents/chain-serializer.ts +3 -329
  507. package/src/agents/config-values.ts +57 -0
  508. package/src/agents/discovery-paths.ts +134 -0
  509. package/src/agents/frontmatter.ts +35 -17
  510. package/src/agents/identity.ts +49 -18
  511. package/src/agents/json-chain.ts +305 -0
  512. package/src/agents/management-config.ts +342 -0
  513. package/src/agents/management-format.ts +243 -0
  514. package/src/agents/management-persistence.ts +408 -0
  515. package/src/agents/management-targets.ts +260 -0
  516. package/src/agents/management-warnings.ts +115 -0
  517. package/src/agents/markdown-chain.ts +237 -0
  518. package/src/agents/package-agents.ts +231 -0
  519. package/src/agents/skill-files.ts +182 -0
  520. package/src/agents/skill-search-paths.ts +289 -0
  521. package/src/agents/skill-types.ts +31 -0
  522. package/src/agents/skills.ts +152 -610
  523. package/src/extension/acceptance-schema.ts +88 -0
  524. package/src/extension/chain-schema.ts +276 -0
  525. package/src/extension/child-runtime.ts +302 -0
  526. package/src/extension/compact-tools.ts +259 -102
  527. package/src/extension/config-schema.ts +59 -0
  528. package/src/extension/config.ts +39 -17
  529. package/src/extension/control-notice-schema.ts +55 -0
  530. package/src/extension/control-notices.ts +57 -33
  531. package/src/extension/delegation-bridges.ts +59 -0
  532. package/src/extension/doctor.ts +171 -135
  533. package/src/extension/everyday-schemas.ts +252 -0
  534. package/src/extension/fanout-child.ts +29 -308
  535. package/src/extension/index.ts +17 -642
  536. package/src/extension/message-renderers.ts +334 -0
  537. package/src/extension/nested-control-inbox.ts +196 -0
  538. package/src/extension/parent-runtime.ts +405 -0
  539. package/src/extension/primary-tool.ts +130 -0
  540. package/src/extension/result-snapshot.ts +35 -0
  541. package/src/extension/runtime-reload.ts +72 -0
  542. package/src/extension/runtime-storage.ts +49 -0
  543. package/src/extension/schema-overrides.ts +114 -0
  544. package/src/extension/schemas.ts +451 -418
  545. package/src/extension/tool-input.ts +40 -13
  546. package/src/extension/tool-result.ts +45 -14
  547. package/src/history/answer-texts.ts +74 -0
  548. package/src/history/canonical-result.ts +127 -51
  549. package/src/history/canonical-selection.ts +54 -0
  550. package/src/history/database-generation.ts +86 -0
  551. package/src/history/database.ts +86 -48
  552. package/src/history/entry-ingestion.ts +129 -0
  553. package/src/history/index.ts +426 -148
  554. package/src/history/ingest.ts +372 -342
  555. package/src/history/output-digests.ts +41 -0
  556. package/src/history/preview.ts +235 -0
  557. package/src/history/prune.ts +48 -0
  558. package/src/history/queries.ts +122 -256
  559. package/src/history/query-scope.ts +278 -0
  560. package/src/history/rows.ts +118 -0
  561. package/src/history/run-projection.ts +164 -0
  562. package/src/history/run-queries.ts +199 -0
  563. package/src/history/schema.ts +34 -0
  564. package/src/history/search-queries.ts +216 -0
  565. package/src/history/selected-record.ts +140 -0
  566. package/src/history/source-file.ts +51 -0
  567. package/src/history/source-watches.ts +156 -0
  568. package/src/history/store.ts +310 -197
  569. package/src/history/text-chunks.ts +181 -0
  570. package/src/history/text.ts +43 -0
  571. package/src/history/transcript-queries.ts +251 -0
  572. package/src/history/types.ts +27 -164
  573. package/src/history/values.ts +36 -0
  574. package/src/history/wire-inputs.ts +141 -0
  575. package/src/history/wire-models.ts +51 -0
  576. package/src/history/worker-runtime.ts +502 -0
  577. package/src/history/worker.ts +94 -336
  578. package/src/intercom/intercom-bridge.ts +136 -69
  579. package/src/intercom/live-intercom.ts +197 -92
  580. package/src/intercom/nested-result-tree.ts +213 -0
  581. package/src/intercom/result-delivery.ts +56 -0
  582. package/src/intercom/result-intercom.ts +364 -382
  583. package/src/pi-intercom/agent-dir.ts +9 -3
  584. package/src/pi-intercom/async.ts +33 -0
  585. package/src/pi-intercom/bridge-ask.ts +64 -0
  586. package/src/pi-intercom/bridge-config.ts +101 -0
  587. package/src/pi-intercom/bridge-http.ts +97 -0
  588. package/src/pi-intercom/bridge-protocol.ts +123 -0
  589. package/src/pi-intercom/bridge-routes.ts +90 -0
  590. package/src/pi-intercom/bridge-session.ts +506 -0
  591. package/src/pi-intercom/bridge.ts +258 -547
  592. package/src/pi-intercom/broker/broker.ts +326 -263
  593. package/src/pi-intercom/broker/client.ts +273 -354
  594. package/src/pi-intercom/broker/connection.ts +192 -0
  595. package/src/pi-intercom/broker/framing.ts +11 -6
  596. package/src/pi-intercom/broker/paths.ts +28 -25
  597. package/src/pi-intercom/broker/pid.ts +68 -24
  598. package/src/pi-intercom/broker/snapshot-reader.ts +91 -0
  599. package/src/pi-intercom/broker/snapshots.ts +241 -0
  600. package/src/pi-intercom/broker/spawn.ts +58 -34
  601. package/src/pi-intercom/config.ts +113 -108
  602. package/src/pi-intercom/connection.ts +346 -0
  603. package/src/pi-intercom/identity.ts +71 -0
  604. package/src/pi-intercom/inbound-delivery.ts +450 -0
  605. package/src/pi-intercom/inbound-journal.ts +350 -0
  606. package/src/pi-intercom/inbound-record.ts +141 -0
  607. package/src/pi-intercom/inbound.ts +237 -0
  608. package/src/pi-intercom/index.ts +86 -2923
  609. package/src/pi-intercom/inspection.ts +82 -0
  610. package/src/pi-intercom/interview.ts +295 -0
  611. package/src/pi-intercom/lifecycle.ts +183 -0
  612. package/src/pi-intercom/message-format.ts +77 -0
  613. package/src/pi-intercom/outbound.ts +418 -0
  614. package/src/pi-intercom/peer-awareness.ts +84 -0
  615. package/src/pi-intercom/reply-tracker.ts +121 -59
  616. package/src/pi-intercom/reply-wait.ts +247 -0
  617. package/src/pi-intercom/runtime-types.ts +97 -0
  618. package/src/pi-intercom/session-events.ts +247 -0
  619. package/src/pi-intercom/session-targets.ts +124 -72
  620. package/src/pi-intercom/subagent-events.ts +299 -0
  621. package/src/pi-intercom/subagent-live-events.ts +212 -109
  622. package/src/pi-intercom/supervisor.ts +362 -0
  623. package/src/pi-intercom/tool-arguments.ts +120 -0
  624. package/src/pi-intercom/tool-registration.ts +121 -0
  625. package/src/pi-intercom/tool-results.ts +54 -0
  626. package/src/pi-intercom/tool-schemas.ts +134 -0
  627. package/src/pi-intercom/tools.ts +80 -0
  628. package/src/pi-intercom/topic-actions.ts +243 -0
  629. package/src/pi-intercom/topics.ts +267 -121
  630. package/src/pi-intercom/transport.ts +14 -0
  631. package/src/pi-intercom/types.ts +288 -190
  632. package/src/pi-intercom/ui/compose-paste.ts +109 -0
  633. package/src/pi-intercom/ui/compose.ts +173 -157
  634. package/src/pi-intercom/ui/inline-message.ts +80 -62
  635. package/src/pi-intercom/ui/message-renderers.ts +182 -0
  636. package/src/pi-intercom/ui/overlay.ts +238 -0
  637. package/src/pi-intercom/ui/session-format.ts +146 -0
  638. package/src/pi-intercom/ui/session-list.ts +145 -62
  639. package/src/pi-intercom/ui/tool-renderers.ts +148 -0
  640. package/src/pi-intercom/ui/topic-view.ts +107 -0
  641. package/src/pi-intercom/validation.ts +69 -0
  642. package/src/runs/background/async-chain-plan.ts +451 -0
  643. package/src/runs/background/async-control.ts +201 -71
  644. package/src/runs/background/async-execution.ts +206 -829
  645. package/src/runs/background/async-job-admission.ts +54 -0
  646. package/src/runs/background/async-job-projection.ts +225 -0
  647. package/src/runs/background/async-job-tracker.ts +416 -360
  648. package/src/runs/background/async-launch.ts +319 -0
  649. package/src/runs/background/async-plan.ts +285 -0
  650. package/src/runs/background/async-result-file.ts +79 -37
  651. package/src/runs/background/async-resume.ts +338 -285
  652. package/src/runs/background/async-run-discovery.ts +270 -0
  653. package/src/runs/background/async-run-location.ts +194 -0
  654. package/src/runs/background/async-run-record.ts +14 -0
  655. package/src/runs/background/async-run-repair.ts +307 -0
  656. package/src/runs/background/async-run-summary.ts +71 -0
  657. package/src/runs/background/async-single-plan.ts +168 -0
  658. package/src/runs/background/async-status-projection.ts +188 -0
  659. package/src/runs/background/async-status-render.ts +164 -0
  660. package/src/runs/background/async-status-validation.ts +238 -0
  661. package/src/runs/background/async-status.ts +9 -481
  662. package/src/runs/background/async-value.ts +29 -0
  663. package/src/runs/background/completion-dedupe.ts +103 -54
  664. package/src/runs/background/completion-delivery.ts +313 -187
  665. package/src/runs/background/completion-receipts.ts +309 -0
  666. package/src/runs/background/legacy-status-acceptance.ts +38 -0
  667. package/src/runs/background/notify.ts +167 -106
  668. package/src/runs/background/parallel-groups.ts +95 -46
  669. package/src/runs/background/result-payload.ts +268 -0
  670. package/src/runs/background/result-watcher.ts +484 -387
  671. package/src/runs/background/run-id-resolver.ts +126 -57
  672. package/src/runs/background/run-schemas.ts +240 -0
  673. package/src/runs/background/run-status-contracts.ts +46 -0
  674. package/src/runs/background/run-status-render.ts +364 -0
  675. package/src/runs/background/run-status.ts +338 -356
  676. package/src/runs/background/runner-attempt-output.ts +281 -0
  677. package/src/runs/background/runner-attempt.ts +354 -0
  678. package/src/runs/background/runner-child-executor.ts +232 -0
  679. package/src/runs/background/runner-child-observer.ts +270 -0
  680. package/src/runs/background/runner-completion-summary.ts +106 -0
  681. package/src/runs/background/runner-completion.ts +274 -0
  682. package/src/runs/background/runner-config.ts +52 -0
  683. package/src/runs/background/runner-contract.ts +51 -0
  684. package/src/runs/background/runner-dynamic.ts +185 -0
  685. package/src/runs/background/runner-finalization.ts +203 -0
  686. package/src/runs/background/runner-graph.ts +91 -0
  687. package/src/runs/background/runner-initial-status.ts +72 -0
  688. package/src/runs/background/runner-lifecycle.ts +159 -0
  689. package/src/runs/background/runner-monitor.ts +399 -0
  690. package/src/runs/background/runner-parallel.ts +280 -0
  691. package/src/runs/background/runner-prepare-step.ts +128 -0
  692. package/src/runs/background/runner-reporting.ts +192 -0
  693. package/src/runs/background/runner-status.ts +220 -0
  694. package/src/runs/background/runner-step-output.ts +158 -0
  695. package/src/runs/background/runner-step-record.ts +76 -0
  696. package/src/runs/background/runner-step.ts +150 -0
  697. package/src/runs/background/runner-streaming.ts +220 -0
  698. package/src/runs/background/runner-workflow.ts +284 -0
  699. package/src/runs/background/stale-run-reconciler.ts +279 -336
  700. package/src/runs/background/subagent-runner-launcher.ts +67 -35
  701. package/src/runs/background/subagent-runner.ts +80 -2048
  702. package/src/runs/background/top-level-async.ts +9 -7
  703. package/src/runs/foreground/chain-clarify.ts +499 -1334
  704. package/src/runs/foreground/clarification-draft.ts +92 -0
  705. package/src/runs/foreground/clarify-contracts.ts +33 -0
  706. package/src/runs/foreground/clarify-invocation.ts +192 -65
  707. package/src/runs/foreground/clarify-text-editor.ts +229 -0
  708. package/src/runs/foreground/clarify-view.ts +222 -0
  709. package/src/runs/foreground/execution-input.ts +358 -424
  710. package/src/runs/foreground/execution-routing.ts +41 -0
  711. package/src/runs/foreground/execution-timeout.ts +92 -0
  712. package/src/runs/foreground/foreground-control.ts +333 -812
  713. package/src/runs/foreground/foreground-memory.ts +132 -0
  714. package/src/runs/foreground/invocation-context.ts +88 -0
  715. package/src/runs/foreground/invocation-execution.ts +465 -0
  716. package/src/runs/foreground/invocation-expansion.ts +58 -0
  717. package/src/runs/foreground/management-actions.ts +360 -0
  718. package/src/runs/foreground/nested-control.ts +248 -0
  719. package/src/runs/foreground/question-continuation.ts +112 -0
  720. package/src/runs/foreground/question-control.ts +297 -70
  721. package/src/runs/foreground/resume-target.ts +330 -0
  722. package/src/runs/foreground/revival-launch-policy.ts +112 -0
  723. package/src/runs/foreground/run-async-path.ts +307 -223
  724. package/src/runs/foreground/run-interrupt.ts +202 -0
  725. package/src/runs/foreground/run-nudge.ts +355 -0
  726. package/src/runs/foreground/saved-revival.ts +356 -0
  727. package/src/runs/foreground/subagent-executor.ts +195 -493
  728. package/src/runs/foreground/subagent-params.ts +314 -242
  729. package/src/runs/foreground/wait-observation.ts +160 -0
  730. package/src/runs/foreground/wait-registration.ts +18 -0
  731. package/src/runs/foreground/wait-run.ts +361 -119
  732. package/src/runs/shared/acceptance-contract.ts +410 -209
  733. package/src/runs/shared/acceptance-defaults.ts +1 -0
  734. package/src/runs/shared/acceptance-evaluation.ts +314 -240
  735. package/src/runs/shared/acceptance-finalization.ts +447 -305
  736. package/src/runs/shared/acceptance-outcome.ts +69 -0
  737. package/src/runs/shared/acceptance-reports.ts +220 -126
  738. package/src/runs/shared/acceptance-submission.ts +251 -0
  739. package/src/runs/shared/acceptance-verification.ts +118 -0
  740. package/src/runs/shared/acceptance.ts +25 -25
  741. package/src/runs/shared/chain-outputs.ts +190 -98
  742. package/src/runs/shared/child-attempt-types.ts +118 -0
  743. package/src/runs/shared/child-attempt.ts +372 -608
  744. package/src/runs/shared/child-boundaries.ts +217 -0
  745. package/src/runs/shared/child-context-filter.ts +53 -0
  746. package/src/runs/shared/child-event-observer.ts +496 -0
  747. package/src/runs/shared/child-execution-cwd.ts +139 -68
  748. package/src/runs/shared/child-execution-outcome.ts +103 -0
  749. package/src/runs/shared/child-invocation.ts +74 -0
  750. package/src/runs/shared/child-message-validation.ts +233 -0
  751. package/src/runs/shared/child-native-accounting.ts +154 -0
  752. package/src/runs/shared/child-native-observation.ts +79 -0
  753. package/src/runs/shared/child-observation-spool.ts +188 -0
  754. package/src/runs/shared/child-observations.ts +219 -89
  755. package/src/runs/shared/child-presence.ts +6 -0
  756. package/src/runs/shared/child-route-env.ts +142 -0
  757. package/src/runs/shared/child-stream-observer.ts +302 -0
  758. package/src/runs/shared/child-stream-projection.ts +160 -0
  759. package/src/runs/shared/child-structured-tool.ts +38 -0
  760. package/src/runs/shared/claude-code.ts +201 -228
  761. package/src/runs/shared/claude-model.ts +67 -0
  762. package/src/runs/shared/claude-session.ts +124 -0
  763. package/src/runs/shared/claude-types.ts +31 -0
  764. package/src/runs/shared/completion-guard.ts +35 -26
  765. package/src/runs/shared/control-event-policy.ts +15 -0
  766. package/src/runs/shared/control-notification-owner.ts +20 -0
  767. package/src/runs/shared/dynamic-fanout.ts +402 -238
  768. package/src/runs/shared/dynamic-item.ts +114 -0
  769. package/src/runs/shared/history-index.ts +112 -51
  770. package/src/runs/shared/legacy-async-recovery.ts +153 -0
  771. package/src/runs/shared/legacy-output-recovery.ts +214 -0
  772. package/src/runs/shared/mcp-config-schema.ts +46 -0
  773. package/src/runs/shared/mcp-direct-tool-allowlist.ts +396 -307
  774. package/src/runs/shared/model-fallback.ts +302 -180
  775. package/src/runs/shared/mutating-tool-guard.ts +259 -158
  776. package/src/runs/shared/native-finalization-types.ts +29 -0
  777. package/src/runs/shared/native-finalization.ts +233 -109
  778. package/src/runs/shared/native-usage.ts +379 -96
  779. package/src/runs/shared/nested-control-records.ts +178 -0
  780. package/src/runs/shared/nested-events.ts +45 -752
  781. package/src/runs/shared/nested-path.ts +47 -34
  782. package/src/runs/shared/nested-projection.ts +230 -0
  783. package/src/runs/shared/nested-protocol.ts +67 -0
  784. package/src/runs/shared/nested-registry.ts +273 -0
  785. package/src/runs/shared/nested-render.ts +198 -100
  786. package/src/runs/shared/nested-route.ts +292 -0
  787. package/src/runs/shared/nested-validation.ts +291 -0
  788. package/src/runs/shared/owned-child-evidence.ts +184 -0
  789. package/src/runs/shared/owned-run-list.ts +187 -0
  790. package/src/runs/shared/owned-run-observation.ts +368 -0
  791. package/src/runs/shared/owned-run-progress.ts +172 -0
  792. package/src/runs/shared/owned-run-read-state.ts +7 -0
  793. package/src/runs/shared/owned-run-results.ts +289 -0
  794. package/src/runs/shared/owned-run-status.ts +239 -0
  795. package/src/runs/shared/owned-run-view.ts +65 -0
  796. package/src/runs/shared/owned-workflow-details.ts +24 -0
  797. package/src/runs/shared/owner-output.ts +73 -0
  798. package/src/runs/shared/parallel-utils.ts +93 -129
  799. package/src/runs/shared/parent-receipts.ts +177 -50
  800. package/src/runs/shared/parent-usage.ts +314 -91
  801. package/src/runs/shared/pi-args.ts +241 -311
  802. package/src/runs/shared/pi-launch-input.ts +48 -0
  803. package/src/runs/shared/pi-session-launch.ts +94 -0
  804. package/src/runs/shared/pi-spawn.ts +57 -33
  805. package/src/runs/shared/run-history-queries.ts +189 -38
  806. package/src/runs/shared/run-history.ts +197 -76
  807. package/src/runs/shared/run-id-ambiguity.ts +7 -3
  808. package/src/runs/shared/run-metadata-paths.ts +17 -0
  809. package/src/runs/shared/run-metadata.ts +240 -0
  810. package/src/runs/shared/run-persistence.ts +181 -0
  811. package/src/runs/shared/run-records.ts +19 -607
  812. package/src/runs/shared/run-restoration.ts +455 -0
  813. package/src/runs/shared/run-state-owner.ts +31 -0
  814. package/src/runs/shared/session-cwd-preload.ts +39 -19
  815. package/src/runs/shared/single-output.ts +358 -205
  816. package/src/runs/shared/stable-value.ts +15 -0
  817. package/src/runs/shared/streaming-text.ts +39 -12
  818. package/src/runs/shared/structured-output.ts +76 -46
  819. package/src/runs/shared/subagent-control.ts +330 -197
  820. package/src/runs/shared/subagent-prompt-runtime.ts +92 -174
  821. package/src/runs/shared/subagent-tool-loop-guard.ts +118 -68
  822. package/src/runs/shared/supervisor-question-state.ts +221 -0
  823. package/src/runs/shared/supervisor-questions.ts +396 -401
  824. package/src/runs/shared/workflow-graph.ts +400 -198
  825. package/src/runs/shared/workflow-policy.ts +245 -110
  826. package/src/runs/shared/worktree-contract.ts +29 -0
  827. package/src/runs/shared/worktree-hook.ts +181 -0
  828. package/src/runs/shared/worktree-location.ts +61 -0
  829. package/src/runs/shared/worktree-preservation.ts +10 -0
  830. package/src/runs/shared/worktree-process.ts +132 -0
  831. package/src/runs/shared/worktree.ts +459 -587
  832. package/src/shared/agent-context-policy.ts +176 -145
  833. package/src/shared/agent-dir.ts +15 -0
  834. package/src/shared/artifacts.ts +99 -68
  835. package/src/shared/atomic-json.ts +14 -11
  836. package/src/shared/chain-files.ts +72 -0
  837. package/src/shared/concurrency.ts +27 -0
  838. package/src/shared/content-preview.ts +117 -0
  839. package/src/shared/cooperative.ts +17 -13
  840. package/src/shared/execution-cwd.ts +34 -9
  841. package/src/shared/file-coalescer.ts +24 -22
  842. package/src/shared/fork-context.ts +52 -48
  843. package/src/shared/formatters.ts +88 -47
  844. package/src/shared/journal-frames.ts +197 -0
  845. package/src/shared/journal-projections.ts +133 -0
  846. package/src/shared/journal-reader.ts +18 -333
  847. package/src/shared/json-projection.ts +224 -0
  848. package/src/shared/lazy-tools.ts +76 -27
  849. package/src/shared/message-output.ts +146 -0
  850. package/src/shared/model-info.ts +94 -58
  851. package/src/shared/native-import.ts +25 -0
  852. package/src/shared/native-journal.ts +172 -0
  853. package/src/shared/native-session.ts +8 -3
  854. package/src/shared/native-tui.ts +13 -3
  855. package/src/shared/native-typebox.ts +18 -3
  856. package/src/shared/output-page.ts +76 -0
  857. package/src/shared/post-exit-stdio-guard.ts +232 -172
  858. package/src/shared/prompt-sections.ts +13 -7
  859. package/src/shared/session-entries.ts +103 -44
  860. package/src/shared/session-identity.ts +17 -10
  861. package/src/shared/settings.ts +182 -367
  862. package/src/shared/status-format.ts +207 -98
  863. package/src/shared/stream-json.d.ts +10 -0
  864. package/src/shared/task-file-policy.ts +35 -0
  865. package/src/shared/temp-root.ts +122 -71
  866. package/src/shared/types/acceptance.ts +149 -0
  867. package/src/shared/types/async.ts +247 -0
  868. package/src/shared/types/config.ts +139 -0
  869. package/src/shared/types/details.ts +104 -0
  870. package/src/shared/types/history.ts +217 -0
  871. package/src/shared/types/inputs.ts +4 -0
  872. package/src/shared/types/intercom.ts +57 -0
  873. package/src/shared/types/launch.ts +39 -0
  874. package/src/shared/types/messages.ts +104 -0
  875. package/src/shared/types/nested.ts +153 -0
  876. package/src/shared/types/owned-runs.ts +148 -0
  877. package/src/shared/types/progress.ts +106 -0
  878. package/src/shared/types/questions.ts +103 -0
  879. package/src/shared/types/results.ts +119 -0
  880. package/src/shared/types/state.ts +56 -0
  881. package/src/shared/types/usage.ts +36 -0
  882. package/src/shared/types/workflow.ts +187 -0
  883. package/src/shared/types.ts +222 -1161
  884. package/src/shared/ui-mode.ts +1 -1
  885. package/src/shared/unknown.ts +59 -0
  886. package/src/shared/utils.ts +111 -305
  887. package/src/slash/command-discovery.ts +109 -0
  888. package/src/slash/command-input.ts +232 -0
  889. package/src/slash/prompt-template-bridge.ts +153 -400
  890. package/src/slash/prompt-template-contract.ts +152 -0
  891. package/src/slash/prompt-template-results.ts +189 -0
  892. package/src/slash/request-protocol.ts +87 -0
  893. package/src/slash/result-delivery.ts +312 -0
  894. package/src/slash/saved-chain.ts +115 -0
  895. package/src/slash/slash-bridge.ts +202 -156
  896. package/src/slash/slash-commands.ts +176 -598
  897. package/src/slash/slash-live-state.ts +287 -229
  898. package/src/tui/action-hints.ts +147 -61
  899. package/src/tui/activity-lines.ts +40 -0
  900. package/src/tui/agent-browser.ts +354 -0
  901. package/src/tui/agent-controls.ts +355 -0
  902. package/src/tui/agent-conversation.ts +514 -0
  903. package/src/tui/agent-dock.ts +250 -0
  904. package/src/tui/agent-history.ts +78 -203
  905. package/src/tui/agent-model.ts +78 -0
  906. package/src/tui/agent-picker.ts +325 -0
  907. package/src/tui/agent-view.ts +391 -1333
  908. package/src/tui/compact-results.ts +342 -0
  909. package/src/tui/conversation-details.ts +206 -0
  910. package/src/tui/conversation-frame.ts +184 -0
  911. package/src/tui/conversation-history.ts +246 -0
  912. package/src/tui/conversation-menu.ts +119 -0
  913. package/src/tui/conversation-notices.ts +116 -0
  914. package/src/tui/conversation-selection.ts +66 -0
  915. package/src/tui/conversation-viewport.ts +169 -0
  916. package/src/tui/direction-message.ts +35 -0
  917. package/src/tui/display.ts +409 -0
  918. package/src/tui/editor-viewport.ts +19 -0
  919. package/src/tui/expanded-content.ts +134 -0
  920. package/src/tui/expanded-multi.ts +264 -0
  921. package/src/tui/expanded-single.ts +92 -0
  922. package/src/tui/history-cards.ts +316 -0
  923. package/src/tui/history-display.ts +334 -0
  924. package/src/tui/history-json.ts +17 -0
  925. package/src/tui/history-metadata.ts +177 -0
  926. package/src/tui/history-record.ts +321 -0
  927. package/src/tui/history-text.ts +34 -0
  928. package/src/tui/indexed-history.ts +149 -0
  929. package/src/tui/nested-widget.ts +192 -0
  930. package/src/tui/picker-page.ts +80 -0
  931. package/src/tui/render.ts +100 -1546
  932. package/src/tui/result-facts.ts +99 -0
  933. package/src/tui/task-observation.ts +96 -0
  934. package/src/tui/task-store.ts +432 -0
  935. package/src/tui/text-values.ts +20 -0
  936. package/src/tui/view-connections.ts +64 -0
  937. package/src/tui/view-model.ts +181 -0
  938. package/src/tui/view-persistence.ts +57 -0
  939. package/src/tui/view-ports.ts +55 -0
  940. package/src/tui/view-session.ts +42 -0
  941. package/src/tui/widget-details.ts +220 -0
  942. package/src/tui/widget-status.ts +331 -0
  943. package/src/tui/widget.ts +208 -0
  944. package/src/tui/workflow-labels.ts +340 -0
  945. package/src/tui/workflow-outcomes.ts +150 -0
  946. package/tsconfig.build.json +11 -10
  947. package/tsconfig.json +30 -17
@@ -1,1515 +1,72 @@
1
- /**
2
- * Rendering functions for subagent results
3
- */
4
- import * as path from "node:path";
5
- import { getMarkdownTheme, keyText } from "@earendil-works/pi-coding-agent";
6
- import { Container, Markdown, Spacer, Text, TruncatedText, visibleWidth } from "@earendil-works/pi-tui";
7
- import { MAX_WIDGET_JOBS, WIDGET_KEY, } from "../shared/types.js";
8
- import { formatTokens, formatUsage, formatDuration, formatModelThinking, formatToolCall, shortenPath } from "../shared/formatters.js";
9
- import { getDisplayItems, getSingleResultOutput } from "../shared/utils.js";
10
- import { flatToLogicalStepIndex } from "../runs/background/parallel-groups.js";
11
- import { formatNestedAggregate } from "../runs/shared/nested-render.js";
12
- import { aggregateStepStatus, formatActivityLabel, formatAgentRunningLabel, formatParallelOutcome } from "../shared/status-format.js";
13
- import { acceptanceHumanAction } from "../runs/shared/acceptance.js";
14
- import { formatAgentProcessExit } from "../shared/status-format.js";
15
- import { isTuiContext } from "../shared/ui-mode.js";
16
- function getTermWidth() {
17
- return process.stdout.columns || 120;
18
- }
19
- const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
20
- /**
21
- * Truncate a line to maxWidth, preserving ANSI styling through the ellipsis.
22
- *
23
- * pi-tui's truncateToWidth adds \x1b[0m before ellipsis which resets all styling,
24
- * causing background color bleed in the TUI. This implementation tracks active
25
- * ANSI styles and re-applies them before the ellipsis.
26
- *
27
- * Uses Intl.Segmenter for proper Unicode/emoji handling (not char-by-char).
28
- */
29
- function truncLine(text, maxWidth) {
30
- if (visibleWidth(text) <= maxWidth)
31
- return text;
32
- const targetWidth = maxWidth - 1;
33
- let result = "";
34
- let currentWidth = 0;
35
- let activeStyles = [];
36
- let i = 0;
37
- while (i < text.length) {
38
- const ansiMatch = text.slice(i).match(/^\x1b\[[0-9;]*m/);
39
- if (ansiMatch) {
40
- const code = ansiMatch[0];
41
- result += code;
42
- if (code === "\x1b[0m" || code === "\x1b[m") {
43
- activeStyles = [];
44
- }
45
- else {
46
- activeStyles.push(code);
47
- }
48
- i += code.length;
49
- continue;
50
- }
51
- let end = i;
52
- while (end < text.length && !text.slice(end).match(/^\x1b\[[0-9;]*m/)) {
53
- end++;
54
- }
55
- const textPortion = text.slice(i, end);
56
- for (const seg of segmenter.segment(textPortion)) {
57
- const grapheme = seg.segment;
58
- const graphemeWidth = visibleWidth(grapheme);
59
- if (currentWidth + graphemeWidth > targetWidth) {
60
- return result + activeStyles.join("") + "…";
61
- }
62
- result += grapheme;
63
- currentWidth += graphemeWidth;
64
- }
65
- i = end;
66
- }
67
- return result + activeStyles.join("") + "…";
68
- }
69
- const RUNNING_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
70
- const STATIC_RUNNING_GLYPH = "●";
71
- function runningSeed(...values) {
72
- let seed;
73
- for (const value of values) {
74
- if (value === undefined || !Number.isFinite(value))
75
- continue;
76
- seed = (seed ?? 0) + Math.trunc(value);
77
- }
78
- return seed;
79
- }
80
- function runningGlyph(seed) {
81
- if (seed === undefined)
82
- return STATIC_RUNNING_GLYPH;
83
- return RUNNING_FRAMES[Math.abs(seed) % RUNNING_FRAMES.length];
84
- }
85
- function progressRunningSeed(progress) {
86
- if (!progress)
87
- return undefined;
88
- return runningSeed(progress.index, progress.toolCount, progress.tokens, progress.durationMs, progress.lastActivityAt, progress.currentToolStartedAt, progress.turnCount);
89
- }
90
- function extractOutputTarget(task) {
91
- const writeToMatch = task.match(/\[Write to:\s*([^\]\n]+)\]/i);
92
- if (writeToMatch?.[1]?.trim())
93
- return writeToMatch[1].trim();
94
- const findingsMatch = task.match(/Write your findings to:\s*(\S+)/i);
95
- if (findingsMatch?.[1]?.trim())
96
- return findingsMatch[1].trim();
97
- const outputMatch = task.match(/[Oo]utput(?:\s+to)?\s*:\s*(\S+)/i);
98
- if (outputMatch?.[1]?.trim())
99
- return outputMatch[1].trim();
100
- return undefined;
101
- }
102
- function hasEmptyTextOutputWithoutOutputTarget(task, output) {
103
- if (output.trim())
104
- return false;
105
- return !extractOutputTarget(task);
106
- }
107
- function getToolCallLines(result, expanded) {
108
- if (result.messages) {
109
- return getDisplayItems(result.messages)
110
- .filter((item) => item.type === "tool")
111
- .map((item) => formatToolCall(item.name, item.args, expanded));
112
- }
113
- return result.toolCalls?.map((toolCall) => expanded ? toolCall.expandedText : toolCall.text) ?? [];
114
- }
115
- function snapshotNowForProgress(progress) {
116
- if (progress.currentToolStartedAt !== undefined && progress.durationMs !== undefined)
117
- return progress.currentToolStartedAt + progress.durationMs;
118
- return progress.lastActivityAt;
119
- }
120
- function formatCurrentToolLine(progress, availableWidth, expanded, snapshotNow) {
121
- if (!progress.currentTool)
122
- return undefined;
123
- const maxToolArgsLen = Math.max(50, availableWidth - 20);
124
- const toolArgsPreview = progress.currentToolArgs
125
- ? (expanded || progress.currentToolArgs.length <= maxToolArgsLen
126
- ? progress.currentToolArgs
127
- : `${progress.currentToolArgs.slice(0, maxToolArgsLen)}...`)
128
- : "";
129
- const durationSuffix = progress.currentToolStartedAt !== undefined && snapshotNow !== undefined
130
- ? ` | ${formatDuration(Math.max(0, snapshotNow - progress.currentToolStartedAt))}`
131
- : "";
132
- return toolArgsPreview
133
- ? `${progress.currentTool}: ${toolArgsPreview}${durationSuffix}`
134
- : `${progress.currentTool}${durationSuffix}`;
135
- }
136
- function buildLiveStatusLine(progress, snapshotNow) {
137
- if (progress.lastActivityAt !== undefined && snapshotNow !== undefined)
138
- return formatActivityLabel(progress.lastActivityAt, progress.activityState, snapshotNow);
139
- if (progress.activityState === "needs_attention")
140
- return "needs attention";
141
- if (progress.lastActivityAt !== undefined)
142
- return "active";
143
- return undefined;
144
- }
145
- function themeBold(theme, text) {
146
- return (theme.bold?.(text)) ?? text;
147
- }
148
- function statJoin(theme, parts) {
149
- return parts.filter(Boolean).map((part) => theme.fg("dim", part)).join(` ${theme.fg("dim", "·")} `);
150
- }
151
- function formatTokenStat(tokens) {
152
- return `${formatTokens(tokens)} token`;
153
- }
154
- function formatToolUseStat(count) {
155
- return `${count} tool use${count === 1 ? "" : "s"}`;
156
- }
157
- function formatProgressStats(theme, progress, includeDuration = true) {
158
- if (!progress)
159
- return "";
160
- const parts = [];
161
- if (progress.toolCount > 0)
162
- parts.push(formatToolUseStat(progress.toolCount));
163
- if (progress.tokens > 0)
164
- parts.push(formatTokenStat(progress.tokens));
165
- if (includeDuration && progress.durationMs > 0)
166
- parts.push(formatDuration(progress.durationMs));
167
- return statJoin(theme, parts);
168
- }
169
- function firstOutputLine(text) {
170
- return text.split("\n").find((line) => line.trim())?.replace(/[\u0000-\u0008\u000b-\u001f\u007f]/g, "").trim() ?? "";
171
- }
172
- function formatAcceptanceStatus(result) {
173
- const acceptance = result.acceptance;
174
- if (!acceptance?.status || acceptance.status === "not-required")
175
- return undefined;
176
- const finalization = acceptance.finalization
177
- ? ` · finalization: ${acceptance.finalization.status} after ${acceptance.finalization.turns.length}/${acceptance.finalization.maxTurns} turns`
178
- : "";
179
- return `acceptance: ${acceptance.status}${finalization}`;
180
- }
181
- function resultStatusLine(result, output) {
182
- if (result.detached)
183
- return result.detachedReason ? `Detached: ${result.detachedReason}` : "Detached";
184
- if (result.timedOut)
185
- return `Timed out${result.error ? `: ${result.error}` : ""}`;
186
- if (result.interrupted)
187
- return "Paused";
188
- if (result.exitCode !== 0)
189
- return `Error: ${result.error ?? (firstOutputLine(output) || `exit ${result.exitCode}`)}`;
190
- if (result.acceptance?.status === "blocked")
191
- return `Needs your action · acceptance incomplete · ${acceptanceHumanAction(result.acceptance)?.split("\n")[0]}`;
192
- const acceptance = formatAcceptanceStatus(result);
193
- if (acceptance)
194
- return `Done · ${acceptance}`;
195
- if (hasEmptyTextOutputWithoutOutputTarget(result.task, output))
196
- return "Done (no text output)";
197
- return "Done";
198
- }
199
- function resultGlyph(result, output, theme, running = result.progress?.status === "running", seed = progressRunningSeed(result.progress ?? result.progressSummary)) {
200
- if (running)
201
- return theme.fg("accent", runningGlyph(seed));
202
- if (result.detached)
203
- return theme.fg("warning", "■");
204
- if (result.timedOut)
205
- return theme.fg("error", "✗");
206
- if (result.interrupted)
207
- return theme.fg("warning", "■");
208
- if (result.exitCode !== 0)
209
- return theme.fg("error", "✗");
210
- if (result.acceptance?.status === "blocked")
211
- return theme.fg("warning", "■");
212
- if (hasEmptyTextOutputWithoutOutputTarget(result.task, output))
213
- return theme.fg("warning", "✓");
214
- return theme.fg("success", "✓");
215
- }
216
- function compactCurrentActivity(progress) {
217
- const snapshotNow = snapshotNowForProgress(progress);
218
- return formatCurrentToolLine(progress, getTermWidth() - 4, false, snapshotNow) ?? buildLiveStatusLine(progress, snapshotNow) ?? "thinking…";
219
- }
220
- export function widgetRenderKey(job) {
221
- return JSON.stringify({
222
- asyncDir: job.asyncDir,
223
- status: job.status,
224
- activityState: job.activityState,
225
- lastActivityAt: job.lastActivityAt,
226
- currentTool: job.currentTool,
227
- currentToolStartedAt: job.currentToolStartedAt,
228
- currentPath: job.currentPath,
229
- turnCount: job.turnCount,
230
- toolCount: job.toolCount,
231
- mode: job.mode,
232
- agents: job.agents,
233
- currentStep: job.currentStep,
234
- chainStepCount: job.chainStepCount,
235
- parallelGroups: job.parallelGroups,
236
- steps: job.steps,
237
- nestedChildren: job.nestedChildren,
238
- stepsTotal: job.stepsTotal,
239
- runningSteps: job.runningSteps,
240
- completedSteps: job.completedSteps,
241
- activeParallelGroup: job.activeParallelGroup,
242
- startedAt: job.startedAt,
243
- updatedAt: job.updatedAt,
244
- totalTokens: job.totalTokens,
245
- });
246
- }
247
- function formatWidgetAgents(agents) {
248
- const distinct = [...new Set(agents)];
249
- if (distinct.length === 1 && agents.length > 1)
250
- return `${distinct[0]} ×${agents.length}`;
251
- if (agents.length > 3)
252
- return `${agents.slice(0, 2).join(", ")} +${agents.length - 2} more`;
253
- return agents.join(", ");
254
- }
255
- function widgetJobName(job) {
256
- if (job.mode === "parallel")
257
- return "parallel";
258
- if (job.mode === "chain")
259
- return "chain";
260
- if (job.mode === "single" && job.agents?.length === 1)
261
- return job.agents[0];
262
- if (job.agents?.length)
263
- return formatWidgetAgents(job.agents);
264
- return job.mode ?? "subagent";
265
- }
266
- function widgetActivity(job, includeCounts = true) {
267
- const facts = [];
268
- if (job.currentTool && job.currentToolStartedAt !== undefined && job.updatedAt !== undefined)
269
- facts.push(`${job.currentTool} ${formatDuration(Math.max(0, job.updatedAt - job.currentToolStartedAt))}`);
270
- else if (job.currentTool)
271
- facts.push(job.currentTool);
272
- if (job.currentPath)
273
- facts.push(shortenPath(job.currentPath));
274
- if (includeCounts && job.turnCount !== undefined)
275
- facts.push(`${job.turnCount} turns`);
276
- if (includeCounts && job.toolCount !== undefined)
277
- facts.push(`${job.toolCount} tools`);
278
- if (job.status !== "running") {
279
- const status = job.status === "queued" ? "queued…" : job.status === "paused" ? "Paused" : job.status === "failed" ? "Failed" : job.status === "blocked" ? "Needs your action" : "Done";
280
- const error = job.status === "failed" ? job.steps?.find((step) => step.error)?.error : undefined;
281
- return [status, error ? firstOutputLine(error) : "", ...facts].filter(Boolean).join(" · ");
282
- }
283
- const activity = buildLiveStatusLine(job, job.updatedAt);
284
- if (activity && facts.length)
285
- return `${activity} · ${facts.join(" · ")}`;
286
- if (activity)
287
- return activity;
288
- if (facts.length)
289
- return facts.join(" · ");
290
- return "thinking…";
291
- }
292
- function widgetStepRunningSeed(step, fallbackIndex) {
293
- return runningSeed(fallbackIndex, step.index, step.toolCount, step.turnCount, step.tokens?.total, step.lastActivityAt, step.currentToolStartedAt, step.durationMs);
294
- }
295
- function widgetStepsRunningSeed(steps) {
296
- let seed;
297
- for (const [index, step] of (steps ?? []).entries())
298
- seed = runningSeed(seed, widgetStepRunningSeed(step, index));
299
- return seed;
300
- }
301
- function widgetJobRunningSeed(job) {
302
- return runningSeed(job.updatedAt, job.lastActivityAt, job.toolCount, job.turnCount, job.totalTokens?.total, job.currentStep, job.runningSteps, job.completedSteps, widgetStepsRunningSeed(job.steps));
303
- }
304
- function widgetJobsRunningSeed(jobs) {
305
- let seed;
306
- for (const job of jobs)
307
- seed = runningSeed(seed, widgetJobRunningSeed(job));
308
- return seed;
309
- }
310
- function widgetStatusGlyph(job, theme) {
311
- if (job.status === "running")
312
- return theme.fg("accent", runningGlyph(widgetJobRunningSeed(job)));
313
- if (job.status === "queued")
314
- return theme.fg("muted", "◦");
315
- if (job.status === "complete")
316
- return theme.fg("success", "✓");
317
- if (job.status === "blocked")
318
- return theme.fg("warning", "■");
319
- if (job.status === "paused")
320
- return theme.fg("warning", "■");
321
- return theme.fg("error", "✗");
322
- }
323
- function widgetStepGlyph(status, theme, seed) {
324
- if (status === "running")
325
- return theme.fg("accent", runningGlyph(seed));
326
- if (status === "complete" || status === "completed")
327
- return theme.fg("success", "✓");
328
- if (status === "failed" || status === "timed-out")
329
- return theme.fg("error", "✗");
330
- if (status === "blocked")
331
- return theme.fg("warning", "■");
332
- if (status === "paused")
333
- return theme.fg("warning", "■");
334
- return theme.fg("muted", "◦");
335
- }
336
- function widgetStepStatus(status, theme) {
337
- if (status === "running")
338
- return theme.fg("accent", "running");
339
- if (status === "complete" || status === "completed")
340
- return theme.fg("success", "complete");
341
- if (status === "failed")
342
- return theme.fg("error", "failed");
343
- if (status === "timed-out")
344
- return theme.fg("error", "timed out");
345
- if (status === "blocked")
346
- return theme.fg("warning", "needs your action");
347
- if (status === "paused")
348
- return theme.fg("warning", "paused");
349
- return theme.fg("dim", status);
350
- }
351
- function widgetStepActivity(step, snapshotNow) {
352
- if ((step.status === "failed" || step.status === "timed-out") && step.error)
353
- return firstOutputLine(step.error);
354
- const facts = [];
355
- if (step.currentTool && step.currentToolStartedAt !== undefined && snapshotNow !== undefined)
356
- facts.push(`${step.currentTool} ${formatDuration(Math.max(0, snapshotNow - step.currentToolStartedAt))}`);
357
- else if (step.currentTool)
358
- facts.push(step.currentTool);
359
- if (step.currentPath)
360
- facts.push(shortenPath(step.currentPath));
361
- if (step.turnCount !== undefined)
362
- facts.push(`${step.turnCount} turns`);
363
- if (step.toolCount !== undefined)
364
- facts.push(`${step.toolCount} tools`);
365
- if (step.tokens?.total)
366
- facts.push(formatTokenStat(step.tokens.total));
367
- const activity = buildLiveStatusLine(step, snapshotNow);
368
- if (activity && facts.length)
369
- return `${activity} · ${facts.join(" · ")}`;
370
- if (activity)
371
- return activity;
372
- return facts.join(" · ");
373
- }
374
- function widgetChainDetails(job, theme, width = getTermWidth()) {
375
- if (!job.steps?.length)
376
- return [];
377
- const total = job.chainStepCount ?? job.steps.length;
378
- const lines = [];
379
- for (const span of buildAsyncChainStepSpans(total, job.steps.length, job.parallelGroups)) {
380
- const steps = job.steps.slice(span.start, span.start + span.count);
381
- if (span.isParallel) {
382
- const status = aggregateStepStatus(steps);
383
- lines.push(` ${widgetStepGlyph(status, theme, widgetStepsRunningSeed(steps))} Step ${span.stepIndex + 1}/${total}: ${themeBold(theme, "parallel group")} ${theme.fg("dim", "·")} ${theme.fg("dim", formatParallelOutcome(steps, span.count))}`);
384
- continue;
385
- }
386
- const step = steps[0];
387
- if (!step) {
388
- lines.push(` ${theme.fg("dim", `◦ Step ${span.stepIndex + 1}/${total}: pending`)}`);
389
- continue;
390
- }
391
- lines.push(...foregroundStyleWidgetStepLines(job, theme, step, "Step", span.stepIndex + 1, total, width));
392
- }
393
- return lines;
394
- }
395
- function widgetParallelAgentDetails(job, theme, width = getTermWidth()) {
396
- if (!job.steps?.length)
397
- return [];
398
- if (job.mode !== "parallel" && job.mode !== "chain")
399
- return [];
400
- if (job.mode === "chain" && !job.activeParallelGroup && job.parallelGroups?.length)
401
- return widgetChainDetails(job, theme, width);
402
- const total = job.stepsTotal ?? job.steps.length;
403
- const lines = [];
404
- for (const [index, step] of job.steps.entries()) {
405
- const marker = index === job.steps.length - 1 ? "└" : "├";
406
- const activity = widgetStepActivity(step, job.updatedAt);
407
- const itemTitle = job.mode === "parallel" || job.activeParallelGroup ? "Agent" : "Step";
408
- const modelDisplay = modelThinkingBadge(theme, step.model, step.thinking);
409
- lines.push(` ${theme.fg("dim", `${marker} ${widgetStepGlyph(step.status, theme, widgetStepRunningSeed(step, index))} ${itemTitle} ${index + 1}/${total}: ${step.agent} · ${widgetStepStatus(step.status, theme)}${modelDisplay}${activity ? ` · ${activity}` : ""}`)}`);
410
- for (const nestedLine of formatNestedWidgetLines(step.children, theme, width, job.updatedAt, 8))
411
- lines.push(` ${nestedLine}`);
412
- }
413
- return lines;
414
- }
415
- function parseParallelGroupAgentCount(label) {
416
- if (!label || !label.startsWith("[") || !label.endsWith("]"))
417
- return undefined;
418
- const inner = label.slice(1, -1).trim();
419
- if (!inner)
420
- return 0;
421
- return inner.split("+").map((part) => part.trim()).filter(Boolean).length;
422
- }
423
- function buildChainStepSpans(details) {
424
- if (details.workflowGraph?.nodes?.length) {
425
- const spans = [];
426
- let flatCursor = 0;
427
- for (const node of details.workflowGraph.nodes) {
428
- if (node.stepIndex === undefined)
429
- continue;
430
- if (node.kind === "parallel-group" || node.kind === "dynamic-parallel-group") {
431
- const childFlatIndexes = (node.children ?? [])
432
- .map((child) => child.flatIndex)
433
- .filter((value) => typeof value === "number");
434
- const start = childFlatIndexes.length ? Math.min(...childFlatIndexes) : flatCursor;
435
- const count = node.children?.length ?? 0;
436
- spans.push({ stepIndex: node.stepIndex, start, count, isParallel: true, status: node.status, label: node.label, error: node.error });
437
- flatCursor = Math.max(flatCursor, start + count);
438
- continue;
439
- }
440
- const start = node.flatIndex ?? flatCursor;
441
- spans.push({ stepIndex: node.stepIndex, start, count: 1, isParallel: false, status: node.status, label: node.label, error: node.error });
442
- flatCursor = Math.max(flatCursor, start + 1);
443
- }
444
- if (spans.length)
445
- return spans.sort((left, right) => left.stepIndex - right.stepIndex);
446
- }
447
- if (!details.chainAgents?.length)
448
- return [];
449
- const spans = [];
450
- let start = 0;
451
- for (let stepIndex = 0; stepIndex < details.chainAgents.length; stepIndex++) {
452
- const label = details.chainAgents[stepIndex];
453
- const parsedCount = parseParallelGroupAgentCount(label);
454
- const count = parsedCount ?? 1;
455
- spans.push({ stepIndex, start, count, isParallel: parsedCount !== undefined });
456
- start += count;
457
- }
458
- return spans;
459
- }
460
- function isChainParallelGroupActive(details) {
461
- if (details.mode !== "chain")
462
- return false;
463
- if (details.currentStepIndex === undefined)
464
- return false;
465
- return buildChainStepSpans(details).some((span) => span.stepIndex === details.currentStepIndex && span.isParallel);
466
- }
467
- function buildAsyncChainStepSpans(total, stepCount, parallelGroups = []) {
468
- const spans = [];
469
- let flatIndex = 0;
470
- for (let stepIndex = 0; stepIndex < total; stepIndex++) {
471
- const group = parallelGroups.find((candidate) => candidate.stepIndex === stepIndex);
472
- if (group) {
473
- spans.push({ stepIndex, start: group.start, count: group.count, isParallel: true });
474
- flatIndex = Math.max(flatIndex, group.start + group.count);
475
- continue;
476
- }
477
- spans.push({ stepIndex, start: flatIndex, count: flatIndex < stepCount ? 1 : 0, isParallel: false });
478
- flatIndex++;
479
- }
480
- return spans;
481
- }
482
- function isDoneResult(result) {
483
- if (result.interrupted || result.detached || result.timedOut || result.acceptance?.status === "blocked")
484
- return false;
485
- const status = result.progress?.status;
486
- if (status === "completed")
487
- return true;
488
- if (status === "running" || status === "pending")
489
- return false;
490
- return result.exitCode === 0;
491
- }
492
- function workflowGraphHasStatus(details, statuses) {
493
- return details.workflowGraph?.nodes.some((node) => statuses.includes(node.status)) ?? false;
494
- }
495
- function buildChainRenderEntries(details, label) {
496
- if (details.mode !== "chain" || (!label.hasParallelInChain && !details.workflowGraph?.nodes.length) || label.showActiveGroupOnly)
497
- return undefined;
498
- const entries = [];
499
- for (const span of buildChainStepSpans(details)) {
500
- if (span.isParallel ? span.count === 0 : !details.results[span.start]) {
501
- entries.push({
502
- kind: "placeholder",
503
- rowNumber: span.stepIndex + 1,
504
- stepLabel: `Step ${span.stepIndex + 1}`,
505
- agentName: (!span.isParallel ? details.chainAgents?.[span.stepIndex] : undefined) ?? span.label ?? details.chainAgents?.[span.stepIndex] ?? `step-${span.stepIndex + 1}`,
506
- status: span.status ?? "pending",
507
- error: span.error,
508
- });
509
- continue;
510
- }
511
- for (let index = span.start; index < span.start + span.count; index++) {
512
- entries.push({
513
- kind: "result",
514
- resultIndex: index,
515
- rowNumber: index + 1,
516
- agentName: details.results[index]?.agent ?? details.chainAgents?.[span.stepIndex] ?? `step-${span.stepIndex + 1}`,
517
- });
518
- }
519
- }
520
- return entries;
521
- }
522
- function buildMultiProgressLabel(details, hasRunning) {
523
- const stepSpans = buildChainStepSpans(details);
524
- const hasParallelInChain = details.mode === "chain" && stepSpans.some((span) => span.isParallel);
525
- const activeParallelGroup = isChainParallelGroupActive(details);
526
- const itemTitle = details.mode === "parallel" || activeParallelGroup ? "Agent" : "Step";
527
- if (details.mode === "parallel") {
528
- const totalCount = details.totalSteps ?? details.results.length;
529
- const statuses = new Array(totalCount).fill("pending");
530
- for (const progress of details.progress ?? []) {
531
- if (progress.index >= 0 && progress.index < totalCount)
532
- statuses[progress.index] = progress.status;
533
- }
534
- for (let i = 0; i < details.results.length; i++) {
535
- const result = details.results[i];
536
- const progressFromArray = details.progress?.find((progress) => progress.index === i)
537
- || details.progress?.find((progress) => progress.agent === result.agent && progress.status === "running");
538
- const index = result.progress?.index ?? progressFromArray?.index ?? i;
539
- if (index < 0 || index >= totalCount)
540
- continue;
541
- const status = result.progress?.status
542
- ?? (result.timedOut
543
- ? "timed-out"
544
- : result.interrupted || result.detached
545
- ? "detached"
546
- : result.exitCode === 0
547
- ? result.acceptance?.status === "blocked" ? "blocked" : "completed"
548
- : "failed");
549
- statuses[index] = status;
550
- }
551
- const running = statuses.filter((status) => status === "running").length;
552
- const succeeded = statuses.filter((status) => status === "completed").length;
553
- const failed = statuses.filter((status) => status === "failed" || status === "timed-out").length;
554
- const paused = statuses.filter((status) => status === "paused" || status === "detached").length;
555
- const blockedCount = statuses.filter((status) => status === "blocked").length;
556
- const parts = [`${succeeded}/${totalCount} succeeded`];
557
- if (blockedCount)
558
- parts.push(`${blockedCount} need human action`);
559
- if (hasRunning)
560
- parts.unshift(formatAgentRunningLabel(running));
561
- if (failed > 0)
562
- parts.push(`${failed} failed`);
563
- if (paused > 0)
564
- parts.push(`${paused} paused`);
565
- const headerLabel = parts.join(" · ");
566
- return { headerLabel, itemTitle, totalCount, hasParallelInChain, activeParallelGroup, groupStartIndex: 0, groupEndIndex: totalCount, showActiveGroupOnly: false };
567
- }
568
- if (activeParallelGroup) {
569
- const currentStepIndex = details.currentStepIndex;
570
- const span = stepSpans[currentStepIndex];
571
- const groupSize = span?.count ?? 1;
572
- const groupStart = span?.start ?? 0;
573
- const groupEnd = groupStart + groupSize;
574
- let running = 0;
575
- let succeeded = 0;
576
- let failed = 0;
577
- let paused = 0;
578
- let blocked = 0;
579
- for (let index = groupStart; index < groupEnd; index++) {
580
- const progressEntry = details.progress?.find((progress) => progress.index === index);
581
- const resultEntry = details.results.find((result, position) => (result.progress?.index ?? position) === index);
582
- const status = progressEntry?.status ?? resultEntry?.progress?.status;
583
- if (status === "running")
584
- running++;
585
- else if (status === "failed" || status === "timed-out" || resultEntry?.timedOut)
586
- failed++;
587
- else if (status === "paused" || status === "detached" || resultEntry?.interrupted || resultEntry?.detached)
588
- paused++;
589
- else if (resultEntry && resultEntry.exitCode !== 0)
590
- failed++;
591
- else if (status === "blocked" || resultEntry?.acceptance?.status === "blocked")
592
- blocked++;
593
- else if (status === "completed" || (resultEntry && isDoneResult(resultEntry)))
594
- succeeded++;
595
- }
596
- const totalSteps = details.totalSteps ?? details.chainAgents?.length ?? 1;
597
- const groupParts = [`${succeeded}/${groupSize} succeeded`];
598
- if (hasRunning)
599
- groupParts.unshift(formatAgentRunningLabel(running));
600
- if (failed > 0)
601
- groupParts.push(`${failed} failed`);
602
- if (paused > 0)
603
- groupParts.push(`${paused} paused`);
604
- if (blocked > 0)
605
- groupParts.push(`${blocked} need human action`);
606
- const headerLabel = `step ${currentStepIndex + 1}/${totalSteps} · parallel group: ${groupParts.join(" · ")}`;
607
- return { headerLabel, itemTitle, totalCount: groupSize, hasParallelInChain, activeParallelGroup, groupStartIndex: groupStart, groupEndIndex: groupEnd, showActiveGroupOnly: true };
608
- }
609
- if (details.mode === "chain" && details.chainAgents?.length) {
610
- const totalCount = details.totalSteps ?? details.chainAgents.length;
611
- const doneLogical = stepSpans.filter((span) => {
612
- if (span.status && span.status !== "completed")
613
- return false;
614
- if (span.count === 0)
615
- return span.status === "completed";
616
- for (let index = span.start; index < span.start + span.count; index++) {
617
- const progressEntry = details.progress?.find((progress) => progress.index === index);
618
- const resultEntry = details.results.find((result) => result.progress?.index === index) ?? details.results[index];
619
- if (progressEntry?.status === "running" || progressEntry?.status === "pending" || progressEntry?.status === "failed")
620
- return false;
621
- if (!resultEntry || !isDoneResult(resultEntry))
622
- return false;
623
- }
624
- return true;
625
- }).length;
626
- const currentStep = details.currentStepIndex !== undefined ? details.currentStepIndex + 1 : Math.min(totalCount, doneLogical + (hasRunning ? 1 : 0));
627
- const headerLabel = hasRunning ? `step ${currentStep}/${totalCount}` : `step ${doneLogical}/${totalCount}`;
628
- return { headerLabel, itemTitle, totalCount, hasParallelInChain, activeParallelGroup, groupStartIndex: 0, groupEndIndex: details.results.length, showActiveGroupOnly: false };
629
- }
630
- const totalCount = details.totalSteps ?? details.results.length;
631
- const currentStep = details.currentStepIndex !== undefined ? details.currentStepIndex + 1 : Math.min(totalCount, details.results.filter(isDoneResult).length + (hasRunning ? 1 : 0));
632
- const done = details.results.filter(isDoneResult).length;
633
- const headerLabel = hasRunning ? `step ${currentStep}/${totalCount}` : `step ${done}/${totalCount}`;
634
- return { headerLabel, itemTitle, totalCount, hasParallelInChain, activeParallelGroup, groupStartIndex: 0, groupEndIndex: details.results.length, showActiveGroupOnly: false };
635
- }
636
- function resultRowLabel(details, label, resultIndex, stepNumber) {
637
- if (details.mode === "chain" && label.hasParallelInChain) {
638
- const span = buildChainStepSpans(details).find((candidate) => resultIndex >= candidate.start && resultIndex < candidate.start + candidate.count);
639
- if (span?.isParallel)
640
- return `Agent ${resultIndex - span.start + 1}/${span.count}`;
641
- if (span)
642
- return `Step ${span.stepIndex + 1}`;
643
- }
644
- if (label.itemTitle === "Agent") {
645
- const localStepNumber = label.activeParallelGroup
646
- ? Math.max(1, stepNumber - label.groupStartIndex)
647
- : stepNumber;
648
- return `Agent ${localStepNumber}/${label.totalCount}`;
649
- }
650
- return `Step ${stepNumber}`;
651
- }
652
- function widgetStats(job, theme) {
653
- const parts = [];
654
- const stepsTotal = job.stepsTotal ?? (job.agents?.length ?? 1);
655
- if (job.activeParallelGroup) {
656
- const running = job.runningSteps ?? (job.status === "running" ? 1 : 0);
657
- const succeeded = job.completedSteps ?? (job.status === "complete" ? stepsTotal : 0);
658
- if (job.mode === "parallel") {
659
- if (job.status === "running" && running > 0)
660
- parts.push(formatAgentRunningLabel(running));
661
- if (stepsTotal > 0)
662
- parts.push(`${succeeded}/${stepsTotal} succeeded`);
663
- }
664
- else {
665
- const activeGroup = job.currentStep !== undefined
666
- ? job.parallelGroups?.find((group) => job.currentStep >= group.start && job.currentStep < group.start + group.count)
667
- : job.parallelGroups?.find((group) => group.start === 0);
668
- const logicalStep = activeGroup?.stepIndex ?? job.currentStep ?? 0;
669
- const total = job.chainStepCount ?? stepsTotal;
670
- const groupParts = [`${succeeded}/${stepsTotal} succeeded`];
671
- if (job.status === "running" && running > 0)
672
- groupParts.unshift(formatAgentRunningLabel(running));
673
- parts.push(`step ${logicalStep + 1}/${total} · parallel group: ${groupParts.join(" · ")}`);
674
- }
675
- }
676
- else if (job.currentStep !== undefined) {
677
- if (job.mode === "chain" && job.parallelGroups?.length) {
678
- const total = job.chainStepCount ?? stepsTotal;
679
- parts.push(`step ${flatToLogicalStepIndex(job.currentStep, total, job.parallelGroups) + 1}/${total}`);
680
- }
681
- else {
682
- parts.push(`step ${job.currentStep + 1}/${stepsTotal}`);
683
- }
684
- }
685
- else if (stepsTotal > 1) {
686
- parts.push(`steps ${stepsTotal}`);
687
- }
688
- if (job.toolCount !== undefined)
689
- parts.push(formatToolUseStat(job.toolCount));
690
- if (job.totalTokens?.total)
691
- parts.push(formatTokenStat(job.totalTokens.total));
692
- if (job.status !== "queued" && job.startedAt !== undefined && job.updatedAt !== undefined)
693
- parts.push(formatDuration(Math.max(0, job.updatedAt - job.startedAt)));
694
- return statJoin(theme, parts);
695
- }
696
- function widgetStepStats(theme, step) {
697
- return statJoin(theme, [
698
- step.turnCount !== undefined ? `${step.turnCount} turns` : "",
699
- step.toolCount !== undefined ? formatToolUseStat(step.toolCount) : "",
700
- step.tokens?.total ? formatTokenStat(step.tokens.total) : "",
701
- step.durationMs !== undefined ? formatDuration(step.durationMs) : "",
702
- ]);
703
- }
704
- function modelThinkingBadge(theme, model, thinking) {
705
- const label = formatModelThinking(model, thinking);
706
- return label ? theme.fg("dim", ` (${label})`) : "";
707
- }
708
- function modelStat(theme, model) {
709
- return model ? ` ${theme.fg("dim", "·")} ${theme.fg("dim", model)}` : "";
710
- }
711
- function widgetStepActivityLine(step, width, expanded, snapshotNow) {
712
- if ((step.status === "failed" || step.status === "timed-out") && step.error)
713
- return firstOutputLine(step.error);
714
- const toolLine = formatCurrentToolLine(step, width, expanded, snapshotNow);
715
- if (toolLine)
716
- return toolLine;
717
- const activity = buildLiveStatusLine(step, snapshotNow);
718
- if (activity)
719
- return activity;
720
- if (step.status === "running")
721
- return "thinking…";
722
- return "";
723
- }
724
- function widgetOutputPath(job, step) {
725
- if (typeof step.index !== "number")
726
- return undefined;
727
- return path.join(job.asyncDir, `output-${step.index}.log`);
728
- }
729
- function nestedRunName(run) {
730
- if (run.agent)
731
- return run.agent;
732
- if (run.agents?.length)
733
- return formatWidgetAgents(run.agents);
734
- return run.id;
735
- }
736
- function nestedStatusGlyph(state, theme, seed) {
737
- if (state === "running")
738
- return theme.fg("accent", runningGlyph(seed));
739
- if (state === "complete" || state === "completed")
740
- return theme.fg("success", "✓");
741
- if (state === "failed")
742
- return theme.fg("error", "✗");
743
- if (state === "blocked")
744
- return theme.fg("warning", "■");
745
- if (state === "paused")
746
- return theme.fg("warning", "■");
747
- return theme.fg("muted", "◦");
748
- }
749
- function nestedRunSeed(run) {
750
- return runningSeed(run.lastUpdate, run.lastActivityAt, run.currentStep, run.toolCount, run.turnCount, run.totalTokens?.total, run.currentToolStartedAt);
751
- }
752
- function nestedActivity(input, state, snapshotNow) {
753
- const facts = [];
754
- if (input.currentTool && input.currentToolStartedAt !== undefined && snapshotNow !== undefined)
755
- facts.push(`${input.currentTool} ${formatDuration(Math.max(0, snapshotNow - input.currentToolStartedAt))}`);
756
- else if (input.currentTool)
757
- facts.push(input.currentTool);
758
- if (input.currentPath)
759
- facts.push(shortenPath(input.currentPath));
760
- if (input.turnCount !== undefined)
761
- facts.push(`${input.turnCount} turns`);
762
- if (input.toolCount !== undefined)
763
- facts.push(`${input.toolCount} tools`);
764
- const activity = buildLiveStatusLine(input, snapshotNow);
765
- if (activity && facts.length)
766
- return `${activity} · ${facts.join(" · ")}`;
767
- if (activity)
768
- return activity;
769
- if (facts.length)
770
- return facts.join(" · ");
771
- if (state === "running")
772
- return "thinking…";
773
- if (state === "queued" || state === "pending")
774
- return "queued…";
775
- if (state === "blocked")
776
- return "Needs your action";
777
- if (state === "paused")
778
- return "Paused";
779
- if (state === "failed")
780
- return "Failed";
781
- return "Done";
782
- }
783
- /** Nested runs only render in the expanded widget; the collapsed view is one line per run. */
784
- function formatNestedWidgetLines(children, theme, width, snapshotNow, lineBudget = 12) {
785
- if (!children?.length || lineBudget <= 0)
786
- return [];
787
- const lines = [];
788
- const maxDepth = 2;
789
- const append = (items, depth, prefix) => {
790
- if (!items?.length || lines.length >= lineBudget)
791
- return;
792
- if (depth > maxDepth) {
793
- const aggregate = formatNestedAggregate(items);
794
- if (aggregate && lines.length < lineBudget)
795
- lines.push(theme.fg("dim", `${prefix}↳ ${aggregate}`));
796
- return;
797
- }
798
- for (let index = 0; index < items.length; index++) {
799
- const child = items[index];
800
- if (lines.length >= lineBudget) {
801
- const aggregate = formatNestedAggregate(items.slice(index));
802
- if (aggregate)
803
- lines[lines.length - 1] = theme.fg("dim", `${prefix}↳ ${aggregate}`);
804
- return;
805
- }
806
- const activity = nestedActivity(child, child.state, snapshotNow ?? child.lastUpdate);
807
- const error = child.error ? ` · ${child.error}` : "";
808
- lines.push(theme.fg("dim", `${prefix}↳ ${nestedStatusGlyph(child.state, theme, nestedRunSeed(child))} ${nestedRunName(child)} · ${child.state} · ${activity}${error}`));
809
- if (depth === maxDepth) {
810
- const aggregate = formatNestedAggregate([...(child.steps?.flatMap((step) => step.children ?? []) ?? []), ...(child.children ?? [])]);
811
- if (aggregate && lines.length < lineBudget)
812
- lines.push(theme.fg("dim", `${prefix} ↳ ${aggregate}`));
813
- continue;
814
- }
815
- for (const step of child.steps ?? []) {
816
- if (lines.length >= lineBudget)
817
- return;
818
- lines.push(theme.fg("dim", `${prefix} ↳ ${nestedStatusGlyph(step.status, theme)} ${step.agent} · ${step.status} · ${nestedActivity(step, step.status, snapshotNow ?? child.lastUpdate)}`));
819
- append(step.children, depth + 1, `${prefix} `);
820
- }
821
- append(child.children, depth + 1, `${prefix} `);
822
- }
823
- };
824
- append(children, 0, "");
825
- return lines.map((line) => truncLine(line, width));
826
- }
827
- function foregroundStyleWidgetStepLines(job, theme, step, itemTitle, index, total, width) {
828
- const status = widgetStepStatus(step.status, theme);
829
- const stats = widgetStepStats(theme, step);
830
- const modelDisplay = modelThinkingBadge(theme, step.model, step.thinking);
831
- const lines = [` ${widgetStepGlyph(step.status, theme, widgetStepRunningSeed(step, index - 1))} ${itemTitle} ${index}/${total}: ${themeBold(theme, step.agent)} ${theme.fg("dim", "·")} ${status}${modelDisplay}${stats ? ` ${theme.fg("dim", "·")} ${stats}` : ""}`];
832
- const activity = widgetStepActivityLine(step, width, true, job.updatedAt);
833
- if (activity)
834
- lines.push(` ${theme.fg("dim", `⎿ ${activity}`)}`);
835
- for (const nestedLine of formatNestedWidgetLines(step.children, theme, width, job.updatedAt)) {
836
- lines.push(` ${nestedLine}`);
837
- }
838
- if (step.status === "running") {
839
- const output = widgetOutputPath(job, step);
840
- if (output)
841
- lines.push(` ${theme.fg("dim", `output: ${shortenPath(output)}`)}`);
842
- const liveStatus = buildLiveStatusLine(step, job.updatedAt);
843
- if (liveStatus && liveStatus !== activity)
844
- lines.push(` ${theme.fg("accent", liveStatus)}`);
845
- for (const tool of step.recentTools?.slice(-3) ?? []) {
846
- const maxArgsLen = Math.max(40, width - 30);
847
- const argsPreview = tool.args.length <= maxArgsLen ? tool.args : `${tool.args.slice(0, maxArgsLen)}...`;
848
- lines.push(` ${theme.fg("dim", `${tool.tool}${argsPreview ? `: ${argsPreview}` : ""}`)}`);
849
- }
850
- for (const line of step.recentOutput?.slice(-5) ?? []) {
851
- lines.push(` ${theme.fg("dim", line)}`);
852
- }
853
- }
854
- return lines;
855
- }
856
- function foregroundStyleWidgetDetails(job, theme, width) {
857
- if (!job.steps?.length)
858
- return [
859
- ` ${theme.fg("dim", `⎿ ${widgetActivity(job)}`)}`,
860
- ...formatNestedWidgetLines(job.nestedChildren, theme, width, job.updatedAt).map((line) => ` ${line}`),
861
- ];
862
- if (job.mode === "chain" && !job.activeParallelGroup && job.parallelGroups?.length)
863
- return widgetChainDetails(job, theme, width);
864
- const total = job.stepsTotal ?? job.steps.length;
865
- const itemTitle = job.mode === "parallel" || job.activeParallelGroup ? "Agent" : "Step";
866
- const lines = [];
867
- for (const [index, step] of job.steps.entries()) {
868
- lines.push(...foregroundStyleWidgetStepLines(job, theme, step, itemTitle, index + 1, total, width));
869
- }
870
- const attached = new Set(job.steps.flatMap((step) => step.children?.map((child) => child.id) ?? []));
871
- const unattached = job.nestedChildren?.filter((child) => !attached.has(child.id)) ?? [];
872
- for (const nestedLine of formatNestedWidgetLines(unattached, theme, width, job.updatedAt)) {
873
- lines.push(` ${nestedLine}`);
874
- }
875
- return lines;
876
- }
877
- /** The expanded single-run view; the collapsed view never reaches this path. */
878
- function buildSingleWidgetLines(job, theme, width) {
879
- const stats = widgetStats(job, theme);
880
- const count = job.mode === "chain" ? job.chainStepCount : job.stepsTotal ?? job.agents?.length ?? job.steps?.length;
881
- const mode = widgetJobName(job);
882
- const title = `async subagent ${mode}${count && count > 1 ? ` (${count})` : ""}`;
883
- return [
884
- `${theme.fg("toolTitle", themeBold(theme, title))} ${theme.fg("dim", "· background")}`,
885
- `${widgetStatusGlyph(job, theme)} ${themeBold(theme, mode)}${stats ? ` ${theme.fg("dim", "·")} ${stats}` : ""}`,
886
- ...foregroundStyleWidgetDetails(job, theme, width),
887
- ].map((line) => truncLine(line, width));
888
- }
889
- /** Collapsed rows carry the live tool inline, since detail lines wait for Ctrl+O. */
890
- function collapsedJobRow(job, theme, width) {
891
- const stats = widgetStats(job, theme);
892
- // The job root mirrors an active step's tool but drops its args, so prefer the step itself.
893
- const runningSteps = job.steps?.filter((step) => step.status === "running") ?? [];
894
- const soloStep = runningSteps.length === 1 ? runningSteps[0] : undefined;
895
- const activity = job.status !== "running"
896
- ? widgetActivity(job, false)
897
- : soloStep
898
- ? widgetStepActivityLine(soloStep, width, false, job.updatedAt)
899
- : widgetActivity(job, false);
900
- return `${widgetStatusGlyph(job, theme)} ${themeBold(theme, widgetJobName(job))}${stats ? ` ${theme.fg("dim", "·")} ${stats}` : ""}${activity ? ` ${theme.fg("dim", "·")} ${theme.fg("dim", activity)}` : ""}`;
901
- }
902
- function fitWidgetLineBudget(lines, theme, width, expanded) {
903
- const rows = process.stdout.rows || 30;
904
- const budget = expanded
905
- ? Math.max(4, Math.min(24, Math.floor(rows * 0.4)))
906
- : MAX_WIDGET_JOBS + 2;
907
- if (lines.length <= budget)
908
- return lines;
909
- const visibleLines = Math.max(1, budget - 1);
910
- const hiddenCount = lines.length - visibleLines;
911
- const hint = expanded
912
- ? `… ${hiddenCount} live-detail lines hidden`
913
- : `… ${hiddenCount} lines hidden · Ctrl+O expands`;
914
- return [...lines.slice(0, visibleLines), truncLine(theme.fg("dim", hint), width)];
915
- }
916
- function buildWidgetComponent(jobs, isExpanded) {
917
- return (_tui, theme) => ({
918
- render(availableWidth) {
919
- // Text pads one column on each side, so build against its inner width on every render.
920
- const width = Math.max(1, availableWidth - 2);
921
- const expanded = isExpanded();
922
- const lines = fitWidgetLineBudget(buildWidgetLines(jobs, theme, width, expanded), theme, width, expanded);
923
- const container = new Container();
924
- for (const line of lines)
925
- container.addChild(new Text(line, 1, 0));
926
- return container.render(availableWidth);
927
- },
928
- invalidate() { },
929
- });
930
- }
931
- export function buildWidgetLines(jobs, theme, width = getTermWidth(), expanded = false) {
932
- if (jobs.length === 0)
933
- return [];
934
- if (jobs.length === 1 && expanded)
935
- return buildSingleWidgetLines(jobs[0], theme, width);
936
- const running = jobs.filter((job) => job.status === "running");
937
- const queued = jobs.filter((job) => job.status === "queued");
938
- const finished = jobs.filter((job) => job.status !== "running" && job.status !== "queued");
939
- const jobItem = (job) => {
940
- if (!expanded)
941
- return [collapsedJobRow(job, theme, width)];
942
- const stats = widgetStats(job, theme);
943
- return [
944
- `${widgetStatusGlyph(job, theme)} ${themeBold(theme, widgetJobName(job))}${stats ? ` ${theme.fg("dim", "·")} ${stats}` : ""}`,
945
- ` ${theme.fg("dim", `⎿ ${widgetActivity(job)}`)}`,
946
- ...widgetParallelAgentDetails(job, theme, width),
947
- ];
948
- };
949
- const items = [];
950
- let hiddenRunning = 0;
951
- let hiddenFinished = 0;
952
- let queuedShown = false;
953
- let slots = MAX_WIDGET_JOBS;
954
- for (const job of running) {
955
- if (slots <= 0) {
956
- hiddenRunning++;
957
- continue;
958
- }
959
- items.push(jobItem(job));
960
- slots--;
961
- }
962
- if (queued.length > 0 && slots > 0) {
963
- // One collapsed queued run has room for its own name; a backlog collapses to a count.
964
- items.push(queued.length === 1 && !expanded ? jobItem(queued[0]) : [`${theme.fg("muted", "◦")} ${theme.fg("dim", `${queued.length} queued`)}`]);
965
- queuedShown = true;
966
- slots--;
967
- }
968
- for (const job of finished) {
969
- if (slots <= 0) {
970
- hiddenFinished++;
971
- continue;
972
- }
973
- items.push(jobItem(job));
974
- slots--;
975
- }
976
- const hiddenQueued = queued.length > 0 && !queuedShown ? queued.length : 0;
977
- const hiddenTotal = hiddenRunning + hiddenFinished + hiddenQueued;
978
- if (hiddenTotal > 0) {
979
- const parts = [];
980
- if (hiddenRunning > 0)
981
- parts.push(`${hiddenRunning} running`);
982
- if (hiddenQueued > 0)
983
- parts.push(`${hiddenQueued} queued`);
984
- if (hiddenFinished > 0)
985
- parts.push(`${hiddenFinished} finished`);
986
- items.push([theme.fg("dim", `+${hiddenTotal} more (${parts.join(", ")})`)]);
987
- }
988
- const hint = running.length > 0 && !expanded ? ` ${theme.fg("dim", "·")} ${theme.fg("accent", "Ctrl+O")}` : "";
989
- if (items.length === 1 && !expanded)
990
- return [truncLine(`${items[0][0]}${hint}`, width)];
991
- const lines = [];
992
- const hasActive = running.length > 0 || queued.length > 0;
993
- const headerGlyph = running.length > 0 ? runningGlyph(widgetJobsRunningSeed(running)) : hasActive ? "●" : "○";
994
- lines.push(truncLine(`${theme.fg(hasActive ? "accent" : "dim", headerGlyph)} ${theme.fg(hasActive ? "accent" : "dim", "Async agents")} ${theme.fg("dim", "· background")}${hint}`, width));
995
- for (let i = 0; i < items.length; i++) {
996
- const item = items[i];
997
- const last = i === items.length - 1;
998
- const branch = last ? "└─" : "├─";
999
- const continuation = last ? " " : "│ ";
1000
- lines.push(truncLine(`${theme.fg("dim", branch)} ${item[0]}`, width));
1001
- for (const detail of item.slice(1)) {
1002
- lines.push(truncLine(`${theme.fg("dim", continuation)} ${detail}`, width));
1003
- }
1004
- }
1005
- return lines;
1006
- }
1007
- /**
1008
- * Render the async jobs widget
1009
- */
1010
- export function renderWidget(ctx, jobs) {
1011
- if (jobs.length === 0) {
1012
- if (isTuiContext(ctx))
1013
- ctx.ui.setWidget(WIDGET_KEY, undefined);
1
+ import { keyText } from "@earendil-works/pi-coding-agent";
2
+ import { Container, Text, TruncatedText } from "@earendil-works/pi-tui";
3
+ import { firstOutputLine, getTermWidth, truncLine } from "./display.js";
4
+ import { renderSingleCompact, renderMultiCompact } from "./compact-results.js";
5
+ import { renderSingleExpanded } from "./expanded-single.js";
6
+ import { renderMultiExpanded } from "./expanded-multi.js";
7
+ import { workflowFacts } from "./result-facts.js";
8
+ import { hasText } from "./text-values.js";
9
+ export { widgetRenderKey } from "./widget-status.js";
10
+ export { buildWidgetLines, renderWidget } from "./widget.js";
11
+ function asyncReceipt(d, text, prefix, theme) {
12
+ if (!d || !hasText(d.asyncId) || d.mode === "management") {
1014
13
  return;
1015
14
  }
1016
- if (!isTuiContext(ctx))
1017
- return;
1018
- ctx.ui.setWidget(WIDGET_KEY, buildWidgetComponent(jobs, () => ctx.ui.getToolsExpanded()));
1019
- }
1020
- function renderSingleCompact(d, r, theme, isError = false) {
1021
- const expandKey = keyText("app.tools.expand");
1022
- const output = r.truncation?.text || getSingleResultOutput(r);
1023
- const statusOutput = output || (d.intercomDelivery?.delivered ? d.intercomDelivery.summary : "");
1024
- const progress = r.progress || r.progressSummary;
1025
- const isRunning = !isError && r.progress?.status === "running";
1026
- const contextBadge = d.context === "fork" ? theme.fg("warning", " [fork]") : "";
1027
- const stats = statJoin(theme, [
1028
- r.usage?.turns ? `⟳ ${r.usage.turns}` : "",
1029
- formatProgressStats(theme, progress),
1030
- ]);
15
+ const headline = hasText(d.managementControl?.revivedFromRunId)
16
+ ? "Revived async"
17
+ : firstOutputLine(text).replace(` [${d.asyncId}]`, "");
1031
18
  const c = new Container();
1032
- const width = getTermWidth() - 4;
1033
- const modelDisplay = modelThinkingBadge(theme, r.model);
1034
- c.addChild(new TruncatedText(`${isError ? theme.fg("error", "✗") : resultGlyph(r, statusOutput, theme, isRunning)} ${theme.fg("toolTitle", theme.bold(r.agent))}${modelDisplay}${contextBadge}${stats ? ` ${theme.fg("dim", "·")} ${stats}` : ""}`));
1035
- if (isRunning && r.progress) {
1036
- const progressSnapshotNow = snapshotNowForProgress(r.progress);
1037
- const activity = compactCurrentActivity(r.progress);
1038
- c.addChild(new Text(truncLine(theme.fg("dim", ` ⎿ ${activity}`), width), 0, 0));
1039
- const liveStatus = buildLiveStatusLine(r.progress, progressSnapshotNow);
1040
- if (liveStatus && liveStatus !== activity)
1041
- c.addChild(new Text(truncLine(theme.fg("dim", ` ${liveStatus}`), width), 0, 0));
1042
- if (expandKey)
1043
- c.addChild(new Text(truncLine(theme.fg("accent", ` Press ${expandKey} for live detail`), width), 0, 0));
1044
- if (r.artifactPaths)
1045
- c.addChild(new Text(truncLine(theme.fg("dim", ` output: ${shortenPath(r.artifactPaths.outputPath)}`), width), 0, 0));
1046
- return c;
1047
- }
1048
- c.addChild(new TruncatedText(theme.fg("dim", ` ⎿ ${resultStatusLine(r, statusOutput)}`)));
1049
- const preview = firstOutputLine(output);
1050
- if (preview && r.exitCode === 0 && !hasEmptyTextOutputWithoutOutputTarget(r.task, output)) {
1051
- c.addChild(new TruncatedText(theme.fg("dim", ` ${preview}`)));
1052
- }
1053
- if (r.sessionFile)
1054
- c.addChild(new TruncatedText(theme.fg("dim", ` session: ${shortenPath(r.sessionFile)}`)));
1055
- if (r.artifactPaths)
1056
- c.addChild(new TruncatedText(theme.fg("dim", ` output: ${shortenPath(r.artifactPaths.outputPath)}`)));
1057
- if (r.truncation?.artifactPath)
1058
- c.addChild(new TruncatedText(theme.fg("dim", ` full output: ${shortenPath(r.truncation.artifactPath)}`)));
1059
- c.addChild(new TruncatedText(theme.fg("dim", ` ${keyText("app.tools.expand")} ${d.intercomDelivery?.delivered ? "receipt details" : "full response"}`)));
19
+ c.addChild(new TruncatedText(`${prefix}[${d.asyncId.slice(0, 8)}] ${headline}`));
20
+ c.addChild(new TruncatedText(theme.fg("dim", `${keyText("app.tools.expand")} details`)));
1060
21
  return c;
1061
22
  }
1062
- function renderMultiCompact(d, theme, isError = false) {
1063
- const expandKey = keyText("app.tools.expand");
1064
- const hasRunning = !isError && (d.progress?.some((p) => p.status === "running")
1065
- || d.results.some((r) => r.progress?.status === "running")
1066
- || workflowGraphHasStatus(d, ["running"]));
1067
- const failed = isError || d.results.some((r) => r.exitCode !== 0 && r.progress?.status !== "running")
1068
- || workflowGraphHasStatus(d, ["failed", "timed-out"]);
1069
- const blocked = d.results.some((r) => r.acceptance?.status === "blocked" && r.exitCode === 0);
1070
- const paused = d.results.some((r) => (r.interrupted || r.detached) && r.progress?.status !== "running")
1071
- || workflowGraphHasStatus(d, ["paused", "detached"]);
1072
- let totalSummary = d.progressSummary;
1073
- if (!totalSummary) {
1074
- let sawProgress = false;
1075
- const summary = { toolCount: 0, tokens: 0, durationMs: 0 };
1076
- for (const r of d.results) {
1077
- const prog = r.progress || r.progressSummary;
1078
- if (!prog)
1079
- continue;
1080
- sawProgress = true;
1081
- summary.toolCount += prog.toolCount;
1082
- summary.tokens += prog.tokens;
1083
- summary.durationMs = d.mode === "chain" ? summary.durationMs + prog.durationMs : Math.max(summary.durationMs, prog.durationMs);
1084
- }
1085
- if (sawProgress)
1086
- totalSummary = summary;
23
+ function compactText(text, prefix, theme) {
24
+ const lines = text.replace(/\n+$/, "").split("\n");
25
+ if (lines.length === 1) {
26
+ return new Text(truncLine(`${prefix}${lines[0] ?? ""}`, getTermWidth() - 4), 0, 0);
1087
27
  }
1088
- const multiLabel = buildMultiProgressLabel(d, hasRunning);
1089
- const itemTitle = multiLabel.itemTitle;
1090
- const stats = statJoin(theme, [multiLabel.headerLabel, formatProgressStats(theme, totalSummary)]);
1091
- const glyph = hasRunning
1092
- ? theme.fg("accent", runningGlyph(runningSeed(progressRunningSeed(totalSummary), d.currentStepIndex)))
1093
- : failed
1094
- ? theme.fg("error", "✗")
1095
- : paused || blocked
1096
- ? theme.fg("warning", "■")
1097
- : theme.fg("success", "✓");
1098
- const contextBadge = d.context === "fork" ? theme.fg("warning", " [fork]") : "";
1099
- const c = new Container();
1100
- const width = getTermWidth() - 4;
1101
- c.addChild(new TruncatedText(`${glyph} ${theme.fg("toolTitle", theme.bold(d.mode))}${contextBadge}${stats ? ` ${theme.fg("dim", "·")} ${stats}` : ""}`));
1102
- const useResultsDirectly = multiLabel.hasParallelInChain || !d.chainAgents?.length;
1103
- const displayStart = multiLabel.showActiveGroupOnly ? multiLabel.groupStartIndex : 0;
1104
- const displayEnd = multiLabel.showActiveGroupOnly ? multiLabel.groupEndIndex : (useResultsDirectly ? d.results.length : d.chainAgents.length);
1105
- const chainEntries = buildChainRenderEntries(d, multiLabel);
1106
- const renderEntries = chainEntries ?? Array.from({ length: displayEnd - displayStart }, (_, offset) => {
1107
- const i = displayStart + offset;
1108
- const r = d.results[i];
1109
- const fallbackLabel = itemTitle.toLowerCase();
1110
- const rowNumber = multiLabel.showActiveGroupOnly ? (i - multiLabel.groupStartIndex + 1) : (i + 1);
1111
- return { kind: "result", resultIndex: i, rowNumber, agentName: useResultsDirectly ? (r?.agent || `${fallbackLabel}-${rowNumber}`) : (d.chainAgents[i] || r?.agent || `${fallbackLabel}-${rowNumber}`) };
1112
- });
1113
- const maxCompactRows = 6;
1114
- const visibleEntries = hasRunning || failed || paused || blocked ? renderEntries : renderEntries.slice(0, maxCompactRows);
1115
- let showLiveDetailHint = false;
1116
- for (const entry of visibleEntries) {
1117
- if (entry.kind === "placeholder") {
1118
- const glyph = widgetStepGlyph(entry.status, theme);
1119
- const statusLabel = widgetStepStatus(entry.status, theme);
1120
- c.addChild(new TruncatedText(` ${glyph} ${entry.stepLabel}: ${themeBold(theme, entry.agentName)} ${theme.fg("dim", "·")} ${statusLabel}`));
1121
- if (entry.error)
1122
- c.addChild(new TruncatedText(theme.fg("error", ` ⎿ Error: ${entry.error}`)));
1123
- continue;
1124
- }
1125
- const i = entry.resultIndex;
1126
- const r = d.results[i];
1127
- const rowNumber = entry.rowNumber;
1128
- const agentName = entry.agentName;
1129
- if (!r) {
1130
- const pendingLabel = chainEntries ? resultRowLabel(d, multiLabel, i, rowNumber) : `${itemTitle} ${rowNumber}`;
1131
- c.addChild(new TruncatedText(theme.fg("dim", ` ◦ ${pendingLabel}: ${agentName} · pending`)));
1132
- continue;
1133
- }
1134
- const output = getSingleResultOutput(r) || (d.intercomDelivery?.delivered ? d.intercomDelivery.summary : "");
1135
- const progressFromArray = d.progress?.find((p) => p.index === i) || d.progress?.find((p) => p.agent === r.agent && p.status === "running");
1136
- const rProg = r.progress || progressFromArray || r.progressSummary;
1137
- const rRunning = rProg && "status" in rProg && rProg.status === "running";
1138
- const rPending = rProg && "status" in rProg && rProg.status === "pending";
1139
- const stepNumber = r.progress?.index !== undefined ? r.progress.index + 1 : progressFromArray?.index !== undefined ? progressFromArray.index + 1 : i + 1;
1140
- const stepStats = formatProgressStats(theme, rProg);
1141
- const glyph = rPending ? theme.fg("dim", "◦") : resultGlyph(r, output, theme, rRunning, progressRunningSeed(rProg));
1142
- const pendingLabel = rPending ? ` ${theme.fg("dim", "· pending")}` : "";
1143
- const stepLabel = resultRowLabel(d, multiLabel, i, stepNumber);
1144
- const line = `${glyph} ${stepLabel}: ${themeBold(theme, agentName)}${modelStat(theme, r.model)}${stepStats ? ` ${theme.fg("dim", "·")} ${stepStats}` : ""}${pendingLabel}`;
1145
- c.addChild(new TruncatedText(` ${line}`));
1146
- if (rRunning && rProg && "status" in rProg) {
1147
- const activity = compactCurrentActivity(rProg);
1148
- c.addChild(new Text(truncLine(theme.fg("dim", ` ⎿ ${activity}`), width), 0, 0));
1149
- showLiveDetailHint = true;
1150
- }
1151
- else if (!rPending && (r.exitCode !== 0 || r.interrupted || r.detached || r.timedOut || r.acceptance?.status === "blocked" || hasEmptyTextOutputWithoutOutputTarget(r.task, output))) {
1152
- c.addChild(new TruncatedText(theme.fg(r.exitCode !== 0 ? "error" : "dim", ` ⎿ ${resultStatusLine(r, output)}`)));
1153
- }
1154
- const outputTarget = extractOutputTarget(r.task);
1155
- if (outputTarget)
1156
- c.addChild(new TruncatedText(theme.fg("dim", ` output: ${outputTarget}`)));
1157
- if (r.artifactPaths)
1158
- c.addChild(new TruncatedText(theme.fg("dim", ` output: ${shortenPath(r.artifactPaths.outputPath)}`)));
28
+ const visible = lines.slice(0, 12), expand = keyText("app.tools.expand");
29
+ if (lines.length > visible.length) {
30
+ visible.push(theme.fg("dim", `+${lines.length - visible.length} more${hasText(expand) ? ` · ${expand} expands` : ""}`));
1159
31
  }
1160
- if (renderEntries.length > visibleEntries.length)
1161
- c.addChild(new Text(theme.fg("dim", ` +${renderEntries.length - visibleEntries.length} more${expandKey ? ` · ${expandKey} expands` : ""}`), 0, 0));
1162
- if (showLiveDetailHint && expandKey)
1163
- c.addChild(new Text(theme.fg("accent", ` Press ${expandKey} for live detail`), 0, 0));
1164
- if (d.artifacts)
1165
- c.addChild(new TruncatedText(theme.fg("dim", ` artifacts: ${shortenPath(d.artifacts.dir)}`)));
1166
- if (!hasRunning)
1167
- c.addChild(new TruncatedText(theme.fg("dim", ` ${keyText("app.tools.expand")} ${d.intercomDelivery?.delivered ? "receipt details" : "full response"}`)));
1168
- return c;
32
+ return new Text(`${prefix}${visible.join("\n")}`, 0, 0);
1169
33
  }
1170
- /**
1171
- * Render a subagent result
1172
- */
1173
- export function renderSubagentResult(result, options, theme, context) {
1174
- const isError = context?.isError ?? result.isError;
1175
- const expandKey = keyText("app.tools.expand");
1176
- const d = result.details;
1177
- if (!d || !d.results.length) {
1178
- const t = result.content[0];
1179
- const text = t?.type === "text" ? t.text : "(no output)";
1180
- const contextPrefix = d?.context === "fork" ? `${theme.fg("warning", "[fork]")} ` : "";
1181
- if (options.expanded)
1182
- return new Text(`${contextPrefix}${text}`, 0, 0);
1183
- if (d?.asyncId && d.mode !== "management" && !isError) {
1184
- const headline = d.managementControl?.revivedFromRunId ? "Revived async" : firstOutputLine(text).replace(` [${d.asyncId}]`, "");
1185
- const c = new Container();
1186
- c.addChild(new TruncatedText(`${contextPrefix}[${d.asyncId.slice(0, 8)}] ${headline}`));
1187
- c.addChild(new TruncatedText(theme.fg("dim", `${keyText("app.tools.expand")} details`)));
1188
- return c;
1189
- }
1190
- const maxCompactLines = 12;
1191
- const lines = text.replace(/\n+$/, "").split("\n");
1192
- if (lines.length === 1)
1193
- return new Text(truncLine(`${contextPrefix}${lines[0]}`, getTermWidth() - 4), 0, 0);
1194
- const visibleLines = lines.slice(0, maxCompactLines);
1195
- if (lines.length > visibleLines.length)
1196
- visibleLines.push(theme.fg("dim", `+${lines.length - visibleLines.length} more${expandKey ? ` · ${expandKey} expands` : ""}`));
1197
- return new Text(`${contextPrefix}${visibleLines.join("\n")}`, 0, 0);
34
+ function textResult(result, expanded, theme, isError) {
35
+ const d = result.details, first = result.content.at(0), text = first?.type === "text" ? first.text : "(no output)";
36
+ const prefix = d?.context === "fork" ? `${theme.fg("warning", "[fork]")} ` : "";
37
+ if (expanded) {
38
+ return new Text(`${prefix}${text}`, 0, 0);
1198
39
  }
1199
- const expanded = options.expanded;
1200
- const hasWorkflowFailure = workflowGraphHasStatus(d, ["failed", "timed-out"]);
1201
- const hasWorkflowBlocked = d.results.some((r) => r.exitCode === 0 && r.acceptance?.status === "blocked") || workflowGraphHasStatus(d, ["blocked"]);
1202
- const hasWorkflowPause = d.results.some((r) => r.interrupted || r.detached)
1203
- || workflowGraphHasStatus(d, ["paused", "detached"]);
1204
- const receiptText = expanded && (isError || hasWorkflowFailure || hasWorkflowBlocked || hasWorkflowPause || d.intercomDelivery?.delivered)
1205
- ? result.content.filter((part) => part.type === "text").map((part) => part.text).join("\n")
40
+ const receipt = isError ? undefined : asyncReceipt(d, text, prefix, theme);
41
+ return receipt ?? compactText(text, prefix, theme);
42
+ }
43
+ function singleResult(d) {
44
+ return d.mode === "single" && d.results.length === 1;
45
+ }
46
+ function expandedResult(result, d, theme, isError) {
47
+ const facts = workflowFacts(d, isError), showRun = isError || facts.failed || facts.blocked || facts.paused;
48
+ const receipt = showRun || d.intercomDelivery?.delivered === true
49
+ ? result.content
50
+ .filter((part) => part.type === "text")
51
+ .map((part) => part.text)
52
+ .join("\n")
1206
53
  : undefined;
1207
- const mdTheme = getMarkdownTheme();
1208
- if (d.mode === "single" && d.results.length === 1) {
1209
- const r = d.results[0];
1210
- if (!expanded)
1211
- return renderSingleCompact(d, r, theme, isError);
1212
- const isRunning = !isError && r.progress?.status === "running";
1213
- const icon = isRunning
1214
- ? theme.fg("warning", "running")
1215
- : isError || r.timedOut
1216
- ? theme.fg("error", "failed")
1217
- : r.detached || r.interrupted
1218
- ? theme.fg("warning", r.detached ? "detached" : "paused")
1219
- : r.exitCode === 0
1220
- ? r.acceptance?.status === "blocked" ? theme.fg("warning", "needs your action") : theme.fg("success", "ok")
1221
- : theme.fg("error", "failed");
1222
- const contextBadge = d.context === "fork" ? theme.fg("warning", " [fork]") : "";
1223
- const output = r.truncation?.text || getSingleResultOutput(r);
1224
- const progressInfo = isRunning && r.progress
1225
- ? ` | ${r.progress.toolCount} tools, ${formatTokens(r.progress.tokens)} tok, ${formatDuration(r.progress.durationMs)}`
1226
- : r.progressSummary
1227
- ? ` | ${r.progressSummary.toolCount} tools, ${formatTokens(r.progressSummary.tokens)} tok, ${formatDuration(r.progressSummary.durationMs)}`
1228
- : "";
1229
- const w = getTermWidth() - 4;
1230
- const fit = (text) => expanded ? text : truncLine(text, w);
1231
- const toolCallLines = getToolCallLines(r, expanded);
1232
- const c = new Container();
1233
- c.addChild(new Text(fit(`${icon} ${theme.fg("toolTitle", theme.bold(r.agent))}${contextBadge}${progressInfo}`), 0, 0));
1234
- if ((isError || hasWorkflowFailure || hasWorkflowBlocked || hasWorkflowPause) && d.runId)
1235
- c.addChild(new Text(theme.fg("dim", `Run: ${d.runId}`), 0, 0));
1236
- c.addChild(new Spacer(1));
1237
- const taskMaxLen = Math.max(20, w - 8);
1238
- const taskPreview = expanded || r.task.length <= taskMaxLen
1239
- ? r.task
1240
- : `${r.task.slice(0, taskMaxLen)}...`;
1241
- c.addChild(new Text(fit(theme.fg("dim", `Task: ${taskPreview}`)), 0, 0));
1242
- c.addChild(new Spacer(1));
1243
- if (isRunning && r.progress) {
1244
- const progressSnapshotNow = snapshotNowForProgress(r.progress);
1245
- const toolLine = formatCurrentToolLine(r.progress, w, expanded, progressSnapshotNow);
1246
- if (toolLine) {
1247
- c.addChild(new Text(fit(theme.fg("warning", `> ${toolLine}`)), 0, 0));
1248
- }
1249
- const liveStatusLine = buildLiveStatusLine(r.progress, progressSnapshotNow);
1250
- if (liveStatusLine) {
1251
- c.addChild(new Text(fit(theme.fg("accent", liveStatusLine)), 0, 0));
1252
- }
1253
- if (expandKey)
1254
- c.addChild(new Text(fit(theme.fg("accent", `Press ${expandKey} for live detail`)), 0, 0));
1255
- if (r.artifactPaths) {
1256
- c.addChild(new Text(fit(theme.fg("dim", `Artifacts: ${shortenPath(r.artifactPaths.outputPath)}`)), 0, 0));
1257
- }
1258
- if (r.progress.recentTools?.length) {
1259
- for (const t of r.progress.recentTools.slice(-3)) {
1260
- const maxArgsLen = Math.max(40, w - 24);
1261
- const argsPreview = expanded || t.args.length <= maxArgsLen
1262
- ? t.args
1263
- : `${t.args.slice(0, maxArgsLen)}...`;
1264
- c.addChild(new Text(fit(theme.fg("dim", `${t.tool}: ${argsPreview}`)), 0, 0));
1265
- }
1266
- }
1267
- for (const line of (r.progress.recentOutput ?? []).slice(-5)) {
1268
- c.addChild(new Text(fit(theme.fg("dim", ` ${line}`)), 0, 0));
1269
- }
1270
- if (toolLine || liveStatusLine || r.progress.recentTools?.length || r.progress.recentOutput?.length || r.artifactPaths) {
1271
- c.addChild(new Spacer(1));
1272
- }
1273
- }
1274
- if (expanded) {
1275
- for (const line of toolCallLines) {
1276
- c.addChild(new Text(fit(theme.fg("muted", line)), 0, 0));
1277
- }
1278
- if (toolCallLines.length)
1279
- c.addChild(new Spacer(1));
1280
- }
1281
- if (r.error && !output.includes(r.error))
1282
- c.addChild(new Text(theme.fg("error", r.error), 0, 0));
1283
- if (output)
1284
- c.addChild(new Markdown(output, 0, 0, mdTheme));
1285
- if (receiptText)
1286
- c.addChild(new Text(receiptText, 0, 0));
1287
- c.addChild(new Spacer(1));
1288
- if (r.skills?.length) {
1289
- c.addChild(new Text(fit(theme.fg("dim", `Skills: ${r.skills.join(", ")}`)), 0, 0));
1290
- }
1291
- if (r.skillsWarning) {
1292
- c.addChild(new Text(fit(theme.fg("warning", `Warning: ${r.skillsWarning}`)), 0, 0));
1293
- }
1294
- if (r.attemptedModels && r.attemptedModels.length > 1) {
1295
- c.addChild(new Text(fit(theme.fg("dim", `Fallbacks: ${r.attemptedModels.join(" → ")}`)), 0, 0));
1296
- }
1297
- c.addChild(new Text(fit(theme.fg("dim", [formatUsage(r.usage, r.model), r.accounting?.state === "incomplete" ? "accounting incomplete · reported totals only" : undefined].filter(Boolean).join(" · "))), 0, 0));
1298
- if (!isRunning)
1299
- c.addChild(new Text(fit(theme.fg("dim", formatAgentProcessExit(r.agentProcessExit))), 0, 0));
1300
- if (r.sessionFile) {
1301
- c.addChild(new Text(fit(theme.fg("dim", `Session: ${shortenPath(r.sessionFile)}`)), 0, 0));
1302
- }
1303
- if (!isRunning && r.artifactPaths) {
1304
- c.addChild(new Spacer(1));
1305
- c.addChild(new Text(fit(theme.fg("dim", `Artifacts: ${shortenPath(r.artifactPaths.outputPath)}`)), 0, 0));
1306
- }
1307
- return c;
1308
- }
1309
- if (!expanded)
1310
- return renderMultiCompact(d, theme, isError);
1311
- const hasRunning = !isError && (d.progress?.some((p) => p.status === "running")
1312
- || d.results.some((r) => r.progress?.status === "running")
1313
- || workflowGraphHasStatus(d, ["running"]));
1314
- const hasFailure = isError || hasWorkflowFailure || d.results.some((r) => (r.exitCode !== 0 || r.timedOut) && !r.interrupted && !r.detached && r.progress?.status !== "running");
1315
- const hasEmptyWithoutTarget = !d.intercomDelivery?.delivered && d.results.some((r) => r.exitCode === 0
1316
- && r.progress?.status !== "running"
1317
- && hasEmptyTextOutputWithoutOutputTarget(r.task, getSingleResultOutput(r)));
1318
- const icon = hasRunning
1319
- ? theme.fg("warning", "running")
1320
- : hasFailure
1321
- ? theme.fg("error", "failed")
1322
- : hasWorkflowBlocked
1323
- ? theme.fg("warning", "needs your action")
1324
- : hasWorkflowPause
1325
- ? theme.fg("warning", "paused")
1326
- : hasEmptyWithoutTarget
1327
- ? theme.fg("warning", "warning")
1328
- : theme.fg("success", "ok");
1329
- const totalSummary = d.progressSummary ||
1330
- d.results.reduce((acc, r) => {
1331
- const prog = r.progress || r.progressSummary;
1332
- if (prog) {
1333
- acc.toolCount += prog.toolCount;
1334
- acc.tokens += prog.tokens;
1335
- acc.durationMs =
1336
- d.mode === "chain"
1337
- ? acc.durationMs + prog.durationMs
1338
- : Math.max(acc.durationMs, prog.durationMs);
1339
- }
1340
- return acc;
1341
- }, { toolCount: 0, tokens: 0, durationMs: 0 });
1342
- const summaryStr = totalSummary.toolCount || totalSummary.tokens
1343
- ? ` | ${totalSummary.toolCount} tools, ${formatTokens(totalSummary.tokens)} tok, ${formatDuration(totalSummary.durationMs)}`
1344
- : "";
1345
- const modeLabel = d.mode;
1346
- const contextBadge = d.context === "fork" ? theme.fg("warning", " [fork]") : "";
1347
- const multiLabel = buildMultiProgressLabel(d, hasRunning);
1348
- if (!hasRunning)
1349
- multiLabel.showActiveGroupOnly = false;
1350
- const itemTitle = multiLabel.itemTitle;
1351
- const chainVis = d.chainAgents?.length && !multiLabel.hasParallelInChain
1352
- ? d.chainAgents
1353
- .map((agent, i) => {
1354
- const result = d.results[i];
1355
- const isFailed = result && result.exitCode !== 0 && result.progress?.status !== "running";
1356
- const isComplete = result && isDoneResult(result);
1357
- const isEmptyWithoutTarget = !d.intercomDelivery?.delivered && Boolean(result)
1358
- && Boolean(isComplete)
1359
- && hasEmptyTextOutputWithoutOutputTarget(result.task, getSingleResultOutput(result));
1360
- const isCurrent = i === (d.currentStepIndex ?? d.results.length);
1361
- const stepIcon = isFailed
1362
- ? theme.fg("error", "failed")
1363
- : result?.acceptance?.status === "blocked" ? theme.fg("warning", "needs your action")
1364
- : result?.interrupted || result?.detached ? theme.fg("warning", result.detached ? "detached" : "paused")
1365
- : isEmptyWithoutTarget
1366
- ? theme.fg("warning", "warning")
1367
- : isComplete
1368
- ? theme.fg("success", "done")
1369
- : isCurrent && hasRunning
1370
- ? theme.fg("warning", "running")
1371
- : theme.fg("dim", "pending");
1372
- return `${stepIcon} ${agent}`;
1373
- })
1374
- .join(theme.fg("dim", " → "))
1375
- : null;
1376
- const w = getTermWidth() - 4;
1377
- const fit = (text) => expanded ? text : truncLine(text, w);
1378
- const c = new Container();
1379
- c.addChild(new Text(fit(`${icon} ${theme.fg("toolTitle", theme.bold(modeLabel))}${contextBadge} · ${multiLabel.headerLabel}${summaryStr}`), 0, 0));
1380
- if ((isError || hasWorkflowFailure || hasWorkflowBlocked || hasWorkflowPause) && d.runId)
1381
- c.addChild(new Text(theme.fg("dim", `Run: ${d.runId}`), 0, 0));
1382
- if (chainVis) {
1383
- c.addChild(new Text(fit(` ${chainVis}`), 0, 0));
54
+ const settings = { isError, showRun, receipt }, first = d.results.at(0);
55
+ if (singleResult(d) && first) {
56
+ return renderSingleExpanded(d, first, theme, settings);
1384
57
  }
1385
- if (receiptText)
1386
- c.addChild(new Text(receiptText, 0, 0));
1387
- const useResultsDirectly = multiLabel.hasParallelInChain || !d.chainAgents?.length;
1388
- const displayStart = multiLabel.showActiveGroupOnly ? multiLabel.groupStartIndex : 0;
1389
- const displayEnd = multiLabel.showActiveGroupOnly ? multiLabel.groupEndIndex : (useResultsDirectly ? d.results.length : d.chainAgents.length);
1390
- const chainEntries = buildChainRenderEntries(d, multiLabel);
1391
- const renderEntries = chainEntries ?? Array.from({ length: displayEnd - displayStart }, (_, offset) => {
1392
- const i = displayStart + offset;
1393
- const r = d.results[i];
1394
- const rowNumber = multiLabel.showActiveGroupOnly ? (i - multiLabel.groupStartIndex + 1) : (i + 1);
1395
- return { kind: "result", resultIndex: i, rowNumber, agentName: useResultsDirectly ? (r?.agent || `step-${rowNumber}`) : (d.chainAgents[i] || r?.agent || `step-${rowNumber}`) };
1396
- });
1397
- c.addChild(new Spacer(1));
1398
- for (const entry of renderEntries) {
1399
- if (entry.kind === "placeholder") {
1400
- const statusLabel = widgetStepStatus(entry.status, theme);
1401
- c.addChild(new Text(fit(` ${statusLabel} ${entry.stepLabel}: ${theme.bold(entry.agentName)}`), 0, 0));
1402
- c.addChild(new Text(theme.fg(entry.status === "failed" ? "error" : "dim", ` status: ${entry.status}`), 0, 0));
1403
- if (entry.error)
1404
- c.addChild(new Text(theme.fg("error", ` error: ${entry.error}`), 0, 0));
1405
- c.addChild(new Spacer(1));
1406
- continue;
1407
- }
1408
- const i = entry.resultIndex;
1409
- const r = d.results[i];
1410
- const rowNumber = entry.rowNumber;
1411
- const agentName = entry.agentName;
1412
- if (!r) {
1413
- const pendingLabel = chainEntries ? resultRowLabel(d, multiLabel, i, rowNumber) : `${itemTitle} ${rowNumber}`;
1414
- c.addChild(new Text(fit(theme.fg("dim", ` ${pendingLabel}: ${agentName}`)), 0, 0));
1415
- c.addChild(new Text(theme.fg("dim", ` status: pending`), 0, 0));
1416
- c.addChild(new Spacer(1));
1417
- continue;
1418
- }
1419
- const progressFromArray = d.progress?.find((p) => p.index === i)
1420
- || d.progress?.find((p) => p.agent === r.agent && p.status === "running");
1421
- const rProg = r.progress || progressFromArray || r.progressSummary;
1422
- const rRunning = rProg?.status === "running";
1423
- const stepNumber = typeof rProg?.index === "number" ? rProg.index + 1 : i + 1;
1424
- const resultOutput = r.truncation?.text || getSingleResultOutput(r);
1425
- const statusIcon = rRunning
1426
- ? theme.fg("warning", "running")
1427
- : r.detached || r.interrupted
1428
- ? theme.fg("warning", r.detached ? "detached" : "paused")
1429
- : r.exitCode !== 0
1430
- ? theme.fg("error", "failed")
1431
- : r.acceptance?.status === "blocked"
1432
- ? theme.fg("warning", "needs your action")
1433
- : !d.intercomDelivery?.delivered && hasEmptyTextOutputWithoutOutputTarget(r.task, resultOutput)
1434
- ? theme.fg("warning", "warning")
1435
- : theme.fg("success", "done");
1436
- const stats = rProg ? ` | ${rProg.toolCount} tools, ${formatDuration(rProg.durationMs)}` : "";
1437
- const modelDisplay = modelThinkingBadge(theme, r.model);
1438
- const stepLabel = resultRowLabel(d, multiLabel, i, stepNumber);
1439
- const stepHeader = rRunning
1440
- ? `${statusIcon} ${stepLabel}: ${theme.bold(theme.fg("warning", r.agent))}${modelDisplay}${stats}`
1441
- : `${statusIcon} ${stepLabel}: ${theme.bold(r.agent)}${modelDisplay}${stats}`;
1442
- const toolCallLines = getToolCallLines(r, expanded);
1443
- c.addChild(new Text(fit(stepHeader), 0, 0));
1444
- const taskMaxLen = Math.max(20, w - 12);
1445
- const taskPreview = expanded || r.task.length <= taskMaxLen
1446
- ? r.task
1447
- : `${r.task.slice(0, taskMaxLen)}...`;
1448
- c.addChild(new Text(fit(theme.fg("dim", ` task: ${taskPreview}`)), 0, 0));
1449
- const outputTarget = extractOutputTarget(r.task);
1450
- if (outputTarget) {
1451
- c.addChild(new Text(fit(theme.fg("dim", ` output: ${outputTarget}`)), 0, 0));
1452
- }
1453
- if (r.skills?.length) {
1454
- c.addChild(new Text(fit(theme.fg("dim", ` skills: ${r.skills.join(", ")}`)), 0, 0));
1455
- }
1456
- if (r.skillsWarning) {
1457
- c.addChild(new Text(fit(theme.fg("warning", ` Warning: ${r.skillsWarning}`)), 0, 0));
1458
- }
1459
- if (r.attemptedModels && r.attemptedModels.length > 1) {
1460
- c.addChild(new Text(fit(theme.fg("dim", ` model attempts: ${r.attemptedModels.join(" → ")}`)), 0, 0));
1461
- }
1462
- if (rRunning && rProg) {
1463
- if (rProg.skills?.length) {
1464
- c.addChild(new Text(fit(theme.fg("accent", ` skills: ${rProg.skills.join(", ")}`)), 0, 0));
1465
- }
1466
- const progressSnapshotNow = snapshotNowForProgress(rProg);
1467
- const toolLine = formatCurrentToolLine(rProg, w, expanded, progressSnapshotNow);
1468
- if (toolLine) {
1469
- c.addChild(new Text(fit(theme.fg("warning", ` > ${toolLine}`)), 0, 0));
1470
- }
1471
- const liveStatusLine = buildLiveStatusLine(rProg, progressSnapshotNow);
1472
- if (liveStatusLine) {
1473
- c.addChild(new Text(fit(theme.fg("accent", ` ${liveStatusLine}`)), 0, 0));
1474
- }
1475
- if (expandKey)
1476
- c.addChild(new Text(fit(theme.fg("accent", ` Press ${expandKey} for live detail`)), 0, 0));
1477
- if (r.artifactPaths) {
1478
- c.addChild(new Text(fit(theme.fg("dim", ` artifacts: ${shortenPath(r.artifactPaths.outputPath)}`)), 0, 0));
1479
- }
1480
- if (rProg.recentTools?.length) {
1481
- for (const t of rProg.recentTools.slice(-3)) {
1482
- const maxArgsLen = Math.max(40, w - 30);
1483
- const argsPreview = expanded || t.args.length <= maxArgsLen
1484
- ? t.args
1485
- : `${t.args.slice(0, maxArgsLen)}...`;
1486
- c.addChild(new Text(fit(theme.fg("dim", ` ${t.tool}: ${argsPreview}`)), 0, 0));
1487
- }
1488
- }
1489
- const recentLines = (rProg.recentOutput ?? []).slice(-5);
1490
- for (const line of recentLines) {
1491
- c.addChild(new Text(fit(theme.fg("dim", ` ${line}`)), 0, 0));
1492
- }
1493
- }
1494
- if (!rRunning && r.artifactPaths) {
1495
- c.addChild(new Text(fit(theme.fg("dim", ` artifacts: ${shortenPath(r.artifactPaths.outputPath)}`)), 0, 0));
1496
- }
1497
- if (expanded && !rRunning) {
1498
- for (const line of toolCallLines) {
1499
- c.addChild(new Text(fit(theme.fg("muted", ` ${line}`)), 0, 0));
1500
- }
1501
- if (toolCallLines.length)
1502
- c.addChild(new Spacer(1));
1503
- if (r.error && !resultOutput.includes(r.error))
1504
- c.addChild(new Text(theme.fg("error", r.error), 0, 0));
1505
- if (resultOutput)
1506
- c.addChild(new Markdown(resultOutput, 0, 0, mdTheme));
1507
- }
1508
- c.addChild(new Spacer(1));
58
+ return renderMultiExpanded(d, theme, settings);
59
+ }
60
+ export function renderSubagentResult(result, options, theme, context) {
61
+ const isError = context?.isError ?? result.isError ?? false, d = result.details;
62
+ if (!d || d.results.length === 0) {
63
+ return textResult(result, options.expanded, theme, isError);
1509
64
  }
1510
- if (d.artifacts) {
1511
- c.addChild(new Spacer(1));
1512
- c.addChild(new Text(fit(theme.fg("dim", `Artifacts dir: ${shortenPath(d.artifacts.dir)}`)), 0, 0));
65
+ if (options.expanded) {
66
+ return expandedResult(result, d, theme, isError);
1513
67
  }
1514
- return c;
68
+ const first = d.results.at(0);
69
+ return singleResult(d) && first
70
+ ? renderSingleCompact(d, first, theme, isError)
71
+ : renderMultiCompact(d, theme, isError);
1515
72
  }