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,673 +0,0 @@
1
- /**
2
- * crew-broker-client.ts — Child-side connector for the local broker.
3
- * PHASE 0 skeleton (sub-task 0.3).
4
- *
5
- * - Connects only on the first request/subscribe.
6
- * - Sends `hello` first; any other method before ack is a protocol error.
7
- * - Bounded backoff (50/100/200/400/800 ms + jitter, max 4 attempts).
8
- * After exhaustion, no hot reconnect loop is scheduled. The only way back
9
- * to the live path is an explicit `reconnect()` (or a new worker lifecycle).
10
- * - On ANY connect/auth/timeout/close error, transitions to `fallback` mode
11
- * and never lets an exception escape `request()` / `subscribe()`. The
12
- * caller can read `client.mode` or the `{ok:false, fallback:true}` result
13
- * and continue using today's file-based paths.
14
- * - `close()` removes all listeners and pending requests.
15
- * - All diagnostic strings pass through `redactSecretString` from
16
- * `src/utils/redaction.ts`. Token and payload bytes are never logged.
17
- *
18
- * No process management. No children. No socket listening. Connect-only.
19
- *
20
- * See `reports/inter-pi-broker-impl-plan-2026-07-21.md` §"0.3" for the
21
- * full contract and acceptance criteria.
22
- */
23
-
24
- import { randomUUID } from "node:crypto";
25
- import * as net from "node:net";
26
-
27
- import { logInternalError } from "../utils/internal-error.ts";
28
- import { BrokerError, encodeBrokerFrame, NdjsonDecoder } from "../utils/ndjson.ts";
29
- import { redactSecretString } from "../utils/redaction.ts";
30
-
31
- /** Shape of an unsolicited event frame pushed by the broker (mailbox.message,
32
- * team.event, etc.). */
33
- export interface BrokerEventFrame {
34
- event: string;
35
- data: unknown;
36
- seq?: number;
37
- }
38
-
39
- /** Protocol version negotiated at hello. Must match the broker. */
40
- const BROKER_PROTOCOL = 1;
41
-
42
- /** Per-attempt timeout for connect + hello. */
43
- const CONNECT_HELLO_TIMEOUT_MS = 5_000;
44
-
45
- /** Bounded backoff schedule (ms). At most 4 attempts means 3 retries after
46
- * the first failure. Jitter is ±25%. */
47
- const BACKOFF_SCHEDULE_MS: readonly number[] = [50, 100, 200, 400, 800] as const;
48
- /** Hard cap on the number of attempts. 4 total = 1 initial + 3 retries. */
49
- const MAX_ATTEMPTS = 4;
50
-
51
- export type BrokerClientMode = "unstarted" | "connected" | "fallback";
52
-
53
- export type BrokerClientResult<T> = { ok: true; value: T } | { ok: false; fallback: true; errorCode?: string; error?: Error };
54
-
55
- export interface CrewBrokerClientOptions {
56
- runId: string;
57
- taskId: string;
58
- /** Pre-resolved socket path. If absent, the client is permanently
59
- * fallback (caller forgot to wire spawn context). */
60
- socketPath?: string;
61
- /** Per-run token. If absent, the client is permanently fallback. */
62
- token?: string;
63
- /** Override `process.env` (used by tests). */
64
- env?: NodeJS.ProcessEnv;
65
- /** Test seam: override the `net` module. */
66
- netModule?: typeof net;
67
- /** Test seam: clock for backoff scheduling. */
68
- now?: () => number;
69
- /** Test seam: timer factory. */
70
- setTimeoutFn?: (cb: () => void, ms: number) => NodeJS.Timeout;
71
- /** Test seam: clear timer. */
72
- clearTimeoutFn?: (timer: NodeJS.Timeout) => void;
73
- /** Test seam: random jitter source (returns a multiplier in [0.75, 1.25]). */
74
- jitter?: () => number;
75
- /** Handler for unsolicited event frames pushed by the broker after hello
76
- * (e.g. `mailbox.message`, `team.event`). When omitted, event frames are
77
- * silently ignored (Phase 0 behavior). Never throws into the socket loop. */
78
- onEvent?: (event: BrokerEventFrame) => void;
79
- }
80
-
81
- interface PendingRequest {
82
- id: string;
83
- method: string;
84
- resolve: (value: unknown) => void;
85
- reject: (err: Error) => void;
86
- }
87
-
88
- export class CrewBrokerClient {
89
- private readonly options: Required<Pick<CrewBrokerClientOptions, "runId" | "taskId">> &
90
- Pick<
91
- CrewBrokerClientOptions,
92
- "socketPath" | "token" | "env" | "netModule" | "now" | "setTimeoutFn" | "clearTimeoutFn" | "jitter" | "onEvent"
93
- >;
94
- private _mode: BrokerClientMode = "unstarted";
95
- private socket: net.Socket | null = null;
96
- private decoder: NdjsonDecoder | null = null;
97
- private readonly pending = new Map<string, PendingRequest>();
98
- private attempts = 0;
99
- /** Listeners attached to the current socket; kept for explicit close(). */
100
- private readonly socketListeners: Array<{
101
- event: string;
102
- listener: (...args: unknown[]) => void;
103
- }> = [];
104
- /** Set in close(); gates reconnect attempts and backoff loops. */
105
- private closed = false;
106
- /** Handle to the in-flight backoff timer so close() can cancel it. */
107
- private backoffTimer: NodeJS.Timeout | null = null;
108
- /** Resolver for the in-flight backoff await so close() can unblock it.
109
- * Without this, cancelling the timer leaves the connectAndHello await
110
- * hanging forever (resolve() never fires). */
111
- private backoffResolver: (() => void) | null = null;
112
-
113
- constructor(options: CrewBrokerClientOptions) {
114
- if (!options || typeof options !== "object") {
115
- throw new Error("CrewBrokerClient: options is required");
116
- }
117
- if (typeof options.runId !== "string" || options.runId.length === 0) {
118
- throw new Error("CrewBrokerClient: runId must be a non-empty string");
119
- }
120
- if (typeof options.taskId !== "string" || options.taskId.length === 0) {
121
- throw new Error("CrewBrokerClient: taskId must be a non-empty string");
122
- }
123
- this.options = {
124
- runId: options.runId,
125
- taskId: options.taskId,
126
- socketPath: options.socketPath,
127
- token: options.token,
128
- env: options.env,
129
- netModule: options.netModule,
130
- now: options.now,
131
- setTimeoutFn: options.setTimeoutFn,
132
- clearTimeoutFn: options.clearTimeoutFn,
133
- jitter: options.jitter,
134
- onEvent: options.onEvent,
135
- };
136
- }
137
-
138
- get mode(): BrokerClientMode {
139
- return this._mode;
140
- }
141
-
142
- /** Diagnostic: number of currently-pending requests. */
143
- get pendingCount(): number {
144
- return this.pending.size;
145
- }
146
-
147
- /**
148
- * Send a request. Returns:
149
- * - `{ok:true, value}` on success.
150
- * - `{ok:false, fallback:true, errorCode?}` on any connect/auth/
151
- * timeout/close/protocol error. The client transitions to fallback
152
- * for its lifetime; only `reconnect()` may move it back to "unstarted".
153
- *
154
- * Never throws. The caller can continue using file-based fallback paths
155
- * without unwrapping anything.
156
- */
157
- async request<T = unknown>(method: string, params: unknown): Promise<BrokerClientResult<T>> {
158
- if (this._mode === "fallback") {
159
- return { ok: false, fallback: true, errorCode: "fallback-sticky" };
160
- }
161
- if (typeof method !== "string" || method.length === 0) {
162
- return { ok: false, fallback: true, errorCode: "bad-method" };
163
- }
164
-
165
- // Lazy connect + hello on first use.
166
- if (this._mode === "unstarted" || !this.socket) {
167
- const connectResult = await this.connectAndHello();
168
- if (!connectResult.ok) {
169
- return connectResult;
170
- }
171
- }
172
-
173
- if (!this.socket) {
174
- return { ok: false, fallback: true, errorCode: "no-socket" };
175
- }
176
-
177
- // Send the request. Send a frame FIRST so the server's hello gate
178
- // cannot reject it as "method other than hello".
179
- const id = `r-${randomUUID()}`;
180
- const promise = new Promise<unknown>((resolve, reject) => {
181
- this.pending.set(id, { id, method, resolve, reject });
182
- });
183
- try {
184
- const frame = encodeBrokerFrame({ id, method, params });
185
- // Write may emit EPIPE etc. We don't await drain here — the response
186
- // promise handles the rest.
187
- this.socket.write(frame);
188
- } catch (err) {
189
- // encodeBrokerFrame can throw on oversize. The socket is still
190
- // alive but the request is bad.
191
- this.pending.delete(id);
192
- return { ok: false, fallback: true, errorCode: "encode-failed" };
193
- }
194
-
195
- try {
196
- const value = await promise;
197
- // Detect the tagged broker-error envelope: per-request errors
198
- // (bad-params, no-manifest, wait-timeout, etc.) resolve with
199
- // `{__brokerError:true, code, message}` and do NOT enter fallback.
200
- if (value && typeof value === "object" && (value as { __brokerError?: boolean }).__brokerError === true) {
201
- const e = value as { code: string; message: string };
202
- return { ok: false, fallback: true, errorCode: e.code };
203
- }
204
- return { ok: true, value: value as T };
205
- } catch (err) {
206
- // Reject from pending handlers → the typed error code.
207
- const code = err instanceof BrokerError ? err.code : "request-failed";
208
- this.enterFallbackOnce(code, err);
209
- return { ok: false, fallback: true, errorCode: code };
210
- }
211
- }
212
-
213
- /**
214
- * Subscribe to a per-run event stream. Phase 0 does not implement
215
- * events.since — the subscription returns a no-op unsubscribe and
216
- * transitions to fallback if the connection is lost. The caller can
217
- * continue using the file poll path.
218
- */
219
- subscribe(options: { runId: string; sinceSeq: number; onEvent: (event: unknown) => void }): () => void {
220
- // Phase 0: subscription is a typed not-implemented. We register a
221
- // no-op unsubscribe so the caller can call it without errors.
222
- void options;
223
- return () => {
224
- /* no-op */
225
- };
226
- }
227
-
228
- /**
229
- * Explicit reconnect. Resets `mode` to `unstarted` and clears the
230
- * backoff counter. Returns true if a fresh connection succeeded,
231
- * false otherwise (mode becomes `fallback` on failure). Use this
232
- * after a known broker restart.
233
- */
234
- async reconnect(): Promise<boolean> {
235
- // Close the current socket if any.
236
- this.teardownSocket();
237
- this.attempts = 0;
238
- this._mode = "unstarted";
239
- const res = await this.request("ping", null);
240
- return res.ok;
241
- }
242
-
243
- /**
244
- * Close the client. Removes all socket listeners, rejects all pending
245
- * requests with a clean fallback result, and transitions to fallback
246
- * (so a subsequent request() returns a typed error rather than
247
- * reconnecting in the background).
248
- */
249
- async close(): Promise<void> {
250
- // Set the closed flag FIRST so any backoff-loop iteration that
251
- // resumes after teardownSocket (e.g. after a queued backoff timer
252
- // fires) sees it and returns immediately with a typed error.
253
- this.closed = true;
254
- // Cancel any queued backoff timer. Without this, the in-flight
255
- // connectAndHello would resume its retry loop after close() and
256
- // create new sockets against a torn-down client.
257
- if (this.backoffTimer !== null) {
258
- try {
259
- (this.options.clearTimeoutFn ?? ((t: NodeJS.Timeout) => clearTimeout(t)))(this.backoffTimer);
260
- } catch {
261
- /* ignore — best-effort cancel */
262
- }
263
- this.backoffTimer = null;
264
- }
265
- // Unblock the in-flight backoff await. Cancelling the timer alone
266
- // leaves the connectAndHello Promise stuck on resolve(); this lets
267
- // the loop unblock, observe this.closed, and return typed 'closed'.
268
- if (this.backoffResolver !== null) {
269
- const resolveBackoff = this.backoffResolver;
270
- this.backoffResolver = null;
271
- try {
272
- resolveBackoff();
273
- } catch {
274
- /* ignore — best-effort unblock */
275
- }
276
- }
277
- this.teardownSocket();
278
- // Reject every pending request. Using reject (not resolve) so the
279
- // request() catch block kicks in and returns {ok:false, fallback:true}.
280
- // Resolving with undefined would have made request() return
281
- // {ok:true, value:undefined}, which is misleading.
282
- for (const [, p] of this.pending) {
283
- p.reject(new BrokerError("close", "client closed"));
284
- }
285
- this.pending.clear();
286
- this._mode = "fallback";
287
- }
288
-
289
- // ------------------------------------------------------------------------
290
- // Connect + hello with bounded backoff
291
- // ------------------------------------------------------------------------
292
-
293
- private async connectAndHello(): Promise<BrokerClientResult<true>> {
294
- if (!this.options.socketPath || !this.options.token) {
295
- this.enterFallbackOnce("missing-credentials", new Error("socket or token not provided"));
296
- return { ok: false, fallback: true, errorCode: "missing-credentials" };
297
- }
298
-
299
- const netModule = this.options.netModule ?? net;
300
- const setTimeoutFn = this.options.setTimeoutFn ?? ((cb: () => void, ms: number) => setTimeout(cb, ms));
301
- const clearTimeoutFn = this.options.clearTimeoutFn ?? ((t: NodeJS.Timeout) => clearTimeout(t));
302
- const jitter = this.options.jitter ?? (() => 0.75 + Math.random() * 0.5); // [0.75, 1.25]
303
-
304
- for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
305
- // Closed gate at the top of each iteration: catches the case
306
- // where close() was called while we were awaiting attemptHello()
307
- // or while a previous backoff timer was firing. After close(),
308
- // the client must not open any new sockets.
309
- if (this.closed) {
310
- return { ok: false, fallback: true, errorCode: "closed" };
311
- }
312
- this.attempts = attempt + 1;
313
- const result = await this.attemptHello(netModule);
314
- if (result.ok) {
315
- // Belt-and-suspenders: a successful hello can still race
316
- // with close() (e.g. close() called between the hello ack
317
- // being processed and this return). If we are now closed,
318
- // tear down the socket we just opened and return the typed
319
- // error rather than handing back a connected client.
320
- if (this.closed) {
321
- this.teardownSocket();
322
- this._mode = "fallback";
323
- return { ok: false, fallback: true, errorCode: "closed" };
324
- }
325
- this._mode = "connected";
326
- return result;
327
- }
328
- // Failure. If we are out of attempts, give up.
329
- if (attempt + 1 >= MAX_ATTEMPTS) {
330
- this.enterFallbackOnce(result.errorCode ?? "connect-failed", result.error);
331
- return { ok: false, fallback: true, errorCode: result.errorCode ?? "connect-failed" };
332
- }
333
- // Wait the next backoff slot (with jitter), unless this was a
334
- // auth failure (no point retrying — server rejected hello).
335
- if (result.errorCode === "auth") {
336
- this.enterFallbackOnce("auth", result.error);
337
- return { ok: false, fallback: true, errorCode: "auth" };
338
- }
339
- const base = BACKOFF_SCHEDULE_MS[attempt] ?? 800;
340
- const delay = Math.max(1, Math.floor(base * jitter()));
341
- await new Promise<void>((resolve) => {
342
- // Capture the resolver so close() can unblock the await
343
- // even after cancelling the timer (timer cancellation alone
344
- // leaves resolve() unfired). We also clear the resolver
345
- // when the timer fires so a stale handle never leaks.
346
- this.backoffResolver = resolve;
347
- const t = setTimeoutFn(() => {
348
- if (this.backoffResolver === resolve) this.backoffResolver = null;
349
- this.backoffTimer = null;
350
- resolve();
351
- }, delay);
352
- this.backoffTimer = t;
353
- if (t && typeof (t as { unref?: () => void }).unref === "function") {
354
- (t as { unref?: () => void }).unref?.();
355
- }
356
- });
357
- // Unused but kept for symmetry with the future test seam.
358
- void clearTimeoutFn;
359
- }
360
-
361
- // Defensive: the loop always returns.
362
- this.enterFallbackOnce("exhausted", new Error("backoff exhausted"));
363
- return { ok: false, fallback: true, errorCode: "exhausted" };
364
- }
365
-
366
- private attemptHello(netModule: typeof net): Promise<BrokerClientResult<true>> {
367
- return new Promise<BrokerClientResult<true>>((resolve) => {
368
- // Belt-and-suspenders closed gate: the backoff loop in
369
- // connectAndHello already checks this.closed, but attemptHello
370
- // can also be entered via reconnect() after the flag is set.
371
- if (this.closed) {
372
- resolve({ ok: false, fallback: true, errorCode: "closed" });
373
- return;
374
- }
375
- const sock = netModule.createConnection(this.options.socketPath!);
376
- let settled = false;
377
- const finish = (v: BrokerClientResult<true>) => {
378
- if (settled) return;
379
- settled = true;
380
- // Cancel the per-attempt deadline timer so it cannot fire after
381
- // a successful handshake and destroy the healthy connection.
382
- try {
383
- clearTimeoutFn(timer);
384
- } catch {
385
- /* ignore */
386
- }
387
- try {
388
- sock.removeAllListeners();
389
- } catch {
390
- /* ignore */
391
- }
392
- resolve(v);
393
- };
394
- this.socket = sock;
395
- this.decoder = new NdjsonDecoder();
396
-
397
- // Per-attempt deadline.
398
- const setTimeoutFn = this.options.setTimeoutFn ?? ((cb: () => void, ms: number) => setTimeout(cb, ms));
399
- const clearTimeoutFn = this.options.clearTimeoutFn ?? ((t: NodeJS.Timeout) => clearTimeout(t));
400
- const timer = setTimeoutFn(() => {
401
- finish({ ok: false, fallback: true, errorCode: "timeout" });
402
- try {
403
- sock.destroy();
404
- } catch {
405
- /* ignore */
406
- }
407
- }, CONNECT_HELLO_TIMEOUT_MS);
408
- if (timer && typeof (timer as { unref?: () => void }).unref === "function") {
409
- (timer as { unref?: () => void }).unref?.();
410
- }
411
-
412
- const onConnect = () => {
413
- // Send hello immediately on connect.
414
- const hello = {
415
- id: `hello-${randomUUID()}`,
416
- method: "hello",
417
- params: {
418
- protocol: BROKER_PROTOCOL,
419
- runId: this.options.runId,
420
- taskId: this.options.taskId,
421
- token: this.options.token,
422
- },
423
- };
424
- try {
425
- sock.write(encodeBrokerFrame(hello));
426
- } catch (err) {
427
- finish({ ok: false, fallback: true, errorCode: "encode-failed" });
428
- try {
429
- sock.destroy();
430
- } catch {
431
- /* ignore */
432
- }
433
- return;
434
- }
435
- };
436
- const onData = (chunk: Buffer | string) => {
437
- if (!this.decoder) return;
438
- const buf = typeof chunk === "string" ? Buffer.from(chunk, "utf8") : chunk;
439
- let frames: unknown[];
440
- try {
441
- frames = this.decoder.push(buf);
442
- } catch (err) {
443
- const code = err instanceof BrokerError ? err.code : "protocol";
444
- finish({ ok: false, fallback: true, errorCode: code });
445
- try {
446
- sock.destroy();
447
- } catch {
448
- /* ignore */
449
- }
450
- return;
451
- }
452
- for (const frame of frames) {
453
- if (!isResponseObject(frame)) {
454
- finish({ ok: false, fallback: true, errorCode: "protocol" });
455
- try {
456
- sock.destroy();
457
- } catch {
458
- /* ignore */
459
- }
460
- return;
461
- }
462
- // Hello ack: must include `result.ok === true` and matching id.
463
- if (frame.id && frame.id.startsWith("hello-")) {
464
- if (frame.error) {
465
- const code = (frame.error as { code?: string }).code ?? "auth";
466
- finish({ ok: false, fallback: true, errorCode: code });
467
- try {
468
- sock.destroy();
469
- } catch {
470
- /* ignore */
471
- }
472
- return;
473
- }
474
- // Hello succeeded — wire up the response handler.
475
- finish({ ok: true, value: true });
476
- this.wireSocketHandlers(sock);
477
- return;
478
- }
479
- // Otherwise it's a response to a request we sent.
480
- const pending = this.pending.get(frame.id);
481
- if (pending) {
482
- this.pending.delete(frame.id);
483
- if (frame.error) {
484
- const code = (frame.error as { code?: string }).code ?? "request-failed";
485
- pending.reject(new BrokerError(code as never, "request error"));
486
- } else {
487
- pending.resolve(frame.result);
488
- }
489
- }
490
- }
491
- };
492
- const onError = (err: Error & { code?: string }) => {
493
- // ECONNREFUSED, EMFILE, ENOSPC, EPERM, ENOENT, EPIPE, etc.
494
- const code = err.code ?? "connect-failed";
495
- finish({ ok: false, fallback: true, errorCode: code });
496
- };
497
- const onClose = () => {
498
- finish({ ok: false, fallback: true, errorCode: "close" });
499
- };
500
- sock.once("connect", onConnect);
501
- sock.on("data", onData);
502
- sock.once("error", onError);
503
- sock.once("close", onClose);
504
- // Keep timer for explicit cleanup.
505
- this.socketListeners.push(
506
- { event: "connect", listener: onConnect as (...args: unknown[]) => void },
507
- { event: "data", listener: onData as (...args: unknown[]) => void },
508
- { event: "error", listener: onError as (...args: unknown[]) => void },
509
- { event: "close", listener: onClose as (...args: unknown[]) => void },
510
- );
511
- void clearTimeoutFn;
512
- });
513
- }
514
-
515
- private wireSocketHandlers(sock: net.Socket): void {
516
- // After hello, attach persistent handlers. The once-handlers from
517
- // attemptHello are already removed in finish().
518
- // Unref the socket so a still-open broker connection never keeps a
519
- // finished child worker's event loop alive (mirrors the file-poll
520
- // steering timer's unref). Pushes still arrive while the worker runs.
521
- (sock as { unref?: () => void }).unref?.();
522
- const onData = (chunk: Buffer | string) => {
523
- if (!this.decoder) return;
524
- const buf = typeof chunk === "string" ? Buffer.from(chunk, "utf8") : chunk;
525
- let frames: unknown[];
526
- try {
527
- frames = this.decoder.push(buf);
528
- } catch (err) {
529
- // Malformed frame — fall back.
530
- this.enterFallbackOnce("protocol", err);
531
- try {
532
- sock.destroy();
533
- } catch {
534
- /* ignore */
535
- }
536
- return;
537
- }
538
- for (const frame of frames) {
539
- // Distinguish unsolicited event frames (e.g. mailbox.message
540
- // pushed by the broker's observer-driven live fanout) from
541
- // request-response frames. Events have `event` + `data` (+ optional
542
- // `seq`); responses have `id` + `result` or `error`. Event frames
543
- // are routed to the optional `onEvent` handler; a missing handler
544
- // silently drops them (the durable path remains authoritative).
545
- if (isEventFrame(frame)) {
546
- const handler = this.options.onEvent;
547
- if (handler) {
548
- const ev = frame as Record<string, unknown>;
549
- try {
550
- handler({ event: ev.event as string, data: ev.data, seq: typeof ev.seq === "number" ? ev.seq : undefined });
551
- } catch {
552
- /* an onEvent handler fault must never break the socket loop */
553
- }
554
- }
555
- continue;
556
- }
557
- if (!isResponseObject(frame)) {
558
- this.enterFallbackOnce("protocol", new Error("malformed response"));
559
- return;
560
- }
561
- const pending = this.pending.get(frame.id);
562
- if (!pending) continue;
563
- this.pending.delete(frame.id);
564
- if (frame.error) {
565
- // Per-request error response from the broker: NOT a protocol
566
- // error, NOT a fallback condition. The broker explicitly rejected
567
- // this call (e.g. bad-params, no-manifest, wait-timeout).
568
- // Resolve with a tagged envelope so request() can return
569
- // ok:false WITHOUT triggering fallback mode.
570
- const errCode = (frame.error as { code?: string }).code ?? "request-failed";
571
- pending.resolve({
572
- __brokerError: true,
573
- code: errCode,
574
- message: (frame.error as { message?: string }).message ?? "",
575
- } as never);
576
- } else {
577
- pending.resolve(frame.result);
578
- }
579
- }
580
- };
581
- const onError = (err: Error & { code?: string }) => {
582
- this.enterFallbackOnce(err.code ?? "socket-error", err);
583
- };
584
- const onClose = () => {
585
- // Reject every pending with a close error so request() returns
586
- // {ok:false, fallback:true}. (Resolving with undefined previously
587
- // returned {ok:true, value:undefined}, which is misleading.)
588
- for (const [, p] of this.pending) {
589
- p.reject(new BrokerError("close", "socket closed"));
590
- }
591
- this.pending.clear();
592
- this.enterFallbackOnce("close", new Error("socket closed"));
593
- };
594
- sock.on("data", onData);
595
- sock.once("error", onError);
596
- sock.once("close", onClose);
597
- this.socketListeners.push(
598
- { event: "data", listener: onData as (...args: unknown[]) => void },
599
- { event: "error", listener: onError as (...args: unknown[]) => void },
600
- { event: "close", listener: onClose as (...args: unknown[]) => void },
601
- );
602
- }
603
-
604
- private teardownSocket(): void {
605
- if (!this.socket) {
606
- this.socket = null;
607
- this.decoder = null;
608
- this.socketListeners.length = 0;
609
- return;
610
- }
611
- const sock = this.socket;
612
- for (const l of this.socketListeners) {
613
- try {
614
- sock.removeListener(l.event, l.listener);
615
- } catch {
616
- /* ignore */
617
- }
618
- }
619
- this.socketListeners.length = 0;
620
- try {
621
- sock.destroy();
622
- } catch {
623
- /* ignore */
624
- }
625
- this.socket = null;
626
- this.decoder = null;
627
- }
628
-
629
- private enterFallbackOnce(code: string, cause?: unknown): void {
630
- if (this._mode === "fallback") return;
631
- this._mode = "fallback";
632
- // Log exactly ONE diagnostic per transition. We redact any cause string
633
- // so token-like bytes cannot leak via the error message.
634
- const safeCause = cause instanceof Error ? cause.message : cause ? String(cause) : undefined;
635
- const safe = safeCause ? redactSecretString(safeCause) : undefined;
636
- logInternalError(
637
- "crew-broker.client.fallback",
638
- new Error(`fallback (${code})`),
639
- `runId=${this.options.runId}${safe ? ` cause=${safe}` : ""}`,
640
- );
641
- }
642
- }
643
-
644
- // ============================================================================
645
- // Type guards (no `any`)
646
- // ============================================================================
647
-
648
- function isResponseObject(value: unknown): value is { id: string; result?: unknown; error?: { code?: string; message?: string } } {
649
- if (!value || typeof value !== "object" || Array.isArray(value)) return false;
650
- const v = value as Record<string, unknown>;
651
- if (typeof v.id !== "string" || v.id.length === 0 || v.id.length > 256) return false;
652
- if ("error" in v) {
653
- const e = v.error;
654
- if (!e || typeof e !== "object" || Array.isArray(e)) return false;
655
- const errObj = e as Record<string, unknown>;
656
- if (typeof errObj.code !== "string") return false;
657
- if (typeof errObj.message !== "string") return false;
658
- }
659
- return true;
660
- }
661
-
662
- /**
663
- * Detect an unsolicited event frame (no `id`, has `event` + `data`).
664
- * Event frames are pushed by the broker's live-fanout (e.g. mailbox.message)
665
- * and must NOT be treated as request responses — otherwise the client's
666
- * strict response validator would fall back on every push.
667
- */
668
- function isEventFrame(value: unknown): boolean {
669
- if (!value || typeof value !== "object" || Array.isArray(value)) return false;
670
- const v = value as Record<string, unknown>;
671
- if (typeof v.event !== "string" || v.event.length === 0) return false;
672
- return "data" in v;
673
- }