@selesai/code 0.13.0 → 0.13.2

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 (463) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/dist/core/agent-session.d.ts +1 -1
  3. package/dist/core/agent-session.js +1 -1
  4. package/dist/core/sdk.d.ts +2 -2
  5. package/dist/core/sdk.js +1 -1
  6. package/dist/core/system-prompt.d.ts +1 -1
  7. package/dist/core/system-prompt.js +1 -1
  8. package/dist/extensions/package.json +1 -2
  9. package/dist/extensions/pi-hermes-memory/CHANGELOG.md +371 -0
  10. package/dist/extensions/pi-hermes-memory/LICENSE +21 -0
  11. package/dist/extensions/pi-hermes-memory/README.md +643 -0
  12. package/dist/extensions/pi-hermes-memory/docs/0.1/TASKS.md +197 -0
  13. package/dist/extensions/pi-hermes-memory/docs/0.2/PLAN.md +290 -0
  14. package/dist/extensions/pi-hermes-memory/docs/0.2/TASKS.md +134 -0
  15. package/dist/extensions/pi-hermes-memory/docs/0.2/TEST-PLAN.md +216 -0
  16. package/dist/extensions/pi-hermes-memory/docs/0.3/PLAN.md +330 -0
  17. package/dist/extensions/pi-hermes-memory/docs/0.3/TASKS.md +125 -0
  18. package/dist/extensions/pi-hermes-memory/docs/0.4/PLAN.md +160 -0
  19. package/dist/extensions/pi-hermes-memory/docs/0.4/TASKS.md +113 -0
  20. package/dist/extensions/pi-hermes-memory/docs/0.6/CHANGELOG.md +57 -0
  21. package/dist/extensions/pi-hermes-memory/docs/0.6/PLAN.md +202 -0
  22. package/dist/extensions/pi-hermes-memory/docs/0.6/TASKS.md +144 -0
  23. package/dist/extensions/pi-hermes-memory/docs/0.7/PLAN.md +349 -0
  24. package/dist/extensions/pi-hermes-memory/docs/0.7/TASKS.md +110 -0
  25. package/dist/extensions/pi-hermes-memory/docs/PUBLISHING.md +149 -0
  26. package/dist/extensions/pi-hermes-memory/docs/ROADMAP.md +468 -0
  27. package/dist/extensions/pi-hermes-memory/docs/images/memory-architecture.svg +1 -0
  28. package/dist/extensions/pi-hermes-memory/docs/images/pi-logo.svg +22 -0
  29. package/dist/extensions/pi-hermes-memory/docs/images/pi_memory.png +0 -0
  30. package/dist/extensions/pi-hermes-memory/docs/images/pi_memory.svg +19 -0
  31. package/dist/extensions/pi-hermes-memory/docs/images/security-flow.svg +1 -0
  32. package/dist/extensions/pi-hermes-memory/docs/images/session-lifecycle.svg +1 -0
  33. package/dist/extensions/pi-hermes-memory/docs/images/source-architecture.svg +1 -0
  34. package/dist/extensions/pi-hermes-memory/docs/mermaid/memory-architecture.mmd +49 -0
  35. package/dist/extensions/pi-hermes-memory/docs/mermaid/security-flow.mmd +40 -0
  36. package/dist/extensions/pi-hermes-memory/docs/mermaid/session-lifecycle.mmd +56 -0
  37. package/dist/extensions/pi-hermes-memory/docs/mermaid/source-architecture.mmd +54 -0
  38. package/dist/extensions/pi-hermes-memory/package-lock.json +3799 -0
  39. package/dist/extensions/pi-hermes-memory/package.json +66 -0
  40. package/dist/extensions/pi-hermes-memory/scripts/check-min-sdk.mjs +99 -0
  41. package/dist/extensions/pi-hermes-memory/scripts/ensure-dev.mjs +57 -0
  42. package/dist/extensions/pi-hermes-memory/src/auto-consolidation-warning.ts +6 -0
  43. package/dist/extensions/pi-hermes-memory/src/config.ts +178 -0
  44. package/dist/extensions/pi-hermes-memory/src/constants.ts +424 -0
  45. package/dist/extensions/pi-hermes-memory/src/extension-root-migration.ts +639 -0
  46. package/dist/extensions/pi-hermes-memory/src/handlers/auto-consolidate.ts +401 -0
  47. package/dist/extensions/pi-hermes-memory/src/handlers/background-review.ts +297 -0
  48. package/dist/extensions/pi-hermes-memory/src/handlers/child-process-watchdog.mjs +90 -0
  49. package/dist/extensions/pi-hermes-memory/src/handlers/correction-detector.ts +300 -0
  50. package/dist/extensions/pi-hermes-memory/src/handlers/index-sessions.ts +86 -0
  51. package/dist/extensions/pi-hermes-memory/src/handlers/insights.ts +78 -0
  52. package/dist/extensions/pi-hermes-memory/src/handlers/interview.ts +37 -0
  53. package/dist/extensions/pi-hermes-memory/src/handlers/learn-memory.ts +186 -0
  54. package/dist/extensions/pi-hermes-memory/src/handlers/message-parts.ts +27 -0
  55. package/dist/extensions/pi-hermes-memory/src/handlers/pi-child-process.ts +485 -0
  56. package/dist/extensions/pi-hermes-memory/src/handlers/preview-context.ts +105 -0
  57. package/dist/extensions/pi-hermes-memory/src/handlers/review-memory-ops.ts +506 -0
  58. package/dist/extensions/pi-hermes-memory/src/handlers/session-backfill.ts +145 -0
  59. package/dist/extensions/pi-hermes-memory/src/handlers/session-flush.ts +151 -0
  60. package/dist/extensions/pi-hermes-memory/src/handlers/session-live-index.ts +94 -0
  61. package/dist/extensions/pi-hermes-memory/src/handlers/skills-command.ts +1334 -0
  62. package/dist/extensions/pi-hermes-memory/src/handlers/standing-pin.ts +111 -0
  63. package/dist/extensions/pi-hermes-memory/src/handlers/switch-project.ts +75 -0
  64. package/dist/extensions/pi-hermes-memory/src/handlers/sync-markdown-memories.ts +266 -0
  65. package/dist/extensions/pi-hermes-memory/src/index.ts +378 -0
  66. package/dist/extensions/pi-hermes-memory/src/lifecycle-timing.ts +54 -0
  67. package/dist/extensions/pi-hermes-memory/src/paths.ts +61 -0
  68. package/dist/extensions/pi-hermes-memory/src/project-context.ts +13 -0
  69. package/dist/extensions/pi-hermes-memory/src/project-memory-migration.ts +93 -0
  70. package/dist/extensions/pi-hermes-memory/src/project.ts +157 -0
  71. package/dist/extensions/pi-hermes-memory/src/prompt-context.ts +55 -0
  72. package/dist/extensions/pi-hermes-memory/src/store/atomic-lock-coordinator.ts +375 -0
  73. package/dist/extensions/pi-hermes-memory/src/store/canonical-storage-path.ts +54 -0
  74. package/dist/extensions/pi-hermes-memory/src/store/content-scanner.ts +101 -0
  75. package/dist/extensions/pi-hermes-memory/src/store/db.ts +1180 -0
  76. package/dist/extensions/pi-hermes-memory/src/store/fts-query.ts +101 -0
  77. package/dist/extensions/pi-hermes-memory/src/store/markdown-mutation-lock.ts +38 -0
  78. package/dist/extensions/pi-hermes-memory/src/store/memory-lookup.ts +24 -0
  79. package/dist/extensions/pi-hermes-memory/src/store/memory-store.ts +1191 -0
  80. package/dist/extensions/pi-hermes-memory/src/store/recovery-maintenance.ts +66 -0
  81. package/dist/extensions/pi-hermes-memory/src/store/schema.ts +118 -0
  82. package/dist/extensions/pi-hermes-memory/src/store/session-anchor-search.ts +472 -0
  83. package/dist/extensions/pi-hermes-memory/src/store/session-indexer.ts +511 -0
  84. package/dist/extensions/pi-hermes-memory/src/store/session-parser.ts +213 -0
  85. package/dist/extensions/pi-hermes-memory/src/store/session-search.ts +234 -0
  86. package/dist/extensions/pi-hermes-memory/src/store/skill-store.ts +950 -0
  87. package/dist/extensions/pi-hermes-memory/src/store/skill-utils.ts +133 -0
  88. package/dist/extensions/pi-hermes-memory/src/store/sqlite-memory-store.ts +1002 -0
  89. package/dist/extensions/pi-hermes-memory/src/store/sqlite-native.ts +241 -0
  90. package/dist/extensions/pi-hermes-memory/src/store/standing-instructions.ts +247 -0
  91. package/dist/extensions/pi-hermes-memory/src/tools/memory-search-tool.ts +95 -0
  92. package/dist/extensions/pi-hermes-memory/src/tools/memory-tool.ts +469 -0
  93. package/dist/extensions/pi-hermes-memory/src/tools/session-search-tool.ts +246 -0
  94. package/dist/extensions/pi-hermes-memory/src/tools/shared-output-view.ts +170 -0
  95. package/dist/extensions/pi-hermes-memory/src/tools/skill-tool.ts +333 -0
  96. package/dist/extensions/pi-hermes-memory/src/tools/tool-result-views.ts +105 -0
  97. package/dist/extensions/pi-hermes-memory/src/types.ts +214 -0
  98. package/dist/extensions/pi-hermes-memory/tests/config.test.ts +434 -0
  99. package/dist/extensions/pi-hermes-memory/tests/extension-root-migration.test.ts +368 -0
  100. package/dist/extensions/pi-hermes-memory/tests/handlers/auto-consolidate.test.ts +984 -0
  101. package/dist/extensions/pi-hermes-memory/tests/handlers/background-review.test.ts +950 -0
  102. package/dist/extensions/pi-hermes-memory/tests/handlers/correction-detector.test.ts +671 -0
  103. package/dist/extensions/pi-hermes-memory/tests/handlers/insights.test.ts +157 -0
  104. package/dist/extensions/pi-hermes-memory/tests/handlers/interview.test.ts +127 -0
  105. package/dist/extensions/pi-hermes-memory/tests/handlers/pi-child-process.test.ts +905 -0
  106. package/dist/extensions/pi-hermes-memory/tests/handlers/preview-context.test.ts +152 -0
  107. package/dist/extensions/pi-hermes-memory/tests/handlers/prompt-context.test.ts +166 -0
  108. package/dist/extensions/pi-hermes-memory/tests/handlers/resources-discover.test.ts +71 -0
  109. package/dist/extensions/pi-hermes-memory/tests/handlers/review-memory-ops.test.ts +614 -0
  110. package/dist/extensions/pi-hermes-memory/tests/handlers/session-backfill.test.ts +192 -0
  111. package/dist/extensions/pi-hermes-memory/tests/handlers/session-flush.test.ts +677 -0
  112. package/dist/extensions/pi-hermes-memory/tests/handlers/session-live-index.test.ts +225 -0
  113. package/dist/extensions/pi-hermes-memory/tests/handlers/skills-command.test.ts +827 -0
  114. package/dist/extensions/pi-hermes-memory/tests/handlers/standing-pin.test.ts +134 -0
  115. package/dist/extensions/pi-hermes-memory/tests/handlers/sync-markdown-memories.test.ts +491 -0
  116. package/dist/extensions/pi-hermes-memory/tests/handlers/system-prompt.test.ts +199 -0
  117. package/dist/extensions/pi-hermes-memory/tests/handlers/thinking-max.test.ts +64 -0
  118. package/dist/extensions/pi-hermes-memory/tests/index.test.ts +30 -0
  119. package/dist/extensions/pi-hermes-memory/tests/integration/flow.test.ts +126 -0
  120. package/dist/extensions/pi-hermes-memory/tests/lifecycle-timing.test.ts +76 -0
  121. package/dist/extensions/pi-hermes-memory/tests/paths.test.ts +23 -0
  122. package/dist/extensions/pi-hermes-memory/tests/project-memory-migration.test.ts +80 -0
  123. package/dist/extensions/pi-hermes-memory/tests/project-rebinding.test.ts +115 -0
  124. package/dist/extensions/pi-hermes-memory/tests/project.test.ts +120 -0
  125. package/dist/extensions/pi-hermes-memory/tests/run-all-timeout.test.ts +107 -0
  126. package/dist/extensions/pi-hermes-memory/tests/run-all.sh +45 -0
  127. package/dist/extensions/pi-hermes-memory/tests/store/atomic-lock-coordinator.test.ts +381 -0
  128. package/dist/extensions/pi-hermes-memory/tests/store/content-scanner.test.ts +388 -0
  129. package/dist/extensions/pi-hermes-memory/tests/store/db.test.ts +1046 -0
  130. package/dist/extensions/pi-hermes-memory/tests/store/markdown-mutation-lock.test.ts +34 -0
  131. package/dist/extensions/pi-hermes-memory/tests/store/memory-store.test.ts +2150 -0
  132. package/dist/extensions/pi-hermes-memory/tests/store/recovery-maintenance.test.ts +170 -0
  133. package/dist/extensions/pi-hermes-memory/tests/store/session-anchor-search.test.ts +210 -0
  134. package/dist/extensions/pi-hermes-memory/tests/store/session-indexer.test.ts +643 -0
  135. package/dist/extensions/pi-hermes-memory/tests/store/session-parser.test.ts +282 -0
  136. package/dist/extensions/pi-hermes-memory/tests/store/session-search.test.ts +287 -0
  137. package/dist/extensions/pi-hermes-memory/tests/store/skill-store.test.ts +678 -0
  138. package/dist/extensions/pi-hermes-memory/tests/store/skill-utils.test.ts +21 -0
  139. package/dist/extensions/pi-hermes-memory/tests/store/sqlite-lazy-load.test.ts +78 -0
  140. package/dist/extensions/pi-hermes-memory/tests/store/sqlite-memory-store.test.ts +543 -0
  141. package/dist/extensions/pi-hermes-memory/tests/store/sqlite-native.test.ts +164 -0
  142. package/dist/extensions/pi-hermes-memory/tests/store/standing-instructions.test.ts +171 -0
  143. package/dist/extensions/pi-hermes-memory/tests/tools/memory-search-tool.test.ts +84 -0
  144. package/dist/extensions/pi-hermes-memory/tests/tools/memory-tool.test.ts +709 -0
  145. package/dist/extensions/pi-hermes-memory/tests/tools/session-search-tool.test.ts +345 -0
  146. package/dist/extensions/pi-hermes-memory/tests/tools/shared-output-view.test.ts +362 -0
  147. package/dist/extensions/pi-hermes-memory/tests/tools/skill-tool.test.ts +478 -0
  148. package/dist/extensions/pi-hermes-memory/tests/tools/tool-result-renderer-wiring.test.ts +40 -0
  149. package/dist/extensions/pi-hermes-memory/tsconfig.json +19 -0
  150. package/dist/extensions/pi-rewind-hook/README.md +4 -1
  151. package/dist/extensions/pi-rewind-hook/index.ts +151 -21
  152. package/dist/extensions/pi-rewind-hook/package.json +5 -3
  153. package/dist/extensions/pi-subagents/.oxlintrc.json +43 -0
  154. package/dist/extensions/pi-subagents/AGENTS.md +5 -0
  155. package/dist/extensions/pi-subagents/CHANGELOG.md +157 -0
  156. package/dist/extensions/pi-subagents/README.md +12 -6
  157. package/dist/extensions/pi-subagents/VISION.md +81 -0
  158. package/dist/extensions/pi-subagents/agents/claude-code-writer.md +15 -0
  159. package/dist/extensions/pi-subagents/agents/claude-code.md +15 -0
  160. package/dist/extensions/pi-subagents/agents/codex-exec-writer.md +15 -0
  161. package/dist/extensions/pi-subagents/agents/codex-exec.md +15 -0
  162. package/dist/extensions/pi-subagents/agents/cursor-agent-writer.md +14 -0
  163. package/dist/extensions/pi-subagents/agents/cursor-agent.md +14 -0
  164. package/dist/extensions/pi-subagents/agents/reviewer.md +1 -3
  165. package/dist/extensions/pi-subagents/docs/agents.md +488 -0
  166. package/dist/extensions/pi-subagents/docs/configuration.md +46 -9
  167. package/dist/extensions/pi-subagents/docs/extension-api.md +42 -3
  168. package/dist/extensions/pi-subagents/docs/models.md +27 -4
  169. package/dist/extensions/pi-subagents/docs/observability.md +10 -9
  170. package/dist/extensions/pi-subagents/docs/tool-reference.md +102 -6
  171. package/dist/extensions/pi-subagents/docs/workflows.md +135 -0
  172. package/dist/extensions/pi-subagents/package-lock.json +389 -2
  173. package/dist/extensions/pi-subagents/package.json +3 -1
  174. package/dist/extensions/pi-subagents/prompts/review-loop.md +2 -2
  175. package/dist/extensions/pi-subagents/skills/council-mode/SKILL.md +1 -1
  176. package/dist/extensions/pi-subagents/skills/pi-subagents/SKILL.md +3 -1
  177. package/dist/extensions/pi-subagents/skills/pi-subagents/references/execution-controls.md +7 -3
  178. package/dist/extensions/pi-subagents/skills/pi-subagents/references/management-authoring-rpc.md +2 -2
  179. package/dist/extensions/pi-subagents/skills/pi-subagents/references/prompting-and-roles.md +26 -5
  180. package/dist/extensions/pi-subagents/src/agents/agent-management.ts +41 -22
  181. package/dist/extensions/pi-subagents/src/agents/agent-refinements.ts +4 -4
  182. package/dist/extensions/pi-subagents/src/agents/agent-serializer.ts +9 -2
  183. package/dist/extensions/pi-subagents/src/agents/agents.ts +322 -75
  184. package/dist/extensions/pi-subagents/src/agents/builtin-names.ts +6 -0
  185. package/dist/extensions/pi-subagents/src/agents/runtime-agent-events.ts +70 -0
  186. package/dist/extensions/pi-subagents/src/agents/runtime-agent-registry.ts +27 -20
  187. package/dist/extensions/pi-subagents/src/api/agents.ts +10 -5
  188. package/dist/extensions/pi-subagents/src/api/background-work.ts +5 -1
  189. package/dist/extensions/pi-subagents/src/api/delegation.ts +0 -7
  190. package/dist/extensions/pi-subagents/src/api/preflight.ts +34 -12
  191. package/dist/extensions/pi-subagents/src/extension/config.ts +70 -0
  192. package/dist/extensions/pi-subagents/src/extension/doctor.ts +3 -3
  193. package/dist/extensions/pi-subagents/src/extension/fanout-child.ts +5 -3
  194. package/dist/extensions/pi-subagents/src/extension/index.ts +83 -30
  195. package/dist/extensions/pi-subagents/src/extension/public-execution.ts +44 -15
  196. package/dist/extensions/pi-subagents/src/extension/rpc.ts +55 -19
  197. package/dist/extensions/pi-subagents/src/extension/schemas.ts +41 -15
  198. package/dist/extensions/pi-subagents/src/extension/tool-description.ts +28 -31
  199. package/dist/extensions/pi-subagents/src/inspectors/herdr/actions.ts +2 -1
  200. package/dist/extensions/pi-subagents/src/inspectors/herdr/inspector-runner.ts +2 -10
  201. package/dist/extensions/pi-subagents/src/inspectors/herdr/session-roots-codec.ts +42 -0
  202. package/dist/extensions/pi-subagents/src/integrations/herdr-status.ts +51 -7
  203. package/dist/extensions/pi-subagents/src/intercom/result-intercom.ts +2 -0
  204. package/dist/extensions/pi-subagents/src/profiles/profiles.ts +5 -6
  205. package/dist/extensions/pi-subagents/src/runs/background/active-async-capacity.ts +77 -10
  206. package/dist/extensions/pi-subagents/src/runs/background/async-execution.ts +176 -53
  207. package/dist/extensions/pi-subagents/src/runs/background/async-job-tracker.ts +19 -12
  208. package/dist/extensions/pi-subagents/src/runs/background/async-resume.ts +29 -27
  209. package/dist/extensions/pi-subagents/src/runs/background/async-retention.ts +20 -3
  210. package/dist/extensions/pi-subagents/src/runs/background/async-status-snapshot.ts +23 -261
  211. package/dist/extensions/pi-subagents/src/runs/background/async-status.ts +73 -7
  212. package/dist/extensions/pi-subagents/src/runs/background/chain-append.ts +8 -3
  213. package/dist/extensions/pi-subagents/src/runs/background/chain-root-attachment.ts +74 -8
  214. package/dist/extensions/pi-subagents/src/runs/background/fleet-view.ts +37 -21
  215. package/dist/extensions/pi-subagents/src/runs/background/inspect-rpc.ts +8 -8
  216. package/dist/extensions/pi-subagents/src/runs/background/notify.ts +184 -9
  217. package/dist/extensions/pi-subagents/src/runs/background/result-delivery-ownership.ts +45 -0
  218. package/dist/extensions/pi-subagents/src/runs/background/result-files.ts +28 -14
  219. package/dist/extensions/pi-subagents/src/runs/background/result-watcher.ts +38 -15
  220. package/dist/extensions/pi-subagents/src/runs/background/resume-guidance.ts +1 -1
  221. package/dist/extensions/pi-subagents/src/runs/background/retained-children.ts +1 -1
  222. package/dist/extensions/pi-subagents/src/runs/background/run-status.ts +50 -13
  223. package/dist/extensions/pi-subagents/src/runs/background/scheduled-runs.ts +93 -8
  224. package/dist/extensions/pi-subagents/src/runs/background/stale-run-reconciler.ts +10 -4
  225. package/dist/extensions/pi-subagents/src/runs/background/steering.ts +4 -14
  226. package/dist/extensions/pi-subagents/src/runs/background/subagent-runner.ts +549 -377
  227. package/dist/extensions/pi-subagents/src/runs/background/subagent-wait.ts +58 -10
  228. package/dist/extensions/pi-subagents/src/runs/background/terminal-run-index.ts +1 -1
  229. package/dist/extensions/pi-subagents/src/runs/background/wait-completions.ts +26 -1
  230. package/dist/extensions/pi-subagents/src/runs/background/wait-config.ts +23 -9
  231. package/dist/extensions/pi-subagents/src/runs/background/wait-tool.ts +9 -2
  232. package/dist/extensions/pi-subagents/src/runs/foreground/async-steering-action.ts +2 -2
  233. package/dist/extensions/pi-subagents/src/runs/foreground/execution.ts +204 -129
  234. package/dist/extensions/pi-subagents/src/runs/foreground/foreground-control.ts +9 -0
  235. package/dist/extensions/pi-subagents/src/runs/foreground/foreground-history.ts +23 -1
  236. package/dist/extensions/pi-subagents/src/runs/foreground/subagent-executor.ts +773 -311
  237. package/dist/extensions/pi-subagents/src/runs/foreground/workflow-detach-reconcile.ts +140 -115
  238. package/dist/extensions/pi-subagents/src/runs/shared/abort-recovery.ts +119 -0
  239. package/dist/extensions/pi-subagents/src/runs/shared/async-status-projection.ts +463 -0
  240. package/dist/extensions/pi-subagents/src/runs/shared/child-identity.ts +19 -4
  241. package/dist/extensions/pi-subagents/src/runs/shared/child-launch-plan.ts +151 -0
  242. package/dist/extensions/pi-subagents/src/runs/shared/child-protocol.ts +21 -7
  243. package/dist/extensions/pi-subagents/src/runs/shared/claude-code-adapter.ts +129 -0
  244. package/dist/extensions/pi-subagents/src/runs/shared/codex-exec-adapter.ts +129 -0
  245. package/dist/extensions/pi-subagents/src/runs/shared/completion-evidence.ts +89 -0
  246. package/dist/extensions/pi-subagents/src/runs/shared/completion-guard.ts +5 -4
  247. package/dist/extensions/pi-subagents/src/runs/shared/cursor-agent-adapter.ts +114 -0
  248. package/dist/extensions/pi-subagents/src/runs/shared/dynamic-fanout.ts +3 -3
  249. package/dist/extensions/pi-subagents/src/runs/shared/external-cli-contract.ts +167 -0
  250. package/dist/extensions/pi-subagents/src/runs/shared/external-cli-preflight.ts +122 -0
  251. package/dist/extensions/pi-subagents/src/runs/shared/external-cli-runner.ts +348 -55
  252. package/dist/extensions/pi-subagents/src/runs/shared/fast-mode-extension.ts +5 -5
  253. package/dist/extensions/pi-subagents/src/runs/shared/host-step-status.ts +230 -0
  254. package/dist/extensions/pi-subagents/src/runs/shared/lane-metadata.ts +105 -0
  255. package/dist/extensions/pi-subagents/src/runs/shared/launch-cwd.ts +16 -0
  256. package/dist/extensions/pi-subagents/src/runs/shared/long-running-guard.ts +2 -1
  257. package/dist/extensions/pi-subagents/src/runs/shared/mcp-config-sources.ts +422 -0
  258. package/dist/extensions/pi-subagents/src/runs/shared/mcp-direct-tool-allowlist.ts +221 -158
  259. package/dist/extensions/pi-subagents/src/runs/shared/mcp-direct-tool-grant.ts +197 -0
  260. package/dist/extensions/pi-subagents/src/runs/shared/model-exclusions.ts +69 -7
  261. package/dist/extensions/pi-subagents/src/runs/shared/model-fallback.ts +47 -6
  262. package/dist/extensions/pi-subagents/src/runs/shared/mutation-evidence.ts +7 -2
  263. package/dist/extensions/pi-subagents/src/runs/shared/nested-events.ts +9 -3
  264. package/dist/extensions/pi-subagents/src/runs/shared/nested-render.ts +9 -5
  265. package/dist/extensions/pi-subagents/src/runs/shared/parallel-handoff.ts +419 -7
  266. package/dist/extensions/pi-subagents/src/runs/shared/parallel-utils.ts +15 -1
  267. package/dist/extensions/pi-subagents/src/runs/shared/pi-args.ts +81 -8
  268. package/dist/extensions/pi-subagents/src/runs/shared/process-signal.ts +13 -0
  269. package/dist/extensions/pi-subagents/src/runs/shared/run-history.ts +21 -1
  270. package/dist/extensions/pi-subagents/src/runs/shared/single-output.ts +44 -4
  271. package/dist/extensions/pi-subagents/src/runs/shared/subagent-prompt-runtime.ts +98 -13
  272. package/dist/extensions/pi-subagents/src/runs/shared/subagent-startup-retry.ts +1 -1
  273. package/dist/extensions/pi-subagents/src/runs/shared/worktree-cleanup-plan.ts +847 -0
  274. package/dist/extensions/pi-subagents/src/runs/shared/worktree.ts +18 -0
  275. package/dist/extensions/pi-subagents/src/shared/child-session-name.ts +46 -0
  276. package/dist/extensions/pi-subagents/src/shared/extension-context.ts +24 -0
  277. package/dist/extensions/pi-subagents/src/shared/fork-context.ts +21 -0
  278. package/dist/extensions/pi-subagents/src/shared/formatters.ts +18 -3
  279. package/dist/extensions/pi-subagents/src/shared/launch-contract.ts +5 -1
  280. package/dist/extensions/pi-subagents/src/shared/pruned-fork.ts +450 -0
  281. package/dist/extensions/pi-subagents/src/shared/session-file-trust.ts +19 -0
  282. package/dist/extensions/pi-subagents/src/shared/session-tokens.ts +14 -3
  283. package/dist/extensions/pi-subagents/src/shared/settings.ts +19 -105
  284. package/dist/extensions/pi-subagents/src/shared/shortcuts.ts +17 -0
  285. package/dist/extensions/pi-subagents/src/shared/types.ts +359 -40
  286. package/dist/extensions/pi-subagents/src/shared/utils.ts +41 -84
  287. package/dist/extensions/pi-subagents/src/shared/workflow-child-permit.ts +116 -0
  288. package/dist/extensions/pi-subagents/src/slash/delegation-adapters.ts +1 -9
  289. package/dist/extensions/pi-subagents/src/slash/delegation-request.ts +0 -4
  290. package/dist/extensions/pi-subagents/src/slash/slash-bridge.ts +1 -2
  291. package/dist/extensions/pi-subagents/src/slash/slash-commands.ts +378 -88
  292. package/dist/extensions/pi-subagents/src/slash/slash-live-state.ts +22 -11
  293. package/dist/extensions/pi-subagents/src/slash/subagents-admin.ts +3 -0
  294. package/dist/extensions/pi-subagents/src/tui/fleet-status.ts +147 -79
  295. package/dist/extensions/pi-subagents/src/tui/fleet-transcript.ts +11 -5
  296. package/dist/extensions/pi-subagents/src/tui/fleet.ts +39 -18
  297. package/dist/extensions/pi-subagents/src/tui/render.ts +369 -46
  298. package/dist/extensions/pi-subagents/src/watchdog/turn-delta.ts +1 -1
  299. package/dist/extensions/pi-subagents/src/workflows/chat-progress.ts +6 -3
  300. package/dist/extensions/pi-subagents/src/workflows/host-command.ts +230 -0
  301. package/dist/extensions/pi-subagents/src/workflows/scripted-workflow.ts +740 -58
  302. package/dist/extensions/pi-subagents/src/workflows/workflow-child-summary.ts +121 -0
  303. package/dist/extensions/pi-subagents/src/workflows/workflow-preflight.ts +270 -0
  304. package/dist/extensions/pi-subagents/src/workflows/workflow-receipt.ts +195 -6
  305. package/dist/extensions/pi-subagents/src/workflows/workflow-settlement.ts +246 -0
  306. package/dist/extensions/pi-subagents/test/e2e/real-session-subagent.test.ts +2 -2
  307. package/dist/extensions/pi-subagents/test/integration/async-execution.test.ts +1114 -260
  308. package/dist/extensions/pi-subagents/test/integration/async-job-tracker.test.ts +34 -0
  309. package/dist/extensions/pi-subagents/test/integration/async-status.test.ts +150 -3
  310. package/dist/extensions/pi-subagents/test/integration/claude-code-smoke.test.ts +52 -0
  311. package/dist/extensions/pi-subagents/test/integration/claude-code-writer-smoke.test.ts +55 -0
  312. package/dist/extensions/pi-subagents/test/integration/codex-exec-smoke.test.ts +53 -0
  313. package/dist/extensions/pi-subagents/test/integration/codex-exec-writer-smoke.test.ts +57 -0
  314. package/dist/extensions/pi-subagents/test/integration/cursor-agent-smoke.test.ts +59 -0
  315. package/dist/extensions/pi-subagents/test/integration/cursor-agent-writer-smoke.test.ts +62 -0
  316. package/dist/extensions/pi-subagents/test/integration/error-handling.test.ts +57 -1
  317. package/dist/extensions/pi-subagents/test/integration/external-cli-runner.test.ts +1 -0
  318. package/dist/extensions/pi-subagents/test/integration/fork-context-execution.test.ts +20 -0
  319. package/dist/extensions/pi-subagents/test/integration/intercom-result-delivery.test.ts +4 -3
  320. package/dist/extensions/pi-subagents/test/integration/orca-progress-tabs.test.ts +2 -2
  321. package/dist/extensions/pi-subagents/test/integration/render-fork-badge.test.ts +54 -4
  322. package/dist/extensions/pi-subagents/test/integration/render-widget.test.ts +482 -4
  323. package/dist/extensions/pi-subagents/test/integration/result-watcher.test.ts +157 -9
  324. package/dist/extensions/pi-subagents/test/integration/session-tokens.test.ts +5 -5
  325. package/dist/extensions/pi-subagents/test/integration/single-execution.test.ts +1508 -291
  326. package/dist/extensions/pi-subagents/test/integration/slash-commands.test.ts +423 -1
  327. package/dist/extensions/pi-subagents/test/integration/template-resolution.test.ts +8 -0
  328. package/dist/extensions/pi-subagents/test/support/cursor-smoke-inputs.ts +51 -0
  329. package/dist/extensions/pi-subagents/test/support/helpers.ts +2 -0
  330. package/dist/extensions/pi-subagents/test/support/mock-pi.ts +5 -5
  331. package/dist/extensions/pi-subagents/test/support/real-session-runner.ts +6 -6
  332. package/dist/extensions/pi-subagents/test/unit/abort-recovery.test.ts +152 -0
  333. package/dist/extensions/pi-subagents/test/unit/active-async-capacity.test.ts +48 -0
  334. package/dist/extensions/pi-subagents/test/unit/agent-frontmatter.test.ts +184 -6
  335. package/dist/extensions/pi-subagents/test/unit/agent-management.test.ts +66 -6
  336. package/dist/extensions/pi-subagents/test/unit/agent-overrides.test.ts +77 -0
  337. package/dist/extensions/pi-subagents/test/unit/agent-refinements.test.ts +18 -0
  338. package/dist/extensions/pi-subagents/test/unit/anti-slop-oxlint.test.ts +86 -0
  339. package/dist/extensions/pi-subagents/test/unit/artifacts.test.ts +1 -1
  340. package/dist/extensions/pi-subagents/test/unit/async-execution.test.ts +101 -1
  341. package/dist/extensions/pi-subagents/test/unit/async-interrupt-action.test.ts +121 -0
  342. package/dist/extensions/pi-subagents/test/unit/async-recovery-descriptor.test.ts +28 -0
  343. package/dist/extensions/pi-subagents/test/unit/async-resume.test.ts +14 -7
  344. package/dist/extensions/pi-subagents/test/unit/async-retention.test.ts +53 -0
  345. package/dist/extensions/pi-subagents/test/unit/async-status-projection.test.ts +190 -0
  346. package/dist/extensions/pi-subagents/test/unit/async-status-snapshot.test.ts +42 -0
  347. package/dist/extensions/pi-subagents/test/unit/auto-drain.test.ts +8 -4
  348. package/dist/extensions/pi-subagents/test/unit/background-work.test.ts +23 -0
  349. package/dist/extensions/pi-subagents/test/unit/chain-root-attachment.test.ts +78 -1
  350. package/dist/extensions/pi-subagents/test/unit/child-launch-plan.test.ts +94 -0
  351. package/dist/extensions/pi-subagents/test/unit/child-protocol.test.ts +21 -0
  352. package/dist/extensions/pi-subagents/test/unit/child-session-name.test.ts +50 -0
  353. package/dist/extensions/pi-subagents/test/unit/claude-code-adapter.test.ts +245 -0
  354. package/dist/extensions/pi-subagents/test/unit/codex-exec-adapter.test.ts +192 -0
  355. package/dist/extensions/pi-subagents/test/unit/compaction-resume.test.ts +27 -0
  356. package/dist/extensions/pi-subagents/test/unit/completion-evidence.test.ts +150 -0
  357. package/dist/extensions/pi-subagents/test/unit/completion-guard.test.ts +21 -0
  358. package/dist/extensions/pi-subagents/test/unit/cursor-agent-adapter.test.ts +259 -0
  359. package/dist/extensions/pi-subagents/test/unit/cursor-smoke-inputs.test.ts +77 -0
  360. package/dist/extensions/pi-subagents/test/unit/delegation-api.test.ts +1 -4
  361. package/dist/extensions/pi-subagents/test/unit/doctor.test.ts +1 -1
  362. package/dist/extensions/pi-subagents/test/unit/extension-context.test.ts +27 -0
  363. package/dist/extensions/pi-subagents/test/unit/external-cli-runner.test.ts +223 -0
  364. package/dist/extensions/pi-subagents/test/unit/fast-mode-extension.test.ts +27 -0
  365. package/dist/extensions/pi-subagents/test/unit/fleet-status.test.ts +208 -2
  366. package/dist/extensions/pi-subagents/test/unit/fleet-transcript.test.ts +29 -1
  367. package/dist/extensions/pi-subagents/test/unit/fleet.test.ts +110 -1
  368. package/dist/extensions/pi-subagents/test/unit/foreground-control.test.ts +10 -0
  369. package/dist/extensions/pi-subagents/test/unit/formatters.test.ts +14 -0
  370. package/dist/extensions/pi-subagents/test/unit/herdr-inspector.test.ts +18 -9
  371. package/dist/extensions/pi-subagents/test/unit/herdr-session-roots-codec.test.ts +63 -0
  372. package/dist/extensions/pi-subagents/test/unit/herdr-shell-command.test.ts +2 -2
  373. package/dist/extensions/pi-subagents/test/unit/herdr-status-bridge.test.ts +136 -6
  374. package/dist/extensions/pi-subagents/test/unit/host-command.test.ts +156 -0
  375. package/dist/extensions/pi-subagents/test/unit/host-step-status.test.ts +98 -0
  376. package/dist/extensions/pi-subagents/test/unit/index-child-registration.test.ts +178 -26
  377. package/dist/extensions/pi-subagents/test/unit/index-segment.test.ts +2 -1
  378. package/dist/extensions/pi-subagents/test/unit/inspect-rpc.test.ts +21 -0
  379. package/dist/extensions/pi-subagents/test/unit/mcp-direct-tool-grant.test.ts +138 -0
  380. package/dist/extensions/pi-subagents/test/unit/mission-lifecycle.test.ts +1 -1
  381. package/dist/extensions/pi-subagents/test/unit/model-exclusions.test.ts +91 -0
  382. package/dist/extensions/pi-subagents/test/unit/model-fallback.test.ts +72 -7
  383. package/dist/extensions/pi-subagents/test/unit/mutation-evidence.test.ts +21 -0
  384. package/dist/extensions/pi-subagents/test/unit/nested-control.test.ts +1 -0
  385. package/dist/extensions/pi-subagents/test/unit/nested-events.test.ts +20 -2
  386. package/dist/extensions/pi-subagents/test/unit/notify.test.ts +129 -1
  387. package/dist/extensions/pi-subagents/test/unit/orca-progress-tabs.test.ts +2 -2
  388. package/dist/extensions/pi-subagents/test/unit/package-manifest.test.ts +4 -0
  389. package/dist/extensions/pi-subagents/test/unit/parallel-handoff.test.ts +358 -0
  390. package/dist/extensions/pi-subagents/test/unit/pi-args.test.ts +574 -21
  391. package/dist/extensions/pi-subagents/test/unit/pi-coding-agent-dir.test.ts +109 -1
  392. package/dist/extensions/pi-subagents/test/unit/preflight.test.ts +71 -1
  393. package/dist/extensions/pi-subagents/test/unit/profiles.test.ts +7 -7
  394. package/dist/extensions/pi-subagents/test/unit/pruned-fork.test.ts +214 -0
  395. package/dist/extensions/pi-subagents/test/unit/public-execution.test.ts +29 -8
  396. package/dist/extensions/pi-subagents/test/unit/render-helpers.test.ts +53 -0
  397. package/dist/extensions/pi-subagents/test/unit/result-delivery-ownership.test.ts +34 -0
  398. package/dist/extensions/pi-subagents/test/unit/result-files.test.ts +101 -3
  399. package/dist/extensions/pi-subagents/test/unit/retained-children.test.ts +1 -0
  400. package/dist/extensions/pi-subagents/test/unit/rpc.test.ts +10 -8
  401. package/dist/extensions/pi-subagents/test/unit/run-fanout-budget.test.ts +71 -1
  402. package/dist/extensions/pi-subagents/test/unit/run-status.test.ts +41 -7
  403. package/dist/extensions/pi-subagents/test/unit/runtime-agent-registration.test.ts +136 -2
  404. package/dist/extensions/pi-subagents/test/unit/scheduled-runs.test.ts +137 -0
  405. package/dist/extensions/pi-subagents/test/unit/schemas.test.ts +33 -12
  406. package/dist/extensions/pi-subagents/test/unit/scripted-workflow.test.ts +504 -1
  407. package/dist/extensions/pi-subagents/test/unit/single-output.test.ts +8 -0
  408. package/dist/extensions/pi-subagents/test/unit/skills-fallback.test.ts +1 -1
  409. package/dist/extensions/pi-subagents/test/unit/stale-run-reconciler.test.ts +12 -1
  410. package/dist/extensions/pi-subagents/test/unit/steering-action.test.ts +3 -5
  411. package/dist/extensions/pi-subagents/test/unit/steering.test.ts +5 -6
  412. package/dist/extensions/pi-subagents/test/unit/subagent-action-recovery.test.ts +0 -8
  413. package/dist/extensions/pi-subagents/test/unit/subagent-guide.test.ts +5 -0
  414. package/dist/extensions/pi-subagents/test/unit/subagent-prompt-runtime.test.ts +157 -2
  415. package/dist/extensions/pi-subagents/test/unit/subagent-startup-retry.test.ts +1 -1
  416. package/dist/extensions/pi-subagents/test/unit/subagent-wait.test.ts +63 -4
  417. package/dist/extensions/pi-subagents/test/unit/tool-description.test.ts +27 -23
  418. package/dist/extensions/pi-subagents/test/unit/wait-completions.test.ts +44 -0
  419. package/dist/extensions/pi-subagents/test/unit/wait-subscriptions.test.ts +1 -0
  420. package/dist/extensions/pi-subagents/test/unit/widget-nested-render.test.ts +7 -5
  421. package/dist/extensions/pi-subagents/test/unit/workflow-chat-progress.test.ts +106 -0
  422. package/dist/extensions/pi-subagents/test/unit/workflow-detach-reconcile.test.ts +484 -9
  423. package/dist/extensions/pi-subagents/test/unit/workflow-launch-params.test.ts +38 -4
  424. package/dist/extensions/pi-subagents/test/unit/workflow-preflight.test.ts +155 -0
  425. package/dist/extensions/pi-subagents/test/unit/workflow-receipt.test.ts +318 -0
  426. package/dist/extensions/pi-subagents/test/unit/workflow-resume-hint.test.ts +365 -0
  427. package/dist/extensions/pi-subagents/test/unit/worktree-cleanup-plan.test.ts +349 -0
  428. package/dist/extensions/pi-subagents/test/unit/worktree.test.ts +21 -0
  429. package/dist/extensions/pi-subagents/test/unit/writer-budget-guidance.test.ts +2 -7
  430. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/effect/index.ts +13 -0
  431. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/effect/rules/no-service-constructor-imports.ts +52 -0
  432. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/index.ts +41 -0
  433. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-chained-type-assertions.ts +77 -0
  434. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-conditional-empty-object-spread.ts +49 -0
  435. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-known-value-widening.ts +247 -0
  436. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-module-mocking.ts +91 -0
  437. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-object-parameters.ts +126 -0
  438. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-reflect-apply.ts +28 -0
  439. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-reflect-get.ts +28 -0
  440. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-runtime-typeof.ts +67 -0
  441. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-shape-in-symbol-names.ts +39 -0
  442. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-unknown-parameters.ts +83 -0
  443. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-unknown-returns.ts +115 -0
  444. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-unknown-type-aliases.ts +72 -0
  445. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-unsafe-dictionary-type.ts +134 -0
  446. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/no-widen-then-assert.ts +366 -0
  447. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/rules/require-safety-comment-for-type-assertion.ts +62 -0
  448. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/shared/dictionary-types.ts +502 -0
  449. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/shared/lexical-type-parameters.ts +60 -0
  450. package/dist/extensions/pi-subagents/tools/oxlint/anti-slop/shared/reflect-method.ts +35 -0
  451. package/dist/extensions/pi-tool-display/tests/capabilities.test.ts +1 -1
  452. package/dist/extensions/pi-tool-display/tests/settings-inspector.test.ts +2 -2
  453. package/dist/extensions/pi-tool-display/tests/tool-overrides-mcp.test.ts +1 -1
  454. package/dist/modes/interactive/interactive-mode.js +7 -7
  455. package/dist/skills/workflow/SKILL.md +65 -50
  456. package/package.json +112 -110
  457. package/dist/extensions/enable-readonly-tools.test.ts +0 -63
  458. package/dist/extensions/enable-readonly-tools.ts +0 -24
  459. package/dist/extensions/model-prompt-injector/config.json +0 -16
  460. package/dist/extensions/model-prompt-injector/index.test.ts +0 -102
  461. package/dist/extensions/model-prompt-injector/index.ts +0 -148
  462. package/dist/extensions/pi-subagents/src/runs/shared/turn-budget.ts +0 -98
  463. package/dist/extensions/pi-subagents/test/unit/turn-budget.test.ts +0 -250
@@ -1,19 +1,64 @@
1
- import { spawn } from "node:child_process";
1
+ import assert from "node:assert/strict";
2
+ import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";
2
3
  import * as fs from "node:fs";
3
4
  import * as path from "node:path";
4
5
  import { finished } from "node:stream/promises";
5
- import { trySignalChild } from "../../shared/post-exit-stdio-guard.ts";
6
6
  import type { ExternalProcessStatus } from "../../shared/types.ts";
7
+ import { createOwnedProcessTreeController, type OwnedProcessTreeController } from "../background/owned-process-tree.ts";
7
8
  import { omitExtensionBindingsEnv } from "./extension-bindings.ts";
9
+ import {
10
+ invalidateExternalCliPreflight,
11
+ preflightExternalCli,
12
+ type ExternalCliPreflightResult,
13
+ type ExternalCliPreflightSpec,
14
+ } from "./external-cli-preflight.ts";
8
15
 
9
- const HARD_KILL_DELAY_MS = 2_000;
10
16
  const MAX_OUTPUT_TAIL_BYTES = 64 * 1024;
11
17
  const MAX_ERROR_TAIL_BYTES = 64 * 1024;
18
+ const MAX_RAW_LOG_BYTES = 8 * 1024 * 1024;
19
+ const MAX_PARSER_LINE_BYTES = 256 * 1024;
20
+ const MAX_PARSER_STREAM_BYTES = 32 * 1024 * 1024;
21
+ const MAX_PARSER_OUTPUT_BYTES = 1024 * 1024;
22
+ const MAX_OVERSIZED_LINE_PREFIX_BYTES = 512;
23
+ const MAX_SKIPPABLE_LINE_BYTES = 1024 * 1024;
24
+ const PARSER_PROGRESS_INTERVAL_MS = 100;
12
25
 
13
26
  export function buildExternalCliPrompt(systemInstructions: string, task: string): string {
14
27
  return `<System instructions>\n${systemInstructions.trim()}\n\n<Task>\n${task}`;
15
28
  }
16
29
 
30
+ export interface ExternalCliParserProgress {
31
+ phase: string;
32
+ eventCount: number;
33
+ message?: string;
34
+ }
35
+
36
+ export interface ExternalCliParserTerminal {
37
+ state: "completed" | "failed";
38
+ output?: string;
39
+ error?: string;
40
+ }
41
+
42
+ export interface ExternalCliParser {
43
+ parseLine(line: string): ExternalCliParserProgress | undefined;
44
+ /** Inspect only a bounded prefix when a non-terminal event exceeds the normal line cap. */
45
+ skipOversizedLine?(prefix: string, byteLength: number): ExternalCliParserProgress | undefined;
46
+ finish(): ExternalCliParserTerminal | undefined;
47
+ }
48
+
49
+ export function parseExternalCliJsonlEvent(line: string, label: string, maxTypeLength: number): Record<string, unknown> {
50
+ let value: unknown;
51
+ try {
52
+ value = JSON.parse(line) as unknown;
53
+ } catch (error) {
54
+ throw new Error(`${label} emitted malformed JSONL: ${error instanceof Error ? error.message : String(error)}`);
55
+ }
56
+ if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${label} emitted a JSONL event that is not an object.`);
57
+ const event = value as Record<string, unknown>;
58
+ if (typeof event.type !== "string" || !event.type || event.type.length > maxTypeLength) throw new Error(`${label} emitted a JSONL event with an invalid type.`);
59
+ return event;
60
+ }
61
+
17
62
  export interface ExternalCliRunResult {
18
63
  output: string;
19
64
  exitCode: number | null;
@@ -22,6 +67,87 @@ export interface ExternalCliRunResult {
22
67
  stopped?: boolean;
23
68
  processSignal?: string | null;
24
69
  externalProcess: ExternalProcessStatus;
70
+ parserTerminal?: ExternalCliParserTerminal;
71
+ preflight?: ExternalCliPreflightResult;
72
+ }
73
+
74
+ interface StreamLimits {
75
+ stdoutLogBytes?: number;
76
+ stderrLogBytes?: number;
77
+ parserLineBytes?: number;
78
+ parserStreamBytes?: number;
79
+ parserOutputBytes?: number;
80
+ }
81
+
82
+ function narrowLimit(value: number | undefined, ceiling: number, label: string): number {
83
+ if (value === undefined) return ceiling;
84
+ assert(Number.isInteger(value) && value > 0 && value <= ceiling, `${label} may only narrow the code-owned ${ceiling}-byte limit.`);
85
+ return value;
86
+ }
87
+
88
+ function externalEnvironment(allowlist: readonly string[] | undefined, values: Readonly<Record<string, string>> | undefined): NodeJS.ProcessEnv {
89
+ if (!allowlist) return omitExtensionBindingsEnv(process.env);
90
+ const allowed = new Set(allowlist);
91
+ const env: NodeJS.ProcessEnv = {};
92
+ for (const key of allowed) {
93
+ if (!key || key.includes("=") || key.includes("\0")) throw new Error(`Invalid external CLI environment key: ${JSON.stringify(key)}.`);
94
+ if (process.env[key] !== undefined) env[key] = process.env[key];
95
+ }
96
+ for (const [key, value] of Object.entries(values ?? {})) {
97
+ if (!allowed.has(key)) throw new Error(`External CLI environment value '${key}' is not in the adapter allowlist.`);
98
+ env[key] = value;
99
+ }
100
+ return omitExtensionBindingsEnv(env);
101
+ }
102
+
103
+ function createByteTail(maxBytes: number): { push(chunk: Buffer): void; text(): string } {
104
+ const chunks: Buffer[] = [];
105
+ let bytes = 0;
106
+ return {
107
+ push(chunk) {
108
+ chunks.push(chunk);
109
+ bytes += chunk.length;
110
+ while (bytes > maxBytes && chunks.length > 0) {
111
+ const first = chunks[0]!;
112
+ const excess = bytes - maxBytes;
113
+ if (first.length <= excess) {
114
+ chunks.shift();
115
+ bytes -= first.length;
116
+ } else {
117
+ chunks[0] = first.subarray(excess);
118
+ bytes -= excess;
119
+ }
120
+ }
121
+ },
122
+ text: () => Buffer.concat(chunks, bytes).toString("utf-8"),
123
+ };
124
+ }
125
+
126
+ function writeBoundedLog(source: NodeJS.ReadableStream, stream: fs.WriteStream, chunk: Buffer, state: { bytes: number; total: number }, limit: number): void {
127
+ state.total += chunk.length;
128
+ const remaining = limit - state.bytes;
129
+ if (remaining <= 0) return;
130
+ const bytes = chunk.length > remaining ? chunk.subarray(0, remaining) : chunk;
131
+ state.bytes += bytes.length;
132
+ if (!stream.write(bytes)) {
133
+ source.pause();
134
+ stream.once("drain", () => source.resume());
135
+ }
136
+ }
137
+
138
+ function classifyInvalidation(error: string): "auth" | "permission" | "launch" {
139
+ if (/auth|unauthori[sz]ed|credential|login/i.test(error)) return "auth";
140
+ if (/permission|forbidden|denied|read.?only/i.test(error)) return "permission";
141
+ return "launch";
142
+ }
143
+
144
+ function terminateExternalProcessTree(pid: number, controller: OwnedProcessTreeController): Promise<unknown> {
145
+ if (process.platform !== "win32") return controller.terminate();
146
+ return new Promise((resolve) => {
147
+ const cleanup = spawn("taskkill", ["/PID", String(pid), "/T", "/F"], { stdio: "ignore", windowsHide: true });
148
+ cleanup.once("error", () => { void controller.terminate().then(resolve); });
149
+ cleanup.once("close", () => { void controller.terminate().then(resolve); });
150
+ });
25
151
  }
26
152
 
27
153
  export function runExternalCli(input: {
@@ -31,14 +157,29 @@ export function runExternalCli(input: {
31
157
  prompt: string;
32
158
  asyncDir: string;
33
159
  stepIndex: number;
160
+ environment?: { allowlist: readonly string[]; values?: Readonly<Record<string, string>> };
161
+ preflight?: ExternalCliPreflightSpec;
162
+ parser?: ExternalCliParser;
163
+ finalOutputPath?: string;
164
+ promptFilePath?: string;
165
+ temporaryDirectories?: readonly string[];
166
+ limits?: StreamLimits;
34
167
  registerTimeout?: (stop: (() => void) | undefined) => void;
35
168
  registerStop?: (stop: (() => void) | undefined) => void;
36
169
  timeoutMessage?: string;
37
170
  stopMessage?: string;
38
171
  onProcess?: (process: ExternalProcessStatus) => void;
172
+ onParserProgress?: (progress: ExternalCliParserProgress) => void;
39
173
  onStdout?: (chunk: Buffer) => void;
40
174
  onStderr?: (chunk: Buffer) => void;
41
175
  }): Promise<ExternalCliRunResult> {
176
+ const limits = {
177
+ stdoutLogBytes: narrowLimit(input.limits?.stdoutLogBytes, MAX_RAW_LOG_BYTES, "stdoutLogBytes"),
178
+ stderrLogBytes: narrowLimit(input.limits?.stderrLogBytes, MAX_RAW_LOG_BYTES, "stderrLogBytes"),
179
+ parserLineBytes: narrowLimit(input.limits?.parserLineBytes, MAX_PARSER_LINE_BYTES, "parserLineBytes"),
180
+ parserStreamBytes: narrowLimit(input.limits?.parserStreamBytes, MAX_PARSER_STREAM_BYTES, "parserStreamBytes"),
181
+ parserOutputBytes: narrowLimit(input.limits?.parserOutputBytes, MAX_PARSER_OUTPUT_BYTES, "parserOutputBytes"),
182
+ };
42
183
  return new Promise((resolve, reject) => {
43
184
  const startedAt = Date.now();
44
185
  const stdoutPath = path.join(input.asyncDir, `external-${input.stepIndex}.stdout.log`);
@@ -47,90 +188,242 @@ export function runExternalCli(input: {
47
188
  const stdoutStream = fs.createWriteStream(stdoutPath, { flags: "w" });
48
189
  const stderrStream = fs.createWriteStream(stderrPath, { flags: "w" });
49
190
  const streamsFinished = Promise.allSettled([finished(stdoutStream), finished(stderrStream)]);
50
- let stdoutTail = Buffer.alloc(0);
51
- let stderrTail = Buffer.alloc(0);
191
+ const createdDirectories: string[] = [];
192
+ let promptFileCreated = false;
193
+ const cleanupTemporaryPaths = () => {
194
+ if (input.promptFilePath && promptFileCreated) fs.rmSync(input.promptFilePath, { force: true });
195
+ for (const directory of createdDirectories.reverse()) fs.rmSync(directory, { recursive: true, force: true });
196
+ };
197
+ const env = externalEnvironment(input.environment?.allowlist, input.environment?.values);
198
+ let preflight: ExternalCliPreflightResult | undefined;
199
+ try {
200
+ for (const directory of input.temporaryDirectories ?? []) {
201
+ fs.mkdirSync(directory, { mode: 0o700 });
202
+ createdDirectories.push(directory);
203
+ }
204
+ if (input.promptFilePath) {
205
+ const promptDescriptor = fs.openSync(input.promptFilePath, "wx", 0o600);
206
+ promptFileCreated = true;
207
+ try { fs.writeFileSync(promptDescriptor, input.prompt, { encoding: "utf-8" }); }
208
+ finally { fs.closeSync(promptDescriptor); }
209
+ }
210
+ if (input.preflight) preflight = preflightExternalCli(input.command, input.preflight, env, input.cwd);
211
+ } catch (error) {
212
+ const endedAt = Date.now();
213
+ const externalProcess = { startedAt, endedAt, durationMs: endedAt - startedAt, exitCode: 1, processSignal: null, stdoutPath, stderrPath, ...(input.finalOutputPath ? { finalOutputPath: input.finalOutputPath } : {}) } satisfies ExternalProcessStatus;
214
+ stdoutStream.end();
215
+ stderrStream.end();
216
+ void streamsFinished.then((streamResults) => {
217
+ try { cleanupTemporaryPaths(); }
218
+ catch (cleanupError) { reject(cleanupError); return; }
219
+ const streamFailure = streamResults.find((streamResult) => streamResult.status === "rejected");
220
+ if (streamFailure?.status === "rejected") reject(streamFailure.reason);
221
+ else resolve({ output: "", exitCode: 1, error: error instanceof Error ? error.message : String(error), processSignal: null, externalProcess });
222
+ });
223
+ return;
224
+ }
225
+ const stdoutTail = createByteTail(MAX_OUTPUT_TAIL_BYTES);
226
+ const stderrTail = createByteTail(MAX_ERROR_TAIL_BYTES);
227
+ const stdoutLog = { bytes: 0, total: 0 };
228
+ const stderrLog = { bytes: 0, total: 0 };
229
+ let parserBytes = 0;
230
+ let pendingLine = Buffer.alloc(0);
231
+ let pendingLineBytes = 0;
232
+ let pendingLineOversizedAccepted = false;
233
+ let parserError: Error | undefined;
234
+ let parserTerminal: ExternalCliParserTerminal | undefined;
235
+ let latestProgress: ExternalCliParserProgress | undefined;
236
+ let progressTimer: NodeJS.Timeout | undefined;
52
237
  let timedOut = false;
53
238
  let stopped = false;
54
239
  let settled = false;
55
- let hardKillTimer: NodeJS.Timeout | undefined;
56
- const child = spawn(input.command, input.args ?? [], {
240
+ let processTree: OwnedProcessTreeController | undefined;
241
+ let processPid: number | undefined;
242
+ let termination: Promise<unknown> | undefined;
243
+ const flushProgress = () => {
244
+ if (!latestProgress) return;
245
+ input.onParserProgress?.(latestProgress);
246
+ latestProgress = undefined;
247
+ };
248
+ const reportProgress = (progress: ExternalCliParserProgress) => {
249
+ if (!progress.phase || progress.phase.length > 64 || !Number.isSafeInteger(progress.eventCount) || progress.eventCount < 0) {
250
+ failParser(new Error("External CLI parser returned invalid progress metadata."));
251
+ return;
252
+ }
253
+ latestProgress = { ...progress, ...(progress.message ? { message: progress.message.slice(0, 512) } : {}) };
254
+ if (progressTimer) return;
255
+ progressTimer = setTimeout(() => {
256
+ progressTimer = undefined;
257
+ flushProgress();
258
+ }, PARSER_PROGRESS_INTERVAL_MS);
259
+ progressTimer.unref?.();
260
+ };
261
+ const terminate = (reason: "timeout" | "stop") => {
262
+ if (settled || timedOut || stopped || parserError) return;
263
+ timedOut = reason === "timeout";
264
+ stopped = reason === "stop";
265
+ if (processTree && processPid !== undefined) termination = terminateExternalProcessTree(processPid, processTree);
266
+ };
267
+ const failParser = (error: unknown) => {
268
+ if (parserError) return;
269
+ parserError = error instanceof Error ? error : new Error(String(error));
270
+ if (input.preflight) invalidateExternalCliPreflight(input.command, input.preflight, "parser");
271
+ if (processTree && processPid !== undefined) termination = terminateExternalProcessTree(processPid, processTree);
272
+ };
273
+ const parseLine = (line: Buffer, byteLength = line.length): boolean => {
274
+ if (!input.parser || parserError) return false;
275
+ if (byteLength > limits.parserLineBytes) {
276
+ const progress = input.limits?.parserLineBytes === undefined
277
+ ? input.parser.skipOversizedLine?.(line.subarray(0, MAX_OVERSIZED_LINE_PREFIX_BYTES).toString("utf-8"), byteLength)
278
+ : undefined;
279
+ if (progress) { reportProgress(progress); return true; }
280
+ failParser(new Error("External CLI parser line exceeded its byte limit."));
281
+ return false;
282
+ }
283
+ try {
284
+ const progress = input.parser.parseLine(line.toString("utf-8"));
285
+ if (progress) reportProgress(progress);
286
+ } catch (error) { failParser(error); }
287
+ return false;
288
+ };
289
+ const appendPendingLine = (chunk: Buffer) => {
290
+ pendingLineBytes += chunk.length;
291
+ if (pendingLineOversizedAccepted) {
292
+ if (pendingLineBytes > MAX_SKIPPABLE_LINE_BYTES) failParser(new Error("External CLI parser line exceeded its byte limit."));
293
+ return;
294
+ }
295
+ if (pendingLineBytes <= limits.parserLineBytes) {
296
+ pendingLine = Buffer.concat([pendingLine, chunk]);
297
+ return;
298
+ }
299
+ if (pendingLineBytes > MAX_SKIPPABLE_LINE_BYTES) {
300
+ failParser(new Error("External CLI parser line exceeded its byte limit."));
301
+ return;
302
+ }
303
+ if (pendingLine.length > MAX_OVERSIZED_LINE_PREFIX_BYTES) pendingLine = pendingLine.subarray(0, MAX_OVERSIZED_LINE_PREFIX_BYTES);
304
+ const remainingPrefixBytes = MAX_OVERSIZED_LINE_PREFIX_BYTES - pendingLine.length;
305
+ if (remainingPrefixBytes > 0) pendingLine = Buffer.concat([pendingLine, chunk.subarray(0, remainingPrefixBytes)]);
306
+ pendingLineOversizedAccepted = parseLine(pendingLine, pendingLineBytes);
307
+ };
308
+ const finishPendingLine = () => {
309
+ if (!pendingLineOversizedAccepted) parseLine(pendingLine, pendingLineBytes);
310
+ pendingLine = Buffer.alloc(0);
311
+ pendingLineBytes = 0;
312
+ pendingLineOversizedAccepted = false;
313
+ };
314
+ const parseChunk = (chunk: Buffer) => {
315
+ if (!input.parser || parserError) return;
316
+ parserBytes += chunk.length;
317
+ if (parserBytes > limits.parserStreamBytes) {
318
+ failParser(new Error("External CLI parser stream exceeded its byte limit."));
319
+ return;
320
+ }
321
+ let start = 0;
322
+ for (let index = 0; index < chunk.length; index++) {
323
+ if (chunk[index] !== 0x0a) continue;
324
+ appendPendingLine(chunk.subarray(start, index));
325
+ finishPendingLine();
326
+ start = index + 1;
327
+ }
328
+ appendPendingLine(chunk.subarray(start));
329
+ };
330
+ const child = spawn(preflight?.binaryPath ?? input.command, input.args ?? [], {
57
331
  cwd: input.cwd,
58
- env: omitExtensionBindingsEnv(process.env),
332
+ env,
59
333
  stdio: ["pipe", "pipe", "pipe"],
60
334
  shell: false,
61
335
  windowsHide: true,
62
- });
336
+ detached: process.platform !== "win32",
337
+ }) as ChildProcessWithoutNullStreams;
338
+ if (typeof child.pid === "number") {
339
+ processPid = child.pid;
340
+ processTree = createOwnedProcessTreeController(child.pid, { termGraceMs: 2_000 });
341
+ }
63
342
  const initialProcess: ExternalProcessStatus = {
64
343
  ...(typeof child.pid === "number" ? { pid: child.pid } : {}),
65
344
  startedAt,
66
345
  stdoutPath,
67
346
  stderrPath,
347
+ ...(input.finalOutputPath ? { finalOutputPath: input.finalOutputPath } : {}),
68
348
  };
69
349
  input.onProcess?.(initialProcess);
70
350
  child.stdout.on("data", (chunk: Buffer) => {
71
- stdoutStream.write(chunk);
351
+ parseChunk(chunk);
352
+ writeBoundedLog(child.stdout, stdoutStream, chunk, stdoutLog, limits.stdoutLogBytes);
72
353
  input.onStdout?.(chunk);
73
- stdoutTail = Buffer.concat([stdoutTail, chunk]);
74
- if (stdoutTail.length > MAX_OUTPUT_TAIL_BYTES) stdoutTail = stdoutTail.subarray(stdoutTail.length - MAX_OUTPUT_TAIL_BYTES);
354
+ stdoutTail.push(chunk);
75
355
  });
76
356
  child.stderr.on("data", (chunk: Buffer) => {
77
- stderrStream.write(chunk);
357
+ writeBoundedLog(child.stderr, stderrStream, chunk, stderrLog, limits.stderrLogBytes);
78
358
  input.onStderr?.(chunk);
79
- stderrTail = Buffer.concat([stderrTail, chunk]);
80
- if (stderrTail.length > MAX_ERROR_TAIL_BYTES) stderrTail = stderrTail.subarray(stderrTail.length - MAX_ERROR_TAIL_BYTES);
359
+ stderrTail.push(chunk);
81
360
  });
82
- const terminate = (reason: "timeout" | "stop") => {
83
- if (settled || timedOut || stopped) return;
84
- timedOut = reason === "timeout";
85
- stopped = reason === "stop";
86
- trySignalChild(child, "SIGTERM");
87
- hardKillTimer = setTimeout(() => {
88
- if (!settled) trySignalChild(child, "SIGKILL");
89
- }, HARD_KILL_DELAY_MS);
90
- hardKillTimer.unref?.();
91
- };
92
361
  input.registerTimeout?.(() => terminate("timeout"));
93
362
  input.registerStop?.(() => terminate("stop"));
94
363
  child.stdin.on("error", () => {});
95
- child.stdin.end(input.prompt);
364
+ child.stdin.end(input.promptFilePath ? undefined : input.prompt);
96
365
  let spawnError: Error | undefined;
97
366
  child.once("error", (error) => { spawnError = error; });
367
+ child.stdout.once("end", () => {
368
+ if (!input.parser || parserError) return;
369
+ if (pendingLineBytes > 0) finishPendingLine();
370
+ try {
371
+ parserTerminal = input.parser.finish();
372
+ if (!parserTerminal) failParser(new Error("External CLI parser did not produce a terminal state."));
373
+ else if (Buffer.byteLength(parserTerminal.output ?? "", "utf-8") > limits.parserOutputBytes) failParser(new Error("External CLI parser terminal output exceeded its byte limit."));
374
+ else if (Buffer.byteLength(parserTerminal.error ?? "", "utf-8") > 4 * 1024) failParser(new Error("External CLI parser terminal error exceeded its byte limit."));
375
+ } catch (error) { failParser(error); }
376
+ });
98
377
  child.once("close", (exitCode, signal) => {
99
378
  settled = true;
100
- if (hardKillTimer) clearTimeout(hardKillTimer);
379
+ if (progressTimer) clearTimeout(progressTimer);
380
+ flushProgress();
101
381
  input.registerTimeout?.(undefined);
102
382
  input.registerStop?.(undefined);
103
- const endedAt = Date.now();
104
- const externalProcess: ExternalProcessStatus = {
105
- ...initialProcess,
106
- endedAt,
107
- durationMs: endedAt - startedAt,
108
- exitCode,
109
- processSignal: signal,
110
- };
111
- input.onProcess?.(externalProcess);
112
- const stderr = stderrTail.toString("utf-8").trim();
113
- const error = stopped
114
- ? input.stopMessage ?? "Subagent stopped by user."
115
- : timedOut
116
- ? input.timeoutMessage ?? "Subagent timed out."
117
- : spawnError?.message ?? (exitCode === 0 ? undefined : stderr || `External CLI exited with code ${exitCode}.`);
118
- const result: ExternalCliRunResult = {
119
- output: stdoutTail.toString("utf-8").trim(),
120
- exitCode: timedOut || stopped || spawnError ? 1 : exitCode,
121
- ...(error ? { error } : {}),
122
- ...(timedOut ? { timedOut: true } : {}),
123
- ...(stopped ? { stopped: true } : {}),
124
- processSignal: signal,
125
- externalProcess,
126
- };
127
- stdoutStream.end();
128
- stderrStream.end();
129
- void streamsFinished.then((streamResults) => {
383
+ void (async () => {
384
+ if (termination) await termination;
385
+ else if (processTree) await processTree.finishAfterWriterClose();
386
+ const endedAt = Date.now();
387
+ const externalProcess: ExternalProcessStatus = {
388
+ ...initialProcess,
389
+ endedAt,
390
+ durationMs: endedAt - startedAt,
391
+ exitCode,
392
+ processSignal: signal,
393
+ stdoutBytes: stdoutLog.total,
394
+ stderrBytes: stderrLog.total,
395
+ ...(stdoutLog.total > stdoutLog.bytes ? { stdoutTruncated: true } : {}),
396
+ ...(stderrLog.total > stderrLog.bytes ? { stderrTruncated: true } : {}),
397
+ };
398
+ input.onProcess?.(externalProcess);
399
+ const stderr = stderrTail.text().trim();
400
+ const parserFailure = parserError?.message ?? (parserTerminal?.state === "failed" ? parserTerminal.error ?? "External CLI parser reported terminal failure." : undefined);
401
+ const error = stopped
402
+ ? input.stopMessage ?? "Subagent stopped by user."
403
+ : timedOut
404
+ ? input.timeoutMessage ?? "Subagent timed out."
405
+ : spawnError?.message ?? parserFailure ?? (exitCode === 0 ? undefined : stderr || `External CLI exited with code ${exitCode}.`);
406
+ if (error && input.preflight && !parserError) invalidateExternalCliPreflight(input.command, input.preflight, classifyInvalidation(error));
407
+ const result: ExternalCliRunResult = {
408
+ output: (!parserError && parserTerminal?.state === "completed" ? parserTerminal.output ?? "" : stdoutTail.text()).trim(),
409
+ exitCode: timedOut || stopped || spawnError || parserFailure ? 1 : exitCode,
410
+ ...(error ? { error } : {}),
411
+ ...(timedOut ? { timedOut: true } : {}),
412
+ ...(stopped ? { stopped: true } : {}),
413
+ processSignal: signal,
414
+ externalProcess,
415
+ ...(parserTerminal ? { parserTerminal } : {}),
416
+ ...(preflight ? { preflight } : {}),
417
+ };
418
+ stdoutStream.end();
419
+ stderrStream.end();
420
+ const streamResults = await streamsFinished;
130
421
  const streamFailure = streamResults.find((streamResult) => streamResult.status === "rejected");
422
+ try { cleanupTemporaryPaths(); }
423
+ catch (cleanupError) { reject(cleanupError); return; }
131
424
  if (streamFailure?.status === "rejected") reject(streamFailure.reason);
132
425
  else resolve(result);
133
- });
426
+ })();
134
427
  });
135
428
  });
136
429
  }
@@ -1,10 +1,10 @@
1
- import type { ExtensionAPI } from "@selesai/code";
1
+ import type { BeforeProviderRequestEvent, ExtensionAPI } from "@selesai/code";
2
2
 
3
- function withPriorityServiceTier(payload: unknown): unknown {
4
- if (!payload || typeof payload !== "object" || Array.isArray(payload)) return payload;
5
- return { ...payload, service_tier: "priority" };
3
+ export function rewriteFastModeProviderRequest(event: BeforeProviderRequestEvent): unknown {
4
+ if (!event.payload || typeof event.payload !== "object" || Array.isArray(event.payload)) return event.payload;
5
+ return { ...event.payload, service_tier: "priority" };
6
6
  }
7
7
 
8
8
  export default function registerSubagentFastModeExtension(pi: ExtensionAPI): void {
9
- pi.on("before_provider_request", (event) => ({ payload: withPriorityServiceTier(event.payload) }));
9
+ pi.on("before_provider_request", rewriteFastModeProviderRequest);
10
10
  }