@pi-unipi/unipi 3.0.0-alpha.2 → 3.0.0-alpha.21

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 (359) hide show
  1. package/CHANGELOG.md +292 -0
  2. package/README.md +8 -11
  3. package/docs/prefix-cache-architecture.md +14 -0
  4. package/package.json +22 -24
  5. package/packages/ask-user/README.md +55 -107
  6. package/packages/ask-user/ask-ui.ts +306 -732
  7. package/packages/ask-user/clipboard.ts +50 -0
  8. package/packages/ask-user/config.ts +74 -78
  9. package/packages/ask-user/package.json +2 -2
  10. package/packages/ask-user/questions.ts +151 -0
  11. package/packages/ask-user/skills/ask-user/SKILL.md +59 -133
  12. package/packages/ask-user/tools.ts +198 -432
  13. package/packages/autocomplete/package.json +1 -1
  14. package/packages/autocomplete/src/constants.ts +38 -43
  15. package/packages/autocomplete/src/sorting.ts +8 -0
  16. package/packages/background-tasks/package.json +2 -2
  17. package/packages/background-tasks/src/config.ts +0 -73
  18. package/packages/background-tasks/src/index.ts +20 -16
  19. package/packages/background-tasks/src/registry.ts +1 -171
  20. package/packages/background-tasks/src/types.ts +0 -32
  21. package/packages/btw/README.md +13 -56
  22. package/packages/btw/extensions/btw.ts +403 -1796
  23. package/packages/btw/package.json +5 -2
  24. package/packages/btw/skills/btw/SKILL.md +7 -143
  25. package/packages/compactor/README.md +56 -287
  26. package/packages/compactor/package.json +5 -9
  27. package/packages/compactor/skills/compactor/SKILL.md +13 -20
  28. package/packages/compactor/src/card.ts +90 -0
  29. package/packages/compactor/src/commands/index.ts +73 -130
  30. package/packages/compactor/src/compaction/compact-args.ts +5 -3
  31. package/packages/compactor/src/compaction/filter-noise.ts +1 -1
  32. package/packages/compactor/src/compaction/hooks.ts +487 -311
  33. package/packages/compactor/src/compaction/source.ts +178 -0
  34. package/packages/compactor/src/compaction/summarize.ts +586 -52
  35. package/packages/compactor/src/config/manager.ts +130 -127
  36. package/packages/compactor/src/config/schema.ts +32 -48
  37. package/packages/compactor/src/index.ts +40 -431
  38. package/packages/compactor/src/info-screen.ts +44 -190
  39. package/packages/compactor/src/session/recall-blocks.ts +1 -1
  40. package/packages/compactor/src/stats.ts +76 -0
  41. package/packages/compactor/src/tools/context-budget.ts +17 -34
  42. package/packages/compactor/src/tools/ctx-doctor.ts +45 -36
  43. package/packages/compactor/src/tools/register.ts +29 -269
  44. package/packages/compactor/src/types.ts +47 -186
  45. package/packages/core/README.md +25 -0
  46. package/packages/core/child-agent.ts +1 -0
  47. package/packages/core/command-echo.ts +63 -0
  48. package/packages/core/compaction-context.ts +41 -0
  49. package/packages/core/constants.ts +8 -38
  50. package/packages/core/events.ts +0 -53
  51. package/packages/core/fusion-status.ts +4 -0
  52. package/packages/core/global.d.ts +10 -0
  53. package/packages/core/harness-messages.ts +392 -0
  54. package/packages/core/index.ts +14 -0
  55. package/packages/core/kanboard-status.ts +49 -0
  56. package/packages/core/long-horizon-owner-status.ts +46 -0
  57. package/packages/core/model-cache.ts +81 -7
  58. package/packages/core/package.json +6 -3
  59. package/packages/core/src/attach/detect.ts +163 -0
  60. package/packages/core/src/child-agent/child-args.ts +31 -0
  61. package/packages/core/src/child-agent/delivery.ts +41 -0
  62. package/packages/core/src/child-agent/index.ts +5 -0
  63. package/packages/core/src/child-agent/readers.ts +203 -0
  64. package/packages/core/src/child-agent/runtime.ts +584 -0
  65. package/packages/core/src/evidence.ts +78 -0
  66. package/packages/core/src/hints/browser.ts +278 -0
  67. package/packages/core/src/hints/crab-data.ts +19 -0
  68. package/packages/core/src/hints/index.ts +865 -0
  69. package/packages/core/src/hints/lines.ts +607 -0
  70. package/packages/core/src/hints/store.ts +120 -0
  71. package/packages/core/src/jev/chatter.ts +24 -0
  72. package/packages/core/src/jev/settings.ts +177 -14
  73. package/packages/core/src/package-colors.ts +2 -0
  74. package/packages/core/src/settings/catalog.ts +39 -15
  75. package/packages/core/src/settings/engine.ts +48 -2
  76. package/packages/core/src/settings/hub.ts +83 -20
  77. package/packages/core/src/settings/open.ts +49 -0
  78. package/packages/core/src/settings/schema.ts +27 -7
  79. package/packages/core/src/tui/hub-kit.ts +18 -5
  80. package/packages/core/src/tui/kit.ts +198 -0
  81. package/packages/core/src/tui/progress.ts +73 -0
  82. package/packages/core/src/turn/arbiter.ts +290 -0
  83. package/packages/footer/README.md +4 -6
  84. package/packages/footer/package.json +3 -3
  85. package/packages/footer/src/glance-editor.ts +19 -11
  86. package/packages/footer/src/help.ts +1 -1
  87. package/packages/footer/src/index.ts +36 -3
  88. package/packages/footer/src/presets.ts +3 -4
  89. package/packages/footer/src/rendering/icons.ts +0 -20
  90. package/packages/footer/src/segments/compactor.ts +52 -142
  91. package/packages/footer/src/segments/status-ext.ts +0 -1
  92. package/packages/fusion/README.md +14 -4
  93. package/packages/fusion/package.json +4 -3
  94. package/packages/fusion/src/child-args.ts +1 -0
  95. package/packages/fusion/src/index.ts +161 -8
  96. package/packages/fusion/src/pi-settings.ts +57 -0
  97. package/packages/fusion/src/picker.ts +186 -51
  98. package/packages/fusion/src/preset.ts +56 -2
  99. package/packages/fusion/src/prompts.ts +1 -1
  100. package/packages/fusion/src/sidekick-runtime.ts +1 -420
  101. package/packages/fusion/src/tools.ts +107 -128
  102. package/packages/fusion/src/transcript.ts +27 -85
  103. package/packages/info-screen/package.json +2 -2
  104. package/packages/input-shortcuts/README.md +18 -30
  105. package/packages/input-shortcuts/package.json +2 -2
  106. package/packages/input-shortcuts/src/burst.ts +88 -0
  107. package/packages/input-shortcuts/src/chord-overlay.ts +20 -70
  108. package/packages/input-shortcuts/src/cleared-input.ts +97 -0
  109. package/packages/input-shortcuts/src/index.ts +99 -193
  110. package/packages/input-shortcuts/src/last-response.ts +40 -0
  111. package/packages/input-shortcuts/src/registers.ts +8 -23
  112. package/packages/input-shortcuts/src/types.ts +4 -16
  113. package/packages/input-shortcuts/src/undo-redo.ts +59 -47
  114. package/packages/kanboard/README.md +51 -47
  115. package/packages/kanboard/index.ts +293 -55
  116. package/packages/kanboard/package.json +8 -8
  117. package/packages/kanboard/skills/kanboard/SKILL.md +61 -27
  118. package/packages/kanboard/src/badges.ts +93 -0
  119. package/packages/kanboard/src/bin.ts +4 -2
  120. package/packages/kanboard/src/commands.ts +218 -84
  121. package/packages/kanboard/src/debug.ts +20 -0
  122. package/packages/kanboard/src/guard.ts +267 -109
  123. package/packages/kanboard/src/monitor.ts +330 -0
  124. package/packages/kanboard/src/notice-buffer.ts +74 -0
  125. package/packages/kanboard/src/progress.ts +27 -0
  126. package/packages/kanboard/src/reminders.ts +234 -0
  127. package/packages/kanboard/src/settings.ts +69 -15
  128. package/packages/kanboard/src/shapes.ts +5 -0
  129. package/packages/long-horizon/index.ts +190 -13
  130. package/packages/long-horizon/package.json +3 -3
  131. package/packages/long-horizon/src/commands.ts +103 -7
  132. package/packages/long-horizon/src/compaction-brief.ts +35 -0
  133. package/packages/long-horizon/src/engine/continuation.ts +84 -15
  134. package/packages/long-horizon/src/engine/goal-state.ts +64 -13
  135. package/packages/long-horizon/src/engine/nudge-stash.ts +71 -0
  136. package/packages/long-horizon/src/engine/ralph.ts +3 -2
  137. package/packages/long-horizon/src/engine/runaway.ts +68 -11
  138. package/packages/long-horizon/src/engine/verifier.ts +19 -0
  139. package/packages/long-horizon/src/gate.ts +37 -12
  140. package/packages/long-horizon/src/judge/resolve.ts +1 -0
  141. package/packages/long-horizon/src/owner.ts +35 -2
  142. package/packages/long-horizon/src/progress.ts +87 -0
  143. package/packages/long-horizon/src/prompts/goal.ts +1 -1
  144. package/packages/long-horizon/src/runtime.ts +172 -18
  145. package/packages/long-horizon/src/settings.ts +54 -39
  146. package/packages/long-horizon/src/tools/goal.ts +6 -0
  147. package/packages/long-horizon/src/tools/graph.ts +1 -1
  148. package/packages/long-horizon/src/tools/swarm.ts +3 -3
  149. package/packages/mcp/package.json +2 -2
  150. package/packages/memory/commands.ts +7 -2
  151. package/packages/memory/index.ts +210 -32
  152. package/packages/memory/package.json +3 -3
  153. package/packages/memory/save-session.ts +264 -0
  154. package/packages/memory/settings.ts +17 -0
  155. package/packages/memory/tools.ts +253 -203
  156. package/packages/notify/package.json +2 -2
  157. package/packages/skill-registry/README.md +53 -16
  158. package/packages/skill-registry/index.ts +230 -0
  159. package/packages/skill-registry/package.json +19 -8
  160. package/packages/skill-registry/src/editor.ts +206 -0
  161. package/packages/skill-registry/src/judge.ts +289 -0
  162. package/packages/skill-registry/src/registry.ts +87 -0
  163. package/packages/skill-registry/src/settings.ts +259 -0
  164. package/packages/skill-registry/src/vault.ts +80 -0
  165. package/packages/subagents/README.md +39 -119
  166. package/packages/subagents/package.json +6 -13
  167. package/packages/subagents/skills/subagents/SKILL.md +18 -42
  168. package/packages/subagents/src/agents.ts +213 -0
  169. package/packages/subagents/src/cards.ts +182 -0
  170. package/packages/subagents/src/index.ts +609 -1084
  171. package/packages/subagents/src/manager.ts +429 -0
  172. package/packages/subagents/src/profiles.ts +130 -0
  173. package/packages/subagents/src/transcript.ts +154 -0
  174. package/packages/subagents/src/ui.ts +389 -0
  175. package/packages/unipi/bundled.js +39756 -45569
  176. package/packages/unipi/index.ts +55 -10
  177. package/packages/updater/package.json +2 -2
  178. package/packages/utility/README.md +76 -69
  179. package/packages/utility/package.json +2 -2
  180. package/packages/utility/skills/image/SKILL.md +37 -0
  181. package/packages/utility/skills/utility/SKILL.md +17 -60
  182. package/packages/utility/src/answer/extract.ts +128 -0
  183. package/packages/utility/src/answer/index.ts +213 -0
  184. package/packages/utility/src/answer/reply.ts +133 -0
  185. package/packages/utility/src/answer/web.ts +167 -0
  186. package/packages/utility/src/attach/index.ts +205 -0
  187. package/packages/utility/src/commands.ts +38 -142
  188. package/packages/utility/src/diagnostics/engine.ts +50 -5
  189. package/packages/utility/src/image/index.ts +33 -0
  190. package/packages/utility/src/image/models.ts +221 -0
  191. package/packages/{image/src → utility/src/image}/recognize.ts +2 -2
  192. package/packages/utility/src/image/settings.ts +178 -0
  193. package/packages/{image/src/image-source.ts → utility/src/image/source.ts} +1 -1
  194. package/packages/utility/src/image/tools.ts +168 -0
  195. package/packages/utility/src/image/transports.ts +186 -0
  196. package/packages/utility/src/index.ts +68 -389
  197. package/packages/utility/src/lifecycle/cleanup.ts +116 -311
  198. package/packages/utility/src/rename/gate.ts +102 -0
  199. package/packages/utility/src/rename/index.ts +191 -0
  200. package/packages/utility/src/rename/session.ts +170 -0
  201. package/packages/utility/src/render/delegated.ts +285 -0
  202. package/packages/utility/src/render/harness.ts +683 -0
  203. package/packages/utility/src/render/parse.ts +156 -0
  204. package/packages/utility/src/render/pi-settings.ts +38 -0
  205. package/packages/utility/src/render/reply-bg.ts +307 -0
  206. package/packages/utility/src/render/simple.ts +724 -0
  207. package/packages/utility/src/render/spacing.ts +235 -0
  208. package/packages/utility/src/render/styled.ts +251 -0
  209. package/packages/utility/src/render/tools.ts +353 -0
  210. package/packages/utility/src/settings.ts +166 -233
  211. package/packages/utility/src/types.ts +1 -222
  212. package/packages/watchdog/index.ts +17 -6
  213. package/packages/watchdog/package.json +3 -3
  214. package/packages/watchdog/src/config.ts +3 -2
  215. package/packages/web-api/package.json +2 -2
  216. package/packages/workflow/README.md +3 -0
  217. package/packages/workflow/index.ts +0 -2
  218. package/packages/workflow/package.json +2 -2
  219. package/packages/workflow/src/permission/decide.ts +6 -4
  220. package/packages/workflow/src/permission/index.ts +17 -7
  221. package/packages/workflow/src/permission/settings.ts +39 -4
  222. package/packages/workflow/src/plan/index.ts +19 -4
  223. package/packages/background-tasks/extensions/delegate-child.ts +0 -1
  224. package/packages/background-tasks/src/context-parent-snapshot.ts +0 -142
  225. package/packages/background-tasks/src/context-token-budget.ts +0 -903
  226. package/packages/background-tasks/src/context-visible-conversation-v2.ts +0 -551
  227. package/packages/background-tasks/src/delegate/artifacts.ts +0 -487
  228. package/packages/background-tasks/src/delegate/budget.ts +0 -415
  229. package/packages/background-tasks/src/delegate/hook-contract-evidence.json +0 -18
  230. package/packages/background-tasks/src/delegate/hook-contract.ts +0 -154
  231. package/packages/background-tasks/src/delegate/launch.ts +0 -484
  232. package/packages/background-tasks/src/delegate/result-package.ts +0 -459
  233. package/packages/background-tasks/src/delegate/runner.ts +0 -430
  234. package/packages/background-tasks/src/delegate/seed.ts +0 -423
  235. package/packages/background-tasks/src/delegate/types.ts +0 -323
  236. package/packages/background-tasks/src/delegate-child-extension.ts +0 -978
  237. package/packages/background-tasks/src/delegate-extension.ts +0 -654
  238. package/packages/background-tasks/src/fixtures/delegate-context-incident.json +0 -17
  239. package/packages/compactor/skills/compactor-detail/SKILL.md +0 -116
  240. package/packages/compactor/skills/compactor-doctor/SKILL.md +0 -71
  241. package/packages/compactor/skills/compactor-stats/SKILL.md +0 -51
  242. package/packages/compactor/src/compaction/build-sections.ts +0 -76
  243. package/packages/compactor/src/compaction/extract/goals.ts +0 -36
  244. package/packages/compactor/src/compaction/extract/preferences.ts +0 -40
  245. package/packages/compactor/src/compaction/format.ts +0 -53
  246. package/packages/compactor/src/compaction/merge.ts +0 -143
  247. package/packages/compactor/src/config/presets.ts +0 -160
  248. package/packages/compactor/src/executor/executor.ts +0 -233
  249. package/packages/compactor/src/executor/runtime.ts +0 -115
  250. package/packages/compactor/src/security/evaluator.ts +0 -89
  251. package/packages/compactor/src/security/policy.ts +0 -96
  252. package/packages/compactor/src/security/scanner.ts +0 -65
  253. package/packages/compactor/src/session/auto-inject.ts +0 -60
  254. package/packages/compactor/src/session/db.ts +0 -325
  255. package/packages/compactor/src/session/extract.ts +0 -144
  256. package/packages/compactor/src/session/resume-inject.ts +0 -64
  257. package/packages/compactor/src/session/snapshot.ts +0 -327
  258. package/packages/compactor/src/tools/ctx-batch-execute.ts +0 -41
  259. package/packages/compactor/src/tools/ctx-execute-file.ts +0 -23
  260. package/packages/compactor/src/tools/ctx-execute.ts +0 -23
  261. package/packages/compactor/src/tools/ctx-stats.ts +0 -96
  262. package/packages/image/README.md +0 -99
  263. package/packages/image/package.json +0 -61
  264. package/packages/image/skills/image/SKILL.md +0 -76
  265. package/packages/image/src/generate.ts +0 -256
  266. package/packages/image/src/index.ts +0 -135
  267. package/packages/image/src/models.ts +0 -519
  268. package/packages/image/src/openai-images-api.ts +0 -282
  269. package/packages/image/src/register-providers.ts +0 -209
  270. package/packages/image/src/settings.ts +0 -173
  271. package/packages/image/src/tools.ts +0 -326
  272. package/packages/input-shortcuts/src/clipboard.ts +0 -119
  273. package/packages/kanboard/src/runner.ts +0 -817
  274. package/packages/skill-registry/skills/auto/SKILL.md +0 -465
  275. package/packages/skill-registry/skills/brainstorm/SKILL.md +0 -219
  276. package/packages/skill-registry/skills/chore-create/SKILL.md +0 -315
  277. package/packages/skill-registry/skills/chore-execute/SKILL.md +0 -314
  278. package/packages/skill-registry/skills/consolidate/SKILL.md +0 -142
  279. package/packages/skill-registry/skills/consultant/SKILL.md +0 -97
  280. package/packages/skill-registry/skills/debug/SKILL.md +0 -228
  281. package/packages/skill-registry/skills/document/SKILL.md +0 -120
  282. package/packages/skill-registry/skills/fix/SKILL.md +0 -212
  283. package/packages/skill-registry/skills/gather-context/SKILL.md +0 -145
  284. package/packages/skill-registry/skills/plan/SKILL.md +0 -231
  285. package/packages/skill-registry/skills/quick-fix/SKILL.md +0 -135
  286. package/packages/skill-registry/skills/quick-work/SKILL.md +0 -110
  287. package/packages/skill-registry/skills/research/SKILL.md +0 -251
  288. package/packages/skill-registry/skills/review-work/SKILL.md +0 -187
  289. package/packages/skill-registry/skills/scan-issues/SKILL.md +0 -195
  290. package/packages/skill-registry/skills/work/SKILL.md +0 -218
  291. package/packages/skill-registry/skills/worktree-create/SKILL.md +0 -69
  292. package/packages/skill-registry/skills/worktree-list/SKILL.md +0 -78
  293. package/packages/skill-registry/skills/worktree-merge/SKILL.md +0 -89
  294. package/packages/subagents/agents/delegate.md +0 -14
  295. package/packages/subagents/agents/oracle.md +0 -78
  296. package/packages/subagents/agents/researcher.md +0 -52
  297. package/packages/subagents/agents/reviewer.md +0 -80
  298. package/packages/subagents/agents/scout.md +0 -50
  299. package/packages/subagents/agents/worker.md +0 -59
  300. package/packages/subagents/prompts/council.md +0 -48
  301. package/packages/subagents/prompts/gather-context-and-clarify.md +0 -13
  302. package/packages/subagents/prompts/parallel-cleanup.md +0 -59
  303. package/packages/subagents/prompts/parallel-research.md +0 -50
  304. package/packages/subagents/prompts/parallel-review.md +0 -54
  305. package/packages/subagents/prompts/review-loop.md +0 -43
  306. package/packages/subagents/skills/council-mode/SKILL.md +0 -230
  307. package/packages/subagents/skills/subagents/references/constraints-and-recipes.md +0 -259
  308. package/packages/subagents/skills/subagents/references/execution-controls.md +0 -454
  309. package/packages/subagents/skills/subagents/references/management-authoring-rpc.md +0 -161
  310. package/packages/subagents/skills/subagents/references/multi-lane-orchestration.md +0 -39
  311. package/packages/subagents/skills/subagents/references/prompting-and-roles.md +0 -267
  312. package/packages/subagents/src/acceptance.ts +0 -331
  313. package/packages/subagents/src/agent-manager.ts +0 -405
  314. package/packages/subagents/src/agent-memory.ts +0 -300
  315. package/packages/subagents/src/agent-overrides.ts +0 -183
  316. package/packages/subagents/src/agent-runner.ts +0 -271
  317. package/packages/subagents/src/async-runner.ts +0 -422
  318. package/packages/subagents/src/authority-policy.ts +0 -47
  319. package/packages/subagents/src/budgets.ts +0 -285
  320. package/packages/subagents/src/child-safety.ts +0 -140
  321. package/packages/subagents/src/config.ts +0 -249
  322. package/packages/subagents/src/conversation-viewer.ts +0 -281
  323. package/packages/subagents/src/core-compat.ts +0 -94
  324. package/packages/subagents/src/custom-agents.ts +0 -343
  325. package/packages/subagents/src/file-system-retry.ts +0 -50
  326. package/packages/subagents/src/fleet-data.ts +0 -105
  327. package/packages/subagents/src/fleet-view.ts +0 -322
  328. package/packages/subagents/src/foreground-detach.ts +0 -59
  329. package/packages/subagents/src/fork-context.ts +0 -285
  330. package/packages/subagents/src/global.d.ts +0 -7
  331. package/packages/subagents/src/guide.ts +0 -129
  332. package/packages/subagents/src/mission-state.ts +0 -133
  333. package/packages/subagents/src/mission-store.ts +0 -436
  334. package/packages/subagents/src/output-limits.ts +0 -142
  335. package/packages/subagents/src/parity-types.ts +0 -315
  336. package/packages/subagents/src/pi-args.ts +0 -167
  337. package/packages/subagents/src/result-files.ts +0 -232
  338. package/packages/subagents/src/result-watcher.ts +0 -221
  339. package/packages/subagents/src/retained-children.ts +0 -176
  340. package/packages/subagents/src/run-fanout-budget.ts +0 -356
  341. package/packages/subagents/src/scheduled-runs.ts +0 -349
  342. package/packages/subagents/src/schemas.ts +0 -263
  343. package/packages/subagents/src/slash-commands.ts +0 -80
  344. package/packages/subagents/src/supervisor-channel.ts +0 -249
  345. package/packages/subagents/src/tool-handler.ts +0 -1144
  346. package/packages/subagents/src/types.ts +0 -238
  347. package/packages/subagents/src/widget.ts +0 -457
  348. package/packages/subagents/src/workflow-script.ts +0 -737
  349. package/packages/subagents/src/workflow-worker.ts +0 -384
  350. package/packages/subagents/src/worktree.ts +0 -614
  351. package/packages/utility/src/analytics/collector.ts +0 -293
  352. package/packages/utility/src/info-screen.ts +0 -80
  353. package/packages/utility/src/lifecycle/process.ts +0 -162
  354. package/packages/utility/src/prefix-cache.ts +0 -263
  355. package/packages/utility/src/skill-discovery.ts +0 -542
  356. package/packages/utility/src/tools/env.ts +0 -113
  357. package/packages/utility/src/tui/name-badge-state.ts +0 -315
  358. package/packages/utility/src/tui/name-badge.ts +0 -109
  359. /package/packages/{subagents/src → core/src/child-agent}/pi-spawn.ts +0 -0
@@ -1,263 +0,0 @@
1
- /**
2
- * @pi-unipi/subagents — Tool parameter schemas (pi-subagents parity)
3
- *
4
- * Ported from nicobailon/pi-subagents src/extension/schemas.ts. Parameter
5
- * names follow the reference (they are arguments, not tool names — no
6
- * convention clash); our legacy spawn_helper params (type/prompt/description/
7
- * run_in_background/max_turns) remain accepted as aliases.
8
- */
9
-
10
- import { Type } from "typebox";
11
-
12
- const TurnBudgetOverride = Type.Object(
13
- {
14
- maxTurns: Type.Integer({ minimum: 1 }),
15
- graceTurns: Type.Optional(Type.Integer({ minimum: 0 })),
16
- },
17
- {
18
- additionalProperties: false,
19
- description:
20
- "Optional assistant-turn budget. At maxTurns the child is asked to wrap up; after graceTurns (default 1) additional assistant turns it is aborted and partial output is returned.",
21
- },
22
- );
23
-
24
- const ToolBudgetBlock = Type.Unsafe({
25
- anyOf: [
26
- { type: "array", minItems: 1, items: { type: "string", minLength: 1 } },
27
- { type: "string", enum: ["*"] },
28
- ],
29
- });
30
-
31
- const ToolBudgetOverride = Type.Object(
32
- {
33
- soft: Type.Optional(Type.Integer({ minimum: 1 })),
34
- hard: Type.Integer({ minimum: 1 }),
35
- block: Type.Optional(ToolBudgetBlock),
36
- },
37
- {
38
- additionalProperties: false,
39
- description:
40
- "Optional child tool-call budget. soft nudges the child to finalize; after hard, block tools (default read/grep/find/ls, or '*' for all tools) are blocked so the child can finalize. Final assistant text is never blocked.",
41
- },
42
- );
43
-
44
- const UsageBudgetLimitOverride = Type.Object(
45
- {
46
- soft: Type.Optional(Type.Number({ exclusiveMinimum: 0 })),
47
- hard: Type.Number({ exclusiveMinimum: 0 }),
48
- },
49
- { additionalProperties: false },
50
- );
51
-
52
- const UsageBudgetOverride = Type.Object(
53
- {
54
- tokens: Type.Optional(UsageBudgetLimitOverride),
55
- costUsd: Type.Optional(UsageBudgetLimitOverride),
56
- },
57
- {
58
- additionalProperties: false,
59
- description:
60
- "Optional root-only reported-usage budget. Soft limits are status-only. Hard limits prevent later child launches after usage is reconciled; running children are not stopped.",
61
- },
62
- );
63
-
64
- const MaxOutputOverride = Type.Object(
65
- {
66
- bytes: Type.Optional(Type.Integer({ minimum: 1 })),
67
- lines: Type.Optional(Type.Integer({ minimum: 1 })),
68
- },
69
- { additionalProperties: false, description: "Final output truncation limits. Defaults: 200KB / 5000 lines." },
70
- );
71
-
72
- /**
73
- * spawn_helper parameter surface. Legacy fields (type, prompt, description,
74
- * run_in_background, max_turns) are the unipi convention and stay primary;
75
- * reference fields (agent, task, action, workflowScript, budgets, ...) join
76
- * them. Execution paths map: agent→type, task→prompt, async→run_in_background.
77
- */
78
- export const SpawnHelperParams = Type.Object({
79
- // ---- unipi legacy (preserved) ----
80
- type: Type.Optional(
81
- Type.String({ description: "Agent type (alias of agent). Enabled builtin or custom type." }),
82
- ),
83
- prompt: Type.Optional(
84
- Type.String({ description: "The task for the agent to perform (alias of task)." }),
85
- ),
86
- description: Type.Optional(
87
- Type.String({ description: "A short (3-5 word) description of the task." }),
88
- ),
89
- run_in_background: Type.Optional(
90
- Type.Boolean({ description: "Run in background (alias of async). Returns helper ID immediately." }),
91
- ),
92
- max_turns: Type.Optional(
93
- Type.Number({ minimum: 1, description: "Max agentic turns before stopping." }),
94
- ),
95
-
96
- // ---- reference surface ----
97
- agent: Type.Optional(
98
- Type.String({ description: "Agent for one-child execution, or target for management actions." }),
99
- ),
100
- task: Type.Optional(
101
- Type.String({
102
- description: "Optional one-child task. Requires agent; cannot combine with action or workflowScript.",
103
- }),
104
- ),
105
- action: Type.Optional(
106
- Type.String({
107
- minLength: 1,
108
- description:
109
- "Optional management/control action (list, get, status, steer, stop, doctor, ...). Omit for execution.",
110
- }),
111
- ),
112
- id: Type.Optional(Type.String({ description: "Run id/prefix for status, interrupt, steer." })),
113
- runId: Type.Optional(Type.String({ description: "Target run ID. Prefer id." })),
114
- dir: Type.Optional(Type.String({ description: "Async run directory for status/stop/resume/steer." })),
115
- index: Type.Optional(
116
- Type.Integer({ minimum: 0, description: "Zero-based child index for actions targeting a specific child." }),
117
- ),
118
- view: Type.Optional(
119
- Type.String({
120
- enum: ["fleet", "transcript"],
121
- description: "Optional status view: fleet surface or transcript tail.",
122
- }),
123
- ),
124
- lines: Type.Optional(
125
- Type.Integer({ minimum: 1, maximum: 500, description: "Max transcript lines for status view=transcript. Default 80." }),
126
- ),
127
- topic: Type.Optional(Type.String({ description: "Guide topic for action=guide." })),
128
- message: Type.Optional(
129
- Type.String({ description: "Follow-up message for resume, live guidance for steer." }),
130
- ),
131
- mode: Type.Optional(
132
- Type.String({
133
- enum: ["steer", "follow_up", "auto"],
134
- description: "Delivery mode for action=steer.",
135
- }),
136
- ),
137
- additional: Type.Optional(
138
- Type.Integer({
139
- minimum: 1,
140
- description: "Positive launches to add with action=grant-spawn-budget.",
141
- }),
142
- ),
143
- missionId: Type.Optional(Type.String({ description: "Mission id." })),
144
- mission: Type.Optional(
145
- Type.Unsafe({
146
- anyOf: [{ type: "object", additionalProperties: true }, { type: "boolean", enum: [false] }],
147
- description: "Mission object, or false for no mission.",
148
- }),
149
- ),
150
- config: Type.Optional(
151
- Type.Unsafe({
152
- anyOf: [{ type: "object", additionalProperties: true }, { type: "string" }],
153
- description: "Agent config for create/update. Object or JSON string.",
154
- }),
155
- ),
156
- workflowScript: Type.Optional(
157
- Type.String({
158
- minLength: 1,
159
- description:
160
- "Trusted inline JavaScript statement body. Use await runs.run(key, {agent, task}) for one child, runs.all([...]) for parallel fanout, await runs.steer(key, message, opts) to steer. Plain helper functions or explicit Promise chains only; nested async helpers are rejected. Explicit return for output. async:true for background (default), async:false only when the parent must block.",
161
- }),
162
- ),
163
- chatProgress: Type.Optional(
164
- Type.String({
165
- enum: ["auto", "off", "live-card"],
166
- description: "WorkflowScript chat progress projection.",
167
- }),
168
- ),
169
- isolation: Type.Optional(
170
- Type.String({ enum: ["none", "worktree"], description: "Workflow child isolation." }),
171
- ),
172
- worktree: Type.Optional(
173
- Type.Boolean({ description: "Managed child isolation via separate git worktrees." }),
174
- ),
175
- context: Type.Optional(
176
- Type.String({
177
- enum: ["fresh", "fork", "profile"],
178
- description:
179
- "'fresh' or 'fork' to branch from parent session, or 'profile' for the agent's declared defaultContext.",
180
- }),
181
- ),
182
- async: Type.Optional(
183
- Type.Boolean({ description: "Run in background. Set false only when the parent must block." }),
184
- ),
185
- timeoutMs: Type.Optional(
186
- Type.Integer({ minimum: 1, description: "Run-level max runtime ms. Alias maxRuntimeMs." }),
187
- ),
188
- maxRuntimeMs: Type.Optional(Type.Integer({ minimum: 1, description: "Alias timeoutMs." })),
189
- toolTimeoutMs: Type.Optional(
190
- Type.Integer({ minimum: 1, description: "Optional hard per-tool-call timeout in ms." }),
191
- ),
192
- turnBudget: Type.Optional(TurnBudgetOverride),
193
- toolBudget: Type.Optional(ToolBudgetOverride),
194
- usageBudget: Type.Optional(UsageBudgetOverride),
195
- agentScope: Type.Optional(
196
- Type.String({
197
- description: "Agent discovery scope: 'user', 'project', or 'both' (default both; project wins collisions).",
198
- }),
199
- ),
200
- cwd: Type.Optional(Type.String({ description: "Execution cwd override." })),
201
- artifacts: Type.Optional(Type.Boolean({ description: "Write debug artifacts. Default true." })),
202
- includeProgress: Type.Optional(
203
- Type.Boolean({ description: "Include full progress in result. Default false." }),
204
- ),
205
- sessionDir: Type.Optional(Type.String({ description: "Directory for child session logs." })),
206
- output: Type.Optional(
207
- Type.Unsafe({
208
- anyOf: [{ type: "string" }, { type: "boolean" }],
209
- description: "Default child output file (string), or false to disable.",
210
- }),
211
- ),
212
- outputMode: Type.Optional(
213
- Type.String({
214
- enum: ["inline", "file-only"],
215
- description: "Return saved output inline (default) or only a concise file reference.",
216
- }),
217
- ),
218
- model: Type.Optional(
219
- Type.String({
220
- description: 'Model override. "provider/modelId" or fuzzy name. Omit to inherit parent model.',
221
- }),
222
- ),
223
- thinking: Type.Optional(
224
- Type.String({
225
- description: "Thinking level: off, minimal, low, medium, high, xhigh. Omit to inherit parent.",
226
- }),
227
- ),
228
- maxOutput: Type.Optional(MaxOutputOverride),
229
- });
230
-
231
- /** get_helper_result parameter surface (parity with subagent_wait). */
232
- export const GetHelperResultParams = Type.Object({
233
- id: Type.Optional(
234
- Type.String({
235
- description:
236
- "Helper/async run id (or prefix) to wait for. Omit to wait across every active run started in this session.",
237
- }),
238
- ),
239
- nonBlocking: Type.Optional(
240
- Type.Boolean({
241
- description:
242
- "When true, resolve id to one exact run, persist a wake subscription, and return immediately. The originating session is woken on completion/failure/attention. Requires id; cannot combine with all.",
243
- }),
244
- ),
245
- all: Type.Optional(
246
- Type.Boolean({
247
- description:
248
- "Wait for ALL active runs to finish. Default false: return when the first run finishes.",
249
- }),
250
- ),
251
- timeoutMs: Type.Optional(
252
- Type.Integer({
253
- minimum: 1,
254
- description: "Give up waiting after this many milliseconds (runs keep going). Default 1800000.",
255
- }),
256
- ),
257
- stopOnAttention: Type.Optional(
258
- Type.Boolean({
259
- description:
260
- "Blocking waits stop when a run needs attention by default. Set false to wait through idle or long-thinking attention.",
261
- }),
262
- ),
263
- });
@@ -1,80 +0,0 @@
1
- /**
2
- * @pi-unipi/subagents — /unipi:* slash commands (Phase 7)
3
- *
4
- * subagents-fleet: open the fleet inspector surface.
5
- * subagents-doctor: run the doctor report.
6
- * subagents-guide: print a guide topic.
7
- */
8
-
9
- import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
10
- import type { AgentManager } from "./agent-manager.js";
11
- import { listAsyncRunSummaries } from "./fleet-data.js";
12
- import { buildGuideText } from "./guide.js";
13
-
14
- export interface SlashDeps {
15
- manager: AgentManager;
16
- config: { maxConcurrent: number; enabled: boolean; types: Record<string, { enabled?: boolean }> };
17
- asyncDirRoot: string;
18
- /** Current session id — scopes the fleet list to this session's own runs. */
19
- sessionId?: string;
20
- retainedDir?: string;
21
- }
22
-
23
- export function registerSlashCommands(pi: ExtensionAPI, getCtx: () => ExtensionContext | undefined, deps: SlashDeps): void {
24
- const send = (markdown: string): void => {
25
- pi.sendMessage(
26
- { customType: "unipi-response", content: markdown, display: true },
27
- { deliverAs: "followUp" },
28
- );
29
- };
30
-
31
- pi.registerCommand("unipi:subagents-fleet", {
32
- description: "Show active subagent fleet (in-process + process runs)",
33
- handler: async (_args, _ctx) => {
34
- const inProcess = deps.manager.listAgents().filter((a) => a.status === "running" || a.status === "queued");
35
- const asyncRuns = listAsyncRunSummaries(
36
- deps.asyncDirRoot,
37
- deps.sessionId ? { sessionId: deps.sessionId } : {},
38
- ).filter((r) => r.state === "running" || r.state === "queued" || r.state === "pending");
39
- const lines: string[] = ["Active subagent fleet:", ""];
40
- if (inProcess.length === 0 && asyncRuns.length === 0) {
41
- lines.push(" (no active work — use spawn_helper to delegate)");
42
- } else {
43
- if (inProcess.length > 0) {
44
- lines.push(`In-process (${inProcess.length}):`);
45
- for (const record of inProcess) {
46
- lines.push(` - ${record.id} [${record.type}] ${record.status}: ${record.description}`);
47
- }
48
- }
49
- if (asyncRuns.length > 0) {
50
- lines.push(`Process runs (${asyncRuns.length}):`);
51
- for (const run of asyncRuns) {
52
- lines.push(` - ${run.runId} [${run.agent}] ${run.state}`);
53
- }
54
- }
55
- lines.push("", "FleetView panel: ↓ to inspect · enter opens transcripts.");
56
- }
57
- send(lines.join("\n"));
58
- },
59
- });
60
-
61
- pi.registerCommand("unipi:subagents-doctor", {
62
- description: "Subagents configuration and capacity diagnosis",
63
- handler: async () => {
64
- send(
65
- "Run the full report via spawn_helper({ action: \"doctor\" }). Quick check:\n" +
66
- `- extension enabled: ${deps.config.enabled}\n` +
67
- `- known agent types: ${deps.manager.getKnownTypes().length}\n` +
68
- `- max concurrent: ${deps.config.maxConcurrent}`,
69
- );
70
- },
71
- });
72
-
73
- pi.registerCommand("unipi:subagents-guide", {
74
- description: "Subagents guide (topic argument optional)",
75
- handler: async (args, _ctx) => {
76
- const topic = args?.trim() || "overview";
77
- send(buildGuideText(topic));
78
- },
79
- });
80
- }
@@ -1,249 +0,0 @@
1
- /**
2
- * @pi-unipi/subagents — Native supervisor channel
3
- *
4
- * Ported from pi-subagents src/intercom/native-supervisor-channel.ts (core).
5
- * File-based channel: children write request JSON into a per-run channel dir;
6
- * the parent polls, surfaces decisions via followUp messages, and writes
7
- * reply JSON back. Children discover the channel through env vars set at
8
- * launch (UNIPI_SUBAGENT_SUPERVISOR_CHANNEL_DIR etc.) — NO external
9
- * pi-intercom dependency.
10
- */
11
-
12
- import * as fs from "node:fs";
13
- import * as path from "node:path";
14
- import { randomUUID } from "node:crypto";
15
-
16
- export const SUPERVISOR_TOOL_NAME = "contact_supervisor";
17
- export const PARENT_SUPERVISOR_TOOL_NAME = "subagent_supervisor";
18
-
19
- const MAX_MESSAGE_BYTES = 64 * 1024;
20
- const DEFAULT_ASK_TIMEOUT_MS = 10 * 60 * 1000;
21
- const CHANNEL_POLL_MS = 500;
22
-
23
- export type SupervisorReason = "need_decision" | "interview_request" | "progress_update";
24
-
25
- export interface SupervisorRequest {
26
- type: "subagent.supervisor.request";
27
- id: string;
28
- createdAt: number;
29
- expiresAt?: number;
30
- reason: SupervisorReason;
31
- message: string;
32
- expectsReply: boolean;
33
- runId: string;
34
- agent: string;
35
- }
36
-
37
- export interface SupervisorReply {
38
- type: "subagent.supervisor.reply";
39
- requestId: string;
40
- createdAt: number;
41
- message: string;
42
- }
43
-
44
- // ============================================================================
45
- // Env contract (child side)
46
- // ============================================================================
47
-
48
- export const SUPERVISOR_CHANNEL_DIR_ENV = "UNIPI_SUBAGENT_SUPERVISOR_CHANNEL_DIR";
49
- export const SUPERVISOR_RUN_ID_ENV = "UNIPI_SUBAGENT_RUN_ID";
50
- export const SUPERVISOR_AGENT_ENV = "UNIPI_SUBAGENT_CHILD_AGENT";
51
- export const SUPERVISOR_PARENT_SESSION_ENV = "UNIPI_SUBAGENT_PARENT_SESSION";
52
-
53
- /** Child-side metadata read from env. All fields required to activate. */
54
- export function readChildSupervisorMetadata(env: NodeJS.ProcessEnv = process.env): {
55
- channelDir: string;
56
- runId: string;
57
- agent: string;
58
- parentSessionId: string;
59
- } | undefined {
60
- const channelDir = env[SUPERVISOR_CHANNEL_DIR_ENV]?.trim();
61
- const runId = env[SUPERVISOR_RUN_ID_ENV]?.trim();
62
- const agent = env[SUPERVISOR_AGENT_ENV]?.trim();
63
- const parentSessionId = env[SUPERVISOR_PARENT_SESSION_ENV]?.trim();
64
- if (!channelDir || !runId || !agent || !parentSessionId) return undefined;
65
- return { channelDir, runId, agent, parentSessionId };
66
- }
67
-
68
- function safeSegment(value: string): string {
69
- return value.trim().replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "unknown";
70
- }
71
-
72
- /** Channel dir under our temp root: supervisor-channels/<runId>-<agent>/. */
73
- export function resolveSupervisorChannelDir(root: string, runId: string, agent: string): string {
74
- return path.join(root, `${safeSegment(runId)}-${safeSegment(agent)}`);
75
- }
76
-
77
- export function ensureSupervisorChannelDir(channelDir: string): void {
78
- fs.mkdirSync(path.join(channelDir, "requests"), { recursive: true, mode: 0o700 });
79
- fs.mkdirSync(path.join(channelDir, "replies"), { recursive: true, mode: 0o700 });
80
- }
81
-
82
- function requestsDir(channelDir: string): string {
83
- return path.join(channelDir, "requests");
84
- }
85
- function repliesDir(channelDir: string): string {
86
- return path.join(channelDir, "replies");
87
- }
88
-
89
- function validateMessage(message: string | undefined): string {
90
- if (!message || !message.trim()) throw new Error("supervisor message must be a non-empty string.");
91
- if (Buffer.byteLength(message, "utf8") > MAX_MESSAGE_BYTES) {
92
- throw new Error(`supervisor message exceeds ${MAX_MESSAGE_BYTES} bytes.`);
93
- }
94
- return message;
95
- }
96
-
97
- // ============================================================================
98
- // Child side: contact_supervisor
99
- // ============================================================================
100
-
101
- /**
102
- * Write a supervisor request and (optionally) block until a reply lands.
103
- * Returns the reply text for asks; undefined for progress updates.
104
- */
105
- export function childContactSupervisor(
106
- params: { reason: SupervisorReason; message?: string; timeoutMs?: number },
107
- metadata = readChildSupervisorMetadata(),
108
- now = Date.now(),
109
- ): { replied: boolean; reply?: string } {
110
- if (!metadata) {
111
- throw new Error("contact_supervisor is unavailable: no supervisor channel in this environment.");
112
- }
113
- const message = validateMessage(params.message);
114
- ensureSupervisorChannelDir(metadata.channelDir);
115
-
116
- const request: SupervisorRequest = {
117
- type: "subagent.supervisor.request",
118
- id: randomUUID(),
119
- createdAt: now,
120
- reason: params.reason,
121
- message,
122
- expectsReply: params.reason !== "progress_update",
123
- runId: metadata.runId,
124
- agent: metadata.agent,
125
- ...(params.reason !== "progress_update"
126
- ? { expiresAt: now + (params.timeoutMs ?? DEFAULT_ASK_TIMEOUT_MS) }
127
- : {}),
128
- };
129
- fs.writeFileSync(
130
- path.join(requestsDir(metadata.channelDir), `${request.id}.json`),
131
- JSON.stringify(request),
132
- { mode: 0o600 },
133
- );
134
-
135
- if (!request.expectsReply) return { replied: false };
136
-
137
- // Block on the reply file. In production children run as separate processes
138
- // (Atomics.wait parks without burning CPU); when Atomics is unavailable
139
- // (e.g. same-process tests), fall back to a busy poll.
140
- const replyFile = path.join(repliesDir(metadata.channelDir), `${request.id}.json`);
141
- const deadline = request.expiresAt ?? now + DEFAULT_ASK_TIMEOUT_MS;
142
- const waitBuffer = typeof SharedArrayBuffer !== "undefined" ? new Int32Array(new SharedArrayBuffer(4)) : undefined;
143
- for (;;) {
144
- try {
145
- const reply = JSON.parse(fs.readFileSync(replyFile, "utf8")) as SupervisorReply;
146
- if (reply.requestId === request.id) return { replied: true, reply: reply.message };
147
- } catch {
148
- // Not there yet.
149
- }
150
- if (Date.now() > deadline) {
151
- return { replied: false, reply: undefined };
152
- }
153
- if (waitBuffer) {
154
- try {
155
- Atomics.wait(waitBuffer, 0, 0, CHANNEL_POLL_MS);
156
- } catch {
157
- // Busy fallback below.
158
- }
159
- }
160
- }
161
- }
162
-
163
- // ============================================================================
164
- // Parent side: poll pending requests, deliver, reply
165
- // ============================================================================
166
-
167
- export interface PendingSupervisorRequest extends SupervisorRequest {
168
- channelDir: string;
169
- }
170
-
171
- /** List open requests across all channel dirs under the root. */
172
- export function listPendingSupervisorRequests(root: string): PendingSupervisorRequest[] {
173
- let entries: fs.Dirent[];
174
- try {
175
- entries = fs.readdirSync(root, { withFileTypes: true });
176
- } catch {
177
- return [];
178
- }
179
- const pending: PendingSupervisorRequest[] = [];
180
- const now = Date.now();
181
- for (const entry of entries) {
182
- if (!entry.isDirectory()) continue;
183
- const channelDir = path.join(root, entry.name);
184
- let files: string[];
185
- try {
186
- files = fs.readdirSync(requestsDir(channelDir));
187
- } catch {
188
- continue;
189
- }
190
- for (const file of files) {
191
- if (!file.endsWith(".json")) continue;
192
- try {
193
- const request = JSON.parse(fs.readFileSync(path.join(requestsDir(channelDir), file), "utf8")) as SupervisorRequest;
194
- if (request.type !== "subagent.supervisor.request") continue;
195
- if (request.expiresAt !== undefined && request.expiresAt < now) {
196
- // Expired: clean up so it never re-surfaces.
197
- fs.rmSync(path.join(requestsDir(channelDir), file), { force: true });
198
- continue;
199
- }
200
- pending.push({ ...request, channelDir });
201
- } catch {
202
- // corrupt → skip
203
- }
204
- }
205
- }
206
- return pending.sort((left, right) => left.createdAt - right.createdAt);
207
- }
208
-
209
- /** Reply to a request (removes it from pending). */
210
- export function replyToSupervisorRequest(root: string, requestId: string, message: string): boolean {
211
- const validMessage = validateMessage(message);
212
- for (const pending of listPendingSupervisorRequests(root)) {
213
- if (pending.id !== requestId) continue;
214
- const reply: SupervisorReply = {
215
- type: "subagent.supervisor.reply",
216
- requestId,
217
- createdAt: Date.now(),
218
- message: validMessage,
219
- };
220
- fs.writeFileSync(path.join(repliesDir(pending.channelDir), `${requestId}.json`), JSON.stringify(reply), { mode: 0o600 });
221
- try {
222
- fs.rmSync(path.join(requestsDir(pending.channelDir), `${requestId}.json`), { force: true });
223
- } catch { /* best effort */ }
224
- return true;
225
- }
226
- return false;
227
- }
228
-
229
- /** Create the parent-side poller that delivers requests as notifications. */
230
- export function createSupervisorPoller(
231
- root: string,
232
- opts: {
233
- pollMs?: number;
234
- notify: (request: PendingSupervisorRequest) => void;
235
- },
236
- ): { stop(): void } {
237
- let timer: ReturnType<typeof setInterval> | undefined;
238
- timer = setInterval(() => {
239
- for (const request of listPendingSupervisorRequests(root)) {
240
- opts.notify(request);
241
- }
242
- }, opts.pollMs ?? CHANNEL_POLL_MS);
243
- timer.unref?.();
244
- return {
245
- stop(): void {
246
- if (timer) clearInterval(timer);
247
- },
248
- };
249
- }