chainlesschain 0.162.189 → 0.162.197

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 (317) hide show
  1. package/README.md +84 -11
  2. package/bin/chainlesschain.js +7 -52
  3. package/completions/_cc +209 -0
  4. package/completions/cc.bash +18 -0
  5. package/completions/cc.fish +13 -0
  6. package/completions/cc.ps1 +226 -0
  7. package/package.json +10 -2
  8. package/src/assets/web-panel/assets/{AIOps-DbZft8w0.js → AIOps-D3Gu1a5d.js} +1 -1
  9. package/src/assets/web-panel/assets/{ActionButton-DoOZpwfN.js → ActionButton-DrwAoKaz.js} +1 -1
  10. package/src/assets/web-panel/assets/{Analytics-B0J0KLTW.js → Analytics-C7Q-gd_3.js} +3 -3
  11. package/src/assets/web-panel/assets/{AppLayout-D9eIR0qq.js → AppLayout-DgBtae-n.js} +4 -4
  12. package/src/assets/web-panel/assets/{Artifacts-BnZXEVeo.js → Artifacts-pQ6LcA-W.js} +1 -1
  13. package/src/assets/web-panel/assets/{Audit-X1ce4Bjn.js → Audit-DK61tocB.js} +1 -1
  14. package/src/assets/web-panel/assets/{BackgroundAgents-BvWR-y5v.js → BackgroundAgents-BOKgDFRh.js} +1 -1
  15. package/src/assets/web-panel/assets/{Backup-BublSGEd.js → Backup-Bo9G4vTP.js} +1 -1
  16. package/src/assets/web-panel/assets/{BaseInput-CR_77Hso.js → BaseInput-Do_dE9_v.js} +1 -1
  17. package/src/assets/web-panel/assets/{Chat-DixW52tq.js → Chat-COVvZzOL.js} +6 -6
  18. package/src/assets/web-panel/assets/ChatBubbleRenderer-BUUyJ5QO.js +1 -0
  19. package/src/assets/web-panel/assets/{Checkbox-CCv1C87K.js → Checkbox-Z9MJMolt.js} +1 -1
  20. package/src/assets/web-panel/assets/{Codegen-B03Cc3dd.js → Codegen-BVzWKVbf.js} +1 -1
  21. package/src/assets/web-panel/assets/{Col-CA06-6pU.js → Col-C8MnYcbT.js} +1 -1
  22. package/src/assets/web-panel/assets/{Community-Bj881J52.js → Community-DQxqw15l.js} +1 -1
  23. package/src/assets/web-panel/assets/{Compact-UZLTPoaL.js → Compact-BAUmrh3y.js} +1 -1
  24. package/src/assets/web-panel/assets/{Compliance-kGwzRb_0.js → Compliance-jPAkQ3zK.js} +1 -1
  25. package/src/assets/web-panel/assets/{Cowork-KundoYM8.js → Cowork-BBQyxbh8.js} +2 -2
  26. package/src/assets/web-panel/assets/{Cron-BYZyoqDe.js → Cron-W5koq8Z5.js} +2 -2
  27. package/src/assets/web-panel/assets/{Crosschain-BhrrppBX.js → Crosschain-BQhnu5hS.js} +1 -1
  28. package/src/assets/web-panel/assets/{DID-CdC6EguZ.js → DID-DD7PlI18.js} +2 -2
  29. package/src/assets/web-panel/assets/{Dashboard-CcQx3J4y.js → Dashboard-w_ILuwKI.js} +2 -2
  30. package/src/assets/web-panel/assets/{Dropdown-BpijtEzQ.js → Dropdown-qiDUAyAo.js} +1 -1
  31. package/src/assets/web-panel/assets/{EmailListRenderer-DfZjeZTe.js → EmailListRenderer-PDeBcI5H.js} +1 -1
  32. package/src/assets/web-panel/assets/{FamilyGuardDashboard-BFYSf69C.js → FamilyGuardDashboard-SuArscRM.js} +1 -1
  33. package/src/assets/web-panel/assets/{Federation-Okdi3pJm.js → Federation-BCovZaUn.js} +1 -1
  34. package/src/assets/web-panel/assets/{FormItemContext-mH-HebKW.js → FormItemContext-DjlFdVFk.js} +1 -1
  35. package/src/assets/web-panel/assets/{GenericCardRenderer-xivV69x7.js → GenericCardRenderer-DoEZ7fcS.js} +1 -1
  36. package/src/assets/web-panel/assets/{Git-1rh_YBwg.js → Git-CV0-6GPI.js} +2 -2
  37. package/src/assets/web-panel/assets/{Governance-eAXkNxdY.js → Governance-B_SFN50w.js} +1 -1
  38. package/src/assets/web-panel/assets/{Inference-CS6dMVTN.js → Inference-heI0Eo6k.js} +1 -1
  39. package/src/assets/web-panel/assets/{KnowledgeGraph-Bq_TnkvD.js → KnowledgeGraph-Cz5INS5p.js} +1 -1
  40. package/src/assets/web-panel/assets/{Logs-KchHtiHt.js → Logs-BSFxiHkg.js} +2 -2
  41. package/src/assets/web-panel/assets/MarkdownRenderer-1mNozZ8v.js +1 -0
  42. package/src/assets/web-panel/assets/{Marketplace-CsmGcX5X.js → Marketplace-0TWTpE7k.js} +1 -1
  43. package/src/assets/web-panel/assets/{McpTools-BaPFnnyz.js → McpTools-CV4-wBLm.js} +4 -4
  44. package/src/assets/web-panel/assets/{Memory-2m-sUUf7.js → Memory-x5bH5rw5.js} +2 -2
  45. package/src/assets/web-panel/assets/{MobileBridge-D5nVZBRu.js → MobileBridge-DaBmUu9G.js} +1 -1
  46. package/src/assets/web-panel/assets/{MobileProjects-Bo8MLZvT.js → MobileProjects-DqnoFPgR.js} +1 -1
  47. package/src/assets/web-panel/assets/{Mtc-3GDvamGa.js → Mtc-B_zKEBif.js} +4 -4
  48. package/src/assets/web-panel/assets/{MtcAudit-D2zGuZCH.js → MtcAudit-BCfKD2yg.js} +4 -4
  49. package/src/assets/web-panel/assets/{Multisig-BBVQ4t6t.js → Multisig-DgYfj6c_.js} +3 -3
  50. package/src/assets/web-panel/assets/{NLProgramming-BIOCyOGp.js → NLProgramming-Dz09lFUm.js} +1 -1
  51. package/src/assets/web-panel/assets/{Notes-DVwBGpzc.js → Notes-Cuj6ugBE.js} +3 -3
  52. package/src/assets/web-panel/assets/{NotificationSettings-BDnHfIfX.js → NotificationSettings-DK2WXjhg.js} +1 -1
  53. package/src/assets/web-panel/assets/{OrderTableRenderer-C7Ek20ag.js → OrderTableRenderer-D1IAOQoo.js} +1 -1
  54. package/src/assets/web-panel/assets/{Organization-D3SRKaa7.js → Organization-9fqnPvTw.js} +4 -4
  55. package/src/assets/web-panel/assets/{Overflow-C2B8ahyn.js → Overflow-n5xHkhow.js} +1 -1
  56. package/src/assets/web-panel/assets/{P2P-2iwQzG65.js → P2P-B5AUWwH-.js} +2 -2
  57. package/src/assets/web-panel/assets/{PdhVaultBrowser-CoPiWqMN.js → PdhVaultBrowser-CoUDV6dy.js} +4 -4
  58. package/src/assets/web-panel/assets/{Permissions-yV5XNXo5.js → Permissions-DPRmQf_H.js} +4 -4
  59. package/src/assets/web-panel/assets/{PersonalDataHub-uCDJhMUF.js → PersonalDataHub-B37bsbEN.js} +4 -4
  60. package/src/assets/web-panel/assets/{Pipeline-hN7ucMOA.js → Pipeline-CCAuPqu9.js} +1 -1
  61. package/src/assets/web-panel/assets/{Privacy-CgU0ptN4.js → Privacy-B81msZdv.js} +1 -1
  62. package/src/assets/web-panel/assets/{ProjectInit-CfYPiT6j.js → ProjectInit-B-Py2NbF.js} +2 -2
  63. package/src/assets/web-panel/assets/{ProjectSettings-B0A2C4nw.js → ProjectSettings-CYsneiRB.js} +2 -2
  64. package/src/assets/web-panel/assets/{Projects-BE5C0ajn.js → Projects-Y975Mh6R.js} +1 -1
  65. package/src/assets/web-panel/assets/{Providers-CstQPf8W.js → Providers-uO-10aP1.js} +1 -1
  66. package/src/assets/web-panel/assets/{QrScannerModal-Co3z_ynk.js → QrScannerModal-Bj_6gJ0l.js} +1 -1
  67. package/src/assets/web-panel/assets/{QuickAsk-DMTS6pQ6.js → QuickAsk-BgpBCMPE.js} +1 -1
  68. package/src/assets/web-panel/assets/{Recommend-ETw4odUa.js → Recommend-DhUW3YUA.js} +1 -1
  69. package/src/assets/web-panel/assets/RemoteSession-DdeyfbkA.js +5 -0
  70. package/src/assets/web-panel/assets/{Reputation-BTVqQgKq.js → Reputation-fxW421xd.js} +1 -1
  71. package/src/assets/web-panel/assets/{Row-CBKKwwtO.js → Row-De73w1og.js} +1 -1
  72. package/src/assets/web-panel/assets/{RssFeed-BHUQ438I.js → RssFeed-3US_Q_lj.js} +2 -2
  73. package/src/assets/web-panel/assets/{Search-B4NqeUsF.js → Search-DbZ_DU74.js} +1 -1
  74. package/src/assets/web-panel/assets/{Security-BRjoYG5_.js → Security-DoIU1vMF.js} +4 -4
  75. package/src/assets/web-panel/assets/{Services-CxQzu3p3.js → Services-DB_RGqpc.js} +2 -2
  76. package/src/assets/web-panel/assets/{Skeleton-BKzwwmWO.js → Skeleton-DnzLaayC.js} +1 -1
  77. package/src/assets/web-panel/assets/{Skills-DrsFcgth.js → Skills-VzVXHENF.js} +1 -1
  78. package/src/assets/web-panel/assets/{Sla-D21tmXCH.js → Sla-DMfvjCAI.js} +1 -1
  79. package/src/assets/web-panel/assets/{SpeechSettings-CjyjLfp8.js → SpeechSettings-DQQOYWbF.js} +1 -1
  80. package/src/assets/web-panel/assets/{SyncSettings-Cu45-tnx.js → SyncSettings-Bmx3FG1P.js} +2 -2
  81. package/src/assets/web-panel/assets/{Tasks-oMcILYOj.js → Tasks-DOQyfb-2.js} +1 -1
  82. package/src/assets/web-panel/assets/{Templates-Bh-Zcr5R.js → Templates-D6hTRT7c.js} +1 -1
  83. package/src/assets/web-panel/assets/{Tenant-68ns63aI.js → Tenant-CTPQZAzs.js} +1 -1
  84. package/src/assets/web-panel/assets/{Terminal-BLJkFykE.js → Terminal-B7vII3oH.js} +2 -2
  85. package/src/assets/web-panel/assets/{TimelineRenderer-xcrJLq-O.js → TimelineRenderer-BkiFJeXV.js} +1 -1
  86. package/src/assets/web-panel/assets/{Tokens-C6PpFJtf.js → Tokens-BPPdQMNo.js} +1 -1
  87. package/src/assets/web-panel/assets/{Trigger-BaKA7tdM.js → Trigger-BxG8JAEI.js} +1 -1
  88. package/src/assets/web-panel/assets/{Trust-BzhA57Jc.js → Trust-DHD7nMpM.js} +1 -1
  89. package/src/assets/web-panel/assets/{UkeySign-4_U3JkIR.js → UkeySign-B4BJpU47.js} +1 -1
  90. package/src/assets/web-panel/assets/{VideoEditing-162AANxX.js → VideoEditing-CRiGpFx2.js} +1 -1
  91. package/src/assets/web-panel/assets/{Wallet-B1viuql_.js → Wallet-BSDSNiem.js} +4 -4
  92. package/src/assets/web-panel/assets/{WebAuthn-ZVWazhCy.js → WebAuthn-DLTUh5Zv.js} +5 -5
  93. package/src/assets/web-panel/assets/WorkflowEditor-tW2MwjhD.js +1 -0
  94. package/src/assets/web-panel/assets/{chat-DmrHNuwq.js → chat-SgsLQ3FC.js} +1 -1
  95. package/src/assets/web-panel/assets/{colors-DAJ_M-PK.js → colors-BHjjLIKO.js} +1 -1
  96. package/src/assets/web-panel/assets/{compact-item-uIzmYwLs.js → compact-item-VceErdKq.js} +1 -1
  97. package/src/assets/web-panel/assets/{createContext-D_ZmuLwb.js → createContext-BZ332MYl.js} +1 -1
  98. package/src/assets/web-panel/assets/devWarning-DosMaL-k.js +1 -0
  99. package/src/assets/web-panel/assets/{hasIn-CDt_shTL.js → hasIn-CBTjJOjn.js} +1 -1
  100. package/src/assets/web-panel/assets/index-0O5ePnUq.js +1 -0
  101. package/src/assets/web-panel/assets/{index-rXdwUeE3.js → index-1n7xjKDU.js} +1 -1
  102. package/src/assets/web-panel/assets/{index-BAvSmJXW.js → index-29wVzi-k.js} +1 -1
  103. package/src/assets/web-panel/assets/{index-C16fYKFD.js → index-B2u26AS3.js} +1 -1
  104. package/src/assets/web-panel/assets/{index-C5WcdJH2.js → index-B40dQn0G.js} +3 -3
  105. package/src/assets/web-panel/assets/{index-CaelyMgF.js → index-B5KAGxNo.js} +1 -1
  106. package/src/assets/web-panel/assets/{index-OzTxFIJP.js → index-BC1xuQgX.js} +1 -1
  107. package/src/assets/web-panel/assets/{index-CzXqvMuP.js → index-BETEjuNr.js} +1 -1
  108. package/src/assets/web-panel/assets/{index-clSX4PEc.js → index-BOtvPdHt.js} +1 -1
  109. package/src/assets/web-panel/assets/{index-saf3VNeP.js → index-BPXFLYdW.js} +1 -1
  110. package/src/assets/web-panel/assets/{index-DdUMcwRB.js → index-BQSmZGgs.js} +1 -1
  111. package/src/assets/web-panel/assets/{index-DfSSy9uy.js → index-BRWhLbWF.js} +1 -1
  112. package/src/assets/web-panel/assets/{index-GcKOHD_c.js → index-BTlc-Bve.js} +1 -1
  113. package/src/assets/web-panel/assets/{index-BHvlm0In.js → index-BY1wexYG.js} +1 -1
  114. package/src/assets/web-panel/assets/{index-Cvak6Oe2.js → index-BcUenmCX.js} +1 -1
  115. package/src/assets/web-panel/assets/{index-CKyd472S.js → index-BeiqkxJG.js} +1 -1
  116. package/src/assets/web-panel/assets/{index-DvFhhe6r.js → index-BhXZEUAc.js} +1 -1
  117. package/src/assets/web-panel/assets/{index-DBFmcaCQ.js → index-By5jBtkV.js} +1 -1
  118. package/src/assets/web-panel/assets/{index-DqDSF2RW.js → index-CLc19alH.js} +1 -1
  119. package/src/assets/web-panel/assets/{index-DeGBoLQA.js → index-CMVvxIS8.js} +1 -1
  120. package/src/assets/web-panel/assets/{index-FyplHuNt.js → index-C_B9rFQE.js} +1 -1
  121. package/src/assets/web-panel/assets/{index-CeUpKjvi.js → index-CaIS_TNX.js} +1 -1
  122. package/src/assets/web-panel/assets/{index-BRa4kJ_S.js → index-CawpdGTW.js} +1 -1
  123. package/src/assets/web-panel/assets/index-ChAzPigF.js +1 -0
  124. package/src/assets/web-panel/assets/{index-QsgfSZrV.js → index-CpumS98o.js} +1 -1
  125. package/src/assets/web-panel/assets/{index-BDF6EQBs.js → index-Cr4rjlW5.js} +1 -1
  126. package/src/assets/web-panel/assets/{index-rS3gl_68.js → index-CrUgDQkf.js} +1 -1
  127. package/src/assets/web-panel/assets/{index-D4n1lGTB.js → index-CtjLcCNU.js} +1 -1
  128. package/src/assets/web-panel/assets/{index-ifxmu8SY.js → index-DUkVN794.js} +1 -1
  129. package/src/assets/web-panel/assets/{index-BTCXf1t-.js → index-D_SePDWj.js} +1 -1
  130. package/src/assets/web-panel/assets/{index-Bbxjfstq.js → index-DaCCy6lq.js} +1 -1
  131. package/src/assets/web-panel/assets/{index-D9OE8B3d.js → index-DdefYBSw.js} +1 -1
  132. package/src/assets/web-panel/assets/{index-CG0lY4h3.js → index-DePOeMDM.js} +1 -1
  133. package/src/assets/web-panel/assets/{index-Bx4d6c1k.js → index-DgPvuIn2.js} +1 -1
  134. package/src/assets/web-panel/assets/{index-Z8P4BexE.js → index-FJ3zC9LK.js} +1 -1
  135. package/src/assets/web-panel/assets/{index-ByzGvpR9.js → index-_PHrIO4O.js} +1 -1
  136. package/src/assets/web-panel/assets/{index-DwfvPe-j.js → index-fU7wNHDB.js} +1 -1
  137. package/src/assets/web-panel/assets/{index-CcZ9xJI9.js → index-iYQNU9za.js} +1 -1
  138. package/src/assets/web-panel/assets/{index-CbD_WW_6.js → index-vIXOpcjD.js} +1 -1
  139. package/src/assets/web-panel/assets/{initDefaultProps-pmfaD-aK.js → initDefaultProps-D1oZNz0D.js} +1 -1
  140. package/src/assets/web-panel/assets/{motion-CaQ2CpYF.js → motion-C8k6doMO.js} +1 -1
  141. package/src/assets/web-panel/assets/{move-CkKTqNbI.js → move-DJ4qSbYt.js} +1 -1
  142. package/src/assets/web-panel/assets/{mtc-parser-Dd4xsgRI.js → mtc-parser-CdpJD85j.js} +1 -1
  143. package/src/assets/web-panel/assets/{omit-BFuA5YEs.js → omit-B0V4slKA.js} +1 -1
  144. package/src/assets/web-panel/assets/{pickAttrs-DDfxOAJc.js → pickAttrs-Di5NiW1F.js} +1 -1
  145. package/src/assets/web-panel/assets/{placementArrow-Be595JCp.js → placementArrow-B5OMHgEM.js} +1 -1
  146. package/src/assets/web-panel/assets/{responsiveObserve-7byljUM3.js → responsiveObserve-C6U9IWql.js} +1 -1
  147. package/src/assets/web-panel/assets/{slide-CTWfOTaY.js → slide-BMyTH3rN.js} +1 -1
  148. package/src/assets/web-panel/assets/{statusUtils-CNZOuIxM.js → statusUtils-C7d6BG7Z.js} +1 -1
  149. package/src/assets/web-panel/assets/{styleChecker-DwOcBV78.js → styleChecker-CR50QnQy.js} +1 -1
  150. package/src/assets/web-panel/assets/{useFlexGapSupport-B6MNwAO9.js → useFlexGapSupport-DBEeoMb8.js} +1 -1
  151. package/src/assets/web-panel/assets/{useFs-CzyQjH9r.js → useFs-3r099cjv.js} +1 -1
  152. package/src/assets/web-panel/assets/{usePersonalDataHub-Dxh3KiVA.js → usePersonalDataHub-C5IYNdTK.js} +1 -1
  153. package/src/assets/web-panel/assets/{vnode-DVfZiS5N.js → vnode-DmEOLRHf.js} +1 -1
  154. package/src/assets/web-panel/assets/{zoom-BYme7fbY.js → zoom-DnpUiVCB.js} +1 -1
  155. package/src/assets/web-panel/index.html +1 -1
  156. package/src/cli-help.js +181 -0
  157. package/src/command-help-index.json +181 -0
  158. package/src/command-manifest.json +1271 -175
  159. package/src/command-surface-policy.js +312 -0
  160. package/src/commands/agent.js +76 -33
  161. package/src/commands/artifacts.js +400 -2
  162. package/src/commands/background-session.js +41 -3
  163. package/src/commands/checkpoint-restore-recovery.js +1476 -0
  164. package/src/commands/checkpoint.js +947 -22
  165. package/src/commands/compact.js +101 -25
  166. package/src/commands/config.js +506 -20
  167. package/src/commands/doctor.js +4 -1
  168. package/src/commands/hub.js +1 -1
  169. package/src/commands/mcp.js +688 -24
  170. package/src/commands/pack.js +16 -2
  171. package/src/commands/plugin.js +20 -12
  172. package/src/commands/session-mcp-recovery.js +218 -0
  173. package/src/commands/session.js +470 -110
  174. package/src/commands/setup.js +36 -10
  175. package/src/commands/skill.js +181 -110
  176. package/src/commands/status.js +21 -5
  177. package/src/commands/update.js +68 -6
  178. package/src/constants.js +11 -0
  179. package/src/data/changelog.json +14 -1
  180. package/src/gateways/ws/action-protocol.js +10 -0
  181. package/src/gateways/ws/session-protocol.js +555 -27
  182. package/src/gateways/ws/ws-agent-handler.js +541 -14
  183. package/src/gateways/ws/ws-session-gateway.js +129 -22
  184. package/src/gateways/ws/ws-session-state.js +431 -0
  185. package/src/harness/background-task-manager.js +233 -36
  186. package/src/harness/jsonl-session-store.js +2551 -167
  187. package/src/harness/mcp-client.js +802 -61
  188. package/src/harness/prompt-compressor.js +227 -27
  189. package/src/harness/session-index.js +89 -38
  190. package/src/harness/session-list-index.js +254 -0
  191. package/src/harness/structured-handoff.js +410 -0
  192. package/src/lazy-dispatch.js +747 -84
  193. package/src/lib/__tests__/logger.test.js +50 -2
  194. package/src/lib/advisor-runtime.js +1047 -0
  195. package/src/lib/agent-core.js +1 -0
  196. package/src/lib/agent-sandbox.js +120 -26
  197. package/src/lib/agent-session-export.js +20 -0
  198. package/src/lib/agent-team/team-runner.js +230 -8
  199. package/src/lib/artifact-store.js +131 -8
  200. package/src/lib/background-agent-supervisor.js +185 -13
  201. package/src/lib/background-interaction-journal.js +37 -9
  202. package/src/lib/background-launch-profile.js +1058 -0
  203. package/src/lib/checkpoint-restore-already-completed-controller.js +902 -0
  204. package/src/lib/checkpoint-restore-orchestrator.js +987 -0
  205. package/src/lib/checkpoint-restore-partial-rollback-controller.js +1953 -0
  206. package/src/lib/checkpoint-restore-recovery-controller.js +689 -0
  207. package/src/lib/checkpoint-restore-recovery.js +884 -0
  208. package/src/lib/checkpoint-restore-retention.js +126 -0
  209. package/src/lib/checkpoint-restore-saga.js +5079 -0
  210. package/src/lib/checkpoint-restore-session-recovery.js +1178 -0
  211. package/src/lib/checkpoint-restore-workspace-target-verifier.js +270 -0
  212. package/src/lib/checkpoint-store.js +1688 -97
  213. package/src/lib/checkpoint-timeline-authority.js +522 -0
  214. package/src/lib/checkpoint-timeline.js +642 -0
  215. package/src/lib/config-keys.js +18 -119
  216. package/src/lib/config-manager.js +446 -27
  217. package/src/lib/config-redaction.js +57 -0
  218. package/src/lib/config-schema.js +853 -0
  219. package/src/lib/cowork-mcp-tools.js +5 -0
  220. package/src/lib/cowork-task-runner.js +458 -63
  221. package/src/lib/delivery-coordinator.js +1234 -0
  222. package/src/lib/delivery-evidence.js +450 -0
  223. package/src/lib/doctor-checkup.js +199 -14
  224. package/src/lib/executable-path.js +34 -0
  225. package/src/lib/fatal-handler.js +16 -0
  226. package/src/lib/file-checkpoint.js +4909 -186
  227. package/src/lib/file-lines.js +125 -0
  228. package/src/lib/headless-config-command.js +16 -5
  229. package/src/lib/hook-runner.cjs +139 -38
  230. package/src/lib/hooks-v2-workspace-context.js +10 -0
  231. package/src/lib/impacted-gate-selector.js +424 -0
  232. package/src/lib/interaction-adapter.js +62 -0
  233. package/src/lib/jsonl-session-store.js +1 -35
  234. package/src/lib/logger.js +66 -14
  235. package/src/lib/mcp-call-ledger-store.js +1069 -0
  236. package/src/lib/mcp-call-ledger.js +747 -0
  237. package/src/lib/mcp-client.js +5 -0
  238. package/src/lib/mcp-conflict-scheduler.js +468 -0
  239. package/src/lib/mcp-effect-contract.js +102 -0
  240. package/src/lib/mcp-headers-helper-trust.js +145 -0
  241. package/src/lib/mcp-headers-helper.js +616 -0
  242. package/src/lib/mcp-host-recovery-runtime.js +131 -0
  243. package/src/lib/mcp-ledger-recovery-admission.js +1065 -0
  244. package/src/lib/mcp-recovery-adjudication.js +443 -0
  245. package/src/lib/output-context.js +86 -0
  246. package/src/lib/packer/file-identity.js +170 -0
  247. package/src/lib/packer/index.js +3 -0
  248. package/src/lib/packer/native-update-state.js +277 -0
  249. package/src/lib/packer/pack-update-applier.js +1983 -136
  250. package/src/lib/packer/pack-update-checker.js +34 -0
  251. package/src/lib/packer/pack-update-downloader.js +875 -86
  252. package/src/lib/packer/pack-update-signature.js +86 -0
  253. package/src/lib/packer/pkg-config-generator.js +6 -0
  254. package/src/lib/paths.js +65 -10
  255. package/src/lib/plan-mode.js +831 -14
  256. package/src/lib/plan-persistence.js +540 -0
  257. package/src/lib/plugin-runtime/hooks.js +227 -69
  258. package/src/lib/plugin-runtime/plugin-options.js +189 -44
  259. package/src/lib/pr-automation-policy.js +146 -8
  260. package/src/lib/process-execution-broker/credential-agent.js +7 -0
  261. package/src/lib/process-execution-broker/index.js +53 -8
  262. package/src/lib/process-execution-broker/workspace-transaction.js +976 -73
  263. package/src/lib/project-instructions.js +165 -29
  264. package/src/lib/project-mcp-trust.js +67 -0
  265. package/src/lib/public-ide-capability-manifest.js +278 -0
  266. package/src/lib/public-ide-capability-validation.js +351 -0
  267. package/src/lib/secret-store.js +267 -43
  268. package/src/lib/secure-fs.js +1089 -0
  269. package/src/lib/security-audit.js +58 -0
  270. package/src/lib/service-manager.js +34 -13
  271. package/src/lib/session-budget-runtime.js +1452 -0
  272. package/src/lib/session-host-snapshot.js +388 -0
  273. package/src/lib/session-message-provenance.js +429 -0
  274. package/src/lib/session-projection.js +804 -0
  275. package/src/lib/session-resource-budget.js +1495 -0
  276. package/src/lib/settings-hooks.cjs +138 -22
  277. package/src/lib/settings-loader.cjs +25 -2
  278. package/src/lib/side-effect-ledger-store.js +45 -23
  279. package/src/lib/skill-execution-identity.js +217 -0
  280. package/src/lib/skill-loader.js +299 -18
  281. package/src/lib/sub-agent-context.js +236 -28
  282. package/src/lib/sub-agent-registry.js +5 -0
  283. package/src/lib/subagent-contract.js +94 -0
  284. package/src/lib/todo-manager.js +185 -18
  285. package/src/lib/todo-persistence.js +417 -0
  286. package/src/lib/turn-binding-store.js +41 -23
  287. package/src/lib/with-file-lock.js +25 -1
  288. package/src/lib/ws-chat-handler.js +21 -0
  289. package/src/program-base.js +18 -0
  290. package/src/repl/advisor-command.js +103 -0
  291. package/src/repl/agent-repl.js +2332 -154
  292. package/src/repl/btw-command.js +93 -10
  293. package/src/repl/clipboard-image.js +119 -0
  294. package/src/repl/config-summary.js +64 -108
  295. package/src/repl/prompt-editor.js +233 -0
  296. package/src/repl/prompt-interactions.js +404 -0
  297. package/src/repl/prompt-stash.js +354 -0
  298. package/src/repl/prompt-suggestions.js +312 -0
  299. package/src/repl/repl-keybindings.js +227 -0
  300. package/src/repl/session-recap.js +217 -0
  301. package/src/repl/slash-command-registry.js +25 -4
  302. package/src/repl/terminal-layout.js +88 -0
  303. package/src/runtime/agent-core.js +1264 -325
  304. package/src/runtime/coding-agent-contract-shared.cjs +13 -1
  305. package/src/runtime/coding-agent-managed-tool-policy.cjs +7 -2
  306. package/src/runtime/diagnostics.js +32 -13
  307. package/src/runtime/headless-runner.js +298 -118
  308. package/src/runtime/headless-stream.js +353 -95
  309. package/src/runtime/mcp-config.js +148 -14
  310. package/src/runtime/status-diagnostics-lite.js +137 -0
  311. package/src/assets/web-panel/assets/ChatBubbleRenderer-DDHDpBBA.js +0 -1
  312. package/src/assets/web-panel/assets/MarkdownRenderer-TabqHW9B.js +0 -1
  313. package/src/assets/web-panel/assets/RemoteSession-B0rkE09d.js +0 -5
  314. package/src/assets/web-panel/assets/WorkflowEditor-tzdyUk-1.js +0 -1
  315. package/src/assets/web-panel/assets/devWarning-DIrncrV1.js +0 -1
  316. package/src/assets/web-panel/assets/index-D-Swwqld.js +0 -1
  317. package/src/assets/web-panel/assets/index-FMZAMKy8.js +0 -1
@@ -55,5 +55,6 @@ export {
55
55
  disposeSharedCodeIntel,
56
56
  emitToolHookLifecycle,
57
57
  emitToolBatchHookLifecycle,
58
+ buildSubAgentHandoffContext,
58
59
  _resetSubtreeInstructionLoaders,
59
60
  } from "../runtime/agent-core.js";
@@ -5,6 +5,11 @@ import { proxyEnv } from "./sandbox-egress-proxy.js";
5
5
  import executionBroker from "./process-execution-broker/index.js";
6
6
 
7
7
  export const DEFAULT_SANDBOX_IMAGE = "node:22-bookworm-slim";
8
+ export const AGENT_SANDBOX_MODES = Object.freeze([
9
+ "off",
10
+ "workspace-write",
11
+ "strict",
12
+ ]);
8
13
  export const _deps = {
9
14
  spawnSync: (...args) => executionBroker.spawnSync(...args),
10
15
  };
@@ -82,8 +87,7 @@ function pathIsWithin(candidate, root) {
82
87
  }
83
88
 
84
89
  function normalizeWorkspaceRoots(entries, cwd) {
85
- const roots =
86
- Array.isArray(entries) && entries.length > 0 ? entries : [cwd];
90
+ const roots = Array.isArray(entries) && entries.length > 0 ? entries : [cwd];
87
91
  return stringList(roots).map((entry) => path.resolve(cwd, entry));
88
92
  }
89
93
 
@@ -142,9 +146,7 @@ export function resolveSandboxPolicyPath(
142
146
  ? normalizedPolicy.allowWrite
143
147
  : normalizedPolicy.allowRead;
144
148
  const policyDenies =
145
- access === "write"
146
- ? normalizedPolicy.denyWrite
147
- : normalizedPolicy.denyRead;
149
+ access === "write" ? normalizedPolicy.denyWrite : normalizedPolicy.denyRead;
148
150
  const allowedInputs = [
149
151
  ...normalizeWorkspaceRoots(workspaceRoots, resolvedCwd),
150
152
  ...resolvePolicyPaths(policyAllows, resolvedCwd),
@@ -208,18 +210,112 @@ export function normalizeSandboxPolicy(settings = {}, cwd = process.cwd()) {
208
210
 
209
211
  export function normalizeAgentSandbox(value, options = {}) {
210
212
  const settings = options.settings || {};
211
- if (!value && settings.enabled !== true) return null;
212
- if (value === false || settings.enabled === false) return null;
213
+ const policyRequiresSandbox =
214
+ settings.requireSandbox === true ||
215
+ settings.allowUnsandboxedCommands === false;
216
+ if (!value && settings.enabled !== true && !policyRequiresSandbox)
217
+ return null;
218
+ if (value === false || settings.enabled === false) {
219
+ if (policyRequiresSandbox) {
220
+ const error = new Error(
221
+ "Sandbox disablement is prohibited by effective sandbox policy",
222
+ );
223
+ error.code = "CONFIG_SANDBOX_OFF_PROHIBITED";
224
+ throw error;
225
+ }
226
+ return null;
227
+ }
228
+ const effectiveSettings = policyRequiresSandbox
229
+ ? {
230
+ ...settings,
231
+ enabled: true,
232
+ failIfUnavailable: true,
233
+ allowUnsandboxedCommands: false,
234
+ }
235
+ : settings;
236
+ const managedNetworkDisabled = options.managedSettings?.network === false;
213
237
  const image =
214
238
  typeof value === "string" && value.trim() && value !== "true"
215
239
  ? value.trim()
216
240
  : DEFAULT_SANDBOX_IMAGE;
217
241
  return {
218
- engine: settings.engine || "docker",
219
- image: settings.image || image,
242
+ engine: effectiveSettings.engine || "docker",
243
+ image: effectiveSettings.image || image,
220
244
  cwd: path.resolve(options.cwd || process.cwd()),
221
- network: options.network === true || settings.network === true,
222
- policy: normalizeSandboxPolicy(settings, options.cwd || process.cwd()),
245
+ network: managedNetworkDisabled
246
+ ? false
247
+ : options.network === true || effectiveSettings.network === true,
248
+ policy: normalizeSandboxPolicy(
249
+ effectiveSettings,
250
+ options.cwd || process.cwd(),
251
+ ),
252
+ };
253
+ }
254
+
255
+ /**
256
+ * Resolve the explicit public sandbox posture. Both isolation modes fail
257
+ * closed when the selected engine is unavailable; `strict` additionally
258
+ * forbids per-command unsandboxed escape hatches and network access.
259
+ */
260
+ export function normalizeAgentSandboxMode(mode, value, options = {}) {
261
+ if (mode == null || mode === "") {
262
+ return normalizeAgentSandbox(value, options);
263
+ }
264
+ if (!AGENT_SANDBOX_MODES.includes(mode)) {
265
+ const error = new Error(
266
+ `Invalid sandbox mode "${mode}"; expected off, workspace-write, or strict`,
267
+ );
268
+ error.code = "CONFIG_SANDBOX_MODE_INVALID";
269
+ throw error;
270
+ }
271
+ const settings = { ...(options.settings || {}) };
272
+ if (mode === "off") {
273
+ const managedSettings = options.managedSettings || {};
274
+ if (
275
+ managedSettings.enabled === true ||
276
+ managedSettings.requireSandbox === true ||
277
+ managedSettings.allowUnsandboxedCommands === false ||
278
+ settings.requireSandbox === true ||
279
+ settings.allowUnsandboxedCommands === false
280
+ ) {
281
+ const error = new Error(
282
+ "Sandbox mode off is prohibited by managed/effective sandbox policy",
283
+ );
284
+ error.code = "CONFIG_SANDBOX_OFF_PROHIBITED";
285
+ throw error;
286
+ }
287
+ return null;
288
+ }
289
+ settings.enabled = true;
290
+ settings.failIfUnavailable = true;
291
+ settings.allowUnsandboxedCommands = false;
292
+ if (mode === "strict") {
293
+ settings.network = false;
294
+ }
295
+ const sandbox = normalizeAgentSandbox(value || true, {
296
+ ...options,
297
+ network: mode === "strict" ? false : options.network,
298
+ settings,
299
+ });
300
+ sandbox.mode = mode;
301
+ return sandbox;
302
+ }
303
+
304
+ /**
305
+ * Clamp an already-enabled sandbox to fail closed for safety-oriented run
306
+ * modes. This never turns isolation on implicitly; it only prevents a selected
307
+ * sandbox from degrading to bare host execution when its engine is missing.
308
+ */
309
+ export function enforceSandboxFailClosed(sandbox, reason = "safe") {
310
+ if (!sandbox) return null;
311
+ return {
312
+ ...sandbox,
313
+ failClosedReason: reason,
314
+ policy: {
315
+ ...(sandbox.policy || {}),
316
+ allowUnsandboxedCommands: false,
317
+ failIfUnavailable: true,
318
+ },
223
319
  };
224
320
  }
225
321
 
@@ -229,21 +325,19 @@ export function executeSandboxedShell(command, sandbox, options = {}) {
229
325
  }
230
326
  const hostCwd = path.resolve(options.cwd || sandbox.cwd);
231
327
  const policy = sandbox.policy || normalizeSandboxPolicy({}, hostCwd);
232
- // An egress proxy (see sandbox-egress-proxy.js) ENFORCES the domain allow/deny
233
- // policy: the caller starts it and passes `{ env }` here, and the sandboxed
234
- // process routes its HTTP(S) traffic through it. Without a proxy, a
235
- // domain-restricted network request has no enforcement point, so we refuse
236
- // rather than grant unrestricted access.
328
+ // Proxy environment variables are advisory: a child can clear them or open a
329
+ // raw socket. Until a backend can enforce egress below the process layer,
330
+ // domain-restricted networking must fail closed instead of granting the
331
+ // sandbox an unrestricted network namespace.
237
332
  const egress = options.egressProxy || null;
238
333
  if (
239
334
  (policy.allowedDomains.length || policy.deniedDomains.length) &&
240
- sandbox.network &&
241
- !egress
335
+ sandbox.network
242
336
  ) {
243
337
  return {
244
338
  stdout: "",
245
339
  stderr:
246
- "Domain-restricted sandbox networking requires a configured sandbox proxy; refusing unrestricted network access",
340
+ "Domain-restricted sandbox networking has no non-bypassable backend enforcement; refusing unrestricted network access",
247
341
  exitCode: 1,
248
342
  failedToStart: true,
249
343
  };
@@ -272,10 +366,8 @@ export function executeSandboxedShell(command, sandbox, options = {}) {
272
366
  if (process.platform !== "win32" && process.getuid && process.getgid) {
273
367
  args.push("--user", `${process.getuid()}:${process.getgid()}`);
274
368
  }
275
- // Route egress through the host proxy so the domain policy is enforced. The
276
- // container reaches the host proxy via host.docker.internal (mapped to the
277
- // gateway on Linux via host-gateway); the caller builds `egress.env` with that
278
- // hostname (proxyEnv(port, "host.docker.internal")).
369
+ // Proxy variables remain useful for unrestricted networking, but are not a
370
+ // security boundary. Domain-restricted requests have already failed closed.
279
371
  if (egress && egress.port && sandbox.network) {
280
372
  args.push("--add-host", "host.docker.internal:host-gateway");
281
373
  const penv = proxyEnv(egress.port, "host.docker.internal");
@@ -348,8 +440,8 @@ function executeBubblewrapShell(command, sandbox, options, hostCwd, policy) {
348
440
  for (const target of policy.denyWrite) args.push("--ro-bind", target, target);
349
441
  for (const target of policy.denyRead) args.push("--tmpfs", target);
350
442
  args.push("--", "sh", "-lc", String(command || ""));
351
- // bwrap `--share-net` shares the host network namespace, so the egress proxy
352
- // is reachable at 127.0.0.1 directly — merge its env into the child's.
443
+ // bwrap `--share-net` shares the host network namespace. Proxy variables are
444
+ // convenience only; domain-restricted requests have already failed closed.
353
445
  const egress = options.egressProxy || null;
354
446
  const bwrapEnv =
355
447
  egress && egress.port && sandbox.network
@@ -459,7 +551,7 @@ export function assertSandboxAvailable(sandbox, deps = _deps) {
459
551
 
460
552
  export function sandboxSummary(sandbox) {
461
553
  if (!sandbox) return null;
462
- return {
554
+ const summary = {
463
555
  engine: sandbox.engine,
464
556
  image: sandbox.image,
465
557
  isolationLevel: isolationLevel(sandbox),
@@ -474,4 +566,6 @@ export function sandboxSummary(sandbox) {
474
566
  failIfUnavailable: sandbox.policy?.failIfUnavailable === true,
475
567
  },
476
568
  };
569
+ if (sandbox.mode) summary.mode = sandbox.mode;
570
+ return summary;
477
571
  }
@@ -7,6 +7,7 @@
7
7
  * Pure function over the event list (see jsonl-session-store.js appendEvent):
8
8
  * { type, timestamp, data }
9
9
  * types: session_start{title,provider,model} · user_message · assistant_message
10
+ * · ws_turn{requestId,user,assistant,outcome}
10
11
  * · system · tool_call{tool,args} · tool_result{tool,result}
11
12
  * · compact(stats) · token_usage{...}
12
13
  */
@@ -76,6 +77,25 @@ export function renderAgentSessionMarkdown(sessionId, events, opts = {}) {
76
77
  L.push(asText(ev.data?.content));
77
78
  L.push("");
78
79
  break;
80
+ case "ws_turn":
81
+ if (
82
+ ev.data?.schemaVersion === 1 &&
83
+ ev.data?.outcome === "completed" &&
84
+ ev.data?.user?.role === "user" &&
85
+ ev.data?.assistant?.role === "assistant"
86
+ ) {
87
+ users += 1;
88
+ assistants += 1;
89
+ L.push("## 👤 User");
90
+ L.push("");
91
+ L.push(asText(ev.data.user.content));
92
+ L.push("");
93
+ L.push("## 🤖 Assistant");
94
+ L.push("");
95
+ L.push(asText(ev.data.assistant.content));
96
+ L.push("");
97
+ }
98
+ break;
79
99
  case "system":
80
100
  L.push("## ⚙ System");
81
101
  L.push("");
@@ -46,6 +46,10 @@ export class TeamRunner {
46
46
  // Team-wide token/USD/time/task budget (null → unbounded). Consulted before
47
47
  // every claim; folded after every settled task.
48
48
  this.budget = opts.budget || null;
49
+ // Optional process/session-wide authority shared with non-team sub-agents,
50
+ // tools and background work. TeamBudget remains the team-specific pricing
51
+ // and reservation facade; this budget owns global concurrency + cascade.
52
+ this.sessionBudget = opts.sessionBudget || null;
49
53
  this.budgetForTask =
50
54
  typeof opts.budgetForTask === "function" ? opts.budgetForTask : null;
51
55
  // Directed/broadcast messaging between teammates (null → disabled).
@@ -338,6 +342,7 @@ export class TeamRunner {
338
342
  armWallTimer();
339
343
  }
340
344
  }
345
+ this.sessionBudget?.start?.();
341
346
  const workers = [];
342
347
  const workerCount = Math.min(
343
348
  this.teammates,
@@ -372,9 +377,11 @@ export class TeamRunner {
372
377
  requestedTeammates: this.teammates,
373
378
  activeTeammates: workerCount,
374
379
  budgetStopped: this._budgetStopped,
375
- budgetReason: this.budget
376
- ? this.budget.reason()
377
- : this._registryBudgetReason,
380
+ budgetReason:
381
+ this.budget?.reason?.() ||
382
+ this.sessionBudget?.reason?.() ||
383
+ this._registryBudgetReason,
384
+ sessionBudgetStatus: this.sessionBudget?.status?.() || null,
378
385
  members: this.members(),
379
386
  messages: this.mailbox ? this.mailbox.size() : 0,
380
387
  mailboxStatus: this.mailbox?.status?.() || null,
@@ -395,6 +402,15 @@ export class TeamRunner {
395
402
  this._setState(holder, "shutdown", { reason: "fatal-error" });
396
403
  return;
397
404
  }
405
+ if (this.sessionBudget?.signal?.aborted) {
406
+ const reason = this.sessionBudget.reason?.() || "session-aborted";
407
+ if (!this._budgetStopped) {
408
+ this._budgetStopped = true;
409
+ this._emit("run:budget-exhausted", { reason });
410
+ }
411
+ this._setState(holder, "shutdown", { reason });
412
+ return;
413
+ }
398
414
  if (this._executions + this._reservedExecutions >= this.maxTasks) {
399
415
  this._emit("run:budget-exhausted", { maxTasks: this.maxTasks });
400
416
  this._setState(holder, "shutdown", { reason: "max-tasks" });
@@ -490,8 +506,74 @@ export class TeamRunner {
490
506
  });
491
507
  return;
492
508
  }
509
+ let sessionWork;
510
+ try {
511
+ sessionWork = this._reserveSessionWork(key, acq.lease);
512
+ } catch (error) {
513
+ this.registry.release(key, {
514
+ holder,
515
+ leaseId: acq.lease.leaseId,
516
+ });
517
+ if (budgetReservation.id) {
518
+ this.budget?.releaseReservation?.(budgetReservation.id);
519
+ }
520
+ this._setFatal(error, {
521
+ phase: "session-budget-acquire",
522
+ key,
523
+ holder,
524
+ });
525
+ this._setState(holder, "shutdown", { reason: "fatal-error" });
526
+ return;
527
+ }
528
+ if (!sessionWork.ok) {
529
+ this.registry.release(key, {
530
+ holder,
531
+ leaseId: acq.lease.leaseId,
532
+ });
533
+ if (budgetReservation.id) {
534
+ this.budget?.releaseReservation?.(budgetReservation.id);
535
+ }
536
+ if (sessionWork.retryable) {
537
+ this._setState(holder, "idle");
538
+ // The occupied global slot may belong to a background task outside
539
+ // this runner, so no TeamRunner progress event is guaranteed.
540
+ await this._tick();
541
+ continue;
542
+ }
543
+ if (!this._budgetStopped) {
544
+ this._budgetStopped = true;
545
+ this._emit("run:budget-exhausted", {
546
+ reason: sessionWork.reason,
547
+ });
548
+ }
549
+ this._setState(holder, "shutdown", {
550
+ reason: sessionWork.reason,
551
+ });
552
+ return;
553
+ }
493
554
  this._reservedExecutions++;
494
- const claim = this._beginClaim(holder, key, acq.lease, budgetReservation);
555
+ let claim;
556
+ try {
557
+ claim = this._beginClaim(
558
+ holder,
559
+ key,
560
+ acq.lease,
561
+ budgetReservation,
562
+ sessionWork,
563
+ );
564
+ } catch (error) {
565
+ this._reservedExecutions = Math.max(0, this._reservedExecutions - 1);
566
+ this.registry.release(key, {
567
+ holder,
568
+ leaseId: acq.lease.leaseId,
569
+ });
570
+ if (budgetReservation.id) {
571
+ this.budget?.releaseReservation?.(budgetReservation.id);
572
+ }
573
+ this._setFatal(error, { phase: "session-budget-bind", key, holder });
574
+ this._setState(holder, "shutdown", { reason: "fatal-error" });
575
+ return;
576
+ }
495
577
  if (!this._acquireScope(holder, key)) {
496
578
  this._abandonClaim(holder, key, claim);
497
579
  if (this._fatalError) {
@@ -524,20 +606,24 @@ export class TeamRunner {
524
606
  // Preserve an explicit human interruption so `_execute` can settle it
525
607
  // fail-closed for adjudication instead of silently abandoning it.
526
608
  const preparedBudgetReason = this.budget?.reason?.();
609
+ const preparedSessionReason = this.sessionBudget?.signal?.aborted
610
+ ? this.sessionBudget.reason?.() || "session-aborted"
611
+ : null;
527
612
  if (
528
613
  !claim.interruption &&
529
614
  !claim.coordinatorAbort &&
530
- preparedBudgetReason === "max-wall-ms"
615
+ (preparedBudgetReason === "max-wall-ms" || preparedSessionReason)
531
616
  ) {
617
+ const reason = preparedSessionReason || preparedBudgetReason;
532
618
  if (!this._budgetStopped) {
533
619
  this._budgetStopped = true;
534
620
  this._emit("run:budget-exhausted", {
535
- reason: preparedBudgetReason,
621
+ reason,
536
622
  });
537
623
  }
538
624
  this._abandonClaim(holder, key, claim);
539
625
  this._setState(holder, "shutdown", {
540
- reason: preparedBudgetReason,
626
+ reason,
541
627
  });
542
628
  return;
543
629
  }
@@ -602,7 +688,22 @@ export class TeamRunner {
602
688
  };
603
689
  }
604
690
 
605
- _beginClaim(holder, key, lease, budgetReservation = null) {
691
+ _reserveSessionWork(key, lease) {
692
+ if (!this.sessionBudget?.acquireWork) return { ok: true, release: null };
693
+ return this.sessionBudget.acquireWork({
694
+ id: `team-task:${lease?.leaseId || key}`,
695
+ kind: "team-task",
696
+ depth: 1,
697
+ });
698
+ }
699
+
700
+ _beginClaim(
701
+ holder,
702
+ key,
703
+ lease,
704
+ budgetReservation = null,
705
+ sessionWork = null,
706
+ ) {
606
707
  const claim = {
607
708
  holder,
608
709
  key,
@@ -614,6 +715,11 @@ export class TeamRunner {
614
715
  abortController: new AbortController(),
615
716
  budgetReservation,
616
717
  budgetSettled: false,
718
+ sessionWork,
719
+ sessionBudgetSettled: false,
720
+ sessionBudgetUsageHandledByExecutor: false,
721
+ sessionBudgetView: null,
722
+ unregisterSessionAbortable: null,
617
723
  interruption: null,
618
724
  coordinatorAbort: null,
619
725
  };
@@ -623,6 +729,29 @@ export class TeamRunner {
623
729
  this._activeKeys.add(key);
624
730
  this._claimControllers.add(claim.abortController);
625
731
  this._claimsByKey.set(key, claim);
732
+ if (this.sessionBudget?.registerAbortable && sessionWork?.id) {
733
+ try {
734
+ claim.unregisterSessionAbortable = this.sessionBudget.registerAbortable(
735
+ `team-claim:${sessionWork.id}`,
736
+ (reason) => {
737
+ if (!claim.abortController.signal.aborted) {
738
+ claim.abortController.abort(reason);
739
+ }
740
+ },
741
+ );
742
+ } catch (error) {
743
+ this._activeKeys.delete(key);
744
+ this._claimControllers.delete(claim.abortController);
745
+ this._claimsByKey.delete(key);
746
+ try {
747
+ sessionWork.release?.();
748
+ } catch {
749
+ // Preserve the registration failure as the authoritative cause. A
750
+ // conforming SessionResourceBudget release is idempotent/nonthrowing.
751
+ }
752
+ throw error;
753
+ }
754
+ }
626
755
  const effectiveTtl =
627
756
  this.ttlMs > 0 ? this.ttlMs : this.registry.defaultTtlMs || 60000;
628
757
  const every = Math.max(
@@ -753,6 +882,84 @@ export class TeamRunner {
753
882
  if (this._claimsByKey.get(claim.key) === claim) {
754
883
  this._claimsByKey.delete(claim.key);
755
884
  }
885
+ try {
886
+ claim.unregisterSessionAbortable?.();
887
+ } catch {
888
+ // The session budget may already have delivered and cleared the callback.
889
+ }
890
+ claim.unregisterSessionAbortable = null;
891
+ try {
892
+ claim.sessionWork?.release?.();
893
+ } catch {
894
+ // Session work leases are idempotent.
895
+ }
896
+ claim.sessionWork = null;
897
+ claim.sessionBudgetView = null;
898
+ }
899
+
900
+ _sessionBudgetForClaim(claim) {
901
+ if (!this.sessionBudget || !claim) return this.sessionBudget;
902
+ if (claim.sessionBudgetView) return claim.sessionBudgetView;
903
+ const authority = this.sessionBudget;
904
+ const methods = new Map();
905
+ claim.sessionBudgetView = new Proxy(authority, {
906
+ get(target, property) {
907
+ const value = Reflect.get(target, property, target);
908
+ if (typeof value !== "function") return value;
909
+ if (methods.has(property)) return methods.get(property);
910
+ const method =
911
+ property === "recordUsage"
912
+ ? (...args) => {
913
+ // Usage charged through the inherited authority is already in
914
+ // the global ledger. Remember that ownership so the task's
915
+ // returned aggregate is not charged a second time.
916
+ claim.sessionBudgetUsageHandledByExecutor = true;
917
+ return value.apply(target, args);
918
+ }
919
+ : value.bind(target);
920
+ methods.set(property, method);
921
+ return method;
922
+ },
923
+ set(target, property, value) {
924
+ return Reflect.set(target, property, value, target);
925
+ },
926
+ });
927
+ return claim.sessionBudgetView;
928
+ }
929
+
930
+ _recordSessionUsage(claim, source) {
931
+ if (!this.sessionBudget || claim.sessionBudgetSettled) return;
932
+ claim.sessionBudgetSettled = true;
933
+ if (claim.sessionBudgetUsageHandledByExecutor) return;
934
+ this.sessionBudget.recordUsage({
935
+ usage: source?.usage || null,
936
+ usageRecords: source?.usageRecords || null,
937
+ provider: source?.provider,
938
+ model: source?.model,
939
+ });
940
+ }
941
+
942
+ _sessionBudgetFailure(executionResult = null) {
943
+ const sharedReason = this.sessionBudget?.signal?.reason;
944
+ // Never attach per-task usage to the shared AbortSignal reason: every
945
+ // sibling observes that same Error object and would then re-record the
946
+ // triggering task's usage as its own failure.
947
+ const failure = new Error(
948
+ sharedReason?.message ||
949
+ `Session budget exhausted: ${this.sessionBudget?.reason?.() || "session-aborted"}`,
950
+ sharedReason instanceof Error ? { cause: sharedReason } : undefined,
951
+ );
952
+ failure.code = sharedReason?.code || "ERR_SESSION_RESOURCE_BUDGET";
953
+ failure.budgetReason =
954
+ sharedReason?.budgetReason || this.sessionBudget?.reason?.();
955
+ failure.retryable = false;
956
+ if (executionResult && typeof executionResult === "object") {
957
+ failure.usage = executionResult.usage || null;
958
+ failure.usageRecords = executionResult.usageRecords || null;
959
+ failure.provider = executionResult.provider;
960
+ failure.model = executionResult.model;
961
+ }
962
+ return failure;
756
963
  }
757
964
 
758
965
  _interruptionError(claim, executionResult = null) {
@@ -947,6 +1154,15 @@ export class TeamRunner {
947
1154
  if (claim.interruption) {
948
1155
  throw this._interruptionError(claim);
949
1156
  }
1157
+ if (claim.coordinatorAbort) {
1158
+ throw claim.coordinatorAbort;
1159
+ }
1160
+ // Synchronous observers above (`onEvent`, mailbox, tracing) may abort the
1161
+ // shared authority after the worker's post-beforeTask check. This is the
1162
+ // final fail-closed fence immediately before executor side effects.
1163
+ if (this.sessionBudget?.signal?.aborted) {
1164
+ throw this._sessionBudgetFailure();
1165
+ }
950
1166
  const result = await this.runTask({
951
1167
  key,
952
1168
  task,
@@ -957,6 +1173,7 @@ export class TeamRunner {
957
1173
  mailbox: this.mailbox,
958
1174
  budget: this.budget,
959
1175
  budgetReservation: claim.budgetReservation,
1176
+ sessionBudget: this._sessionBudgetForClaim(claim),
960
1177
  signal: claim.abortController.signal,
961
1178
  });
962
1179
  // The executor may ignore AbortSignal or finish concurrently with an IDE
@@ -968,6 +1185,10 @@ export class TeamRunner {
968
1185
  if (claim.coordinatorAbort) {
969
1186
  throw claim.coordinatorAbort;
970
1187
  }
1188
+ this._recordSessionUsage(claim, result);
1189
+ if (this.sessionBudget?.signal?.aborted) {
1190
+ throw this._sessionBudgetFailure(result);
1191
+ }
971
1192
  // Executors are allowed to return after observing (or even ignoring) an
972
1193
  // aborted signal. Re-read the authoritative budget before recording or
973
1194
  // completing so a late result can never become a phantom success.
@@ -1074,6 +1295,7 @@ export class TeamRunner {
1074
1295
  );
1075
1296
  claim.budgetSettled = true;
1076
1297
  }
1298
+ this._recordSessionUsage(claim, failure);
1077
1299
  const outcome = this.registry.fail(key, {
1078
1300
  holder,
1079
1301
  leaseId: claim.leaseId,