@bitkyc08/opencodex 2.93.0 → 2.95.0

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 (582) hide show
  1. package/README.md +27 -8
  2. package/bin/ocx.mjs +215 -63
  3. package/gui/dist/assets/App-8yedBkhm.js +58 -0
  4. package/gui/dist/assets/App-B4j-Txmb.css +1 -0
  5. package/gui/dist/assets/Tray-erSMzxPG.js +1 -0
  6. package/gui/dist/assets/index-CHWwDo9L.css +1 -0
  7. package/gui/dist/assets/index-D7DCm5eQ.js +94 -0
  8. package/gui/dist/assets/quota-summary-BK4VuQNc.js +1 -0
  9. package/gui/dist/index.html +2 -2
  10. package/gui/dist/provider-icons/t3code.svg +4 -0
  11. package/package.json +7 -4
  12. package/src/adapters/anthropic/account-metadata.ts +34 -3
  13. package/src/adapters/anthropic/beta-allowlist.ts +5 -5
  14. package/src/adapters/anthropic/passthrough.ts +5 -2
  15. package/src/adapters/anthropic.ts +27 -7
  16. package/src/adapters/antigravity-refusal.ts +29 -0
  17. package/src/adapters/base.ts +11 -1
  18. package/src/adapters/client-fingerprint.ts +43 -9
  19. package/src/adapters/coding-agent/protocol.ts +19 -9
  20. package/src/adapters/command-code-project-context.ts +3 -3
  21. package/src/adapters/command-code.ts +4 -5
  22. package/src/adapters/cursor/catalog.ts +5 -3
  23. package/src/adapters/cursor/claude-id.ts +30 -19
  24. package/src/adapters/cursor/cursor-errors.ts +5 -2
  25. package/src/adapters/cursor/h2-pool.ts +9 -7
  26. package/src/adapters/cursor/http1-bidi.ts +1 -0
  27. package/src/adapters/cursor/live-models.ts +4 -2
  28. package/src/adapters/cursor.ts +4 -1
  29. package/src/adapters/devin/cloud-direct/chat.ts +18 -2
  30. package/src/adapters/google-antigravity-replay.ts +13 -2
  31. package/src/adapters/google-antigravity-wire.ts +8 -3
  32. package/src/adapters/google-errors.ts +33 -0
  33. package/src/adapters/google-http.ts +41 -16
  34. package/src/adapters/google-wire-compiler.ts +4 -0
  35. package/src/adapters/google.ts +21 -10
  36. package/src/adapters/kiro/adapter.ts +7 -1
  37. package/src/adapters/kiro/stream.ts +19 -13
  38. package/src/adapters/kiro-events.ts +1 -0
  39. package/src/adapters/openai-chat/completed-tool-blocks.ts +65 -0
  40. package/src/adapters/openai-chat/messages.ts +42 -17
  41. package/src/adapters/openai-chat/passthrough.ts +4 -2
  42. package/src/adapters/openai-chat/required-tool-result.ts +3 -3
  43. package/src/adapters/openai-chat/serialized-tool-call-content.ts +5 -0
  44. package/src/adapters/openai-chat/single-system.ts +24 -0
  45. package/src/adapters/openai-chat/wire.ts +9 -0
  46. package/src/adapters/openai-chat.ts +18 -17
  47. package/src/adapters/openai-responses/image-gen.ts +15 -1
  48. package/src/adapters/openai-responses/muse-tool-catalog.ts +87 -0
  49. package/src/adapters/openai-responses/passthrough.ts +53 -41
  50. package/src/adapters/openai-responses/prompt-cache.ts +3 -1
  51. package/src/adapters/openai-responses/request-strips.ts +23 -4
  52. package/src/adapters/openai-responses/tool-output-recovery.ts +21 -8
  53. package/src/adapters/openai-responses/tool-schema.ts +20 -8
  54. package/src/adapters/openai-responses/transport.ts +20 -2
  55. package/src/adapters/openai-responses/usage.ts +34 -0
  56. package/src/adapters/opencode-go-additional-tools.ts +39 -6
  57. package/src/adapters/qoder/adapter.ts +9 -15
  58. package/src/adapters/qoder/image-input.ts +52 -0
  59. package/src/adapters/routed-agent-messages.ts +3 -0
  60. package/src/adapters/unique-tool-call-ids.ts +2 -2
  61. package/src/adapters/xai-web-search.ts +6 -3
  62. package/src/adapters/zed-additional-tools.ts +51 -0
  63. package/src/adapters/zed-diagnostic-usage.ts +22 -0
  64. package/src/adapters/zed-json-tokens.ts +166 -0
  65. package/src/adapters/zed-openai-stream.ts +723 -0
  66. package/src/adapters/zed-tool-arguments.ts +79 -0
  67. package/src/adapters/zed.ts +48 -3
  68. package/src/advisor/consult.ts +39 -5
  69. package/src/advisor/runtime.ts +12 -3
  70. package/src/bridge/errors.ts +22 -1
  71. package/src/bridge/max-output-completion.ts +41 -0
  72. package/src/bridge/response-json.ts +13 -5
  73. package/src/bridge/sse.ts +34 -14
  74. package/src/chat/inbound.ts +13 -2
  75. package/src/chatgpt/app-server-shim/bundle-trust-async.ts +111 -0
  76. package/src/chatgpt/app-server-shim/bundle-trust-policy.ts +88 -0
  77. package/src/chatgpt/app-server-shim/bundle-trust.ts +15 -72
  78. package/src/chatgpt/app-server-shim/launcher.ts +40 -6
  79. package/src/claude/compatibility.ts +5 -1
  80. package/src/claude/desktop-3p.ts +27 -6
  81. package/src/claude/desktop-first-party.ts +16 -5
  82. package/src/claude/desktop-gateway-state.ts +4 -0
  83. package/src/claude/desktop-model-visibility.ts +141 -0
  84. package/src/claude/desktop-remote-store-io.ts +8 -8
  85. package/src/claude/inbound-content-options.ts +11 -1
  86. package/src/claude/inbound-tool-loading.ts +93 -0
  87. package/src/claude/intercept/picker-listener.ts +33 -1
  88. package/src/claude/intercept/proxy-auth.ts +16 -16
  89. package/src/claude/model-info.ts +29 -4
  90. package/src/claude/outbound.ts +33 -13
  91. package/src/cli/account-main.ts +44 -5
  92. package/src/cli/capabilities-base.ts +22 -5
  93. package/src/cli/capabilities-integrations.ts +4 -4
  94. package/src/cli/capabilities-provider-models.ts +7 -0
  95. package/src/cli/chatgpt-command.ts +1 -1
  96. package/src/cli/claude-desktop.ts +139 -98
  97. package/src/cli/codex-cli-update.ts +102 -48
  98. package/src/cli/codex-launch-auth.ts +93 -0
  99. package/src/cli/codex-launch-command.ts +32 -0
  100. package/src/cli/codex-launch-diagnostics.ts +37 -0
  101. package/src/cli/codex-launch-ownership.ts +307 -0
  102. package/src/cli/codex-launch-policy.ts +84 -0
  103. package/src/cli/codex-launcher.ts +322 -0
  104. package/src/cli/codex-shim-autorestore.ts +21 -1
  105. package/src/cli/config-command.ts +9 -4
  106. package/src/cli/config-mutation.ts +13 -0
  107. package/src/cli/dispatch.ts +19 -13
  108. package/src/cli/doctor.ts +5 -5
  109. package/src/cli/effort.ts +19 -14
  110. package/src/cli/ensure-desired-integrations.ts +21 -14
  111. package/src/cli/ensure-desktop-cold-start.ts +41 -10
  112. package/src/cli/export-command.ts +8 -4
  113. package/src/cli/help.ts +3 -1
  114. package/src/cli/index.ts +62 -73
  115. package/src/cli/init.ts +2 -2
  116. package/src/cli/integration-input.ts +12 -0
  117. package/src/cli/integration-plan-dto.ts +2 -0
  118. package/src/cli/integration-preview.ts +6 -3
  119. package/src/cli/integrations.ts +2 -1
  120. package/src/cli/internal-command.ts +29 -2
  121. package/src/cli/link-cleanup.ts +8 -23
  122. package/src/cli/link-enrollment.ts +1 -4
  123. package/src/cli/link.ts +1 -1
  124. package/src/cli/loopback-family.ts +2 -31
  125. package/src/cli/models.ts +62 -49
  126. package/src/cli/provider-cc-switch-import.ts +185 -0
  127. package/src/cli/provider.ts +151 -139
  128. package/src/cli/registry.ts +35 -3
  129. package/src/cli/restart-scope.ts +2 -2
  130. package/src/cli/root.ts +8 -6
  131. package/src/cli/start-owner-fence.ts +22 -3
  132. package/src/cli/status-link.ts +28 -0
  133. package/src/cli/status.ts +15 -0
  134. package/src/cli/stop-approval.ts +15 -1
  135. package/src/cli/stop-restore-guard.ts +48 -0
  136. package/src/cli/stop-restore.ts +117 -36
  137. package/src/cli/system-command.ts +2 -0
  138. package/src/cli/v2.ts +86 -23
  139. package/src/client/lifecycle-lock.ts +1 -1
  140. package/src/client/link-connection.ts +19 -0
  141. package/src/client/link-relay-transport.ts +25 -3
  142. package/src/client/link-tunnel.ts +10 -0
  143. package/src/client/machine-api.ts +2 -2
  144. package/src/client/machine-listener.ts +7 -1
  145. package/src/client/restore-ownership.ts +45 -0
  146. package/src/client/runtime.ts +13 -1
  147. package/src/client/state.ts +1 -1
  148. package/src/clients/client-ids.ts +7 -0
  149. package/src/clients/client-path.ts +13 -5
  150. package/src/clients/config-export/agent-clients.ts +3 -6
  151. package/src/clients/config-export/alias-selectors.ts +85 -0
  152. package/src/clients/config-export/contracts.ts +6 -25
  153. package/src/clients/config-export/dsh.ts +8 -1
  154. package/src/clients/config-export/model-metadata.ts +19 -0
  155. package/src/clients/config-export/model-names.ts +31 -0
  156. package/src/clients/config-export/qoder.ts +3 -11
  157. package/src/clients/config-export/t3code.ts +141 -0
  158. package/src/clients/config-export.ts +65 -18
  159. package/src/clients/gentle-shell-path.ts +3 -3
  160. package/src/codex/account-cooldown-response.ts +18 -0
  161. package/src/codex/account-lifecycle.ts +27 -13
  162. package/src/codex/account-store.ts +32 -6
  163. package/src/codex/app-server-processes.ts +84 -1
  164. package/src/codex/app-server-restart-service.ts +2 -2
  165. package/src/codex/auth-api/login-flow.ts +2 -2
  166. package/src/codex/auth-api/main-account-probe.ts +50 -11
  167. package/src/codex/auth-api/pool-mode-gate.ts +16 -8
  168. package/src/codex/auth-api/pool-quota-probe.ts +2 -2
  169. package/src/codex/auth-context.ts +49 -8
  170. package/src/codex/catalog/antigravity-discovery.ts +59 -0
  171. package/src/codex/catalog/build-entries.ts +12 -13
  172. package/src/codex/catalog/bundled.ts +67 -10
  173. package/src/codex/catalog/derive-entry.ts +2 -0
  174. package/src/codex/catalog/gather-capture.ts +3 -0
  175. package/src/codex/catalog/metadata.ts +10 -10
  176. package/src/codex/catalog/model-hints.ts +36 -4
  177. package/src/codex/catalog/native-omission.ts +28 -0
  178. package/src/codex/catalog/native-priority.ts +63 -0
  179. package/src/codex/catalog/native-template.ts +58 -0
  180. package/src/codex/catalog/parsing.ts +3 -29
  181. package/src/codex/catalog/provider-models.ts +22 -5
  182. package/src/codex/catalog/retained-sync.ts +16 -6
  183. package/src/codex/catalog/write-audit.ts +18 -18
  184. package/src/codex/chatgpt-refresh-failure.ts +2 -2
  185. package/src/codex/cli-install-provenance.ts +103 -74
  186. package/src/codex/cli-installation-identity.ts +1 -1
  187. package/src/codex/cli-installation-limits.ts +7 -0
  188. package/src/codex/cli-update-apply.ts +391 -0
  189. package/src/codex/cli-update-artifacts.ts +259 -0
  190. package/src/codex/cli-update-files.ts +100 -0
  191. package/src/codex/cli-update-inspection-context.ts +49 -0
  192. package/src/codex/cli-update-job-execution.ts +77 -0
  193. package/src/codex/cli-update-job-store-windows.ts +1082 -0
  194. package/src/codex/cli-update-job-worker.ts +385 -0
  195. package/src/codex/cli-update-job.ts +369 -0
  196. package/src/codex/cli-update-lease.ts +71 -0
  197. package/src/codex/cli-update-paths.ts +76 -0
  198. package/src/codex/cli-update-plan.ts +180 -47
  199. package/src/codex/cli-update-recovery.ts +282 -0
  200. package/src/codex/cli-update-selection-gate.ts +305 -0
  201. package/src/codex/cli-update-windows-apply.ts +308 -0
  202. package/src/codex/cli-update-windows-layout.ts +110 -0
  203. package/src/codex/cli-update-windows-observation.ts +91 -0
  204. package/src/codex/cli-update-windows-paths.ts +26 -0
  205. package/src/codex/cli-update-worker-recovery.ts +32 -0
  206. package/src/codex/cli-update-worker.ts +185 -0
  207. package/src/codex/cli-windows-plan-provenance.ts +268 -0
  208. package/src/codex/codex-home-owner.ts +9 -8
  209. package/src/codex/convergence.ts +13 -3
  210. package/src/codex/coordinator-doctor.ts +14 -8
  211. package/src/codex/desktop-app/handoff.ts +1 -1
  212. package/src/codex/desktop-app-restart.ts +32 -3
  213. package/src/codex/exec-boundary.ts +229 -0
  214. package/src/codex/forward-transport-headers.ts +80 -0
  215. package/src/codex/history-job.ts +7 -0
  216. package/src/codex/history-provider.ts +16 -12
  217. package/src/codex/history-worker.ts +20 -1
  218. package/src/codex/inject/bounded-config-reader.ts +14 -13
  219. package/src/codex/inject/restore.ts +57 -25
  220. package/src/codex/internal/history-writer.ts +2 -1
  221. package/src/codex/mac-app-bundle.ts +52 -0
  222. package/src/codex/main-account.ts +167 -29
  223. package/src/codex/native-main-auth-temp.ts +3 -2
  224. package/src/codex/native-main-lock-file.ts +13 -12
  225. package/src/codex/native-main-refresh-mode.ts +18 -3
  226. package/src/codex/native-profile-manager.ts +8 -6
  227. package/src/codex/native-profile-store.ts +9 -0
  228. package/src/codex/native-residue.ts +18 -14
  229. package/src/codex/ocx-compaction-history.ts +3 -2
  230. package/src/codex/orca-auth-source.ts +8 -7
  231. package/src/codex/prompt-text-probe.ts +211 -69
  232. package/src/codex/quota-types.ts +5 -0
  233. package/src/codex/quota.ts +58 -7
  234. package/src/codex/role-auto-assign.ts +50 -26
  235. package/src/codex/role-capability.ts +160 -0
  236. package/src/codex/role-model-history.ts +253 -0
  237. package/src/codex/role-sizing.ts +24 -6
  238. package/src/codex/routing/cooldown-math.ts +3 -2
  239. package/src/codex/runtime.ts +161 -72
  240. package/src/codex/shim-fingerprint.ts +11 -9
  241. package/src/codex/shim-inspect.ts +3 -2
  242. package/src/codex/shim-overlay.ts +22 -3
  243. package/src/codex/shim-restore-lock.ts +11 -14
  244. package/src/codex/shim-state-file.ts +22 -14
  245. package/src/codex/shim-templates.ts +5 -2
  246. package/src/codex/shim-wrapper-write.ts +137 -0
  247. package/src/codex/shim.ts +48 -126
  248. package/src/codex/transition-state.ts +5 -4
  249. package/src/codex/windows-cli-child-native.ts +119 -0
  250. package/src/codex/windows-cli-child-pipe.ts +87 -0
  251. package/src/codex/windows-cli-child.ts +260 -0
  252. package/src/codex/windows-cli-recovery-guardian.ts +89 -0
  253. package/src/codex/windows-cli-recovery.ts +39 -0
  254. package/src/codex/windows-installation-files.ts +52 -6
  255. package/src/codex/windows-npm-execution.ts +25 -0
  256. package/src/combos/failover.ts +127 -9
  257. package/src/combos/index.ts +1 -0
  258. package/src/combos/resolve.ts +60 -22
  259. package/src/config/atomic-write.ts +113 -29
  260. package/src/config/diagnostics.ts +21 -10
  261. package/src/config/initialize.ts +6 -6
  262. package/src/config/live-reconcile.ts +11 -3
  263. package/src/config/load-degrade.ts +2 -0
  264. package/src/config/owner-registry.ts +5 -4
  265. package/src/config/persist-unlocked.ts +34 -8
  266. package/src/config/persisted-mutation.ts +7 -0
  267. package/src/config/process-state.ts +32 -10
  268. package/src/config/removed-opencode-free-backup.ts +99 -0
  269. package/src/config/removed-opencode-free.ts +4 -8
  270. package/src/config/salvage.ts +2 -0
  271. package/src/config/schema/config-schema.ts +44 -1
  272. package/src/config/schema/leaf-validators.ts +22 -0
  273. package/src/config/schema/workflow-budget.ts +43 -0
  274. package/src/config/tracked-runtime-inspection.ts +188 -0
  275. package/src/config.ts +4 -4
  276. package/src/generated/compatibility-version.json +962 -434
  277. package/src/grok/inject.ts +2 -1
  278. package/src/grok/sync.ts +5 -2
  279. package/src/images/loop.ts +14 -5
  280. package/src/integrations/aside-profile-context.ts +1 -1
  281. package/src/integrations/catalog-refresh.ts +1 -1
  282. package/src/integrations/droid-settings.ts +4 -4
  283. package/src/integrations/hermes-profiles.ts +3 -3
  284. package/src/integrations/hermes-refresh.ts +28 -0
  285. package/src/integrations/model-name-guard.ts +31 -0
  286. package/src/integrations/mutation-plan.ts +17 -4
  287. package/src/integrations/ownership.ts +3 -0
  288. package/src/integrations/registry.ts +10 -1
  289. package/src/integrations/state.ts +6 -0
  290. package/src/integrations/writer.ts +64 -59
  291. package/src/lib/abort.ts +8 -4
  292. package/src/lib/bounded-body.ts +7 -1
  293. package/src/lib/bounded-file-read.ts +3 -9
  294. package/src/lib/bun-runtime-preflight.ts +9 -8
  295. package/src/lib/config-ownership.ts +4 -0
  296. package/src/lib/errors.ts +2 -0
  297. package/src/lib/eventstream-decoder.ts +3 -2
  298. package/src/lib/file-identity.ts +15 -0
  299. package/src/lib/http-response-semantics.ts +9 -6
  300. package/src/lib/inbound-body-policy.ts +11 -0
  301. package/src/lib/jsonc.ts +7 -2
  302. package/src/lib/local-chat-completion.ts +8 -6
  303. package/src/lib/local-destinations.ts +32 -3
  304. package/src/lib/local-management-capability.ts +3 -1
  305. package/src/lib/local-upstream.ts +22 -26
  306. package/src/lib/loopback-family.ts +31 -0
  307. package/src/lib/plain-data.ts +7 -5
  308. package/src/lib/process-control.ts +30 -5
  309. package/src/lib/redact-folding.ts +9 -0
  310. package/src/lib/shadow-call.ts +55 -1
  311. package/src/lib/spend-pool-alias-validation.ts +6 -6
  312. package/src/lib/state-store-registrations.ts +2 -0
  313. package/src/lib/test-home-guard.ts +37 -9
  314. package/src/lib/tool-argument-integers.ts +99 -7
  315. package/src/lib/upstream-retry.ts +6 -1
  316. package/src/lib/windows-elevation.ts +34 -11
  317. package/src/lib/windows-owner-acl.ts +272 -32
  318. package/src/lib/windows-secret-acl.ts +328 -44
  319. package/src/lib/windows-service-wrappers.ts +10 -7
  320. package/src/lib/winsw.ts +8 -4
  321. package/src/lib/workflow-budget-config.ts +39 -0
  322. package/src/link/relay-auth.ts +38 -1
  323. package/src/link/remote-platform.ts +11 -23
  324. package/src/link/remote-probe.ts +3 -1
  325. package/src/link/remote-windows.ts +150 -0
  326. package/src/link/ssh-argv.ts +13 -5
  327. package/src/link/store.ts +4 -1
  328. package/src/link/supervisor.ts +9 -0
  329. package/src/local-credentials/generation.ts +242 -0
  330. package/src/local-credentials/inventory.ts +405 -0
  331. package/src/local-credentials/observation-lease.ts +83 -0
  332. package/src/local-credentials/publication-fence.ts +81 -0
  333. package/src/local-credentials/references.ts +36 -0
  334. package/src/local-credentials/runtime-observation.ts +28 -0
  335. package/src/messaging/remote-forward-failure.ts +35 -0
  336. package/src/messaging/remote-ports.ts +27 -5
  337. package/src/messaging/remote-process.ts +30 -4
  338. package/src/messaging/remote-tunnels.ts +80 -15
  339. package/src/oauth/account-auto-pause-policy.ts +11 -0
  340. package/src/oauth/anthropic-account-refusal.ts +1 -0
  341. package/src/oauth/anthropic-rate-limit-policy.ts +26 -2
  342. package/src/oauth/anthropic-routing.ts +34 -44
  343. package/src/oauth/anthropic-session-affinity-store.ts +177 -0
  344. package/src/oauth/antigravity-discovery-diagnostics.ts +65 -0
  345. package/src/oauth/chatgpt.ts +11 -9
  346. package/src/oauth/cursor.ts +8 -2
  347. package/src/oauth/generic-account-failover.ts +33 -2
  348. package/src/oauth/generic-session-affinity.ts +7 -0
  349. package/src/oauth/google-antigravity.ts +49 -12
  350. package/src/oauth/index.ts +3 -0
  351. package/src/oauth/kiro-device-login.ts +87 -30
  352. package/src/oauth/kiro-iam-identity-center.ts +107 -0
  353. package/src/oauth/store.ts +41 -11
  354. package/src/protocols/encoders/adapter-events.ts +7 -4
  355. package/src/protocols/encoders/messages.ts +1 -1
  356. package/src/providers/account-quota-disk.ts +18 -4
  357. package/src/providers/antigravity-account-roster.ts +73 -7
  358. package/src/providers/antigravity-models.ts +8 -4
  359. package/src/providers/api-key-resolve.ts +16 -3
  360. package/src/providers/cc-switch-import-bytes.ts +991 -0
  361. package/src/providers/cc-switch-import-source.ts +1083 -0
  362. package/src/providers/cc-switch-import.ts +942 -0
  363. package/src/providers/claude-cli-identity.ts +2 -0
  364. package/src/providers/codex-capacity.ts +3 -2
  365. package/src/providers/derive.ts +6 -0
  366. package/src/providers/free-directory.ts +10 -2
  367. package/src/providers/key-store.ts +7 -2
  368. package/src/providers/model-discovery-diagnostic.ts +4 -0
  369. package/src/providers/model-discovery.ts +4 -4
  370. package/src/providers/model-rename-fields.ts +2 -0
  371. package/src/providers/model-rename-migration.ts +41 -6
  372. package/src/providers/provider-id-rewrite.ts +3 -0
  373. package/src/providers/quota/antigravity.ts +6 -4
  374. package/src/providers/quota/report-cache.ts +17 -4
  375. package/src/providers/quota/vendor-probes-oauth.ts +0 -1
  376. package/src/providers/quota.ts +2 -2
  377. package/src/providers/reasoning-metadata.ts +31 -15
  378. package/src/providers/registry/entries-core.ts +1 -1
  379. package/src/providers/registry/entries-extended.ts +1 -1
  380. package/src/providers/registry/model-ids.ts +1 -0
  381. package/src/providers/registry/model-seeds.ts +2 -1
  382. package/src/providers/registry/types.ts +3 -1
  383. package/src/providers/resolved-model-policy.ts +2 -2
  384. package/src/providers/routed-config.ts +2 -0
  385. package/src/providers/stale-model-roster-migration.ts +8 -1
  386. package/src/providers/xai-transport.ts +4 -4
  387. package/src/quota-pool/assemble.ts +51 -21
  388. package/src/quota-pool/pooled.ts +162 -0
  389. package/src/remote-control/workspace-codex-runtime.ts +63 -20
  390. package/src/remote-control/workspace-executor.ts +14 -13
  391. package/src/responses/apply-patch-envelope.ts +35 -0
  392. package/src/responses/compaction-history-framing.ts +15 -4
  393. package/src/responses/custom-tool-compat.ts +2 -1
  394. package/src/responses/item-provenance.ts +79 -0
  395. package/src/responses/namespace-tool-compat.ts +21 -3
  396. package/src/responses/turn-membership.ts +111 -0
  397. package/src/router.ts +21 -2
  398. package/src/routing/analytics.ts +3 -5
  399. package/src/routing/fallback-policy.ts +7 -3
  400. package/src/routing/health.ts +5 -3
  401. package/src/routing/history/build-file.ts +6 -0
  402. package/src/routing/history/indexer.ts +158 -31
  403. package/src/routing/history/ingest.ts +1 -1
  404. package/src/routing/history/integrity.ts +208 -0
  405. package/src/routing/history/rebuild-job.ts +20 -6
  406. package/src/routing/history/rebuild-protocol.ts +2 -1
  407. package/src/routing/history/rebuild-worker.ts +18 -0
  408. package/src/routing/history/sqlite-errors.ts +9 -0
  409. package/src/server/admission-model-scope.ts +21 -4
  410. package/src/server/advisor-admission-scope.ts +72 -0
  411. package/src/server/audio-upstream.ts +10 -2
  412. package/src/server/auth-cors.ts +28 -2
  413. package/src/server/bind-host.ts +5 -0
  414. package/src/server/capture-admission-policy.ts +91 -0
  415. package/src/server/chat-completions.ts +47 -6
  416. package/src/server/chat-native.ts +16 -11
  417. package/src/server/claude-messages.ts +99 -3
  418. package/src/server/codex-model-list.ts +47 -0
  419. package/src/server/configured-credentials.ts +5 -0
  420. package/src/server/gui-session.ts +5 -2
  421. package/src/server/inbound-body-admission.ts +21 -13
  422. package/src/server/inbound-body-budget.ts +128 -0
  423. package/src/server/index/link-listener.ts +3 -1
  424. package/src/server/index/link-relay-sessions.ts +9 -2
  425. package/src/server/index/optional-listeners.ts +1 -0
  426. package/src/server/index/serve-options.ts +21 -45
  427. package/src/server/index/websocket-handler.ts +10 -0
  428. package/src/server/index.ts +6 -5
  429. package/src/server/inference/client-encoder-delivery.ts +3 -1
  430. package/src/server/lifecycle.ts +8 -1
  431. package/src/server/management/advisor-routes.ts +26 -9
  432. package/src/server/management/agent-settings-routes.ts +455 -549
  433. package/src/server/management/anthropic-reset-grant-routes.ts +2 -1
  434. package/src/server/management/claude-code-settings-patch.ts +211 -0
  435. package/src/server/management/claude-desktop-config-writers.ts +78 -0
  436. package/src/server/management/codex-agent-role-routes.ts +80 -2
  437. package/src/server/management/codex-cli-update-routes.ts +55 -0
  438. package/src/server/management/codex-prompt-routes.ts +2 -1
  439. package/src/server/management/codex-role-auto-assign.ts +50 -6
  440. package/src/server/management/config-routes.ts +459 -384
  441. package/src/server/management/consent-session.ts +6 -0
  442. package/src/server/management/context.ts +3 -0
  443. package/src/server/management/desktop-compatibility-authorization.ts +12 -0
  444. package/src/server/management/desktop-compatibility-routes.ts +3 -2
  445. package/src/server/management/desktop-compatibility-runtime-routes.ts +2 -1
  446. package/src/server/management/desktop-compatibility-settings-routes.ts +2 -1
  447. package/src/server/management/integration-routes.ts +45 -5
  448. package/src/server/management/link-enrollment.ts +21 -32
  449. package/src/server/management/link-route-state.ts +1 -0
  450. package/src/server/management/link-routes.ts +4 -1
  451. package/src/server/management/model-routes.ts +22 -6
  452. package/src/server/management/model-rows.ts +3 -1
  453. package/src/server/management/native-integration-routes.ts +112 -38
  454. package/src/server/management/oauth-account-routes.ts +28 -11
  455. package/src/server/management/provider-overwrite-carry.ts +21 -0
  456. package/src/server/management/provider-routes.ts +3 -1
  457. package/src/server/management/route-registry.ts +10 -3
  458. package/src/server/management/session-routes.ts +20 -2
  459. package/src/server/management/shadow-call-validation.ts +43 -2
  460. package/src/server/management/shared.ts +17 -1
  461. package/src/server/management/sidebar-routes.ts +2 -1
  462. package/src/server/management/system-restart.ts +47 -7
  463. package/src/server/management/workflow-budget-routes.ts +70 -3
  464. package/src/server/management-api.ts +61 -51
  465. package/src/server/management-auth.ts +11 -3
  466. package/src/server/messages-native-eligibility.ts +6 -5
  467. package/src/server/messages-native-scope.ts +6 -1
  468. package/src/server/messages-native.ts +21 -7
  469. package/src/server/messages-shared.ts +161 -29
  470. package/src/server/persistent-gui-session.ts +155 -0
  471. package/src/server/port-reclaim.ts +29 -5
  472. package/src/server/proxy-liveness.ts +110 -33
  473. package/src/server/request-decompress.ts +5 -1
  474. package/src/server/request-log.ts +30 -2
  475. package/src/server/responses/account-change-state.ts +14 -2
  476. package/src/server/responses/adapter-continuation.ts +5 -4
  477. package/src/server/responses/adapter-delivery.ts +24 -5
  478. package/src/server/responses/adapter-dispatch.ts +39 -45
  479. package/src/server/responses/advisor-plan-slot.ts +7 -0
  480. package/src/server/responses/advisor-slot.ts +77 -48
  481. package/src/server/responses/antigravity-model-denial-recovery.ts +70 -0
  482. package/src/server/responses/antigravity-validation-refusal.ts +6 -0
  483. package/src/server/responses/codex-auth-error.ts +5 -1
  484. package/src/server/responses/combo-required-tool-contract.ts +29 -1
  485. package/src/server/responses/combo-required-tool-fulfillments.ts +58 -0
  486. package/src/server/responses/combo-required-tool-stream.ts +119 -0
  487. package/src/server/responses/combo-stream-preflight.ts +47 -7
  488. package/src/server/responses/compact.ts +18 -8
  489. package/src/server/responses/compaction-recovery.ts +2 -1
  490. package/src/server/responses/core-auth.ts +2 -1
  491. package/src/server/responses/core-codex-account.ts +1 -0
  492. package/src/server/responses/core-combo-failure.ts +13 -6
  493. package/src/server/responses/core-combo-native.ts +6 -5
  494. package/src/server/responses/core-combo.ts +159 -25
  495. package/src/server/responses/core-lifetime.ts +4 -0
  496. package/src/server/responses/core-options.ts +16 -0
  497. package/src/server/responses/core.ts +2 -0
  498. package/src/server/responses/fetch-helpers.ts +5 -1
  499. package/src/server/responses/jev-model-invoke.ts +10 -3
  500. package/src/server/responses/memory-models.ts +3 -2
  501. package/src/server/responses/passthrough-delivery.ts +36 -8
  502. package/src/server/responses/passthrough-dispatch.ts +17 -16
  503. package/src/server/responses/policy-fallback.ts +2 -0
  504. package/src/server/responses/request-prepare.ts +14 -6
  505. package/src/server/responses/request-send-budget.ts +2 -1
  506. package/src/server/responses/request-sidecar-auth.ts +1 -0
  507. package/src/server/responses/request-transport.ts +43 -9
  508. package/src/server/responses/run-turn-execution.ts +15 -3
  509. package/src/server/responses/sidecar-execution.ts +26 -5
  510. package/src/server/responses/turn-membership.ts +30 -0
  511. package/src/server/responses-custom-tool-repair.ts +86 -11
  512. package/src/server/responses-image-gen-repair.ts +1 -1
  513. package/src/server/responses-snapshot-repair.ts +18 -4
  514. package/src/server/responses-undeclared-tool-guard.ts +4 -0
  515. package/src/server/restart-parent-ownership.ts +49 -0
  516. package/src/server/stop-teardown.ts +46 -9
  517. package/src/server/windows-tcp-drop.ts +4 -2
  518. package/src/server/workflow-refusal.ts +2 -1
  519. package/src/service/desktop-recovery-process.ts +341 -0
  520. package/src/service/desktop-recovery.ts +172 -0
  521. package/src/service/state-lock.ts +12 -11
  522. package/src/service/windows-ops.ts +6 -3
  523. package/src/service/windows-scheduler.ts +29 -6
  524. package/src/service-manager-probe.ts +53 -8
  525. package/src/stall-timeout.ts +47 -0
  526. package/src/tray/windows.ts +6 -4
  527. package/src/types/admission-policy.ts +13 -0
  528. package/src/types/config.ts +86 -10
  529. package/src/types/provider.ts +10 -0
  530. package/src/types/request.ts +8 -1
  531. package/src/types.ts +2 -0
  532. package/src/update/async-check.ts +4 -3
  533. package/src/update/bind-probe.ts +2 -2
  534. package/src/update/codex-cli-update-launch-policy.mjs +9 -0
  535. package/src/update/guarded-port-reclaim.ts +14 -0
  536. package/src/update/guarded-runtime-ops.ts +58 -0
  537. package/src/update/guarded-tray-ops.ts +9 -0
  538. package/src/update/index.ts +196 -58
  539. package/src/update/job-pinned-start.ts +53 -0
  540. package/src/update/job-supervised-restart.ts +23 -6
  541. package/src/update/job-update-home.ts +62 -0
  542. package/src/update/job-update-tray.ts +29 -0
  543. package/src/update/job-windows-restart.ts +39 -0
  544. package/src/update/job.ts +199 -193
  545. package/src/update/mutation-guard.d.mts +30 -0
  546. package/src/update/mutation-guard.mjs +103 -0
  547. package/src/update/notify.ts +2 -2
  548. package/src/update/npm-cache-preflight.mjs +4 -4
  549. package/src/update/npm-install.mjs +5 -3
  550. package/src/update/pnpm-read-policy.mjs +3 -2
  551. package/src/update/proxy-liveness-probe.mjs +2 -2
  552. package/src/update/service-home-authority.ts +35 -0
  553. package/src/update/service-home-package-only-protocol.json +1 -0
  554. package/src/update/service-home-policy.d.mts +25 -0
  555. package/src/update/service-home-policy.mjs +112 -0
  556. package/src/update/service-home-probe-entry.ts +9 -0
  557. package/src/update/service-home-probe.d.mts +15 -0
  558. package/src/update/service-home-probe.mjs +79 -0
  559. package/src/update/service-home-protocol.json +1 -0
  560. package/src/update/supervised-recovery.d.mts +2 -2
  561. package/src/update/supervised-recovery.mjs +14 -7
  562. package/src/update/transactional-install.d.mts +3 -1
  563. package/src/update/transactional-install.mjs +29 -19
  564. package/src/update/update-failure-guidance.mjs +1 -1
  565. package/src/update/worker-launch.ts +74 -4
  566. package/src/usage/log.ts +25 -4
  567. package/src/vision/anthropic-describe.ts +2 -1
  568. package/src/vision/index.ts +2 -0
  569. package/src/vision/plan.ts +4 -0
  570. package/src/vision/routed-describe.ts +38 -23
  571. package/src/web-search/anthropic-executor.ts +2 -1
  572. package/src/web-search/anthropic-history.ts +1 -0
  573. package/src/web-search/format-result.ts +3 -2
  574. package/src/web-search/header-deadline.ts +3 -2
  575. package/src/web-search/loop.ts +113 -12
  576. package/src/web-search/parse.ts +201 -40
  577. package/gui/dist/assets/App-CizjBqyk.js +0 -58
  578. package/gui/dist/assets/App-DMps4OLk.css +0 -1
  579. package/gui/dist/assets/Tray-DamiMqcX.js +0 -1
  580. package/gui/dist/assets/index-DQsht3vH.js +0 -94
  581. package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
  582. package/gui/dist/assets/quota-summary-BXu4zE8H.js +0 -1
package/src/update/job.ts CHANGED
@@ -1,19 +1,19 @@
1
- import { spawn, spawnSync, type ChildProcess } from "node:child_process";
2
- import { existsSync, mkdirSync, openSync, readFileSync, writeSync } from "node:fs";
1
+ import { guardedRun, guardedSpawnSync, materializeMutationData } from "./mutation-guard.mjs";
2
+ import type { ChildProcess } from "node:child_process";
3
+ import { probeSpawn, probeSpawnSync } from "./mutation-guard.mjs";
4
+ import { existsSync, mkdirSync, readFileSync } from "node:fs";
3
5
  import { dirname, join, sep } from "node:path";
4
6
  import { fileURLToPath } from "node:url";
5
7
  import { atomicWriteFile, getConfigDir, loadConfig } from "../config";
6
- import { readPid, readRuntimePort, removePid, removeRuntimePort, verifyPidIdentity } from "../config/process-state";
7
- import { isProcessAlive, killProxy } from "../lib/process-control";
8
+ import { readPid, readRuntimePort, verifyPidIdentity } from "../config/process-state";
9
+ import { isProcessAlive } from "../lib/process-control";
8
10
  import { selfLaunchArgv } from "../lib/self-launch-argv";
9
- import { killWindowsSchedulerWrappers } from "../lib/windows-service-wrappers";
10
- import {
11
- buildWindowsElevatedArgumentList,
11
+ import { buildWindowsElevatedArgumentList,
12
12
  resolveTrustedWindowsPowerShellExe,
13
13
  } from "../lib/windows-elevation";
14
- import { stopWinswService } from "../lib/winsw";
15
- import { listListenPids, reclaimListenPort, scanListenPids, type ListenPidScan } from "../server/port-reclaim";
16
- import { dropWindowsTcpRowsForLocalPort } from "../server/windows-tcp-drop";
14
+ import { listListenPids, scanListenPids, type ListenPidScan } from "../server/port-reclaim";
15
+ import { guardedReclaimListenPort as reclaimListenPort } from "./guarded-port-reclaim";
16
+ import { guardedKillProxy, guardedRemovePid, guardedRemoveRuntimePort, guardedDropWindowsTcp, guardedPublishJob, type KillProxy } from "./guarded-runtime-ops";
17
17
  import {
18
18
  isHealthzVersion,
19
19
  isOpencodexHealthz,
@@ -21,7 +21,9 @@ import {
21
21
  proxyIdentityAt,
22
22
  type HealthzIdentity,
23
23
  } from "../server/proxy-liveness";
24
- import { isServiceInstalled, isServiceViable, readServiceBackend, stopWindows } from "../service";
24
+ import { isServiceInstalled, isServiceViable } from "../service";
25
+ import { stopWindowsServiceWrappersBestEffort } from "./job-windows-restart";
26
+ import { createUpdateServiceHomePolicy, inspectUpdateServiceHome, type UpdateServiceHomeInspector } from "./service-home-authority";
25
27
  import { runUpdateRestartWithOwnershipLease, type ServiceOwnershipResolution } from "./restart-ownership";
26
28
  import { restartServiceManagerAfterUpdate, unsettledManagerRestartFailure, unsupervisedRestartFailure, type ManagerRestartFn } from "./job-supervised-restart";
27
29
  import {
@@ -44,7 +46,7 @@ export type { UpdateCheckDeps } from "./check-types";
44
46
  import type { PnpmGlobalOwner } from "./pnpm-global-install.mjs";
45
47
  import { isNewer } from "./notify";
46
48
  import { isRealBunBinary } from "../lib/bun-binary-validator.mjs";
47
- import { handoffWindowsTrayForUpdate, planWindowsTrayUpdate } from "./tray-update-plan.mjs";
49
+ import { planWindowsTrayUpdate } from "./tray-update-plan.mjs";
48
50
  import { GUI_UPDATE_FAILURE_NEXT_STEP } from "./update-failure-guidance.mjs";
49
51
  import {
50
52
  npmCachePreflightFailureMessage,
@@ -52,7 +54,10 @@ import {
52
54
  type NpmCachePreflightReason,
53
55
  } from "./npm-cache-preflight.mjs";
54
56
  import { guiUpdateWorkerCommand } from "./worker-launch";
55
- import { withoutSiblingMarker } from "../codex/sibling-start";
57
+ import { prepareWorkerUpdateHome, packageOnlyUpdateSucceeded } from "./job-update-home";
58
+ import { defaultWorkerTrayHandoff } from "./job-update-tray";
59
+ import { spawnWorkerPinnedStart } from "./job-pinned-start";
60
+ import type { UpdateMutationAuthorizer } from "./mutation-guard.mjs";
56
61
  import { spawnBindProbe, strictBindProbeScript } from "./bind-probe";
57
62
  import { withoutUpdateTeardownHandover, withUpdateTeardownHandover } from "./teardown-handover";
58
63
  import type { WorkerLaunchContext } from "./worker-launch";
@@ -169,11 +174,8 @@ async function strictRuntimePortAvailable(port: number, hostname = "127.0.0.1"):
169
174
  return spawnBindProbe(process.execPath, script);
170
175
  }
171
176
 
172
- /**
173
- * Wait until netstat reports no LISTEN owners on `port` AND the start runtime
174
- * can bind. Dead PIDs still appear as holders while the ghost TCB lives;
175
- * SetTcpEntry is a no-op without elevation (rc 317), so wait them out.
176
- */
177
+ /** Wait for no LISTEN owners plus a bindable port. Dead PIDs retain ghost TCBs;
178
+ * SetTcpEntry needs elevation (rc 317 otherwise), so wait them out. */
177
179
  async function waitForGhostListenClear(
178
180
  port: number,
179
181
  hostname: string,
@@ -181,6 +183,7 @@ async function waitForGhostListenClear(
181
183
  timeoutMs: number,
182
184
  sleep: (ms: number) => Promise<void>,
183
185
  aliveFn: (pid: number) => boolean = isProcessAlive,
186
+ authorizeMutation: (kind: "runtime") => boolean = () => true,
184
187
  ): Promise<{ ok: boolean; accessDenied: boolean }> {
185
188
  const deadline = Date.now() + timeoutMs;
186
189
  let accessDenied = false;
@@ -189,8 +192,9 @@ async function waitForGhostListenClear(
189
192
  const liveHolders = holders.filter(pid => aliveFn(pid));
190
193
  // Never SetTcpEntry while a live process still owns the port (foreign or ocx).
191
194
  if (process.platform === "win32" && liveHolders.length === 0) {
195
+ if (!authorizeMutation("runtime")) return { ok: false, accessDenied };
192
196
  try {
193
- const drop = dropWindowsTcpRowsForLocalPort(port);
197
+ const drop = guardedDropWindowsTcp(authorizeMutation, port);
194
198
  if (drop.accessDenied > 0) accessDenied = true;
195
199
  } catch { /* best-effort */ }
196
200
  }
@@ -201,7 +205,6 @@ async function waitForGhostListenClear(
201
205
  }
202
206
  return { ok: false, accessDenied };
203
207
  }
204
-
205
208
  function packageLauncherPath(): string {
206
209
  // The launcher is <pkg-root>/bin/ocx.mjs. After `npm install -g`, import.meta.url
207
210
  // can still point at npm's renamed temp tree — prefer the live package path then.
@@ -363,9 +366,13 @@ function sanitizePersistedUpdateJob(job: UpdateJobState): UpdateJobState {
363
366
  ) as UpdateJobState;
364
367
  }
365
368
 
366
- function writeJob(job: UpdateJobState): void {
369
+ function writeJob(job: UpdateJobState, authorizeMutation: UpdateMutationAuthorizer = () => false,
370
+ kind: "publish" | "package-publish" = "publish"): void {
367
371
  ensureJobDir();
368
- atomicWriteFile(updateJobPath(), `${JSON.stringify(sanitizePersistedUpdateJob(job), null, 2)}\n`);
372
+ const data = materializeMutationData(job);
373
+ const target = updateJobPath(), text = `${JSON.stringify(sanitizePersistedUpdateJob(data), null, 2)}\n`;
374
+ if (data.status === "succeeded") guardedPublishJob(authorizeMutation, kind, target, text);
375
+ else atomicWriteFile(target, text);
369
376
  }
370
377
 
371
378
  export function readUpdateJob(jobId?: string | null): UpdateJobState | null {
@@ -387,6 +394,9 @@ export function readUpdateJob(jobId?: string | null): UpdateJobState | null {
387
394
  * `withheldSummary()`, which produces a branded description WITHOUT the text itself.
388
395
  */
389
396
  function updateJob(job: UpdateJobState, patch: Partial<UpdateJobState>, logLine?: string): UpdateJobState {
397
+ const next = prepareUpdateJob(job, patch, logLine); writeJob(next); return next;
398
+ }
399
+ function prepareUpdateJob(job: UpdateJobState, patch: Partial<UpdateJobState>, logLine?: string): UpdateJobState {
390
400
  const current = readUpdateJob(job.id) ?? job;
391
401
  const next = {
392
402
  ...current,
@@ -394,7 +404,6 @@ function updateJob(job: UpdateJobState, patch: Partial<UpdateJobState>, logLine?
394
404
  updatedAt: new Date().toISOString(),
395
405
  log: logLine ? [...current.log, logLine] : current.log,
396
406
  };
397
- writeJob(next);
398
407
  return next;
399
408
  }
400
409
 
@@ -518,6 +527,26 @@ export function staleActiveUpdateJobReason(
518
527
  return null;
519
528
  }
520
529
 
530
+ /**
531
+ * Status view of an active record whose worker is gone (#7967). A worker killed with its service
532
+ * cgroup never writes a terminal state, so the persisted record stays `running`. The view reports
533
+ * it as `failed` with the reason so the dashboard stops waiting, without writing: the persisted
534
+ * record is settled only by the next run's existing stale recovery, which holds the start path,
535
+ * so a status poll can never overwrite a job another process started meanwhile.
536
+ */
537
+ export function readUpdateJobForStatus(
538
+ jobId?: string | null,
539
+ now = Date.now(),
540
+ isAlive: (pid: number) => boolean = isProcessAlive,
541
+ ): UpdateJobState | null {
542
+ const job = readUpdateJob(jobId);
543
+ if (!job) return null;
544
+ const reason = staleActiveUpdateJobReason(job, now, isAlive);
545
+ if (!reason) return job;
546
+ const line = `Update worker stopped before finishing: ${reason}.`;
547
+ return { ...job, status: "failed", error: line, exitCode: null, log: [...job.log, line] };
548
+ }
549
+
521
550
  /**
522
551
  * Spawn the GUI update worker without inheriting the proxy's LISTEN socket.
523
552
  *
@@ -542,7 +571,7 @@ export function spawnGuiUpdateWorker(
542
571
  ]);
543
572
  if (process.platform !== "win32") {
544
573
  const launch = guiUpdateWorkerCommand(process.execPath, args, context);
545
- return spawn(launch.command, launch.argv, {
574
+ return probeSpawn(launch.command, launch.argv, {
546
575
  detached: true,
547
576
  stdio: "ignore",
548
577
  windowsHide: true,
@@ -560,7 +589,7 @@ export function spawnGuiUpdateWorker(
560
589
  `if (-not $p) { exit 1 }`,
561
590
  `Write-Output $p.Id`,
562
591
  ].join("; ");
563
- const launched = spawnSync(
592
+ const launched = probeSpawnSync(
564
593
  resolveTrustedWindowsPowerShellExe(),
565
594
  ["-NoProfile", "-NoLogo", "-NonInteractive", "-Command", ps],
566
595
  { encoding: "utf8", windowsHide: true, timeout: 15_000 },
@@ -675,9 +704,12 @@ function runLoggedCommand(
675
704
  args: string[],
676
705
  timeout: number,
677
706
  env?: NodeJS.ProcessEnv,
707
+ authorizeMutation: UpdateMutationAuthorizer = () => false,
708
+ kind: Parameters<UpdateMutationAuthorizer>[0] = "runtime",
678
709
  ): { status: number | null; signal: NodeJS.Signals | null; timedOut: boolean } {
679
710
  job = updateJob(job, {}, `$ ${formatCommand(bin, args)}`);
680
- const result = spawnSync(bin, args, {
711
+ if (!authorizeMutation(kind)) return { status: 1, signal: null, timedOut: false };
712
+ const result = guardedSpawnSync(authorizeMutation, kind, bin, args, {
681
713
  encoding: "utf8",
682
714
  timeout,
683
715
  windowsHide: true,
@@ -853,27 +885,26 @@ export function summarizeCommandOutput(
853
885
  return parts.join(" · ");
854
886
  }
855
887
 
856
- /**
857
- * Tear down anything that would make `ocx start` exit 1 with "already running"
858
- * (service wrapper respawn, stale pidfile + live /healthz) before a pinned spawn.
859
- */
888
+ /** Clear wrappers, stale state and verified ocx listeners before a pinned spawn. */
860
889
  function preparePortForPinnedStart(
861
- job: UpdateJobState,
862
- port: number,
863
- listPids: (port: number) => number[],
864
- aliveFn: (pid: number) => boolean,
890
+ job: UpdateJobState, port: number,
891
+ listPids: (port: number) => number[], aliveFn: (pid: number) => boolean,
865
892
  verifyOcx: (pid: number) => number | null = verifyPidIdentity,
866
- ): void {
867
- stopWindowsServiceWrappersBestEffort();
893
+ stopServiceWrappers: () => void = () => {},
894
+ authorizeMutation: (kind: "runtime") => boolean = () => true,
895
+ ): false | void {
896
+ if (!authorizeMutation("runtime")) return false;
897
+ stopServiceWrappers();
868
898
  const pid = readPid();
869
899
  if (pid) {
870
900
  updateJob(job, {}, `Clearing pre-start proxy PID ${pid} before pinned start.`);
871
- try { killProxy(pid); } catch { /* best-effort */ }
872
- removePid(pid);
873
- } else {
874
- removePid();
901
+ if (!authorizeMutation("runtime")) return false;
902
+ try { guardedKillProxy(authorizeMutation, "runtime", pid); } catch { /* best-effort */ }
875
903
  }
876
- removeRuntimePort();
904
+ if (!authorizeMutation("runtime")) return false;
905
+ guardedRemovePid(authorizeMutation, pid ?? undefined);
906
+ if (!authorizeMutation("runtime")) return false;
907
+ guardedRemoveRuntimePort(authorizeMutation);
877
908
  for (const holder of listPids(port)) {
878
909
  if (holder === process.pid || !aliveFn(holder)) continue;
879
910
  if (verifyOcx(holder) !== holder) {
@@ -885,60 +916,22 @@ function preparePortForPinnedStart(
885
916
  continue;
886
917
  }
887
918
  updateJob(job, {}, `Stopping live ocx listen holder PID ${holder} on port ${port} before pinned start.`);
888
- try { killProxy(holder); } catch { /* best-effort */ }
919
+ if (!authorizeMutation("runtime")) return false;
920
+ try { guardedKillProxy(authorizeMutation, "runtime", holder); } catch { /* best-effort */ }
889
921
  }
890
922
  // Match reclaimListenPort: never SetTcpEntry while a live holder remains.
891
923
  const liveRemain = listPids(port).filter(pid => pid !== process.pid && aliveFn(pid));
892
924
  if (process.platform === "win32" && liveRemain.length === 0) {
893
- try { dropWindowsTcpRowsForLocalPort(port); } catch { /* best-effort */ }
925
+ if (!authorizeMutation("runtime")) return false;
926
+ try { guardedDropWindowsTcp(authorizeMutation, port); } catch { /* best-effort */ }
894
927
  }
895
928
  }
896
929
 
897
- function spawnDetachedStart(
898
- job: UpdateJobState,
899
- installer: Installer,
900
- port?: number,
901
- launcher = packageLauncherPath(),
902
- ): ChildProcess {
903
- const cmd = restartCommand(false, installer, launcher, port);
904
- // An ordinary owner: a stray sibling marker would otherwise mark it before any probe.
905
- const env: NodeJS.ProcessEnv = withoutSiblingMarker(process.env);
906
- delete env.OCX_SERVICE;
907
- updateJob(job, {}, `$ ${cmd.display}`);
908
- let stdio: "ignore" | [ "ignore", number, number ] = "ignore";
909
- let logFd: number | undefined;
910
- try {
911
- const logPath = join(getConfigDir(), "update-pinned-start.log");
912
- mkdirSync(getConfigDir(), { recursive: true });
913
- logFd = openSync(logPath, "a");
914
- writeSync(logFd, `\n--- ${new Date().toISOString()} ---\n$ ${cmd.display}\n`);
915
- stdio = ["ignore", logFd, logFd];
916
- } catch { /* fall back to ignored stdio */ }
917
- const child = spawn(cmd.bin, cmd.args, {
918
- detached: true,
919
- stdio,
920
- windowsHide: true,
921
- env,
922
- });
923
- child.once("error", err => {
924
- try {
925
- updateJob(job, {}, `Pinned start spawn error: ${withheldSummary(err)}`);
926
- } catch { /* best-effort */ }
927
- });
928
- // Foreground `ocx start` keeps the listen process; EADDRINUSE/ghost races exit quickly
929
- // with stdio ignored — surface that so the job log explains a silent miss.
930
- child.once("exit", (code, signal) => {
931
- if (code === 0 && !signal) return;
932
- try {
933
- updateJob(
934
- job,
935
- {},
936
- `Pinned start exited early (code=${code ?? "null"} signal=${signal ?? "null"}).`,
937
- );
938
- } catch { /* best-effort */ }
939
- });
940
- child.unref();
941
- return child;
930
+ function spawnDetachedStart(job: UpdateJobState, installer: Installer, port: number | undefined,
931
+ launcher: string, authorizeMutation: UpdateMutationAuthorizer): ChildProcess {
932
+ if (!authorizeMutation("runtime")) throw new Error("Automatic update restart refused; check 'ocx service status'.");
933
+ return spawnWorkerPinnedStart(restartCommand(false, installer, launcher, port), authorizeMutation,
934
+ line => updateJob(job, {}, line), withheldSummary);
942
935
  }
943
936
 
944
937
  /** Identity snapshot used to prove a package-manager self-update replaced the pre-update process. */
@@ -957,8 +950,12 @@ export interface RestartIo {
957
950
  spawnDetachedStartFn?: typeof spawnDetachedStart;
958
951
  preparePortForPinnedStartFn?: typeof preparePortForPinnedStart;
959
952
  waitForGhostListenClearFn?: typeof waitForGhostListenClear;
960
- killProxyFn?: typeof killProxy;
953
+ killProxyFn?: KillProxy;
961
954
  serviceInstalledFn?: () => boolean;
955
+ serviceHomeAuthorityFn?: UpdateServiceHomeInspector;
956
+ serviceHomeBaseline?: ReturnType<UpdateServiceHomeInspector>; // Worker delegation pins its original authority.
957
+ stopServiceWrappersFn?: (authorizeMutation: UpdateMutationAuthorizer) => void;
958
+ readPidFn?: typeof readPid;
962
959
  /**
963
960
  * After a service reinstall exits 0, only trust the service path when this is true.
964
961
  * Defaults to {@link isServiceViable} — installed-but-stale assets must fall through
@@ -1067,7 +1064,10 @@ async function restartAfterUpdate(
1067
1064
  captured?: { port: number; hostname: string; oldPid?: number },
1068
1065
  io: RestartIo = {},
1069
1066
  ): Promise<false | void | "unsupervised"> {
1070
- const serviceInstalled = (io.serviceInstalledFn ?? isServiceInstalled)();
1067
+ const homePolicy = createUpdateServiceHomePolicy(io.serviceHomeAuthorityFn ?? inspectUpdateServiceHome,
1068
+ refusal => { updateJob(job, { status: "failed", restarted: false, error: refusal }, refusal); }, false, io.serviceHomeBaseline);
1069
+ if (!homePolicy.check(io.serviceHomeBaseline ? undefined : homePolicy.initial)) return false;
1070
+ const serviceInstalled = homePolicy.initial.kind === "same" && (io.serviceInstalledFn ?? isServiceInstalled)();
1071
1071
  const config = loadConfig();
1072
1072
  // Stop-first update already cleared pid/runtime state, so the pre-update capture is
1073
1073
  // the authoritative port to wait on; config is only the cold-start fallback.
@@ -1089,9 +1089,8 @@ async function restartAfterUpdate(
1089
1089
  const listPids = io.listListenPidsFn ?? listListenPids;
1090
1090
  const verifyOcx = io.verifyOcxFn ?? verifyPidIdentity;
1091
1091
  const aliveFn = io.isAliveFn ?? isProcessAlive;
1092
- // Pre-update PID plus any ocx still LISTENing on the captured port: a self-update
1093
- // often leaves a respawned bun/node child that is not the captured PID, and
1094
- // treating it as protected blocks reclaim so the direct start never binds.
1092
+ // Pre-update PID plus live ocx listeners on the captured port: a self-update can
1093
+ // leave a respawned child whose protected status would block reclaim and the start.
1095
1094
  const reclaimKillAllowlist = (): number[] => {
1096
1095
  const allow = new Set<number>();
1097
1096
  if (oldPid != null) allow.add(oldPid);
@@ -1101,6 +1100,12 @@ async function restartAfterUpdate(
1101
1100
  }
1102
1101
  return [...allow];
1103
1102
  };
1103
+ // A reclaim denial stays latched across preparation and this job's waits.
1104
+ let reclaimDenied = false;
1105
+ const reclaimGate = () => {
1106
+ try { reclaimDenied ||= !homePolicy.authorizeMutation("runtime"); } catch { reclaimDenied = true; }
1107
+ return !reclaimDenied;
1108
+ };
1104
1109
  const reclaimOptsFor = (onlyKillPids: number[]) => ({
1105
1110
  timeoutMs: RESTART_PORT_RECLAIM_MS,
1106
1111
  intervalMs: 100,
@@ -1110,20 +1115,19 @@ async function restartAfterUpdate(
1110
1115
  // listener, not only the pre-wait snapshot; foreign claimants stay protected.
1111
1116
  killAllOcxOnPort: true,
1112
1117
  onlyKillPids,
1118
+ mayMutateFn: reclaimGate, // the wait's awaits can span a home change; gate each kill/drop
1113
1119
  });
1114
-
1115
1120
  if (serviceInstalled) {
1116
- // schtasks /end often leaves the hidden cmd/wscript wrapper alive; its :loop
1117
- // respawns `ocx start` a few seconds later and races port reclaim, so end the
1118
- // task again and kill those wrappers before touching the socket, then reclaim it
1119
- // for wrappers that bake `--port`.
1120
- stopWindowsServiceWrappersBestEffort();
1121
+ if (!homePolicy.authorizeMutation("runtime")) return false; // a home change during the service-args import refuses before stop/reclaim
1122
+ // schtasks /end often leaves the hidden wrapper alive; its :loop respawns
1123
+ // `ocx start` and races reclaim, so end wrappers before the socket.
1124
+ if (homePolicy.authorizeMutation("service")) (io.stopServiceWrappersFn ?? stopWindowsServiceWrappersBestEffort)(homePolicy.authorizeMutation);
1121
1125
  const preServiceAllow = reclaimKillAllowlist();
1122
1126
  const freed = await waitFn(port, hostname, reclaimOptsFor(preServiceAllow));
1127
+ if (!freed && !reclaimGate()) return false; // a latched denial already refused the job
1123
1128
  let skipServiceInstall = false;
1124
- // `service repair` reuses the live task and refreshes a stale definition through
1125
- // its guarded create/elevation path, so the old install-only skip no longer
1126
- // applies; only a caller that still passes install argv keeps that behavior.
1129
+ // `service repair` reuses the live task and refreshes stale definitions via its
1130
+ // guarded path; only a caller still passing install argv keeps the old skip.
1127
1131
  const refreshRegisters = (svcArgs ?? []).includes("install");
1128
1132
  if ((io.platform ?? process.platform) === "win32" && process.env.OCX_SERVICE === "1" && refreshRegisters) {
1129
1133
  updateJob(job, {}, "Skipping service re-registration from the non-elevated update worker; falling back to a direct proxy start.");
@@ -1153,10 +1157,10 @@ async function restartAfterUpdate(
1153
1157
  }
1154
1158
  }
1155
1159
  if (!skipServiceInstall) {
1156
- // `service repair` re-activates a manager whose `ocx start` child is not a
1157
- // process descendant and cannot join this lease; held through its serving
1158
- // wait, the lease makes that child die at the acquire deadline (#5760).
1160
+ // `service repair` re-activates a manager whose `ocx start` child cannot join
1161
+ // this lease; holding it through the serving wait kills that child at the deadline (#5760).
1159
1162
  io.releaseForServiceManagerFn?.();
1163
+ if (!homePolicy.authorizeMutation("runtime")) return false;
1160
1164
  const prevBake = process.env.OCX_BAKE_PORT;
1161
1165
  process.env.OCX_BAKE_PORT = String(Math.trunc(port));
1162
1166
  let serviceOk = false;
@@ -1164,10 +1168,10 @@ async function restartAfterUpdate(
1164
1168
  const repairTimeoutMs = (io.platform ?? process.platform) === "win32"
1165
1169
  ? WINDOWS_SERVICE_REPAIR_TIMEOUT_MS
1166
1170
  : RESTART_TIMEOUT_MS;
1167
- const run = io.runService ?? ((j, bin, args, timeoutMs) => runLoggedCommand(j, bin, args, timeoutMs));
1168
- const result = run(job, cmd.bin, cmd.args, repairTimeoutMs);
1169
- serviceOk = result.status === 0;
1170
- if (!serviceOk) {
1171
+ const run = io.runService ?? ((j, bin, args, timeoutMs) => runLoggedCommand(j, bin, args, timeoutMs, undefined, homePolicy.authorizeMutation, "service"));
1172
+ const result = homePolicy.authorizeMutation("service") ? run(job, cmd.bin, cmd.args, repairTimeoutMs) : { status: 0, timedOut: false };
1173
+ serviceOk = homePolicy.serviceAllowed && result.status === 0;
1174
+ if (!serviceOk && homePolicy.serviceAllowed) {
1171
1175
  if (result.timedOut) {
1172
1176
  // UAC and scheduler mutation can outlive a fixed child deadline. Once the
1173
1177
  // worker kills that child, ownership is ambiguous: launching a foreground
@@ -1192,14 +1196,14 @@ async function restartAfterUpdate(
1192
1196
  if (prevBake === undefined) delete process.env.OCX_BAKE_PORT;
1193
1197
  else process.env.OCX_BAKE_PORT = prevBake;
1194
1198
  }
1195
- if (serviceOk) {
1199
+ if (!homePolicy.authorizeMutation("runtime")) return false;
1200
+ if (serviceOk && homePolicy.serviceAllowed) {
1196
1201
  // Registration state cannot distinguish a serving supervisor from one that
1197
- // registered and bound nothing — `launchctl list` reports both, `schtasks`
1198
- // reports a task whose child exited immediately, a flapping supervisor can
1199
- // satisfy one probe — so ask the port before skipping the fallback.
1202
+ // registered and bound nothing — `launchctl list`/`schtasks` report both, and
1203
+ // a flapping supervisor can satisfy one probe — so ask the port first.
1200
1204
  const viable = (io.serviceViableFn ?? isServiceViable)();
1201
1205
  if (viable) {
1202
- if (await serviceRestartServed(job, port, hostname, io)) return;
1206
+ if (await serviceRestartServed(job, port, hostname, io)) return homePolicy.authorizeMutation("publish") ? undefined : false;
1203
1207
  updateJob(
1204
1208
  job,
1205
1209
  {},
@@ -1219,33 +1223,37 @@ async function restartAfterUpdate(
1219
1223
  }
1220
1224
 
1221
1225
  // #7043: a managed install asks launchd/systemd first; only the manager's own job counts as recovered.
1222
- const managed = !serviceInstalled ? "failed" : await (io.restartServiceManagerFn ?? restartServiceManagerAfterUpdate)(
1223
- { port, hostname, release: io.releaseForServiceManagerFn }, line => updateJob(job, {}, line));
1224
- if (managed === "supervised") return;
1226
+ if (!homePolicy.authorizeMutation("runtime")) return false;
1227
+ const managed = !serviceInstalled || !homePolicy.authorizeMutation("service") ? "failed" : await (io.restartServiceManagerFn ?? restartServiceManagerAfterUpdate)(
1228
+ { port, hostname, release: io.releaseForServiceManagerFn, authorizeMutation: homePolicy.authorizeMutation }, line => updateJob(job, {}, line));
1229
+ if (managed === "supervised") return homePolicy.authorizeMutation("publish") ? undefined : false;
1230
+ if (managed === "refused") { updateJob(job, { status: "failed", restarted: false, error: "Automatic service restart was refused; check 'ocx service status' before restarting manually." }); return false; }
1225
1231
  if (managed === "unsettled") { updateJob(job, ...unsettledManagerRestartFailure(port)); return false; }
1226
1232
  const fallback = serviceInstalled ? "unsupervised" as const : undefined; // every exit below is unproven ownership
1227
1233
  // The service refresh ran outside the lease; take it back so the veto and the kills/start below stay serialized.
1228
1234
  const restartVeto = io.reacquireForDirectStartFn?.();
1235
+ if (!homePolicy.authorizeMutation("runtime")) return false;
1229
1236
  if (restartVeto) {
1230
- updateJob(job, restartVeto.failed ? { status: "failed", restarted: false, error: restartVeto.notice } : { status: "succeeded", restarted: false }, restartVeto.notice);
1237
+ if (!homePolicy.authorizeMutation("publish")) return false;
1238
+ writeJob(prepareUpdateJob(job, restartVeto.failed ? { status: "failed", restarted: false, error: restartVeto.notice } : { status: "succeeded", restarted: false }, restartVeto.notice), homePolicy.authorizeMutation, "publish");
1231
1239
  return false;
1232
1240
  }
1233
-
1234
- const pid = readPid();
1241
+ const pid = (io.readPidFn ?? readPid)();
1235
1242
  if (pid) {
1236
1243
  updateJob(job, {}, `Stopping current proxy PID ${pid}.`);
1237
1244
  try {
1238
- killProxy(pid);
1245
+ if (!homePolicy.authorizeMutation("runtime")) return false;
1246
+ guardedKillProxy(homePolicy.authorizeMutation, "runtime", pid, io.killProxyFn);
1239
1247
  } catch {
1240
1248
  // A PID that resists taskkill must not abort recovery: reclaim + pinned start
1241
1249
  // below are the path that repairs stuck Windows listeners.
1242
1250
  }
1243
1251
  }
1244
- if (serviceInstalled) stopWindowsServiceWrappersBestEffort();
1245
- // Reclaim before the pinned start: spawning `--port` while the old socket is busy
1246
- // is how updates used to fail health checks or hop ports.
1252
+ if (serviceInstalled && homePolicy.authorizeMutation("service")) (io.stopServiceWrappersFn ?? stopWindowsServiceWrappersBestEffort)(homePolicy.authorizeMutation);
1253
+ // Reclaim before the pinned start: a busy old socket used to hop ports or fail health.
1247
1254
  const directAllow = reclaimKillAllowlist();
1248
1255
  const freed = await waitFn(port, hostname, reclaimOptsFor(directAllow));
1256
+ if (!freed && !reclaimGate()) return false;
1249
1257
  if (!freed) {
1250
1258
  const liveHolders = listPids(port).filter(pid => pid !== process.pid && aliveFn(pid));
1251
1259
  updateJob(
@@ -1258,8 +1266,7 @@ async function restartAfterUpdate(
1258
1266
  updateJob(job, {}, `Live holder(s) remain on port ${port}; not starting on another port. Retry 'ocx start --port ${port}'.`);
1259
1267
  return fallback;
1260
1268
  }
1261
- // Dead PIDs can still own LISTEN rows. SetTcpEntry needs elevation (rc 317 on a
1262
- // normal update worker), so poll until netstat is empty and the start runtime can bind.
1269
+ // Dead PIDs can still own LISTEN rows (SetTcpEntry needs elevation); poll netstat until bindable.
1263
1270
  updateJob(
1264
1271
  job,
1265
1272
  {},
@@ -1268,7 +1275,8 @@ async function restartAfterUpdate(
1268
1275
  // Injected spawnStart is the unit-test seam — skip the long OS wait.
1269
1276
  if (!io.spawnStart) {
1270
1277
  const sleep = io.sleepMs ?? ((ms: number) => new Promise<void>(r => setTimeout(r, ms)));
1271
- const cleared = await waitForGhostListenClear(port, hostname, listPids, 90_000, sleep);
1278
+ const cleared = await waitForGhostListenClear(port, hostname, listPids, 90_000, sleep, aliveFn, reclaimGate);
1279
+ if (!reclaimGate()) return false;
1272
1280
  if (cleared.accessDenied) {
1273
1281
  updateJob(job, {}, "SetTcpEntry is non-elevated (access denied); relying on OS ghost-LISTEN expiry.");
1274
1282
  }
@@ -1287,6 +1295,7 @@ async function restartAfterUpdate(
1287
1295
  // Injected spawnStart keeps unit tests deterministic (one call). Production path
1288
1296
  // retries on missing /healthz after prepare + ghost-LISTEN clear.
1289
1297
  if (io.spawnStart) {
1298
+ if (!homePolicy.authorizeMutation("runtime")) return false;
1290
1299
  io.spawnStart(job, job.installer, port, launcher);
1291
1300
  return fallback;
1292
1301
  }
@@ -1323,7 +1332,8 @@ async function restartAfterUpdate(
1323
1332
  // A numeric PID can be reused once this particular child has exited.
1324
1333
  if (!child?.pid || child.exitCode !== null || child.signalCode !== null) return;
1325
1334
  if (aliveFn(child.pid)) {
1326
- try { (io.killProxyFn ?? killProxy)(child.pid); } catch { /* best-effort */ }
1335
+ if (!homePolicy.authorizeMutation("own-child")) return;
1336
+ try { guardedKillProxy(homePolicy.authorizeMutation, "own-child", child.pid, io.killProxyFn); } catch { /* best-effort */ }
1327
1337
  }
1328
1338
  };
1329
1339
  for (let attempt = 1; attempt <= attempts; attempt++) {
@@ -1337,14 +1347,16 @@ async function restartAfterUpdate(
1337
1347
  killSpawnAttempt(lastChild);
1338
1348
  lastChild = null;
1339
1349
  }
1340
- preparePort(job, port, listPids, aliveFn, verifyOcx);
1350
+ if (!homePolicy.authorizeMutation("runtime")) return false;
1351
+ if (preparePort(job, port, listPids, aliveFn, verifyOcx, () => { if (serviceInstalled && homePolicy.authorizeMutation("service")) (io.stopServiceWrappersFn ?? stopWindowsServiceWrappersBestEffort)(homePolicy.authorizeMutation); }, reclaimGate) === false) return false;
1341
1352
  const ready = await waitForGhost(
1342
1353
  port,
1343
1354
  hostname,
1344
1355
  listPids,
1345
1356
  attempt === 1 ? (freed ? 15_000 : 5_000) : 30_000,
1346
- sleep,
1357
+ sleep, aliveFn, reclaimGate,
1347
1358
  );
1359
+ if (!reclaimGate()) return false;
1348
1360
  if (!ready.ok) {
1349
1361
  updateJob(
1350
1362
  job,
@@ -1354,7 +1366,8 @@ async function restartAfterUpdate(
1354
1366
  );
1355
1367
  continue;
1356
1368
  }
1357
- const child = spawnPinnedStart(job, job.installer, port, launcher);
1369
+ if (!homePolicy.authorizeMutation("runtime")) return false;
1370
+ const child = spawnPinnedStart(job, job.installer, port, launcher, homePolicy.authorizeMutation);
1358
1371
  lastChild = child;
1359
1372
  const retireChild = () => {
1360
1373
  if (lastChild === child) lastChild = null;
@@ -1395,35 +1408,6 @@ function formatPortHolders(
1395
1408
  return `holders=[${holders.join(", ") || "none"}] allow=[${allow.join(", ") || "none"}]`;
1396
1409
  }
1397
1410
 
1398
- /** Stop the installed Windows backend and best-effort kill surviving :loop wrappers. */
1399
- function stopWindowsServiceWrappersBestEffort(): void {
1400
- if (process.platform !== "win32") return;
1401
- try {
1402
- if (readServiceBackend() === "native") {
1403
- stopWinswService();
1404
- return;
1405
- }
1406
- stopWindows();
1407
- } catch { /* already stopped */ }
1408
- killWindowsServiceWrapperProcesses();
1409
- }
1410
-
1411
- /**
1412
- * Best-effort termination of surviving Windows scheduler launcher/wrapper processes.
1413
- * `schtasks /end` ends the task instance but often leaves wscript/cmd running the
1414
- * `:loop` batch, which brings the proxy back during post-update reclaim.
1415
- *
1416
- * This used to match the bare filenames with -like '*name*', which could stop a
1417
- * wrapper belonging to a DIFFERENT OpenCodex home under the same account. The
1418
- * shared killer scopes to this home's canonical paths as complete tokens.
1419
- */
1420
- function killWindowsServiceWrapperProcesses(): void {
1421
- killWindowsSchedulerWrappers({
1422
- scriptPath: join(getConfigDir(), "opencodex-service.cmd"),
1423
- launcherPath: join(getConfigDir(), "opencodex-service-launcher.vbs"),
1424
- });
1425
- }
1426
-
1427
1411
  /** Exposed for tests: drives the non-service restart path with injected io. */
1428
1412
  export function restartAfterUpdateForTests(
1429
1413
  job: UpdateJobState,
@@ -1518,7 +1502,7 @@ async function confirmRestartedProxy(
1518
1502
  ): Promise<boolean> {
1519
1503
  /* [Decision Log]
1520
1504
  - 목적과 의도: GUI update job이 detached restart 요청만 보고 성공 처리하지 않도록, 실제 프록시 복귀 여부를 확인한다.
1521
- - 기존 구현 및 제약 조건: update-job.json은 spawn/service reinstall 직후 `succeeded`로 끝났고, Windows npm/Bun 교체 실패처럼 몇 초 후 죽는 재시작을 잡지 못했다.
1505
+ - 기존 구현 및 제약 조건: update-job.json은 probeSpawn/service reinstall 직후 `succeeded`로 끝났고, Windows npm/Bun 교체 실패처럼 몇 초 후 죽는 재시작을 잡지 못했다.
1522
1506
  - 검토한 주요 대안: (1) 포트 점유만 확인 — 외부 프로세스/죽기 직전 프로세스를 성공으로 오인할 수 있다. (2) 무기한 /healthz 폴링 — UX가 느려지고 worker 종료 시점이 불명확하다. (3) 짧은 healthy 등장 + 안정성 창 확인 — 실제 복귀를 확인하면서도 대기 시간을 제한할 수 있다.
1523
1507
  - 선택한 방식: identity-aware /healthz probe가 일정 시간 안에 나타나고, 추가 안정성 창 동안 유지되는지 확인한다.
1524
1508
  - 다른 대안 대신 이 방식을 선택한 이유: GUI는 "업데이트가 설치됐지만 재시작은 실패"를 분리해 알려줘야 하며, 이 방식이 가장 적은 오탐으로 그 경계를 만든다.
@@ -1781,8 +1765,14 @@ export interface GuiUpdateWorkerIo {
1781
1765
  resolvePnpmActiveLauncherFn?: (owner: PnpmGlobalOwner) => string | null;
1782
1766
  /** Restart seams used by focused worker tests; the verified launcher is always injected. */
1783
1767
  restartIo?: RestartIo;
1784
- /** Resolves who owns the runtime; defaults to the shared service install state. */
1785
- resolveOwnershipFn?: () => ServiceOwnershipResolution;
1768
+ resolveOwnershipFn?: () => ServiceOwnershipResolution; // Defaults to the shared service install state.
1769
+ serviceHomeAuthorityFn?: UpdateServiceHomeInspector;
1770
+ launcherSupportsUpdateHomeFn?: (launcher: string, node: string) => boolean;
1771
+ platform?: NodeJS.Platform; // Exercise the default Windows handoff without changing the host platform.
1772
+ /** Isolated tray handoff plan for focused worker tests (default: the win32 tray handoff). */
1773
+ trayHandoffFn?: (capturePlan?: Parameters<typeof defaultWorkerTrayHandoff>[0], authorizeMutation?: UpdateMutationAuthorizer) => ReturnType<typeof planWindowsTrayUpdate> | Promise<ReturnType<typeof planWindowsTrayUpdate>>;
1774
+ /** Isolated tray command runner for focused worker tests (default: runLoggedCommand). */
1775
+ trayCommandFn?: GuiUpdateWorkerIo["runCommandFn"];
1786
1776
  runCommandFn?: (
1787
1777
  job: UpdateJobState,
1788
1778
  bin: string,
@@ -1791,7 +1781,6 @@ export interface GuiUpdateWorkerIo {
1791
1781
  env?: NodeJS.ProcessEnv,
1792
1782
  ) => { status: number | null; signal: NodeJS.Signals | null };
1793
1783
  }
1794
-
1795
1784
  export async function runGuiUpdateWorker(
1796
1785
  jobId: string,
1797
1786
  channel: Channel,
@@ -1821,6 +1810,12 @@ export async function runGuiUpdateWorker(
1821
1810
  let activeLauncher = packageLauncherPath();
1822
1811
  let activeLauncherVerified = true;
1823
1812
  let pnpmOwner: PnpmGlobalOwner | undefined;
1813
+ let workerAuthorizeMutation: UpdateMutationAuthorizer = () => false;
1814
+ const trayRun = (args: string[], timeout: number) => {
1815
+ if (!workerAuthorizeMutation(args[1] === "start" ? "own-tray" : "tray")) return { status: 1, signal: null };
1816
+ return io.trayCommandFn ? io.trayCommandFn(job!, process.execPath, [activeLauncher, ...args], timeout)
1817
+ : runLoggedCommand(job!, process.execPath, [activeLauncher, ...args], timeout, undefined, workerAuthorizeMutation, args[1] === "start" ? "own-tray" : "tray");
1818
+ };
1824
1819
  if (!job) {
1825
1820
  job = {
1826
1821
  id: jobId,
@@ -1838,7 +1833,6 @@ export async function runGuiUpdateWorker(
1838
1833
  };
1839
1834
  writeJob(job);
1840
1835
  }
1841
-
1842
1836
  try {
1843
1837
  if (!check.canUpdate) {
1844
1838
  throw new Error(check.reason ?? "No update is available");
@@ -1855,7 +1849,7 @@ export async function runGuiUpdateWorker(
1855
1849
  // proxy is stopped; transient registry failure degrades to a logged skip.
1856
1850
  const integrity = io.integrityFn
1857
1851
  ? io.integrityFn(check.latestVersion)
1858
- : checkUpdatePackageIntegrity(check.latestVersion, spawnSync, check.installer, pnpmOwner);
1852
+ : checkUpdatePackageIntegrity(check.latestVersion, probeSpawnSync, check.installer, pnpmOwner);
1859
1853
  if (integrity.ok === false) {
1860
1854
  updateJob(job, { status: "failed", error: integrity.reason });
1861
1855
  return;
@@ -1883,28 +1877,31 @@ export async function runGuiUpdateWorker(
1883
1877
  }
1884
1878
  }
1885
1879
 
1886
- if (process.platform === "win32") {
1880
+ let homeRefusal: string | undefined;
1881
+ const homePolicy = prepareWorkerUpdateHome(cmd, check.installer, activeLauncher, nodeBin(), channel,
1882
+ message => { homeRefusal = message; job = updateJob(job!, {}, message); }, io.serviceHomeAuthorityFn, io.launcherSupportsUpdateHomeFn);
1883
+ if (!homePolicy) { updateJob(job, { status: "failed", restarted: false, error: homeRefusal }); return; }
1884
+ workerAuthorizeMutation = homePolicy.authorizeMutation;
1885
+ job = updateJob(job, { command: cmd.display });
1886
+ const refuseWorkerHome = () => {
1887
+ if (trayWasRunning && activeLauncherVerified && homePolicy.authorizeMutation("own-tray")) trayRun(["tray", "start"], 15_000);
1888
+ updateJob(job!, { status: "failed", restarted: false, error: homeRefusal });
1889
+ };
1890
+ if (!homePolicy.packageOnly && (io.trayHandoffFn || (io.platform ?? process.platform) === "win32")) {
1887
1891
  try {
1888
- const { getWindowsTrayStatus, startWindowsTray, stopWindowsTray } = await import("../tray/windows");
1889
- const tray = getWindowsTrayStatus();
1890
- const trayPlan = handoffWindowsTrayForUpdate(tray, {
1891
- stop: () => {
1892
- const stopped = stopWindowsTray();
1893
- return { exitStatus: 0, running: stopped.running };
1894
- },
1895
- start: () => startWindowsTray(),
1896
- });
1892
+ if (!homePolicy.authorizeMutation("tray")) { refuseWorkerHome(); return; }
1893
+ const trayPlan = await (io.trayHandoffFn ?? defaultWorkerTrayHandoff)(plan => { trayWasInstalled = plan.refreshAfterReplacement; trayWasRunning = plan.restoreOnFailure; }, homePolicy.authorizeMutation);
1897
1894
  trayWasInstalled = trayPlan.refreshAfterReplacement;
1898
1895
  trayWasRunning = trayPlan.restoreOnFailure;
1899
1896
  } catch (error) {
1897
+ if (trayWasRunning && activeLauncherVerified && homePolicy.authorizeMutation("own-tray")) { try { trayRun(["tray", "start"], 15_000); } catch { /* preserve the handoff failure */ } }
1900
1898
  updateJob(job, {
1901
- status: "failed",
1902
- error: `Could not stop the Windows tray; aborting before package replacement: ${withheldSummary(error)}`,
1899
+ status: "failed", restarted: false,
1900
+ error: homeRefusal ?? `Could not stop the Windows tray; aborting before package replacement: ${withheldSummary(error)}`,
1903
1901
  });
1904
1902
  return;
1905
1903
  }
1906
1904
  }
1907
-
1908
1905
  /* [Decision Log]
1909
1906
  - 목적: GUI 요청 처리 프로세스가 자신이 실행 중인 패키지를 직접 덮어쓰지 않도록 업데이트를 별도 worker에서 수행한다.
1910
1907
  - 대안 분석: (1) 서버에서 runUpdate 직접 호출: process.exit/stdio/실행 파일 교체 위험. (2) GUI에서 CLI 명령 안내만 제공: 자동 업데이트 UX 부족. (3) 숨은 worker가 Node launcher/Bun 전역 명령을 실행: 상태 추적과 안전한 재시작이 가능.
@@ -1914,7 +1911,15 @@ export async function runGuiUpdateWorker(
1914
1911
  // and the routed catalog to the replacement instead of restoring native Codex for the
1915
1912
  // seconds in between. Without a restart the stop restores, even under an inherited marker.
1916
1913
  const updateEnv = restart ? withUpdateTeardownHandover(process.env) : withoutUpdateTeardownHandover(process.env);
1917
- const result = (io.runCommandFn ?? runLoggedCommand)(job, cmd.bin, cmd.args, UPDATE_TIMEOUT_MS, updateEnv);
1914
+ // Raw package-manager lanes cannot carry the baseline argv; the parent rechecks it at the boundary.
1915
+ if (!homePolicy.authorizeMutation("package")) { refuseWorkerHome(); return; }
1916
+ const result = (io.runCommandFn ?? runLoggedCommand)(job, cmd.bin, cmd.args, UPDATE_TIMEOUT_MS, updateEnv, homePolicy.authorizeMutation, "package");
1917
+ if (packageOnlyUpdateSucceeded(cmd, result.status, homePolicy.packageOnly)) {
1918
+ homePolicy.check({ kind: "unknown" });
1919
+ if (!homePolicy.authorizeMutation("package-publish")) { refuseWorkerHome(); return; }
1920
+ writeJob(prepareUpdateJob(job, { status: "succeeded", restarted: false }, "Update installed. Restart the proxy manually after checking 'ocx service status'."), homePolicy.authorizeMutation, "package-publish");
1921
+ return;
1922
+ }
1918
1923
  if (result.status !== 0) {
1919
1924
  if (check.installer === "pnpm") {
1920
1925
  const verifiedLauncher = pnpmOwner
@@ -1923,9 +1928,7 @@ export async function runGuiUpdateWorker(
1923
1928
  if (verifiedLauncher) activeLauncher = verifiedLauncher;
1924
1929
  else activeLauncherVerified = false;
1925
1930
  }
1926
- if (trayWasRunning && activeLauncherVerified) {
1927
- runLoggedCommand(job, process.execPath, [activeLauncher, "tray", "start"], 15_000);
1928
- }
1931
+ if (trayWasRunning && activeLauncherVerified && homePolicy.authorizeMutation("own-tray")) trayRun(["tray", "start"], 15_000);
1929
1932
  updateJob(job, {
1930
1933
  status: "failed",
1931
1934
  exitCode: result.status,
@@ -1941,37 +1944,40 @@ export async function runGuiUpdateWorker(
1941
1944
  activeLauncher = verifiedLauncher;
1942
1945
  }
1943
1946
 
1947
+ // Authority gates every post-replacement control action; refusal may only restore the
1948
+ // own tray stopped before replacement, never install/refresh a new artifact.
1949
+ if (!homePolicy.authorizeMutation("runtime")) { refuseWorkerHome(); return; }
1944
1950
  if (trayWasInstalled) {
1945
1951
  const trayArgs = planWindowsTrayUpdate({ installed: trayWasInstalled, running: trayWasRunning }).installArgs;
1946
- const tray = runLoggedCommand(job, process.execPath, [activeLauncher, ...trayArgs], 20_000);
1952
+ if (!homePolicy.authorizeMutation("tray")) { refuseWorkerHome(); return; }
1953
+ const tray = trayRun(trayArgs, 20_000);
1947
1954
  if (tray.status !== 0) {
1948
1955
  updateJob(job, {}, "Windows tray refresh failed; run 'ocx tray install'.");
1949
- if (trayWasRunning) runLoggedCommand(job, process.execPath, [activeLauncher, "tray", "start"], 15_000);
1956
+ if (trayWasRunning && homePolicy.authorizeMutation("own-tray")) trayRun(["tray", "start"], 15_000);
1950
1957
  }
1951
1958
  }
1952
-
1953
1959
  if (restart) {
1954
1960
  const outcome = await runUpdateRestartWithOwnershipLease(io.resolveOwnershipFn, async lease => {
1955
1961
  job = updateJob(job!, { status: "restarting" }, "Update installed. Restarting proxy...");
1956
1962
  return finishGuiUpdateRestart(job!, captured, check.installer, {
1957
1963
  ...io.restartIo,
1964
+ serviceHomeAuthorityFn: io.restartIo?.serviceHomeAuthorityFn ?? io.serviceHomeAuthorityFn, serviceHomeBaseline: homePolicy.initial,
1958
1965
  releaseForServiceManagerFn: lease.releaseForServiceManager,
1959
1966
  reacquireForDirectStartFn: lease.reacquireForDirectStart,
1960
1967
  packageLauncherPathFn: () => activeLauncher,
1961
1968
  });
1962
1969
  });
1963
- if (outcome.kind === "veto") { updateJob(job, { status: "succeeded", restarted: false }, outcome.notice); return; }
1970
+ if (outcome.kind === "veto") { if (!homePolicy.authorizeMutation("publish")) { refuseWorkerHome(); return; } writeJob(prepareUpdateJob(job, { status: "succeeded", restarted: false }, outcome.notice), homePolicy.authorizeMutation, "publish"); return; }
1964
1971
  if (!outcome.value) return;
1965
- updateJob(job, { status: "succeeded", restarted: true }, "Restart requested and proxy is healthy.");
1972
+ if (!homePolicy.authorizeMutation("publish")) { refuseWorkerHome(); return; }
1973
+ writeJob(prepareUpdateJob(job, { status: "succeeded", restarted: true }, "Restart requested and proxy is healthy."), homePolicy.authorizeMutation, "publish");
1966
1974
  return;
1967
1975
  }
1968
-
1969
- updateJob(job, { status: "succeeded", restarted: false }, "Update installed. Restart the proxy to use the new version.");
1976
+ if (!homePolicy.authorizeMutation("publish")) { refuseWorkerHome(); return; }
1977
+ writeJob(prepareUpdateJob(job, { status: "succeeded", restarted: false }, "Update installed. Restart the proxy to use the new version."), homePolicy.authorizeMutation, "publish");
1970
1978
  } catch (err) {
1971
1979
  if (check.installer === "pnpm") activeLauncherVerified = false;
1972
- if (trayWasRunning && activeLauncherVerified) {
1973
- runLoggedCommand(job, process.execPath, [activeLauncher, "tray", "start"], 15_000);
1974
- }
1980
+ if (trayWasRunning && activeLauncherVerified && workerAuthorizeMutation("own-tray")) trayRun(["tray", "start"], 15_000);
1975
1981
  updateJob(job, {
1976
1982
  status: "failed",
1977
1983
  error: withheldSummary(err),