@bitkyc08/opencodex 2.100.2 → 2.100.3

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 (561) hide show
  1. package/README.md +1 -1
  2. package/bin/ocx.mjs +32 -18
  3. package/gui/dist/assets/{App-COo8Yopd.css → App-BGP8I0V4.css} +1 -1
  4. package/gui/dist/assets/App-Dnb6VMsP.js +59 -0
  5. package/gui/dist/assets/{Tray-BcaI-VCr.js → Tray-BV4ms9U9.js} +1 -1
  6. package/gui/dist/assets/{brand-mark-DU-0Vdkr.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/{index-DJEkIDAi.css → index-DQtCRNAw.css} +1 -1
  9. package/gui/dist/assets/{segment-thumb-features-e9A_FogJ.js → segment-thumb-features-DXSidY6D.js} +1 -1
  10. package/gui/dist/classic/assets/App-DA-scMPq.js +58 -0
  11. package/gui/dist/classic/assets/{Tray-DT146AhS.js → Tray-BrHaVRAq.js} +1 -1
  12. package/gui/dist/classic/assets/index-BqOaGLf5.js +105 -0
  13. package/gui/dist/classic/assets/{quota-summary-CakPe9Ni.js → quota-summary-Dy5_wfTT.js} +1 -1
  14. package/gui/dist/classic/index.html +1 -1
  15. package/gui/dist/index.html +2 -2
  16. package/native/ocx-child/Cargo.toml +9 -0
  17. package/native/ocx-child/src/cli.rs +402 -20
  18. package/native/ocx-child/src/codex_home.rs +98 -14
  19. package/native/ocx-child/src/daemon.rs +2 -1
  20. package/native/ocx-child/src/lib.rs +3 -0
  21. package/native/ocx-child/src/link_ws.rs +2598 -0
  22. package/native/ocx-child/src/link_ws_advert.rs +346 -0
  23. package/native/ocx-child/src/link_ws_frame.rs +749 -0
  24. package/native/ocx-child/src/parity.rs +5 -1
  25. package/native/ocx-child/src/platform.rs +152 -6
  26. package/native/ocx-child/src/relay.rs +150 -19
  27. package/package.json +3 -3
  28. package/src/adapters/anthropic/advisor-tool.ts +176 -0
  29. package/src/adapters/anthropic/beta-body-pairs.ts +6 -0
  30. package/src/adapters/anthropic/client-identity.ts +3 -1
  31. package/src/adapters/anthropic/passthrough.ts +9 -3
  32. package/src/adapters/anthropic.ts +31 -14
  33. package/src/adapters/client-fingerprint.ts +3 -3
  34. package/src/adapters/cursor/discovery.ts +17 -0
  35. package/src/adapters/cursor/native-exec-desktop.ts +2 -1
  36. package/src/adapters/cursor/native-exec-shell.ts +2 -1
  37. package/src/adapters/cursor/protobuf-request.ts +8 -8
  38. package/src/adapters/cursor.ts +7 -6
  39. package/src/adapters/google-antigravity-wire.ts +7 -5
  40. package/src/adapters/google-wire-compiler.ts +2 -2
  41. package/src/adapters/google.ts +9 -2
  42. package/src/adapters/kiro/payload.ts +7 -4
  43. package/src/adapters/kiro/reasoning.ts +44 -1
  44. package/src/adapters/kiro/structured-output.ts +10 -8
  45. package/src/adapters/kiro-tools.ts +61 -15
  46. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  47. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  48. package/src/adapters/zed.ts +3 -0
  49. package/src/advisor/consult.ts +15 -4
  50. package/src/advisor/context.ts +12 -3
  51. package/src/advisor/runtime.ts +35 -5
  52. package/src/advisor/settings.ts +8 -0
  53. package/src/advisor/synthetic-tool.ts +21 -8
  54. package/src/bridge/response-json.ts +11 -2
  55. package/src/bridge/sse.ts +43 -8
  56. package/src/claude/auth-detect.ts +21 -33
  57. package/src/claude/desktop-3p.ts +11 -5
  58. package/src/claude/desktop-gateway-state.ts +2 -0
  59. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  60. package/src/claude/desktop-remote-store.ts +24 -4
  61. package/src/claude/inbound-content-options.ts +31 -16
  62. package/src/claude/outbound.ts +13 -3
  63. package/src/cli/account-api.ts +17 -1
  64. package/src/cli/account-auth.ts +54 -21
  65. package/src/cli/account-key-quota.ts +34 -5
  66. package/src/cli/account.ts +4 -2
  67. package/src/cli/advisor.ts +7 -4
  68. package/src/cli/alias.ts +38 -1
  69. package/src/cli/capabilities-access-remote.ts +128 -3
  70. package/src/cli/capabilities-accounts.ts +3 -3
  71. package/src/cli/capabilities-agents-routing.ts +17 -10
  72. package/src/cli/capabilities-base.ts +41 -16
  73. package/src/cli/capabilities-integrations.ts +2 -2
  74. package/src/cli/capabilities-provider-models.ts +18 -2
  75. package/src/cli/capabilities-route-to.ts +43 -0
  76. package/src/cli/capabilities.ts +2 -0
  77. package/src/cli/capability-contracts.ts +1 -1
  78. package/src/cli/claude-desktop.ts +30 -11
  79. package/src/cli/claude.ts +17 -3
  80. package/src/cli/codex-launcher.ts +3 -1
  81. package/src/cli/codex-shim-autorestore.ts +5 -42
  82. package/src/cli/config-command.ts +14 -1
  83. package/src/cli/config-root-startup.ts +34 -0
  84. package/src/cli/connect.ts +88 -16
  85. package/src/cli/desktop-runtime-guidance.ts +1 -1
  86. package/src/cli/disconnect-runtime.ts +168 -0
  87. package/src/cli/dispatch.ts +54 -12
  88. package/src/cli/export-command.ts +1 -1
  89. package/src/cli/gui-pair-client.ts +6 -3
  90. package/src/cli/gui.ts +10 -5
  91. package/src/cli/help-catalog.ts +11 -0
  92. package/src/cli/help.ts +4 -3
  93. package/src/cli/index.ts +83 -92
  94. package/src/cli/inspect.ts +11 -2
  95. package/src/cli/integrations.ts +26 -1
  96. package/src/cli/link-capture.ts +64 -0
  97. package/src/cli/link-child-ops.ts +218 -40
  98. package/src/cli/link-cleanup.ts +8 -5
  99. package/src/cli/link-diagnostics.ts +67 -0
  100. package/src/cli/link-enrollment.ts +158 -12
  101. package/src/cli/link-operations.ts +52 -0
  102. package/src/cli/link-recover.ts +152 -0
  103. package/src/cli/link-routes.ts +87 -0
  104. package/src/cli/link-status-child.ts +44 -1
  105. package/src/cli/link-status-traffic.ts +34 -0
  106. package/src/cli/link.ts +314 -37
  107. package/src/cli/message-command.ts +1 -1
  108. package/src/cli/message-mcp-command.ts +23 -10
  109. package/src/cli/models-runtime.ts +3 -3
  110. package/src/cli/opencode.ts +3 -1
  111. package/src/cli/pi-sync.ts +35 -0
  112. package/src/cli/preflight-exemptions.ts +46 -0
  113. package/src/cli/registry.ts +28 -12
  114. package/src/cli/restart-failure.ts +5 -2
  115. package/src/cli/root.ts +5 -1
  116. package/src/cli/route-to.ts +172 -0
  117. package/src/cli/runtime-api.ts +5 -8
  118. package/src/cli/status.ts +3 -1
  119. package/src/cli/stop-approval.ts +66 -19
  120. package/src/cli/stop-report.ts +23 -0
  121. package/src/cli/stop-windows-checked.ts +304 -0
  122. package/src/cli/sync-command.ts +70 -15
  123. package/src/cli/sync-fanout.ts +74 -19
  124. package/src/cli/sync-flags.ts +40 -3
  125. package/src/cli/sync-link-status.ts +18 -2
  126. package/src/cli/sync-update-guard.ts +7 -2
  127. package/src/cli/system-restart-client.ts +3 -2
  128. package/src/cli/uninstall-plan.ts +77 -5
  129. package/src/cli/uninstall-stop.ts +152 -0
  130. package/src/cli/v2-input.ts +10 -6
  131. package/src/cli/v2-local-output.ts +3 -2
  132. package/src/cli/v2-runtime.ts +10 -3
  133. package/src/cli/v2.ts +22 -7
  134. package/src/client/connect.ts +321 -34
  135. package/src/client/link-home-features.ts +27 -0
  136. package/src/client/link-home.ts +92 -4
  137. package/src/client/link-ingress.ts +21 -3
  138. package/src/client/link-join.ts +12 -2
  139. package/src/client/link-parity-reporter.ts +60 -6
  140. package/src/client/link-relay-transport.ts +161 -36
  141. package/src/client/link-relay.ts +150 -6
  142. package/src/client/link-request-compression.ts +84 -0
  143. package/src/client/link-state.ts +11 -5
  144. package/src/client/link-status.ts +39 -1
  145. package/src/client/link-teardown.ts +1 -0
  146. package/src/client/link-tunnel.ts +56 -5
  147. package/src/client/link-websocket-limits.ts +89 -0
  148. package/src/client/link-websocket.ts +586 -0
  149. package/src/client/link-ws-advertisement.ts +100 -0
  150. package/src/client/link-ws-framer.ts +241 -0
  151. package/src/client/link-ws-transport.ts +177 -0
  152. package/src/client/machine-api.ts +13 -2
  153. package/src/client/machine-listener.ts +48 -7
  154. package/src/client/route-intent-apply.ts +293 -0
  155. package/src/client/route-intent-file-originals.ts +97 -0
  156. package/src/client/route-intent-native-originals.ts +201 -0
  157. package/src/client/route-intent-watch.ts +141 -0
  158. package/src/client/runtime-restart.ts +127 -5
  159. package/src/client/runtime.ts +61 -15
  160. package/src/client/state.ts +30 -0
  161. package/src/client/sync-expectation.ts +36 -2
  162. package/src/client/sync-runtime.ts +7 -0
  163. package/src/clients/config-export/alias-selectors.ts +63 -40
  164. package/src/clients/config-export/contracts.ts +2 -0
  165. package/src/clients/config-export/nested-selectors.ts +42 -0
  166. package/src/clients/config-export.ts +22 -3
  167. package/src/codex/account-store.ts +12 -3
  168. package/src/codex/account-usability.ts +13 -0
  169. package/src/codex/auth-api/account-list.ts +29 -3
  170. package/src/codex/auth-collision.ts +23 -22
  171. package/src/codex/auth-context.ts +21 -6
  172. package/src/codex/catalog/gather-capture.ts +8 -2
  173. package/src/codex/catalog/parsing.ts +7 -3
  174. package/src/codex/catalog/provider-models.ts +54 -15
  175. package/src/codex/catalog/retained-sync.ts +2 -1
  176. package/src/codex/catalog/routed-gather.ts +1 -1
  177. package/src/codex/catalog-auto-refresh.ts +11 -0
  178. package/src/codex/cli-update-job.ts +35 -13
  179. package/src/codex/convergence.ts +2 -2
  180. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  181. package/src/codex/features.ts +2 -2
  182. package/src/codex/history-provider.ts +31 -0
  183. package/src/codex/inject/multi-agent-v2.ts +9 -3
  184. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  185. package/src/codex/inject/plan.ts +20 -2
  186. package/src/codex/inject.ts +2 -0
  187. package/src/codex/journal-config-restore.ts +217 -0
  188. package/src/codex/journal.ts +75 -6
  189. package/src/codex/main-account.ts +23 -30
  190. package/src/codex/native-main-auth-file.ts +104 -0
  191. package/src/codex/native-profile-manager.ts +4 -3
  192. package/src/codex/native-profile-store.ts +3 -61
  193. package/src/codex/orca-import.ts +10 -1
  194. package/src/codex/quota-history.ts +13 -0
  195. package/src/codex/quota-window-conflict.ts +103 -0
  196. package/src/codex/quota.ts +23 -1
  197. package/src/codex/subagent-model-fallback.ts +3 -1
  198. package/src/codex/websocket-activity.ts +171 -16
  199. package/src/codex/websocket-registry.ts +11 -4
  200. package/src/combos/cooldown-store.ts +25 -5
  201. package/src/combos/failover.ts +330 -2
  202. package/src/config/dashboard-trusted-proxy.ts +83 -0
  203. package/src/config/diagnostics.ts +28 -0
  204. package/src/config/feature-flags.ts +9 -0
  205. package/src/config/live-reconcile.ts +10 -1
  206. package/src/config/load-degrade.ts +12 -1
  207. package/src/config/multi-agent-surface.ts +28 -5
  208. package/src/config/pending-teardown.ts +60 -3
  209. package/src/config/process-state.ts +175 -4
  210. package/src/config/provider-validation.ts +4 -4
  211. package/src/config/schema/config-schema.ts +6 -0
  212. package/src/config/schema/leaf-validators.ts +9 -2
  213. package/src/config/windows-process-command-line.ts +107 -0
  214. package/src/generated/compatibility-version.json +948 -392
  215. package/src/generated/model-metadata.ts +1 -1
  216. package/src/images/loop.ts +3 -0
  217. package/src/integrations/model-name-guard.ts +25 -0
  218. package/src/integrations/route-intent-catalog.ts +26 -0
  219. package/src/integrations/route-intent-connected.ts +262 -0
  220. package/src/integrations/route-intent-contract.ts +55 -0
  221. package/src/integrations/route-intent-disconnect.ts +109 -0
  222. package/src/integrations/route-intent-initial.ts +64 -0
  223. package/src/integrations/route-intent-state.ts +117 -0
  224. package/src/integrations/route-intent-tick.ts +65 -0
  225. package/src/integrations/route-intent.ts +212 -0
  226. package/src/integrations/writer.ts +44 -11
  227. package/src/lib/client-retry-after.ts +29 -0
  228. package/src/lib/config-ownership.ts +13 -0
  229. package/src/lib/desktop-gui-origin.ts +28 -0
  230. package/src/lib/errors.ts +1 -1
  231. package/src/lib/gui-pair-capability.ts +2 -1
  232. package/src/lib/messages-error-body.ts +4 -1
  233. package/src/lib/outbound-credential-registry.ts +362 -4
  234. package/src/lib/paced-stream.ts +34 -0
  235. package/src/lib/passive-key-fetch-proof.ts +30 -0
  236. package/src/lib/passive-read.ts +5 -0
  237. package/src/lib/process-control.ts +76 -12
  238. package/src/lib/redact.ts +84 -8
  239. package/src/lib/state-store-registrations.ts +11 -0
  240. package/src/lib/state-store-sweeper.ts +4 -0
  241. package/src/lib/supervisor-markers.ts +18 -0
  242. package/src/lib/terminal-safe-text.ts +58 -0
  243. package/src/lib/translator-budget.ts +3 -2
  244. package/src/lib/upstream-retry.ts +14 -4
  245. package/src/link/alias-lock.ts +119 -0
  246. package/src/link/child-activity.ts +28 -2
  247. package/src/link/child-binary-cache-fill.d.mts +50 -0
  248. package/src/link/child-binary-cache-fill.mjs +494 -0
  249. package/src/link/child-binary-cache-start.ts +73 -0
  250. package/src/link/child-binary-source.ts +12 -5
  251. package/src/link/child-gated-ocx.ts +29 -11
  252. package/src/link/child-observations.ts +2 -1
  253. package/src/link/child-observe.ts +2 -2
  254. package/src/link/child-ops-engine.ts +159 -91
  255. package/src/link/child-ops-host.ts +138 -0
  256. package/src/link/child-ops-runners.ts +319 -0
  257. package/src/link/child-ops-scheduler.ts +207 -0
  258. package/src/link/child-ops-types.ts +89 -0
  259. package/src/link/child-parity.ts +23 -4
  260. package/src/link/child-policy.ts +93 -0
  261. package/src/link/child-update-contract.ts +12 -3
  262. package/src/link/codex-settings.ts +1 -1
  263. package/src/link/compatibility.ts +18 -1
  264. package/src/link/diagnostics-read.ts +163 -0
  265. package/src/link/diagnostics.ts +20 -7
  266. package/src/link/explicit-route.ts +209 -0
  267. package/src/link/link-recover.ts +113 -0
  268. package/src/link/management-routes.ts +3 -1
  269. package/src/link/operation-recovery-slot.ts +44 -0
  270. package/src/link/operations-journal.ts +408 -0
  271. package/src/link/peer-report.ts +1 -1
  272. package/src/link/relay-auth.ts +14 -0
  273. package/src/link/remote-plant.ts +152 -14
  274. package/src/link/remote-platform.ts +21 -10
  275. package/src/link/remote-probe.ts +11 -3
  276. package/src/link/remote-windows.ts +50 -10
  277. package/src/link/request-compression.ts +30 -0
  278. package/src/link/residual-recovery.ts +54 -0
  279. package/src/link/retirement.ts +128 -0
  280. package/src/link/route-intent-watch.ts +41 -0
  281. package/src/link/route-intent.ts +209 -0
  282. package/src/link/route-proof.ts +82 -0
  283. package/src/link/route-rounds.ts +579 -0
  284. package/src/link/route-select.ts +95 -0
  285. package/src/link/route-trust.ts +96 -0
  286. package/src/link/ssh-argv.ts +172 -24
  287. package/src/link/ssh-capture-redact.ts +253 -0
  288. package/src/link/ssh-capture.ts +497 -0
  289. package/src/link/ssh-runner.ts +141 -14
  290. package/src/link/status-projection.ts +87 -0
  291. package/src/link/store.ts +54 -1
  292. package/src/link/supervisor.ts +543 -55
  293. package/src/link/sync-fanout-classify.ts +16 -0
  294. package/src/link/sync-then-restart.ts +65 -0
  295. package/src/link/tombstones.ts +209 -0
  296. package/src/link/traffic.ts +178 -0
  297. package/src/link/ws-activity-holds.ts +474 -0
  298. package/src/local-credentials/publication-fence.ts +20 -1
  299. package/src/messaging/mcp-queue-rpc.ts +1 -1
  300. package/src/messaging/mcp-queue-server.ts +16 -1
  301. package/src/messaging/mcp-resume-tools.ts +25 -0
  302. package/src/messaging/remote-enrollment.ts +3 -3
  303. package/src/messaging/remote-tunnels.ts +2 -2
  304. package/src/messaging/resume-permissions.ts +27 -0
  305. package/src/messaging/rpc.ts +46 -2
  306. package/src/oauth/anthropic-continuity.ts +23 -7
  307. package/src/oauth/anthropic-routing.ts +5 -2
  308. package/src/oauth/anthropic.ts +22 -2
  309. package/src/oauth/claude-keychain-read.ts +78 -68
  310. package/src/oauth/index.ts +24 -6
  311. package/src/oauth/local-token-detect.ts +8 -29
  312. package/src/oauth/login-cli-errors.ts +5 -1
  313. package/src/oauth/login-cli.ts +33 -18
  314. package/src/oauth/login-flow-state.ts +26 -3
  315. package/src/oauth/meta-muse.ts +1 -1
  316. package/src/oauth/store.ts +7 -0
  317. package/src/oauth/xai.ts +248 -14
  318. package/src/protocols/contract.ts +4 -0
  319. package/src/protocols/encoders/messages.ts +1 -0
  320. package/src/providers/alias-template.ts +48 -0
  321. package/src/providers/anthropic-billing-ownership.ts +2 -0
  322. package/src/providers/anthropic-output-caps.ts +46 -0
  323. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  324. package/src/providers/antigravity-effort-families.ts +11 -3
  325. package/src/providers/antigravity-models.ts +32 -9
  326. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  327. package/src/providers/api-key-pause.ts +3 -0
  328. package/src/providers/api-key-resolve.ts +49 -7
  329. package/src/providers/api-key-response-ownership.ts +2 -0
  330. package/src/providers/api-key-selection.ts +51 -9
  331. package/src/providers/api-keys.ts +6 -2
  332. package/src/providers/cache-affinity-identity.ts +73 -0
  333. package/src/providers/cache-affinity.ts +256 -0
  334. package/src/providers/default-aliases.ts +98 -20
  335. package/src/providers/google-vertex-model-discovery.ts +510 -0
  336. package/src/providers/key-failover.ts +123 -8
  337. package/src/providers/key-store.ts +3 -3
  338. package/src/providers/kiro-models.ts +3 -5
  339. package/src/providers/label.ts +31 -5
  340. package/src/providers/mistral-transport.ts +17 -4
  341. package/src/providers/model-rename-fields.ts +3 -0
  342. package/src/providers/muse-key-quota.ts +14 -6
  343. package/src/providers/new-model-policy-runtime.ts +17 -4
  344. package/src/providers/new-model-policy.ts +30 -4
  345. package/src/providers/passive-key-observation.ts +252 -0
  346. package/src/providers/quota/account-cache.ts +2 -1
  347. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  348. package/src/providers/quota/passive-key-limits.ts +272 -0
  349. package/src/providers/quota/passive-wire-model.ts +126 -0
  350. package/src/providers/quota/report-cache.ts +61 -2
  351. package/src/providers/quota-key-accounts.ts +11 -6
  352. package/src/providers/quota-types.ts +18 -0
  353. package/src/providers/quota.ts +11 -12
  354. package/src/providers/registry/entries-core.ts +34 -16
  355. package/src/providers/registry/entries-extended.ts +32 -0
  356. package/src/providers/registry/model-seeds.ts +35 -0
  357. package/src/providers/resolved-model-policy.ts +7 -0
  358. package/src/providers/routed-config.ts +8 -3
  359. package/src/providers/xai-transport.ts +3 -0
  360. package/src/remote/features.ts +17 -0
  361. package/src/responses/anthropic-progress.ts +10 -4
  362. package/src/responses/citation-markers.ts +231 -0
  363. package/src/responses/spill-store.ts +5 -1
  364. package/src/responses/state/replay-input.ts +50 -0
  365. package/src/responses/state/replay-owner.ts +24 -0
  366. package/src/responses/state/snapshot-codec.ts +9 -0
  367. package/src/responses/state/spill-queue.ts +1 -0
  368. package/src/responses/state.ts +42 -60
  369. package/src/router.ts +2 -2
  370. package/src/routing/home-route-capture.ts +123 -0
  371. package/src/routing/home-route-intent.ts +200 -0
  372. package/src/routing/route-intent-state.ts +178 -0
  373. package/src/routing/route-to-live-settings.ts +35 -0
  374. package/src/routing/route-to-local.ts +145 -0
  375. package/src/routing/route-to-status.ts +94 -0
  376. package/src/routing/route-to-sync-child.ts +32 -0
  377. package/src/server/adapter-resolve.ts +21 -1
  378. package/src/server/admitted-http-turn.ts +3 -0
  379. package/src/server/auth-cors.ts +98 -0
  380. package/src/server/bare-upstream-error.ts +220 -0
  381. package/src/server/chat-native.ts +14 -5
  382. package/src/server/claude-messages.ts +6 -4
  383. package/src/server/codex-model-list.ts +2 -1
  384. package/src/server/configured-credentials.ts +37 -5
  385. package/src/server/gui-desktop-authorization.ts +36 -0
  386. package/src/server/gui-pair-delivery.ts +6 -3
  387. package/src/server/gui-session.ts +10 -1
  388. package/src/server/inbound-body-admission.ts +17 -4
  389. package/src/server/index/link-listener.ts +190 -12
  390. package/src/server/index/link-management.ts +15 -1
  391. package/src/server/index/link-relay-sessions.ts +87 -8
  392. package/src/server/index/link-websocket-limits.ts +136 -0
  393. package/src/server/index/link-websocket.ts +692 -0
  394. package/src/server/index/optional-listeners.ts +97 -7
  395. package/src/server/index/route-intent-watch.ts +47 -0
  396. package/src/server/index/serve-contract.ts +86 -0
  397. package/src/server/index/serve-options.ts +35 -86
  398. package/src/server/index/startup-warnings.ts +8 -2
  399. package/src/server/index/websocket-handler.ts +26 -4
  400. package/src/server/index.ts +12 -2
  401. package/src/server/inference/client-encoder-delivery.ts +2 -0
  402. package/src/server/inspection-tee.ts +39 -2
  403. package/src/server/lifecycle.ts +2 -0
  404. package/src/server/link-turn.ts +137 -0
  405. package/src/server/management/advisor-routes.ts +10 -2
  406. package/src/server/management/agent-settings-routes.ts +50 -16
  407. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  408. package/src/server/management/context.ts +9 -2
  409. package/src/server/management/desktop-authorization.ts +41 -0
  410. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  411. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  412. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  413. package/src/server/management/home-integration-decision.ts +89 -0
  414. package/src/server/management/integration-routes.ts +208 -81
  415. package/src/server/management/link-child-ops-routes.ts +145 -43
  416. package/src/server/management/link-child-preflight.ts +31 -0
  417. package/src/server/management/link-diagnostics-route.ts +29 -0
  418. package/src/server/management/link-enrollment.ts +199 -47
  419. package/src/server/management/link-operation.ts +609 -0
  420. package/src/server/management/link-recover-route.ts +103 -0
  421. package/src/server/management/link-route-edit.ts +173 -0
  422. package/src/server/management/link-route-request.ts +62 -0
  423. package/src/server/management/link-route-state.ts +83 -7
  424. package/src/server/management/link-routes.ts +553 -51
  425. package/src/server/management/link-traffic-status.ts +13 -0
  426. package/src/server/management/model-routes.ts +122 -36
  427. package/src/server/management/model-rows.ts +2 -1
  428. package/src/server/management/native-integration-routes.ts +176 -70
  429. package/src/server/management/oauth-account-routes.ts +36 -13
  430. package/src/server/management/protocol-routes.ts +7 -0
  431. package/src/server/management/provider-completion-test.ts +4 -4
  432. package/src/server/management/provider-overwrite-carry.ts +11 -0
  433. package/src/server/management/provider-routes.ts +64 -61
  434. package/src/server/management/provider-routing-quota.ts +45 -0
  435. package/src/server/management/route-registry.ts +22 -3
  436. package/src/server/management/route-to-routes.ts +257 -0
  437. package/src/server/management/system-restart.ts +4 -2
  438. package/src/server/management/usage-aggregate-cache.ts +101 -66
  439. package/src/server/management-api.ts +17 -3
  440. package/src/server/management-auth.ts +13 -1
  441. package/src/server/messages-native-preflight.ts +27 -4
  442. package/src/server/messages-native.ts +17 -5
  443. package/src/server/persistent-gui-session.ts +6 -3
  444. package/src/server/proxy-liveness.ts +33 -6
  445. package/src/server/relay-eager.ts +36 -12
  446. package/src/server/relay.ts +183 -116
  447. package/src/server/request-body-facts.ts +48 -0
  448. package/src/server/request-decompress.ts +65 -2
  449. package/src/server/request-log-account-rotation.ts +6 -0
  450. package/src/server/request-log-attempt-usage.ts +69 -0
  451. package/src/server/request-log-cache-affinity.ts +60 -0
  452. package/src/server/request-log-conversation.ts +45 -2
  453. package/src/server/request-log-terminal-status.ts +210 -24
  454. package/src/server/request-log.ts +71 -79
  455. package/src/server/responses/adapter-continuation.ts +2 -1
  456. package/src/server/responses/adapter-delivery.ts +2 -0
  457. package/src/server/responses/adapter-dispatch.ts +5 -7
  458. package/src/server/responses/advisor-plan-slot.ts +33 -1
  459. package/src/server/responses/advisor-question.ts +21 -0
  460. package/src/server/responses/advisor-slot.ts +10 -3
  461. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  462. package/src/server/responses/buffered-sse-json.ts +9 -3
  463. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  464. package/src/server/responses/codex-tool-catalog.ts +156 -0
  465. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  466. package/src/server/responses/combo-stream-preflight.ts +557 -54
  467. package/src/server/responses/compact.ts +32 -8
  468. package/src/server/responses/core-codex-account.ts +17 -3
  469. package/src/server/responses/core-combo-failure.ts +8 -0
  470. package/src/server/responses/core-combo.ts +32 -4
  471. package/src/server/responses/core-errors.ts +5 -2
  472. package/src/server/responses/core-lifetime.ts +3 -2
  473. package/src/server/responses/core-normalize.ts +3 -1
  474. package/src/server/responses/core-options.ts +6 -0
  475. package/src/server/responses/core.ts +2 -0
  476. package/src/server/responses/fetch-helpers.ts +15 -10
  477. package/src/server/responses/native-replay-guard.ts +57 -0
  478. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  479. package/src/server/responses/outbound-request-body.ts +29 -0
  480. package/src/server/responses/passthrough-completion.ts +105 -8
  481. package/src/server/responses/passthrough-delivery.ts +31 -11
  482. package/src/server/responses/passthrough-dispatch.ts +74 -73
  483. package/src/server/responses/policy-fallback.ts +13 -1
  484. package/src/server/responses/request-prepare.ts +50 -6
  485. package/src/server/responses/request-transport.ts +10 -3
  486. package/src/server/responses/reset-replay.ts +46 -2
  487. package/src/server/responses/run-turn-execution.ts +2 -0
  488. package/src/server/responses/sidecar-execution.ts +14 -0
  489. package/src/server/responses/terminal-error-redaction.ts +222 -25
  490. package/src/server/responses/ws-upstream.ts +2 -2
  491. package/src/server/sse-payload-rewrite.ts +3 -2
  492. package/src/server/stop-service-route.ts +85 -0
  493. package/src/server/system-env-shell.ts +12 -1
  494. package/src/server/system-env.ts +5 -3
  495. package/src/server/windows-tcp-drop.ts +21 -4
  496. package/src/server/workflow-refusal.ts +8 -0
  497. package/src/server/ws-bridge.ts +191 -12
  498. package/src/service/cli-windows-stop.ts +189 -0
  499. package/src/service/cli.ts +41 -12
  500. package/src/service/disconnected-client-restart.ts +60 -0
  501. package/src/service/guarded-manager-target.ts +18 -1
  502. package/src/service/health.ts +99 -6
  503. package/src/service/launchd.ts +84 -31
  504. package/src/service/orchestration.ts +418 -91
  505. package/src/service/repair.ts +223 -6
  506. package/src/service/restart-proxy-stop.ts +79 -0
  507. package/src/service/service-child-ownership.ts +6 -2
  508. package/src/service/windows-checked-stop-live.ts +467 -0
  509. package/src/service/windows-checked-stop.ts +435 -0
  510. package/src/service/windows-command-line-token.ts +23 -0
  511. package/src/service/windows-guarded-manager.ts +77 -34
  512. package/src/service/windows-ops.ts +38 -56
  513. package/src/service/windows-process-evidence.ts +292 -0
  514. package/src/service/windows-process-native.ts +262 -0
  515. package/src/service/windows-service-stop.ts +321 -0
  516. package/src/service/windows-stop-binding.ts +187 -0
  517. package/src/service/windows-stop-budget.ts +123 -0
  518. package/src/service/windows-stop-confirm.ts +158 -0
  519. package/src/service/windows-stop-deadline.ts +56 -0
  520. package/src/service.ts +2 -2
  521. package/src/types/config.ts +42 -18
  522. package/src/types/link.ts +20 -0
  523. package/src/types/multi-agent.ts +13 -0
  524. package/src/types/provider.ts +47 -2
  525. package/src/types/request.ts +4 -0
  526. package/src/types.ts +3 -0
  527. package/src/update/guarded-runtime-ops.ts +5 -7
  528. package/src/update/index.ts +25 -10
  529. package/src/update/install-detection.mjs +3 -1
  530. package/src/update/job-pinned-start.ts +2 -0
  531. package/src/update/job-windows-restart.ts +19 -32
  532. package/src/update/job.ts +12 -5
  533. package/src/update/npm-install.d.mts +11 -0
  534. package/src/update/npm-install.mjs +44 -7
  535. package/src/update/orchestrated-entry.ts +1 -1
  536. package/src/update/orchestrated-node-driver.mjs +3 -2
  537. package/src/update/orchestrated-pnpm.d.mts +4 -0
  538. package/src/update/orchestrated-pnpm.mjs +50 -6
  539. package/src/update/orchestrated-session.d.mts +3 -1
  540. package/src/update/orchestrated-session.mjs +21 -6
  541. package/src/update/pnpm-global-install.d.mts +21 -3
  542. package/src/update/pnpm-global-install.mjs +322 -19
  543. package/src/update/pnpm-store-layout.mjs +46 -0
  544. package/src/update/sync-update-mutex.d.mts +3 -2
  545. package/src/update/sync-update-mutex.mjs +57 -8
  546. package/src/update/transactional-install.d.mts +3 -1
  547. package/src/update/transactional-install.mjs +545 -12
  548. package/src/update/windows-installer-marker.d.mts +1 -0
  549. package/src/update/windows-installer-marker.mjs +44 -0
  550. package/src/usage/expected-prices.ts +8 -0
  551. package/src/usage/filter-index.ts +326 -77
  552. package/src/usage/ledger-scanner.ts +15 -0
  553. package/src/usage/link-log-fields.ts +48 -0
  554. package/src/usage/log.ts +43 -2
  555. package/src/usage/request-body.ts +37 -0
  556. package/src/web-search/loop.ts +3 -0
  557. package/gui/dist/assets/App-BpJOzw4F.js +0 -59
  558. package/gui/dist/assets/index-Bbor_y80.js +0 -94
  559. package/gui/dist/classic/assets/App-BrIlUiLc.js +0 -58
  560. package/gui/dist/classic/assets/index-DyJHagvT.js +0 -94
  561. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -0,0 +1,609 @@
1
+ /**
2
+ * The management side of the operation journal (src/link/operations-journal.ts; structure/remote-link.md,
3
+ * "Operation journal"): the per-alias lock around apply and revoke, the handle apply marks its effects through,
4
+ * the replay of a recorded outcome, and the recovery of an entry whose process died before it finished.
5
+ */
6
+ import { randomUUID } from "node:crypto";
7
+ import { existsSync } from "node:fs";
8
+ import { AliasLockError, withAliasLock } from "../../link/alias-lock";
9
+ import type { ExplicitRoute } from "../../link/explicit-route";
10
+ import { assertRoomForNewOperation, findOperation, hasEffect, isOperationId, markRevokeLive, OPERATION_JOURNAL_MAX_RECENT_SETTLED, OPERATION_JOURNAL_MAX_UNSETTLED, OperationsJournalFullError, openEnrollmentFor, operationDigest, operationsJournalPath, readOperationsJournal, resolveLinkOperation, updateOperationsJournal,
11
+ type EnrollEffect, type LinkOperation, type OperationsJournal, type OperationState, type RevokeEffect } from "../../link/operations-journal";
12
+ import { readLinkRetirement, type LinkRetirement } from "../../link/retirement";
13
+ import { residualRecovery } from "../../link/residual-recovery";
14
+ import { newLinkId } from "../../link/store";
15
+ import type { ManagementContext } from "./context";
16
+ import { compensateNewLink, fail, readStoreFor, revokeKeyIdempotent, type LinkRouteState } from "./link-route-state";
17
+ import type { RouteRequest } from "./link-route-request";
18
+
19
+ /** A damaged operations.json: nothing reads it as empty, so the answer names the way out. */
20
+ export function journalUnreadable(): Response {
21
+ return fail("operation_journal_unreadable", "The link operation journal (<configDir>/link/operations.json) is damaged; keep a copy, move it aside, and retry. ocx link operations shows the same error; a revoke with --force still runs.", 500);
22
+ }
23
+
24
+ /** Compensation that could not finish: whether anything this operation created remains is unknown. */
25
+ const UNKNOWN_CODES = new Set(["compensation_failed", "key_cleanup_failed", "link_cleanup_uncertain", "key_issue_uncertain"]);
26
+ /** The link a residual's Child step is bound to: an enrollment's reserved id, a revoke's own link. */
27
+ function residualLinkId(op: LinkOperation): string | undefined {
28
+ return op.kind === "enroll" ? op.reserved?.linkId : op.linkId;
29
+ }
30
+
31
+ /** The Child's side of a residual, as a closed word a client maps to its own guidance. */
32
+ function residualKind(op: LinkOperation): "plant" | "enrollment" | undefined {
33
+ if (op.state !== "residual" && !op.childResidual) return undefined;
34
+ return hasEffect(op, "plant", "intent") ? "plant" : "enrollment";
35
+ }
36
+
37
+ export interface OperationRequest { id: string; digest: string }
38
+
39
+ export function journalPathFor(ctx: ManagementContext): string {
40
+ return ctx.deps.linkOperationsPath?.() ?? operationsJournalPath();
41
+ }
42
+
43
+ const nowOf = (ctx: ManagementContext) => (ctx.deps.now ?? Date.now)();
44
+ const iso = (ctx: ManagementContext) => new Date(nowOf(ctx)).toISOString();
45
+
46
+ /**
47
+ * A revoke entry that still owns its link's retirement receipt is never pruned (#8416): its replay is the only path
48
+ * that settles that receipt from its own evidence, recovery must not lose it between two effect marks, and a pruned
49
+ * id could be reused by an unrelated operation. A receipt that cannot be read keeps the entry.
50
+ */
51
+ export function ownsRetirement(op: LinkOperation): boolean {
52
+ if (op.kind !== "revoke" || op.linkId === undefined) return false;
53
+ // Its former owner too: every later plain force fences that entry, so it must outlive its retention while the receipt does.
54
+ try {
55
+ const receipt = readLinkRetirement(op.linkId);
56
+ return receipt?.operationId === op.operationId || receipt?.formerOwner === op.operationId;
57
+ } catch { return true; }
58
+ }
59
+
60
+ function retirementOutstanding(op: LinkOperation): boolean {
61
+ if (op.linkId === undefined) return false;
62
+ try { return readLinkRetirement(op.linkId) !== null; } catch { return true; }
63
+ }
64
+
65
+ /**
66
+ * Whether the journal recorded the Child cleanup a receipt stands for (#8416): its owner (the revoke of that link under
67
+ * the receipt's id) marked remote_cleanup done and, for a purge, holds the Child's purged:true for that link. This is
68
+ * the evidence a replayed purge already answers from; the receipt alone is not. Unreadable is false.
69
+ */
70
+ export function cleanupRecorded(ctx: ManagementContext, receipt: LinkRetirement): boolean {
71
+ let owner: LinkOperation | undefined;
72
+ try { owner = retirementOwner(readOperationsJournal(journalPathFor(ctx)), receipt); } catch { return false; }
73
+ if (!owner || !hasEffect(owner, "remote_cleanup", "done")) return false;
74
+ return receipt.mode !== "purge" || (owner.receipt?.purged === true && owner.receipt.linkId === receipt.link.id);
75
+ }
76
+
77
+ /**
78
+ * The journalled owner of a retirement receipt: the revoke of that same link under the receipt's operation id. With
79
+ * includeFormer, a receipt a plain --force disowned answers its former owner, which every later force fences too.
80
+ */
81
+ export function retirementOwner(journal: OperationsJournal, receipt: LinkRetirement, includeFormer = false): LinkOperation | undefined {
82
+ const id = receipt.operationId ?? (includeFormer ? receipt.formerOwner : undefined);
83
+ if (id === undefined) return undefined;
84
+ const op = findOperation(journal, id);
85
+ return op && op.kind === "revoke" && op.linkId === receipt.link.id ? op : undefined;
86
+ }
87
+
88
+ function updateJournalPinned<T>(path: string, nowMs: number, change: (journal: OperationsJournal) => T): T {
89
+ return updateOperationsJournal(path, nowMs, change, ownsRetirement);
90
+ }
91
+
92
+ /**
93
+ * The parameters that name an enrollment. plant is left out: it follows from what the probe found, and a repeat
94
+ * replays without probing, so it cannot restate it.
95
+ */
96
+ export function enrollOperationDigest(params: { alias: string; fingerprint?: string; route: RouteRequest; requireEphemeral: boolean }): string {
97
+ return operationDigest({ kind: "enroll", alias: params.alias, fingerprint: params.fingerprint ?? null,
98
+ explicitRoute: params.route.explicitRoute, exclusive: params.route.exclusive, requireEphemeral: params.requireEphemeral });
99
+ }
100
+
101
+ /**
102
+ * Has this Home ever journalled an operation? Until it has, an apply or revoke without an operation id behaves
103
+ * exactly as before: no lock file, no journal read, no new refusal.
104
+ */
105
+ export function journalInUse(ctx: ManagementContext): boolean {
106
+ return existsSync(journalPathFor(ctx));
107
+ }
108
+
109
+ /**
110
+ * Apply and revoke run under their alias's lock when required (an operation id, or a Home that has a journal); a
111
+ * holder past the wait answers 409. Not required: the action runs as it always did.
112
+ */
113
+ export async function underAliasLock(ctx: ManagementContext, alias: string, required: boolean, action: () => Promise<Response>): Promise<Response> {
114
+ if (!required) return await action();
115
+ try { return await withAliasLock(alias, { ...ctx.deps.linkAliasLock, signal: ctx.req.signal }, action); } catch (error) {
116
+ if (error instanceof AliasLockError) {
117
+ if (error.code === "link_alias_lock_busy") return fail("link_operation_in_progress", "Another enrollment or revoke of this alias is running; try again when it ends.", 409);
118
+ // The client went away while waiting: nothing ran, and nobody is left to read a longer answer.
119
+ if (error.code === "link_alias_lock_aborted") return fail("link_operation_in_progress", "The request ended while it waited for this alias; nothing was changed.", 409);
120
+ return fail("link_alias_lock_failed", "The alias lock could not be taken.", 500);
121
+ }
122
+ throw error;
123
+ }
124
+ }
125
+
126
+ /** An open revoke entry of another operation for this link refuses every other revoke of it. */
127
+ export function openRevokeConflict(ctx: ManagementContext, linkId: string, except?: string, force = false): Response | null {
128
+ if (!journalInUse(ctx)) return null;
129
+ let open: LinkOperation | undefined;
130
+ try { open = readOperationsJournal(journalPathFor(ctx)).operations.find(op => op.kind === "revoke" && op.state === "open" && op.linkId === linkId && op.operationId !== except); } catch {
131
+ // --force is the escape hatch: it skips remote cleanup by design, so it must not be locked out by a damaged journal.
132
+ if (force) { console.warn("[link] operation journal unreadable; force revoke proceeds without the open-entry check linkId=" + linkId); return null; }
133
+ return journalUnreadable();
134
+ }
135
+ return open ? fail("link_operation_open", "An unfinished revoke holds this link; repeat it with its operation id to settle it.", 409) : null;
136
+ }
137
+
138
+ /** An open enroll entry of another operation for this alias refuses every other enrollment. */
139
+ export function openEnrollmentConflict(ctx: ManagementContext, alias: string, except?: string): Response | null {
140
+ if (!journalInUse(ctx)) return null;
141
+ let open: LinkOperation | undefined;
142
+ try { open = openEnrollmentFor(readOperationsJournal(journalPathFor(ctx)), alias, except); } catch {
143
+ return journalUnreadable();
144
+ }
145
+ return open ? fail("link_operation_open", "An unfinished enrollment holds this alias; repeat it with its operation id to settle it.", 409) : null;
146
+ }
147
+
148
+ function outcomeBody(op: LinkOperation): Record<string, unknown> {
149
+ return { operationId: op.operationId, outcome: op.state };
150
+ }
151
+
152
+ /** The recorded outcome as a response: committed answers like the apply that committed. */
153
+ /** A new operation's entry could not be written: 409 when the journal is full, 500 otherwise. Nothing ran either way. */
154
+ export function journalOpenFailure(error: unknown): Response {
155
+ if (!(error instanceof OperationsJournalFullError)) return fail("operation_journal_failed", "The link operation journal could not be written; nothing was changed.", 500);
156
+ const message = error.bound === "unsettled"
157
+ ? "The link operation journal holds " + OPERATION_JOURNAL_MAX_UNSETTLED + " unsettled operations. Check the Child of each residual or unknown one and run ocx link operations resolve --operation-id <id> --yes; repeat an open one with its operation id first (ocx link operations lists them). Nothing was changed."
158
+ : "The link operation journal holds " + OPERATION_JOURNAL_MAX_RECENT_SETTLED + " operations that settled within the last 2 hours and three minutes; retry once the oldest of them is older than that. Nothing was changed.";
159
+ // bound is a closed field a CLI picks its own guidance by; it is additive, and an older CLI drops it and still refuses.
160
+ return Response.json({ error: { code: "operation_journal_full", message }, bound: error.bound }, { status: 409, headers: { "cache-control": "no-store" } });
161
+ }
162
+
163
+ export function replayResponse(op: LinkOperation): Response {
164
+ if (op.state === "committed") {
165
+ return Response.json(op.kind === "enroll" ? { linkId: op.reserved!.linkId, ...outcomeBody(op), ...(hasEffect(op, "plant", "done") ? { planted: true } : {}) }
166
+ : { linkId: op.linkId, ...outcomeBody(op), ...(op.receipt ? { purged: true } : {}) }, { status: op.kind === "enroll" ? 202 : 200 });
167
+ }
168
+ const error = op.error ?? { code: "operation_interrupted", status: 409 };
169
+ return Response.json({
170
+ error: { code: error.code, message: "The operation ended " + op.state + "; this is its recorded outcome." },
171
+ ...outcomeBody(op),
172
+ // The Child's step is bound to the link id the journal recorded before anything changed (src/link/residual-recovery.ts).
173
+ ...(residualKind(op) ? { residual: true, residualKind: residualKind(op), ...(residualLinkId(op) ? { linkId: residualLinkId(op) } : {}),
174
+ recovery: residualRecovery(residualKind(op) === "plant" ? "plant" : "enrollment", residualLinkId(op)) } : {}),
175
+ }, { status: error.status, headers: { "cache-control": "no-store" } });
176
+ }
177
+
178
+ /**
179
+ * A repeat: the same id with the same digest reads its outcome; another digest or kind is refused. An entry
180
+ * still open here belongs to a process that died (this caller holds the alias lock), so it is recovered first.
181
+ * null when there is no entry.
182
+ */
183
+ export async function replayOperation(ctx: ManagementContext, state: LinkRouteState, request: OperationRequest, kind: LinkOperation["kind"]): Promise<Response | null> {
184
+ let op: LinkOperation | undefined;
185
+ try { op = findOperation(readOperationsJournal(journalPathFor(ctx)), request.id); } catch {
186
+ return journalUnreadable();
187
+ }
188
+ if (!op) return null;
189
+ if (op.kind !== kind || op.digest !== request.digest) return fail("operation_mismatch", "This operation id was used with other parameters.", 409);
190
+ if (op.state === "open") op = kind === "enroll" ? await recoverEnroll(ctx, state, op) : recoverRevoke(ctx, op);
191
+ return replayResponse(op);
192
+ }
193
+
194
+ function settle(ctx: ManagementContext, operationId: string, outcome: OperationState, error?: { code: string; status: number }, childResidual = false): LinkOperation {
195
+ return updateJournalPinned(journalPathFor(ctx), nowOf(ctx), journal => {
196
+ const op = findOperation(journal, operationId)!;
197
+ op.state = outcome;
198
+ if (childResidual && op.kind === "enroll") op.childResidual = true;
199
+ op.updatedAt = iso(ctx);
200
+ if (outcome !== "open") op.finishedAt = op.updatedAt;
201
+ if (error && outcome !== "committed") op.error = error;
202
+ return structuredClone(op);
203
+ });
204
+ }
205
+
206
+ /**
207
+ * Recovery by reserved id. A completed relay verification committed; only its outcome write was lost. Otherwise
208
+ * whatever carries this operation's reserved link id or key id is undone; another link for the alias is not this
209
+ * operation's and makes the outcome unknown, as does compensation that does not finish. A Child that was asked to
210
+ * enroll, or given a plant, may still hold it: residual.
211
+ */
212
+ async function recoverEnroll(ctx: ManagementContext, state: LinkRouteState, op: LinkOperation): Promise<LinkOperation> {
213
+ const reserved = op.reserved!;
214
+ const interrupted = { code: "operation_interrupted", status: 409 };
215
+ if (hasEffect(op, "relay_verified", "done")) return settle(ctx, op.operationId, "committed");
216
+ const store = readStoreFor(ctx), wanted = op.alias.toLowerCase();
217
+ const childTouched = hasEffect(op, "child_enrolled", "intent") || hasEffect(op, "plant", "intent");
218
+ if (store.links.some(link => link.direction === "hub-initiated" && link.alias.toLowerCase() === wanted && link.id !== reserved.linkId)) {
219
+ // Which link is whose is unclear, so the outcome is unknown; but the reserved key id names only this operation's
220
+ // key, and with no record carrying the reserved link id nothing depends on it.
221
+ if (!store.links.some(link => link.id === reserved.linkId)) revokeKeyIdempotent(ctx, reserved.apiKeyId);
222
+ return settle(ctx, op.operationId, "unknown", interrupted, childTouched);
223
+ }
224
+ const record = store.links.find(link => link.id === reserved.linkId);
225
+ if (record) {
226
+ if (await compensateNewLink(ctx, state, record)) return settle(ctx, op.operationId, "unknown", interrupted, childTouched);
227
+ } else if (!revokeKeyIdempotent(ctx, reserved.apiKeyId)) {
228
+ return settle(ctx, op.operationId, "unknown", interrupted, childTouched);
229
+ }
230
+ return settle(ctx, op.operationId, childTouched ? "residual" : "failed_clean", interrupted);
231
+ }
232
+
233
+ /**
234
+ * A revoke whose process died, settled from its own marks only. Its link counts as removed by it only after its own
235
+ * removal intent: every other revoke of the link was refused while this entry was open, so a record gone after that
236
+ * mark went by this operation's write, and a record gone before it went some other way (unknown). With the record
237
+ * still there, any started effect (cleanup on the Child, the key revoke, the removal) leaves it unknown.
238
+ */
239
+ function recoverRevoke(ctx: ManagementContext, op: LinkOperation): LinkOperation {
240
+ const removed = !readStoreFor(ctx).links.some(link => link.id === op.linkId);
241
+ const removalStarted = hasEffect(op, "record_removed", "intent");
242
+ // A retirement receipt still outstanding for the link means its post-commit work has not finished (#8416): this
243
+ // revoke's own receipt was resumed before replay, so one left here belongs to another identity or is unreadable.
244
+ const outstanding = retirementOutstanding(op);
245
+ if (removed && removalStarted && !outstanding) return settle(ctx, op.operationId, "committed");
246
+ // An outstanding receipt counts as touched: a removal was claimed and its outcome is not known to be nothing.
247
+ const touched = removalStarted || outstanding || hasEffect(op, "remote_cleanup", "intent") || hasEffect(op, "key_revoked", "intent");
248
+ return settle(ctx, op.operationId, removed || touched ? "unknown" : "failed_clean", { code: "operation_interrupted", status: 409 });
249
+ }
250
+
251
+ /** A plain --force's hold on the owner of the receipt it finishes (fenceRetirementOwnerForForce). */
252
+ export interface ForceTakeover {
253
+ readonly operationId: string;
254
+ /**
255
+ * The journal the force's removal runs with: it writes no marks (the force claims nothing); its first intent, written just
256
+ * before the tunnel is held and stopped, marks the takeover begun; the owner settles before the receipt is cleared; release
257
+ * drops the owner's live mark with the tunnel hold.
258
+ */
259
+ readonly journal: RevokeJournal;
260
+ /** Whether the force's removal reached the tunnel (its first intent). */
261
+ readonly began: boolean;
262
+ /** Drop the live mark and settle the owner unknown and unresolved: it is never credited with the force's removal. */
263
+ settle(): void;
264
+ /** The takeover never began its removal: drop the live mark and restore the owner exactly as it was. */
265
+ abandon(): void;
266
+ }
267
+
268
+ /**
269
+ * Before a plain --force finishes an owned receipt, fence its owner for the whole takeover (#8416). An open owner (its
270
+ * process died; the force holds the alias lock and this runtime's per-alias set) or an unknown one is reopened as an
271
+ * open, live revoke once that write is durable, so resolve refuses it while the force runs; the force's removal drops the
272
+ * live mark in the same step that releases the tunnel hold, and settle() leaves the owner unknown and unresolved, so a
273
+ * link the force could not remove stays suspended (revokeSuspendsLink). Null when there is no such owner to fence.
274
+ */
275
+ export function fenceRetirementOwnerForForce(ctx: ManagementContext, receipt: LinkRetirement): ForceTakeover | null {
276
+ const path = journalPathFor(ctx);
277
+ // A receipt an earlier force disowned still fences its former owner: a later force could otherwise leave it resolvable.
278
+ const owner = retirementOwner(readOperationsJournal(path), receipt, true);
279
+ if (!owner || (owner.state !== "open" && owner.state !== "unknown")) return null;
280
+ const operationId = owner.operationId;
281
+ const prior = { state: owner.state, finishedAt: owner.finishedAt, resolvedAt: owner.resolvedAt, error: owner.error, updatedAt: owner.updatedAt };
282
+ updateJournalPinned(path, nowOf(ctx), journal => {
283
+ const op = findOperation(journal, operationId);
284
+ if (!op) throw new Error("the revoke operation is no longer journalled");
285
+ if (op.state !== "open") {
286
+ op.state = "open";
287
+ delete op.finishedAt;
288
+ delete op.resolvedAt;
289
+ delete op.error;
290
+ op.updatedAt = iso(ctx);
291
+ }
292
+ });
293
+ markRevokeLive(path, operationId, true);
294
+ let live = true, began = false;
295
+ const drop = (): void => { if (live) { live = false; markRevokeLive(path, operationId, false); } };
296
+ const settleOwner = (): void => {
297
+ const op = findOperation(readOperationsJournal(path), operationId);
298
+ if (op?.state === "open") settle(ctx, operationId, "unknown", { code: "operation_interrupted", status: 409 });
299
+ };
300
+ return {
301
+ operationId,
302
+ get began() { return began; },
303
+ journal: {
304
+ intent() { began = true; }, done() {}, cleanupNotRun() {}, release: drop, finish: async response => response,
305
+ // Settled before the receipt is cleared: a crash after the clear cannot leave the owner open with its own removal
306
+ // intent and the record gone, which recovery would credit to it. A failed write keeps the receipt (and the owner).
307
+ beforeReceiptCleared: () => { drop(); settleOwner(); },
308
+ },
309
+ settle() {
310
+ drop();
311
+ settleOwner();
312
+ },
313
+ abandon() {
314
+ drop();
315
+ if (prior.state === "open") return;
316
+ updateJournalPinned(path, nowOf(ctx), journal => {
317
+ const op = findOperation(journal, operationId);
318
+ if (!op || op.state !== "open") return;
319
+ op.state = prior.state;
320
+ op.updatedAt = prior.updatedAt;
321
+ if (prior.finishedAt !== undefined) op.finishedAt = prior.finishedAt;
322
+ if (prior.resolvedAt !== undefined) op.resolvedAt = prior.resolvedAt;
323
+ if (prior.error !== undefined) op.error = prior.error;
324
+ });
325
+ },
326
+ };
327
+ }
328
+
329
+ /**
330
+ * A recorded revoke whose interrupted retirement was just finished (#8416): its own removal intent preceded the
331
+ * record's disappearance, so it committed, whatever its live response, an earlier recovery or a resolve recorded.
332
+ * The check and the write run in one journal section, so a concurrent resolve cannot leave a committed entry that
333
+ * still carries resolvedAt (which the journal refuses to parse).
334
+ */
335
+ export function settleRevokeAfterRetirement(ctx: ManagementContext, operationId: string): void {
336
+ updateJournalPinned(journalPathFor(ctx), nowOf(ctx), journal => {
337
+ const current = findOperation(journal, operationId);
338
+ // failed_clean too: a write failure right after the receipt claim can leave the owner recorded clean (#8416).
339
+ if (!current || current.kind !== "revoke" || (current.state !== "open" && current.state !== "unknown" && current.state !== "failed_clean")) return;
340
+ if (!hasEffect(current, "record_removed", "intent") || readStoreFor(ctx).links.some(link => link.id === current.linkId)) return;
341
+ current.state = "committed";
342
+ delete current.error;
343
+ delete current.resolvedAt;
344
+ current.updatedAt = iso(ctx);
345
+ current.finishedAt = current.updatedAt;
346
+ });
347
+ }
348
+
349
+ /**
350
+ * The journal of a recorded revoke resuming its interrupted retirement (#8416): the resumed key revoke and record
351
+ * removal are marked on that same entry, so a crash after the resumed removal still settles it as committed.
352
+ * Used only while the link record is present, so a record another removal already took is never credited here.
353
+ * The entry settles before the receipt is cleared: a crash between them leaves the receipt for the next repeat to
354
+ * resume, never a finished removal whose entry stays unknown with nothing left to resume.
355
+ */
356
+ export function resumedRevokeJournal(ctx: ManagementContext, operationId: string, markEffects: boolean): RevokeJournal {
357
+ const path = journalPathFor(ctx);
358
+ let reopened = false;
359
+ // The resumed removal runs as an open, live revoke from its first intent (written before stopLink, whether or not the
360
+ // Child cleanup is rerun): resolve refuses an open entry, so no resolution (earlier or concurrent) can cover a removal
361
+ // whose outcome is pending; a resume that fails settles it unknown and unresolved (settleResumedRevoke), so the link
362
+ // stays suspended (revokeSuspendsLink). The live mark is set only once that reopening write is durable.
363
+ const mark = (effect: RevokeEffect, phase: "intent" | "done", receipt?: { purged: true; linkId: string }) => {
364
+ if (!markEffects) return;
365
+ const reopen = phase === "intent" && !reopened;
366
+ updateJournalPinned(path, nowOf(ctx), journal => {
367
+ const op = findOperation(journal, operationId);
368
+ if (!op) throw new Error("the revoke operation is no longer journalled");
369
+ // Recovery reads only whether a mark exists (hasEffect), so a mark already recorded is not appended again: repeated
370
+ // resumes of a pinned entry cannot grow it past one intent and one completion per effect.
371
+ if (!hasEffect(op, effect, phase)) op.effects.push({ effect, phase, at: iso(ctx) });
372
+ if (receipt) op.receipt = receipt;
373
+ op.updatedAt = iso(ctx);
374
+ if (reopen && op.state !== "open") {
375
+ op.state = "open";
376
+ delete op.finishedAt;
377
+ delete op.resolvedAt;
378
+ delete op.error;
379
+ }
380
+ });
381
+ if (reopen) {
382
+ reopened = true;
383
+ markRevokeLive(path, operationId, true);
384
+ }
385
+ };
386
+ return {
387
+ operationId,
388
+ keepsTunnelDown: true,
389
+ intent: effect => mark(effect, "intent"),
390
+ // As for a fresh revoke: a completion is best effort unless it carries the Child's purge receipt.
391
+ done: (effect, receipt) => {
392
+ try { mark(effect, "done", receipt); } catch (error) {
393
+ if (receipt) throw error;
394
+ console.warn("[link] resumed revoke journal mark not written operation=" + operationId + " mark=" + effect + ":done");
395
+ }
396
+ },
397
+ beforeReceiptCleared: () => settleRevokeAfterRetirement(ctx, operationId),
398
+ cleanupNotRun: () => {},
399
+ release: () => { if (reopened) markRevokeLive(path, operationId, false); },
400
+ finish: async response => response,
401
+ };
402
+ }
403
+
404
+ /**
405
+ * A resumed retirement that did not finish (#8416): an owner it left open settles unknown, unresolved, with the
406
+ * failure's code, as a fresh revoke's finish settles it; its live mark goes in the same step.
407
+ */
408
+ export async function settleResumedRevoke(ctx: ManagementContext, operationId: string, response: Response): Promise<void> {
409
+ const path = journalPathFor(ctx);
410
+ // Dropped before anything awaits: an open entry that is not live is suspended until it settles.
411
+ markRevokeLive(path, operationId, false);
412
+ try {
413
+ let code = "revoke_failed";
414
+ try {
415
+ const body = await response.clone().json() as { error?: { code?: unknown } };
416
+ if (typeof body.error?.code === "string" && /^[a-z][a-z0-9_]{0,63}$/.test(body.error.code)) code = body.error.code;
417
+ } catch { /* keeps revoke_failed */ }
418
+ const op = findOperation(readOperationsJournal(path), operationId);
419
+ if (op?.state === "open") settle(ctx, operationId, "unknown", { code, status: response.status >= 400 && response.status <= 599 ? response.status : 500 });
420
+ } finally { markRevokeLive(path, operationId, false); }
421
+ }
422
+
423
+ export interface EnrollJournal {
424
+ readonly reservedLinkId?: string;
425
+ readonly reservedKeyId?: string;
426
+ intent(effect: EnrollEffect): void;
427
+ done(effect: EnrollEffect): void;
428
+ port(tunnelPort: number): void;
429
+ /** Record the outcome of the live response and add operationId and outcome to it. */
430
+ finish(response: Response): Promise<Response>;
431
+ }
432
+
433
+ export const NO_ENROLL_JOURNAL: EnrollJournal = {
434
+ intent() {}, done() {}, port() {}, finish: async response => response,
435
+ };
436
+
437
+ /** Write the open entry with its reserved identities; any write failure throws before an effect runs. */
438
+ export function openEnrollJournal(ctx: ManagementContext, request: OperationRequest, alias: string, route: { explicitRoute?: ExplicitRoute; exclusive?: true }): EnrollJournal {
439
+ const path = journalPathFor(ctx), reservedLinkId = newLinkId(), reservedKeyId = randomUUID();
440
+ updateJournalPinned(path, nowOf(ctx), journal => {
441
+ assertRoomForNewOperation(journal, nowOf(ctx));
442
+ journal.operations.push({
443
+ operationId: request.id, kind: "enroll", alias, digest: request.digest, createdAt: iso(ctx), updatedAt: iso(ctx), state: "open",
444
+ reserved: { linkId: reservedLinkId, apiKeyId: reservedKeyId, tunnelPort: null, ...route }, effects: [],
445
+ });
446
+ });
447
+ const change = (edit: (op: LinkOperation) => void) => updateJournalPinned(path, nowOf(ctx), journal => {
448
+ const op = findOperation(journal, request.id)!;
449
+ edit(op);
450
+ op.updatedAt = iso(ctx);
451
+ });
452
+ return {
453
+ reservedLinkId, reservedKeyId,
454
+ intent: effect => change(op => { op.effects.push({ effect, phase: "intent", at: iso(ctx) }); }),
455
+ done: effect => change(op => { op.effects.push({ effect, phase: "done", at: iso(ctx) }); }),
456
+ port: tunnelPort => change(op => { op.reserved!.tunnelPort = tunnelPort; }),
457
+ async finish(response) {
458
+ let body: Record<string, unknown> = {};
459
+ try { body = await response.clone().json() as Record<string, unknown>; } catch { /* a body that is not JSON keeps its status */ }
460
+ const errorCode = typeof (body.error as { code?: unknown } | undefined)?.code === "string" ? (body.error as { code: string }).code : "apply_failed";
461
+ // A plant that did not report completion may have installed the binary anyway (a timeout, a lost connection, an
462
+ // exit after the install). Only the script's own refusal before installing (hash_tool_unavailable) proves none.
463
+ let plantUnsettled = false;
464
+ try { const op = findOperation(readOperationsJournal(path), request.id); plantUnsettled = !!op && hasEffect(op, "plant", "intent") && !hasEffect(op, "plant", "done"); } catch { plantUnsettled = true; }
465
+ const hint = (body.error as { hint?: unknown } | undefined)?.hint;
466
+ const outcome: OperationState = response.status === 202 ? "committed"
467
+ : UNKNOWN_CODES.has(errorCode) ? "unknown"
468
+ : body.residual === true || (plantUnsettled && hint !== "hash_tool_unavailable") ? "residual" : "failed_clean";
469
+ let op: LinkOperation;
470
+ // The Child's side is kept apart from the outcome: an unknown key and a plant whose rollback failed are both true.
471
+ const childResidual = outcome !== "committed" && (body.residual === true || plantUnsettled && hint !== "hash_tool_unavailable");
472
+ try { op = settle(ctx, request.id, outcome, { code: /^[a-z][a-z0-9_]{0,63}$/.test(errorCode) ? errorCode : "apply_failed", status: response.status }, childResidual); } catch {
473
+ // The live outcome stands; the open entry is recovered by the next repeat.
474
+ return response;
475
+ }
476
+ const kind = residualKind(op);
477
+ const planted = op.state === "committed" && hasEffect(op, "plant", "done");
478
+ // A residual this answer settles on (a plant that did not report, which returns before the live residual is built) gets
479
+ // the same step a replay gives: bound to the reserved link id. A live line is kept only when it was built for this kind.
480
+ const residualFields = (): Record<string, unknown> => {
481
+ const linkId = residualLinkId(op);
482
+ const platform = body.remotePlatform === "posix" || body.remotePlatform === "windows" ? body.remotePlatform : undefined;
483
+ const install = body.residualInstall === "ephemeral" || body.residualInstall === "full" ? body.residualInstall : "enrollment";
484
+ const keep = body.residualKind === kind && typeof body.recovery === "string" && body.linkId === linkId;
485
+ return { residual: true, residualKind: kind, ...(linkId ? { linkId } : {}),
486
+ recovery: keep ? body.recovery : residualRecovery(kind === "plant" ? "plant" : install, linkId, platform) };
487
+ };
488
+ return Response.json({ ...body, ...outcomeBody(op), ...(kind ? residualFields() : {}), ...(planted ? { planted: true } : {}) },
489
+ { status: response.status, headers: response.headers });
490
+ },
491
+ };
492
+ }
493
+
494
+ export function revokeOperationDigest(params: { linkId: string; purge: boolean; force: boolean }): string {
495
+ return operationDigest({ kind: "revoke", linkId: params.linkId, purge: params.purge, force: params.force });
496
+ }
497
+
498
+ export interface RevokeJournal {
499
+ /** The journalled revoke this removal runs under; its retirement receipt names it. */
500
+ readonly operationId?: string;
501
+ /** Strict: a failed write throws before its effect runs. */
502
+ intent(effect: RevokeEffect): void;
503
+ /**
504
+ * Best effort without a receipt: the effect has already happened and recovery reads an intent without its completion
505
+ * as "may have happened". With a receipt (the Child's purged:true for this link id) it is strict and throws, because
506
+ * the link must not be removed on evidence that a crash would lose.
507
+ */
508
+ done(effect: RevokeEffect, receipt?: { purged: true; linkId: string }): void;
509
+ /** Runs after the post-commit cleanup and before the retirement receipt is cleared; a throw keeps the receipt. */
510
+ beforeReceiptCleared?(): void;
511
+ /**
512
+ * A resumed retirement (#8416): an earlier cleanup attempt may already have reached the Child, so a failed cleanup never
513
+ * restarts the tunnel, even one that provably did not run this time; the owner settles unknown and stays suspended.
514
+ */
515
+ readonly keepsTunnelDown?: boolean;
516
+ /** The Child's cleanup failed before it ran (removeReserved): the outcome can be failed_clean despite its intent. */
517
+ cleanupNotRun(): void;
518
+ /** Drop this revoke's live registration; finish does too, this covers a revoke that threw before it. */
519
+ release(): void;
520
+ finish(response: Response): Promise<Response>;
521
+ }
522
+
523
+ export const NO_REVOKE_JOURNAL: RevokeJournal = { intent() {}, done() {}, cleanupNotRun() {}, release() {}, finish: async response => response };
524
+
525
+ /** Write the open revoke entry; a write failure throws before the revoke changes anything. */
526
+ export function openRevokeJournal(ctx: ManagementContext, request: OperationRequest, alias: string, linkId: string): RevokeJournal {
527
+ const path = journalPathFor(ctx);
528
+ updateJournalPinned(path, nowOf(ctx), journal => {
529
+ assertRoomForNewOperation(journal, nowOf(ctx));
530
+ journal.operations.push({ operationId: request.id, kind: "revoke", alias, linkId, digest: request.digest, createdAt: iso(ctx), updatedAt: iso(ctx), state: "open", effects: [] });
531
+ });
532
+ // Until finish, this entry is the running revoke's: the supervisor does not suspend its link for it (revokeSuspendsLink).
533
+ markRevokeLive(path, request.id, true);
534
+ let cleanupRan = true;
535
+ const change = (edit: (op: LinkOperation) => void) => updateJournalPinned(path, nowOf(ctx), journal => {
536
+ const op = findOperation(journal, request.id)!;
537
+ edit(op);
538
+ op.updatedAt = iso(ctx);
539
+ });
540
+ return {
541
+ operationId: request.id,
542
+ intent: effect => { ctx.deps.linkOperationMarkHook?.(effect, "intent"); change(op => { op.effects.push({ effect, phase: "intent", at: iso(ctx) }); }); },
543
+ done: (effect, receipt) => {
544
+ try {
545
+ ctx.deps.linkOperationMarkHook?.(effect, "done");
546
+ change(op => { op.effects.push({ effect, phase: "done", at: iso(ctx) }); if (receipt) op.receipt = receipt; });
547
+ } catch (error) {
548
+ if (receipt) throw error;
549
+ console.warn("[link] revoke journal mark not written operation=" + request.id + " mark=" + effect + ":done");
550
+ }
551
+ },
552
+ cleanupNotRun: () => { cleanupRan = false; },
553
+ release: () => { markRevokeLive(path, request.id, false); },
554
+ async finish(response) {
555
+ try { return await settleRevoke(response); } finally { markRevokeLive(path, request.id, false); }
556
+ },
557
+ };
558
+ async function settleRevoke(response: Response): Promise<Response> {
559
+ let body: Record<string, unknown> = {};
560
+ try { body = await response.clone().json() as Record<string, unknown>; } catch { /* keeps its status */ }
561
+ const errorCode = typeof (body.error as { code?: unknown } | undefined)?.code === "string" ? (body.error as { code: string }).code : "revoke_failed";
562
+ let current: LinkOperation | undefined;
563
+ try { current = findOperation(readOperationsJournal(path), request.id); } catch { current = undefined; }
564
+ // Clean only when nothing was touched: a cleanup on the Child, a key revoke or a record removal that started
565
+ // (finished or not) may have changed something the failed response does not describe.
566
+ const touched = !current || (cleanupRan && hasEffect(current, "remote_cleanup", "intent")) || hasEffect(current, "key_revoked", "intent") || hasEffect(current, "record_removed", "intent");
567
+ const outcome: OperationState = response.status === 200 ? "committed" : touched ? "unknown" : "failed_clean";
568
+ let op: LinkOperation;
569
+ try { op = settle(ctx, request.id, outcome, { code: /^[a-z][a-z0-9_]{0,63}$/.test(errorCode) ? errorCode : "revoke_failed", status: response.status }); } catch { return response; }
570
+ return Response.json({ ...body, ...outcomeBody(op), ...(op.state === "committed" && op.receipt ? { purged: true } : {}) }, { status: response.status, headers: response.headers });
571
+ }
572
+ }
573
+
574
+ /** GET /api/link/operations[/{id}] and POST /api/link/operations/{id}/resolve (structure/remote-link.md, "Operation journal"). */
575
+ export function handleLinkOperationRoutes(ctx: ManagementContext): Response | null {
576
+ const { url, req } = ctx;
577
+ const read = () => readOperationsJournal(journalPathFor(ctx));
578
+ const headers = { "cache-control": "no-store" };
579
+ if (url.pathname === "/api/link/operations" && req.method === "GET") {
580
+ try { return Response.json({ operations: read().operations }, { headers }); } catch {
581
+ return journalUnreadable();
582
+ }
583
+ }
584
+ const one = /^\/api\/link\/operations\/([^/]+)(\/resolve)?$/.exec(url.pathname);
585
+ if (!one) return null;
586
+ let id: string;
587
+ try { id = decodeURIComponent(one[1]!); } catch { return fail("invalid_operation_id", "The operation id is invalid.", 400); }
588
+ if (!isOperationId(id)) return fail("invalid_operation_id", "The operation id is invalid.", 400);
589
+ if (!one[2] && req.method === "GET") {
590
+ let op: LinkOperation | undefined;
591
+ try { op = findOperation(read(), id); } catch { return journalUnreadable(); }
592
+ return op ? Response.json(op, { headers }) : fail("operation_not_found", "No operation has this id.", 404);
593
+ }
594
+ if (one[2] && req.method === "POST") {
595
+ let resolved: ReturnType<typeof resolveLinkOperation>;
596
+ try { resolved = resolveLinkOperation(journalPathFor(ctx), id, nowOf(ctx), ownsRetirement); } catch {
597
+ return fail("operation_journal_failed", "The link operation journal could not be written.", 500);
598
+ }
599
+ if (resolved === null) return fail("operation_not_found", "No operation has this id.", 404);
600
+ if (resolved === "not_resolvable") return fail("operation_not_resolvable", "Only a residual or unknown operation can be resolved.", 409);
601
+ // An unknown revoke past its Child cleanup suspended its link's tunnel (revokeSuspendsLink); resolving lifts that,
602
+ // and an idle link is not retried on a tick, so the tunnels are reloaded. Best effort: the resolve is already stored.
603
+ if (resolved.kind === "revoke") {
604
+ void ctx.deps.linkSupervisor?.()?.reload().catch(() => console.warn("[link] operation resolved; tunnel reload failed"));
605
+ }
606
+ return Response.json(resolved, { headers });
607
+ }
608
+ return null;
609
+ }