@bitkyc08/opencodex 2.96.0 → 2.98.0-preview.20261107

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 (465) hide show
  1. package/bin/ocx.mjs +215 -20
  2. package/gui/dist/assets/App-6TFtZsUF.css +1 -0
  3. package/gui/dist/assets/App-B8_sOxoz.js +59 -0
  4. package/gui/dist/assets/Tray-DpWEp6ee.js +1 -0
  5. package/gui/dist/assets/WantedSansVariable.split.0-Dwvb1WRx.woff2 +0 -0
  6. package/gui/dist/assets/WantedSansVariable.split.1-1wKD2RxI.woff2 +0 -0
  7. package/gui/dist/assets/WantedSansVariable.split.10-CAKA6LIP.woff2 +0 -0
  8. package/gui/dist/assets/WantedSansVariable.split.11-k5H85R4b.woff2 +0 -0
  9. package/gui/dist/assets/WantedSansVariable.split.12-BHboLsUv.woff2 +0 -0
  10. package/gui/dist/assets/WantedSansVariable.split.13-9GV377ix.woff2 +0 -0
  11. package/gui/dist/assets/WantedSansVariable.split.14-DovDXnrj.woff2 +0 -0
  12. package/gui/dist/assets/WantedSansVariable.split.15-DTdykCig.woff2 +0 -0
  13. package/gui/dist/assets/WantedSansVariable.split.16-CKz2ccgK.woff2 +0 -0
  14. package/gui/dist/assets/WantedSansVariable.split.17-Z2RD_KRZ.woff2 +0 -0
  15. package/gui/dist/assets/WantedSansVariable.split.18-BcKtfonJ.woff2 +0 -0
  16. package/gui/dist/assets/WantedSansVariable.split.19-DEQPOSZn.woff2 +0 -0
  17. package/gui/dist/assets/WantedSansVariable.split.2-DryboyuA.woff2 +0 -0
  18. package/gui/dist/assets/WantedSansVariable.split.20-Bia5JMls.woff2 +0 -0
  19. package/gui/dist/assets/WantedSansVariable.split.21-Cr4jFw-E.woff2 +0 -0
  20. package/gui/dist/assets/WantedSansVariable.split.22-DjjB69TZ.woff2 +0 -0
  21. package/gui/dist/assets/WantedSansVariable.split.23-CvUzJskt.woff2 +0 -0
  22. package/gui/dist/assets/WantedSansVariable.split.24-i_eMg5ox.woff2 +0 -0
  23. package/gui/dist/assets/WantedSansVariable.split.25-2aKHwPX-.woff2 +0 -0
  24. package/gui/dist/assets/WantedSansVariable.split.26-B6wXoCEL.woff2 +0 -0
  25. package/gui/dist/assets/WantedSansVariable.split.27-D4h1WfGM.woff2 +0 -0
  26. package/gui/dist/assets/WantedSansVariable.split.28-kvRPCStd.woff2 +0 -0
  27. package/gui/dist/assets/WantedSansVariable.split.29-DHAiwleD.woff2 +0 -0
  28. package/gui/dist/assets/WantedSansVariable.split.3-7H--eyZi.woff2 +0 -0
  29. package/gui/dist/assets/WantedSansVariable.split.30-C66cfAY2.woff2 +0 -0
  30. package/gui/dist/assets/WantedSansVariable.split.31-FDmtiNim.woff2 +0 -0
  31. package/gui/dist/assets/WantedSansVariable.split.32-DouHt2Dd.woff2 +0 -0
  32. package/gui/dist/assets/WantedSansVariable.split.33-B8HVvkJX.woff2 +0 -0
  33. package/gui/dist/assets/WantedSansVariable.split.34-BtkRu1FN.woff2 +0 -0
  34. package/gui/dist/assets/WantedSansVariable.split.35-DBylQbtk.woff2 +0 -0
  35. package/gui/dist/assets/WantedSansVariable.split.36-Sg089Kgh.woff2 +0 -0
  36. package/gui/dist/assets/WantedSansVariable.split.37-CYtvbriS.woff2 +0 -0
  37. package/gui/dist/assets/WantedSansVariable.split.38-DKkSLf8Z.woff2 +0 -0
  38. package/gui/dist/assets/WantedSansVariable.split.39-CecotKZD.woff2 +0 -0
  39. package/gui/dist/assets/WantedSansVariable.split.4-Bv8O3ZMb.woff2 +0 -0
  40. package/gui/dist/assets/WantedSansVariable.split.40-DdCvkmOU.woff2 +0 -0
  41. package/gui/dist/assets/WantedSansVariable.split.41-ESn674Hc.woff2 +0 -0
  42. package/gui/dist/assets/WantedSansVariable.split.42-DL9V7NNV.woff2 +0 -0
  43. package/gui/dist/assets/WantedSansVariable.split.43-yipO0cyk.woff2 +0 -0
  44. package/gui/dist/assets/WantedSansVariable.split.44-6rTmLZhm.woff2 +0 -0
  45. package/gui/dist/assets/WantedSansVariable.split.45-BJAj8lrm.woff2 +0 -0
  46. package/gui/dist/assets/WantedSansVariable.split.46-BDTzMn2c.woff2 +0 -0
  47. package/gui/dist/assets/WantedSansVariable.split.47-Bxd4wGgi.woff2 +0 -0
  48. package/gui/dist/assets/WantedSansVariable.split.48-DxnFBLnH.woff2 +0 -0
  49. package/gui/dist/assets/WantedSansVariable.split.49-DnVD0aOD.woff2 +0 -0
  50. package/gui/dist/assets/WantedSansVariable.split.5-B1wI2pp5.woff2 +0 -0
  51. package/gui/dist/assets/WantedSansVariable.split.50-D9JlkZd6.woff2 +0 -0
  52. package/gui/dist/assets/WantedSansVariable.split.51-D9Vw6Bu3.woff2 +0 -0
  53. package/gui/dist/assets/WantedSansVariable.split.52-ClEJk4kn.woff2 +0 -0
  54. package/gui/dist/assets/WantedSansVariable.split.53-BSXU0vh-.woff2 +0 -0
  55. package/gui/dist/assets/WantedSansVariable.split.54-EcuxkR9v.woff2 +0 -0
  56. package/gui/dist/assets/WantedSansVariable.split.55-CYiFhQX8.woff2 +0 -0
  57. package/gui/dist/assets/WantedSansVariable.split.56--Gk9g8BK.woff2 +0 -0
  58. package/gui/dist/assets/WantedSansVariable.split.57-DnkOPZcy.woff2 +0 -0
  59. package/gui/dist/assets/WantedSansVariable.split.58-9MB8504z.woff2 +0 -0
  60. package/gui/dist/assets/WantedSansVariable.split.59-ByxIsN72.woff2 +0 -0
  61. package/gui/dist/assets/WantedSansVariable.split.6-Bmk0dRVw.woff2 +0 -0
  62. package/gui/dist/assets/WantedSansVariable.split.60-Bxwx_aWQ.woff2 +0 -0
  63. package/gui/dist/assets/WantedSansVariable.split.61-DA2z5sm7.woff2 +0 -0
  64. package/gui/dist/assets/WantedSansVariable.split.62-C5iJPJZn.woff2 +0 -0
  65. package/gui/dist/assets/WantedSansVariable.split.63-DAqrmaEc.woff2 +0 -0
  66. package/gui/dist/assets/WantedSansVariable.split.64-BgXFsljb.woff2 +0 -0
  67. package/gui/dist/assets/WantedSansVariable.split.65-DKiWujvu.woff2 +0 -0
  68. package/gui/dist/assets/WantedSansVariable.split.66-8po4vUZ4.woff2 +0 -0
  69. package/gui/dist/assets/WantedSansVariable.split.67-Cy5qyI9O.woff2 +0 -0
  70. package/gui/dist/assets/WantedSansVariable.split.68-BKny7Fy3.woff2 +0 -0
  71. package/gui/dist/assets/WantedSansVariable.split.69-B4VU4u_b.woff2 +0 -0
  72. package/gui/dist/assets/WantedSansVariable.split.7-BuqwNpgA.woff2 +0 -0
  73. package/gui/dist/assets/WantedSansVariable.split.70-BCd4n346.woff2 +0 -0
  74. package/gui/dist/assets/WantedSansVariable.split.71-CkQppaWn.woff2 +0 -0
  75. package/gui/dist/assets/WantedSansVariable.split.72-Db7vaoFs.woff2 +0 -0
  76. package/gui/dist/assets/WantedSansVariable.split.73-DI80TYWl.woff2 +0 -0
  77. package/gui/dist/assets/WantedSansVariable.split.74-tMCtDAHB.woff2 +0 -0
  78. package/gui/dist/assets/WantedSansVariable.split.75-Ciw0D5WG.woff2 +0 -0
  79. package/gui/dist/assets/WantedSansVariable.split.76-DoLjFgp-.woff2 +0 -0
  80. package/gui/dist/assets/WantedSansVariable.split.77-CpT2uvMy.woff2 +0 -0
  81. package/gui/dist/assets/WantedSansVariable.split.78-CkcJ4iZ1.woff2 +0 -0
  82. package/gui/dist/assets/WantedSansVariable.split.79-DsOUJjEM.woff2 +0 -0
  83. package/gui/dist/assets/WantedSansVariable.split.8-DsjypPd6.woff2 +0 -0
  84. package/gui/dist/assets/WantedSansVariable.split.80-C0VwHTte.woff2 +0 -0
  85. package/gui/dist/assets/WantedSansVariable.split.81-DTelu57i.woff2 +0 -0
  86. package/gui/dist/assets/WantedSansVariable.split.82-BiMndGN1.woff2 +0 -0
  87. package/gui/dist/assets/WantedSansVariable.split.83-CVcC6eDG.woff2 +0 -0
  88. package/gui/dist/assets/WantedSansVariable.split.84-DlhZVt_O.woff2 +0 -0
  89. package/gui/dist/assets/WantedSansVariable.split.85-S8I2D3pA.woff2 +0 -0
  90. package/gui/dist/assets/WantedSansVariable.split.86-DozXXpH5.woff2 +0 -0
  91. package/gui/dist/assets/WantedSansVariable.split.87-Dsn0Vuuo.woff2 +0 -0
  92. package/gui/dist/assets/WantedSansVariable.split.88-iNwxxDCr.woff2 +0 -0
  93. package/gui/dist/assets/WantedSansVariable.split.89-B63u_9CZ.woff2 +0 -0
  94. package/gui/dist/assets/WantedSansVariable.split.9-Bi3IzpMI.woff2 +0 -0
  95. package/gui/dist/assets/WantedSansVariable.split.90-ByeH1Pqf.woff2 +0 -0
  96. package/gui/dist/assets/WantedSansVariable.split.91-UQLlagpm.woff2 +0 -0
  97. package/gui/dist/assets/brand-mark-VPhzz-WE.js +1 -0
  98. package/gui/dist/assets/geist-cyrillic-ext-wght-normal-DjL33-gN.woff2 +0 -0
  99. package/gui/dist/assets/geist-cyrillic-wght-normal-BEAKL7Jp.woff2 +0 -0
  100. package/gui/dist/assets/geist-latin-ext-wght-normal-DC-KSUi6.woff2 +0 -0
  101. package/gui/dist/assets/geist-latin-wght-normal-BgDaEnEv.woff2 +0 -0
  102. package/gui/dist/assets/geist-mono-cyrillic-ext-wght-normal-X_5orZeX.woff2 +0 -0
  103. package/gui/dist/assets/geist-mono-cyrillic-wght-normal-DiZS0aHC.woff2 +0 -0
  104. package/gui/dist/assets/geist-mono-latin-ext-wght-normal-Bwz-egvJ.woff2 +0 -0
  105. package/gui/dist/assets/geist-mono-latin-wght-normal-XN7g48iV.woff2 +0 -0
  106. package/gui/dist/assets/geist-mono-symbols2-wght-normal-CO5SzqOn.woff2 +0 -0
  107. package/gui/dist/assets/geist-mono-vietnamese-wght-normal-DadHysG0.woff2 +0 -0
  108. package/gui/dist/assets/geist-vietnamese-wght-normal-6IgcOCM7.woff2 +0 -0
  109. package/gui/dist/assets/index-5REODpG3.css +2 -0
  110. package/gui/dist/assets/index-BWKBeK77.js +94 -0
  111. package/gui/dist/assets/segment-thumb-features-BQYzrze9.js +1 -0
  112. package/gui/dist/classic/assets/App-Bz65x1J6.js +58 -0
  113. package/gui/dist/{assets/Tray-BOPQyDbH.js → classic/assets/Tray-kk7mdO6I.js} +1 -1
  114. package/gui/dist/classic/assets/index-Dp2j8bSc.js +94 -0
  115. package/gui/dist/classic/assets/quota-summary-CvamtHjB.js +1 -0
  116. package/gui/dist/classic/index.html +47 -0
  117. package/gui/dist/favicon.png +0 -0
  118. package/gui/dist/favicon.svg +14 -0
  119. package/gui/dist/index.html +15 -2
  120. package/package.json +1 -1
  121. package/src/adapters/anthropic.ts +17 -8
  122. package/src/adapters/command-code.ts +15 -16
  123. package/src/adapters/cursor/transport-retry.ts +2 -2
  124. package/src/adapters/devin/cloud-direct/chat.ts +15 -6
  125. package/src/adapters/google.ts +7 -7
  126. package/src/adapters/kiro/adapter.ts +18 -3
  127. package/src/adapters/kiro/conversation.ts +8 -8
  128. package/src/adapters/kiro/payload.ts +45 -12
  129. package/src/adapters/kiro/stream.ts +230 -14
  130. package/src/adapters/kiro/structured-output-json.ts +191 -0
  131. package/src/adapters/kiro/structured-output-schema.ts +542 -0
  132. package/src/adapters/kiro/structured-output.ts +367 -0
  133. package/src/adapters/kiro-constants.ts +24 -1
  134. package/src/adapters/kiro-events.ts +31 -1
  135. package/src/adapters/kiro-retry.ts +3 -3
  136. package/src/adapters/kiro-tools.ts +14 -9
  137. package/src/adapters/kiro-wire.ts +9 -5
  138. package/src/adapters/ollama-native.ts +11 -1
  139. package/src/adapters/openai-chat/messages.ts +58 -5
  140. package/src/adapters/openai-chat/mistral-image-limit.ts +50 -0
  141. package/src/adapters/openai-chat/passthrough.ts +5 -3
  142. package/src/adapters/openai-chat/tool-schema.ts +83 -13
  143. package/src/adapters/openai-responses/empty-assistant.ts +15 -3
  144. package/src/adapters/openai-responses/opengateway-input.ts +18 -6
  145. package/src/adapters/openai-responses/passthrough.ts +5 -4
  146. package/src/adapters/openai-responses/reasoning.ts +9 -4
  147. package/src/adapters/openai-responses/request-strips.ts +1 -1
  148. package/src/adapters/openai-responses/tool-output-recovery.ts +79 -0
  149. package/src/adapters/physical-send.ts +3 -3
  150. package/src/adapters/qoder/live-models.ts +115 -1
  151. package/src/adapters/zed-openai-stream.ts +2 -1
  152. package/src/bridge/errors.ts +11 -2
  153. package/src/bridge/response-json.ts +2 -1
  154. package/src/bridge/sse.ts +14 -6
  155. package/src/chat/failure-verdict.ts +21 -0
  156. package/src/chat/outbound.ts +139 -21
  157. package/src/claude/failure-verdict.ts +21 -0
  158. package/src/claude/inbound-content-options.ts +15 -2
  159. package/src/claude/inbound-model-options.ts +2 -1
  160. package/src/claude/inbound-records.ts +2 -0
  161. package/src/claude/inbound.ts +17 -11
  162. package/src/claude/outbound.ts +98 -22
  163. package/src/cli/capabilities-access-remote.ts +13 -0
  164. package/src/cli/capabilities-base.ts +26 -3
  165. package/src/cli/capabilities-command.ts +12 -3
  166. package/src/cli/capabilities-provider-models.ts +3 -3
  167. package/src/cli/capability-contracts.ts +2 -0
  168. package/src/cli/codex-launch-auth.ts +30 -1
  169. package/src/cli/codex-launcher.ts +12 -5
  170. package/src/cli/codex-shim-autorestore.ts +12 -4
  171. package/src/cli/config-command.ts +11 -2
  172. package/src/cli/connect.ts +17 -2
  173. package/src/cli/dispatch.ts +14 -177
  174. package/src/cli/doctor.ts +95 -7
  175. package/src/cli/help.ts +2 -2
  176. package/src/cli/index.ts +17 -8
  177. package/src/cli/link-apply-restart.ts +9 -2
  178. package/src/cli/link.ts +1 -1
  179. package/src/cli/models.ts +124 -38
  180. package/src/cli/registry.ts +12 -4
  181. package/src/cli/restart-failure.ts +17 -0
  182. package/src/cli/root.ts +8 -0
  183. package/src/cli/stop-approval.ts +2 -2
  184. package/src/cli/sync-command.ts +243 -0
  185. package/src/cli/sync-fanout-process.ts +92 -0
  186. package/src/cli/sync-fanout.ts +161 -0
  187. package/src/cli/sync-flags.ts +10 -0
  188. package/src/cli/sync-link-status.ts +39 -0
  189. package/src/cli/sync-update-guard.ts +18 -0
  190. package/src/cli/system-restart-client.ts +5 -0
  191. package/src/cli/uninstall-client-state.ts +12 -1
  192. package/src/cli/update-restart-child.ts +13 -3
  193. package/src/cli/update-restart-home.ts +6 -3
  194. package/src/cli/update-restart.ts +36 -19
  195. package/src/client/connect.ts +35 -15
  196. package/src/client/hub-client.ts +5 -0
  197. package/src/client/link-home.ts +3 -2
  198. package/src/client/link-management-relay.ts +39 -2
  199. package/src/client/link-readiness.ts +3 -1
  200. package/src/client/machine-api.ts +2 -1
  201. package/src/client/machine-listener.ts +10 -0
  202. package/src/client/orphan-token-recovery.ts +322 -0
  203. package/src/client/restore-ownership.ts +19 -1
  204. package/src/client/runtime-restart.ts +12 -4
  205. package/src/client/runtime.ts +40 -11
  206. package/src/client/stop-routing.ts +62 -0
  207. package/src/client/sync-runtime.ts +65 -0
  208. package/src/clients/config-export.ts +32 -3
  209. package/src/codex/auth-context.ts +49 -103
  210. package/src/codex/catalog/antigravity-discovery.ts +16 -5
  211. package/src/codex/catalog/provider-models.ts +18 -12
  212. package/src/codex/forward-transport-headers.ts +35 -6
  213. package/src/codex/inject/config-toml.ts +88 -0
  214. package/src/codex/inject/multi-agent-v2.ts +30 -4
  215. package/src/codex/inject/plan.ts +34 -7
  216. package/src/codex/inject-coordination.ts +11 -0
  217. package/src/codex/inject.ts +18 -7
  218. package/src/codex/lineage.ts +13 -7
  219. package/src/codex/native-profile-api.ts +27 -1
  220. package/src/codex/quota.ts +22 -6
  221. package/src/codex/request-owned-affinity-key.ts +11 -0
  222. package/src/codex/request-owned-affinity.ts +118 -0
  223. package/src/codex/request-owned-main-pin.ts +86 -0
  224. package/src/codex/role-capability.ts +52 -41
  225. package/src/codex/routing/active-account.ts +13 -5
  226. package/src/codex/routing/selection.ts +40 -1
  227. package/src/codex/routing/thread-affinity-store.ts +916 -0
  228. package/src/codex/routing/thread-affinity.ts +90 -12
  229. package/src/codex/shim-diagnostics.ts +7 -0
  230. package/src/codex/shim-legacy-record.ts +290 -0
  231. package/src/codex/shim-windows-refresh.ts +9 -2
  232. package/src/codex/shim-wrapper-write.ts +7 -0
  233. package/src/codex/shim.ts +80 -21
  234. package/src/codex/toml-source-lines.ts +72 -13
  235. package/src/combos/failover.ts +6 -109
  236. package/src/combos/request.ts +2 -2
  237. package/src/combos/resolve.ts +29 -11
  238. package/src/config/diagnostics.ts +9 -9
  239. package/src/config/load-degrade.ts +27 -27
  240. package/src/config/process-state.ts +5 -0
  241. package/src/config/provider-validation.ts +9 -2
  242. package/src/config/removed-opencode-free-backup.ts +6 -3
  243. package/src/config/schema/leaf-validators.ts +1 -0
  244. package/src/config/tracked-runtime-inspection.ts +3 -3
  245. package/src/generated/compatibility-version.json +595 -255
  246. package/src/images/loop.ts +4 -3
  247. package/src/lib/client-error-body.ts +215 -0
  248. package/src/lib/client-retry-after.ts +66 -0
  249. package/src/lib/config-ownership-removal.ts +422 -0
  250. package/src/lib/config-ownership.ts +650 -81
  251. package/src/lib/context-overflow-verdict.ts +113 -0
  252. package/src/lib/crash-guard.ts +4 -2
  253. package/src/lib/desktop-cli-handoff.d.mts +4 -5
  254. package/src/lib/desktop-cli-handoff.mjs +18 -17
  255. package/src/lib/empty-tool-catalog.ts +25 -3
  256. package/src/lib/error-destination.ts +47 -0
  257. package/src/lib/errors.ts +1 -0
  258. package/src/lib/failure-detail.ts +66 -0
  259. package/src/lib/local-management-capability.ts +3 -1
  260. package/src/lib/messages-error-body.ts +162 -0
  261. package/src/lib/messages-sse-error-presentation.ts +93 -0
  262. package/src/lib/model-identity.ts +44 -0
  263. package/src/lib/passive-read.ts +9 -4
  264. package/src/lib/private-sqlite-path.ts +124 -0
  265. package/src/lib/response-service-tier.ts +17 -0
  266. package/src/lib/retry-after.ts +3 -0
  267. package/src/lib/socks5-fetch.ts +21 -9
  268. package/src/lib/spend-ledger-owner.ts +43 -4
  269. package/src/lib/upstream-condition.ts +142 -0
  270. package/src/lib/upstream-retry.ts +95 -12
  271. package/src/lib/windows-owner-acl.ts +22 -9
  272. package/src/lib/winsw.ts +5 -5
  273. package/src/lib/workflow-budget.ts +3 -1
  274. package/src/link/remote-platform.ts +14 -0
  275. package/src/link/remote-windows.ts +51 -9
  276. package/src/link/ssh-argv.ts +63 -10
  277. package/src/oauth/generic-account-failover.ts +13 -11
  278. package/src/oauth/index.ts +42 -73
  279. package/src/oauth/oauth-errors.ts +67 -0
  280. package/src/oauth/store.ts +21 -11
  281. package/src/protocols/codecs/messages-ir.ts +15 -9
  282. package/src/protocols/codecs/ollama.ts +197 -0
  283. package/src/protocols/encoders/adapter-events.ts +30 -7
  284. package/src/protocols/encoders/chat.ts +18 -10
  285. package/src/protocols/encoders/messages.ts +72 -28
  286. package/src/protocols/trace.ts +18 -0
  287. package/src/providers/antigravity-models.ts +45 -12
  288. package/src/providers/fastwire.ts +3 -2
  289. package/src/providers/free-directory.ts +2 -2
  290. package/src/providers/quota/anthropic-usage-windows.ts +13 -3
  291. package/src/providers/quota/vendor-probes-key.ts +60 -24
  292. package/src/providers/reasoning-metadata.ts +2 -1
  293. package/src/providers/registry/entries-extended.ts +9 -0
  294. package/src/providers/request-pacing.ts +3 -2
  295. package/src/reasoning-effort.ts +7 -2
  296. package/src/remote/hub-usage.ts +3 -0
  297. package/src/responses/apply-patch-envelope.ts +45 -19
  298. package/src/responses/compaction-history-framing.ts +5 -1
  299. package/src/responses/freeform-wrapper-scan.ts +5 -3
  300. package/src/responses/progressive-freeform-input.ts +354 -45
  301. package/src/routing/fallback-policy.ts +3 -1
  302. package/src/server/admission-model-scope.ts +17 -6
  303. package/src/server/admitted-http-turn.ts +57 -0
  304. package/src/server/anthropic-rate-limit-headers.ts +75 -3
  305. package/src/server/auth-cors.ts +5 -0
  306. package/src/server/chat-completions.ts +45 -20
  307. package/src/server/chat-native-sse.ts +52 -7
  308. package/src/server/chat-native.ts +60 -35
  309. package/src/server/claude-bridge-pool-session.ts +59 -0
  310. package/src/server/claude-messages.ts +174 -84
  311. package/src/server/context-history.ts +5 -1
  312. package/src/server/gui-static.ts +4 -1
  313. package/src/server/hub-usage.ts +7 -2
  314. package/src/server/inbound-body-admission.ts +11 -4
  315. package/src/server/index/link-management.ts +8 -0
  316. package/src/server/index/ollama-routes.ts +91 -0
  317. package/src/server/index/serve-options.ts +44 -24
  318. package/src/server/index/startup-warnings.ts +5 -12
  319. package/src/server/index/websocket-handler.ts +5 -2
  320. package/src/server/index.ts +6 -36
  321. package/src/server/inference/client-encoder-delivery.ts +9 -3
  322. package/src/server/json-serialized-bytes.ts +44 -0
  323. package/src/server/management/agent-settings-routes.ts +24 -21
  324. package/src/server/management/codex-cli-update-routes.ts +2 -1
  325. package/src/server/management/logs-usage-routes.ts +89 -4
  326. package/src/server/management/provider-routes.ts +2 -22
  327. package/src/server/management/qoder-provider-probe.ts +105 -0
  328. package/src/server/management/route-registry.ts +4 -1
  329. package/src/server/management/usage-aggregate-cache.ts +15 -5
  330. package/src/server/management/usage-source-facets.ts +38 -0
  331. package/src/server/messages-native-scope.ts +2 -1
  332. package/src/server/messages-native-tool-guard.ts +12 -4
  333. package/src/server/messages-native.ts +123 -47
  334. package/src/server/messages-response-headers.ts +25 -11
  335. package/src/server/messages-shared.ts +99 -65
  336. package/src/server/messages-sse-error-filter.ts +199 -0
  337. package/src/server/native-final-log.ts +93 -0
  338. package/src/server/ollama-inbound.ts +349 -0
  339. package/src/server/ollama-native-paths.ts +21 -0
  340. package/src/server/ollama-route-policy.ts +73 -0
  341. package/src/server/relay.ts +22 -3
  342. package/src/server/request-decompress.ts +4 -2
  343. package/src/server/request-log-failure-attribution.ts +22 -0
  344. package/src/server/request-log-failure-detail.ts +80 -0
  345. package/src/server/request-log-terminal-status.ts +4 -2
  346. package/src/server/request-log.ts +91 -42
  347. package/src/server/response-log-body.ts +6 -1
  348. package/src/server/responses/account-change-state.ts +17 -6
  349. package/src/server/responses/adapter-continuation.ts +17 -6
  350. package/src/server/responses/adapter-delivery.ts +17 -10
  351. package/src/server/responses/adapter-dispatch.ts +32 -31
  352. package/src/server/responses/anthropic-thinking-recovery.ts +3 -0
  353. package/src/server/responses/codex-auth-error.ts +24 -19
  354. package/src/server/responses/codex-ws-exchange.ts +11 -8
  355. package/src/server/responses/codex-ws-metadata.ts +94 -21
  356. package/src/server/responses/codex-ws-request.ts +3 -1
  357. package/src/server/responses/codex-ws-wire.ts +19 -3
  358. package/src/server/responses/compact.ts +57 -24
  359. package/src/server/responses/compaction-recovery.ts +4 -2
  360. package/src/server/responses/compaction-routing.ts +9 -4
  361. package/src/server/responses/core-auth.ts +32 -14
  362. package/src/server/responses/core-codex-account.ts +17 -6
  363. package/src/server/responses/core-combo-failure.ts +7 -1
  364. package/src/server/responses/core-combo-native.ts +2 -1
  365. package/src/server/responses/core-combo.ts +43 -27
  366. package/src/server/responses/core-errors.ts +24 -21
  367. package/src/server/responses/core-lifetime.ts +6 -3
  368. package/src/server/responses/core-normalize.ts +1 -0
  369. package/src/server/responses/core-options.ts +9 -0
  370. package/src/server/responses/core-pipeline.ts +4 -3
  371. package/src/server/responses/empty-completion-guard.ts +4 -1
  372. package/src/server/responses/fetch-helpers.ts +7 -1
  373. package/src/server/responses/input-admission.ts +28 -2
  374. package/src/server/responses/native-injection.ts +1 -1
  375. package/src/server/responses/native-response-json.ts +13 -4
  376. package/src/server/responses/native-response-output.ts +1 -2
  377. package/src/server/responses/non-replayable-error.ts +2 -1
  378. package/src/server/responses/pacing-overload.ts +3 -2
  379. package/src/server/responses/passthrough-delivery.ts +55 -14
  380. package/src/server/responses/passthrough-dispatch.ts +20 -18
  381. package/src/server/responses/passthrough-error.ts +9 -9
  382. package/src/server/responses/policy-fallback.ts +2 -1
  383. package/src/server/responses/request-prepare.ts +69 -48
  384. package/src/server/responses/request-transport.ts +36 -31
  385. package/src/server/responses/response-effects.ts +3 -2
  386. package/src/server/responses/run-turn-execution.ts +6 -6
  387. package/src/server/responses/sidecar-execution.ts +16 -12
  388. package/src/server/responses/spend-storage-error.ts +2 -1
  389. package/src/server/responses/terminal-guard.ts +30 -0
  390. package/src/server/responses/ws-upstream.ts +9 -0
  391. package/src/server/responses-custom-tool-repair.ts +14 -3
  392. package/src/server/responses-terminal-repair.ts +5 -2
  393. package/src/server/responses-undeclared-tool-guard.ts +39 -16
  394. package/src/server/restart-replacement.ts +3 -1
  395. package/src/server/safe-response-headers.ts +162 -13
  396. package/src/server/sse-payload-rewrite.ts +23 -11
  397. package/src/server/turn-state-handles.ts +164 -0
  398. package/src/server/workflow-refusal.ts +2 -1
  399. package/src/server/ws-bridge.ts +4 -0
  400. package/src/service/definition.ts +36 -4
  401. package/src/service/launchd.ts +89 -32
  402. package/src/service/logging.ts +34 -7
  403. package/src/service/ownership-mutation-lease.d.mts +11 -2
  404. package/src/service/ownership-mutation-lease.mjs +53 -11
  405. package/src/service/plist-xml.ts +59 -0
  406. package/src/service/state.ts +8 -0
  407. package/src/service/systemd-env.ts +2 -0
  408. package/src/service/systemd.ts +31 -7
  409. package/src/service/windows-taskxml.ts +16 -7
  410. package/src/service-manager-probe.ts +4 -10
  411. package/src/types/config.ts +2 -0
  412. package/src/types/provider.ts +2 -0
  413. package/src/types/request.ts +13 -1
  414. package/src/update/config-preflight.ts +48 -0
  415. package/src/update/index.ts +148 -26
  416. package/src/update/npm-install.d.mts +8 -0
  417. package/src/update/npm-install.mjs +20 -1
  418. package/src/update/orchestrated-admission.d.mts +4 -0
  419. package/src/update/orchestrated-admission.mjs +12 -0
  420. package/src/update/orchestrated-arguments.d.mts +12 -0
  421. package/src/update/orchestrated-arguments.mjs +64 -0
  422. package/src/update/orchestrated-child.d.mts +12 -0
  423. package/src/update/orchestrated-child.mjs +70 -0
  424. package/src/update/orchestrated-entry.ts +234 -0
  425. package/src/update/orchestrated-identity-probe-entry.ts +20 -0
  426. package/src/update/orchestrated-identity.ts +53 -0
  427. package/src/update/orchestrated-live-identity.ts +48 -0
  428. package/src/update/orchestrated-node-driver.mjs +99 -0
  429. package/src/update/orchestrated-outcome.d.mts +21 -0
  430. package/src/update/orchestrated-outcome.mjs +40 -0
  431. package/src/update/orchestrated-plan.ts +49 -0
  432. package/src/update/orchestrated-pnpm.d.mts +8 -0
  433. package/src/update/orchestrated-pnpm.mjs +33 -0
  434. package/src/update/orchestrated-session.d.mts +37 -0
  435. package/src/update/orchestrated-session.mjs +264 -0
  436. package/src/update/orchestrated-token.d.mts +10 -0
  437. package/src/update/orchestrated-token.mjs +21 -0
  438. package/src/update/orchestrated-token.ts +3 -0
  439. package/src/update/orchestrated-tree.d.mts +1 -0
  440. package/src/update/orchestrated-tree.mjs +14 -0
  441. package/src/update/pnpm-global-install.d.mts +6 -0
  442. package/src/update/pnpm-global-install.mjs +9 -2
  443. package/src/update/posix-install-supervisor-entry.mjs +6 -0
  444. package/src/update/posix-install-supervisor.d.mts +10 -0
  445. package/src/update/posix-install-supervisor.mjs +88 -0
  446. package/src/update/sync-update-mutex.d.mts +10 -0
  447. package/src/update/sync-update-mutex.mjs +164 -0
  448. package/src/update/sync-update-mutex.ts +1 -0
  449. package/src/update/test-home-guard.mjs +33 -0
  450. package/src/update/transactional-install.mjs +2 -2
  451. package/src/usage/client.ts +43 -0
  452. package/src/usage/error-detail.ts +225 -0
  453. package/src/usage/log.ts +64 -27
  454. package/src/usage/source-facets.ts +51 -0
  455. package/src/usage/source-filter.ts +65 -0
  456. package/src/usage/summary.ts +50 -8
  457. package/src/web-search/anthropic-executor.ts +105 -24
  458. package/src/web-search/executor.ts +5 -3
  459. package/src/web-search/loop.ts +33 -6
  460. package/src/web-search/progress-stream.ts +64 -5
  461. package/gui/dist/assets/App-bwugJRKn.js +0 -58
  462. package/gui/dist/assets/index-ebuVUtB7.js +0 -94
  463. package/gui/dist/assets/quota-summary-6HsrHQAy.js +0 -1
  464. /package/gui/dist/{assets → classic/assets}/App-B4j-Txmb.css +0 -0
  465. /package/gui/dist/{assets → classic/assets}/index-CHWwDo9L.css +0 -0
@@ -0,0 +1,234 @@
1
+ import { mkdtempSync, readFileSync, realpathSync, rmSync } from "node:fs";
2
+ import { dirname, join, resolve } from "node:path";
3
+ import { tmpdir } from "node:os";
4
+ import type { ChildProcess } from "node:child_process";
5
+ import { fileURLToPath } from "node:url";
6
+ import { packageVersion } from "../lib/package-version";
7
+ import { getConfigDir } from "../config/paths";
8
+ import { readConfigDiagnostics } from "../config";
9
+ import { resolveServiceOwnership } from "../service/state";
10
+ import type { ServiceOwnershipResolution } from "../service/state";
11
+ import { inspectDesktopSupervision, type SupervisionEvidence } from "../service/desktop-supervision.mjs";
12
+ import { diagnoseService } from "../service/diagnostics";
13
+ import { detectInstallOwnership, defaultUpdateTag, latestVersion } from "./index";
14
+ import { parseOrchestratedUpdateArgs, type OrchestratedUpdateArgs } from "./orchestrated-arguments.mjs";
15
+ import { buildOrchestratedPlan, type PlanInputs } from "./orchestrated-plan";
16
+ import { inspectLiveOrchestratedIdentity } from "./orchestrated-live-identity";
17
+ import type { ServingIdentity } from "./orchestrated-identity";
18
+ import { planUpdateRuntimeHandling } from "./runtime-ownership.mjs";
19
+ import { isUpdateInFlight } from "./sync-update-mutex";
20
+ import { createOrchestratedResultChannel, encodeOrchestratedExpect, type OrchestratedExpect } from "./orchestrated-session.mjs";
21
+ import { waitForOrchestratedChild } from "./orchestrated-child.mjs";
22
+ import { classifyOrchestratedOutcome, type Outcome } from "./orchestrated-outcome.mjs";
23
+ import { verifyOrchestratedInstall } from "./orchestrated-tree.mjs";
24
+ import { decideOrchestratedApply } from "./orchestrated-admission.mjs";
25
+ import { createUpdatePlanToken } from "./orchestrated-token.mjs";
26
+ import { selfLaunchArgv } from "../lib/self-launch-argv";
27
+ import { proxyIdentityAt } from "../server/proxy-liveness";
28
+ import { probeSpawn, probeSpawnSync } from "./mutation-guard.mjs";
29
+
30
+ type Request = Extract<OrchestratedUpdateArgs, { ok: true }>;
31
+ type DetectedInstaller = PlanInputs["installer"] | "standalone";
32
+ export interface OrchestratedPlanDeps {
33
+ install(): { installer: DetectedInstaller; cliRoot: string; desktopPath: boolean };
34
+ currentVersion(): string;
35
+ identity(): Promise<ServingIdentity>;
36
+ ownership(identity: ServingIdentity): { runtimeOwner: PlanInputs["runtimeOwner"]; permits: boolean };
37
+ target(selector: string, installer: PlanInputs["installer"]): string | null;
38
+ inFlight(): boolean;
39
+ }
40
+
41
+ export function classifyPlanRuntimeOwner(identity: ServingIdentity, owner: ServiceOwnershipResolution,
42
+ supervision: SupervisionEvidence, serviceInstalled: boolean | null): { runtimeOwner: PlanInputs["runtimeOwner"]; permits: boolean } {
43
+ const policy = planUpdateRuntimeHandling({ ownership: owner.kind === "owned" ? owner.ownership : null,
44
+ ownershipUnknown: owner.kind === "unknown", serviceInstalled: serviceInstalled === true, supervision });
45
+ const desktop = supervision.kind === "desktop" || (owner.kind === "owned" && owner.ownership.owner !== "cli");
46
+ const uncertain = owner.kind === "unknown" || supervision.kind === "unknown" || supervision.kind === "unsupported" || serviceInstalled === null;
47
+ const identityUnknown = identity.kind !== "live" && identity.kind !== "absent";
48
+ const runtimeOwner = uncertain ? "unknown" : desktop ? "desktop-app" : identityUnknown ? "unknown" : identity.kind === "absent" ? "none"
49
+ : serviceInstalled && owner.kind === "owned" && owner.ownership.owner === "cli" ? "service" : "unmanaged";
50
+ return { runtimeOwner, permits: !uncertain && !identityUnknown && policy.mayReplacePackage };
51
+ }
52
+
53
+ const defaultDeps: OrchestratedPlanDeps = {
54
+ install() {
55
+ const installer = detectInstallOwnership().installer;
56
+ const path = installer === "standalone" ? process.execPath : resolve(dirname(fileURLToPath(import.meta.url)), "../..");
57
+ return { installer, cliRoot: realpathSync.native(path), desktopPath: /(?:[\\/]\.opencodex-desktop[\\/]|\.app[\\/]Contents[\\/])/i.test(path) };
58
+ },
59
+ currentVersion: packageVersion,
60
+ async identity() {
61
+ const config = readConfigDiagnostics({ passive: true });
62
+ if (config.source === "fallback") return { kind: "unknown" };
63
+ return inspectLiveOrchestratedIdentity(getConfigDir(), { port: config.config.port ?? 10100, hostname: config.config.hostname });
64
+ },
65
+ ownership(identity) {
66
+ const owner = resolveServiceOwnership();
67
+ const supervision = identity.kind === "live" ? inspectDesktopSupervision({ targetPid: identity.runtime.pid }) : { kind: "none" as const };
68
+ let serviceInstalled: boolean | null = false;
69
+ if (identity.kind === "live" && owner.kind === "owned" && owner.ownership.owner === "cli") {
70
+ const service = diagnoseService();
71
+ serviceInstalled = service.supported && !service.conflict ? service.installed : null;
72
+ }
73
+ return classifyPlanRuntimeOwner(identity, owner, supervision, serviceInstalled);
74
+ },
75
+ target: (selector, installer) => {
76
+ if (!["npm", "pnpm", "bun"].includes(installer)) return null;
77
+ const cache = mkdtempSync(join(tmpdir(), "ocx-registry-probe-"));
78
+ const overrides = { npm_config_cache: cache, npm_config_logs_dir: join(cache, "logs"), npm_config_logs_max: "0",
79
+ npm_config_update_notifier: "false", pnpm_config_cache_dir: join(cache, "pnpm-cache"),
80
+ npm_config_cache_dir: join(cache, "pnpm-cache"), npm_config_store_dir: join(cache, "pnpm-store"),
81
+ pnpm_config_store_dir: join(cache, "pnpm-store"), pnpm_config_state_dir: join(cache, "pnpm-state"),
82
+ BUN_INSTALL_CACHE_DIR: join(cache, "bun-cache"), XDG_CACHE_HOME: join(cache, "xdg-cache"), XDG_STATE_HOME: join(cache, "xdg-state") };
83
+ const keys = new Set(Object.keys(overrides).map(key => key.toLowerCase()));
84
+ const env = { ...Object.fromEntries(Object.entries(process.env).filter(([key]) => !keys.has(key.toLowerCase()))), ...overrides };
85
+ try { return latestVersion(selector, installer as "npm" | "pnpm" | "bun", undefined, probeSpawnSync, env); }
86
+ finally { rmSync(cache, { recursive: true, force: true }); }
87
+ },
88
+ inFlight: () => isUpdateInFlight(getConfigDir()),
89
+ };
90
+
91
+ /** Passive identity and plan-bound fields for a Node update child. */
92
+ export async function inspectNodeOrchestratedIdentity(cliRoot: string, targetVersion?: string, installer?: "npm" | "pnpm") {
93
+ const root = realpathSync.native(cliRoot);
94
+ const identity = await defaultDeps.identity();
95
+ if (!targetVersion || !installer) return { ...identity, cliRoot: root };
96
+ const ownership = defaultDeps.ownership(identity);
97
+ const live = identity.kind === "live" ? identity : null;
98
+ const manifest = JSON.parse(readFileSync(join(root, "package.json"), "utf8")) as { version?: unknown };
99
+ if (typeof manifest.version !== "string") throw new Error("invalid package version");
100
+ return { ...identity, cliRoot: root, permits: ownership.permits, planToken: createUpdatePlanToken({
101
+ currentVersion: manifest.version, targetVersion, installer, cliRoot: root,
102
+ servingRoot: live?.servingRoot ?? null, runtimeOwner: ownership.runtimeOwner, runtime: live?.runtime ?? null,
103
+ }) };
104
+ }
105
+
106
+ export async function verifyOrchestratedChildIdentity(expected: OrchestratedExpect, targetVersion: string): Promise<boolean> {
107
+ if (getConfigDir() !== expected.home) return false;
108
+ const install = defaultDeps.install();
109
+ const identity = await defaultDeps.identity();
110
+ if (install.installer !== "bun" || install.cliRoot !== expected.cliRoot || (identity.kind !== "live" && identity.kind !== "absent")) return false;
111
+ const live = identity.kind === "live" ? identity : null;
112
+ if ((live?.servingRoot ?? null) !== expected.servingRoot || (live?.runtime.pid ?? null) !== expected.runtimePid) return false;
113
+ const ownership = defaultDeps.ownership(identity);
114
+ return ownership.permits && createUpdatePlanToken({ currentVersion: defaultDeps.currentVersion(), targetVersion,
115
+ installer: install.installer, cliRoot: install.cliRoot, servingRoot: live?.servingRoot ?? null,
116
+ runtimeOwner: ownership.runtimeOwner, runtime: live?.runtime ?? null }) === expected.planToken;
117
+ }
118
+
119
+ /** Observe first, then classify; failures never become permission to update. */
120
+ export async function observeOrchestratedPlan(request: Request, deps: OrchestratedPlanDeps = defaultDeps) {
121
+ let install: ReturnType<OrchestratedPlanDeps["install"]> = { installer: "unknown", cliRoot: process.execPath, desktopPath: false };
122
+ let currentVersion = "unknown", targetVersion: string | null = null, identity: ServingIdentity = { kind: "unknown" };
123
+ let runtimeOwner: PlanInputs["runtimeOwner"] = "unknown", permits = false, unavailable = false, updateInFlight = true;
124
+ try { install = deps.install(); currentVersion = deps.currentVersion(); } catch { unavailable = true; }
125
+ try { updateInFlight = deps.inFlight(); } catch { /* indeterminate means in flight */ }
126
+ try { identity = await deps.identity(); } catch { unavailable = true; }
127
+ try { const owner = deps.ownership(identity); runtimeOwner = owner.runtimeOwner; permits = owner.permits; } catch { runtimeOwner = "unknown"; }
128
+ const installer = install.installer === "standalone" ? (install.desktopPath || runtimeOwner === "desktop-app" ? "desktop-app" : "unknown") : install.installer;
129
+ try {
130
+ const selector = request.version ?? request.tag ?? defaultUpdateTag(currentVersion);
131
+ const resolved = deps.target(selector, installer);
132
+ targetVersion = request.version && resolved !== request.version ? null : resolved;
133
+ } catch { targetVersion = null; }
134
+ const plan = buildOrchestratedPlan({ currentVersion, targetVersion, installer, runtimeOwner, cliRoot: install.cliRoot,
135
+ identity, ownershipPermits: permits, updateInFlight });
136
+ return unavailable ? { ...plan, canApply: false, reason: "plan-unavailable" as const } : plan;
137
+ }
138
+
139
+ export { decideOrchestratedApply } from "./orchestrated-admission.mjs";
140
+
141
+ type Plan = Awaited<ReturnType<typeof observeOrchestratedPlan>>;
142
+ type BunDriverDeps = {
143
+ home: string;
144
+ identity: () => Promise<ServingIdentity>;
145
+ now: () => number;
146
+ spawn: (exe: string, args: string[], options: { env: Record<string, string | undefined>; stdio: ["ignore", number, number] }) => ChildProcess;
147
+ };
148
+
149
+ /** The parent owns stdout and verifies the child-reported outcome independently. */
150
+ export async function applyOrchestratedBun(plan: Plan, request: Request, deps: BunDriverDeps) {
151
+ const base = { fromVersion: plan.currentVersion, toVersion: plan.targetVersion, installer: plan.installer,
152
+ childExited: false, childExitCode: null, outcome: null, previousVerified: false, targetVerified: false, runtimeHealthy: false, restarted: false } as const;
153
+ const uncertain = () => classifyOrchestratedOutcome(base);
154
+ let channel: ReturnType<typeof createOrchestratedResultChannel> | undefined;
155
+ let childStarted = false, childEverStarted = false;
156
+ try {
157
+ const before = await deps.identity();
158
+ const live = before.kind === "live" ? before : null;
159
+ const token = createUpdatePlanToken({ currentVersion: plan.currentVersion, targetVersion: plan.targetVersion,
160
+ installer: plan.installer, cliRoot: plan.cliPath, servingRoot: live?.servingRoot ?? null,
161
+ runtimeOwner: plan.runtimeOwner, runtime: live?.runtime ?? null });
162
+ if ((before.kind !== "live" && before.kind !== "absent") || token !== plan.planToken || !plan.targetVersion) {
163
+ return { exitCode: 10 as const, result: { ...uncertain().result, error: "plan-changed" } };
164
+ }
165
+ const started = deps.now();
166
+ channel = createOrchestratedResultChannel();
167
+ const expect = encodeOrchestratedExpect({ home: deps.home, cliRoot: plan.cliPath, servingRoot: live?.servingRoot ?? null,
168
+ runtimePid: live?.runtime.pid ?? null, planToken: plan.planToken });
169
+ const args = ["update", "--version", plan.targetVersion, "--orchestrated-expect", expect, "--orchestrated-result", channel.resultPath,
170
+ ...(request.notAfter === undefined ? [] : ["--not-after", String(request.notAfter)])];
171
+ const child = deps.spawn(process.execPath, selfLaunchArgv(args), { env: { ...process.env, OCX_UPDATE_ORCHESTRATED_CHILD: "1", OCX_UPDATE_RESULT_CAPABILITY: channel.capability }, stdio: ["ignore", 2, 2] });
172
+ childStarted = true; childEverStarted = true;
173
+ const waited = await waitForOrchestratedChild(child, { overrunMs: (request.notAfter ?? started) + plan.mutationBoundMs - deps.now() });
174
+ if (!waited.confirmed) {
175
+ child.unref();
176
+ if (waited.reason === "overrun") return { exitCode: 12 as const, result: { ...uncertain().result, error: "overrun" } };
177
+ return uncertain();
178
+ }
179
+ childStarted = false;
180
+ const outcome = channel.read() as Outcome | null;
181
+ const activeRoot = outcome?.phase === "installed" ? outcome.activeRoot : plan.cliPath;
182
+ const targetVerified = outcome?.phase === "installed" && activeRoot === plan.cliPath
183
+ && verifyOrchestratedInstall(activeRoot, plan.targetVersion, "bun");
184
+ const previousVerified = verifyOrchestratedInstall(plan.cliPath, plan.currentVersion, "bun");
185
+ let runtimeHealthy = !plan.restartRequired, restarted = false;
186
+ if (plan.restartRequired) {
187
+ try {
188
+ const after = await deps.identity();
189
+ if (after.kind === "live" && after.servingRoot === activeRoot) {
190
+ const health = await proxyIdentityAt(after.runtime.port, { hostname: after.runtime.hostname, expectedPid: after.runtime.pid });
191
+ runtimeHealthy = health?.version === (outcome?.phase === "installed" ? plan.targetVersion : plan.currentVersion);
192
+ restarted = after.runtime.pid !== live?.runtime.pid;
193
+ }
194
+ } catch {
195
+ return { exitCode: 12 as const, result: { ...uncertain().result, applied: targetVerified, error: "runtime-unverified" } };
196
+ }
197
+ }
198
+ return classifyOrchestratedOutcome({ ...base, childExited: true, childExitCode: waited.code, outcome,
199
+ previousVerified, targetVerified, runtimeHealthy, restarted });
200
+ } catch {
201
+ if (childEverStarted) return uncertain();
202
+ return { exitCode: 10 as const, result: { ...uncertain().result, error: "plan-unavailable" } };
203
+ } finally {
204
+ if (channel && !childStarted) channel.dispose();
205
+ }
206
+ }
207
+
208
+ export async function runOrchestratedUpdate(argv: string[]): Promise<number> {
209
+ const parsed = parseOrchestratedUpdateArgs(argv);
210
+ if (!parsed.ok) {
211
+ console.log(JSON.stringify({ error: "usage" }));
212
+ console.error("Usage: ocx update (--plan | --yes) --json [--tag latest|preview | --version <version>]");
213
+ return 64;
214
+ }
215
+ const plan = await observeOrchestratedPlan(parsed);
216
+ if (parsed.mode === "plan") {
217
+ console.log(JSON.stringify(plan));
218
+ return 0;
219
+ }
220
+ const admission = decideOrchestratedApply(plan, parsed, Date.now());
221
+ if (admission.kind === "done") {
222
+ console.log(JSON.stringify(admission.result));
223
+ return admission.exitCode;
224
+ }
225
+ if (plan.installer === "bun") {
226
+ const result = await applyOrchestratedBun(plan, parsed, { home: getConfigDir(), identity: defaultDeps.identity,
227
+ now: Date.now, spawn: (exe, args, options) => probeSpawn(exe, args, options) });
228
+ console.log(JSON.stringify(result.result));
229
+ return result.exitCode;
230
+ }
231
+ console.log(JSON.stringify({ schema: "ocx.update.result/1", applied: false, fromVersion: plan.currentVersion,
232
+ toVersion: null, installer: plan.installer, restarted: false, healthy: false, rolledBack: false, error: plan.reason ?? "plan-unavailable" }));
233
+ return 10;
234
+ }
@@ -0,0 +1,20 @@
1
+ import { dirname, resolve } from "node:path";
2
+ import { fileURLToPath } from "node:url";
3
+ import { inspectNodeOrchestratedIdentity } from "./orchestrated-entry";
4
+ import { proxyIdentityAt } from "../server/proxy-liveness";
5
+
6
+ // A direct Bun entry keeps the probe outside ordinary CLI startup and repair paths.
7
+ export async function runIdentityProbe(args: string[], cliRoot = resolve(dirname(fileURLToPath(import.meta.url)), "../..")) {
8
+ if (args.length !== 1 || args[0] !== "__update-orchestrated-identity") return 1;
9
+ try {
10
+ const installer = process.env.OCX_IDENTITY_INSTALLER;
11
+ const target = process.env.OCX_IDENTITY_TARGET;
12
+ if ((installer || target) && (!(installer === "npm" || installer === "pnpm") || !target)) return 1;
13
+ const identity = await inspectNodeOrchestratedIdentity(cliRoot, target, installer as "npm" | "pnpm" | undefined);
14
+ const health = identity.kind === "live" ? await proxyIdentityAt(identity.runtime.port,
15
+ { hostname: identity.runtime.hostname, expectedPid: identity.runtime.pid }) : null;
16
+ console.log(JSON.stringify({ ...identity, healthVersion: health?.version ?? null }));
17
+ return 0;
18
+ } catch { return 1; }
19
+ }
20
+ if (import.meta.main) process.exitCode = await runIdentityProbe(process.argv.slice(2), process.env.OCX_IDENTITY_CLI_ROOT);
@@ -0,0 +1,53 @@
1
+ import { dirname, isAbsolute, join } from "node:path";
2
+ import { isValidRuntimePortState, type RuntimePortState } from "../config/process-state";
3
+ import { isLocalAttestationSecret } from "../lib/local-management-attestation";
4
+ import type { HomeOwnershipProof } from "../server/proxy-liveness";
5
+
6
+ type RecordRead = { kind: "record"; raw: string } | { kind: "missing" } | { kind: "unreadable" };
7
+ type RuntimeIdentity = { pid: number; port: number; hostname: string; command: readonly string[] };
8
+ export type ServingIdentity =
9
+ | { kind: "unknown" | "absent" | "mismatch" }
10
+ | { kind: "live"; servingRoot: string; runtime: RuntimeIdentity };
11
+
12
+ export interface ServingIdentityDeps {
13
+ readRecord(): RecordRead;
14
+ prove(record: RuntimePortState): Promise<HomeOwnershipProof>;
15
+ probeConfigured(): Promise<"live" | "dead" | "unknown">;
16
+ legacyExecutableDiffers?(pid: number): Promise<boolean>;
17
+ realpath(path: string): string;
18
+ }
19
+
20
+ /** A live listener is usable only when it attests the same record observed before and after. */
21
+ export async function inspectOrchestratedServingIdentity(deps: ServingIdentityDeps): Promise<ServingIdentity> {
22
+ try {
23
+ const first = deps.readRecord();
24
+ if (first.kind === "unreadable") return { kind: "unknown" };
25
+ if (first.kind === "missing") {
26
+ const endpoint = await deps.probeConfigured();
27
+ return endpoint === "dead" && deps.readRecord().kind === "missing" ? { kind: "absent" } : { kind: "unknown" };
28
+ }
29
+ const parsed: unknown = JSON.parse(first.raw);
30
+ if (!isValidRuntimePortState(parsed) || !isLocalAttestationSecret(parsed.attestationSecret)) return { kind: "unknown" };
31
+ if (await deps.prove(parsed) !== "proven") return { kind: "unknown" };
32
+ const after = deps.readRecord();
33
+ if (after.kind !== "record" || after.raw !== first.raw) return { kind: "unknown" };
34
+ const command: unknown = parsed.command;
35
+ if (command === undefined) {
36
+ return await deps.legacyExecutableDiffers?.(parsed.pid) ? { kind: "mismatch" } : { kind: "unknown" };
37
+ }
38
+ if (!Array.isArray(command) || command.length < 1 || command.length > 2 || !command.every(part => typeof part === "string" && isAbsolute(part))) return { kind: "unknown" };
39
+ let servingRoot: string;
40
+ if (command.length === 1) servingRoot = deps.realpath(command[0]);
41
+ else {
42
+ const source = command[1] as string;
43
+ const root = dirname(dirname(dirname(source)));
44
+ // Windows accepts both separators; only separators are equated, so dotted or doubled forms still fail.
45
+ const native = process.platform === "win32" ? source.replace(/\//g, "\\") : source;
46
+ if (join(root, "src", "cli", "index.ts") !== native) return { kind: "unknown" };
47
+ servingRoot = deps.realpath(root);
48
+ }
49
+ return { kind: "live", servingRoot, runtime: { pid: parsed.pid, port: parsed.port, hostname: parsed.hostname ?? "127.0.0.1", command } };
50
+ } catch {
51
+ return { kind: "unknown" };
52
+ }
53
+ }
@@ -0,0 +1,48 @@
1
+ import { closeSync, constants, fstatSync, lstatSync, openSync, readSync, realpathSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { assertNotRealHomeUnderTest } from "../lib/test-home-guard";
4
+ import { probeEndpointLiveness, proveLiveProxyOwnedByHome } from "../server/proxy-liveness";
5
+ import { processIdentity, procfs, windowsProcessPair } from "../service/desktop-supervision.mjs";
6
+ import { inspectOrchestratedServingIdentity } from "./orchestrated-identity";
7
+
8
+ function readRuntimeRecord(home: string): { kind: "record"; raw: string } | { kind: "missing" } | { kind: "unreadable" } {
9
+ const path = join(home, "runtime-port.json");
10
+ let observed = false, fd: number | undefined;
11
+ try {
12
+ const before = lstatSync(path);
13
+ observed = true;
14
+ if (!before.isFile() || before.size > 32_768) return { kind: "unreadable" };
15
+ fd = openSync(path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
16
+ const opened = fstatSync(fd);
17
+ if (!opened.isFile() || opened.dev !== before.dev || opened.ino !== before.ino || opened.size !== before.size) return { kind: "unreadable" };
18
+ const bytes = Buffer.alloc(32_769);
19
+ const count = readSync(fd, bytes, 0, bytes.length, 0);
20
+ if (count !== opened.size || count > 32_768) return { kind: "unreadable" };
21
+ const after = lstatSync(path);
22
+ if (before.dev !== after.dev || before.ino !== after.ino || before.size !== after.size || before.mtimeMs !== after.mtimeMs) return { kind: "unreadable" };
23
+ return { kind: "record", raw: new TextDecoder("utf-8", { fatal: true }).decode(bytes.subarray(0, count)) };
24
+ } catch (error) {
25
+ return !observed && (error as NodeJS.ErrnoException).code === "ENOENT" ? { kind: "missing" } : { kind: "unreadable" };
26
+ } finally { if (fd !== undefined) closeSync(fd); }
27
+ }
28
+
29
+ /** Read the specified home only; listener possession of its record key proves a live identity. */
30
+ export async function inspectLiveOrchestratedIdentity(home: string, configured: { port: number; hostname?: string }) {
31
+ assertNotRealHomeUnderTest(home);
32
+ return inspectOrchestratedServingIdentity({
33
+ readRecord: () => readRuntimeRecord(home),
34
+ realpath: path => realpathSync.native(path),
35
+ probeConfigured: () => probeEndpointLiveness(configured),
36
+ prove: record => proveLiveProxyOwnedByHome({ pid: record.pid, port: record.port, hostname: record.hostname, source: "runtime" }, { readRuntimeFn: () => record }),
37
+ legacyExecutableDiffers: async pid => {
38
+ try {
39
+ const executable = process.platform === "linux" ? procfs.exe(pid)
40
+ : process.platform === "darwin" ? processIdentity(pid)?.executable
41
+ : process.platform === "win32" ? windowsProcessPair(pid).child?.exe : undefined;
42
+ if (!executable) return false;
43
+ const key = (path: string) => process.platform === "win32" ? path.toLowerCase() : path;
44
+ return key(realpathSync.native(executable)) !== key(realpathSync.native(process.execPath));
45
+ } catch { return false; }
46
+ },
47
+ });
48
+ }
@@ -0,0 +1,99 @@
1
+ import { realpathSync } from "node:fs";
2
+ import { decideOrchestratedApply } from "./orchestrated-admission.mjs";
3
+ import { createOrchestratedResultChannel, encodeOrchestratedExpect } from "./orchestrated-session.mjs";
4
+ import { createUpdatePlanToken } from "./orchestrated-token.mjs";
5
+ import { waitForOrchestratedChild } from "./orchestrated-child.mjs";
6
+ import { classifyOrchestratedOutcome } from "./orchestrated-outcome.mjs";
7
+ import { verifyOrchestratedInstall } from "./orchestrated-tree.mjs";
8
+ import { verifyOrchestratedPnpmInstall } from "./orchestrated-pnpm.mjs";
9
+ import { resolvePnpmGlobalOwner } from "./pnpm-global-install.mjs";
10
+ import { parseOrchestratedUpdateArgs } from "./orchestrated-arguments.mjs";
11
+
12
+ const BOUND = 900_000;
13
+
14
+ /** Parent retains stdout and independently verifies all child-reported effects. */
15
+ export async function applyNodeOrchestratedUpdate(request, deps) {
16
+ let started = false, exited = false, channel;
17
+ let plan;
18
+ const base = () => ({ fromVersion: plan?.currentVersion ?? deps.currentVersion, toVersion: plan?.targetVersion ?? null,
19
+ installer: deps.installer, childExited: false, childExitCode: null, outcome: null, previousVerified: false,
20
+ targetVerified: false, runtimeHealthy: false, restarted: false });
21
+ const uncertain = () => classifyOrchestratedOutcome(base());
22
+ const fail = error => ({ exitCode: 10, result: { ...uncertain().result, error } });
23
+ try {
24
+ const bun = deps.resolveBun();
25
+ if (!bun) return fail("plan-unavailable");
26
+ const p = deps.plan(bun, request.version, request.tag);
27
+ if (p.status !== 0 || p.error || p.signal || typeof p.stdout !== "string" || Buffer.byteLength(p.stdout) > 65536) return fail("plan-unavailable");
28
+ plan = JSON.parse(p.stdout);
29
+ const validVersion = version => typeof version === "string"
30
+ && parseOrchestratedUpdateArgs(["--plan", "--json", "--version", version]).ok;
31
+ if (!plan || plan.schema !== "ocx.update.plan/1" || !validVersion(plan.currentVersion)
32
+ || !(typeof plan.targetVersion === "string" || plan.targetVersion === null) || plan.installer !== deps.installer
33
+ || typeof plan.cliPath !== "string" || realpathSync.native(plan.cliPath) !== realpathSync.native(deps.cliRoot)
34
+ || typeof plan.canApply !== "boolean" || typeof plan.restartRequired !== "boolean"
35
+ || (plan.targetVersion !== null && !validVersion(plan.targetVersion))
36
+ || (plan.canApply && (!plan.targetVersion || plan.reason !== undefined))
37
+ || (!plan.canApply && (typeof plan.reason !== "string" || !plan.reason))
38
+ || !["service", "desktop-app", "unmanaged", "none", "unknown"].includes(plan.runtimeOwner)
39
+ || !(plan.servingPath === null || typeof plan.servingPath === "string") || typeof plan.updateInFlight !== "boolean"
40
+ || typeof plan.planToken !== "string" || !/^[A-Za-z0-9_-]{16,128}$/.test(plan.planToken)
41
+ || plan.mutationBoundMs !== BOUND) throw Error("invalid plan");
42
+ const admission = decideOrchestratedApply(plan, request, Date.now());
43
+ if (admission.kind === "done") return admission;
44
+ const before = deps.identity(bun);
45
+ const live = before.kind === "live" ? before : null;
46
+ if ((before.kind !== "live" && before.kind !== "absent") || !plan.targetVersion
47
+ || Boolean(live) !== plan.restartRequired || (live?.servingRoot ?? null) !== plan.servingPath
48
+ || createUpdatePlanToken({ currentVersion: plan.currentVersion, targetVersion: plan.targetVersion,
49
+ installer: plan.installer, cliRoot: plan.cliPath, servingRoot: live?.servingRoot ?? null,
50
+ runtimeOwner: plan.runtimeOwner, runtime: live?.runtime ?? null }) !== plan.planToken) return fail("plan-changed");
51
+ let owner;
52
+ if (deps.installer === "pnpm") {
53
+ const resolved = resolvePnpmGlobalOwner({ packageName: "@bitkyc08/opencodex", packagePath: plan.cliPath,
54
+ commandPaths: deps.pnpmCommands, runningShimPath: deps.runningShimPath, runPnpm: deps.runPnpm });
55
+ if (!resolved.ok) return fail("plan-unavailable");
56
+ owner = resolved.owner;
57
+ }
58
+ const start = Date.now();
59
+ channel = createOrchestratedResultChannel();
60
+ const expect = encodeOrchestratedExpect({ home: deps.home, cliRoot: plan.cliPath, servingRoot: live?.servingRoot ?? null,
61
+ runtimePid: live?.runtime.pid ?? null, planToken: plan.planToken });
62
+ const args = [deps.launcher, "update", "--version", plan.targetVersion, "--orchestrated-expect", expect,
63
+ "--orchestrated-result", channel.resultPath, ...(request.notAfter === undefined ? [] : ["--not-after", String(request.notAfter)])];
64
+ const child = deps.spawn(process.execPath, args, { env: { ...process.env, OCX_UPDATE_ORCHESTRATED_CHILD: "1", OCX_UPDATE_RESULT_CAPABILITY: channel.capability }, stdio: ["ignore", 2, 2] });
65
+ started = true;
66
+ const waited = await waitForOrchestratedChild(child, { overrunMs: (request.notAfter ?? start) + BOUND - Date.now() });
67
+ if (!waited.confirmed) {
68
+ child.unref();
69
+ return waited.reason === "overrun" ? { exitCode: 12, result: { ...uncertain().result, error: "overrun" } } : uncertain();
70
+ }
71
+ exited = true;
72
+ const outcome = channel.read();
73
+ const activeRoot = outcome?.phase === "installed" ? outcome.activeRoot : plan.cliPath;
74
+ const verify = (root, version) => deps.installer === "npm"
75
+ ? root === plan.cliPath && verifyOrchestratedInstall(root, version, "npm")
76
+ : verifyOrchestratedPnpmInstall({ owner, activeRoot: root, version, runPnpm: deps.runPnpm });
77
+ const targetVerified = outcome?.phase === "installed" && verify(activeRoot, plan.targetVersion);
78
+ const previousVerified = verify(plan.cliPath, plan.currentVersion);
79
+ let runtimeHealthy = !plan.restartRequired, restarted = false;
80
+ if (plan.restartRequired) {
81
+ try {
82
+ const afterBun = deps.resolveBun();
83
+ const after = afterBun ? deps.identity(afterBun) : null;
84
+ if (after?.kind === "live" && after.servingRoot === activeRoot) {
85
+ runtimeHealthy = after.healthVersion === (outcome?.phase === "installed" ? plan.targetVersion : plan.currentVersion);
86
+ restarted = after.runtime.pid !== live?.runtime.pid;
87
+ }
88
+ } catch {
89
+ return { exitCode: 12, result: { ...uncertain().result, applied: targetVerified, error: "runtime-unverified" } };
90
+ }
91
+ }
92
+ return classifyOrchestratedOutcome({ ...base(), childExited: true, childExitCode: waited.code, outcome,
93
+ previousVerified, targetVerified, runtimeHealthy, restarted });
94
+ } catch {
95
+ return started ? uncertain() : fail("plan-unavailable");
96
+ } finally {
97
+ if (channel && (!started || exited)) channel.dispose();
98
+ }
99
+ }
@@ -0,0 +1,21 @@
1
+ export type Outcome = ({ phase: "preflight" | "mutating" | "overrun" }
2
+ | { phase: "installed"; activeRoot: string; recoveryFailed?: boolean; error?: string }
3
+ | { phase: "refused"; error?: string }
4
+ | { phase: "failed"; error?: string; rollbackPerformed?: boolean }) & { terminationConfirmed?: boolean };
5
+ export interface OutcomeInput {
6
+ fromVersion: string;
7
+ toVersion: string | null;
8
+ installer: "npm" | "pnpm" | "bun" | "mise" | "desktop-app" | "source" | "unknown";
9
+ childExited: boolean;
10
+ childExitCode: number | null;
11
+ outcome: Outcome | null;
12
+ previousVerified: boolean;
13
+ targetVerified: boolean;
14
+ runtimeHealthy: boolean;
15
+ restarted: boolean;
16
+ }
17
+ export declare function classifyOrchestratedOutcome(input: OutcomeInput): {
18
+ exitCode: 0 | 10 | 11 | 12;
19
+ result: { schema: "ocx.update.result/1"; applied: boolean; fromVersion: string; toVersion: string | null;
20
+ installer: OutcomeInput["installer"]; restarted: boolean; healthy: boolean; rolledBack: boolean; error?: string };
21
+ };
@@ -0,0 +1,40 @@
1
+ import { isAbsolute } from "node:path";
2
+
3
+ function validOutcome(outcome) {
4
+ if (!outcome || typeof outcome !== "object" || Array.isArray(outcome)) return false;
5
+ if (!["preflight", "mutating", "installed", "failed", "refused", "overrun"].includes(outcome.phase)) return false;
6
+ if (outcome.error !== undefined && typeof outcome.error !== "string") return false;
7
+ if (outcome.rollbackPerformed !== undefined && typeof outcome.rollbackPerformed !== "boolean") return false;
8
+ if (outcome.terminationConfirmed !== undefined && typeof outcome.terminationConfirmed !== "boolean") return false;
9
+ return outcome.phase !== "installed" || (typeof outcome.activeRoot === "string" && isAbsolute(outcome.activeRoot));
10
+ }
11
+
12
+ /** Classify only independently observed state after confirmed child termination. */
13
+ export function classifyOrchestratedOutcome(input) {
14
+ const result = {
15
+ schema: "ocx.update.result/1", applied: false, fromVersion: input.fromVersion,
16
+ toVersion: input.toVersion, installer: input.installer, restarted: false,
17
+ healthy: false, rolledBack: false,
18
+ };
19
+ const done = (exitCode, error) => ({ exitCode, result: error ? { ...result, error } : result });
20
+ if (!input.childExited || input.childExitCode === null || !validOutcome(input.outcome) || input.outcome.phase === "overrun") return done(12, "outcome-unverified");
21
+ if (input.outcome.terminationConfirmed === false) return done(12, input.outcome.error || "installer-termination-unconfirmed");
22
+ if (input.outcome.phase === "refused" && input.childExitCode !== 0) return done(10, input.outcome.error || "runtime-ownership-refused");
23
+ if (input.outcome.phase === "failed" && input.outcome.error === "installer-termination-unconfirmed") return done(12, input.outcome.error);
24
+ if (input.outcome.phase === "installed") {
25
+ result.applied = input.targetVerified;
26
+ result.restarted = input.restarted;
27
+ result.healthy = input.targetVerified && input.runtimeHealthy && input.childExitCode === 0;
28
+ if (!input.targetVerified) return done(12, "install-unverified");
29
+ if (!result.healthy) return done(12, "runtime-unhealthy");
30
+ return done(0);
31
+ }
32
+ if (["preflight", "mutating", "failed"].includes(input.outcome.phase) && input.childExitCode !== 0
33
+ && input.previousVerified && input.runtimeHealthy) {
34
+ result.healthy = true;
35
+ result.restarted = input.restarted;
36
+ result.rolledBack = input.outcome.phase === "failed" && input.outcome.rollbackPerformed === true;
37
+ return done(11, input.outcome.error || "update-failed");
38
+ }
39
+ return done(12, "outcome-unverified");
40
+ }
@@ -0,0 +1,49 @@
1
+ import { compareStrictSemver, parseStrictSemver } from "../lib/strict-semver";
2
+ import { createUpdatePlanToken } from "./orchestrated-token.mjs";
3
+ import type { ServingIdentity } from "./orchestrated-identity";
4
+
5
+ export const ORCHESTRATED_MUTATION_BOUND_MS = 900_000;
6
+ type Installer = "npm" | "pnpm" | "bun" | "mise" | "desktop-app" | "source" | "unknown";
7
+ type RuntimeOwner = "service" | "desktop-app" | "unmanaged" | "none" | "unknown";
8
+ type Reason = "desktop-app-owned" | "source-checkout" | "mise-managed" | "installer-unknown" | "plan-unavailable" | "serving-install-unknown" | "cli-not-serving-install" | "runtime-ownership-refused" | "target-unresolved" | "downgrade-refused" | "up-to-date";
9
+
10
+ export interface PlanInputs {
11
+ currentVersion: string;
12
+ targetVersion: string | null;
13
+ installer: Installer;
14
+ runtimeOwner: RuntimeOwner;
15
+ cliRoot: string;
16
+ identity: ServingIdentity;
17
+ ownershipPermits: boolean;
18
+ updateInFlight: boolean;
19
+ }
20
+
21
+ /** Construct the public plan from already-observed facts, refusing every uncertain boundary. */
22
+ export function buildOrchestratedPlan(input: PlanInputs) {
23
+ const live = input.identity.kind === "live" ? input.identity : null;
24
+ const servingRoot = live?.servingRoot ?? null;
25
+ const current = parseStrictSemver(input.currentVersion);
26
+ const target = parseStrictSemver(input.targetVersion);
27
+ let reason: Reason | undefined;
28
+ if (input.installer === "desktop-app") reason = "desktop-app-owned";
29
+ else if (input.installer === "source") reason = "source-checkout";
30
+ else if (input.installer === "mise") reason = "mise-managed";
31
+ else if (input.installer === "unknown") reason = "installer-unknown";
32
+ else if (input.identity.kind === "unknown") reason = "serving-install-unknown";
33
+ else if (input.identity.kind === "mismatch") reason = "cli-not-serving-install";
34
+ else if (live && servingRoot !== input.cliRoot) reason = "cli-not-serving-install";
35
+ else if (!input.ownershipPermits || input.runtimeOwner === "unknown") reason = "runtime-ownership-refused";
36
+ else if (!current || !target) reason = "target-unresolved";
37
+ else if (compareStrictSemver(target, current) < 0) reason = "downgrade-refused";
38
+ else if (compareStrictSemver(target, current) === 0) reason = "up-to-date";
39
+ const planToken = createUpdatePlanToken({
40
+ currentVersion: input.currentVersion, targetVersion: input.targetVersion, installer: input.installer,
41
+ cliRoot: input.cliRoot, servingRoot, runtimeOwner: input.runtimeOwner, runtime: live?.runtime ?? null,
42
+ });
43
+ return {
44
+ schema: "ocx.update.plan/1" as const, currentVersion: input.currentVersion, targetVersion: input.targetVersion,
45
+ installer: input.installer, runtimeOwner: input.runtimeOwner, servingPath: servingRoot, cliPath: input.cliRoot,
46
+ canApply: reason === undefined, ...(reason ? { reason } : {}), restartRequired: live !== null,
47
+ planToken, updateInFlight: input.updateInFlight, mutationBoundMs: ORCHESTRATED_MUTATION_BOUND_MS,
48
+ };
49
+ }
@@ -0,0 +1,8 @@
1
+ import type { PnpmGlobalOwner, RunPnpmCandidate } from "./pnpm-global-install.mjs";
2
+
3
+ export declare function verifyOrchestratedPnpmInstall(options: {
4
+ owner: PnpmGlobalOwner;
5
+ activeRoot: string;
6
+ version: string;
7
+ runPnpm: RunPnpmCandidate;
8
+ }): boolean;
@@ -0,0 +1,33 @@
1
+ import { readFileSync, realpathSync, statSync } from "node:fs";
2
+ import { join } from "node:path";
3
+ import { readPnpmGlobalPackage, resolvePnpmGlobalOwner } from "./pnpm-global-install.mjs";
4
+ import { verifyPnpmInstallTree } from "./transactional-install.mjs";
5
+
6
+ const PACKAGE_NAME = "@bitkyc08/opencodex";
7
+
8
+ /** Re-resolve the selected pnpm group and verify its active tree and generated shims. */
9
+ export function verifyOrchestratedPnpmInstall({ owner, activeRoot, version, runPnpm }) {
10
+ try {
11
+ const key = path => {
12
+ const result = realpathSync.native(path);
13
+ return process.platform === "win32" ? result.toLowerCase() : result;
14
+ };
15
+ const verify = (path, expected) => {
16
+ try {
17
+ const manifest = JSON.parse(readFileSync(join(path, "package.json"), "utf8"));
18
+ const source = statSync(join(path, "src", "cli", "index.ts"));
19
+ return { ok: manifest.version === expected && Boolean(manifest.dependencies?.bun && manifest.dependencies?.zod)
20
+ && source.isFile() && source.size > 0 && verifyPnpmInstallTree(path, expected).ok };
21
+ } catch { return { ok: false }; }
22
+ };
23
+ const resolved = resolvePnpmGlobalOwner({ packageName: PACKAGE_NAME, packagePath: activeRoot,
24
+ commandPaths: [owner.commandPath], runPnpm, verify });
25
+ if (!resolved.ok || key(resolved.owner.globalDir) !== key(owner.globalDir)
26
+ || key(resolved.owner.globalRoot) !== key(owner.globalRoot)
27
+ || key(resolved.owner.globalBinDir) !== key(owner.globalBinDir)) return false;
28
+ const active = readPnpmGlobalPackage(PACKAGE_NAME,
29
+ (args, capture) => runPnpm(owner.commandPath, args, capture), verify,
30
+ { owner, expectedPackagePath: activeRoot, expectedGlobalRoot: owner.globalRoot, globalBinDir: owner.globalBinDir });
31
+ return active.ok && active.version === version && key(active.path) === key(activeRoot);
32
+ } catch { return false; }
33
+ }