pi-crew 0.9.50 → 0.9.52

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 (609) hide show
  1. package/CHANGELOG.md +150 -0
  2. package/README.md +216 -20
  3. package/dist/build-meta.json +2222 -1761
  4. package/dist/index.mjs +18636 -17603
  5. package/docs/actions-reference.md +431 -1
  6. package/package.json +19 -9
  7. package/schema.json +41 -0
  8. package/scripts/check-bundle-size.mjs +38 -0
  9. package/scripts/test-runner.mjs +11 -1
  10. package/skills/distill-software/SKILL.md +24 -1
  11. package/dist/index.mjs.map +0 -7
  12. package/docs/FEATURE_INTAKE.md +0 -126
  13. package/docs/HARNESS.md +0 -87
  14. package/docs/HARNESS_BACKLOG.md +0 -89
  15. package/docs/PROJECT_REVIEW.md +0 -270
  16. package/docs/PROJECT_REVIEW_FIXES.md +0 -342
  17. package/docs/PROJECT_REVIEW_ROUND4.md +0 -156
  18. package/docs/PROJECT_REVIEW_ROUND5.md +0 -86
  19. package/docs/REVIEW-FINDINGS-2026-06 +0 -357
  20. package/docs/REVIEW-FINDINGS-2026-07-CORE.md +0 -139
  21. package/docs/REVIEW-FINDINGS-2026-07.md +0 -125
  22. package/docs/TEST_MATRIX.md +0 -51
  23. package/docs/archive/README.md +0 -91
  24. package/docs/archive/followup-review-round3-2026-05-12.md +0 -342
  25. package/docs/archive/followup-review-round4-2026-05-13.md +0 -107
  26. package/docs/archive/pi-crew-bugs.md +0 -961
  27. package/docs/archive/pi-crew-test-final.md +0 -120
  28. package/docs/archive/pi-crew-test-results.md +0 -260
  29. package/docs/archive/pi-crew-test-round2.md +0 -136
  30. package/docs/archive/pi-crew-test-round4.md +0 -100
  31. package/docs/archive/pi-crew-test-round5.md +0 -70
  32. package/docs/archive/pi-crew-test-round6.md +0 -110
  33. package/docs/archive/pi-crew-v0.5.10-audit-fix-plan.md +0 -60
  34. package/docs/archive/pi-crew-v0.5.11-audit-fix-plan.md +0 -92
  35. package/docs/archive/pi-crew-v0.5.12-audit-fix-plan.md +0 -76
  36. package/docs/archive/pi-crew-v0.5.13-audit-fix-plan.md +0 -75
  37. package/docs/archive/pi-crew-v0.5.14-audit-fix-plan.md +0 -75
  38. package/docs/archive/pi-crew-v0.5.16-audit-fix-plan.md +0 -35
  39. package/docs/archive/pi-crew-v0.5.17-audit-fix-plan.md +0 -80
  40. package/docs/archive/pi-crew-v0.5.5-audit-fix-plan.md +0 -133
  41. package/docs/archive/pi-crew-v0.5.9-audit-fix-plan.md +0 -88
  42. package/docs/archive/pi-mono-opportunities.md +0 -969
  43. package/docs/archive/pi-mono-review.md +0 -291
  44. package/docs/archive/pi-subagent4-comparison.md +0 -261
  45. package/docs/archive/pi-subagents3-deep-analysis.md +0 -508
  46. package/docs/bugs/bug-021-notification-badge-counter-misleading.md +0 -293
  47. package/docs/bugs/bug-023-chain-windows-path-resolution.md +0 -106
  48. package/docs/bugs/bug-quota-display-truncation.md +0 -223
  49. package/docs/bugs/cross-session-notification-leakage.md +0 -82
  50. package/docs/code-review-2026-05-11.md +0 -592
  51. package/docs/coding-agent-optimization.md +0 -268
  52. package/docs/comparison-pi-subagents-vs-pi-crew.md +0 -303
  53. package/docs/decisions/0001-durable-state.md +0 -41
  54. package/docs/decisions/0002-child-process-for-async.md +0 -42
  55. package/docs/decisions/0003-depth-guard.md +0 -36
  56. package/docs/decisions/0004-execfile-over-exec.md +0 -34
  57. package/docs/decisions/0005-no-parameter-properties.md +0 -49
  58. package/docs/decisions/0006-publish-bundled-esm.md +0 -63
  59. package/docs/decisions/0007-active-run-binary-index.md +0 -54
  60. package/docs/decisions/0008-child-pi-warm-pool.md +0 -61
  61. package/docs/decisions/2026-07-21-broker-phase4-default-on.md +0 -77
  62. package/docs/decisions/2026-07-21-broker-windows-perms.md +0 -91
  63. package/docs/decisions/2026-07-22-broker-phase4-gated-on.md +0 -99
  64. package/docs/decisions/2026-07-24-oidc-trusted-publishing.md +0 -112
  65. package/docs/decisions/README.md +0 -26
  66. package/docs/deep-review-report.md +0 -384
  67. package/docs/distillation/cybersecurity-patterns.md +0 -294
  68. package/docs/feature-analysis-subagent4.md +0 -305
  69. package/docs/fix-plan-disabletools-exit-null.md +0 -219
  70. package/docs/fixes/BATCH_A_H1_H2.md +0 -86
  71. package/docs/fixes/bug-006-foreground-cancel-concurrent.md +0 -78
  72. package/docs/fixes/bug-007-async-notifier-stale-ctx.md +0 -112
  73. package/docs/fixes/bug-008-child-process-silent-timeout.md +0 -100
  74. package/docs/fixes/bug-009-executor-yield-limit-needs-attention.md +0 -75
  75. package/docs/fixes/bug-010-child-process-api-key-filtered.md +0 -109
  76. package/docs/fixes/bug-011-spawn-pi-enoent.md +0 -92
  77. package/docs/fixes/bug-012-essential-env-stripped.md +0 -89
  78. package/docs/fixes/bug-013-background-runner-death.md +0 -84
  79. package/docs/fixes/bug-014-infinite-retry-loop-needs-attention.md +0 -82
  80. package/docs/fixes/bug-015-background-runner-sigterm.md +0 -65
  81. package/docs/fixes/bug-017-background-runner-session-shutdown.md +0 -66
  82. package/docs/fixes/bug-017-background-runner-sigkill-double-fork.md +0 -28
  83. package/docs/fixes/bug-018-child-pi-worker-stdin-hang.md +0 -61
  84. package/docs/fixes/bug-019-phantom-runs-temp-workspace.md +0 -52
  85. package/docs/fixes/bug-020-infinite-retry-loop-needs-attention.md +0 -47
  86. package/docs/fixes/v0.9.10/locks-fix-verify.md +0 -3
  87. package/docs/fixes/v0.9.10/smoke-test.md +0 -12
  88. package/docs/followup-plan-2026-05-12.md +0 -463
  89. package/docs/followup-review-2026-05-12.md +0 -297
  90. package/docs/goals.md +0 -59
  91. package/docs/implementation-plan-top3.md +0 -333
  92. package/docs/issue-29-analysis.md +0 -189
  93. package/docs/live-mailbox-runtime.md +0 -36
  94. package/docs/migration/atomic-write-v2-migration.md +0 -299
  95. package/docs/next-upgrade-roadmap.md +0 -808
  96. package/docs/oh-my-pi-research.md +0 -509
  97. package/docs/optimization-plan-2026-07.md +0 -366
  98. package/docs/optimization-plan.md +0 -644
  99. package/docs/patterns/command-agent-skill.md +0 -71
  100. package/docs/perf/baseline-2026-05.md +0 -113
  101. package/docs/perf/final-report-2026-05.md +0 -206
  102. package/docs/perf/optimization-plan-2026-07-verified.md +0 -396
  103. package/docs/perf/performance-audit-report-2026-07.md +0 -948
  104. package/docs/perf/performance-review-2026-07.md +0 -287
  105. package/docs/perf/sprint-1-report.md +0 -71
  106. package/docs/perf/sprint-2-report.md +0 -81
  107. package/docs/perf/sprint-2.5-report.md +0 -53
  108. package/docs/perf/sprint-3-report.md +0 -36
  109. package/docs/perf/sprint-4-report.md +0 -47
  110. package/docs/perf/sprint-5-report.md +0 -51
  111. package/docs/perf/sprint-6-report.md +0 -94
  112. package/docs/perf/sprint-7-report.md +0 -74
  113. package/docs/perf/upgrade-plan-2026-05.md +0 -147
  114. package/docs/performance-optimization-execution-plan.md +0 -520
  115. package/docs/phase4-triage.md +0 -58
  116. package/docs/pi-crew-investigation-report.md +0 -411
  117. package/docs/product/README.md +0 -31
  118. package/docs/product/platform.md +0 -27
  119. package/docs/product/runtime-safety.md +0 -37
  120. package/docs/product/team-run.md +0 -39
  121. package/docs/product/team-tool.md +0 -37
  122. package/docs/runtime-analysis-child-vs-live.md +0 -171
  123. package/docs/runtime-migration-in-process-analysis.md +0 -250
  124. package/docs/skills/REFERENCE.md +0 -138
  125. package/docs/stories/README.md +0 -32
  126. package/docs/stories/US-DEPS-major-upgrade.md +0 -62
  127. package/docs/stories/backlog.md +0 -36
  128. package/docs/superpowers/plans/2026-06-09-fallow-patterns-adoption.md +0 -1270
  129. package/docs/templates/decision.md +0 -27
  130. package/docs/templates/story.md +0 -44
  131. package/docs/templates/validation-report.md +0 -32
  132. package/docs/ui-optimization-plan.md +0 -447
  133. package/src/adapters/claude-adapter.ts +0 -23
  134. package/src/adapters/codex-adapter.ts +0 -21
  135. package/src/adapters/cursor-adapter.ts +0 -17
  136. package/src/adapters/export-util.ts +0 -143
  137. package/src/adapters/index.ts +0 -15
  138. package/src/adapters/registry.ts +0 -18
  139. package/src/adapters/types.ts +0 -23
  140. package/src/agents/agent-config.ts +0 -194
  141. package/src/agents/agent-search.ts +0 -98
  142. package/src/agents/agent-serializer.ts +0 -38
  143. package/src/agents/discover-agents.ts +0 -623
  144. package/src/benchmark/benchmark-runner.ts +0 -313
  145. package/src/benchmark/feedback-loop.ts +0 -73
  146. package/src/config/config.ts +0 -1269
  147. package/src/config/defaults.ts +0 -193
  148. package/src/config/drift-detector.ts +0 -290
  149. package/src/config/markers.ts +0 -330
  150. package/src/config/resilient-parser.ts +0 -117
  151. package/src/config/role-tools.ts +0 -118
  152. package/src/config/suggestions.ts +0 -75
  153. package/src/config/types.ts +0 -278
  154. package/src/errors.ts +0 -194
  155. package/src/extension/action-suggestions.ts +0 -117
  156. package/src/extension/async-notifier.ts +0 -179
  157. package/src/extension/autonomous-policy.ts +0 -209
  158. package/src/extension/command-completions.ts +0 -120
  159. package/src/extension/context-status-injection.ts +0 -185
  160. package/src/extension/crew-autocomplete.ts +0 -131
  161. package/src/extension/crew-cleanup.ts +0 -168
  162. package/src/extension/crew-input-router.ts +0 -93
  163. package/src/extension/crew-shortcuts.ts +0 -87
  164. package/src/extension/crew-vibes/cat-frames.ts +0 -18
  165. package/src/extension/crew-vibes/config.ts +0 -195
  166. package/src/extension/crew-vibes/figures.ts +0 -101
  167. package/src/extension/crew-vibes/font-detect.ts +0 -71
  168. package/src/extension/crew-vibes/footer.ts +0 -292
  169. package/src/extension/crew-vibes/index.ts +0 -432
  170. package/src/extension/crew-vibes/provider-usage.ts +0 -396
  171. package/src/extension/crew-vibes/render.ts +0 -206
  172. package/src/extension/crew-vibes/speed.ts +0 -286
  173. package/src/extension/cross-extension-rpc.ts +0 -350
  174. package/src/extension/help.ts +0 -62
  175. package/src/extension/import-index.ts +0 -74
  176. package/src/extension/knowledge-injection.ts +0 -402
  177. package/src/extension/management.ts +0 -571
  178. package/src/extension/message-renderers.ts +0 -108
  179. package/src/extension/notification-router.ts +0 -152
  180. package/src/extension/notification-sink.ts +0 -54
  181. package/src/extension/pi-api.ts +0 -56
  182. package/src/extension/plan-orchestrate.ts +0 -302
  183. package/src/extension/project-init.ts +0 -170
  184. package/src/extension/register.ts +0 -113
  185. package/src/extension/registration/artifact-cleanup.ts +0 -20
  186. package/src/extension/registration/command-registration.ts +0 -58
  187. package/src/extension/registration/command-utils.ts +0 -58
  188. package/src/extension/registration/commands.ts +0 -1228
  189. package/src/extension/registration/compaction-guard.ts +0 -333
  190. package/src/extension/registration/context-builder.ts +0 -135
  191. package/src/extension/registration/crash-recovery-cache.ts +0 -54
  192. package/src/extension/registration/foreground-run-controller.ts +0 -238
  193. package/src/extension/registration/hook-registration.ts +0 -119
  194. package/src/extension/registration/lazy-configurers.ts +0 -124
  195. package/src/extension/registration/lifecycle-handlers.ts +0 -923
  196. package/src/extension/registration/lifecycle.ts +0 -259
  197. package/src/extension/registration/observability.ts +0 -322
  198. package/src/extension/registration/registration-types.ts +0 -158
  199. package/src/extension/registration/runtime-cleanup.ts +0 -230
  200. package/src/extension/registration/subagent-helpers.ts +0 -125
  201. package/src/extension/registration/subagent-manager-setup.ts +0 -330
  202. package/src/extension/registration/subagent-tools.ts +0 -456
  203. package/src/extension/registration/team-tool.ts +0 -220
  204. package/src/extension/registration/tool-registration.ts +0 -50
  205. package/src/extension/registration/ui.ts +0 -172
  206. package/src/extension/registration/viewers.ts +0 -121
  207. package/src/extension/registration/wire-cross-extension.ts +0 -37
  208. package/src/extension/result-watcher.ts +0 -139
  209. package/src/extension/rpc-hmac.ts +0 -256
  210. package/src/extension/run-bundle-schema.ts +0 -104
  211. package/src/extension/run-export.ts +0 -97
  212. package/src/extension/run-import.ts +0 -168
  213. package/src/extension/run-index.ts +0 -131
  214. package/src/extension/run-maintenance.ts +0 -190
  215. package/src/extension/session-summary.ts +0 -18
  216. package/src/extension/team-manager-command.ts +0 -153
  217. package/src/extension/team-onboard.ts +0 -177
  218. package/src/extension/team-recommendation.ts +0 -288
  219. package/src/extension/team-tool/anchor.ts +0 -172
  220. package/src/extension/team-tool/api.ts +0 -1244
  221. package/src/extension/team-tool/auto-summarize.ts +0 -142
  222. package/src/extension/team-tool/cache-control.ts +0 -19
  223. package/src/extension/team-tool/cancel.ts +0 -337
  224. package/src/extension/team-tool/chain-dispatch.ts +0 -95
  225. package/src/extension/team-tool/chain-executor.ts +0 -379
  226. package/src/extension/team-tool/config-patch.ts +0 -50
  227. package/src/extension/team-tool/context.ts +0 -149
  228. package/src/extension/team-tool/destructive-gate.ts +0 -52
  229. package/src/extension/team-tool/doctor.ts +0 -431
  230. package/src/extension/team-tool/explain.ts +0 -282
  231. package/src/extension/team-tool/failure-patterns.ts +0 -118
  232. package/src/extension/team-tool/goal-wrap.ts +0 -330
  233. package/src/extension/team-tool/goal.ts +0 -556
  234. package/src/extension/team-tool/handle-schedule.ts +0 -332
  235. package/src/extension/team-tool/handle-settings.ts +0 -520
  236. package/src/extension/team-tool/health-monitor.ts +0 -481
  237. package/src/extension/team-tool/inspect.ts +0 -88
  238. package/src/extension/team-tool/intent-policy.ts +0 -45
  239. package/src/extension/team-tool/lifecycle-actions.ts +0 -615
  240. package/src/extension/team-tool/orchestrate.ts +0 -98
  241. package/src/extension/team-tool/parallel-dispatch.ts +0 -183
  242. package/src/extension/team-tool/plan.ts +0 -50
  243. package/src/extension/team-tool/respond.ts +0 -150
  244. package/src/extension/team-tool/run-not-found.ts +0 -49
  245. package/src/extension/team-tool/run.ts +0 -1035
  246. package/src/extension/team-tool/status.ts +0 -260
  247. package/src/extension/team-tool/workflow-manage.ts +0 -261
  248. package/src/extension/team-tool-types.ts +0 -26
  249. package/src/extension/team-tool.ts +0 -1116
  250. package/src/extension/tool-result.ts +0 -16
  251. package/src/extension/validate-resources.ts +0 -108
  252. package/src/hooks/registry.ts +0 -200
  253. package/src/hooks/types.ts +0 -69
  254. package/src/i18n.ts +0 -212
  255. package/src/observability/correlation.ts +0 -50
  256. package/src/observability/event-bus.ts +0 -86
  257. package/src/observability/event-to-metric.ts +0 -170
  258. package/src/observability/exporters/adapter.ts +0 -27
  259. package/src/observability/exporters/otlp-exporter.ts +0 -356
  260. package/src/observability/exporters/prometheus-exporter.ts +0 -54
  261. package/src/observability/metric-registry.ts +0 -100
  262. package/src/observability/metric-retention.ts +0 -64
  263. package/src/observability/metric-sink.ts +0 -99
  264. package/src/observability/metrics-primitives.ts +0 -219
  265. package/src/plugins/plugin-define.ts +0 -6
  266. package/src/plugins/plugin-registry.ts +0 -32
  267. package/src/plugins/plugins/index.ts +0 -3
  268. package/src/plugins/plugins/nextjs.ts +0 -19
  269. package/src/plugins/plugins/vite.ts +0 -10
  270. package/src/plugins/plugins/vitest.ts +0 -9
  271. package/src/prompt/prompt-runtime.ts +0 -380
  272. package/src/runtime/adaptive-plan.ts +0 -563
  273. package/src/runtime/agent-control.ts +0 -215
  274. package/src/runtime/agent-memory.ts +0 -81
  275. package/src/runtime/agent-observability.ts +0 -122
  276. package/src/runtime/anchor-manager.ts +0 -475
  277. package/src/runtime/async-marker.ts +0 -32
  278. package/src/runtime/async-runner.ts +0 -381
  279. package/src/runtime/attention-events.ts +0 -28
  280. package/src/runtime/auto-summarize.ts +0 -344
  281. package/src/runtime/background-runner.ts +0 -837
  282. package/src/runtime/batch-barrier.ts +0 -147
  283. package/src/runtime/broker-issuer.ts +0 -37
  284. package/src/runtime/cancellation-token.ts +0 -99
  285. package/src/runtime/cancellation.ts +0 -99
  286. package/src/runtime/capability-inventory.ts +0 -137
  287. package/src/runtime/chain-parser.ts +0 -237
  288. package/src/runtime/chain-runner.ts +0 -606
  289. package/src/runtime/checkpoint.ts +0 -291
  290. package/src/runtime/child-pi-constants.ts +0 -42
  291. package/src/runtime/child-pi-kill.ts +0 -180
  292. package/src/runtime/child-pi-pool.ts +0 -68
  293. package/src/runtime/child-pi-spawn.ts +0 -287
  294. package/src/runtime/child-pi-steering.ts +0 -128
  295. package/src/runtime/child-pi-streams.ts +0 -296
  296. package/src/runtime/child-pi-transcript.ts +0 -169
  297. package/src/runtime/child-pi.ts +0 -1105
  298. package/src/runtime/coalesce-tasks.ts +0 -268
  299. package/src/runtime/code-summary.ts +0 -292
  300. package/src/runtime/command-trace.ts +0 -105
  301. package/src/runtime/compact-pipeline.ts +0 -56
  302. package/src/runtime/compact-stages/ansi-strip-stage.ts +0 -25
  303. package/src/runtime/compact-stages/blank-collapse-stage.ts +0 -31
  304. package/src/runtime/compact-stages/deduplicate-stage.ts +0 -34
  305. package/src/runtime/compact-stages/head-snap-stage.ts +0 -57
  306. package/src/runtime/compact-stages/index.ts +0 -23
  307. package/src/runtime/compact-stages/tail-capture-stage.ts +0 -77
  308. package/src/runtime/compact-stages/truncation-stage.ts +0 -74
  309. package/src/runtime/compaction-summary.ts +0 -278
  310. package/src/runtime/completion-guard.ts +0 -207
  311. package/src/runtime/concurrency.ts +0 -58
  312. package/src/runtime/crash-classification.ts +0 -229
  313. package/src/runtime/crash-recovery.ts +0 -577
  314. package/src/runtime/crew-agent-records.ts +0 -593
  315. package/src/runtime/crew-agent-runtime.ts +0 -62
  316. package/src/runtime/crew-broker-child.ts +0 -88
  317. package/src/runtime/crew-broker-client.ts +0 -673
  318. package/src/runtime/crew-broker-tokens.ts +0 -84
  319. package/src/runtime/crew-broker.ts +0 -1276
  320. package/src/runtime/crew-hooks.ts +0 -227
  321. package/src/runtime/cross-extension-rpc.ts +0 -143
  322. package/src/runtime/custom-tools/irc-tool.ts +0 -282
  323. package/src/runtime/custom-tools/submit-result-tool.ts +0 -102
  324. package/src/runtime/deadletter.ts +0 -47
  325. package/src/runtime/delivery-coordinator.ts +0 -211
  326. package/src/runtime/delta-conflict.ts +0 -348
  327. package/src/runtime/deterministic-ast.ts +0 -161
  328. package/src/runtime/diagnostic-export.ts +0 -171
  329. package/src/runtime/direct-run.ts +0 -45
  330. package/src/runtime/dwf-state-store.ts +0 -102
  331. package/src/runtime/dynamic-workflow-context.ts +0 -1016
  332. package/src/runtime/dynamic-workflow-runner.ts +0 -310
  333. package/src/runtime/effectiveness.ts +0 -90
  334. package/src/runtime/errors/crew-errors.ts +0 -162
  335. package/src/runtime/event-stream-bridge.ts +0 -98
  336. package/src/runtime/foreground-control.ts +0 -193
  337. package/src/runtime/foreground-watchdog.ts +0 -132
  338. package/src/runtime/global-worker-cap.ts +0 -96
  339. package/src/runtime/goal-achievement.ts +0 -148
  340. package/src/runtime/goal-evaluator.ts +0 -361
  341. package/src/runtime/goal-loop-runner.ts +0 -828
  342. package/src/runtime/goal-state-store.ts +0 -219
  343. package/src/runtime/green-contract.ts +0 -55
  344. package/src/runtime/group-join.ts +0 -267
  345. package/src/runtime/handoff-manager.ts +0 -598
  346. package/src/runtime/heartbeat-gradient.ts +0 -36
  347. package/src/runtime/heartbeat-watcher.ts +0 -239
  348. package/src/runtime/hidden-handoff.ts +0 -407
  349. package/src/runtime/important-line-classifier.ts +0 -140
  350. package/src/runtime/intercom-bridge.ts +0 -187
  351. package/src/runtime/iteration-hooks.ts +0 -305
  352. package/src/runtime/live-agent-control.ts +0 -136
  353. package/src/runtime/live-agent-manager.ts +0 -704
  354. package/src/runtime/live-control-realtime.ts +0 -56
  355. package/src/runtime/live-extension-bridge.ts +0 -148
  356. package/src/runtime/live-irc.ts +0 -97
  357. package/src/runtime/live-session-health.ts +0 -108
  358. package/src/runtime/live-session-runtime.ts +0 -1139
  359. package/src/runtime/loop-gates.ts +0 -128
  360. package/src/runtime/manifest-cache.ts +0 -375
  361. package/src/runtime/mcp-proxy.ts +0 -105
  362. package/src/runtime/metric-parser.ts +0 -36
  363. package/src/runtime/model-fallback.ts +0 -409
  364. package/src/runtime/model-resolver.ts +0 -126
  365. package/src/runtime/model-scope.ts +0 -158
  366. package/src/runtime/orphan-worker-registry.ts +0 -465
  367. package/src/runtime/output-validator.ts +0 -202
  368. package/src/runtime/overflow-recovery.ts +0 -206
  369. package/src/runtime/parallel-research.ts +0 -68
  370. package/src/runtime/parallel-utils.ts +0 -160
  371. package/src/runtime/parent-guard.ts +0 -134
  372. package/src/runtime/path-overlap.ts +0 -150
  373. package/src/runtime/peer-dep.ts +0 -292
  374. package/src/runtime/per-write-validator.ts +0 -181
  375. package/src/runtime/phase-progress.ts +0 -217
  376. package/src/runtime/phase-tracker.ts +0 -385
  377. package/src/runtime/pi-args.ts +0 -655
  378. package/src/runtime/pi-json-output.ts +0 -170
  379. package/src/runtime/pi-spawn.ts +0 -273
  380. package/src/runtime/pipeline-runner.ts +0 -523
  381. package/src/runtime/plan-templates.ts +0 -201
  382. package/src/runtime/policy-engine.ts +0 -115
  383. package/src/runtime/post-checks.ts +0 -142
  384. package/src/runtime/post-exit-stdio-guard.ts +0 -104
  385. package/src/runtime/process-lifecycle.ts +0 -491
  386. package/src/runtime/process-status.ts +0 -154
  387. package/src/runtime/progress-event-coalescer.ts +0 -44
  388. package/src/runtime/progress-tracker.ts +0 -124
  389. package/src/runtime/prose-compressor.ts +0 -162
  390. package/src/runtime/recovery-recipes.ts +0 -203
  391. package/src/runtime/replace.ts +0 -570
  392. package/src/runtime/resilient-edit.ts +0 -153
  393. package/src/runtime/result-extractor.ts +0 -213
  394. package/src/runtime/retry-executor.ts +0 -100
  395. package/src/runtime/retry-runner.ts +0 -336
  396. package/src/runtime/role-permission.ts +0 -59
  397. package/src/runtime/run-coalesced-task-group.ts +0 -308
  398. package/src/runtime/run-drift.ts +0 -219
  399. package/src/runtime/run-tracker.ts +0 -116
  400. package/src/runtime/runtime-policy.ts +0 -29
  401. package/src/runtime/runtime-resolver.ts +0 -172
  402. package/src/runtime/runtime-warmup.ts +0 -160
  403. package/src/runtime/scheduler.ts +0 -353
  404. package/src/runtime/semaphore.ts +0 -141
  405. package/src/runtime/sensitive-paths.ts +0 -93
  406. package/src/runtime/session-resources.ts +0 -25
  407. package/src/runtime/session-snapshot.ts +0 -59
  408. package/src/runtime/session-usage.ts +0 -79
  409. package/src/runtime/settings-store.ts +0 -155
  410. package/src/runtime/sidechain-output.ts +0 -35
  411. package/src/runtime/single-agent-compose.ts +0 -84
  412. package/src/runtime/skill-effectiveness.ts +0 -524
  413. package/src/runtime/skill-instructions.ts +0 -391
  414. package/src/runtime/stale-reconciler.ts +0 -680
  415. package/src/runtime/stream-preview.ts +0 -184
  416. package/src/runtime/streaming-output.ts +0 -50
  417. package/src/runtime/subagent-manager.ts +0 -561
  418. package/src/runtime/subprocess-tool-registry.ts +0 -70
  419. package/src/runtime/supervisor-contact.ts +0 -64
  420. package/src/runtime/task-display.ts +0 -52
  421. package/src/runtime/task-graph-scheduler.ts +0 -227
  422. package/src/runtime/task-graph.ts +0 -290
  423. package/src/runtime/task-health.ts +0 -83
  424. package/src/runtime/task-id.ts +0 -161
  425. package/src/runtime/task-output-context.ts +0 -602
  426. package/src/runtime/task-packet.ts +0 -268
  427. package/src/runtime/task-quality.ts +0 -199
  428. package/src/runtime/task-runner/capabilities.ts +0 -78
  429. package/src/runtime/task-runner/context-retrieval.ts +0 -163
  430. package/src/runtime/task-runner/live-executor.ts +0 -227
  431. package/src/runtime/task-runner/output-splitter.ts +0 -152
  432. package/src/runtime/task-runner/progress.ts +0 -157
  433. package/src/runtime/task-runner/prompt-builder.ts +0 -278
  434. package/src/runtime/task-runner/prompt-pipeline.ts +0 -88
  435. package/src/runtime/task-runner/result-utils.ts +0 -16
  436. package/src/runtime/task-runner/retrieval-orchestrator.ts +0 -310
  437. package/src/runtime/task-runner/run-projection.ts +0 -125
  438. package/src/runtime/task-runner/state-helpers.ts +0 -176
  439. package/src/runtime/task-runner/tail-read.ts +0 -34
  440. package/src/runtime/task-runner.ts +0 -1420
  441. package/src/runtime/team-runner-artifacts.ts +0 -13
  442. package/src/runtime/team-runner.ts +0 -1993
  443. package/src/runtime/tool-output-pruner.ts +0 -333
  444. package/src/runtime/tool-progress.ts +0 -278
  445. package/src/runtime/usage-tracker.ts +0 -73
  446. package/src/runtime/verification-gates.ts +0 -571
  447. package/src/runtime/verification-integrity.ts +0 -105
  448. package/src/runtime/verification-worktree.ts +0 -186
  449. package/src/runtime/worker-heartbeat.ts +0 -25
  450. package/src/runtime/worker-startup.ts +0 -83
  451. package/src/runtime/workflow-state.ts +0 -195
  452. package/src/runtime/workspace-lock.ts +0 -443
  453. package/src/runtime/workspace-tree.ts +0 -312
  454. package/src/runtime/yield-handler.ts +0 -224
  455. package/src/runtime/zombie-scanner.ts +0 -298
  456. package/src/schema/config-schema.ts +0 -327
  457. package/src/schema/team-tool-schema.ts +0 -415
  458. package/src/schema/validation-types.ts +0 -159
  459. package/src/skills/discover-skills.ts +0 -197
  460. package/src/skills/skill-templates.ts +0 -456
  461. package/src/skills/validate.ts +0 -285
  462. package/src/state/active-run-registry.ts +0 -439
  463. package/src/state/artifact-store.ts +0 -176
  464. package/src/state/atomic-write.ts +0 -903
  465. package/src/state/blob-store.ts +0 -308
  466. package/src/state/contracts.ts +0 -158
  467. package/src/state/crew-init.ts +0 -269
  468. package/src/state/decision-ledger.ts +0 -345
  469. package/src/state/event-log-rotation.ts +0 -342
  470. package/src/state/event-log.ts +0 -1311
  471. package/src/state/event-reconstructor.ts +0 -229
  472. package/src/state/gitignore-manager.ts +0 -46
  473. package/src/state/health-store.ts +0 -79
  474. package/src/state/hook-instinct-bridge.ts +0 -94
  475. package/src/state/hook-integrations.ts +0 -51
  476. package/src/state/instinct-store.ts +0 -275
  477. package/src/state/jsonl-writer.ts +0 -107
  478. package/src/state/locks.ts +0 -562
  479. package/src/state/mailbox.ts +0 -916
  480. package/src/state/observation-store.ts +0 -176
  481. package/src/state/run-cache.ts +0 -193
  482. package/src/state/run-graph.ts +0 -183
  483. package/src/state/run-metrics.ts +0 -165
  484. package/src/state/schedule.ts +0 -166
  485. package/src/state/session-state-map.ts +0 -51
  486. package/src/state/state-store.ts +0 -958
  487. package/src/state/task-claims.ts +0 -61
  488. package/src/state/tiered-eval.ts +0 -480
  489. package/src/state/types-eval.ts +0 -58
  490. package/src/state/types.ts +0 -440
  491. package/src/state/usage.ts +0 -138
  492. package/src/state/worker-atomic-writer.ts +0 -194
  493. package/src/subagents/async-entry.ts +0 -1
  494. package/src/subagents/index.ts +0 -3
  495. package/src/subagents/live/control.ts +0 -1
  496. package/src/subagents/live/manager.ts +0 -1
  497. package/src/subagents/live/realtime.ts +0 -1
  498. package/src/subagents/live/session-runtime.ts +0 -1
  499. package/src/subagents/manager.ts +0 -1
  500. package/src/subagents/spawn.ts +0 -1
  501. package/src/teams/discover-teams.ts +0 -187
  502. package/src/teams/team-config.ts +0 -27
  503. package/src/teams/team-serializer.ts +0 -38
  504. package/src/tools/safe-bash-extension.ts +0 -54
  505. package/src/tools/safe-bash.ts +0 -505
  506. package/src/types/diff.d.ts +0 -18
  507. package/src/types/new-api-types.ts +0 -35
  508. package/src/ui/agent-management-overlay.ts +0 -160
  509. package/src/ui/card-colors.ts +0 -139
  510. package/src/ui/crew-footer.ts +0 -102
  511. package/src/ui/crew-select-list.ts +0 -111
  512. package/src/ui/dashboard-panes/agents-pane.ts +0 -164
  513. package/src/ui/dashboard-panes/cancellation-pane.ts +0 -66
  514. package/src/ui/dashboard-panes/capability-pane.ts +0 -77
  515. package/src/ui/dashboard-panes/health-pane.ts +0 -31
  516. package/src/ui/dashboard-panes/mailbox-pane.ts +0 -35
  517. package/src/ui/dashboard-panes/metrics-pane.ts +0 -37
  518. package/src/ui/dashboard-panes/progress-pane.ts +0 -38
  519. package/src/ui/dashboard-panes/transcript-pane.ts +0 -10
  520. package/src/ui/deploy-bundled-themes.ts +0 -71
  521. package/src/ui/dwf-phase-display.ts +0 -151
  522. package/src/ui/dynamic-border.ts +0 -35
  523. package/src/ui/heartbeat-aggregator.ts +0 -74
  524. package/src/ui/key-utils.ts +0 -42
  525. package/src/ui/keybinding-map.ts +0 -248
  526. package/src/ui/layout-primitives.ts +0 -106
  527. package/src/ui/live-conversation-overlay.ts +0 -183
  528. package/src/ui/live-duration.ts +0 -55
  529. package/src/ui/live-run-sidebar.ts +0 -301
  530. package/src/ui/loaders.ts +0 -176
  531. package/src/ui/mascot.ts +0 -436
  532. package/src/ui/overlays/agent-picker-overlay.ts +0 -65
  533. package/src/ui/overlays/confirm-overlay.ts +0 -60
  534. package/src/ui/overlays/help-overlay.ts +0 -177
  535. package/src/ui/overlays/mailbox-compose-overlay.ts +0 -181
  536. package/src/ui/overlays/mailbox-compose-preview.ts +0 -78
  537. package/src/ui/overlays/mailbox-detail-overlay.ts +0 -154
  538. package/src/ui/pi-ui-compat.ts +0 -68
  539. package/src/ui/powerbar-publisher.ts +0 -459
  540. package/src/ui/render-coalescer.ts +0 -101
  541. package/src/ui/render-diff.ts +0 -160
  542. package/src/ui/render-scheduler.ts +0 -224
  543. package/src/ui/run-action-dispatcher.ts +0 -182
  544. package/src/ui/run-dashboard.ts +0 -913
  545. package/src/ui/run-event-bus.ts +0 -381
  546. package/src/ui/run-snapshot-cache.ts +0 -1057
  547. package/src/ui/settings-overlay.ts +0 -1067
  548. package/src/ui/snapshot-types.ts +0 -90
  549. package/src/ui/spinner.ts +0 -17
  550. package/src/ui/status-colors.ts +0 -143
  551. package/src/ui/syntax-highlight.ts +0 -136
  552. package/src/ui/terminal-status.ts +0 -269
  553. package/src/ui/theme-adapter.ts +0 -271
  554. package/src/ui/theme-discovery.ts +0 -199
  555. package/src/ui/tool-progress-formatter.ts +0 -93
  556. package/src/ui/tool-render.ts +0 -453
  557. package/src/ui/tool-renderers/brief-mode.ts +0 -225
  558. package/src/ui/tool-renderers/index.ts +0 -726
  559. package/src/ui/transcript-cache.ts +0 -128
  560. package/src/ui/transcript-entries.ts +0 -256
  561. package/src/ui/transcript-viewer.ts +0 -424
  562. package/src/ui/widget/index.ts +0 -357
  563. package/src/ui/widget/widget-formatters.ts +0 -182
  564. package/src/ui/widget/widget-model.ts +0 -110
  565. package/src/ui/widget/widget-renderer.ts +0 -182
  566. package/src/ui/widget/widget-types.ts +0 -36
  567. package/src/utils/bm25-search.ts +0 -235
  568. package/src/utils/completion-dedupe.ts +0 -63
  569. package/src/utils/conflict-detect.ts +0 -668
  570. package/src/utils/env-allowlist.ts +0 -30
  571. package/src/utils/env-filter.ts +0 -155
  572. package/src/utils/file-coalescer.ts +0 -98
  573. package/src/utils/fingerprint.ts +0 -180
  574. package/src/utils/frontmatter.ts +0 -70
  575. package/src/utils/fs-watch.ts +0 -37
  576. package/src/utils/gh-protocol.ts +0 -556
  577. package/src/utils/git.ts +0 -260
  578. package/src/utils/guards.ts +0 -107
  579. package/src/utils/ids.ts +0 -24
  580. package/src/utils/incremental-reader.ts +0 -220
  581. package/src/utils/internal-error.ts +0 -10
  582. package/src/utils/names.ts +0 -36
  583. package/src/utils/ndjson.ts +0 -115
  584. package/src/utils/paths.ts +0 -227
  585. package/src/utils/project-detector.ts +0 -160
  586. package/src/utils/redaction.ts +0 -347
  587. package/src/utils/resolve-shell.ts +0 -36
  588. package/src/utils/run-watcher-registry.ts +0 -152
  589. package/src/utils/safe-paths.ts +0 -383
  590. package/src/utils/scan-cache.ts +0 -144
  591. package/src/utils/session-utils.ts +0 -110
  592. package/src/utils/sleep.ts +0 -54
  593. package/src/utils/socket-path.ts +0 -127
  594. package/src/utils/sse-parser.ts +0 -129
  595. package/src/utils/task-name-generator.ts +0 -337
  596. package/src/utils/timings.ts +0 -33
  597. package/src/utils/token-counter.ts +0 -200
  598. package/src/utils/visual.ts +0 -207
  599. package/src/workflows/cost-estimator.ts +0 -34
  600. package/src/workflows/discover-workflows.ts +0 -290
  601. package/src/workflows/intermediate-store.ts +0 -166
  602. package/src/workflows/preflight-validator.ts +0 -168
  603. package/src/workflows/topology-analyzer.ts +0 -203
  604. package/src/workflows/validate-workflow.ts +0 -50
  605. package/src/workflows/workflow-config.ts +0 -70
  606. package/src/workflows/workflow-serializer.ts +0 -32
  607. package/src/worktree/branch-freshness.ts +0 -112
  608. package/src/worktree/cleanup.ts +0 -341
  609. package/src/worktree/worktree-manager.ts +0 -1200
@@ -1,1139 +0,0 @@
1
- import * as fs from "node:fs";
2
- import * as path from "node:path";
3
- import type { AgentConfig } from "../agents/agent-config.ts";
4
- import { resolveToolPolicy } from "../agents/agent-config.ts";
5
- import type { CrewRuntimeConfig } from "../config/config.ts";
6
- import { loadConfig } from "../config/config.ts";
7
- import { DEFAULT_LIVE_SESSION } from "../config/defaults.ts";
8
- import { appendEvent, appendEventFireAndForget } from "../state/event-log.ts";
9
- import type { TeamRunManifest, TeamTaskState, UsageState } from "../state/types.ts";
10
- import { logInternalError } from "../utils/internal-error.ts";
11
- import { redactSecrets } from "../utils/redaction.ts";
12
- import type { WorkflowStep } from "../workflows/workflow-config.ts";
13
- import { createIrcTool } from "./custom-tools/irc-tool.ts";
14
- import { createSubmitResultTool } from "./custom-tools/submit-result-tool.ts";
15
- import { applyLiveAgentControlRequest, applyLiveAgentControlRequests, type LiveAgentControlCursor } from "./live-agent-control.ts";
16
- import {
17
- disposeLiveAgentSession,
18
- listLiveAgents,
19
- markLiveAgentCompleted,
20
- registerLiveAgent,
21
- terminateLiveAgent,
22
- trackLiveAgentResponseText,
23
- trackLiveAgentToolEnd,
24
- trackLiveAgentToolStart,
25
- trackLiveAgentTurnEnd,
26
- updateLiveAgentStatus,
27
- } from "./live-agent-manager.ts";
28
- import { subscribeLiveControlRealtime } from "./live-control-realtime.ts";
29
- import { buildExtensionBridge } from "./live-extension-bridge.ts";
30
- import { collectLiveSessionHealth, formatLiveSessionDiagnostics } from "./live-session-health.ts";
31
- import { buildMcpProxyFromSession } from "./mcp-proxy.ts";
32
- import { buildConfiguredModelRouting } from "./model-fallback.ts";
33
- import { readEnabledModelsPatterns } from "./model-scope.ts";
34
- import { isLiveSessionRuntimeAvailable } from "./runtime-resolver.ts";
35
- import { awaitRuntimeWarmup } from "./runtime-warmup.ts";
36
- // prose-compressor imported for custom tool descriptions below;
37
- // tool description compression for SDK-managed tools awaits SDK support.
38
- import { buildSensitivePathConstraint } from "./sensitive-paths.ts";
39
- import { eventToSidechainType, sidechainOutputPath, writeSidechainEntry } from "./sidechain-output.ts";
40
- // NOTE: buildMemoryBlock is intentionally NOT imported here. The agent memory
41
- // block is injected via renderTaskPrompt().full (the USER prompt), which is
42
- // shared by both the child-pi path (no system prompt) and the live-session
43
- // path. Adding it to liveSystemPrompt() too duplicated the entire memory
44
- // block (up to 200 lines) in both the user and system prompts. Keep memory
45
- // in a single place: the shared user prompt. See G3 fix.
46
- import { createStreamingOutput, type StreamingOutputHandle } from "./streaming-output.ts";
47
- import { trackTaskUsage } from "./usage-tracker.ts";
48
- import {
49
- buildYieldReminder,
50
- DEFAULT_YIELD_CONFIG,
51
- extractYieldResult,
52
- hasYieldInOutput,
53
- isYieldEvent,
54
- validateYieldData,
55
- type YieldResult,
56
- } from "./yield-handler.ts";
57
-
58
- /**
59
- * Module-scoped latch for the optional peer dependency import. When N
60
- * in-process live-session subagents spawn CONCURRENTLY (e.g. several
61
- * `Agent({run_in_background:true})` started at once), each used to call
62
- // LAZY: defer dynamic import of @earendil-works/pi-coding-agent to its call site.
63
- * `await import("@earendil-works/pi-coding-agent")` independently. Under the
64
- * tsx loader (registering load/resolve hooks), concurrent first-imports can
65
- * each enter the loader and race module-record instantiation, yielding
66
- * `Cannot read properties of undefined (reading 'existsSync')` /
67
- * `'validateWorkflowForTeam'` as namespace bindings observed mid-evaluation.
68
- * Sequential retries always succeed → this is a cold-start race, not a logic
69
- * bug. ESM engines memoize imports, but that memoization is not guaranteed
70
- * to be observed synchronously across concurrent evaluation under transpiling
71
- * loaders, so we add an explicit JS-level latch: the first caller wins, every
72
- * later caller awaits the same in-flight promise. (Observed 2026-06-16 when 4
73
- * explorer subagents launched together; 3 of 4 crashed.)
74
- */
75
- let liveSessionModulePromise: Promise<LiveSessionModule> | undefined;
76
- function loadLiveSessionModule(): Promise<LiveSessionModule> {
77
- if (!liveSessionModulePromise) {
78
- liveSessionModulePromise = import("@earendil-works/pi-coding-agent") as unknown as Promise<LiveSessionModule>;
79
- }
80
- return liveSessionModulePromise;
81
- }
82
-
83
- export interface LiveSessionSpawnInput {
84
- manifest: TeamRunManifest;
85
- task: TeamTaskState;
86
- step: WorkflowStep;
87
- agent: AgentConfig;
88
- prompt: string;
89
- signal?: AbortSignal;
90
- transcriptPath?: string;
91
- onEvent?: (event: unknown) => void;
92
- onOutput?: (text: string) => void;
93
- runtimeConfig?: CrewRuntimeConfig;
94
- parentContext?: string;
95
- parentModel?: unknown;
96
- modelRegistry?: unknown;
97
- modelOverride?: string;
98
- teamRoleModel?: string;
99
- isCurrent?: () => boolean;
100
- /** Workspace where this run was initiated — used for session-scoped live-agent visibility. */
101
- workspaceId: string;
102
- /** Phase 2: Output schema for validating yield data. */
103
- outputSchema?: unknown;
104
- }
105
-
106
- export interface LiveSessionRunResult {
107
- available: true;
108
- exitCode: number | null;
109
- stdout: string;
110
- stderr: string;
111
- jsonEvents: number;
112
- usage?: UsageState;
113
- error?: string;
114
- /** Phase 1: Extracted yield result from submit_result tool call. */
115
- yieldResult?: YieldResult;
116
- }
117
-
118
- export interface LiveSessionUnavailableResult {
119
- available: false;
120
- reason: string;
121
- }
122
-
123
- export interface LiveSessionPlannedResult {
124
- available: true;
125
- reason: string;
126
- }
127
-
128
- type LiveSessionModule = Record<string, unknown> & {
129
- createAgentSession?: (options?: Record<string, unknown>) => Promise<{ session: LiveSessionLike; modelFallbackMessage?: string }>;
130
- DefaultResourceLoader?: new (options: Record<string, unknown>) => { reload?: () => Promise<void> };
131
- SessionManager?: {
132
- inMemory?: (cwd?: string) => unknown;
133
- create?: (cwd?: string, sessionDir?: string) => unknown;
134
- };
135
- SettingsManager?: { create?: (cwd?: string, agentDir?: string) => unknown };
136
- getAgentDir?: () => string;
137
- };
138
-
139
- type LiveSessionLike = {
140
- subscribe?: (listener: (event: unknown) => void) => () => void;
141
- prompt?: (text: string, options?: Record<string, unknown>) => Promise<void>;
142
- steer?: (text: string) => Promise<void>;
143
- abort?: () => Promise<void> | void;
144
- dispose?: () => void;
145
- getStats?: () => unknown;
146
- stats?: unknown;
147
- bindExtensions?: (bindings?: Record<string, unknown>) => Promise<void>;
148
- getActiveToolNames?: () => string[];
149
- setActiveToolsByName?: (names: string[]) => void;
150
- };
151
-
152
- function appendTranscript(filePath: string | undefined, event: unknown): void {
153
- if (!filePath) return;
154
- // Fire-and-forget async write to avoid blocking the event loop.
155
- // Transcript writes are best-effort telemetry — callers do not need to await.
156
- void appendTranscriptAsync(filePath, event);
157
- }
158
-
159
- /** Async version of appendTranscript — fire-and-forget for non-blocking writes. */
160
- async function appendTranscriptAsync(filePath: string, event: unknown): Promise<void> {
161
- try {
162
- await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
163
- const content = `${JSON.stringify(redactSecrets(event))}\n`;
164
- await fs.promises.appendFile(filePath, content, "utf-8");
165
- } catch (error) {
166
- logInternalError("live-session.transcript-write-failed", error as Error, `path=${filePath}`);
167
- }
168
- }
169
-
170
- function asRecord(value: unknown): Record<string, unknown> | undefined {
171
- return value && typeof value === "object" && !Array.isArray(value) ? (value as Record<string, unknown>) : undefined;
172
- }
173
-
174
- function isString(value: unknown): value is string {
175
- return typeof value === "string";
176
- }
177
-
178
- /**
179
- * Type-safe extractor for message role from streaming events.
180
- * Handles the case where message may be a Record with a role field.
181
- */
182
- function extractMessageRole(obj: Record<string, unknown> | undefined): string | undefined {
183
- const message = obj?.message ? asRecord(obj.message) : undefined;
184
- return isString(message?.role) ? message.role : undefined;
185
- }
186
-
187
- /**
188
- * Type-safe extractor for message usage from streaming events.
189
- * Handles the case where message may be a Record with usage data.
190
- */
191
- function extractMessageUsage(obj: Record<string, unknown> | undefined): Record<string, unknown> | undefined {
192
- const message = obj?.message ? asRecord(obj.message) : undefined;
193
- return message?.usage && typeof message.usage === "object" ? (message.usage as Record<string, unknown>) : undefined;
194
- }
195
-
196
- /**
197
- * Type-safe extractor for tool name from streaming events.
198
- * Handles various event structures: { tool: { name } }, { toolName }, { name }.
199
- */
200
- function extractToolName(obj: Record<string, unknown> | undefined): string | undefined {
201
- if (!obj) return undefined;
202
- const tool = asRecord(obj.tool);
203
- if (isString(tool?.name)) return tool.name;
204
- if (isString(obj.toolName)) return obj.toolName;
205
- if (isString(obj.name)) return obj.name;
206
- return undefined;
207
- }
208
-
209
- function textFromContent(content: unknown): string[] {
210
- if (typeof content === "string") return [content];
211
- if (!Array.isArray(content)) return [];
212
- return content.flatMap((part) => {
213
- const obj = asRecord(part);
214
- if (!obj) return [];
215
- if (obj.type === "text" && typeof obj.text === "string") return [obj.text];
216
- if (typeof obj.content === "string") return [obj.content];
217
- return [];
218
- });
219
- }
220
-
221
- function eventText(event: unknown): string[] {
222
- const obj = asRecord(event);
223
- if (!obj) return [];
224
- const text: string[] = [];
225
- if (typeof obj.text === "string") text.push(obj.text);
226
- text.push(...textFromContent(obj.content));
227
- const message = asRecord(obj.message);
228
- if (message) text.push(...textFromContent(message.content));
229
- return text.filter((entry) => entry.trim());
230
- }
231
-
232
- function finalAssistantText(event: unknown): string[] {
233
- const obj = asRecord(event);
234
- if (obj?.type !== "message_end") return [];
235
- const message = asRecord(obj.message);
236
- if (message?.role !== "assistant") return [];
237
- return textFromContent(message.content);
238
- }
239
-
240
- function numberField(obj: Record<string, unknown> | undefined, keys: string[]): number | undefined {
241
- if (!obj) return undefined;
242
- for (const key of keys) {
243
- const value = obj[key];
244
- if (typeof value === "number" && Number.isFinite(value)) return value;
245
- }
246
- return undefined;
247
- }
248
-
249
- /**
250
- * F7: resolve the enabledModels allowlist for the current project, but only
251
- * if the `runtime.reliability.scopeModels` toggle is ON. Returns an empty
252
- * array when the toggle is off or no allowlist is configured — the routing
253
- * gate treats empty patterns as "no enforcement" (no-op). Best-effort:
254
- * any failure to read the toggle or the allowlist silently disables the gate
255
- * rather than blocking spawn.
256
- */
257
- async function resolveScopeModelsPatterns(cwd: string, agentDir?: string): Promise<string[]> {
258
- let scopeModels = false;
259
- try {
260
- scopeModels = loadConfig(cwd).config.reliability?.scopeModels === true;
261
- } catch {
262
- return [];
263
- }
264
- if (!scopeModels) return [];
265
- return readEnabledModelsPatterns(cwd, agentDir);
266
- }
267
-
268
- function modelFromRegistry(modelRegistry: unknown, modelId: string | undefined): unknown {
269
- if (!modelId?.includes("/")) return undefined;
270
- const registry = asRecord(modelRegistry);
271
- const find = registry?.find;
272
- if (typeof find !== "function") return undefined;
273
- const [provider, ...modelParts] = modelId.split("/");
274
- const id = modelParts.join("/");
275
- try {
276
- return find.call(modelRegistry, provider, id);
277
- } catch {
278
- return undefined;
279
- }
280
- }
281
-
282
- /**
283
- * Round 18: when agent declares `model: false`, the inherited `parentModel`
284
- * (= `ctx.model` from Pi runtime, set via `team-tool.ts:541/655`) is the
285
- * session's SAVED model. That saved model can be stale (e.g. a previous
286
- * session used claude-sonnet-4-5 and saved it as session.model; the new
287
- * session actually runs on minimax-M3 displayed in the footer). If the
288
- * saved model has no auth in `modelRegistry`, the worker fails immediately
289
- * with "No API key found" before reaching any fallback candidate.
290
- *
291
- * This helper prefers the saved model when it is in the auth-available
292
- * registry; otherwise falls back to the first auth-available registry
293
- * model (e.g. minimax/MiniMax-M3, zai/glm-5.2); otherwise returns the
294
- * raw `parentModel` unchanged so the caller surfaces E008.
295
- */
296
- export function resolveParentModelFromRegistry(modelRegistry: unknown, rawParentModel: unknown): string | undefined {
297
- const raw = typeof rawParentModel === "string" ? rawParentModel.trim() : undefined;
298
- if (raw) {
299
- const candidate = raw.includes("/")
300
- ? raw
301
- : (() => {
302
- const m = modelFromRegistry(modelRegistry, raw);
303
- if (m && typeof m === "object" && "fullId" in m) {
304
- return String((m as { fullId?: unknown }).fullId ?? raw);
305
- }
306
- return undefined;
307
- })();
308
- if (candidate && modelFromRegistry(modelRegistry, candidate)) return candidate;
309
- }
310
- const registry = modelRegistry as { getAvailable?: () => unknown[] } | undefined;
311
- if (registry && typeof registry.getAvailable === "function") {
312
- try {
313
- const available = registry.getAvailable();
314
- if (Array.isArray(available) && available.length > 0) {
315
- const first = available[0] as { provider?: unknown; id?: unknown } | undefined;
316
- if (first && typeof first.provider === "string" && typeof first.id === "string") {
317
- return `${first.provider}/${first.id}`;
318
- }
319
- }
320
- } catch {
321
- // ignore — fall through to raw
322
- }
323
- }
324
- return raw;
325
- }
326
-
327
- /** Communication intensity by role (caveman-inspired token optimization) */
328
- const ROLE_INTENSITY: Record<string, "lite" | "full" | "ultra"> = {
329
- explorer: "ultra",
330
- analyst: "full",
331
- planner: "full",
332
- critic: "full",
333
- executor: "full",
334
- reviewer: "full",
335
- "security-reviewer": "full",
336
- "test-engineer": "full",
337
- verifier: "full",
338
- writer: "lite",
339
- };
340
-
341
- function buildCommunicationStyle(role: string): string {
342
- const intensity = ROLE_INTENSITY[role] ?? "full";
343
- if (intensity === "lite") return "## Communication\nProfessional concise. No filler/hedging. Full sentences OK.";
344
- if (intensity === "ultra")
345
- return [
346
- "## Communication (ultra-compressed)",
347
- "Drop: articles, filler, hedging, pleasantries. Fragments OK.",
348
- "Pattern: [thing] [action] [reason].",
349
- "Code/paths/symbols: exact, never abbreviated. Errors quoted exact.",
350
- "Abbreviate prose words: DB/auth/config/req/res/fn/impl.",
351
- "Arrows for causality: X → Y. One word when one word enough.",
352
- "Security/destructive: write normal English. Resume compressed after.",
353
- ].join("\n");
354
- return [
355
- "## Communication (compressed)",
356
- "Drop: articles (a/an/the), filler (just/really/basically/actually/simply), hedging, pleasantries.",
357
- "Short synonyms. Fragments OK. Pattern: [thing] [action] [reason]. [next step].",
358
- "Code/paths/symbols: exact. Errors quoted exact.",
359
- "Security/destructive: write normal English. Resume compressed after.",
360
- ].join("\n");
361
- }
362
-
363
- function buildOutputContract(role: string): string {
364
- if (role === "explorer")
365
- return [
366
- "## Output Contract",
367
- "<path>:<line> — `<symbol>` — <≤6 word note>",
368
- "Group: Defs: / Refs: / Callers: / Tests: / Sites:",
369
- 'Zero hits → "No match."',
370
- "Last line → totals: N defs, M refs.",
371
- ].join("\n");
372
- if (role === "executor")
373
- return [
374
- "## Output Contract",
375
- "<path>:<line-range> — <change ≤10 words>.",
376
- "verified: <re-read OK | mismatch @ path:line>.",
377
- "Refusal tokens: too-big. / needs-confirm. / ambiguous. / regressed.",
378
- ].join("\n");
379
- if (role === "reviewer" || role === "security-reviewer")
380
- return [
381
- "## Output Contract",
382
- "<path>:<line>: <emoji> <severity>: <problem>. <fix>.",
383
- "Severity: 🔴 bug, 🟡 risk, 🔵 nit, ❓ question.",
384
- 'Zero findings → "No issues."',
385
- "Sorted: file order → ascending line numbers.",
386
- ].join("\n");
387
- if (role === "verifier")
388
- return [
389
- "## Output Contract",
390
- "PASS: <what verified> — <evidence ≤20 words>.",
391
- "FAIL: <what failed> — <reason>. <expected vs actual>.",
392
- "Evidence: file paths, test output, or diffs.",
393
- ].join("\n");
394
- if (role === "writer") return "## Output Contract\nWrite clear documentation. Full sentences. No compression.";
395
- return ""; // planner, critic, analyst, test-engineer: no strict format
396
- }
397
-
398
- /**
399
- * Phase 3 (caveman): Compress tool descriptions in a live session to reduce
400
- * input token cost per tool call. MCP tools often have verbose descriptions
401
- * (e.g. "This tool allows you to search for files in the filesystem..." → "Search files in filesystem.").
402
- * Compresses only description text, never modifies tool names or parameters.
403
- */
404
- function compressSessionToolDescriptions(session: LiveSessionLike): void {
405
- if (typeof session.getActiveToolNames !== "function") return;
406
- // The Pi SDK doesn't expose a setDescription API, but we can attempt
407
- // to compress via setActiveToolsByName if the session supports it.
408
- // For now, this is a no-op that documents the intent for future SDK support.
409
- // When Pi SDK adds tool description mutation, this function will compress.
410
- // Side benefit: the import of compressToolDescription ensures the module
411
- // is loaded and tree-shakeable, so adding the actual logic later is trivial.
412
- }
413
-
414
- export function liveSystemPrompt(input: LiveSessionSpawnInput): string {
415
- // Agent MEMORY is intentionally omitted here — it is already injected via
416
- // renderTaskPrompt().full (the user prompt, shared with the child-pi path).
417
- // See the import-block note above and the G3 fix.
418
- const role = input.task.role;
419
- const styleBlock = buildCommunicationStyle(role);
420
- const contractBlock = buildOutputContract(role);
421
- const sensitiveConstraint = buildSensitivePathConstraint();
422
- return [
423
- "# pi-crew Live Subagent",
424
- `Run ID: ${input.manifest.runId}`,
425
- `Task ID: ${input.task.id}`,
426
- `Role: ${role}`,
427
- `Agent: ${input.agent.name}`,
428
- `Working directory: ${input.task.cwd}`,
429
- "",
430
- styleBlock,
431
- contractBlock,
432
- sensitiveConstraint,
433
- "",
434
- input.agent.systemPrompt || "Follow the user task exactly and report verification evidence.",
435
- ]
436
- .filter(Boolean)
437
- .join("\n");
438
- }
439
-
440
- function filterActiveTools(session: LiveSessionLike, agent: AgentConfig, role?: string): void {
441
- if (typeof session.getActiveToolNames !== "function" || typeof session.setActiveToolsByName !== "function") return;
442
- const recursiveTools = new Set(["team", "Team", "Agent", "get_subagent_result", "steer_subagent"]);
443
- // F1 unify (v0.8.0): use the shared resolveToolPolicy so this path agrees
444
- // with child-pi (pi-args.ts). Before this, live-session used frontmatter
445
- // only and ignored role-config entirely — so a builtin explorer on the
446
- // live-session path wasn't bound by the role's read-only security constraint.
447
- // Now allowlist precedence is source-aware and the denylist is additive.
448
- const policy = resolveToolPolicy(agent, role);
449
- const disallowed = policy.excludeTools?.length ? new Set(policy.excludeTools) : undefined;
450
- const allowed = policy.tools?.length ? new Set(policy.tools) : undefined;
451
- const active = session
452
- .getActiveToolNames()
453
- .filter((name) => !recursiveTools.has(name) && !disallowed?.has(name) && (!allowed || allowed.has(name)));
454
- session.setActiveToolsByName(active);
455
- }
456
-
457
- function usageFromStats(stats: unknown): UsageState | undefined {
458
- const obj = asRecord(stats);
459
- if (!obj) return undefined;
460
- const input = numberField(obj, ["input", "inputTokens", "input_tokens"]);
461
- const output = numberField(obj, ["output", "outputTokens", "output_tokens"]);
462
- const cacheRead = numberField(obj, ["cacheRead", "cache_read"]);
463
- const cacheWrite = numberField(obj, ["cacheWrite", "cache_write"]);
464
- const cost = numberField(obj, ["cost"]);
465
- const turns = numberField(obj, ["turns", "turnCount", "turn_count"]);
466
- return [input, output, cacheRead, cacheWrite, cost, turns].some((value) => value !== undefined)
467
- ? { input, output, cacheRead, cacheWrite, cost, turns }
468
- : undefined;
469
- }
470
-
471
- async function promptWithTimeout(session: LiveSessionLike, text: string, timeoutMs: number, label: string): Promise<boolean> {
472
- const promptPromise = session.prompt?.(text, {
473
- source: "api",
474
- expandPromptTemplates: false,
475
- });
476
- if (!promptPromise) return false;
477
- let timer: ReturnType<typeof setTimeout> | undefined;
478
- try {
479
- await Promise.race([
480
- promptPromise,
481
- new Promise<void>((_, reject) => {
482
- timer = setTimeout(() => reject(new Error(`${label} timed out after ${timeoutMs}ms`)), timeoutMs);
483
- timer.unref?.();
484
- }),
485
- ]);
486
- return true;
487
- } finally {
488
- if (timer) clearTimeout(timer);
489
- }
490
- }
491
-
492
- export async function probeLiveSessionRuntime(): Promise<LiveSessionUnavailableResult | LiveSessionPlannedResult> {
493
- const availability = await isLiveSessionRuntimeAvailable();
494
- if (!availability.available)
495
- return {
496
- available: false,
497
- reason: availability.reason ?? "Live-session runtime is unavailable.",
498
- };
499
- return {
500
- available: true,
501
- reason: "Live-session SDK exports are available. pi-crew can run in-process live agents when runtime.mode=live-session.",
502
- };
503
- }
504
-
505
- export async function runLiveSessionTask(input: LiveSessionSpawnInput): Promise<LiveSessionRunResult> {
506
- // Cold-start race fix: ensure the hot module graph is warm before touching
507
- // any module. Under tsx, concurrent first-imports race module-record
508
- // instantiation; awaiting the registration-time warmup eliminates the window.
509
- await awaitRuntimeWarmup();
510
- const isCurrent = input.isCurrent ?? (() => true);
511
- let streamOut: StreamingOutputHandle | undefined;
512
-
513
- // G1: Capture yield result from custom tool callback
514
- let customToolYieldResult: YieldResult | undefined;
515
- let customToolYieldResolved = false;
516
- if (process.env.PI_CREW_MOCK_LIVE_SESSION === "success") {
517
- const agentId = `${input.manifest.runId}:${input.task.id}`;
518
- const inherited =
519
- input.runtimeConfig?.inheritContext === true && input.parentContext ? ` with inherited context: ${input.parentContext}` : "";
520
- const event = {
521
- type: "message_end",
522
- message: {
523
- role: "assistant",
524
- content: [
525
- {
526
- type: "text",
527
- text: `Mock live-session success for ${input.agent.name}${inherited}`,
528
- },
529
- ],
530
- },
531
- };
532
- const mockSession = {
533
- steer: async () => {},
534
- prompt: async () => {},
535
- abort: async () => {},
536
- };
537
- registerLiveAgent(
538
- {
539
- agentId,
540
- runId: input.manifest.runId,
541
- taskId: input.task.id,
542
- role: input.task.role,
543
- agent: input.agent?.name ?? "mock",
544
- description: "mock",
545
- session: mockSession,
546
- status: "running",
547
- workspaceId: input.workspaceId,
548
- },
549
- appendEvent,
550
- input.manifest.eventsPath,
551
- );
552
- appendTranscript(input.transcriptPath, event);
553
- const sidechainPath = sidechainOutputPath(input.manifest.stateRoot, input.task.id);
554
- writeSidechainEntry(sidechainPath, {
555
- agentId,
556
- type: "user",
557
- message: { role: "user", content: input.prompt },
558
- cwd: input.task.cwd,
559
- });
560
- writeSidechainEntry(sidechainPath, {
561
- agentId,
562
- type: "message",
563
- message: event,
564
- cwd: input.task.cwd,
565
- });
566
- if (isCurrent()) input.onEvent?.(event);
567
- const stdout = `Mock live-session success for ${input.agent.name}${inherited}`;
568
- if (isCurrent()) input.onOutput?.(stdout);
569
- updateLiveAgentStatus(agentId, "completed");
570
- markLiveAgentCompleted(agentId);
571
- return {
572
- available: true,
573
- exitCode: 0,
574
- stdout,
575
- stderr: "",
576
- jsonEvents: 1,
577
- };
578
- }
579
- const availability = await isLiveSessionRuntimeAvailable();
580
- if (!availability.available)
581
- return {
582
- available: true,
583
- exitCode: 1,
584
- stdout: "",
585
- stderr: availability.reason ?? "Live-session runtime unavailable.",
586
- jsonEvents: 0,
587
- error: availability.reason,
588
- };
589
- // LAZY: optional peer dependency — only loaded when live-session runtime is
590
- // chosen. Goes through the module-scoped latch (loadLiveSessionModule) so
591
- // concurrent first-imports share ONE in-flight promise instead of racing
592
- // module-record instantiation under the tsx loader.
593
- const mod = await loadLiveSessionModule();
594
- if (typeof mod.createAgentSession !== "function")
595
- return {
596
- available: true,
597
- exitCode: 1,
598
- stdout: "",
599
- stderr: "createAgentSession export is unavailable.",
600
- jsonEvents: 0,
601
- error: "createAgentSession export is unavailable.",
602
- };
603
- // OPT-03: compute yield-enabled flag early to conditionally allocate
604
- // collectedJsonEvents — avoids ~1KB array allocation per task when yield
605
- // detection is disabled. Pattern mirrors task-runner.ts:165. Uses the same
606
- // `enabled !== false` semantics as the late yield-detection block below so
607
- // the array is always allocated when (and only when) it will be read.
608
- const yieldConfig = input.runtimeConfig?.yield ?? { enabled: DEFAULT_YIELD_CONFIG.enabled };
609
- const yieldEnabled = yieldConfig.enabled !== false;
610
- let session: LiveSessionLike | undefined;
611
- let unsubscribe: (() => void) | undefined;
612
- let unsubscribeControlRealtime: (() => void) | undefined;
613
- let controlTimer: ReturnType<typeof setInterval> | undefined;
614
- let stdout = "";
615
- let jsonEvents = 0;
616
- const collectedJsonEvents: Record<string, unknown>[] | undefined = yieldEnabled ? [] : undefined;
617
- const maxCollectedJsonEvents = 1000;
618
- let yieldResult: YieldResult | undefined;
619
-
620
- const agentId = `${input.manifest.runId}:${input.task.id}`;
621
-
622
- // Round 27 (BUG 4): hoisted to function scope so the finally block can remove
623
- // it. const inside try{} is block-scoped and invisible to finally{}. The
624
- // handler resolves `session` lazily at call time (it may be assigned later
625
- // inside the try), so declaring it here is safe.
626
- let onSignalAbort: (() => void) | undefined;
627
-
628
- try {
629
- const agentDir = typeof mod.getAgentDir === "function" ? mod.getAgentDir() : undefined;
630
- let resourceLoader: unknown;
631
- // F1 (v0.7.9) NOTE: `agent.excludeExtensions` is applied on the
632
- // child-pi path (see `pi-args.ts`). The live-session path loads
633
- // extensions via pi's `DefaultResourceLoader`, which has no explicit
634
- // per-extension allow/deny API at the point we hand off. For
635
- // v0.7.9, the denylist is honored on the default async path only;
636
- // the live-session path (opt-in via `runtime.preferLiveSession`)
637
- // ignores it. This is a documented limitation, not a silent bug.
638
- if (mod.DefaultResourceLoader && agentDir) {
639
- resourceLoader = new mod.DefaultResourceLoader({
640
- cwd: input.task.cwd,
641
- agentDir,
642
- noPromptTemplates: true,
643
- noThemes: true,
644
- noContextFiles: input.runtimeConfig?.inheritContext !== true,
645
- systemPromptOverride: () => liveSystemPrompt(input),
646
- appendSystemPromptOverride: () => [],
647
- });
648
- await (resourceLoader as { reload?: () => Promise<void> }).reload?.();
649
- }
650
- const effectiveParentModel = resolveParentModelFromRegistry(input.modelRegistry, input.parentModel);
651
- const modelRouting = buildConfiguredModelRouting({
652
- overrideModel: input.modelOverride,
653
- stepModel: input.step.model,
654
- teamRoleModel: input.teamRoleModel,
655
- agentModel: input.agent.model,
656
- fallbackModels: input.agent.fallbackModels,
657
- parentModel: effectiveParentModel,
658
- modelRegistry: input.modelRegistry,
659
- cwd: input.manifest.cwd,
660
- scopeModelsPatterns: await resolveScopeModelsPatterns(input.manifest.cwd),
661
- });
662
- const resolvedModel =
663
- modelFromRegistry(input.modelRegistry, modelRouting.candidates[0] ?? modelRouting.requested) ?? input.parentModel;
664
- // Phase 4: MCP proxy — will be determined after session creation
665
- // (we check parent's MCP tools and share connections when available)
666
- const mcpProxy = buildMcpProxyFromSession([], { shareMcp: true });
667
-
668
- // G1: Build custom tools (submit_result + irc)
669
- const submitResultTool = createSubmitResultTool((result) => {
670
- customToolYieldResult = result;
671
- customToolYieldResolved = true;
672
- });
673
- const ircTool = createIrcTool(agentId);
674
- const customTools = [submitResultTool, ircTool];
675
-
676
- const sessionCreateStart = Date.now();
677
- const created = await mod.createAgentSession({
678
- cwd: input.task.cwd,
679
- ...(agentDir ? { agentDir } : {}),
680
- ...(resourceLoader ? { resourceLoader } : {}),
681
- ...(mod.SessionManager?.inMemory
682
- ? {
683
- sessionManager: mod.SessionManager.inMemory(input.task.cwd),
684
- }
685
- : {}),
686
- ...(mod.SettingsManager?.create && agentDir
687
- ? {
688
- settingsManager: mod.SettingsManager.create(input.task.cwd, agentDir),
689
- }
690
- : {}),
691
- ...(input.modelRegistry ? { modelRegistry: input.modelRegistry } : {}),
692
- ...(resolvedModel ? { model: resolvedModel } : {}),
693
- ...(input.agent.thinking ? { thinkingLevel: input.agent.thinking } : {}),
694
- ...(mcpProxy.enableMcp ? {} : { enableMCP: false }),
695
- customTools,
696
- });
697
- session = created.session;
698
- // P7 (perf): fire-and-forget — return value not needed, blocks the
699
- // event loop less than the sync appendEvent under file-lock contention.
700
- appendEventFireAndForget(input.manifest.eventsPath, {
701
- type: "live-session.session_created",
702
- runId: input.manifest.runId,
703
- taskId: input.task.id,
704
- data: {
705
- elapsedMs: Date.now() - sessionCreateStart,
706
- modelFallbackMessage: created.modelFallbackMessage,
707
- },
708
- });
709
- filterActiveTools(session, input.agent, input.task.role);
710
-
711
- // Diagnostic: log before bindExtensions so we can identify extension-loading hangs
712
- const bindExtensionsStart = Date.now();
713
- try {
714
- await Promise.race([
715
- session.bindExtensions?.({}) ?? Promise.resolve(),
716
- new Promise<void>((_, reject) => setTimeout(() => reject(new Error("bindExtensions timed out after 30s")), 30_000)),
717
- ]);
718
- } catch (bindError) {
719
- const msg = bindError instanceof Error ? bindError.message : String(bindError);
720
- // P7: fire-and-forget — return value not needed.
721
- appendEventFireAndForget(input.manifest.eventsPath, {
722
- type: "live-session.bind_extensions_error",
723
- runId: input.manifest.runId,
724
- taskId: input.task.id,
725
- data: {
726
- elapsedMs: Date.now() - bindExtensionsStart,
727
- error: msg,
728
- },
729
- });
730
- // Continue without extensions — they should not block the session
731
- }
732
-
733
- // Phase 3 (caveman): Compress tool descriptions to reduce input token cost
734
- compressSessionToolDescriptions(session);
735
-
736
- // Phase 5: Initialize extension runner bridge if available
737
- // The bridge provides extension-like APIs (sendMessage, setActiveTools, etc.)
738
- // to the extension runner if the session exposes one.
739
- const extensionBridge = buildExtensionBridge(session as never);
740
- if (extensionBridge) {
741
- const extRunner = (session as Record<string, unknown>).extensionRunner;
742
- if (extRunner && typeof (extRunner as Record<string, unknown>).initialize === "function") {
743
- try {
744
- (
745
- extRunner as {
746
- initialize: (apis: unknown, host: unknown) => void;
747
- }
748
- ).initialize(extensionBridge.apis, extensionBridge.host);
749
- if (typeof (extRunner as Record<string, unknown>).emit === "function") {
750
- await (
751
- extRunner as {
752
- emit: (event: unknown) => Promise<void>;
753
- }
754
- ).emit({ type: "session_start" });
755
- }
756
- } catch {
757
- // Extension runner initialization failure should not block the session
758
- }
759
- }
760
- }
761
-
762
- registerLiveAgent(
763
- {
764
- agentId,
765
- runId: input.manifest.runId,
766
- taskId: input.task.id,
767
- role: input.task.role,
768
- agent: input.agent?.name ?? "unknown",
769
- description: input.task.adaptive?.task ?? input.step?.task ?? "",
770
- modelName: (resolvedModel as { name?: string })?.name,
771
- session,
772
- status: "running",
773
- workspaceId: input.workspaceId,
774
- },
775
- appendEvent,
776
- input.manifest.eventsPath,
777
- );
778
- streamOut = createStreamingOutput(input.manifest, input.task.id);
779
- let controlCursor: LiveAgentControlCursor = { offset: 0 };
780
- const seenControlRequestIds = new Set<string>();
781
- let controlBusy = false;
782
- const pollControl = async () => {
783
- if (!isCurrent() || controlBusy || !session) return;
784
- controlBusy = true;
785
- try {
786
- controlCursor = await applyLiveAgentControlRequests({
787
- manifest: input.manifest,
788
- taskId: input.task.id,
789
- agentId,
790
- session,
791
- cursor: controlCursor,
792
- seenRequestIds: seenControlRequestIds,
793
- });
794
- } finally {
795
- controlBusy = false;
796
- }
797
- };
798
- unsubscribeControlRealtime = subscribeLiveControlRealtime((request) => {
799
- if (!isCurrent() || request.runId !== input.manifest.runId || request.taskId !== input.task.id || !session) return;
800
- void applyLiveAgentControlRequest({
801
- request,
802
- taskId: input.task.id,
803
- agentId,
804
- session,
805
- seenRequestIds: seenControlRequestIds,
806
- });
807
- });
808
- await pollControl();
809
- controlTimer = setInterval(() => {
810
- if (isCurrent()) void pollControl();
811
- }, 500);
812
- let turnCount = 0;
813
- let softLimitReached = false;
814
- const maxTurns = input.runtimeConfig?.maxTurns;
815
- const graceTurns = input.runtimeConfig?.graceTurns ?? 5;
816
- const sidechainPath = sidechainOutputPath(input.manifest.stateRoot, input.task.id);
817
- writeSidechainEntry(sidechainPath, {
818
- agentId,
819
- type: "user",
820
- message: { role: "user", content: input.prompt },
821
- cwd: input.task.cwd,
822
- });
823
- if (typeof session.subscribe === "function") {
824
- unsubscribe = session.subscribe((event) => {
825
- // Wrap callback body in try/catch to prevent unguarded exceptions from
826
- // propagating into the session internals and crashing the live session.
827
- try {
828
- if (!isCurrent()) return;
829
- jsonEvents += 1;
830
- appendTranscript(input.transcriptPath, event);
831
- const sidechainType = eventToSidechainType(event);
832
- if (sidechainType)
833
- writeSidechainEntry(sidechainPath, {
834
- agentId,
835
- type: sidechainType,
836
- message: event,
837
- cwd: input.task.cwd,
838
- });
839
- const obj = asRecord(event);
840
- if (obj?.type === "turn_end") {
841
- turnCount += 1;
842
- trackLiveAgentTurnEnd(agentId);
843
- if (maxTurns !== undefined && !softLimitReached && turnCount >= maxTurns) {
844
- softLimitReached = true;
845
- void session?.steer?.("You have reached your turn limit. Wrap up immediately — provide your final answer now.");
846
- } else if (maxTurns !== undefined && softLimitReached && turnCount >= maxTurns + graceTurns) {
847
- void session?.abort?.();
848
- }
849
- }
850
- // Accumulate lifetime usage that survives compaction
851
- if (obj?.type === "message_end" && extractMessageRole(obj) === "assistant") {
852
- const u = extractMessageUsage(obj);
853
- if (u) {
854
- trackTaskUsage(input.task.id, {
855
- input: typeof u.input === "number" ? u.input : 0,
856
- output: typeof u.output === "number" ? u.output : 0,
857
- cacheWrite: typeof u.cacheWrite === "number" ? u.cacheWrite : 0,
858
- });
859
- }
860
- }
861
- input.onEvent?.(event);
862
- const text = [...eventText(event), ...finalAssistantText(event)].join("\n");
863
- if (text.trim()) {
864
- stdout += `${text}\n`;
865
- streamOut?.write(text + "\n");
866
- trackLiveAgentResponseText(agentId, text);
867
- input.onOutput?.(text);
868
- }
869
- // G2: Track tool start/end for activity display
870
- if (obj?.type === "tool_use" || obj?.type === "tool_execution_start") {
871
- const toolName = extractToolName(obj) ?? "unknown";
872
- trackLiveAgentToolStart(agentId, toolName);
873
- }
874
- if (obj?.type === "tool_result" || obj?.type === "tool_execution_end") {
875
- const toolName = extractToolName(obj) ?? "unknown";
876
- trackLiveAgentToolEnd(agentId, toolName);
877
- }
878
- // Phase 1: collect events for yield detection
879
- if (collectedJsonEvents && event && typeof event === "object" && !Array.isArray(event)) {
880
- collectedJsonEvents.push(event as Record<string, unknown>);
881
- if (collectedJsonEvents.length > maxCollectedJsonEvents)
882
- collectedJsonEvents.splice(0, collectedJsonEvents.length - maxCollectedJsonEvents);
883
- }
884
- } catch (error) {
885
- // Prevent unguarded exceptions in the subscribe callback from crashing
886
- // the live session or propagating into the session internals.
887
- logInternalError("live-session.subscribe-callback", error, `agentId=${agentId}`);
888
- }
889
- });
890
- }
891
- // Round 27 (BUG 4): named abort handler (removed in finally below).
892
- onSignalAbort = (): void => {
893
- void session?.abort?.();
894
- };
895
- if (input.signal) {
896
- if (input.signal.aborted) await session.abort?.();
897
- // Round 27 (BUG 4): named handler so the finally block can remove it.
898
- // The previous anonymous listener leaked on normal completion (only
899
- // auto-removed by { once: true } AFTER the signal fires).
900
- else
901
- input.signal.addEventListener("abort", onSignalAbort, {
902
- once: true,
903
- });
904
- }
905
- const effectivePrompt =
906
- input.runtimeConfig?.inheritContext === true && input.parentContext
907
- ? `${input.parentContext}\n\n---\n# Live Subagent Task\n${input.prompt}`
908
- : input.prompt;
909
-
910
- // Diagnostic: log prompt size and timing
911
- const promptStart = Date.now();
912
- // P7: fire-and-forget — return value not needed.
913
- appendEventFireAndForget(input.manifest.eventsPath, {
914
- type: "live-session.prompt_start",
915
- runId: input.manifest.runId,
916
- taskId: input.task.id,
917
- data: {
918
- promptLength: effectivePrompt.length,
919
- agent: input.agent.name,
920
- role: input.task.role,
921
- },
922
- });
923
-
924
- // Phase 3: Wrap session.prompt with timeout for graceful cancellation
925
- const sessionTimeoutMs = DEFAULT_LIVE_SESSION.responseTimeoutMs;
926
- try {
927
- await promptWithTimeout(session, effectivePrompt, sessionTimeoutMs, "Live-session");
928
- } catch (promptError) {
929
- const msg = promptError instanceof Error ? promptError.message : String(promptError);
930
- // P7: fire-and-forget — return value not needed.
931
- appendEventFireAndForget(input.manifest.eventsPath, {
932
- type: "live-session.prompt_error",
933
- runId: input.manifest.runId,
934
- taskId: input.task.id,
935
- data: { elapsedMs: Date.now() - promptStart, error: msg },
936
- });
937
- if (msg.includes("timed out")) {
938
- await session.abort?.();
939
- updateLiveAgentStatus(agentId, "failed");
940
- return {
941
- available: true,
942
- exitCode: 1,
943
- stdout: stdout.trim(),
944
- stderr: msg,
945
- jsonEvents,
946
- error: msg,
947
- };
948
- }
949
- throw promptError;
950
- }
951
- // P7: fire-and-forget — return value not needed.
952
- appendEventFireAndForget(input.manifest.eventsPath, {
953
- type: "live-session.prompt_done",
954
- runId: input.manifest.runId,
955
- taskId: input.task.id,
956
- data: {
957
- elapsedMs: Date.now() - promptStart,
958
- jsonEvents,
959
- outputLength: stdout.length,
960
- },
961
- });
962
-
963
- // --- Phase 1: Yield enforcement loop ---
964
- // After the initial prompt completes, check if the worker called submit_result.
965
- // Priority: 1) custom tool callback (G1), 2) JSON event detection (legacy).
966
- if (yieldEnabled && session) {
967
- // Check custom tool callback first (G1)
968
- if (customToolYieldResolved && customToolYieldResult) {
969
- yieldResult = customToolYieldResult;
970
- } else if (collectedJsonEvents) {
971
- // Legacy: detect from JSON events (only when collection is enabled)
972
- const alreadyYielded = hasYieldInOutput(collectedJsonEvents);
973
- if (alreadyYielded) {
974
- const yieldEvent = collectedJsonEvents.find((e) => isYieldEvent(e));
975
- if (yieldEvent) yieldResult = extractYieldResult(yieldEvent);
976
- }
977
- }
978
- // Phase 2: Validate yield data against output schema if provided
979
- let schemaFailures = 0;
980
- const maxSchemaFailures = 2;
981
- if (yieldResult && input.outputSchema) {
982
- const validation = await validateYieldData(yieldResult.structuredData, input.outputSchema);
983
- if (!validation.valid) {
984
- schemaFailures++;
985
- yieldResult = undefined;
986
- customToolYieldResolved = false;
987
- const schemaReminder = `Your submit_result data did not match the required schema: ${validation.error}. Please fix and call submit_result again with valid data.`;
988
- try {
989
- await promptWithTimeout(
990
- session,
991
- schemaReminder,
992
- Math.min(sessionTimeoutMs, DEFAULT_LIVE_SESSION.idleWaitTimeoutMs),
993
- "Live-session schema reminder",
994
- );
995
- } catch {
996
- /* ignore */
997
- }
998
- await new Promise((resolve) => setTimeout(resolve, DEFAULT_LIVE_SESSION.yieldPollIntervalMs));
999
- // Check again after schema reminder
1000
- if (customToolYieldResolved && customToolYieldResult) {
1001
- yieldResult = customToolYieldResult;
1002
- } else if (collectedJsonEvents) {
1003
- const newEvents = collectedJsonEvents.slice(-10);
1004
- if (hasYieldInOutput(newEvents)) {
1005
- const yieldEvent = newEvents.find((e) => isYieldEvent(e));
1006
- if (yieldEvent) {
1007
- const candidate = extractYieldResult(yieldEvent);
1008
- if (candidate && input.outputSchema) {
1009
- const revalidation = await validateYieldData(candidate.structuredData, input.outputSchema);
1010
- if (revalidation.valid || schemaFailures >= maxSchemaFailures) {
1011
- yieldResult = candidate;
1012
- }
1013
- }
1014
- }
1015
- }
1016
- }
1017
- }
1018
- }
1019
- // Reminder loop — only if yield not yet received
1020
- const maxReminders = yieldConfig.maxReminders ?? DEFAULT_LIVE_SESSION.maxYieldRetries;
1021
- let retryCount = 0;
1022
- while (!customToolYieldResolved && !yieldResult && retryCount < maxReminders && !input.signal?.aborted) {
1023
- retryCount++;
1024
- const reminder = buildYieldReminder(retryCount, maxReminders, yieldConfig.reminderPrompt);
1025
- const prevTools = typeof session.getActiveToolNames === "function" ? session.getActiveToolNames() : [];
1026
- try {
1027
- // G6: Constrain tool set to submit_result before sending reminder
1028
- if (typeof session.setActiveToolsByName === "function" && prevTools.length > 0) {
1029
- session.setActiveToolsByName(["submit_result"]);
1030
- }
1031
- await promptWithTimeout(
1032
- session,
1033
- reminder,
1034
- Math.min(sessionTimeoutMs, DEFAULT_LIVE_SESSION.idleWaitTimeoutMs),
1035
- "Live-session yield reminder",
1036
- );
1037
- } catch {
1038
- break;
1039
- } finally {
1040
- // Restore previous tools even if reminder prompt times out/throws.
1041
- if (typeof session.setActiveToolsByName === "function" && prevTools.length > 0) {
1042
- session.setActiveToolsByName(prevTools);
1043
- }
1044
- }
1045
- const pollInterval = DEFAULT_LIVE_SESSION.yieldPollIntervalMs;
1046
- await new Promise((resolve) => setTimeout(resolve, pollInterval));
1047
- // Check custom tool callback
1048
- if (customToolYieldResolved && customToolYieldResult) {
1049
- yieldResult = customToolYieldResult;
1050
- break;
1051
- }
1052
- // Legacy: check JSON events
1053
- if (collectedJsonEvents && hasYieldInOutput(collectedJsonEvents.slice(-10))) {
1054
- const yieldEvent = collectedJsonEvents.slice(-10).find((e) => isYieldEvent(e));
1055
- if (yieldEvent) yieldResult = extractYieldResult(yieldEvent);
1056
- break;
1057
- }
1058
- }
1059
- if (!customToolYieldResolved && !yieldResult && !input.signal?.aborted && retryCount >= maxReminders) {
1060
- input.onEvent?.({
1061
- type: "task.attention",
1062
- runId: input.manifest.runId,
1063
- taskId: input.task.id,
1064
- message: "Live-session worker completed without calling submit_result tool.",
1065
- data: {
1066
- activityState: "needs_attention",
1067
- reason: "no_yield",
1068
- attempts: retryCount,
1069
- },
1070
- });
1071
- }
1072
- }
1073
-
1074
- const usage = usageFromStats(typeof session.getStats === "function" ? session.getStats() : session.stats);
1075
- updateLiveAgentStatus(agentId, "completed");
1076
- markLiveAgentCompleted(agentId);
1077
- return {
1078
- available: true,
1079
- exitCode: 0,
1080
- stdout: stdout.trim(),
1081
- stderr: created.modelFallbackMessage ?? "",
1082
- jsonEvents,
1083
- usage,
1084
- yieldResult,
1085
- };
1086
- } catch (error) {
1087
- const message = error instanceof Error ? error.message : String(error);
1088
-
1089
- // Phase 8: Log diagnostics on failure
1090
- try {
1091
- const agents = listLiveAgents();
1092
- const health = collectLiveSessionHealth(agents, () => undefined);
1093
- const diagnostics = formatLiveSessionDiagnostics(health);
1094
- input.onEvent?.({
1095
- type: "live-session.diagnostics",
1096
- data: diagnostics,
1097
- });
1098
- } catch (diagError) {
1099
- logInternalError("live-session.diagnostics", diagError);
1100
- }
1101
-
1102
- updateLiveAgentStatus(`${input.manifest.runId}:${input.task.id}`, "failed");
1103
- return {
1104
- available: true,
1105
- exitCode: 1,
1106
- stdout: stdout.trim(),
1107
- stderr: message,
1108
- jsonEvents,
1109
- error: message,
1110
- };
1111
- } finally {
1112
- // H6: Unsubscribe listeners FIRST before clearing timer to prevent race
1113
- unsubscribe?.();
1114
- unsubscribeControlRealtime?.();
1115
- // Round 27 (BUG 4): remove the named abort listener to avoid leaking it
1116
- // on the shared AbortSignal across many live-session tasks.
1117
- if (onSignalAbort) input.signal?.removeEventListener("abort", onSignalAbort);
1118
- if (controlTimer) clearInterval(controlTimer);
1119
- streamOut?.close();
1120
- if (input.signal?.aborted) {
1121
- await terminateLiveAgent(agentId, "cancelled", appendEvent, input.manifest.eventsPath);
1122
- } else {
1123
- // Dispose the session to free resources, but keep the handle in the registry
1124
- // for resume/follow-up. Removing the handle entirely breaks steer/followUp/resume.
1125
- disposeLiveAgentSession(agentId);
1126
- }
1127
-
1128
- // Phase 8: Emit final health snapshot
1129
- try {
1130
- const agents = listLiveAgents();
1131
- if (agents.length > 0) {
1132
- const health = collectLiveSessionHealth(agents, () => undefined);
1133
- input.onEvent?.({ type: "live-session.health", data: health });
1134
- }
1135
- } catch (healthError) {
1136
- logInternalError("live-session.health-snapshot", healthError);
1137
- }
1138
- }
1139
- }