chainlesschain 0.163.5 → 0.163.7

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 (236) hide show
  1. package/completions/_cc +1 -1
  2. package/completions/cc.bash +1 -1
  3. package/completions/cc.fish +1 -1
  4. package/completions/cc.ps1 +1 -1
  5. package/package.json +1 -1
  6. package/src/assets/web-panel/assets/{AIOps-Cv2EE1Zy.js → AIOps-axqQfwv8.js} +1 -1
  7. package/src/assets/web-panel/assets/{ActionButton-CcpxMLuW.js → ActionButton-DV-Ro0By.js} +1 -1
  8. package/src/assets/web-panel/assets/{Analytics-DE8mJoMI.js → Analytics-Bt72WEVu.js} +3 -3
  9. package/src/assets/web-panel/assets/{AppLayout-DKn9dk9L.js → AppLayout-BtepG55E.js} +5 -5
  10. package/src/assets/web-panel/assets/{Artifacts-Cp3mG3Py.js → Artifacts-B7KaJ7S_.js} +1 -1
  11. package/src/assets/web-panel/assets/{Audit-zvsQfF2C.js → Audit-FNFaUg7A.js} +1 -1
  12. package/src/assets/web-panel/assets/{BackgroundAgents-Bi85SsjN.js → BackgroundAgents-DFb6J2wQ.js} +1 -1
  13. package/src/assets/web-panel/assets/{Backup-Cw47Dj6s.js → Backup-CC7YBhyj.js} +1 -1
  14. package/src/assets/web-panel/assets/{BaseInput-C5Ip2afH.js → BaseInput-RkgTNVtj.js} +1 -1
  15. package/src/assets/web-panel/assets/{Chat-C0iAFkJv.js → Chat-hHEmGZy-.js} +5 -5
  16. package/src/assets/web-panel/assets/{ChatBubbleRenderer-BV9Wv7wO.js → ChatBubbleRenderer-CAP9YhHv.js} +1 -1
  17. package/src/assets/web-panel/assets/{Checkbox-3KZZCiAF.js → Checkbox-z5wXOQP1.js} +1 -1
  18. package/src/assets/web-panel/assets/{Codegen-C8OMbBAz.js → Codegen-DVaDJnxy.js} +1 -1
  19. package/src/assets/web-panel/assets/{Col-B-MB84LJ.js → Col-CJmaRDR5.js} +1 -1
  20. package/src/assets/web-panel/assets/{Community-DpR7Dxao.js → Community-DF29_2bI.js} +1 -1
  21. package/src/assets/web-panel/assets/{Compact-CyDtz0OS.js → Compact-DtkQkBzn.js} +1 -1
  22. package/src/assets/web-panel/assets/{Compliance-5tiRa2An.js → Compliance-xoHDxp7I.js} +1 -1
  23. package/src/assets/web-panel/assets/{Cowork-DnQaKZ5x.js → Cowork-BUm-R7ht.js} +4 -4
  24. package/src/assets/web-panel/assets/{Cron-BaWfoEDf.js → Cron-Cgl14ZkB.js} +2 -2
  25. package/src/assets/web-panel/assets/{Crosschain-Bu0HoHhb.js → Crosschain-BNcbmoqh.js} +1 -1
  26. package/src/assets/web-panel/assets/{DID-31zk8upX.js → DID-Bwja0Zo9.js} +2 -2
  27. package/src/assets/web-panel/assets/{Dashboard-BmVne-e2.js → Dashboard-Bk5XjEdJ.js} +2 -2
  28. package/src/assets/web-panel/assets/{Dropdown-B4PkoOWd.js → Dropdown-Ci36Oitq.js} +1 -1
  29. package/src/assets/web-panel/assets/{EmailListRenderer-BZ6tyFtI.js → EmailListRenderer--U04ZN4q.js} +1 -1
  30. package/src/assets/web-panel/assets/{FamilyGuardDashboard-Osozn4Ds.js → FamilyGuardDashboard-B2gNPR2s.js} +1 -1
  31. package/src/assets/web-panel/assets/{Federation-DaH8TOAP.js → Federation-C4KghYn7.js} +1 -1
  32. package/src/assets/web-panel/assets/{FormItemContext-tbU0uwis.js → FormItemContext-QL7x_Q_0.js} +1 -1
  33. package/src/assets/web-panel/assets/{GenericCardRenderer-Df8LQBrL.js → GenericCardRenderer-F3Ryltwm.js} +1 -1
  34. package/src/assets/web-panel/assets/{Git-DsMB6-14.js → Git-2HassK5k.js} +2 -2
  35. package/src/assets/web-panel/assets/{Governance-BnH0dZzd.js → Governance-DoBIp7oe.js} +1 -1
  36. package/src/assets/web-panel/assets/{Inference-DhnN1N_P.js → Inference--W01QhZ-.js} +1 -1
  37. package/src/assets/web-panel/assets/{KnowledgeGraph-DnNshAgn.js → KnowledgeGraph-DmvwqGpT.js} +1 -1
  38. package/src/assets/web-panel/assets/{Logs-BmBFX3_N.js → Logs-BBJ4yAel.js} +2 -2
  39. package/src/assets/web-panel/assets/{MarkdownRenderer-DCslfQU3.js → MarkdownRenderer-BLCZMzhJ.js} +1 -1
  40. package/src/assets/web-panel/assets/{Marketplace-CPEgWDc3.js → Marketplace-D5lNngSI.js} +1 -1
  41. package/src/assets/web-panel/assets/{McpTools-C36qjgF9.js → McpTools-CkEVOMKH.js} +5 -5
  42. package/src/assets/web-panel/assets/{Memory-tNHvrgqN.js → Memory-B1Ow1xVE.js} +2 -2
  43. package/src/assets/web-panel/assets/{MobileBridge-Xaf6cKjc.js → MobileBridge-SgYbUfb6.js} +1 -1
  44. package/src/assets/web-panel/assets/{MobileProjects-D2E5TTeO.js → MobileProjects-BWdOvQAj.js} +1 -1
  45. package/src/assets/web-panel/assets/{Mtc-D4AJ2dwV.js → Mtc-DcTXSSma.js} +2 -2
  46. package/src/assets/web-panel/assets/{MtcAudit-Df-gtn2_.js → MtcAudit-Dt3WG4oj.js} +4 -4
  47. package/src/assets/web-panel/assets/{Multisig-DTCHLWld.js → Multisig-B9B38UZx.js} +3 -3
  48. package/src/assets/web-panel/assets/{NLProgramming-DruZ_1Jb.js → NLProgramming-B0S4GGvG.js} +1 -1
  49. package/src/assets/web-panel/assets/{Notes-Dx3pdGDs.js → Notes-DZ5U58Ng.js} +4 -4
  50. package/src/assets/web-panel/assets/{NotificationSettings-Bi3L69oL.js → NotificationSettings-PjL5ZW34.js} +1 -1
  51. package/src/assets/web-panel/assets/{OrderTableRenderer-BHY33m7C.js → OrderTableRenderer-DrAX2ESt.js} +1 -1
  52. package/src/assets/web-panel/assets/{Organization-BG2ZVEV-.js → Organization-Cv1GYs-c.js} +4 -4
  53. package/src/assets/web-panel/assets/{Overflow-Viwtg4Mn.js → Overflow-Bbkp_PL3.js} +1 -1
  54. package/src/assets/web-panel/assets/{P2P-Clm_yc1Z.js → P2P-BD8QUgoZ.js} +2 -2
  55. package/src/assets/web-panel/assets/{PdhVaultBrowser-NKmmDiOw.js → PdhVaultBrowser-BO-2PeaB.js} +5 -5
  56. package/src/assets/web-panel/assets/{Permissions-DIL8u9Nk.js → Permissions-D_OPVa02.js} +4 -4
  57. package/src/assets/web-panel/assets/{PersonalDataHub-B-jM4wt-.js → PersonalDataHub-mh-pEmaB.js} +4 -4
  58. package/src/assets/web-panel/assets/{Pipeline-627I__H5.js → Pipeline-6JC2EDdb.js} +1 -1
  59. package/src/assets/web-panel/assets/{Privacy-2DN2qrkW.js → Privacy-CUshzUAG.js} +1 -1
  60. package/src/assets/web-panel/assets/{ProjectInit-CN4wC0sF.js → ProjectInit-Cs2Aalri.js} +2 -2
  61. package/src/assets/web-panel/assets/{ProjectSettings-K35vsh5H.js → ProjectSettings-1ak49tcj.js} +2 -2
  62. package/src/assets/web-panel/assets/{Projects-B_wQadhX.js → Projects-BV4oApsm.js} +1 -1
  63. package/src/assets/web-panel/assets/{Providers-MckaQUhQ.js → Providers-CXXxvafH.js} +1 -1
  64. package/src/assets/web-panel/assets/{QrScannerModal-BS3mtA_O.js → QrScannerModal-PTcDsF58.js} +1 -1
  65. package/src/assets/web-panel/assets/{QuickAsk-BHp_nofL.js → QuickAsk-CDwucrJw.js} +1 -1
  66. package/src/assets/web-panel/assets/{Recommend-DlmnPuZj.js → Recommend-CJlLVRXR.js} +1 -1
  67. package/src/assets/web-panel/assets/{RemoteSession-tsyFbvpy.js → RemoteSession-DlN-ETsO.js} +2 -2
  68. package/src/assets/web-panel/assets/{Reputation-Ba1iWv2D.js → Reputation-DI23LR6m.js} +1 -1
  69. package/src/assets/web-panel/assets/{Row-NnlGC--f.js → Row-Cl7UQMrM.js} +1 -1
  70. package/src/assets/web-panel/assets/{RssFeed-CjThSIRv.js → RssFeed-CexHNfh8.js} +3 -3
  71. package/src/assets/web-panel/assets/{Search-CojUyC5x.js → Search-BneBWvRN.js} +1 -1
  72. package/src/assets/web-panel/assets/{Security-c-sxeJEc.js → Security-DX7Phgrp.js} +4 -4
  73. package/src/assets/web-panel/assets/{Services-CtcKEEmF.js → Services-BWXO8Mte.js} +2 -2
  74. package/src/assets/web-panel/assets/{Skeleton-CIBBXflN.js → Skeleton-DCyOjKPJ.js} +1 -1
  75. package/src/assets/web-panel/assets/{Skills-D1XOOK9n.js → Skills-CXqERsTB.js} +1 -1
  76. package/src/assets/web-panel/assets/{Sla-hRfEp5Sn.js → Sla-bhbrbz8E.js} +1 -1
  77. package/src/assets/web-panel/assets/{SpeechSettings-Dexb1f_6.js → SpeechSettings-3IPU0HBZ.js} +1 -1
  78. package/src/assets/web-panel/assets/{SyncSettings-BJsSFGYy.js → SyncSettings-DBNTQLbM.js} +2 -2
  79. package/src/assets/web-panel/assets/{Tasks-CfSZ8A1L.js → Tasks-quP0bkN-.js} +1 -1
  80. package/src/assets/web-panel/assets/{Templates-idDf47W-.js → Templates-BouWmgho.js} +1 -1
  81. package/src/assets/web-panel/assets/{Tenant-C-UsX6w6.js → Tenant-qv0D9s7z.js} +1 -1
  82. package/src/assets/web-panel/assets/{Terminal-BgJtX5n1.js → Terminal-BxvbE8BB.js} +2 -2
  83. package/src/assets/web-panel/assets/{TimelineRenderer-DP0BLKTl.js → TimelineRenderer-D-IeLnJ2.js} +1 -1
  84. package/src/assets/web-panel/assets/{Tokens-LwCzqETp.js → Tokens-CFMKKyVG.js} +1 -1
  85. package/src/assets/web-panel/assets/{Trigger-D_9tVch0.js → Trigger-L8as3UuJ.js} +1 -1
  86. package/src/assets/web-panel/assets/{Trust-BH2UlEWh.js → Trust-MxmA4VZG.js} +1 -1
  87. package/src/assets/web-panel/assets/{UkeySign-CIpD0nYb.js → UkeySign-C0VvJYRi.js} +1 -1
  88. package/src/assets/web-panel/assets/{VideoEditing-9ShhYxK_.js → VideoEditing-Bf5QZj8N.js} +1 -1
  89. package/src/assets/web-panel/assets/{Wallet-C7afGNIG.js → Wallet-BIJ9riRz.js} +4 -4
  90. package/src/assets/web-panel/assets/{WebAuthn-bUKn6i5R.js → WebAuthn-B8p9Mhkw.js} +4 -4
  91. package/src/assets/web-panel/assets/{WorkflowEditor-CxgQaGyp.js → WorkflowEditor-BVsuaPen.js} +1 -1
  92. package/src/assets/web-panel/assets/{chat-DMVkmJwx.js → chat-BfkjoKpV.js} +1 -1
  93. package/src/assets/web-panel/assets/{colors-CDzQh5nS.js → colors-DeAlsWK8.js} +1 -1
  94. package/src/assets/web-panel/assets/{compact-item-C51kEF4D.js → compact-item-Cs97bz5j.js} +1 -1
  95. package/src/assets/web-panel/assets/{createContext-BTk9bXBn.js → createContext-BqbG60LH.js} +1 -1
  96. package/src/assets/web-panel/assets/devWarning-DPty0mGN.js +1 -0
  97. package/src/assets/web-panel/assets/{hasIn-CMje33rb.js → hasIn-i_RY0b1X.js} +1 -1
  98. package/src/assets/web-panel/assets/{index-DpcrFxMI.js → index-0-agYlWL.js} +1 -1
  99. package/src/assets/web-panel/assets/{index-BW4F5YDF.js → index-79V_zv1s.js} +1 -1
  100. package/src/assets/web-panel/assets/{index-DRG-aqOs.js → index-B-3tEpTc.js} +1 -1
  101. package/src/assets/web-panel/assets/{index-BCRvG9lq.js → index-B-JVTrpr.js} +1 -1
  102. package/src/assets/web-panel/assets/{index-DgivOKHA.js → index-B1CbOH1i.js} +1 -1
  103. package/src/assets/web-panel/assets/{index-BzCkNylB.js → index-B5UkyA3c.js} +1 -1
  104. package/src/assets/web-panel/assets/{index-x53Vf7la.js → index-BESLFt4q.js} +1 -1
  105. package/src/assets/web-panel/assets/{index-CCLj9hcD.js → index-BOVkf1K3.js} +1 -1
  106. package/src/assets/web-panel/assets/{index-CypsfcEq.js → index-BYUVuwKt.js} +1 -1
  107. package/src/assets/web-panel/assets/{index-BtlEqHLP.js → index-BcUXAB2s.js} +1 -1
  108. package/src/assets/web-panel/assets/{index-Ld_4mFmC.js → index-BkBi5TmC.js} +1 -1
  109. package/src/assets/web-panel/assets/{index-DqU9njjT.js → index-Bm7lLR4c.js} +1 -1
  110. package/src/assets/web-panel/assets/index-Bt7g0Vq_.js +1 -0
  111. package/src/assets/web-panel/assets/{index-CwGPwjUu.js → index-BuLQobzW.js} +1 -1
  112. package/src/assets/web-panel/assets/{index-C5IWTMVl.js → index-CE2VtTlp.js} +1 -1
  113. package/src/assets/web-panel/assets/{index-DJfnCuMq.js → index-CED2PL_y.js} +1 -1
  114. package/src/assets/web-panel/assets/{index-hg_emBsi.js → index-CG3PRyAL.js} +1 -1
  115. package/src/assets/web-panel/assets/{index-togc_uYn.js → index-CIG8fQ2_.js} +1 -1
  116. package/src/assets/web-panel/assets/{index-C4rQCS8T.js → index-COdGA-8n.js} +1 -1
  117. package/src/assets/web-panel/assets/{index-0Auljb10.js → index-CeWoNHau.js} +1 -1
  118. package/src/assets/web-panel/assets/{index-Cd0hmPxD.js → index-Cf3WCLmy.js} +1 -1
  119. package/src/assets/web-panel/assets/{index-BXQBPLyE.js → index-CgsqdnRV.js} +1 -1
  120. package/src/assets/web-panel/assets/index-ChVT0p9u.js +1 -0
  121. package/src/assets/web-panel/assets/{index-h31MwrME.js → index-D2B4VPyP.js} +1 -1
  122. package/src/assets/web-panel/assets/{index-C1oZReaY.js → index-D9evtvg2.js} +1 -1
  123. package/src/assets/web-panel/assets/{index-CfC-piWZ.js → index-DUUrv141.js} +1 -1
  124. package/src/assets/web-panel/assets/{index-D9rC-fGW.js → index-DiSkx4UB.js} +3 -3
  125. package/src/assets/web-panel/assets/{index-CvSeVzqe.js → index-Dk2qouAz.js} +1 -1
  126. package/src/assets/web-panel/assets/{index-CtM8OT_7.js → index-Dk7-v4hP.js} +1 -1
  127. package/src/assets/web-panel/assets/{index-BBz9LIMS.js → index-DmbfhJUP.js} +1 -1
  128. package/src/assets/web-panel/assets/{index-BAfY7m7i.js → index-DqBgBpgp.js} +1 -1
  129. package/src/assets/web-panel/assets/{index-BVePe_Rf.js → index-PT_5sBMA.js} +1 -1
  130. package/src/assets/web-panel/assets/{index-CDLkNkLj.js → index-U4f5izHz.js} +1 -1
  131. package/src/assets/web-panel/assets/{index-BTlsE8Df.js → index-YXgLng0K.js} +1 -1
  132. package/src/assets/web-panel/assets/{index-BeEaAEIp.js → index-ZxO_-E8a.js} +1 -1
  133. package/src/assets/web-panel/assets/{index-B0-zMtKA.js → index-dIHr4B_u.js} +1 -1
  134. package/src/assets/web-panel/assets/{index-C1oZQmAA.js → index-gyFpvL7l.js} +1 -1
  135. package/src/assets/web-panel/assets/{index-DRLQyp2A.js → index-s1opAL-M.js} +1 -1
  136. package/src/assets/web-panel/assets/{index-OS-vfbTA.js → index-yObj1O4n.js} +1 -1
  137. package/src/assets/web-panel/assets/{initDefaultProps-vrA8K-ac.js → initDefaultProps-C9h9yKL3.js} +1 -1
  138. package/src/assets/web-panel/assets/{motion-ByEzwIAl.js → motion-BvmLsPdu.js} +1 -1
  139. package/src/assets/web-panel/assets/{move-Ck4AWjw-.js → move-CoL4ekU1.js} +1 -1
  140. package/src/assets/web-panel/assets/{mtc-parser-6p0l9SrB.js → mtc-parser-C4pMy6xV.js} +1 -1
  141. package/src/assets/web-panel/assets/{omit-B1CUPQ6R.js → omit-DPuJfNxx.js} +1 -1
  142. package/src/assets/web-panel/assets/{pickAttrs-B1STg1iW.js → pickAttrs-D0KEeaK2.js} +1 -1
  143. package/src/assets/web-panel/assets/{placementArrow-DTTllkBV.js → placementArrow-BpkyINxt.js} +1 -1
  144. package/src/assets/web-panel/assets/{responsiveObserve-AIrrCfBb.js → responsiveObserve-DQI_wOq8.js} +1 -1
  145. package/src/assets/web-panel/assets/{slide-C_fPMjdR.js → slide-DYfdDiRg.js} +1 -1
  146. package/src/assets/web-panel/assets/{statusUtils-D5ow2yIP.js → statusUtils-B5dtvb0D.js} +1 -1
  147. package/src/assets/web-panel/assets/{styleChecker-Dy3hEA--.js → styleChecker-CF310mSj.js} +1 -1
  148. package/src/assets/web-panel/assets/{useFlexGapSupport-WfzcfSh4.js → useFlexGapSupport-D1Qp4BLp.js} +1 -1
  149. package/src/assets/web-panel/assets/{useFs-CKSejfas.js → useFs-C7_iyvJK.js} +1 -1
  150. package/src/assets/web-panel/assets/{usePersonalDataHub-od3zpPBN.js → usePersonalDataHub-DZUt_fIm.js} +1 -1
  151. package/src/assets/web-panel/assets/{vnode-DRD_2DFA.js → vnode-D3dsi0lZ.js} +1 -1
  152. package/src/assets/web-panel/assets/{zoom-DmNrEtgf.js → zoom-WdbOlvdQ.js} +1 -1
  153. package/src/assets/web-panel/index.html +1 -1
  154. package/src/command-help-index.json +5 -5
  155. package/src/command-manifest.json +1 -1
  156. package/src/commands/agenda.js +76 -4
  157. package/src/commands/agent.js +90 -1
  158. package/src/commands/automation.js +462 -3
  159. package/src/commands/background-session.js +102 -1
  160. package/src/commands/chat.js +11 -2
  161. package/src/commands/compact.js +106 -23
  162. package/src/commands/cowork.js +6 -1
  163. package/src/commands/loop.js +187 -38
  164. package/src/commands/routine.js +12 -5
  165. package/src/commands/scheduler-daemon.js +807 -0
  166. package/src/commands/session-observability.js +305 -0
  167. package/src/commands/session.js +38 -0
  168. package/src/data/changelog.json +28 -2
  169. package/src/gateways/ws/ws-agent-handler.js +439 -5
  170. package/src/harness/jsonl-session-store.js +463 -125
  171. package/src/harness/prompt-compressor.js +86 -13
  172. package/src/harness/provider-backed-compaction.js +100 -27
  173. package/src/lib/advisor-runtime.js +3 -1
  174. package/src/lib/agent-schedule-store.js +737 -47
  175. package/src/lib/agent-team/team-adjudication.js +40 -1
  176. package/src/lib/automation-center-routines.js +363 -0
  177. package/src/lib/automation-center.js +435 -0
  178. package/src/lib/automation-engine.js +568 -19
  179. package/src/lib/automation-execution-authority.js +736 -0
  180. package/src/lib/background-agent-supervisor.js +871 -215
  181. package/src/lib/background-command-argv.js +24 -0
  182. package/src/lib/background-interaction-journal.js +361 -52
  183. package/src/lib/background-interaction-resolver.js +32 -0
  184. package/src/lib/background-launch-profile.js +2 -0
  185. package/src/lib/background-needs-input-incident.js +221 -0
  186. package/src/lib/causal-observability.js +2661 -0
  187. package/src/lib/chat-session-admission.js +76 -0
  188. package/src/lib/cost-budget.js +5 -7
  189. package/src/lib/cowork/ab-comparator-cli.js +11 -0
  190. package/src/lib/cowork/debate-review-cli.js +12 -0
  191. package/src/lib/cowork-adapter.js +159 -38
  192. package/src/lib/cowork-cron.js +673 -19
  193. package/src/lib/cowork-observe.js +5 -1
  194. package/src/lib/cowork-task-runner.js +112 -17
  195. package/src/lib/delivery-coordinator.js +142 -0
  196. package/src/lib/direct-model-usage.js +121 -0
  197. package/src/lib/file-lines.js +183 -47
  198. package/src/lib/llm-pricing.js +12 -17
  199. package/src/lib/loop.js +62 -3
  200. package/src/lib/permission-engine.js +14 -7
  201. package/src/lib/public-ide-capability-manifest.js +2 -0
  202. package/src/lib/routine-store.js +546 -86
  203. package/src/lib/runtime-usage-ledger.js +182 -0
  204. package/src/lib/scheduler-kernel/agenda-adapter.js +604 -29
  205. package/src/lib/scheduler-kernel/authority-resolver.js +163 -0
  206. package/src/lib/scheduler-kernel/automation-adapter.js +994 -0
  207. package/src/lib/scheduler-kernel/automation-event-adapter.js +757 -0
  208. package/src/lib/scheduler-kernel/contract.js +11 -3
  209. package/src/lib/scheduler-kernel/cowork-cron-adapter.js +343 -15
  210. package/src/lib/scheduler-kernel/loop-adapter.js +913 -0
  211. package/src/lib/scheduler-kernel/migration-admin.js +346 -0
  212. package/src/lib/scheduler-kernel/migration-rollback-admin.js +932 -0
  213. package/src/lib/scheduler-kernel/routine-adapter.js +691 -22
  214. package/src/lib/scheduler-kernel/runtime.js +63 -1
  215. package/src/lib/scheduler-kernel/service.js +328 -0
  216. package/src/lib/scheduler-kernel/source-locator-path.js +142 -0
  217. package/src/lib/scheduler-kernel/store.js +3439 -206
  218. package/src/lib/session-host-lease.js +171 -2
  219. package/src/lib/session-host-snapshot.js +14 -3
  220. package/src/lib/session-persistence-failure.js +1 -0
  221. package/src/lib/session-tail.js +179 -34
  222. package/src/lib/session-transcript-structure.js +96 -0
  223. package/src/lib/sub-agent-context.js +328 -22
  224. package/src/lib/ws-agent-handler.js +4 -1
  225. package/src/repl/agent-repl.js +732 -91
  226. package/src/repl/chat-repl.js +5 -1
  227. package/src/runtime/agent-core.js +1274 -208
  228. package/src/runtime/coding-agent-contract-shared.cjs +5 -0
  229. package/src/runtime/fallback-model.js +5 -0
  230. package/src/runtime/headless-runner.js +324 -82
  231. package/src/runtime/headless-stream.js +232 -26
  232. package/src/runtime/policies/agent-policy.js +4 -0
  233. package/src/workers/background-agent-worker.js +468 -98
  234. package/src/assets/web-panel/assets/devWarning-CdwPwYj8.js +0 -1
  235. package/src/assets/web-panel/assets/index-BEeOdfEe.js +0 -1
  236. package/src/assets/web-panel/assets/index-BTe0TOu6.js +0 -1
@@ -8,7 +8,7 @@
8
8
  // Injected by web-ui-server.js at serve time
9
9
  window.__CC_CONFIG__ = __CC_CONFIG_PLACEHOLDER__;
10
10
  </script>
11
- <script type="module" crossorigin src="./assets/index-D9rC-fGW.js"></script>
11
+ <script type="module" crossorigin src="./assets/index-DiSkx4UB.js"></script>
12
12
  <link rel="modulepreload" crossorigin href="./assets/vendor-Bn1JzzAn.js">
13
13
  <link rel="modulepreload" crossorigin href="./assets/icons-DG5UD-6K.js">
14
14
  <link rel="stylesheet" crossorigin href="./assets/index-Cq93VfoF.css">
@@ -5,7 +5,7 @@
5
5
  "a2a": "Usage: chainlesschain a2a [options] [command]\n\nA2A Protocol — agent-to-agent communication\n\nOptions:\n -h, --help display help for command\n\nCommands:\n register [options] <name> Register an agent card\n discover [options] Discover agents by capability or skill\n submit [options] <agent-id> <input> Submit a task to an agent\n status [options] <task-id> Get task status\n complete <task-id> <output> Mark a task as completed\n fail <task-id> <error> Mark a task as failed\n peers [options] List all registered agents\n cards [options] List all agent cards with details\n negotiate [options] <agent-id> <capabilities> Check if an agent supports required capabilities\n task-statuses [options] List V2 task statuses (Phase 81)\n card-statuses [options] List V2 card statuses (Phase 81)\n subscription-types [options] List V2 subscription types (Phase 81)\n negotiation-results [options] List V2 negotiation outcomes (Phase 81)\n validate-card [options] <name> Validate an agent card against the A2A schema\n set-card-status [options] <cardId> <status> Transition a card between active/inactive/expired\n card-status [options] <cardId> Show a card's V2 status\n send-task-v2 [options] <agentId> <input> Submit a V2 task (in-memory, with optional timeout)\n start-working [options] <taskId> Transition a V2 task to working\n request-input [options] <taskId> <prompt> Request user input while a V2 task is working\n provide-input [options] <taskId> <input> Provide input for an input-required V2 task\n complete-task-v2 [options] <taskId> [output] Complete a V2 task (from working only)\n fail-task-v2 [options] <taskId> [error] Fail a V2 task with an error message\n cancel-task [options] <taskId> [reason] Cancel a non-terminal V2 task\n check-timeout [options] <taskId> Check V2 task timeout (auto-fails if past deadline)\n task-v2 [options] <taskId> Show a V2 task snapshot\n tasks-v2 [options] List V2 tasks\n negotiate-v2 [options] <cardJson> Phase 81 capability negotiation against an agent card\n stats-v2 [options] Aggregate V2 stats (tasks + cards + subscriptions)\n enums-v2 Show V2 governance enums\n register-agent-v2 [options] Register an a2a agent profile (pending)\n activate-agent-v2 <id> Activate agent\n suspend-agent-v2 <id> Suspend agent\n retire-agent-v2 <id> Retire agent (terminal)\n touch-agent-v2 <id> Refresh lastTouchedAt\n get-agent-v2 <id> Get agent\n list-agents-v2 List agents\n create-message-v2 [options] Create an a2a message (queued)\n start-message-v2 <id> Transition message to sending\n deliver-message-v2 <id> Transition message to delivered\n fail-message-v2 [options] <id> Fail message\n cancel-message-v2 [options] <id> Cancel message\n get-message-v2 <id> Get message\n list-messages-v2 List messages\n set-max-active-agents-v2 <n> Set per-owner active cap\n set-max-pending-messages-v2 <n> Set per-agent pending cap\n set-agent-idle-ms-v2 <n> Set idle threshold\n set-message-stuck-ms-v2 <n> Set stuck threshold\n auto-suspend-idle-agents-v2 Auto-suspend idle agents\n auto-fail-stuck-messages-v2 Auto-fail stuck sending messages\n gov-stats-v2 V2 governance aggregate stats\n help [command] display help for command\n",
6
6
  "activitypub": "Usage: chainlesschain activitypub|ap [options] [command]\n\nActivityPub C2S bridge — actors, outbox/inbox, Follow/Create/Like/Announce\n\nOptions:\n -h, --help display help for command\n\nCommands:\n actor Manage local and remote ActivityPub actors\n publish [options] <content> Publish a Create(Note) activity to the actor's outbox\n follow [options] <target> Publish a Follow activity (target: username or actor URL)\n accept [options] <follow-activity-id> Accept a pending Follow request\n unfollow [options] <target> Publish an Undo(Follow) activity\n like [options] <object-id> Publish a Like activity for an object URL\n announce [options] <object-id> Publish an Announce (boost) activity for an object URL\n outbox [options] <username> List an actor's outbox activities\n inbox [options] <username> List an actor's inbox activities\n deliver [options] <username> <activity-json> Simulate inbox delivery — push a JSON activity into a local actor's inbox\n followers [options] <username> List followers of an actor\n search [options] <query> Search actors and/or notes in the local Fediverse index\n following [options] <username> List who this actor is following\n enums-v2 Show V2 enums\n register-actor-v2 [options] Register an AP actor profile (pending)\n activate-actor-v2 <id> Activate actor\n suspend-actor-v2 <id> Suspend actor\n deactivate-actor-v2 <id> Deactivate actor (terminal)\n touch-actor-v2 <id> Refresh lastTouchedAt\n get-actor-v2 <id> Get actor\n list-actors-v2 List actors\n create-activity-v2 [options] Create an AP activity (queued)\n start-activity-v2 <id> Transition activity to delivering\n deliver-activity-v2 <id> Transition activity to delivered\n fail-activity-v2 [options] <id> Fail activity\n cancel-activity-v2 [options] <id> Cancel activity\n get-activity-v2 <id> Get activity\n list-activities-v2 List activities\n set-max-active-actors-v2 <n> Set per-owner active cap\n set-max-pending-activities-v2 <n> Set per-actor pending cap\n set-actor-idle-ms-v2 <n> Set idle threshold\n set-activity-stuck-ms-v2 <n> Set stuck threshold\n auto-suspend-idle-actors-v2 Auto-suspend idle actors\n auto-fail-stuck-activities-v2 Auto-fail stuck delivering activities\n gov-stats-v2 V2 governance aggregate stats\n help [command] display help for command\n",
7
7
  "agenda": "Usage: chainlesschain agenda [options] [command]\n\nFire agent-scheduled wakeups / crons / monitors (persisted by the `schedule`\ntool)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n list [options] List all scheduled entries\n run [options] Fire every entry that is due now\n cancel [options] <id> Remove a scheduled entry by id\n prune [options] Remove finished entries (fired / matched / exhausted /\n expired)\n help [command] display help for command\n",
8
- "agent": "Usage: chainlesschain agent|a [options] [task...]\n\nStart an agentic AI session (reads/writes files, runs commands)\n\nArguments:\n task Headless task 鈥?when given (or with -p /\n piped stdin), runs non-interactively\n\nOptions:\n --model <model> Model name\n --provider <provider> LLM provider (ollama, openai,\n volcengine, deepseek, ...)\n --base-url <url> API base URL\n --api-key <key> API key\n --think [level] Enable Anthropic extended thinking\n (level: think | hard | ultra; Anthropic\n models only)\n --ultrathink Maximum Anthropic extended thinking (=\n --think ultra)\n --thinking-budget <n> Thinking token budget for legacy Claude\n models (Sonnet 4.5 / Opus 4.0-4.5 /\n older); clamped below max_tokens.\n Adaptive-thinking models ignore it (they\n use --think's effort). Requires\n --think/--ultrathink.\n --image <path> Attach an image (png/jpg/jpeg/gif/webp)\n to the prompt for a vision-capable model\n (headless; repeatable)\n --vision-model <id> Model to use when an image is attached\n (default: config llm.visionModel or\n doubao-seed-2-0-lite-260215)\n --session <id> Resume a previous agent session\n -c, --continue Resume the most recent session (no id\n needed 鈥?claude --continue parity)\n --resume [id] Resume a session by id (no id 鈫?most\n recent 鈥?claude --resume parity)\n --fork-session When resuming, branch into a NEW session\n id and leave the original untouched\n (claude --fork-session parity)\n --fork-request-id <key> Stable idempotency key for\n --fork-session retries (omit for a new\n fork each invocation)\n --add-dir <dir> Extra working directory the agent may\n read/search/edit (repeatable)\n --checkpoint Auto-snapshot the work tree before each\n mutating tool (DEFAULT inside a git\n repo; cc checkpoint restore to roll\n back)\n --no-checkpoint Disable auto-checkpointing (it is on by\n default inside git repos)\n --managed-checkpoint Checkpoint bounded mutating tools with\n Process Broker; unavailable writer\n lifetimes are reported as coverage none\n --managed-checkpoint-state <dir> Durable managed-checkpoint state\n directory (must be outside the\n workspace)\n --managed-checkpoint-exclude <path> Explicit workspace path excluded from\n managed checkpoints; repeatable and\n reported as partial coverage\n --safe-mode Run bare: disable project memory,\n settings hooks, memory recall, IDE\n context, status line and update notice\n (permission rules STAY active)\n --bare Everything --safe-mode disables PLUS\n skills, plugins and MCP/IDE auto-connect\n — minimal fast surface for scripted\n calls (explicit --mcp-config still\n loads; permission rules STAY active)\n --ephemeral No session persistence: nothing is\n written to the session store (headless;\n a --resume id still replays history\n read-only)\n --capabilities Print a machine-readable capability\n manifest (JSON: protocol version, tools,\n permission modes, exit codes) and exit\n --disable-slash-commands Interactive REPL: don't dispatch '/'\n input as slash commands — it reaches the\n model verbatim (/exit and /quit stay\n live)\n --ax-screen-reader Screen-reader friendly output: no ANSI\n colors, no in-place status line repaints\n (also CC_SCREEN_READER=1)\n --worktree Run this session in a fresh git worktree\n (isolated branch; auto-removed when the\n session changes nothing)\n --no-worktree Background Git task: explicitly share\n the current work tree (intended for\n read-only tasks; writable runs are not\n isolated)\n --unattended Enable fail-closed shell action policy\n for scheduled/event-driven runs\n --unattended-allow <classes> Comma-separated action classes\n explicitly allowed for unattended shell\n runs\n --sandbox [image] Run shell commands in an ephemeral\n Docker sandbox (network disabled by\n default)\n --sandbox-mode <mode> Sandbox posture: off | workspace-write |\n strict (explicit isolation modes fail\n closed)\n --sandbox-network Allow network access inside --sandbox\n --otlp <file> Write the agent run's OpenTelemetry\n spans (model/tool/retry) as OTLP/JSON to\n <file>\n --otlp-content Include prompt/response CONTENT in\n --otlp spans (off by default; content is\n redacted unless this is set)\n --auto-rewake When an async `asyncRewake` hook (e.g. a\n background test) fails at turn end,\n re-engage the agent to fix it (bounded\n by --max-rewakes)\n --auto-pin Force-pin the original task (first user\n turn) through compaction (ON by default;\n disable with CC_AUTO_PIN=0 or config\n context.autoPin=false)\n --max-rewakes <n> Max auto-rewake re-drives per run\n (default 1); implies --auto-rewake\n --bg, --background Start as a detached background agent and\n return its id immediately\n --agent-id <id> Agent id for scoped memory recall\n --recall-limit <n> Top-K memories to inject into system\n prompt\n --recall-query <q> Query string for startup memory recall\n --no-recall-memory Disable startup memory recall\n --vim Start the interactive REPL in vim-mode\n line editing (toggle later with /vim; or\n CC_VIM=1)\n --no-stream Disable streamed response rendering\n --no-park-on-exit Close the session-core handle on exit\n instead of parking it\n --bundle <path> Agent bundle directory (may execute\n local MCP commands from mcp.json)\n -p, --print [prompt] Headless: run one non-interactive turn\n and exit\n --output-format <fmt> Headless output: text | json |\n stream-json (default: \"text\")\n --max-turns <n> Cap agent loop iterations (headless)\n --json-schema <file> Headless structured output: final reply\n must be JSON validating against this\n schema (invalid replies retried)\n --allowed-tools <list> Comma/space-separated tool allow-list\n (headless)\n --disallowed-tools <list> Comma/space-separated tool deny-list\n (headless)\n --permission-mode <mode> manual | auto | dontAsk | default | plan\n | acceptEdits | bypassPermissions (plan\n headless-only)\n --no-file-refs Disable @path file-reference expansion\n in the prompt (headless)\n --no-slash-macros Disable /name custom-command\n (.claude/commands) expansion in the\n prompt (headless)\n --system-prompt <text> Replace the built-in system prompt\n (literal text or @file)\n --append-system-prompt <text> Append extra guidance to the system\n prompt (literal text or @file)\n --no-project-memory Skip auto-loaded project memory (cc.md /\n CLAUDE.md / AGENTS.md hierarchy,\n .chainlesschain/rules.md,\n .claude/rules/*.md) — a lean system\n prompt for token-tight surfaces (e.g.\n IDE chat). The agent can still read\n those files with tools when it needs\n them.\n --output-style <name> Apply a named output-style persona\n (.claude/output-styles/<name>.md or a\n built-in: explanatory | learning)\n --input-format <fmt> Headless input: text | stream-json\n (NDJSON user events on stdin,\n multi-turn) (default: \"text\")\n --trace-id <id> Correlation id stamped as `trace_id` on\n every stream-json output line (also read\n from CC_TRACE_ID). Lets an IDE/bridge\n trace one run across its own logs, the\n CLI, transcripts and diagnostics.\n Auto-generated per run when omitted.\n --fallback-model <model> Backup model(s) to try in order when the\n primary fails (transient error or\n model-not-found). Repeatable or\n comma-separated; up to 3. A\n `provider:model` entry (e.g.\n openai:gpt-4o) falls back\n cross-provider, using that provider's\n API key from its env var (skipped if\n unset — never reuses the primary key).\n Defaults to config llm.fallbackModels.\n --include-partial-messages Emit live assistant-text deltas as\n stream_event lines (requires\n --output-format stream-json)\n --goal [id] Bind a cc goal into the run (id, or omit\n the value to auto-resolve the active\n goal)\n --goal-assess After the run, ask the model to assess\n goal progress and persist it (opt-in;\n costs one extra completion; requires\n --goal)\n --goal-condition <spec> Session completion condition; re-drives\n outer turns until met. Prefix\n exit-zero:/file-exists:/contains:/regex:\n (deterministic) or model:<desc>\n (model-judged)\n --max-outer-turns <n> Max outer re-drive turns for\n --goal-condition (default 10, hard cap\n 100)\n --goal-max-tokens <n> Token budget across --goal-condition\n outer turns\n --goal-max-cost <usd> Cost budget (USD) across\n --goal-condition outer turns\n --goal-max-time <ms> Wall-clock budget (ms) across\n --goal-condition outer turns\n --mcp-config <file> Load ad-hoc MCP servers from a JSON file\n for this run (headless); their tools\n become callable (mcp__<server>__<tool>)\n --no-mcp Don't auto-connect MCP servers\n registered with `cc mcp add\n --auto-connect` (--mcp-config still\n loads)\n --ide Force-enable IDE bridge auto-connect:\n discover a running editor's MCP server\n via ~/.chainlesschain/ide/*.json\n (default: auto inside an IDE integrated\n terminal)\n --no-ide Disable IDE bridge auto-connect\n --pdh Force-enable PDH bridge auto-connect:\n discover the Android app's\n device-capability MCP server via\n ~/.chainlesschain/pdh-bridge/*.json\n (default: auto when\n CHAINLESSCHAIN_PDH_PORT is set)\n --no-pdh Disable PDH bridge auto-connect\n --jetbrains Force-enable IntelliJ IDEA built-in MCP\n (IDEA >= 2025.2) as server `idea`\n (default: auto when the ChainlessChain\n JetBrains plugin injects\n CHAINLESSCHAIN_JETBRAINS_MCP_URL)\n --no-jetbrains Disable IDEA built-in MCP auto-connect\n --interactive-approvals Stream mode: confirm-tier approvals\n become approval_request/approval\n stdin-stdout events instead of failing\n closed (chat-panel UX)\n --permission-prompt-tool <tool> Defer tool approvals to an MCP tool\n (mcp__<server>__<tool>; requires\n --mcp-config) instead of headless\n fail-closed\n --remote-control Route confirm-tier approvals to paired\n mobile/web devices — prints a pairing\n URI/QR. Headless waits for the remote\n allow/deny (fail-closed on timeout);\n interactive races the terminal prompt\n (first answer wins; also\n /remote-control)\n --channels <list> Inbound channels for the interactive\n session (webhook[:port],telegram) —\n external events enter as user turns;\n webhook needs its bearer token, telegram\n needs channels.telegram.allowFrom\n --settings <file> Merge an extra\n .claude/settings.json-shaped file for\n this run: permission rules\n (allow/ask/deny) + native config\n overrides (model, env)\n --max-budget-usd <amount> Hard USD spend cap: stop the run before\n the next paid LLM call once the\n estimated cost reaches this (headless;\n uses the cc cost price table)\n --strict-mcp-config Use ONLY --mcp-config servers; ignore\n registered (cc mcp add) and IDE-bridge\n MCP for a reproducible tool surface\n --project-mcp Opt in to loading a project-scoped\n .mcp.json (default off; a checked-in\n .mcp.json can spawn commands)\n --replay-user-messages Stream-input mode: echo each accepted\n stdin user message back as a `user`\n event (transcript/correlation)\n --allow-dangerous-bypass Bypass all permission prompts in\n headless mode (DANGEROUS: auto-approves\n all tool calls) (default: false)\n -y, --yolo Alias for --allow-dangerous-bypass\n (default: false)\n --dangerously-skip-permissions Alias for --allow-dangerous-bypass\n (default: false)\n -h, --help display help for command\n",
8
+ "agent": "Usage: chainlesschain agent|a [options] [task...]\n\nStart an agentic AI session (reads/writes files, runs commands)\n\nArguments:\n task Headless task 鈥?when given (or with -p /\n piped stdin), runs non-interactively\n\nOptions:\n --model <model> Model name\n --provider <provider> LLM provider (ollama, openai,\n volcengine, deepseek, ...)\n --base-url <url> API base URL\n --api-key <key> API key\n --think [level] Enable Anthropic extended thinking\n (level: think | hard | ultra; Anthropic\n models only)\n --ultrathink Maximum Anthropic extended thinking (=\n --think ultra)\n --thinking-budget <n> Thinking token budget for legacy Claude\n models (Sonnet 4.5 / Opus 4.0-4.5 /\n older); clamped below max_tokens.\n Adaptive-thinking models ignore it (they\n use --think's effort). Requires\n --think/--ultrathink.\n --image <path> Attach an image (png/jpg/jpeg/gif/webp)\n to the prompt for a vision-capable model\n (headless; repeatable)\n --vision-model <id> Model to use when an image is attached\n (default: config llm.visionModel or\n doubao-seed-2-0-lite-260215)\n --session <id> Resume a previous agent session\n -c, --continue Resume the most recent session (no id\n needed 鈥?claude --continue parity)\n --resume [id] Resume a session by id (no id 鈫?most\n recent 鈥?claude --resume parity)\n --fork-session When resuming, branch into a NEW session\n id and leave the original untouched\n (claude --fork-session parity)\n --fork-request-id <key> Stable idempotency key for\n --fork-session retries (omit for a new\n fork each invocation)\n --add-dir <dir> Extra working directory the agent may\n read/search/edit (repeatable)\n --checkpoint Auto-snapshot the work tree before each\n mutating tool (DEFAULT inside a git\n repo; cc checkpoint restore to roll\n back)\n --no-checkpoint Disable auto-checkpointing (it is on by\n default inside git repos)\n --managed-checkpoint Checkpoint bounded mutating tools with\n Process Broker; unavailable writer\n lifetimes are reported as coverage none\n --managed-checkpoint-state <dir> Durable managed-checkpoint state\n directory (must be outside the\n workspace)\n --managed-checkpoint-exclude <path> Explicit workspace path excluded from\n managed checkpoints; repeatable and\n reported as partial coverage\n --safe-mode Run bare: disable project memory,\n settings hooks, memory recall, IDE\n context, status line and update notice\n (permission rules STAY active)\n --bare Everything --safe-mode disables PLUS\n skills, plugins and MCP/IDE auto-connect\n — minimal fast surface for scripted\n calls (explicit --mcp-config still\n loads; permission rules STAY active)\n --ephemeral No session persistence: nothing is\n written to the session store (headless;\n a --resume id still replays history\n read-only)\n --capabilities Print a machine-readable capability\n manifest (JSON: protocol version, tools,\n permission modes, exit codes) and exit\n --disable-slash-commands Interactive REPL: don't dispatch '/'\n input as slash commands — it reaches the\n model verbatim (/exit and /quit stay\n live)\n --ax-screen-reader Screen-reader friendly output: no ANSI\n colors, no in-place status line repaints\n (also CC_SCREEN_READER=1)\n --worktree Run this session in a fresh git worktree\n (isolated branch; auto-removed when the\n session changes nothing)\n --no-worktree Background Git task: explicitly share\n the current work tree (intended for\n read-only tasks; writable runs are not\n isolated)\n --unattended Enable fail-closed shell action policy\n for scheduled/event-driven runs\n --unattended-allow <classes> Comma-separated action classes\n explicitly allowed for unattended shell\n runs\n --sandbox [image] Run shell commands in an ephemeral\n Docker sandbox (network disabled by\n default)\n --sandbox-mode <mode> Sandbox posture: off | workspace-write |\n strict (explicit isolation modes fail\n closed)\n --sandbox-network Allow network access inside --sandbox\n --otlp <file> Write the agent run's OpenTelemetry\n spans (model/tool/retry) as OTLP/JSON to\n <file>\n --otlp-content Include prompt/response CONTENT in\n --otlp spans (off by default; content is\n redacted unless this is set)\n --auto-rewake When an async `asyncRewake` hook (e.g. a\n background test) fails at turn end,\n re-engage the agent to fix it (bounded\n by --max-rewakes)\n --auto-pin Force-pin the original task (first user\n turn) through compaction (ON by default;\n disable with CC_AUTO_PIN=0 or config\n context.autoPin=false)\n --max-rewakes <n> Max auto-rewake re-drives per run\n (default 1); implies --auto-rewake\n --bg, --background Start as a detached background agent and\n return its id immediately\n --agent-id <id> Agent id for scoped memory recall\n --recall-limit <n> Top-K memories to inject into system\n prompt\n --recall-query <q> Query string for startup memory recall\n --no-recall-memory Disable startup memory recall\n --vim Start the interactive REPL in vim-mode\n line editing (toggle later with /vim; or\n CC_VIM=1)\n --no-stream Disable streamed response rendering\n --no-park-on-exit Close the session-core handle on exit\n instead of parking it\n --bundle <path> Agent bundle directory (may execute\n local MCP commands from mcp.json)\n -p, --print [prompt] Headless: run one non-interactive turn\n and exit\n --output-format <fmt> Headless output: text | json |\n stream-json (default: \"text\")\n --max-turns <n> Cap agent loop iterations (headless)\n --json-schema <file> Headless structured output: final reply\n must be JSON validating against this\n schema (invalid replies retried)\n --allowed-tools <list> Comma/space-separated tool allow-list\n (headless)\n --disallowed-tools <list> Comma/space-separated tool deny-list\n (headless)\n --permission-mode <mode> manual | auto | dontAsk | default | plan\n | acceptEdits | bypassPermissions (plan\n headless-only)\n --no-file-refs Disable @path file-reference expansion\n in the prompt (headless)\n --no-slash-macros Disable /name custom-command\n (.claude/commands) expansion in the\n prompt (headless)\n --system-prompt <text> Replace the built-in system prompt\n (literal text or @file)\n --append-system-prompt <text> Append extra guidance to the system\n prompt (literal text or @file)\n --no-project-memory Skip auto-loaded project memory (cc.md /\n CLAUDE.md / AGENTS.md hierarchy,\n .chainlesschain/rules.md,\n .claude/rules/*.md) — a lean system\n prompt for token-tight surfaces (e.g.\n IDE chat). The agent can still read\n those files with tools when it needs\n them.\n --output-style <name> Apply a named output-style persona\n (.claude/output-styles/<name>.md or a\n built-in: explanatory | learning)\n --input-format <fmt> Headless input: text | stream-json\n (NDJSON user events on stdin,\n multi-turn) (default: \"text\")\n --trace-id <id> Correlation id stamped as `trace_id` on\n every stream-json output line (also read\n from CC_TRACE_ID). Lets an IDE/bridge\n trace one run across its own logs, the\n CLI, transcripts and diagnostics.\n Auto-generated per run when omitted.\n --fallback-model <model> Backup model(s) to try in order when the\n primary fails (transient error or\n model-not-found). Repeatable or\n comma-separated; up to 3. A\n `provider:model` entry (e.g.\n openai:gpt-4o) falls back\n cross-provider, using that provider's\n API key from its env var (skipped if\n unset — never reuses the primary key).\n Defaults to config llm.fallbackModels.\n --include-partial-messages Emit live assistant-text deltas as\n stream_event lines (requires\n --output-format stream-json)\n --goal [id] Bind a cc goal into the run (id, or omit\n the value to auto-resolve the active\n goal)\n --goal-assess After the run, ask the model to assess\n goal progress and persist it (opt-in;\n costs one extra completion; requires\n --goal)\n --goal-condition <spec> Session completion condition; re-drives\n outer turns until met. Prefix\n exit-zero:/file-exists:/contains:/regex:\n (deterministic) or model:<desc>\n (model-judged)\n --max-outer-turns <n> Max outer re-drive turns for\n --goal-condition (default 10, hard cap\n 100)\n --goal-max-tokens <n> Token budget across --goal-condition\n outer turns\n --goal-max-cost <usd> Cost budget (USD) across\n --goal-condition outer turns\n --goal-max-time <ms> Wall-clock budget (ms) across\n --goal-condition outer turns\n --mcp-config <file> Load ad-hoc MCP servers from a JSON file\n for this run (headless); their tools\n become callable (mcp__<server>__<tool>)\n --no-mcp Don't auto-connect MCP servers\n registered with `cc mcp add\n --auto-connect` (--mcp-config still\n loads)\n --ide Force-enable IDE bridge auto-connect:\n discover a running editor's MCP server\n via ~/.chainlesschain/ide/*.json\n (default: auto inside an IDE integrated\n terminal)\n --no-ide Disable IDE bridge auto-connect\n --pdh Force-enable PDH bridge auto-connect:\n discover the Android app's\n device-capability MCP server via\n ~/.chainlesschain/pdh-bridge/*.json\n (default: auto when\n CHAINLESSCHAIN_PDH_PORT is set)\n --no-pdh Disable PDH bridge auto-connect\n --jetbrains Force-enable IntelliJ IDEA built-in MCP\n (IDEA >= 2025.2) as server `idea`\n (default: auto when the ChainlessChain\n JetBrains plugin injects\n CHAINLESSCHAIN_JETBRAINS_MCP_URL)\n --no-jetbrains Disable IDEA built-in MCP auto-connect\n --interactive-approvals Stream mode: confirm-tier approvals\n become approval_request/approval\n stdin-stdout events instead of failing\n closed (chat-panel UX)\n --permission-prompt-tool <tool> Defer tool approvals to an MCP tool\n (mcp__<server>__<tool>; requires\n --mcp-config) instead of headless\n fail-closed\n --remote-control Route confirm-tier approvals to paired\n mobile/web devices — prints a pairing\n URI/QR. Headless waits for the remote\n allow/deny (fail-closed on timeout);\n interactive races the terminal prompt\n (first answer wins; also\n /remote-control)\n --channels <list> Inbound channels for the interactive\n session (webhook[:port],telegram) —\n external events enter as user turns;\n webhook needs its bearer token, telegram\n needs channels.telegram.allowFrom\n --settings <file> Merge an extra\n .claude/settings.json-shaped file for\n this run: permission rules\n (allow/ask/deny) + native config\n overrides (model, env)\n --max-budget-usd <amount> Hard USD spend cap: stop the run before\n the next paid LLM call once the\n estimated cost reaches this (headless;\n uses the cc cost price table)\n --observability-workspace <id> Persist a workspace scope on new session\n authority for causal reports\n --observability-team <id> Persist a team scope on new session\n authority for causal reports\n --observability-policy <id> Persist a policy scope on new session\n authority for causal reports\n --strict-mcp-config Use ONLY --mcp-config servers; ignore\n registered (cc mcp add) and IDE-bridge\n MCP for a reproducible tool surface\n --project-mcp Opt in to loading a project-scoped\n .mcp.json (default off; a checked-in\n .mcp.json can spawn commands)\n --replay-user-messages Stream-input mode: echo each accepted\n stdin user message back as a `user`\n event (transcript/correlation)\n --allow-dangerous-bypass Bypass all permission prompts in\n headless mode (DANGEROUS: auto-approves\n all tool calls) (default: false)\n -y, --yolo Alias for --allow-dangerous-bypass\n (default: false)\n --dangerously-skip-permissions Alias for --allow-dangerous-bypass\n (default: false)\n -h, --help display help for command\n",
9
9
  "agent-network": "Usage: chainlesschain agent-network|anet [options] [command]\n\nDecentralized Agent Network (Phase 24) — DID / registry / credentials / task\nrouting\n\nOptions:\n -h, --help display help for command\n\nCommands:\n config [options] Show network constants & reputation weights\n dimensions [options] List reputation dimensions\n task-statuses [options] List task lifecycle statuses\n did-create [options] Create an Agent DID (Ed25519 + DID document)\n did-resolve [options] <did> Resolve DID → DID document\n dids [options] List Agent DIDs\n did-deactivate [options] <did> Deactivate a DID (also forces registry offline)\n sign [options] <did> <data> Sign data with agent's Ed25519 key\n verify [options] <did> <data> <signature> Verify a signature from an agent\n register [options] <did> <orgId> Register an Agent in the federated registry\n unregister [options] <did> Remove an Agent from the registry\n heartbeat [options] <did> Bump last_heartbeat (forces online)\n discover [options] Discover agents (capability / org / status)\n sweep [options] Mark stale online agents offline\n peer-add [options] <peerId> Add/update a Kademlia peer (k-bucket auto-computed)\n peer-remove [options] <peerId> Remove a peer\n peers [options] List peers (optionally by k-bucket)\n auth-start [options] <did> Issue an auth challenge for a DID\n auth-complete [options] <sessionId> <signature> Complete auth with signature over challenge\n auth-validate [options] <token> Validate a session token (returns agentDid or exits 1)\n auth-sessions [options] List auth sessions\n credential-issue [options] <issuerDid> <subjectDid> Issue a VC with HMAC/Ed25519 proof\n credential-verify [options] <id> Verify a VC (signature + expiry + revocation)\n credential-revoke [options] <id> Revoke a credential\n credential-show [options] <id> Show a credential\n credentials [options] List credentials (filter by subject/issuer/status/type)\n task-route [options] <sourceOrg> <taskType> Route task → pick best-rep agent matching capability\n task-show [options] <taskId> Show a task\n task-status [options] <taskId> <status> Update task status (terminal states set completedAt)\n task-cancel [options] <taskId> Cancel a task (sets CANCELLED + reason)\n tasks [options] List tasks\n rep-update [options] <did> <dimension> <score> Record a reputation observation\n rep-show [options] <did> Show reputation summary (weighted total + per-dim avg)\n rep-history [options] <did> Show reputation history (newest first)\n rep-top [options] Top agents by dimension (or total)\n stats [options] Network-level statistics\n agent-maturities-v2 List V2 agent maturity states\n task-lifecycles-v2 List V2 task lifecycle states\n stats-v2 V2 agent-network stats\n get-max-active-agents-v2 Get max active agents per network (V2)\n set-max-active-agents-v2 <n> Set max active agents per network (V2)\n get-max-pending-tasks-v2 Get max pending tasks per agent (V2)\n set-max-pending-tasks-v2 <n> Set max pending tasks per agent (V2)\n get-agent-idle-ms-v2 Get agent idle threshold (V2)\n set-agent-idle-ms-v2 <ms> Set agent idle threshold (V2)\n get-task-stuck-ms-v2 Get task stuck threshold (V2)\n set-task-stuck-ms-v2 <ms> Set task stuck threshold (V2)\n active-agent-count-v2 <networkId> Active agent count for network (V2)\n pending-task-count-v2 <agentId> Pending task count for agent (V2)\n register-agent-v2 [options] <id> Register a V2 agent\n get-agent-v2 <id> Get a V2 agent\n list-agents-v2 [options] List V2 agents\n set-agent-status-v2 <id> <next> Set V2 agent status\n activate-agent-v2 <id> Activate a V2 agent\n suspend-agent-v2 <id> Suspend a V2 agent\n revoke-agent-v2 <id> Revoke a V2 agent\n touch-agent-v2 <id> Touch a V2 agent\n create-task-v2 [options] <id> Create a V2 task\n get-task-v2 <id> Get a V2 task\n list-tasks-v2 [options] List V2 tasks\n set-task-status-v2 <id> <next> Set V2 task status\n start-task-v2 <id> Start a V2 task\n complete-task-v2 <id> Complete a V2 task\n fail-task-v2 <id> Fail a V2 task\n cancel-task-v2 <id> Cancel a V2 task\n auto-suspend-idle-agents-v2 Auto-suspend idle V2 agents\n auto-fail-stuck-tasks-v2 Auto-fail stuck V2 tasks\n help [command] display help for command\n",
10
10
  "agents": "Usage: chainlesschain agents [options] [command]\n\nUser-defined subagents (.claude/agents/*.md)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n background|bg [options] List background agent sessions\n logs [options] <id> Print recent output from a background agent\n view [options] <id> Show a detailed background agent view\n stop [options] <id> Stop a running background agent\n rename [options] <id> <title...> Rename a background agent session\n list|ls [options] List discovered subagents (project +\n personal)\n show [options] <name> Show an agent's metadata + system prompt\n run [options] <name> [task...] Run a task headlessly as the named subagent\n new [options] <name> Scaffold a new agent file (project-native\n .chainlesschain/agents/)\n help [command] display help for command\n",
11
11
  "android": "Usage: chainlesschain android [options] [command]\n\nAndroid-native bridge: ContentResolver / SAF / Accessibility / Shizuku / root\n(Plan A A7)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n caps [options] Probe what bridge capabilities are available on this\n device\n contacts ContentResolver: contacts\n sms ContentResolver: SMS\n calls ContentResolver: call log\n app PackageManager: app inventory + Intent\n fs SAF / sandbox filesystem\n a11y Accessibility Service\n shizuku Shizuku ADB-like privileges\n root Magisk root su\n perms [options] <name> Check (and request) a runtime permission\n help [command] display help for command\n",
@@ -14,10 +14,10 @@
14
14
  "attach": "Usage: chainlesschain attach [options] <id>\n\nAttach to a background agent — interactive when its session transport is\navailable, log stream otherwise\n\nOptions:\n -n, --lines <n> Initial lines to print (default: \"100\")\n --no-follow Print the initial log tail and exit\n --no-input Log stream only; never send prompts\n -h, --help display help for command\n",
15
15
  "audit": "Usage: chainlesschain audit [options] [command]\n\nAudit log — security event tracking and compliance\n\nOptions:\n -h, --help display help for command\n\nCommands:\n log [options] Show recent audit events\n search [options] <query> Search audit logs\n stats [options] Show audit statistics\n export [options] Export audit logs to file\n purge [options] Delete old audit logs\n types List available event types and risk levels\n log-statuses-v2 List V2 log lifecycle states\n integrity-statuses-v2 List V2 integrity states\n alert-statuses-v2 List V2 alert lifecycle states\n event-types-v2 List V2 event types\n risk-levels-v2 List V2 risk levels\n default-max-alerts-per-actor Show default max alerts per actor\n max-alerts-per-actor Show current max alerts per actor\n set-max-alerts-per-actor <n> Update max alerts per actor\n default-archive-retention-ms Show default archive retention\n archive-retention-ms Show current archive retention\n set-archive-retention-ms <ms> Update archive retention (ms)\n default-purge-retention-ms Show default purge retention\n purge-retention-ms Show current purge retention\n set-purge-retention-ms <ms> Update purge retention (ms)\n open-alert-count [options] Count OPEN alerts (optionally scoped to actor)\n log-event-v2 [options] <log-id> V2: register a hash-chained log entry\n log-status-v2 <log-id> V2: show log status + integrity\n set-log-status-v2 [options] <log-id> <status> V2: transition log status (active|archived|purged)\n verify-chain-v2 V2: re-hash the chain and mark each entry verified/corrupted\n auto-archive-logs V2: bulk-flip stale ACTIVE logs → ARCHIVED\n auto-purge-logs V2: bulk-flip stale ARCHIVED logs → PURGED\n alert-status-v2 <alert-id> V2: show alert status\n set-alert-status-v2 [options] <alert-id> <status> V2: transition alert status (open|acknowledged|resolved|dismissed)\n acknowledge-alert [options] <alert-id> V2: shortcut → acknowledged\n resolve-alert [options] <alert-id> V2: shortcut → resolved\n dismiss-alert [options] <alert-id> V2: shortcut → dismissed\n stats-v2 V2: all-enum-key stats snapshot\n mtc Audit MTC double-track (Phase 2 scaffolding, default disabled)\n help [command] display help for command\n",
16
16
  "auth": "Usage: chainlesschain auth [options] [command]\n\nRBAC permission management\n\nOptions:\n -h, --help display help for command\n\nCommands:\n roles [options] List all roles\n create-role [options] <name> Create a custom role\n delete-role [options] <name> Delete a custom role\n grant [options] <user-did> <role> Grant a role to a user\n revoke <user-did> <role> Revoke a role from a user\n grant-permission <user-did> <permission> Grant a direct permission to a user\n revoke-permission <user-did> <permission> Revoke a direct permission from a user\n check [options] <user-did> <permission> Check if a user has a specific permission\n permissions [options] <user-did> Show all permissions for a user\n users [options] List all users with role assignments\n scopes List all available permission scopes\n help [command] display help for command\n",
17
- "auto": "Usage: chainlesschain auto [options] [command]\n\nWorkflow automation engine — 12 SaaS connectors + triggers (Phase 96)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n connectors [options] List 12 built-in SaaS connectors\n trigger-types [options] List trigger types\n statuses List flow and execution statuses\n config [options] Show automation engine config\n create [options] Create a flow\n flows [options] List flows\n show [options] <flowId> Show flow detail\n activate <flowId> Set flow status = active\n pause <flowId> Set flow status = paused\n archive <flowId> Set flow status = archived\n delete <flowId> Delete a flow (cascades triggers + executions)\n schedule [options] <flowId> Set flow cron schedule\n share [options] <flowId> Record flow share to another org\n templates [options] List built-in flow templates\n import-template [options] <templateId> Import a built-in template as a flow\n add-trigger [options] <flowId> Add a trigger to a flow\n triggers [options] [flowId] List triggers (optionally scoped to a flow)\n enable-trigger <triggerId> Enable a trigger\n disable-trigger <triggerId> Disable a trigger\n fire-trigger [options] <triggerId> Simulate trigger firing (executes flow)\n execute [options] <flowId> Manually execute a flow (simulated)\n exec-show [options] <execId> Show execution detail\n logs [options] List executions\n stats [options] Show automation engine stats\n automation-maturities-v2 List V2 automation maturity states\n execution-lifecycles-v2 List V2 execution lifecycle states\n stats-v2 V2 automation engine stats\n get-max-active-automations-v2 Get max active automations per owner (V2)\n set-max-active-automations-v2 <n> Set max active automations per owner (V2)\n get-max-running-executions-v2 Get max running executions per automation (V2)\n set-max-running-executions-v2 <n> Set max running executions per automation (V2)\n get-automation-idle-ms-v2 Get automation idle threshold (V2)\n set-automation-idle-ms-v2 <ms> Set automation idle threshold (V2)\n get-execution-stuck-ms-v2 Get execution stuck threshold (V2)\n set-execution-stuck-ms-v2 <ms> Set execution stuck threshold (V2)\n active-automation-count-v2 <ownerId> Active automation count for owner (V2)\n running-execution-count-v2 <automationId> Running execution count for automation (V2)\n register-automation-v2 [options] <id> Register a V2 automation\n get-automation-v2 <id> Get a V2 automation\n list-automations-v2 [options] List V2 automations\n set-automation-status-v2 <id> <next> Set V2 automation status\n activate-automation-v2 <id> Activate a V2 automation\n pause-automation-v2 <id> Pause a V2 automation\n retire-automation-v2 <id> Retire a V2 automation\n touch-automation-v2 <id> Touch a V2 automation\n create-execution-v2 [options] <id> Create a V2 execution\n get-execution-v2 <id> Get a V2 execution\n list-executions-v2 [options] List V2 executions\n set-execution-status-v2 <id> <next> Set V2 execution status\n start-execution-v2 <id> Start a V2 execution\n succeed-execution-v2 <id> Succeed a V2 execution\n fail-execution-v2 <id> Fail a V2 execution\n cancel-execution-v2 <id> Cancel a V2 execution\n auto-pause-idle-automations-v2 Auto-pause idle V2 automations\n auto-fail-stuck-executions-v2 Auto-fail stuck V2 executions\n help [command] display help for command\n",
17
+ "auto": "Usage: chainlesschain auto [options] [command]\n\nWorkflow automation engine — 12 SaaS connectors + triggers (Phase 96)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n connectors [options] List 12 built-in SaaS connectors\n trigger-types [options] List trigger types\n statuses List flow and execution statuses\n config [options] Show automation engine config\n create [options] Create a flow\n flows [options] List flows\n center-projection [options] Emit the versioned Automation Center projection for IDEs\n center-routine-create [options] Create a revision-gated Routine from JSON stdin\n center-routine-edit [options] <routineId> Edit a revision-gated Routine from JSON stdin\n center-routine-action [options] <routineId> <action> Run a revision-gated Routine action\n center-action [options] <flowId> <action> Run a revision-gated Automation Center action\n show [options] <flowId> Show flow detail\n activate <flowId> Set flow status = active\n pause <flowId> Set flow status = paused\n archive <flowId> Set flow status = archived\n delete <flowId> Delete a flow (cascades triggers + executions)\n schedule [options] <flowId> Set flow cron schedule\n run-scheduled [options] Run due cron flows through the durable scheduler kernel\n set-execution-budget [options] <flowId> Set the durable unattended-execution budget for a flow\n execution-preflight [options] <flowId> Check live RBAC connector permissions and durable budget availability\n share [options] <flowId> Record flow share to another org\n templates [options] List built-in flow templates\n import-template [options] <templateId> Import a built-in template as a flow\n add-trigger [options] <flowId> Add a trigger to a flow\n triggers [options] [flowId] List triggers (optionally scoped to a flow)\n enable-trigger <triggerId> Enable a trigger\n disable-trigger <triggerId> Disable a trigger\n fire-trigger [options] <triggerId> Simulate trigger firing (executes flow)\n dispatch-channel-event [options] Dispatch one durable, scope-checked webhook or Telegram event\n execute [options] <flowId> Manually execute a flow (simulated)\n exec-show [options] <execId> Show execution detail\n logs [options] List executions\n stats [options] Show automation engine stats\n automation-maturities-v2 List V2 automation maturity states\n execution-lifecycles-v2 List V2 execution lifecycle states\n stats-v2 V2 automation engine stats\n get-max-active-automations-v2 Get max active automations per owner (V2)\n set-max-active-automations-v2 <n> Set max active automations per owner (V2)\n get-max-running-executions-v2 Get max running executions per automation (V2)\n set-max-running-executions-v2 <n> Set max running executions per automation (V2)\n get-automation-idle-ms-v2 Get automation idle threshold (V2)\n set-automation-idle-ms-v2 <ms> Set automation idle threshold (V2)\n get-execution-stuck-ms-v2 Get execution stuck threshold (V2)\n set-execution-stuck-ms-v2 <ms> Set execution stuck threshold (V2)\n active-automation-count-v2 <ownerId> Active automation count for owner (V2)\n running-execution-count-v2 <automationId> Running execution count for automation (V2)\n register-automation-v2 [options] <id> Register a V2 automation\n get-automation-v2 <id> Get a V2 automation\n list-automations-v2 [options] List V2 automations\n set-automation-status-v2 <id> <next> Set V2 automation status\n activate-automation-v2 <id> Activate a V2 automation\n pause-automation-v2 <id> Pause a V2 automation\n retire-automation-v2 <id> Retire a V2 automation\n touch-automation-v2 <id> Touch a V2 automation\n create-execution-v2 [options] <id> Create a V2 execution\n get-execution-v2 <id> Get a V2 execution\n list-executions-v2 [options] List V2 executions\n set-execution-status-v2 <id> <next> Set V2 execution status\n start-execution-v2 <id> Start a V2 execution\n succeed-execution-v2 <id> Succeed a V2 execution\n fail-execution-v2 <id> Fail a V2 execution\n cancel-execution-v2 <id> Cancel a V2 execution\n auto-pause-idle-automations-v2 Auto-pause idle V2 automations\n auto-fail-stuck-executions-v2 Auto-fail stuck V2 executions\n help [command] display help for command\n",
18
18
  "auto-mode": "Usage: chainlesschain auto-mode|automode [options] [command]\n\nInspect auto permission-mode defaults and effective config\n\nOptions:\n -h, --help display help for command\n\nCommands:\n defaults Print built-in auto-mode classification defaults as JSON\n config [options] Print the effective auto-mode config\n eval [options] Run the offline dangerous-operation classifier corpus and\n CI gate\n help [command] display help for command\n",
19
19
  "autoagent": "Usage: chainlesschain autoagent [options] [command]\n\nAutonomous agent V2 governance\n\nOptions:\n -h, --help display help for command\n\nCommands:\n enums-v2\n config-v2\n set-max-active-v2 <n>\n set-max-pending-v2 <n>\n set-idle-ms-v2 <n>\n set-stuck-ms-v2 <n>\n register-agent-v2 [options] <id> <owner>\n activate-agent-v2 <id>\n pause-agent-v2 <id>\n archive-agent-v2 <id>\n touch-agent-v2 <id>\n get-agent-v2 <id>\n list-agents-v2\n create-run-v2 [options] <id> <agentId>\n start-run-v2 <id>\n complete-run-v2 <id>\n fail-run-v2 <id> [reason]\n cancel-run-v2 <id> [reason]\n get-run-v2 <id>\n list-runs-v2\n auto-pause-idle-v2\n auto-fail-stuck-v2\n gov-stats-v2\n reset-state-v2\n help [command] display help for command\n",
20
- "automation": "Usage: chainlesschain automation [options] [command]\n\nWorkflow automation engine — 12 SaaS connectors + triggers (Phase 96)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n connectors [options] List 12 built-in SaaS connectors\n trigger-types [options] List trigger types\n statuses List flow and execution statuses\n config [options] Show automation engine config\n create [options] Create a flow\n flows [options] List flows\n show [options] <flowId> Show flow detail\n activate <flowId> Set flow status = active\n pause <flowId> Set flow status = paused\n archive <flowId> Set flow status = archived\n delete <flowId> Delete a flow (cascades triggers + executions)\n schedule [options] <flowId> Set flow cron schedule\n share [options] <flowId> Record flow share to another org\n templates [options] List built-in flow templates\n import-template [options] <templateId> Import a built-in template as a flow\n add-trigger [options] <flowId> Add a trigger to a flow\n triggers [options] [flowId] List triggers (optionally scoped to a flow)\n enable-trigger <triggerId> Enable a trigger\n disable-trigger <triggerId> Disable a trigger\n fire-trigger [options] <triggerId> Simulate trigger firing (executes flow)\n execute [options] <flowId> Manually execute a flow (simulated)\n exec-show [options] <execId> Show execution detail\n logs [options] List executions\n stats [options] Show automation engine stats\n automation-maturities-v2 List V2 automation maturity states\n execution-lifecycles-v2 List V2 execution lifecycle states\n stats-v2 V2 automation engine stats\n get-max-active-automations-v2 Get max active automations per owner (V2)\n set-max-active-automations-v2 <n> Set max active automations per owner (V2)\n get-max-running-executions-v2 Get max running executions per automation (V2)\n set-max-running-executions-v2 <n> Set max running executions per automation (V2)\n get-automation-idle-ms-v2 Get automation idle threshold (V2)\n set-automation-idle-ms-v2 <ms> Set automation idle threshold (V2)\n get-execution-stuck-ms-v2 Get execution stuck threshold (V2)\n set-execution-stuck-ms-v2 <ms> Set execution stuck threshold (V2)\n active-automation-count-v2 <ownerId> Active automation count for owner (V2)\n running-execution-count-v2 <automationId> Running execution count for automation (V2)\n register-automation-v2 [options] <id> Register a V2 automation\n get-automation-v2 <id> Get a V2 automation\n list-automations-v2 [options] List V2 automations\n set-automation-status-v2 <id> <next> Set V2 automation status\n activate-automation-v2 <id> Activate a V2 automation\n pause-automation-v2 <id> Pause a V2 automation\n retire-automation-v2 <id> Retire a V2 automation\n touch-automation-v2 <id> Touch a V2 automation\n create-execution-v2 [options] <id> Create a V2 execution\n get-execution-v2 <id> Get a V2 execution\n list-executions-v2 [options] List V2 executions\n set-execution-status-v2 <id> <next> Set V2 execution status\n start-execution-v2 <id> Start a V2 execution\n succeed-execution-v2 <id> Succeed a V2 execution\n fail-execution-v2 <id> Fail a V2 execution\n cancel-execution-v2 <id> Cancel a V2 execution\n auto-pause-idle-automations-v2 Auto-pause idle V2 automations\n auto-fail-stuck-executions-v2 Auto-fail stuck V2 executions\n help [command] display help for command\n",
20
+ "automation": "Usage: chainlesschain automation [options] [command]\n\nWorkflow automation engine — 12 SaaS connectors + triggers (Phase 96)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n connectors [options] List 12 built-in SaaS connectors\n trigger-types [options] List trigger types\n statuses List flow and execution statuses\n config [options] Show automation engine config\n create [options] Create a flow\n flows [options] List flows\n center-projection [options] Emit the versioned Automation Center projection for IDEs\n center-routine-create [options] Create a revision-gated Routine from JSON stdin\n center-routine-edit [options] <routineId> Edit a revision-gated Routine from JSON stdin\n center-routine-action [options] <routineId> <action> Run a revision-gated Routine action\n center-action [options] <flowId> <action> Run a revision-gated Automation Center action\n show [options] <flowId> Show flow detail\n activate <flowId> Set flow status = active\n pause <flowId> Set flow status = paused\n archive <flowId> Set flow status = archived\n delete <flowId> Delete a flow (cascades triggers + executions)\n schedule [options] <flowId> Set flow cron schedule\n run-scheduled [options] Run due cron flows through the durable scheduler kernel\n set-execution-budget [options] <flowId> Set the durable unattended-execution budget for a flow\n execution-preflight [options] <flowId> Check live RBAC connector permissions and durable budget availability\n share [options] <flowId> Record flow share to another org\n templates [options] List built-in flow templates\n import-template [options] <templateId> Import a built-in template as a flow\n add-trigger [options] <flowId> Add a trigger to a flow\n triggers [options] [flowId] List triggers (optionally scoped to a flow)\n enable-trigger <triggerId> Enable a trigger\n disable-trigger <triggerId> Disable a trigger\n fire-trigger [options] <triggerId> Simulate trigger firing (executes flow)\n dispatch-channel-event [options] Dispatch one durable, scope-checked webhook or Telegram event\n execute [options] <flowId> Manually execute a flow (simulated)\n exec-show [options] <execId> Show execution detail\n logs [options] List executions\n stats [options] Show automation engine stats\n automation-maturities-v2 List V2 automation maturity states\n execution-lifecycles-v2 List V2 execution lifecycle states\n stats-v2 V2 automation engine stats\n get-max-active-automations-v2 Get max active automations per owner (V2)\n set-max-active-automations-v2 <n> Set max active automations per owner (V2)\n get-max-running-executions-v2 Get max running executions per automation (V2)\n set-max-running-executions-v2 <n> Set max running executions per automation (V2)\n get-automation-idle-ms-v2 Get automation idle threshold (V2)\n set-automation-idle-ms-v2 <ms> Set automation idle threshold (V2)\n get-execution-stuck-ms-v2 Get execution stuck threshold (V2)\n set-execution-stuck-ms-v2 <ms> Set execution stuck threshold (V2)\n active-automation-count-v2 <ownerId> Active automation count for owner (V2)\n running-execution-count-v2 <automationId> Running execution count for automation (V2)\n register-automation-v2 [options] <id> Register a V2 automation\n get-automation-v2 <id> Get a V2 automation\n list-automations-v2 [options] List V2 automations\n set-automation-status-v2 <id> <next> Set V2 automation status\n activate-automation-v2 <id> Activate a V2 automation\n pause-automation-v2 <id> Pause a V2 automation\n retire-automation-v2 <id> Retire a V2 automation\n touch-automation-v2 <id> Touch a V2 automation\n create-execution-v2 [options] <id> Create a V2 execution\n get-execution-v2 <id> Get a V2 execution\n list-executions-v2 [options] List V2 executions\n set-execution-status-v2 <id> <next> Set V2 execution status\n start-execution-v2 <id> Start a V2 execution\n succeed-execution-v2 <id> Succeed a V2 execution\n fail-execution-v2 <id> Fail a V2 execution\n cancel-execution-v2 <id> Cancel a V2 execution\n auto-pause-idle-automations-v2 Auto-pause idle V2 automations\n auto-fail-stuck-executions-v2 Auto-fail stuck V2 executions\n help [command] display help for command\n",
21
21
  "batch": "Usage: chainlesschain batch [options]\n\nSplit a large change into independent units, run each in its own git worktree\nin parallel, and aggregate results\n\nOptions:\n --units <file> Units JSON file ({ units: [{key, prompt, test?}]\n })\n --decompose <goal> Ask an agent to split this goal into units first\n (structured output)\n --parts <n> Target number of units for --decompose (default:\n \"6\")\n --plan-only With --decompose: print the units and exit (no\n run)\n --concurrency <n> Max worktrees running at once (default: \"4\")\n --test <cmd> Default test command run in each worktree\n --merge Merge clean, passing branches back to base\n --model <model> Model for agent runs\n --permission-mode <mode> Permission mode for each agent unit (default:\n \"acceptEdits\")\n --max-turns <n> Per-unit agent turn cap\n --max-budget-usd <amount> Per-unit agent cost cap\n --json Machine-readable JSON output\n -h, --help display help for command\n",
22
22
  "bi": "Usage: chainlesschain bi [options] [command]\n\nBusiness intelligence — queries, dashboards, reports, analytics\n\nOptions:\n -h, --help display help for command\n\nCommands:\n query [options] <question> Natural-language query (NL→SQL)\n dashboard [options] <name> Create a dashboard\n report [options] <name> Generate a report\n schedule [options] <report-id> <cron> Schedule a report for recurring generation\n anomaly [options] Detect anomalies in data using Z-score\n predict [options] Predict trend using linear regression\n chart-types [options] List supported chart types (V2)\n anomaly-methods [options] List supported anomaly detection methods (V2)\n report-formats [options] List supported report formats (V2)\n report-statuses [options] List canonical report statuses (V2)\n dashboard-layouts [options] List supported dashboard layouts (V2)\n query-v2 [options] <question> Heuristic NL→SQL with intent detection (V2)\n anomaly-v2 [options] Anomaly detection with method choice (V2)\n predict-v2 [options] Trend prediction with r² confidence (V2)\n recommend-chart [options] Recommend chart type from intent or data shape (V2)\n dashboard-v2 [options] <name> Create dashboard with validated layout (V2)\n set-report-status [options] <report-id> <status> Update report status with validated transition (V2)\n report-status [options] <report-id> Show current report status (V2)\n report-history [options] <report-id> Show report status transition history (V2)\n stats-v2 [options] BI platform statistics (V2)\n templates [options] List available BI templates\n enums-v2 Show V2 enums\n register-dataset-v2 [options] Register a BI dataset profile (pending)\n activate-dataset-v2 <id> Activate dataset\n stale-dataset-v2 <id> Mark dataset stale\n archive-dataset-v2 <id> Archive dataset (terminal)\n touch-dataset-v2 <id> Refresh lastTouchedAt\n get-dataset-v2 <id> Get dataset\n list-datasets-v2 List datasets\n create-query-v2 [options] Create a BI query (queued)\n start-query-v2 <id> Transition query to running\n complete-query-v2 <id> Transition query to completed\n fail-query-v2 [options] <id> Fail query\n cancel-query-v2 [options] <id> Cancel query\n get-query-v2 <id> Get query\n list-queries-v2 List queries\n set-max-active-datasets-v2 <n> Set per-owner active cap\n set-max-pending-queries-v2 <n> Set per-dataset pending cap\n set-dataset-idle-ms-v2 <n> Set idle threshold\n set-query-stuck-ms-v2 <n> Set stuck threshold\n auto-stale-idle-datasets-v2 Auto-stale idle datasets\n auto-fail-stuck-queries-v2 Auto-fail stuck running queries\n gov-stats-v2 V2 governance aggregate stats\n help [command] display help for command\n",
23
23
  "bm25": "Usage: chainlesschain bm25 [options] [command]\n\nBM25 Search V2 governance (in-memory, CLI v0.143.0)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n enums-v2\n register-profile-v2 [options]\n activate-profile-v2 <id>\n stale-profile-v2 <id>\n archive-profile-v2 <id>\n touch-profile-v2 <id>\n get-profile-v2 <id>\n list-profiles-v2\n create-query-v2 [options]\n searching-query-v2 <id>\n complete-query-v2 <id>\n fail-query-v2 [options] <id>\n cancel-query-v2 [options] <id>\n get-query-v2 <id>\n list-queries-v2\n config-v2\n set-max-active-profiles-v2 <n>\n set-max-pending-queries-v2 <n>\n set-profile-idle-ms-v2 <ms>\n set-query-stuck-ms-v2 <ms>\n auto-stale-idle-v2\n auto-fail-stuck-v2\n gov-stats-v2\n help [command] display help for command\n",
@@ -42,7 +42,7 @@
42
42
  "cost": "Usage: chainlesschain cost [options] [id]\n\nEstimated $ cost from recorded token usage (per-session or global)\n\nArguments:\n id Session ID (omit for global rollup)\n\nOptions:\n --json Output as JSON\n --limit <n> Max sessions for global rollup (default: \"1000\")\n -h, --help display help for command\n",
43
43
  "cowork": "Usage: chainlesschain cowork [options] [command]\n\nMulti-agent collaboration (debate review, A/B comparison, analysis)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n debate [options] <file-or-topic> Multi-agent debate review of a file or topic\n compare [options] <prompt> Generate and compare multiple solution variants\n analyze [options] <path> Analyze code structure, style, or knowledge graph\n template Cowork template marketplace (search/install/publish via EvoMap)\n cron Schedule Cowork tasks on a cron expression\n share Export/import signed Cowork packets (templates or task results)\n workflow Define and execute multi-step Cowork workflows (DAG)\n observe Aggregate view over Cowork history, workflows, and schedules\n learning Analyze Cowork history for stats, recommendations, failures\n status Show cowork collaboration status\n coord-agent-maturities-v2 List coord agent maturity states (V2)\n coord-assignment-lifecycle-v2 List coord assignment lifecycle states (V2)\n coord-stats-v2 Show agent-coordinator V2 stats\n coord-config-v2 Show agent-coordinator V2 config\n coord-register-agent-v2 <id> <owner> Register a coord agent (V2)\n coord-activate-agent-v2 <id> Activate a coord agent (V2)\n coord-idle-agent-v2 <id> Mark coord agent as idle (V2)\n coord-retire-agent-v2 <id> Retire a coord agent (V2)\n coord-touch-agent-v2 <id> Touch a coord agent (V2)\n coord-get-agent-v2 <id> Get a coord agent (V2)\n coord-list-agents-v2 List coord agents (V2)\n coord-create-assignment-v2 <id> <agentId> Create a coord assignment (V2)\n coord-dispatch-assignment-v2 <id> Dispatch a coord assignment (V2)\n coord-complete-assignment-v2 <id> Complete a coord assignment (V2)\n coord-fail-assignment-v2 <id> [reason] Fail a coord assignment (V2)\n coord-cancel-assignment-v2 <id> [reason] Cancel a coord assignment (V2)\n coord-get-assignment-v2 <id> Get a coord assignment (V2)\n coord-list-assignments-v2 List coord assignments (V2)\n coord-auto-idle-agents-v2 Auto-idle coord agents (V2)\n coord-auto-fail-stuck-assignments-v2 Auto-fail stuck coord assignments (V2)\n coord-set-max-active-agents-v2 <n> Set max active coord agents per owner (V2)\n coord-set-max-pending-assignments-v2 <n> Set max pending coord assignments per agent (V2)\n coord-set-agent-idle-ms-v2 <n> Set coord agent idle timeout ms (V2)\n coord-set-assignment-stuck-ms-v2 <n> Set coord assignment stuck timeout ms (V2)\n coord-reset-state-v2 Reset agent-coordinator V2 in-memory state\n runner-enums-v2 [options] List Runner V2 enums\n runner-config-set-v2 [options] Set Runner V2 caps/thresholds\n runner-register-profile-v2 [options] <id> Register Runner V2 profile\n runner-activate-profile-v2 <id> Activate Runner V2 profile\n runner-pause-profile-v2 <id> Pause Runner V2 profile\n runner-retire-profile-v2 <id> Retire Runner V2 profile\n runner-touch-profile-v2 <id> Touch Runner V2 profile\n runner-get-profile-v2 <id> Get Runner V2 profile\n runner-list-profiles-v2 List Runner V2 profiles\n runner-create-exec-v2 [options] <id> Create Runner V2 exec\n runner-start-exec-v2 <id> Start Runner V2 exec\n runner-succeed-exec-v2 <id> Succeed Runner V2 exec\n runner-fail-exec-v2 [options] <id> Fail Runner V2 exec\n runner-cancel-exec-v2 [options] <id> Cancel Runner V2 exec\n runner-get-exec-v2 <id> Get Runner V2 exec\n runner-list-execs-v2 List Runner V2 execs\n runner-auto-pause-profiles-v2 Auto-pause idle Runner V2 profiles\n runner-auto-fail-execs-v2 Auto-fail stuck Runner V2 execs\n runner-gov-stats-v2 [options] Runner V2 governance stats\n help [command] display help for command\n",
44
44
  "crosschain": "Usage: chainlesschain crosschain [options] [command]\n\nCross-chain interoperability (Phase 89)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n chains [options] List supported chains\n bridge-statuses [options] List bridge statuses\n swap-statuses [options] List swap statuses\n bridge [options] <from-chain> <to-chain> <amount> Bridge asset between chains\n bridge-consume [options] <proposalId> Finalize a multisig-gated bridge after threshold reached — performs the SQLite insert and marks proposal consumed\n bridge-status [options] <bridge-id> <status> Update bridge status\n bridge-show [options] <bridge-id> Show bridge details\n bridges [options] List bridge transactions\n swap [options] <from-chain> <to-chain> <amount> Initiate HTLC atomic swap\n swap-claim [options] <swap-id> Claim a swap with secret\n swap-refund [options] <swap-id> Refund a swap\n swap-show [options] <swap-id> Show swap details\n swap-secret [options] <swap-id> Reveal swap secret (only after claim)\n swaps [options] List swaps\n send [options] <from-chain> <to-chain> Send cross-chain message\n msg-status [options] <message-id> <status> Update message status\n msg-show [options] <message-id> Show message details\n messages [options] List cross-chain messages\n estimate-fee [options] <from-chain> <to-chain> <amount> Estimate cross-chain bridge fee\n stats [options] Cross-chain statistics\n mtc-status [options] Show cross-chain bridge MTC config + trust anchors + batches\n mtc-serve [options] Run a daemon that periodically closes staged bridge ops into batches\n mtc-batch [options] Close currently-staged bridge ops into batches (one per chain-pair)\n mtc-envelope [options] Build a bridge MTC envelope from a JSON file of bridge ops\n mtc-verify [options] <envelope-path> <landmark-path> Verify a bridge MTC envelope against a landmark file\n mtc-multihop-build [options] Build a multi-hop bridge envelope from a JSON file of leg envelopes\n mtc-multihop-verify [options] <wrapper-path> Verify a multi-hop bridge envelope against per-leg landmark files\n mtc-gas-check [options] <target-chain> Heuristic: should the bridge MTCA close its batch now given current gas + staged ops?\n mtc-sla [options] Emit cc sla-compatible operational metrics for the bridge MTCA\n mtc-trust-anchor Manage Independent-mode trust anchors (per source chain)\n bridge-statuses-v2 [options] List V2 bridge statuses\n swap-statuses-v2 [options] List V2 swap statuses\n message-statuses-v2 [options] List V2 message statuses\n chain-ids-v2 [options] List V2 chain IDs\n default-max-active-bridges Show default max active bridges per address\n max-active-bridges Show current max active bridges per address\n active-bridge-count [address] Active (non-terminal) bridge count, optionally by address\n set-max-active-bridges <n> Set max active bridges per address (positive integer)\n configure-chain [options] <chain-id> Configure a supported chain (rpcUrl, contract, enabled)\n chain-config [options] <chain-id> Show chain config (or 'not configured')\n list-chains-v2 [options] List chains enriched with V2 config\n bridge-v2 [options] <from-chain> <to-chain> <amount> Create a bridge (V2: throws on error, enforces per-address cap)\n set-bridge-status [options] <bridge-id> <status> Set bridge status with state-machine guard\n set-swap-status [options] <swap-id> <status> Set swap status with state-machine guard\n set-message-status [options] <message-id> <status> Set message status with state-machine guard\n auto-expire-swaps [options] Bulk-flip past-deadline swaps to EXPIRED\n stats-v2 [options] V2 cross-chain statistics (all-enum-key)\n enums-v2 Show V2 governance enums\n register-channel-v2 [options] Register an xchain channel profile (pending)\n activate-channel-v2 <id> Activate channel\n pause-channel-v2 <id> Pause channel\n decommission-channel-v2 <id> Decommission channel (terminal)\n touch-channel-v2 <id> Refresh lastTouchedAt\n get-channel-v2 <id> Get channel\n list-channels-v2 List channels\n create-transfer-v2 [options] Create an xchain transfer (queued)\n start-transfer-v2 <id> Transition transfer to relaying\n confirm-transfer-v2 <id> Transition transfer to confirmed\n fail-transfer-v2 [options] <id> Fail transfer\n cancel-transfer-v2 [options] <id> Cancel transfer\n get-transfer-v2 <id> Get transfer\n list-transfers-v2 List transfers\n set-max-active-channels-v2 <n> Set per-owner active cap\n set-max-pending-transfers-v2 <n> Set per-channel pending cap\n set-channel-idle-ms-v2 <n> Set idle threshold\n set-transfer-stuck-ms-v2 <n> Set stuck threshold\n auto-pause-idle-channels-v2 Auto-pause idle channels\n auto-fail-stuck-transfers-v2 Auto-fail stuck relaying transfers\n gov-stats-v2 V2 governance aggregate stats\n help [command] display help for command\n",
45
- "daemon": "Usage: chainlesschain daemon [options] [command]\n\nInspect and stop background agent supervisor sessions\n\nOptions:\n -h, --help display help for command\n\nCommands:\n status [options] Show background agent supervisor status\n view [options] [id] Detailed view of one background agent, or\n the interactive agent dashboard when no id\n is given\n rename [options] <id> <title...> Rename a background agent session\n resume [options] <id> <prompt...> Continue a finished/crashed background\n session as a new background run on the\n same conversation\n reply [options] <id> <prompt...> Queue a reply on a running interactive\n background session and wait for worker\n acceptance\n rm [options] <id> Remove a finished background agent's\n record + log (a bound worktree is removed\n only when verified empty; the conversation\n session itself is untouched)\n stop [options] [id] Stop one background agent, or all running\n agents with --any\n help [command] display help for command\n",
45
+ "daemon": "Usage: chainlesschain daemon [options] [command]\n\nManage background agent and scheduler services\n\nOptions:\n -h, --help display help for command\n\nCommands:\n scheduler Run durable unattended scheduler domains\n in one process\n notify-needs-input [options] <id> Retry a durable needs-input notification\n for a background run\n status [options] Show background agent supervisor status\n view [options] [id] Detailed view of one background agent, or\n the interactive agent dashboard when no id\n is given\n rename [options] <id> <title...> Rename a background agent session\n resume [options] <id> <prompt...> Continue a finished/crashed background\n session as a new background run on the\n same conversation\n reply [options] <id> <prompt...> Queue a reply on a running interactive\n background session and wait for worker\n acceptance\n rm [options] <id> Remove a finished background agent's\n record + log (a bound worktree is removed\n only when verified empty; the conversation\n session itself is untouched)\n stop [options] [id] Stop one background agent, or all running\n agents with --any\n help [command] display help for command\n",
46
46
  "dao": "Usage: chainlesschain dao [options] [command]\n\nDAO Governance v2 — proposals, voting, delegation, treasury\n\nOptions:\n -h, --help display help for command\n\nCommands:\n propose [options] <title> Create a governance proposal\n vote [options] <proposal-id> <direction> Vote on a proposal (direction: \"for\" or \"against\")\n delegate [options] <delegator> <delegate-to> Delegate voting power\n execute <proposal-id> Execute a passed proposal\n treasury [options] Show treasury balance and allocations\n allocate [options] <proposal-id> <amount> Allocate treasury funds to a proposal\n stats [options] Show governance statistics\n configure [options] Update governance configuration\n statuses [options] List Phase 92 enum references\n propose-v2 [options] <title> Create a Phase 92 proposal in DRAFT status\n activate <proposal-id> Move proposal DRAFT → ACTIVE and open voting window\n cast-vote [options] <proposal-id> Cast a quadratic vote (cost = voteCount²). voteType: for|against|abstain\n delegate-v2 [options] <from-did> <to-did> Delegate voting power with cycle + depth safety\n revoke-delegation <from-did> Revoke an active delegation\n active-delegations [options] List ACTIVE delegations (auto-expires past expiresAt)\n queue <proposal-id> Queue proposal (ACTIVE → QUEUE) if majority + quorum met\n execute-v2 <proposal-id> Execute proposal (QUEUE → EXECUTE) after timelock\n cancel <proposal-id> Cancel a proposal (non-executed)\n allocate-v2 [options] <proposal-id> Allocate treasury funds to a recipient (proposal must be EXECUTED)\n deposit-v2 [options] Deposit funds into the DAO treasury\n treasury-state [options] Show Phase 92 treasury state (balance + recent txs)\n stats-v2 [options] Phase 92 governance stats with participation + delegation coverage\n configure-v2 [options] Update Phase 92 governance config\n config-v2 [options] Show Phase 92 governance config\n enums-v2 Show V2 governance enums\n register-org-v2 [options] Register a dao org profile (pending)\n activate-org-v2 <id> Activate org\n pause-org-v2 <id> Pause org\n dissolve-org-v2 <id> Dissolve org (terminal)\n touch-org-v2 <id> Refresh lastTouchedAt\n get-org-v2 <id> Get org\n list-orgs-v2 List orgs\n create-proposal-v2 [options] Create a dao proposal (queued)\n start-proposal-v2 <id> Transition proposal to voting\n pass-proposal-v2 <id> Transition proposal to passed\n fail-proposal-v2 [options] <id> Fail proposal\n cancel-proposal-v2 [options] <id> Cancel proposal\n get-proposal-v2 <id> Get proposal\n list-proposals-v2 List proposals\n set-max-active-orgs-v2 <n> Set per-owner active cap\n set-max-pending-proposals-v2 <n> Set per-org pending cap\n set-org-idle-ms-v2 <n> Set idle threshold\n set-proposal-stuck-ms-v2 <n> Set stuck threshold\n auto-pause-idle-orgs-v2 Auto-pause idle orgs\n auto-fail-stuck-proposals-v2 Auto-fail stuck voting proposals\n gov-stats-v2 V2 governance aggregate stats\n help [command] display help for command\n",
47
47
  "db": "Usage: chainlesschain db [options] [command]\n\nDatabase management\n\nOptions:\n -h, --help display help for command\n\nCommands:\n init [options] Initialize the database\n info [options] Show database information\n backup [output] Create database backup\n restore [options] <backup> Restore database from backup\n check [options] Run SQLite integrity check on the database\n reset [options] Back up the database (and WAL sidecar) and start\n fresh next run\n repair [options] Best-effort row salvage from a corrupt DB into a\n new file\n help [command] display help for command\n",
48
48
  "dbevo": "Usage: chainlesschain dbevo [options] [command]\n\nDatabase evolution & migration framework (Phase 80)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n migration-statuses [options] List migration statuses\n directions [options] List migration directions\n suggestion-types [options] List index suggestion types\n register [options] <version> Register a migration version\n registered [options] List registered migrations\n validate [options] Validate registered migrations\n status [options] Show migration status\n up [options] Migrate up (apply pending migrations)\n down [options] Rollback migrations\n history [options] Show migration history\n query-log [options] <sql> <duration-ms> Log a query with duration\n query-stats [options] Show query statistics\n slow-threshold [options] <ms> Set slow query threshold\n query-clear [options] Clear query log\n analyze [options] Analyze slow queries and generate index suggestions\n suggestions [options] List index suggestions\n suggestion-show [options] <id> Show suggestion details\n apply [options] <id> Apply an index suggestion\n stats [options] Database evolution statistics\n schema-baselines-v2 [options] List V2 baseline states\n migration-runs-v2 [options] List V2 migration-run states\n default-max-active-baselines-per-db Default active-baseline cap\n max-active-baselines-per-db Current active-baseline cap\n set-max-active-baselines-per-db <n> Set active-baseline cap\n default-max-running-migrations-per-db Default running-migration cap\n max-running-migrations-per-db Current running-migration cap\n set-max-running-migrations-per-db <n> Set running-migration cap\n default-baseline-idle-ms Default baseline idle ms\n baseline-idle-ms Current baseline idle ms\n set-baseline-idle-ms <ms> Set baseline idle ms\n default-migration-stuck-ms Default migration stuck ms\n migration-stuck-ms Current migration stuck ms\n set-migration-stuck-ms <ms> Set migration stuck ms\n active-baseline-count [options] Count of ACTIVE baselines\n running-migration-count [options] Count of RUNNING migration runs\n register-baseline-v2 [options] <baseline-id> Register a V2 baseline\n baseline-v2 <baseline-id> Get a V2 baseline\n set-baseline-status-v2 [options] <baseline-id> <status> Transition baseline status\n validate-baseline [options] <baseline-id> Transition baseline (validate-baseline)\n activate-baseline [options] <baseline-id> Transition baseline (activate-baseline)\n deprecate-baseline [options] <baseline-id> Transition baseline (deprecate-baseline)\n retire-baseline [options] <baseline-id> Transition baseline (retire-baseline)\n touch-baseline-activity <baseline-id> Bump lastTouchedAt\n enqueue-migration-run-v2 [options] <run-id> Enqueue a V2 migration run\n migration-run-v2 <run-id> Get a V2 migration run\n set-migration-run-status-v2 [options] <run-id> <status> Transition migration-run status\n start-migration-run [options] <run-id> Transition migration run (start-migration-run)\n apply-migration-run [options] <run-id> Transition migration run (apply-migration-run)\n fail-migration-run [options] <run-id> Transition migration run (fail-migration-run)\n rollback-migration-run [options] <run-id> Transition migration run (rollback-migration-run)\n auto-retire-idle-baselines Flip idle draft/validated/deprecated → RETIRED\n auto-fail-stuck-migration-runs Flip stuck RUNNING → FAILED\n stats-v2 V2 stats snapshot\n help [command] display help for command\n",
@@ -140,7 +140,7 @@
140
140
  "seshsearch": "Usage: chainlesschain seshsearch [options] [command]\n\nSession Search V2 governance\n\nOptions:\n -h, --help display help for command\n\nCommands:\n enums-v2\n config-v2\n set-max-active-v2 <n>\n set-max-pending-v2 <n>\n set-idle-ms-v2 <n>\n set-stuck-ms-v2 <n>\n register-profile-v2 [options] <id> <owner>\n activate-profile-v2 <id>\n stale-profile-v2 <id>\n archive-profile-v2 <id>\n touch-profile-v2 <id>\n get-profile-v2 <id>\n list-profiles-v2\n create-query-v2 [options] <id> <profileId>\n searching-query-v2 <id>\n complete-query-v2 <id>\n fail-query-v2 <id> [reason]\n cancel-query-v2 <id> [reason]\n get-query-v2 <id>\n list-queries-v2\n auto-stale-idle-v2\n auto-fail-stuck-v2\n gov-stats-v2\n reset-state-v2\n help [command] display help for command\n",
141
141
  "seshtail": "Usage: chainlesschain seshtail [options] [command]\n\nSession Tail V2 governance\n\nOptions:\n -h, --help display help for command\n\nCommands:\n enums-v2\n config-v2\n set-max-active-v2 <n>\n set-max-pending-v2 <n>\n set-idle-ms-v2 <n>\n set-stuck-ms-v2 <n>\n register-sub-v2 [options] <id> <owner>\n activate-sub-v2 <id>\n pause-sub-v2 <id>\n close-sub-v2 <id>\n touch-sub-v2 <id>\n get-sub-v2 <id>\n list-subs-v2\n create-event-v2 [options] <id> <subId>\n tailing-event-v2 <id>\n complete-event-v2 <id>\n fail-event-v2 <id> [reason]\n cancel-event-v2 <id> [reason]\n get-event-v2 <id>\n list-events-v2\n auto-pause-idle-v2\n auto-fail-stuck-v2\n gov-stats-v2\n reset-state-v2\n help [command] display help for command\n",
142
142
  "seshu": "Usage: chainlesschain seshu [options] [command]\n\nSession Usage V2 governance\n\nOptions:\n -h, --help display help for command\n\nCommands:\n enums-v2\n config-v2\n set-max-active-v2 <n>\n set-max-pending-v2 <n>\n set-idle-ms-v2 <n>\n set-stuck-ms-v2 <n>\n register-budget-v2 [options] <id> <owner>\n activate-budget-v2 <id>\n exhaust-budget-v2 <id>\n archive-budget-v2 <id>\n touch-budget-v2 <id>\n get-budget-v2 <id>\n list-budgets-v2\n create-record-v2 [options] <id> <budgetId>\n recording-record-v2 <id>\n record-record-v2 <id>\n reject-record-v2 <id> [reason]\n cancel-record-v2 <id> [reason]\n get-record-v2 <id>\n list-records-v2\n auto-exhaust-idle-v2\n auto-reject-stuck-v2\n gov-stats-v2\n reset-state-v2\n help [command] display help for command\n",
143
- "session": "Usage: chainlesschain session [options] [command]\n\nConversation session management\n\nOptions:\n -h, --help display help for command\n\nCommands:\n mcp-recovery Inspect or adjudicate verified MCP outcome-unknown calls\n list [options] List saved sessions\n projection [options] Emit the canonical versioned session projection for IDEs\n show [options] <id> Show a session's messages\n pr-status [options] [id] PR/CI monitor + controlled auto-merge decision for a session's linked PR\n resume [options] [id] Resume a session in chat mode (id optional — interactive picker, or most recent when piped)\n export [options] <id> Export a session as Markdown (canonical JSONL transcript, then legacy DB fallback)\n search [options] <query> Full-text search across agent session transcripts (JSONL --resume store)\n delete [options] <id> Delete a session\n rename [options] <id> <title...> Rename a headless (JSONL) session — shows up in session list\n prune [options] Delete JSONL sessions whose last activity is older than a cutoff (newest N always kept)\n migrate [options] [source] Migrate legacy JSON session files to JSONL\n validate [options] [id] Validate JSONL session files\n verify [options] [id] Verify transcript hash-chain integrity (tamper-evidence); omit id to verify all\n repair [options] <id> Diagnose and repair one crash-partial final transcript record only\n index [options] [query] Build/refresh the SQLite session index; search it, or mirror sessions off-box\n policy [options] <id> Show or set per-session approval policy\n lifecycle [options] List session-core handles (running/idle/parked)\n park <id> Park a session (persist to disk, free process memory)\n unpark <id> Resume a parked session\n end [options] <id> Close a session (optionally consolidate trace into MemoryStore)\n tail [options] <id> Follow a JSONL session's events (NDJSON on stdout)\n usage [options] [id] Aggregate token usage (per-session or global)\n workflow [options] [id] Inspect coding workflow state (.chainlesschain/sessions/)\n conversation-maturities-v2 [options] List V2 conversation maturity states\n turn-lifecycles-v2 [options] List V2 turn lifecycle states\n stats-v2 [options] Show V2 session stats\n get-max-active-conv-v2 Get max active conversations per user\n set-max-active-conv-v2 <n> Set max active conversations per user\n get-max-pending-turns-v2 Get max pending turns per conversation\n set-max-pending-turns-v2 <n> Set max pending turns per conversation\n get-conv-idle-ms-v2 Get conversation idle ms\n set-conv-idle-ms-v2 <ms> Set conversation idle ms\n get-turn-stuck-ms-v2 Get turn stuck ms\n set-turn-stuck-ms-v2 <ms> Set turn stuck ms\n active-conv-count-v2 <userId> Count active conversations for user\n pending-turn-count-v2 <conversationId> Count pending+streaming turns for conversation\n register-conversation-v2 [options] <id> Register V2 conversation (initial=draft)\n get-conversation-v2 <id> Get V2 conversation by id\n list-conversations-v2 [options] List V2 conversations\n activate-conversation-v2 <id> Transition conversation → active\n pause-conversation-v2 <id> Transition conversation → paused\n archive-conversation-v2 <id> Transition conversation → archived (terminal)\n touch-conversation-v2 <id> Update conversation lastSeenAt\n create-turn-v2 [options] <id> Create V2 turn (initial=pending)\n get-turn-v2 <id> Get V2 turn by id\n list-turns-v2 [options] List V2 turns\n stream-turn-v2 <id> Transition turn → streaming\n complete-turn-v2 <id> Transition turn → completed (terminal)\n fail-turn-v2 <id> Transition turn → failed (terminal)\n cancel-turn-v2 <id> Transition turn → cancelled (terminal)\n auto-archive-idle-conv-v2 Auto-archive idle conversations; output flipped\n auto-fail-stuck-turns-v2 Auto-fail stuck streaming turns; output flipped\n help [command] display help for command\n",
143
+ "session": "Usage: chainlesschain session [options] [command]\n\nConversation session management\n\nOptions:\n -h, --help display help for command\n\nCommands:\n mcp-recovery Inspect or adjudicate verified MCP outcome-unknown calls\n list [options] List saved sessions\n projection [options] Emit the canonical versioned session projection for IDEs\n show [options] <id> Show a session's messages\n pr-status [options] [id] PR/CI monitor + controlled auto-merge decision for a session's linked PR\n resume [options] [id] Resume a session in chat mode (id optional — interactive picker, or most recent when piped)\n export [options] <id> Export a session as Markdown (canonical JSONL transcript, then legacy DB fallback)\n search [options] <query> Full-text search across agent session transcripts (JSONL --resume store)\n delete [options] <id> Delete a session\n rename [options] <id> <title...> Rename a headless (JSONL) session — shows up in session list\n prune [options] Delete JSONL sessions whose last activity is older than a cutoff (newest N always kept)\n migrate [options] [source] Migrate legacy JSON session files to JSONL\n validate [options] [id] Validate JSONL session files\n verify [options] [id] Verify transcript hash-chain integrity (tamper-evidence); omit id to verify all\n repair [options] <id> Diagnose and repair one crash-partial final transcript record only\n index [options] [query] Build/refresh the SQLite session index; search it, or mirror sessions off-box\n policy [options] <id> Show or set per-session approval policy\n lifecycle [options] List session-core handles (running/idle/parked)\n park <id> Park a session (persist to disk, free process memory)\n unpark <id> Resume a parked session\n end [options] <id> Close a session (optionally consolidate trace into MemoryStore)\n tail [options] <id> Follow a JSONL session's events (NDJSON on stdout)\n usage [options] [id] Aggregate token usage (per-session or global)\n observability [options] <request> Export verified token/USD, retry, tool latency, diff, gate, artifact and PR causality\n observability-authority [options] <id> Print the verified headHash/eventCount/scope binding for a delivery flow\n workflow [options] [id] Inspect coding workflow state (.chainlesschain/sessions/)\n conversation-maturities-v2 [options] List V2 conversation maturity states\n turn-lifecycles-v2 [options] List V2 turn lifecycle states\n stats-v2 [options] Show V2 session stats\n get-max-active-conv-v2 Get max active conversations per user\n set-max-active-conv-v2 <n> Set max active conversations per user\n get-max-pending-turns-v2 Get max pending turns per conversation\n set-max-pending-turns-v2 <n> Set max pending turns per conversation\n get-conv-idle-ms-v2 Get conversation idle ms\n set-conv-idle-ms-v2 <ms> Set conversation idle ms\n get-turn-stuck-ms-v2 Get turn stuck ms\n set-turn-stuck-ms-v2 <ms> Set turn stuck ms\n active-conv-count-v2 <userId> Count active conversations for user\n pending-turn-count-v2 <conversationId> Count pending+streaming turns for conversation\n register-conversation-v2 [options] <id> Register V2 conversation (initial=draft)\n get-conversation-v2 <id> Get V2 conversation by id\n list-conversations-v2 [options] List V2 conversations\n activate-conversation-v2 <id> Transition conversation → active\n pause-conversation-v2 <id> Transition conversation → paused\n archive-conversation-v2 <id> Transition conversation → archived (terminal)\n touch-conversation-v2 <id> Update conversation lastSeenAt\n create-turn-v2 [options] <id> Create V2 turn (initial=pending)\n get-turn-v2 <id> Get V2 turn by id\n list-turns-v2 [options] List V2 turns\n stream-turn-v2 <id> Transition turn → streaming\n complete-turn-v2 <id> Transition turn → completed (terminal)\n fail-turn-v2 <id> Transition turn → failed (terminal)\n cancel-turn-v2 <id> Transition turn → cancelled (terminal)\n auto-archive-idle-conv-v2 Auto-archive idle conversations; output flipped\n auto-fail-stuck-turns-v2 Auto-fail stuck streaming turns; output flipped\n help [command] display help for command\n",
144
144
  "setup": "Usage: chainlesschain setup [options]\n\nInteractive setup wizard for ChainlessChain\n\nOptions:\n --skip-download Skip binary download\n --skip-services Skip Docker service setup\n -h, --help display help for command\n",
145
145
  "sganal": "Usage: chainlesschain sganal [options] [command]\n\nSocial Graph Analytics V2 governance (in-memory, CLI v0.143.0)\n\nOptions:\n -h, --help display help for command\n\nCommands:\n enums-v2\n register-profile-v2 [options]\n activate-profile-v2 <id>\n stale-profile-v2 <id>\n archive-profile-v2 <id>\n touch-profile-v2 <id>\n get-profile-v2 <id>\n list-profiles-v2\n create-run-v2 [options]\n running-run-v2 <id>\n complete-run-v2 <id>\n fail-run-v2 [options] <id>\n cancel-run-v2 [options] <id>\n get-run-v2 <id>\n list-runs-v2\n config-v2\n set-max-active-profiles-v2 <n>\n set-max-pending-runs-v2 <n>\n set-profile-idle-ms-v2 <ms>\n set-run-stuck-ms-v2 <ms>\n auto-stale-idle-v2\n auto-fail-stuck-v2\n gov-stats-v2\n help [command] display help for command\n",
146
146
  "siem": "Usage: chainlesschain siem [options] [command]\n\nSIEM integration — log export to external targets\n\nOptions:\n -h, --help display help for command\n\nCommands:\n targets [options] List SIEM export targets\n add-target [options] <type> <url> Add a SIEM target (splunk_hec, elasticsearch, azure_sentinel)\n export <target-id> Export logs to a SIEM target\n stats [options] Show SIEM export statistics\n formats List SIEM export formats (V2)\n target-types List SIEM target types (V2)\n severities List SIEM severity levels (V2)\n statuses List SIEM target statuses (V2)\n default-batch-size Show default SIEM batch size (V2)\n severity-cef <severity> Map a SIEM severity to its CEF integer (0-10)\n format-log [options] <format> Format a JSON log payload as cef|leef|json\n add-target-v2 [options] Add a SIEM target via canonical options (V2)\n remove-target <target-id> Remove a SIEM target (V2)\n set-status <target-id> <status> Transition a SIEM target's status (V2)\n export-v2 [options] <target-id> Batch-export logs to a target (V2)\n stats-v2 Show extended SIEM stats (byFormat/byType/byStatus, V2)\n by-status <status> List SIEM targets filtered by status (V2)\n enums-v2 Show V2 enums (target maturity + export lifecycle)\n config-v2 Show V2 config thresholds\n set-max-active-targets-v2 <n> Set max active targets per operator\n set-max-pending-exports-v2 <n> Set max pending exports per target\n set-target-idle-ms-v2 <n> Set target idle threshold (ms)\n set-export-stuck-ms-v2 <n> Set export stuck threshold (ms)\n register-target-v2 [options] <id> <operator> Register V2 SIEM target\n activate-target-v2 <id> Activate target\n degrade-target-v2 <id> Degrade target\n retire-target-v2 <id> Retire target (terminal)\n touch-target-v2 <id> Touch target lastTouchedAt\n get-target-v2 <id> Get V2 target\n list-targets-v2 List V2 targets\n create-export-v2 [options] <id> <targetId> Create V2 export (queued)\n start-export-v2 <id> Start export\n deliver-export-v2 <id> Deliver export\n fail-export-v2 <id> [reason] Fail export\n cancel-export-v2 <id> [reason] Cancel export\n get-export-v2 <id> Get V2 export\n list-exports-v2 List V2 exports\n auto-degrade-idle-v2 Auto-degrade idle targets\n auto-fail-stuck-v2 Auto-fail stuck sending exports\n gov-stats-v2 V2 governance aggregate stats\n help [command] display help for command\n",
@@ -582,7 +582,7 @@
582
582
  "aliases": [],
583
583
  "module": "./commands/background-session.js",
584
584
  "register": "registerBackgroundSessionCommands",
585
- "summary": "Inspect and stop background agent supervisor sessions",
585
+ "summary": "Manage background agent and scheduler services",
586
586
  "stability": "compatibility",
587
587
  "category": "compatibility",
588
588
  "visibility": "extended",
@@ -149,6 +149,70 @@ function isExecutionPolicyFailure(error) {
149
149
  );
150
150
  }
151
151
 
152
+ export async function evaluateAgendaMonitor(
153
+ entry,
154
+ { runCommand, readWatchedFile, fetchUrl, now },
155
+ ) {
156
+ let output = "";
157
+ let matched = false;
158
+ let mtimeMs = null;
159
+ if (entry.source === "file") {
160
+ const file = await readWatchedFile(entry.watchFile);
161
+ output = file.content;
162
+ mtimeMs = file.mtimeMs ?? null;
163
+ if (entry.watchChange) {
164
+ matched =
165
+ entry.lastMtimeMs != null &&
166
+ mtimeMs != null &&
167
+ mtimeMs > entry.lastMtimeMs;
168
+ } else {
169
+ matched = entry.stopWhen
170
+ ? new RegExp(entry.stopWhen).test(file.content)
171
+ : file.exists;
172
+ }
173
+ } else if (entry.source === "http") {
174
+ const res = await fetchUrl(entry.watchUrl);
175
+ output = res.body;
176
+ matched = entry.stopWhen
177
+ ? new RegExp(entry.stopWhen).test(res.body)
178
+ : res.ok;
179
+ } else {
180
+ const workspaceCwd = resolveMonitorWorkspaceCwd(entry);
181
+ assertMonitorShellPolicy(entry.command);
182
+ output = await runCommand(entry.command, { workspaceCwd });
183
+ matched = entry.stopWhen ? new RegExp(entry.stopWhen).test(output) : false;
184
+ }
185
+ if (!matched) return { matched: false, mtimeMs };
186
+
187
+ const what =
188
+ entry.source === "file"
189
+ ? entry.watchFile
190
+ : entry.source === "http"
191
+ ? entry.watchUrl
192
+ : entry.command;
193
+ const envelope = monitorEventEnvelope(
194
+ entry.id,
195
+ { what, output },
196
+ { at: now, source: entry.source },
197
+ );
198
+ const duplicate =
199
+ entry.lastEventId != null && entry.lastEventId === envelope.event_id;
200
+ return {
201
+ matched: true,
202
+ mtimeMs,
203
+ eventId: envelope.event_id,
204
+ authority: envelope.authority,
205
+ truncated: envelope.truncated === true,
206
+ notification: duplicate
207
+ ? null
208
+ : {
209
+ title: entry.notify?.title || `Monitor matched: ${what}`,
210
+ body: capEventPayload(output, 500).value,
211
+ level: "success",
212
+ },
213
+ };
214
+ }
215
+
152
216
  export function registerAgendaCommand(program) {
153
217
  const cmd = program
154
218
  .command("agenda")
@@ -233,7 +297,7 @@ export function runAgendaList(options = {}, _deps = {}) {
233
297
  e.kind === "wakeup"
234
298
  ? new Date(e.dueAt).toISOString()
235
299
  : e.kind === "cron"
236
- ? `${e.cron} (next ${new Date(e.nextAt).toISOString()})`
300
+ ? `${e.cron}${e.timeZone ? ` [${e.timeZone}]` : ""} (next ${new Date(e.nextAt).toISOString()})`
237
301
  : `${monitorWhat} (next ${new Date(e.nextAt).toISOString()})`;
238
302
  const expiry =
239
303
  e.expiresAt != null
@@ -367,6 +431,14 @@ export async function runAgendaRun(options = {}, _deps = {}) {
367
431
  agendaStore: store,
368
432
  schedulerStore,
369
433
  runAgent: ({ prompt, runPolicy }) => spawnAgent(prompt, runPolicy),
434
+ runMonitor: ({ entry }) =>
435
+ evaluateAgendaMonitor(entry, {
436
+ runCommand,
437
+ readWatchedFile,
438
+ fetchUrl,
439
+ now: clock(),
440
+ }),
441
+ notifyMonitor: notify,
370
442
  now: clock,
371
443
  ...(options.leaseMs === undefined
372
444
  ? {}
@@ -388,11 +460,11 @@ export async function runAgendaRun(options = {}, _deps = {}) {
388
460
  }
389
461
  const due = options.dryRun
390
462
  ? store.due(null, now)
391
- : useSchedulerKernel && typeof store.claimDue === "function"
392
- ? store.claimDue(now, options.leaseMs, "monitor")
463
+ : useSchedulerKernel
464
+ ? []
393
465
  : typeof store.claimDue === "function"
394
466
  ? store.claimDue(now, options.leaseMs)
395
- : store.due(useSchedulerKernel ? "monitor" : null, now);
467
+ : store.due(null, now);
396
468
 
397
469
  for (const entry of due) {
398
470
  if (options.dryRun) {
@@ -24,6 +24,7 @@ import {
24
24
  import { appendSecurityAuditEvent } from "../lib/security-audit.js";
25
25
  import {
26
26
  agentPrintArgument,
27
+ BACKGROUND_EPHEMERAL_UNSUPPORTED_CODE,
27
28
  canonicalizeBackgroundSessionArgv,
28
29
  captureCommandArgvGrammar,
29
30
  transformBackgroundLaunchArgv,
@@ -175,6 +176,52 @@ function readStdin() {
175
176
  });
176
177
  }
177
178
 
179
+ /** Normalize the three opt-in causal-report scope flags without losing empties. */
180
+ export function resolveAgentObservabilityScope(options = {}) {
181
+ const fields = [
182
+ ["observabilityWorkspace", "workspaceId", "--observability-workspace"],
183
+ ["observabilityTeam", "teamId", "--observability-team"],
184
+ ["observabilityPolicy", "policyId", "--observability-policy"],
185
+ ];
186
+ const providedFields = fields.filter(
187
+ ([optionName]) => options[optionName] !== undefined,
188
+ );
189
+ if (providedFields.length > 0 && options.forkSession === true) {
190
+ throw new Error(
191
+ "observability scope flags cannot be combined with --fork-session; a fork inherits the source session's immutable observability scope",
192
+ );
193
+ }
194
+ let provided = false;
195
+ const scope = {};
196
+ for (const [optionName, scopeName, flag] of fields) {
197
+ const value = options[optionName];
198
+ if (value === undefined) {
199
+ scope[scopeName] = null;
200
+ continue;
201
+ }
202
+ provided = true;
203
+ if (typeof value !== "string") {
204
+ throw new TypeError(`${flag} requires a non-empty string id`);
205
+ }
206
+ const normalized = value.trim();
207
+ const hasControlCharacter = [...normalized].some((character) => {
208
+ const code = character.codePointAt(0);
209
+ return code <= 0x1f || code === 0x7f;
210
+ });
211
+ if (!normalized || normalized.length > 256 || hasControlCharacter) {
212
+ throw new TypeError(`${flag} requires a valid non-empty id`);
213
+ }
214
+ scope[scopeName] = normalized;
215
+ }
216
+ if (!provided) return undefined;
217
+ if (options.ephemeral === true) {
218
+ throw new Error(
219
+ "observability scope requires durable session persistence and cannot be combined with --ephemeral",
220
+ );
221
+ }
222
+ return scope;
223
+ }
224
+
178
225
  export function registerAgentCommand(program) {
179
226
  program
180
227
  .command("agent")
@@ -496,6 +543,18 @@ export function registerAgentCommand(program) {
496
543
  "--max-budget-usd <amount>",
497
544
  "Hard USD spend cap: stop the run before the next paid LLM call once the estimated cost reaches this (headless; uses the cc cost price table)",
498
545
  )
546
+ .option(
547
+ "--observability-workspace <id>",
548
+ "Persist a workspace scope on new session authority for causal reports",
549
+ )
550
+ .option(
551
+ "--observability-team <id>",
552
+ "Persist a team scope on new session authority for causal reports",
553
+ )
554
+ .option(
555
+ "--observability-policy <id>",
556
+ "Persist a policy scope on new session authority for causal reports",
557
+ )
499
558
  .option(
500
559
  "--strict-mcp-config",
501
560
  "Use ONLY --mcp-config servers; ignore registered (cc mcp add) and IDE-bridge MCP for a reproducible tool surface",
@@ -520,6 +579,19 @@ export function registerAgentCommand(program) {
520
579
  false,
521
580
  )
522
581
  .action(async (task, options, command) => {
582
+ // Scope is immutable session authority. Resolve every scope/fork
583
+ // conflict before worktree creation, session forking, bootstrap, or any
584
+ // other externally visible setup performed by this action.
585
+ let observabilityScope;
586
+ try {
587
+ observabilityScope = resolveAgentObservabilityScope(options);
588
+ } catch (error) {
589
+ process.stderr.write(`${error.message}\n`);
590
+ process.exitCode = 1;
591
+ return;
592
+ }
593
+ const hasObservabilityScope = observabilityScope !== undefined;
594
+
523
595
  // --capabilities: print the machine-readable manifest and exit — no
524
596
  // config, no bootstrap, no network (gap-analysis 2026-07-11 快速收益 #6).
525
597
  if (options.capabilities) {
@@ -625,6 +697,15 @@ export function registerAgentCommand(program) {
625
697
  }
626
698
  const backgroundRequested =
627
699
  options.background === true || options.bg === true;
700
+ if (backgroundRequested && options.ephemeral === true) {
701
+ const error = new Error(
702
+ "--bg cannot be combined with --ephemeral because background sessions require durable session and interaction authority",
703
+ );
704
+ error.code = BACKGROUND_EPHEMERAL_UNSUPPORTED_CODE;
705
+ process.stderr.write(`${error.message}\n`);
706
+ process.exitCode = 1;
707
+ return;
708
+ }
628
709
  const invocationCwd = process.cwd();
629
710
  let worktreeDecision = {
630
711
  enabled: false,
@@ -1182,7 +1263,6 @@ export function registerAgentCommand(program) {
1182
1263
  const { mergePricing } = await import("../lib/llm-pricing.js");
1183
1264
  priceTable = mergePricing(loadConfig().llm?.pricing);
1184
1265
  }
1185
-
1186
1266
  // 鈹€鈹€ Streaming-input mode (--input-format stream-json) 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
1187
1267
  // A persistent multi-turn conversation driven by NDJSON user events on
1188
1268
  // stdin; output is always NDJSON. Routed before single-prompt handling
@@ -1248,6 +1328,9 @@ export function registerAgentCommand(program) {
1248
1328
  maxCostUsd,
1249
1329
  priceTable,
1250
1330
  chatFn: fallbackChatFn,
1331
+ observabilityScope: hasObservabilityScope
1332
+ ? observabilityScope
1333
+ : undefined,
1251
1334
  // --json-schema: structured output for stream-INPUT mode. The schema
1252
1335
  // is resolved + meta-validated up front, its output contract injected
1253
1336
  // into the system prompt, and a per-turn `structured_result` event is
@@ -1544,6 +1627,9 @@ export function registerAgentCommand(program) {
1544
1627
  // --max-budget-usd: hard spend cap (+ price table from config llm.pricing)
1545
1628
  maxCostUsd,
1546
1629
  priceTable,
1630
+ observabilityScope: hasObservabilityScope
1631
+ ? observabilityScope
1632
+ : undefined,
1547
1633
  // --fallback-model: retry once on a backup model on transient errors
1548
1634
  chatFn: fallbackChatFn,
1549
1635
  };
@@ -1701,6 +1787,9 @@ export function registerAgentCommand(program) {
1701
1787
  // --channels: inbound channel listeners (webhook/telegram) whose
1702
1788
  // events become user turns in this session.
1703
1789
  channels: options.channels || null,
1790
+ observabilityScope: hasObservabilityScope
1791
+ ? observabilityScope
1792
+ : undefined,
1704
1793
  });
1705
1794
  await runtime.startAgentSession();
1706
1795
  // Interactive session ended (REPL closed) — settle the worktree.