@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,129 +0,0 @@
1
- /**
2
- * @pi-unipi/subagents — Guide topics (action: "guide")
3
- *
4
- * Bundled quick-reference for the spawn_helper guide action. Adapted from
5
- * pi-subagents docs/ (condensed to agent-facing essentials, our tool names).
6
- */
7
-
8
- import { SUBAGENT_ACTIONS } from "./parity-types.js";
9
-
10
- const TOPICS: Record<string, string> = {
11
- overview: `# Subagents overview
12
-
13
- spawn_helper delegates work to focused child agents; get_helper_result waits on
14
- or inspects them. Builtins: explore/work (unipi) + scout/researcher/worker/
15
- reviewer/oracle/delegate (parity). Custom agents live in
16
- ~/.unipi/config/agents/*.md and <workspace>/.unipi/config/agents/*.md.
17
-
18
- Execution modes:
19
- - single child: { agent, task } (foreground or run_in_background)
20
- - workflow: { workflowScript } — runs.run/runs.all/runs.steer in a sandbox
21
- - management: { action } for list/get/status/children.list/resume/doctor/...
22
-
23
- Rule of thumb: scout before you understand code, researcher before you trust
24
- external facts, worker to implement, reviewer to check, oracle when the
25
- decision itself feels risky.`,
26
-
27
- workflows: `# Workflows
28
-
29
- All orchestration is code-driven through workflowScript:
30
-
31
- // sequential
32
- const scan = await runs.run("scan", { agent: "scout", task: "Analyze auth" });
33
- const fix = await runs.run("fix", { agent: "worker", task: "Implement: " + scan.output });
34
- return fix.output;
35
-
36
- // parallel fanout (await it; do not read .output from unawaited launches)
37
- const reviews = await runs.all([
38
- { key: "correctness", agent: "reviewer", task: "Review correctness" },
39
- { key: "tests", agent: "reviewer", task: "Review tests" }
40
- ]);
41
- return reviews.map((r) => r.output);
42
-
43
- Steering: await runs.steer(key, message, { mode: "auto" }) after a launch.
44
- Plain helper functions returning runs.run(...) are fine; nested async helpers
45
- are rejected. Recommended loop: clarify → scout → worker → fresh reviewers → worker.`,
46
-
47
- agents: `# Agents
48
-
49
- An agent is a markdown file: YAML frontmatter + system prompt.
50
-
51
- Fields: name, description, tools (comma list), model, thinking, aliases,
52
- systemPromptMode (replace|append), inheritProjectContext, inheritSkills,
53
- defaultContext (fresh|fork), timeoutMs, toolTimeoutMs, maxSubagentDepth,
54
- memory ({ scope: user|project, path: role-name }), enabled.
55
-
56
- Discovery priority: project .unipi/config/agents > global ~/.unipi/config/agents
57
- > builtin files > code builtins. agentOverrides in the subagents.json
58
- "subagents" block can override any builtin field per agent; disableBuiltins
59
- disables all builtins while custom agents keep working.`,
60
-
61
- observability: `# Observability
62
-
63
- FleetView (persistent panel): active work from both transports — in-process
64
- agents and child-process runs. ↓/← activates; j/k navigate; enter inspects
65
- (live transcript for local agents, result tail for process runs); esc closes.
66
-
67
- spawn_helper({ action: "status" }) reports active work + spawn budgets.
68
- children.list shows retained (completed) children with resumability.
69
- Async completions arrive as <task-notification> follow-ups automatically.`,
70
-
71
- "tool-reference": `# spawn_helper reference
72
-
73
- Execution: { agent, task, async?, context?, timeoutMs?, maxTurns?, turnBudget?,
74
- toolBudget?, usageBudget?, model?, thinking?, worktree? }
75
- Legacy aliases: type (= agent), prompt (= task), run_in_background (= async),
76
- max_turns (= maxTurns).
77
-
78
- workflowScript: { workflowScript, async?, timeoutMs?, maxOutput? }
79
-
80
- Management actions: ${SUBAGENT_ACTIONS.slice(0, 12).join(", ")}, ...
81
-
82
- get_helper_result: { id, wait?, nonBlocking?, all?, timeoutMs?, stopOnAttention? }
83
- - blocking wait returns when a run needs attention (default) or completes
84
- - nonBlocking: persist a subscription and return immediately; the session is
85
- woken on completion/failure/attention`,
86
-
87
- configuration: `# Configuration
88
-
89
- ~/.unipi/config/subagents.json (global) + <workspace>/.unipi/config/subagents.json
90
- (workspace overrides global). The "subagents" block carries parity settings:
91
-
92
- { "subagents": { "defaultModel", "defaultThinking", "agentOverrides",
93
- "disableBuiltins", "asyncByDefault", "defaultSubagentContext", "timeoutMs",
94
- "toolTimeoutMs", "maxSubagentSpawnsPerRun" (64), "maxSubagentSpawnsPerSession",
95
- "maxActiveAsyncRunsPerSession", "maxSubagentDepth" (2), "parallel",
96
- "fleetView", "fleetViewPlacement", "inlineToolDisplay", "resultScanLogging" } }
97
-
98
- Env overrides: UNIPI_SUBAGENT_PI_BINARY, UNIPI_SUBAGENT_TASK_DELIVERY,
99
- UNIPI_SUBAGENT_TOOL_TIMEOUT_MS, UNIPI_SUBAGENTS_WORKTREE_DIR, UNIPI_SUBAGENT_MAX_DEPTH.`,
100
-
101
- missions: `# Missions (planned phase)
102
-
103
- Durable mission records with delivery receipts, timed and recurring runs.
104
- Not yet wired in this build — see the roadmap in the package README.`,
105
-
106
- models: `# Models
107
-
108
- Children inherit the parent model by default. Override per call ({ model }),
109
- per agent (frontmatter model), or globally (subagents.defaultModel).
110
- Thinking: per call ({ thinking }), per agent, or subagents.defaultThinking.
111
- Fallback models: agent frontmatter fallbackModels (ordered).`,
112
-
113
- watchdog: `# Watchdog (planned phase)
114
-
115
- Opt-in adversarial change reviewer, scope monitoring, LSP diagnostics, child
116
- tool permissions. Not yet wired in this build.`,
117
-
118
- "extension-api": `# Extension API (planned phase)
119
-
120
- Runtime agent registration (AgentManager.registerRuntimeAgent) exists; the
121
- full RPC bridge for external hosts lands in a later phase.`,
122
- };
123
-
124
- export function buildGuideText(topic: string): string {
125
- const normalized = topic.toLowerCase().trim();
126
- const doc = TOPICS[normalized];
127
- if (doc) return doc;
128
- return `Unknown guide topic "${topic}". Available topics: ${Object.keys(TOPICS).join(", ")}.`;
129
- }
@@ -1,133 +0,0 @@
1
- /**
2
- * @pi-unipi/subagents — Mission workflow state (state.get/set)
3
- *
4
- * Ported from pi-subagents src/missions/workflow-state.ts. Durable JSON
5
- * key/value state shared across workflows attached to the same mission:
6
- * each set takes a lock file, merges the key, enforces a strict 256 KiB
7
- * total-size limit.
8
- */
9
-
10
- import * as fs from "node:fs";
11
- import * as path from "node:path";
12
- import { randomUUID } from "node:crypto";
13
- import { DEFAULT_FILE_SYSTEM_RETRY_DELAYS_MS, waitForFileSystemRetry } from "./file-system-retry.js";
14
-
15
- export const MISSION_STATE_MAX_BYTES = 256 * 1024;
16
-
17
- interface StateFile {
18
- version: 1;
19
- values: Record<string, unknown>;
20
- }
21
-
22
- function statePath(missionDir: string, missionId: string): string {
23
- return path.join(missionDir, `${missionId}.state.json`);
24
- }
25
-
26
- function readState(file: string): StateFile {
27
- try {
28
- const parsed = JSON.parse(fs.readFileSync(file, "utf8")) as StateFile;
29
- if (parsed.version === 1 && parsed.values && typeof parsed.values === "object" && !Array.isArray(parsed.values)) {
30
- return parsed;
31
- }
32
- } catch {
33
- // Missing/corrupt → fresh state.
34
- }
35
- return { version: 1, values: {} };
36
- }
37
-
38
- function validateKey(key: string): string {
39
- if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(key)) {
40
- throw new Error("state key must be 1-128 characters using letters, numbers, '.', '_' or '-', and start with a letter or number.");
41
- }
42
- return key;
43
- }
44
-
45
- function withStateLock<T>(lockPath: string, operation: () => T): T {
46
- const owner = { pid: process.pid, token: randomUUID() };
47
- for (let attempt = 0; ; attempt++) {
48
- try {
49
- fs.mkdirSync(lockPath, { mode: 0o700 });
50
- try {
51
- fs.writeFileSync(path.join(lockPath, "owner.json"), JSON.stringify(owner), { mode: 0o600 });
52
- } catch (error) {
53
- fs.rmSync(lockPath, { recursive: true, force: true });
54
- throw error;
55
- }
56
- break;
57
- } catch (error) {
58
- if ((error as NodeJS.ErrnoException).code !== "EEXIST") throw error;
59
- // Stale-lock reclaim via pid probe (reference behavior).
60
- try {
61
- const ownerRaw = fs.readFileSync(path.join(lockPath, "owner.json"), "utf8");
62
- const held = JSON.parse(ownerRaw) as { pid?: number };
63
- if (held.pid && held.pid > 0) {
64
- try {
65
- process.kill(held.pid, 0);
66
- } catch (killError) {
67
- if ((killError as NodeJS.ErrnoException).code !== "EPERM") {
68
- fs.rmSync(lockPath, { recursive: true, force: true });
69
- continue;
70
- }
71
- }
72
- }
73
- } catch {
74
- // Unreadable owner → age-based fallback below.
75
- }
76
- const delay = DEFAULT_FILE_SYSTEM_RETRY_DELAYS_MS[attempt];
77
- if (delay === undefined) throw new Error("Timed out acquiring mission state lock.");
78
- waitForFileSystemRetry(delay);
79
- }
80
- }
81
- try {
82
- return operation();
83
- } finally {
84
- try {
85
- const ownerRaw = fs.readFileSync(path.join(lockPath, "owner.json"), "utf8");
86
- if (JSON.parse(ownerRaw).token === owner.token) fs.rmSync(lockPath, { recursive: true, force: true });
87
- } catch {
88
- // best effort
89
- }
90
- }
91
- }
92
-
93
- export interface MissionWorkflowState {
94
- get(key: string): unknown;
95
- set(key: string, value: unknown): void;
96
- }
97
-
98
- /** Create the state adapter for one mission. */
99
- export function createMissionWorkflowState(missionDir: string, missionId: string): MissionWorkflowState {
100
- const file = statePath(missionDir, missionId);
101
- const lock = `${file}.lock`;
102
-
103
- return {
104
- get(key: string): unknown {
105
- validateKey(key);
106
- return withStateLock(lock, () => {
107
- const state = readState(file);
108
- return state.values[key];
109
- });
110
- },
111
- set(key: string, value: unknown): void {
112
- validateKey(key);
113
- withStateLock(lock, () => {
114
- const state = readState(file);
115
- state.values[key] = value;
116
- const serialized = JSON.stringify(state);
117
- if (Buffer.byteLength(serialized, "utf8") > MISSION_STATE_MAX_BYTES) {
118
- throw new Error(
119
- `Mission state exceeds the strict ${MISSION_STATE_MAX_BYTES} byte limit; remove keys or store large data in files.`,
120
- );
121
- }
122
- writePrivateAtomic(file, serialized);
123
- });
124
- },
125
- };
126
- }
127
-
128
- function writePrivateAtomic(file: string, content: string): void {
129
- fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
130
- const tmp = `${file}.tmp-${process.pid}`;
131
- fs.writeFileSync(tmp, content, { mode: 0o600 });
132
- fs.renameSync(tmp, file);
133
- }
@@ -1,436 +0,0 @@
1
- /**
2
- * @pi-unipi/subagents — Mission store
3
- *
4
- * Ported from pi-subagents src/missions/store.ts (core). Durable mission
5
- * records under OUR layout: ~/.unipi/missions/<project-hash>/<missionId>.json
6
- * (project-keyed by sha256 of the resolved cwd), with an optional global
7
- * pointer index (~/.unipi/missions/index/) and retainTerminal pruning that
8
- * removes only the oldest terminal records.
9
- */
10
-
11
- import * as fs from "node:fs";
12
- import * as path from "node:path";
13
- import { createHash, randomUUID } from "node:crypto";
14
- import { homedir } from "node:os";
15
- import { stateDir } from "@pi-unipi/core";
16
-
17
- export const MISSION_STATUSES = [
18
- "planned",
19
- "active",
20
- "waiting",
21
- "needs_decision",
22
- "completed",
23
- "failed",
24
- "cancelled",
25
- ] as const;
26
-
27
- export type MissionStatus = (typeof MISSION_STATUSES)[number];
28
-
29
- const TERMINAL_MISSION_STATUSES = new Set<string>(["completed", "failed", "cancelled"]);
30
- const DEFAULT_TERMINAL_MISSION_RETENTION = 200;
31
-
32
- export interface MissionGoal {
33
- status: "active" | "paused" | "budget-exhausted";
34
- }
35
-
36
- export interface MissionTokenBudget {
37
- tokens: number;
38
- }
39
-
40
- export interface MissionRunLink {
41
- runId: string;
42
- agent?: string;
43
- mode?: string;
44
- status?: string;
45
- startedAt?: string;
46
- completedAt?: string;
47
- }
48
-
49
- export interface MissionDecision {
50
- id: string;
51
- status: "open" | "resolved";
52
- title: string;
53
- prompt?: string;
54
- options?: string[];
55
- recommendation?: string;
56
- createdAt: string;
57
- resolvedAt?: string;
58
- resolution?: string;
59
- }
60
-
61
- export interface MissionArtifact {
62
- kind: string;
63
- path: string;
64
- description?: string;
65
- }
66
-
67
- export interface MissionReceipt {
68
- kind: string;
69
- status: string;
70
- title: string;
71
- url: string;
72
- createdAt: string;
73
- description?: string;
74
- }
75
-
76
- export interface MissionRecord {
77
- schemaVersion: 1;
78
- id: string;
79
- title: string;
80
- objective: string;
81
- goal?: MissionGoal;
82
- budget?: MissionTokenBudget;
83
- usage?: { tokens: number };
84
- status: MissionStatus;
85
- createdAt: string;
86
- updatedAt: string;
87
- cwd?: string;
88
- ownerSessionId?: string;
89
- runs: MissionRunLink[];
90
- decisions: MissionDecision[];
91
- artifacts: MissionArtifact[];
92
- receipts: MissionReceipt[];
93
- summary?: string;
94
- labels?: string[];
95
- }
96
-
97
- export interface MissionIndexEntry {
98
- schemaVersion: 1;
99
- missionId: string;
100
- projectRoot: string;
101
- recordPath: string;
102
- title: string;
103
- status: MissionStatus;
104
- updatedAt: string;
105
- lastRunId?: string;
106
- }
107
-
108
- export interface MissionStoreConfig {
109
- enabled?: boolean;
110
- directory?: string;
111
- globalIndex?: boolean;
112
- globalIndexDir?: string;
113
- retainTerminal?: number;
114
- }
115
-
116
- export interface MissionStoreLocation {
117
- projectRoot: string;
118
- missionDir: string;
119
- globalIndexDir: string;
120
- writeGlobalIndex: boolean;
121
- retainTerminal?: number;
122
- }
123
-
124
- // ============================================================================
125
- // Validation helpers
126
- // ============================================================================
127
-
128
- const MISSION_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
129
-
130
- export function validateMissionId(value: unknown, label = "missionId"): string {
131
- if (typeof value !== "string" || !MISSION_ID_PATTERN.test(value)) {
132
- throw new Error(`${label} must be 1-128 characters using letters, numbers, '.', '_' or '-', and start with a letter or number.`);
133
- }
134
- return value;
135
- }
136
-
137
- function requiredString(value: unknown, label: string): string {
138
- if (typeof value !== "string" || !value.trim()) throw new Error(`${label} must be a non-empty string.`);
139
- return value;
140
- }
141
-
142
- function optionalString(value: unknown): string | undefined {
143
- return typeof value === "string" && value.length > 0 ? value : undefined;
144
- }
145
-
146
- function missionStatus(value: unknown, label: string): MissionStatus {
147
- if (typeof value === "string" && (MISSION_STATUSES as readonly string[]).includes(value)) {
148
- return value as MissionStatus;
149
- }
150
- throw new Error(`${label} must be one of ${MISSION_STATUSES.join(", ")}.`);
151
- }
152
-
153
- function parseBudget(value: unknown, label: string): MissionTokenBudget {
154
- if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${label} must be an object with tokens.`);
155
- const tokens = (value as { tokens?: unknown }).tokens;
156
- if (typeof tokens !== "number" || !Number.isInteger(tokens) || tokens <= 0) {
157
- throw new Error(`${label}.tokens must be a positive integer.`);
158
- }
159
- return { tokens };
160
- }
161
-
162
- /** Parse + validate a full mission record. */
163
- export function parseMissionRecord(value: unknown, source = "mission record"): MissionRecord {
164
- if (!value || typeof value !== "object" || Array.isArray(value)) {
165
- throw new Error(`${source} must be an object.`);
166
- }
167
- const input = value as Record<string, unknown>;
168
- if (input.schemaVersion !== 1) throw new Error(`${source}.schemaVersion must be 1`);
169
- const arrays = ["runs", "decisions", "artifacts", "receipts"] as const;
170
- for (const key of arrays) {
171
- if (!Array.isArray(input[key])) throw new Error(`${source}.${key} must be an array.`);
172
- }
173
- return {
174
- schemaVersion: 1,
175
- id: validateMissionId(input.id, `${source}.id`),
176
- title: requiredString(input.title, `${source}.title`),
177
- objective: requiredString(input.objective, `${source}.objective`),
178
- ...(input.goal && typeof input.goal === "object" ? { goal: input.goal as MissionGoal } : {}),
179
- ...(input.budget ? { budget: parseBudget(input.budget, `${source}.budget`) } : {}),
180
- ...(input.usage && typeof input.usage === "object" ? { usage: input.usage as { tokens: number } } : {}),
181
- status: missionStatus(input.status, `${source}.status`),
182
- createdAt: requiredString(input.createdAt, `${source}.createdAt`),
183
- updatedAt: requiredString(input.updatedAt, `${source}.updatedAt`),
184
- ...(optionalString(input.cwd) ? { cwd: input.cwd as string } : {}),
185
- ...(optionalString(input.ownerSessionId) ? { ownerSessionId: input.ownerSessionId as string } : {}),
186
- runs: input.runs as MissionRunLink[],
187
- decisions: input.decisions as MissionDecision[],
188
- artifacts: input.artifacts as MissionArtifact[],
189
- receipts: input.receipts as MissionReceipt[],
190
- ...(optionalString(input.summary) ? { summary: input.summary as string } : {}),
191
- ...(Array.isArray(input.labels) ? { labels: input.labels.filter((l): l is string => typeof l === "string") } : {}),
192
- };
193
- }
194
-
195
- // ============================================================================
196
- // Store location — OUR layout: ~/.unipi/missions/<project-hash>/
197
- // ============================================================================
198
-
199
- function expandConfiguredPath(raw: string, projectRoot: string): string {
200
- const trimmed = raw.trim();
201
- if (trimmed.startsWith("~/")) return path.join(homedir(), trimmed.slice(2));
202
- if (path.isAbsolute(trimmed)) return trimmed;
203
- return path.resolve(projectRoot, trimmed);
204
- }
205
-
206
- /** Project hash key (sha256 of the resolved root, first 16 hex chars). */
207
- export function projectHashKey(projectRoot: string): string {
208
- return createHash("sha256").update(path.resolve(projectRoot)).digest("hex").slice(0, 16);
209
- }
210
-
211
- export function resolveMissionStoreLocation(input: {
212
- projectRoot: string;
213
- config?: MissionStoreConfig;
214
- }): MissionStoreLocation {
215
- const projectRoot = path.resolve(input.projectRoot);
216
- // Per-project missions live in the workspace state root (collision-safe by
217
- // marker uuid); the cross-project index legitimately stays global.
218
- const defaultMissionDir = path.join(stateDir("subagents", "state", projectRoot), "missions");
219
- const missionDir = input.config?.directory
220
- ? expandConfiguredPath(input.config.directory, projectRoot)
221
- : defaultMissionDir;
222
- const globalIndexDir = input.config?.globalIndexDir
223
- ? expandConfiguredPath(input.config.globalIndexDir, projectRoot)
224
- : path.join(homedir(), ".unipi", "global", "subagents", "missions-index");
225
- return {
226
- projectRoot,
227
- missionDir,
228
- globalIndexDir,
229
- writeGlobalIndex: input.config?.globalIndex !== false,
230
- ...(input.config?.retainTerminal !== undefined ? { retainTerminal: input.config.retainTerminal } : {}),
231
- };
232
- }
233
-
234
- export function missionRecordPath(location: MissionStoreLocation, missionId: string): string {
235
- return path.join(location.missionDir, `${validateMissionId(missionId)}.json`);
236
- }
237
-
238
- // ============================================================================
239
- // CRUD
240
- // ============================================================================
241
-
242
- function writePrivateAtomicJson(filePath: string, value: unknown): void {
243
- fs.mkdirSync(path.dirname(filePath), { recursive: true, mode: 0o700 });
244
- const tmp = `${filePath}.tmp-${process.pid}`;
245
- fs.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600 });
246
- fs.renameSync(tmp, filePath);
247
- }
248
-
249
- function indexPath(location: MissionStoreLocation, missionId: string): string {
250
- const key = createHash("sha256").update(`${location.projectRoot}\0${missionId}`).digest("hex");
251
- return path.join(location.globalIndexDir, `${key}.json`);
252
- }
253
-
254
- function writeMission(location: MissionStoreLocation, record: MissionRecord): MissionRecord {
255
- const validated = parseMissionRecord(record);
256
- writePrivateAtomicJson(missionRecordPath(location, validated.id), validated);
257
- if (location.writeGlobalIndex) {
258
- const lastRunId = validated.runs.at(-1)?.runId;
259
- const entry: MissionIndexEntry = {
260
- schemaVersion: 1,
261
- missionId: validated.id,
262
- projectRoot: location.projectRoot,
263
- recordPath: missionRecordPath(location, validated.id),
264
- title: validated.title,
265
- status: validated.status,
266
- updatedAt: validated.updatedAt,
267
- ...(lastRunId ? { lastRunId } : {}),
268
- };
269
- writePrivateAtomicJson(indexPath(location, validated.id), entry);
270
- }
271
- return validated;
272
- }
273
-
274
- function pruneTerminalMissions(location: MissionStoreLocation, maxTerminal: number): void {
275
- const terminal = listMissions(location)
276
- .records.filter((record) => TERMINAL_MISSION_STATUSES.has(record.status))
277
- .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
278
- for (const record of terminal.slice(maxTerminal)) {
279
- try {
280
- fs.rmSync(missionRecordPath(location, record.id), { force: true });
281
- if (location.writeGlobalIndex) fs.rmSync(indexPath(location, record.id), { force: true });
282
- } catch {
283
- // Retention is best-effort and must never block a launch.
284
- }
285
- }
286
- }
287
-
288
- export interface MissionCreateInput {
289
- title: string;
290
- objective: string;
291
- goal?: boolean;
292
- budget?: { tokens: number };
293
- status?: MissionStatus;
294
- ownerSessionId?: string;
295
- labels?: string[];
296
- }
297
-
298
- export function createMission(
299
- location: MissionStoreLocation,
300
- input: MissionCreateInput,
301
- now = new Date(),
302
- retainTerminal = location.retainTerminal ?? DEFAULT_TERMINAL_MISSION_RETENTION,
303
- ): MissionRecord {
304
- if (input.goal === true && !input.budget) {
305
- throw new Error("mission.budget is required when mission.goal is true");
306
- }
307
- const createdAt = now.toISOString();
308
- const record: MissionRecord = {
309
- schemaVersion: 1,
310
- id: randomUUID(),
311
- title: requiredString(input.title, "mission.title").trim(),
312
- objective: requiredString(input.objective, "mission.objective").trim(),
313
- ...(input.goal === true ? { goal: { status: "active" as const } } : {}),
314
- ...(input.budget ? { budget: parseBudget(input.budget, "mission.budget") } : {}),
315
- ...(input.goal === true ? { usage: { tokens: 0 } } : {}),
316
- status: input.status ?? "planned",
317
- createdAt,
318
- updatedAt: createdAt,
319
- cwd: location.projectRoot,
320
- runs: [],
321
- decisions: [],
322
- artifacts: [],
323
- receipts: [],
324
- ...(input.ownerSessionId ? { ownerSessionId: requiredString(input.ownerSessionId, "mission.ownerSessionId") } : {}),
325
- ...(input.labels ? { labels: input.labels.filter((l): l is string => typeof l === "string") } : {}),
326
- };
327
- const created = writeMission(location, record);
328
- pruneTerminalMissions(location, retainTerminal);
329
- return created;
330
- }
331
-
332
- export class MissionNotFoundError extends Error {
333
- readonly code = "MISSION_NOT_FOUND";
334
-
335
- constructor(missionId: string, missionDir: string) {
336
- super(`Mission '${missionId}' was not found in mission directory '${missionDir}'. If it was created in another worktree, run the request from that worktree.`);
337
- this.name = "MissionNotFoundError";
338
- }
339
- }
340
-
341
- export function readMission(location: MissionStoreLocation, missionId: string): MissionRecord {
342
- const filePath = missionRecordPath(location, missionId);
343
- let raw: string;
344
- try {
345
- raw = fs.readFileSync(filePath, "utf-8");
346
- } catch (error) {
347
- if ((error as NodeJS.ErrnoException).code === "ENOENT") throw new MissionNotFoundError(missionId, location.missionDir);
348
- throw error;
349
- }
350
- try {
351
- return parseMissionRecord(JSON.parse(raw), filePath);
352
- } catch (error) {
353
- throw new Error(`Invalid mission file '${filePath}': ${error instanceof Error ? error.message : String(error)}`);
354
- }
355
- }
356
-
357
- export interface MissionListResult {
358
- records: MissionRecord[];
359
- warnings: string[];
360
- }
361
-
362
- export function listMissions(location: MissionStoreLocation): MissionListResult {
363
- if (!fs.existsSync(location.missionDir)) return { records: [], warnings: [] };
364
- const records: MissionRecord[] = [];
365
- const warnings: string[] = [];
366
- for (const name of fs.readdirSync(location.missionDir).filter((item) => item.endsWith(".json")).sort()) {
367
- const filePath = path.join(location.missionDir, name);
368
- try {
369
- records.push(parseMissionRecord(JSON.parse(fs.readFileSync(filePath, "utf-8")), filePath));
370
- } catch (error) {
371
- warnings.push(`Skipped corrupt mission '${filePath}': ${error instanceof Error ? error.message : String(error)}`);
372
- }
373
- }
374
- records.sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
375
- return { records, warnings };
376
- }
377
-
378
- export interface MissionUpdateInput {
379
- status?: MissionStatus;
380
- summary?: string;
381
- labels?: string[];
382
- addRun?: MissionRunLink;
383
- addDecision?: Omit<MissionDecision, "id" | "createdAt"> & { id?: string };
384
- resolveDecision?: { id: string; resolution: string };
385
- addArtifact?: MissionArtifact;
386
- addReceipt?: MissionReceipt;
387
- incrementUsage?: { tokens: number };
388
- }
389
-
390
- export function updateMission(
391
- location: MissionStoreLocation,
392
- missionId: string,
393
- update: MissionUpdateInput,
394
- now = new Date(),
395
- retainTerminal = location.retainTerminal ?? DEFAULT_TERMINAL_MISSION_RETENTION,
396
- ): MissionRecord {
397
- const current = readMission(location, missionId);
398
- const next: MissionRecord = { ...current, updatedAt: now.toISOString() };
399
-
400
- if (update.status !== undefined) next.status = update.status;
401
- if (update.summary !== undefined) next.summary = update.summary;
402
- if (update.labels !== undefined) next.labels = update.labels;
403
- if (update.addRun) next.runs = [...next.runs, update.addRun];
404
- if (update.addArtifact) next.artifacts = [...next.artifacts, update.addArtifact];
405
- if (update.addReceipt) next.receipts = [...next.receipts, update.addReceipt];
406
- if (update.incrementUsage) {
407
- const base = next.usage?.tokens ?? 0;
408
- next.usage = { tokens: base + update.incrementUsage.tokens };
409
- // Goal continuation: budget exhaustion flips the goal status.
410
- if (next.goal && next.budget && next.usage.tokens >= next.budget.tokens) {
411
- next.goal = { ...next.goal, status: "budget-exhausted" };
412
- }
413
- }
414
- if (update.addDecision) {
415
- next.decisions = [
416
- ...next.decisions,
417
- {
418
- ...update.addDecision,
419
- id: update.addDecision.id ?? randomUUID().slice(0, 8),
420
- status: "open",
421
- createdAt: now.toISOString(),
422
- } as MissionDecision,
423
- ];
424
- }
425
- if (update.resolveDecision) {
426
- next.decisions = next.decisions.map((decision) =>
427
- decision.id === update.resolveDecision!.id && decision.status === "open"
428
- ? { ...decision, status: "resolved", resolvedAt: now.toISOString(), resolution: update.resolveDecision!.resolution }
429
- : decision,
430
- );
431
- }
432
-
433
- const saved = writeMission(location, next);
434
- pruneTerminalMissions(location, retainTerminal);
435
- return saved;
436
- }