@bitkyc08/opencodex 2.100.1 → 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 (624) 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-BV4ms9U9.js +1 -0
  6. package/gui/dist/assets/{brand-mark-nr3ziR-T.js → brand-mark-XOLJbomA.js} +1 -1
  7. package/gui/dist/assets/index-DCdXsMyZ.js +105 -0
  8. package/gui/dist/assets/index-DQtCRNAw.css +2 -0
  9. package/gui/dist/assets/{segment-thumb-features-DKCVUUTi.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-BedmOsE7.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-Dy5_wfTT.js +1 -0
  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 +6 -4
  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/native-exec.ts +3 -2
  38. package/src/adapters/cursor/protobuf-request.ts +8 -8
  39. package/src/adapters/cursor/tool-guidance.ts +3 -3
  40. package/src/adapters/cursor/tool-wording.ts +10 -1
  41. package/src/adapters/cursor.ts +7 -6
  42. package/src/adapters/devin/cloud-direct/tool-schema.ts +20 -2
  43. package/src/adapters/google-antigravity-wire.ts +15 -6
  44. package/src/adapters/google-truncation.ts +4 -2
  45. package/src/adapters/google-wire-compiler.ts +2 -2
  46. package/src/adapters/google.ts +17 -4
  47. package/src/adapters/kiro/payload.ts +7 -4
  48. package/src/adapters/kiro/reasoning.ts +44 -1
  49. package/src/adapters/kiro/structured-output.ts +10 -8
  50. package/src/adapters/kiro-tools.ts +61 -15
  51. package/src/adapters/openai-chat/destination-policy.ts +16 -0
  52. package/src/adapters/openai-chat/reasoning-replay.ts +4 -1
  53. package/src/adapters/openai-chat/tool-schema.ts +9 -0
  54. package/src/adapters/openai-responses/tool-schema.ts +18 -4
  55. package/src/adapters/run-turn-queue.ts +139 -5
  56. package/src/adapters/upstream-http-error.ts +4 -2
  57. package/src/adapters/zed.ts +3 -0
  58. package/src/advisor/consult.ts +15 -4
  59. package/src/advisor/context.ts +12 -3
  60. package/src/advisor/runtime.ts +35 -5
  61. package/src/advisor/settings.ts +8 -0
  62. package/src/advisor/synthetic-tool.ts +21 -8
  63. package/src/bridge/response-json.ts +11 -2
  64. package/src/bridge/sse.ts +51 -9
  65. package/src/claude/auth-detect.ts +21 -33
  66. package/src/claude/chat-tool-dispatch.ts +233 -0
  67. package/src/claude/desktop-3p.ts +11 -5
  68. package/src/claude/desktop-gateway-state.ts +2 -0
  69. package/src/claude/desktop-remote-store-artifact.ts +14 -3
  70. package/src/claude/desktop-remote-store.ts +24 -4
  71. package/src/claude/inbound-content-options.ts +31 -16
  72. package/src/claude/inbound-tool-loading.ts +42 -17
  73. package/src/claude/outbound.ts +13 -3
  74. package/src/cli/account-api.ts +23 -1
  75. package/src/cli/account-auth.ts +54 -21
  76. package/src/cli/account-extended.ts +60 -6
  77. package/src/cli/account-key-quota.ts +56 -7
  78. package/src/cli/account.ts +5 -3
  79. package/src/cli/advisor.ts +7 -4
  80. package/src/cli/alias.ts +38 -1
  81. package/src/cli/capabilities-access-remote.ts +137 -2
  82. package/src/cli/capabilities-accounts.ts +3 -3
  83. package/src/cli/capabilities-agents-routing.ts +17 -10
  84. package/src/cli/capabilities-base.ts +43 -18
  85. package/src/cli/capabilities-integrations.ts +2 -2
  86. package/src/cli/capabilities-provider-models.ts +18 -2
  87. package/src/cli/capabilities-route-to.ts +43 -0
  88. package/src/cli/capabilities.ts +2 -0
  89. package/src/cli/capability-contracts.ts +1 -1
  90. package/src/cli/claude-desktop.ts +30 -11
  91. package/src/cli/claude.ts +36 -17
  92. package/src/cli/codex-launcher.ts +3 -1
  93. package/src/cli/codex-shim-autorestore.ts +5 -42
  94. package/src/cli/config-command.ts +38 -2
  95. package/src/cli/config-root-startup.ts +34 -0
  96. package/src/cli/connect.ts +124 -19
  97. package/src/cli/desktop-runtime-guidance.ts +1 -1
  98. package/src/cli/disconnect-runtime.ts +168 -0
  99. package/src/cli/dispatch.ts +54 -12
  100. package/src/cli/export-command.ts +1 -1
  101. package/src/cli/gui-pair-client.ts +29 -5
  102. package/src/cli/gui.ts +10 -5
  103. package/src/cli/help-catalog.ts +11 -0
  104. package/src/cli/help.ts +5 -4
  105. package/src/cli/hub.ts +18 -1
  106. package/src/cli/index.ts +83 -92
  107. package/src/cli/inspect.ts +11 -2
  108. package/src/cli/integrations.ts +26 -1
  109. package/src/cli/link-capture.ts +64 -0
  110. package/src/cli/link-child-ops.ts +314 -0
  111. package/src/cli/link-cleanup.ts +8 -5
  112. package/src/cli/link-diagnostics.ts +67 -0
  113. package/src/cli/link-enrollment.ts +158 -12
  114. package/src/cli/link-operations.ts +52 -0
  115. package/src/cli/link-recover.ts +152 -0
  116. package/src/cli/link-routes.ts +87 -0
  117. package/src/cli/link-status-child.ts +137 -0
  118. package/src/cli/link-status-traffic.ts +34 -0
  119. package/src/cli/link.ts +327 -37
  120. package/src/cli/message-command.ts +1 -1
  121. package/src/cli/message-mcp-command.ts +23 -10
  122. package/src/cli/models-runtime.ts +3 -3
  123. package/src/cli/opencode.ts +3 -1
  124. package/src/cli/pi-sync.ts +35 -0
  125. package/src/cli/preflight-exemptions.ts +46 -0
  126. package/src/cli/registry.ts +29 -12
  127. package/src/cli/restart-failure.ts +5 -2
  128. package/src/cli/root.ts +5 -1
  129. package/src/cli/route-to.ts +172 -0
  130. package/src/cli/runtime-api.ts +5 -8
  131. package/src/cli/status.ts +3 -1
  132. package/src/cli/stop-approval.ts +66 -19
  133. package/src/cli/stop-report.ts +23 -0
  134. package/src/cli/stop-windows-checked.ts +304 -0
  135. package/src/cli/sync-command.ts +70 -13
  136. package/src/cli/sync-fanout.ts +81 -99
  137. package/src/cli/sync-flags.ts +40 -3
  138. package/src/cli/sync-link-status.ts +18 -2
  139. package/src/cli/sync-update-guard.ts +7 -2
  140. package/src/cli/system-restart-client.ts +3 -2
  141. package/src/cli/uninstall-plan.ts +77 -5
  142. package/src/cli/uninstall-stop.ts +152 -0
  143. package/src/cli/v2-input.ts +10 -6
  144. package/src/cli/v2-local-output.ts +3 -2
  145. package/src/cli/v2-runtime.ts +10 -3
  146. package/src/cli/v2.ts +22 -7
  147. package/src/client/connect.ts +321 -34
  148. package/src/client/link-home-features.ts +27 -0
  149. package/src/client/link-home.ts +92 -4
  150. package/src/client/link-ingress.ts +21 -3
  151. package/src/client/link-join.ts +12 -2
  152. package/src/client/link-parity-reporter.ts +60 -6
  153. package/src/client/link-readiness.ts +16 -6
  154. package/src/client/link-relay-transport.ts +161 -36
  155. package/src/client/link-relay.ts +150 -6
  156. package/src/client/link-request-compression.ts +84 -0
  157. package/src/client/link-state.ts +11 -5
  158. package/src/client/link-status.ts +39 -1
  159. package/src/client/link-teardown.ts +1 -0
  160. package/src/client/link-tunnel-status.ts +76 -0
  161. package/src/client/link-tunnel.ts +56 -5
  162. package/src/client/link-websocket-limits.ts +89 -0
  163. package/src/client/link-websocket.ts +586 -0
  164. package/src/client/link-ws-advertisement.ts +100 -0
  165. package/src/client/link-ws-framer.ts +241 -0
  166. package/src/client/link-ws-transport.ts +177 -0
  167. package/src/client/machine-api.ts +13 -2
  168. package/src/client/machine-listener.ts +48 -7
  169. package/src/client/route-intent-apply.ts +293 -0
  170. package/src/client/route-intent-file-originals.ts +97 -0
  171. package/src/client/route-intent-native-originals.ts +201 -0
  172. package/src/client/route-intent-watch.ts +141 -0
  173. package/src/client/runtime-restart.ts +127 -5
  174. package/src/client/runtime.ts +61 -15
  175. package/src/client/state.ts +30 -0
  176. package/src/client/sync-expectation.ts +36 -2
  177. package/src/client/sync-runtime.ts +7 -0
  178. package/src/clients/config-export/alias-selectors.ts +63 -40
  179. package/src/clients/config-export/contracts.ts +2 -0
  180. package/src/clients/config-export/nested-selectors.ts +42 -0
  181. package/src/clients/config-export.ts +36 -4
  182. package/src/codex/account-resume-health.ts +41 -0
  183. package/src/codex/account-store.ts +12 -3
  184. package/src/codex/account-usability.ts +13 -0
  185. package/src/codex/auth-api/account-list.ts +29 -3
  186. package/src/codex/auth-api/login-flow.ts +6 -0
  187. package/src/codex/auth-api/routes.ts +35 -2
  188. package/src/codex/auth-collision.ts +23 -22
  189. package/src/codex/auth-context.ts +21 -6
  190. package/src/codex/catalog/gather-capture.ts +10 -2
  191. package/src/codex/catalog/parsing.ts +7 -3
  192. package/src/codex/catalog/provider-models.ts +67 -23
  193. package/src/codex/catalog/retained-sync.ts +2 -1
  194. package/src/codex/catalog/routed-gather.ts +1 -1
  195. package/src/codex/catalog-auto-refresh.ts +11 -0
  196. package/src/codex/cli-update-job.ts +35 -13
  197. package/src/codex/convergence-types.ts +2 -0
  198. package/src/codex/convergence.ts +2 -2
  199. package/src/codex/desktop-compatibility/native-identity.ts +4 -8
  200. package/src/codex/features.ts +2 -2
  201. package/src/codex/history-provider.ts +31 -0
  202. package/src/codex/inject/multi-agent-v2.ts +9 -3
  203. package/src/codex/inject/paginated-openai-compat.ts +54 -1
  204. package/src/codex/inject/plan.ts +20 -2
  205. package/src/codex/inject.ts +2 -0
  206. package/src/codex/journal-config-restore.ts +217 -0
  207. package/src/codex/journal.ts +75 -6
  208. package/src/codex/main-account.ts +23 -30
  209. package/src/codex/native-main-auth-file.ts +104 -0
  210. package/src/codex/native-profile-manager.ts +4 -3
  211. package/src/codex/native-profile-store.ts +3 -61
  212. package/src/codex/orca-import.ts +10 -1
  213. package/src/codex/quota-history.ts +13 -0
  214. package/src/codex/quota-window-conflict.ts +103 -0
  215. package/src/codex/quota.ts +134 -7
  216. package/src/codex/subagent-model-fallback.ts +3 -1
  217. package/src/codex/websocket-activity.ts +171 -16
  218. package/src/codex/websocket-registry.ts +11 -4
  219. package/src/combos/cooldown-store.ts +228 -0
  220. package/src/combos/failover.ts +760 -35
  221. package/src/config/dashboard-trusted-proxy.ts +83 -0
  222. package/src/config/diagnostics.ts +28 -0
  223. package/src/config/feature-flags.ts +9 -0
  224. package/src/config/live-reconcile.ts +10 -1
  225. package/src/config/load-degrade.ts +12 -1
  226. package/src/config/multi-agent-surface.ts +28 -5
  227. package/src/config/pending-teardown.ts +60 -3
  228. package/src/config/process-state.ts +175 -4
  229. package/src/config/provider-validation.ts +4 -4
  230. package/src/config/salvage.ts +1 -0
  231. package/src/config/schema/config-schema.ts +12 -3
  232. package/src/config/schema/leaf-validators.ts +43 -14
  233. package/src/config/windows-process-command-line.ts +107 -0
  234. package/src/generated/compatibility-version.json +1077 -429
  235. package/src/generated/model-metadata.ts +1 -1
  236. package/src/images/loop.ts +3 -0
  237. package/src/integrations/model-name-guard.ts +25 -0
  238. package/src/integrations/route-intent-catalog.ts +26 -0
  239. package/src/integrations/route-intent-connected.ts +262 -0
  240. package/src/integrations/route-intent-contract.ts +55 -0
  241. package/src/integrations/route-intent-disconnect.ts +109 -0
  242. package/src/integrations/route-intent-initial.ts +64 -0
  243. package/src/integrations/route-intent-state.ts +117 -0
  244. package/src/integrations/route-intent-tick.ts +65 -0
  245. package/src/integrations/route-intent.ts +212 -0
  246. package/src/integrations/writer.ts +44 -11
  247. package/src/lib/catalog-etag.ts +10 -0
  248. package/src/lib/client-error-body.ts +15 -0
  249. package/src/lib/client-retry-after.ts +29 -0
  250. package/src/lib/config-ownership.ts +13 -0
  251. package/src/lib/context-overflow-verdict.ts +266 -9
  252. package/src/lib/desktop-gui-origin.ts +28 -0
  253. package/src/lib/errors.ts +1 -1
  254. package/src/lib/failure-detail.ts +72 -3
  255. package/src/lib/gui-pair-capability.ts +2 -1
  256. package/src/lib/hard-refusal.ts +259 -0
  257. package/src/lib/messages-error-body.ts +4 -1
  258. package/src/lib/outbound-credential-registry.ts +362 -4
  259. package/src/lib/paced-stream.ts +34 -0
  260. package/src/lib/passive-key-fetch-proof.ts +30 -0
  261. package/src/lib/passive-read.ts +5 -0
  262. package/src/lib/process-control.ts +76 -12
  263. package/src/lib/redact.ts +84 -8
  264. package/src/lib/state-store-registrations.ts +11 -0
  265. package/src/lib/state-store-sweeper.ts +4 -0
  266. package/src/lib/supervisor-markers.ts +18 -0
  267. package/src/lib/terminal-safe-text.ts +58 -0
  268. package/src/lib/translator-budget.ts +3 -2
  269. package/src/lib/upstream-retry.ts +14 -4
  270. package/src/link/alias-lock.ts +119 -0
  271. package/src/link/child-activity.ts +83 -0
  272. package/src/link/child-binary-cache-fill.d.mts +50 -0
  273. package/src/link/child-binary-cache-fill.mjs +494 -0
  274. package/src/link/child-binary-cache-start.ts +73 -0
  275. package/src/link/child-binary-source.ts +12 -5
  276. package/src/link/child-catalog-freshness.ts +149 -0
  277. package/src/link/child-gated-ocx.ts +135 -0
  278. package/src/link/child-observations.ts +206 -0
  279. package/src/link/child-observe.ts +121 -0
  280. package/src/link/child-ops-engine.ts +230 -0
  281. package/src/link/child-ops-host.ts +138 -0
  282. package/src/link/child-ops-runners.ts +319 -0
  283. package/src/link/child-ops-scheduler.ts +207 -0
  284. package/src/link/child-ops-types.ts +89 -0
  285. package/src/link/child-parity.ts +23 -4
  286. package/src/link/child-policy.ts +93 -0
  287. package/src/link/child-update-contract.ts +174 -0
  288. package/src/link/codex-settings.ts +1 -1
  289. package/src/link/compatibility.ts +18 -1
  290. package/src/link/diagnostics-read.ts +163 -0
  291. package/src/link/diagnostics.ts +20 -7
  292. package/src/link/explicit-route.ts +209 -0
  293. package/src/link/link-recover.ts +113 -0
  294. package/src/link/management-routes.ts +3 -1
  295. package/src/link/operation-recovery-slot.ts +44 -0
  296. package/src/link/operations-journal.ts +408 -0
  297. package/src/link/paths.ts +5 -0
  298. package/src/link/peer-report.ts +1 -1
  299. package/src/link/relay-auth.ts +14 -0
  300. package/src/link/remote-plant.ts +152 -14
  301. package/src/link/remote-platform.ts +21 -10
  302. package/src/link/remote-probe.ts +11 -3
  303. package/src/link/remote-windows.ts +88 -12
  304. package/src/link/request-compression.ts +30 -0
  305. package/src/link/residual-recovery.ts +54 -0
  306. package/src/link/retirement.ts +128 -0
  307. package/src/link/route-intent-watch.ts +41 -0
  308. package/src/link/route-intent.ts +209 -0
  309. package/src/link/route-proof.ts +82 -0
  310. package/src/link/route-rounds.ts +579 -0
  311. package/src/link/route-select.ts +95 -0
  312. package/src/link/route-trust.ts +96 -0
  313. package/src/link/ssh-argv.ts +285 -43
  314. package/src/link/ssh-capture-redact.ts +253 -0
  315. package/src/link/ssh-capture.ts +497 -0
  316. package/src/link/ssh-runner.ts +141 -14
  317. package/src/link/status-projection.ts +160 -0
  318. package/src/link/store.ts +54 -1
  319. package/src/link/supervisor.ts +543 -55
  320. package/src/link/sync-fanout-classify.ts +114 -0
  321. package/src/link/sync-then-restart.ts +65 -0
  322. package/src/link/tombstones.ts +209 -0
  323. package/src/link/traffic.ts +178 -0
  324. package/src/link/tunnel-state.ts +10 -4
  325. package/src/link/ws-activity-holds.ts +474 -0
  326. package/src/local-credentials/publication-fence.ts +20 -1
  327. package/src/messaging/mcp-queue-rpc.ts +3 -2
  328. package/src/messaging/mcp-queue-server.ts +21 -1
  329. package/src/messaging/mcp-reply-tools.ts +24 -9
  330. package/src/messaging/mcp-reply-wait.ts +70 -0
  331. package/src/messaging/mcp-resume-tools.ts +25 -0
  332. package/src/messaging/remote-enrollment.ts +3 -3
  333. package/src/messaging/remote-tunnels.ts +2 -2
  334. package/src/messaging/resume-permissions.ts +27 -0
  335. package/src/messaging/rpc.ts +46 -2
  336. package/src/oauth/account-resume-health.ts +60 -0
  337. package/src/oauth/anthropic-continuity.ts +23 -7
  338. package/src/oauth/anthropic-routing.ts +5 -2
  339. package/src/oauth/anthropic.ts +22 -2
  340. package/src/oauth/claude-keychain-read.ts +78 -68
  341. package/src/oauth/index.ts +25 -6
  342. package/src/oauth/local-token-detect.ts +8 -29
  343. package/src/oauth/login-cli-errors.ts +5 -1
  344. package/src/oauth/login-cli.ts +33 -18
  345. package/src/oauth/login-flow-state.ts +26 -3
  346. package/src/oauth/meta-muse.ts +1 -1
  347. package/src/oauth/store.ts +51 -1
  348. package/src/oauth/xai.ts +248 -14
  349. package/src/protocols/contract.ts +4 -0
  350. package/src/protocols/encoders/messages.ts +1 -0
  351. package/src/providers/alias-template.ts +48 -0
  352. package/src/providers/anthropic-billing-ownership.ts +2 -0
  353. package/src/providers/anthropic-output-caps.ts +46 -0
  354. package/src/providers/anthropic-reset-grant-ledger.ts +9 -3
  355. package/src/providers/antigravity-effort-families.ts +11 -3
  356. package/src/providers/antigravity-models.ts +32 -9
  357. package/src/providers/antigravity-wire-snapshot.ts +3 -2
  358. package/src/providers/api-key-pause-state.ts +23 -0
  359. package/src/providers/api-key-pause.ts +71 -10
  360. package/src/providers/api-key-resolve.ts +49 -7
  361. package/src/providers/api-key-response-ownership.ts +2 -0
  362. package/src/providers/api-key-selection-capture.ts +3 -1
  363. package/src/providers/api-key-selection.ts +54 -11
  364. package/src/providers/api-keys.ts +24 -7
  365. package/src/providers/cache-affinity-identity.ts +73 -0
  366. package/src/providers/cache-affinity.ts +256 -0
  367. package/src/providers/claude-cli-usage-state.ts +11 -6
  368. package/src/providers/claude-cli-usage.ts +27 -9
  369. package/src/providers/codex-capacity.ts +11 -2
  370. package/src/providers/default-aliases.ts +98 -20
  371. package/src/providers/google-vertex-model-discovery.ts +510 -0
  372. package/src/providers/key-failover.ts +136 -14
  373. package/src/providers/key-store.ts +3 -3
  374. package/src/providers/kiro-models.ts +3 -5
  375. package/src/providers/label.ts +31 -5
  376. package/src/providers/mistral-transport.ts +17 -4
  377. package/src/providers/model-discovery-config.ts +31 -0
  378. package/src/providers/model-discovery-diagnostic.ts +34 -3
  379. package/src/providers/model-discovery.ts +43 -7
  380. package/src/providers/model-rename-fields.ts +5 -0
  381. package/src/providers/muse-key-quota.ts +14 -6
  382. package/src/providers/new-model-policy-runtime.ts +17 -4
  383. package/src/providers/new-model-policy.ts +30 -4
  384. package/src/providers/openai-sidecar.ts +15 -2
  385. package/src/providers/passive-key-observation.ts +252 -0
  386. package/src/providers/provider-id-rewrite.ts +3 -0
  387. package/src/providers/quota/account-cache.ts +53 -34
  388. package/src/providers/quota/anthropic-cooldown-recovery-worker.ts +121 -0
  389. package/src/providers/quota/anthropic-usage-windows.ts +19 -9
  390. package/src/providers/quota/passive-key-limits.ts +272 -0
  391. package/src/providers/quota/passive-wire-model.ts +126 -0
  392. package/src/providers/quota/report-cache.ts +112 -5
  393. package/src/providers/quota/vendor-probes-key.ts +73 -0
  394. package/src/providers/quota/vendor-probes-oauth.ts +57 -3
  395. package/src/providers/quota-key-accounts.ts +22 -10
  396. package/src/providers/quota-mistral-budget.ts +18 -0
  397. package/src/providers/quota-types.ts +43 -0
  398. package/src/providers/quota.ts +31 -32
  399. package/src/providers/reasoning-metadata.ts +1051 -12
  400. package/src/providers/registry/entries-core.ts +34 -16
  401. package/src/providers/registry/entries-extended.ts +32 -0
  402. package/src/providers/registry/model-seeds.ts +35 -0
  403. package/src/providers/resolved-model-policy.ts +7 -0
  404. package/src/providers/routed-config.ts +8 -3
  405. package/src/providers/xai-transport.ts +3 -0
  406. package/src/quota/reset-observer.ts +4 -2
  407. package/src/quota/reset-seen-store.ts +9 -0
  408. package/src/quota/window-mapping.ts +1 -0
  409. package/src/quota-pool/assemble.ts +4 -1
  410. package/src/remote/features.ts +17 -0
  411. package/src/responses/anthropic-progress.ts +10 -4
  412. package/src/responses/citation-markers.ts +231 -0
  413. package/src/responses/hosted-tool-policy.ts +56 -12
  414. package/src/responses/spill-store.ts +5 -1
  415. package/src/responses/state/replay-input.ts +50 -0
  416. package/src/responses/state/replay-owner.ts +24 -0
  417. package/src/responses/state/snapshot-codec.ts +9 -0
  418. package/src/responses/state/spill-queue.ts +1 -0
  419. package/src/responses/state.ts +42 -60
  420. package/src/router.ts +4 -2
  421. package/src/routing/home-route-capture.ts +123 -0
  422. package/src/routing/home-route-intent.ts +200 -0
  423. package/src/routing/route-intent-state.ts +178 -0
  424. package/src/routing/route-to-live-settings.ts +35 -0
  425. package/src/routing/route-to-local.ts +145 -0
  426. package/src/routing/route-to-status.ts +94 -0
  427. package/src/routing/route-to-sync-child.ts +32 -0
  428. package/src/server/adapter-resolve.ts +21 -1
  429. package/src/server/admitted-http-turn.ts +3 -0
  430. package/src/server/auth-cors.ts +109 -8
  431. package/src/server/bare-upstream-error.ts +220 -0
  432. package/src/server/catalog-download.ts +3 -5
  433. package/src/server/chat-native.ts +25 -7
  434. package/src/server/claude-messages.ts +8 -5
  435. package/src/server/codex-model-list.ts +2 -1
  436. package/src/server/configured-credentials.ts +37 -5
  437. package/src/server/gui-desktop-authorization.ts +36 -0
  438. package/src/server/gui-pair-delivery.ts +6 -3
  439. package/src/server/gui-session.ts +10 -1
  440. package/src/server/images.ts +41 -13
  441. package/src/server/inbound-body-admission.ts +17 -4
  442. package/src/server/index/link-listener.ts +203 -11
  443. package/src/server/index/link-management.ts +15 -1
  444. package/src/server/index/link-relay-sessions.ts +128 -8
  445. package/src/server/index/link-websocket-limits.ts +136 -0
  446. package/src/server/index/link-websocket.ts +692 -0
  447. package/src/server/index/optional-listeners.ts +115 -7
  448. package/src/server/index/route-intent-watch.ts +47 -0
  449. package/src/server/index/serve-contract.ts +86 -0
  450. package/src/server/index/serve-options.ts +35 -86
  451. package/src/server/index/startup-warnings.ts +8 -2
  452. package/src/server/index/websocket-handler.ts +26 -4
  453. package/src/server/index.ts +12 -2
  454. package/src/server/inference/client-encoder-delivery.ts +2 -0
  455. package/src/server/inspection-tee.ts +39 -2
  456. package/src/server/lifecycle.ts +2 -0
  457. package/src/server/link-turn.ts +137 -0
  458. package/src/server/management/advisor-routes.ts +10 -2
  459. package/src/server/management/agent-settings-routes.ts +50 -16
  460. package/src/server/management/anthropic-reset-grant-routes.ts +1 -1
  461. package/src/server/management/config-routes.ts +7 -1
  462. package/src/server/management/context.ts +9 -2
  463. package/src/server/management/desktop-authorization.ts +41 -0
  464. package/src/server/management/desktop-compatibility-routes.ts +9 -8
  465. package/src/server/management/desktop-compatibility-runtime-routes.ts +3 -2
  466. package/src/server/management/desktop-compatibility-settings-routes.ts +5 -3
  467. package/src/server/management/home-integration-decision.ts +89 -0
  468. package/src/server/management/integration-routes.ts +208 -81
  469. package/src/server/management/link-child-ops-routes.ts +218 -0
  470. package/src/server/management/link-child-preflight.ts +31 -0
  471. package/src/server/management/link-diagnostics-route.ts +29 -0
  472. package/src/server/management/link-enrollment.ts +199 -47
  473. package/src/server/management/link-operation.ts +609 -0
  474. package/src/server/management/link-recover-route.ts +103 -0
  475. package/src/server/management/link-route-edit.ts +173 -0
  476. package/src/server/management/link-route-request.ts +62 -0
  477. package/src/server/management/link-route-state.ts +92 -6
  478. package/src/server/management/link-routes.ts +563 -51
  479. package/src/server/management/link-traffic-status.ts +13 -0
  480. package/src/server/management/model-routes.ts +122 -36
  481. package/src/server/management/model-rows.ts +2 -1
  482. package/src/server/management/native-integration-routes.ts +176 -70
  483. package/src/server/management/oauth-account-routes.ts +69 -17
  484. package/src/server/management/protocol-routes.ts +7 -0
  485. package/src/server/management/provider-completion-test.ts +4 -4
  486. package/src/server/management/provider-overwrite-carry.ts +39 -3
  487. package/src/server/management/provider-routes.ts +80 -72
  488. package/src/server/management/provider-routing-quota.ts +45 -0
  489. package/src/server/management/route-registry.ts +25 -3
  490. package/src/server/management/route-to-routes.ts +257 -0
  491. package/src/server/management/system-restart.ts +4 -2
  492. package/src/server/management/usage-aggregate-cache.ts +101 -66
  493. package/src/server/management-api.ts +17 -3
  494. package/src/server/management-auth.ts +13 -1
  495. package/src/server/messages-native-preflight.ts +27 -4
  496. package/src/server/messages-native.ts +22 -5
  497. package/src/server/persistent-gui-session.ts +6 -3
  498. package/src/server/proxy-liveness.ts +33 -6
  499. package/src/server/relay-eager.ts +36 -12
  500. package/src/server/relay.ts +183 -116
  501. package/src/server/request-body-facts.ts +48 -0
  502. package/src/server/request-decompress.ts +65 -2
  503. package/src/server/request-log-account-rotation.ts +6 -0
  504. package/src/server/request-log-attempt-usage.ts +69 -0
  505. package/src/server/request-log-cache-affinity.ts +60 -0
  506. package/src/server/request-log-conversation.ts +45 -2
  507. package/src/server/request-log-failure-detail.ts +59 -1
  508. package/src/server/request-log-terminal-status.ts +210 -24
  509. package/src/server/request-log.ts +71 -79
  510. package/src/server/responses/adapter-continuation.ts +2 -1
  511. package/src/server/responses/adapter-delivery.ts +2 -0
  512. package/src/server/responses/adapter-dispatch.ts +40 -51
  513. package/src/server/responses/advisor-plan-slot.ts +33 -1
  514. package/src/server/responses/advisor-question.ts +21 -0
  515. package/src/server/responses/advisor-slot.ts +10 -3
  516. package/src/server/responses/bare-namespace-aliases.ts +18 -0
  517. package/src/server/responses/buffered-sse-json.ts +9 -3
  518. package/src/server/responses/code-mode-collab-surface.ts +11 -0
  519. package/src/server/responses/codex-tool-catalog.ts +156 -0
  520. package/src/server/responses/combo-required-tool-fulfillments.ts +4 -2
  521. package/src/server/responses/combo-stream-preflight.ts +701 -81
  522. package/src/server/responses/compact.ts +47 -12
  523. package/src/server/responses/context-overflow.ts +58 -2
  524. package/src/server/responses/core-codex-account.ts +17 -3
  525. package/src/server/responses/core-combo-failure.ts +37 -4
  526. package/src/server/responses/core-combo-native.ts +3 -1
  527. package/src/server/responses/core-combo.ts +62 -7
  528. package/src/server/responses/core-errors.ts +8 -3
  529. package/src/server/responses/core-lifetime.ts +3 -2
  530. package/src/server/responses/core-normalize.ts +3 -1
  531. package/src/server/responses/core-opaque-recovery.ts +45 -2
  532. package/src/server/responses/core-options.ts +18 -0
  533. package/src/server/responses/core.ts +2 -0
  534. package/src/server/responses/fetch-helpers.ts +15 -10
  535. package/src/server/responses/native-replay-guard.ts +57 -0
  536. package/src/server/responses/opengateway-completion-guard.ts +10 -4
  537. package/src/server/responses/outbound-request-body.ts +29 -0
  538. package/src/server/responses/passthrough-completion.ts +105 -8
  539. package/src/server/responses/passthrough-delivery.ts +31 -11
  540. package/src/server/responses/passthrough-dispatch.ts +99 -106
  541. package/src/server/responses/policy-fallback.ts +13 -1
  542. package/src/server/responses/request-prepare.ts +50 -6
  543. package/src/server/responses/request-transport.ts +53 -17
  544. package/src/server/responses/reset-replay.ts +104 -4
  545. package/src/server/responses/run-turn-execution.ts +58 -30
  546. package/src/server/responses/sidecar-execution.ts +14 -0
  547. package/src/server/responses/terminal-error-redaction.ts +222 -25
  548. package/src/server/responses/ws-upstream.ts +2 -2
  549. package/src/server/sse-payload-rewrite.ts +3 -2
  550. package/src/server/stop-service-route.ts +85 -0
  551. package/src/server/system-env-shell.ts +12 -1
  552. package/src/server/system-env.ts +5 -3
  553. package/src/server/windows-tcp-drop.ts +21 -4
  554. package/src/server/workflow-refusal.ts +8 -0
  555. package/src/server/ws-bridge.ts +191 -12
  556. package/src/service/cli-windows-stop.ts +189 -0
  557. package/src/service/cli.ts +41 -12
  558. package/src/service/disconnected-client-restart.ts +60 -0
  559. package/src/service/guarded-manager-target.ts +18 -1
  560. package/src/service/health.ts +99 -6
  561. package/src/service/launchd.ts +84 -31
  562. package/src/service/orchestration.ts +418 -91
  563. package/src/service/repair.ts +223 -6
  564. package/src/service/restart-proxy-stop.ts +79 -0
  565. package/src/service/service-child-ownership.ts +6 -2
  566. package/src/service/windows-checked-stop-live.ts +467 -0
  567. package/src/service/windows-checked-stop.ts +435 -0
  568. package/src/service/windows-command-line-token.ts +23 -0
  569. package/src/service/windows-guarded-manager.ts +77 -34
  570. package/src/service/windows-ops.ts +38 -56
  571. package/src/service/windows-process-evidence.ts +292 -0
  572. package/src/service/windows-process-native.ts +262 -0
  573. package/src/service/windows-service-stop.ts +321 -0
  574. package/src/service/windows-stop-binding.ts +187 -0
  575. package/src/service/windows-stop-budget.ts +123 -0
  576. package/src/service/windows-stop-confirm.ts +158 -0
  577. package/src/service/windows-stop-deadline.ts +56 -0
  578. package/src/service.ts +2 -2
  579. package/src/types/claude-tool-loading.ts +48 -0
  580. package/src/types/config.ts +47 -53
  581. package/src/types/link.ts +20 -0
  582. package/src/types/multi-agent.ts +13 -0
  583. package/src/types/provider.ts +68 -2
  584. package/src/types/request.ts +4 -0
  585. package/src/types.ts +4 -0
  586. package/src/update/guarded-runtime-ops.ts +5 -7
  587. package/src/update/index.ts +25 -10
  588. package/src/update/install-detection.mjs +3 -1
  589. package/src/update/job-pinned-start.ts +2 -0
  590. package/src/update/job-windows-restart.ts +19 -32
  591. package/src/update/job.ts +12 -5
  592. package/src/update/npm-install.d.mts +11 -0
  593. package/src/update/npm-install.mjs +44 -7
  594. package/src/update/orchestrated-entry.ts +1 -1
  595. package/src/update/orchestrated-node-driver.mjs +3 -2
  596. package/src/update/orchestrated-pnpm.d.mts +4 -0
  597. package/src/update/orchestrated-pnpm.mjs +50 -6
  598. package/src/update/orchestrated-session.d.mts +3 -1
  599. package/src/update/orchestrated-session.mjs +21 -6
  600. package/src/update/pnpm-global-install.d.mts +21 -3
  601. package/src/update/pnpm-global-install.mjs +322 -19
  602. package/src/update/pnpm-store-layout.mjs +46 -0
  603. package/src/update/sync-update-mutex.d.mts +3 -2
  604. package/src/update/sync-update-mutex.mjs +57 -8
  605. package/src/update/transactional-install.d.mts +3 -1
  606. package/src/update/transactional-install.mjs +545 -12
  607. package/src/update/windows-installer-marker.d.mts +1 -0
  608. package/src/update/windows-installer-marker.mjs +44 -0
  609. package/src/usage/expected-prices.ts +8 -0
  610. package/src/usage/filter-index.ts +326 -77
  611. package/src/usage/ledger-scanner.ts +15 -0
  612. package/src/usage/link-log-fields.ts +48 -0
  613. package/src/usage/log.ts +43 -2
  614. package/src/usage/request-body.ts +37 -0
  615. package/src/web-search/loop.ts +3 -0
  616. package/src/web-search/parse.ts +21 -2
  617. package/gui/dist/assets/App-g3Cm2xhZ.js +0 -59
  618. package/gui/dist/assets/Tray-BMDkAiXy.js +0 -1
  619. package/gui/dist/assets/index-Bziu8gTy.css +0 -2
  620. package/gui/dist/assets/index-OYzhQUNP.js +0 -94
  621. package/gui/dist/classic/assets/App-CgPBKUP-.js +0 -58
  622. package/gui/dist/classic/assets/index-BR-HhNrp.js +0 -94
  623. package/gui/dist/classic/assets/quota-summary-CXKhvSmQ.js +0 -1
  624. package/src/server/management/desktop-compatibility-authorization.ts +0 -12
@@ -9,6 +9,7 @@
9
9
  * Design of record: devlog/_fin/260802_client_toggle_api/040_wp4_management_api.md.
10
10
  */
11
11
  import { readFileSync } from "node:fs";
12
+ import { LinkApplyBusyError, withLinkApply } from "../../client/link-home";
12
13
  import { saveConfigPreservingClaudeCode } from "../../config";
13
14
  import { listAsideProfileStates, type AsideProfilesInput } from "../../integrations/aside-profiles";
14
15
  import {
@@ -48,6 +49,8 @@ import {
48
49
  setIntegrationMutationFlightTestHook,
49
50
  } from "../../integrations/mutation-flight";
50
51
  import { jsonResponse } from "../auth-cors";
52
+ import { isRouteClientId, type RouteClientIntent } from "../../link/route-intent";
53
+ import { prepareHomeIntegrationDecision, recordHomeIntegrationDecision } from "./home-integration-decision";
51
54
  import { readManagementJsonBody, rethrowManagementBodyTooLarge } from "./body";
52
55
  import { managementInferencePort, type ManagementContext } from "./context";
53
56
  import { exportSnapshotIdentity, loadExportModels, previewExportSnapshot } from "./model-rows";
@@ -150,6 +153,8 @@ let integrationMutationTestHooks: {
150
153
  */
151
154
  store?: IntegrationStateStore;
152
155
  run?: (operation: () => Promise<unknown>) => Promise<unknown>;
156
+ afterWriterStart?: () => void;
157
+ afterBoundSnapshot?: () => Promise<void>;
153
158
  } | null = null;
154
159
 
155
160
  /**
@@ -240,6 +245,8 @@ export function setIntegrationMutationFlightTestHooks(
240
245
  /** Binds the WHOLE request — reads, writes and journal — to one store. */
241
246
  store?: IntegrationStateStore;
242
247
  run?: (operation: () => Promise<unknown>) => Promise<unknown>;
248
+ afterWriterStart?: () => void;
249
+ afterBoundSnapshot?: () => Promise<void>;
243
250
  } | null,
244
251
  ): void {
245
252
  integrationMutationTestHooks = hooks;
@@ -281,6 +288,33 @@ function asideOptions(ctx: ManagementContext): AsideProfileRouteOptions {
281
288
  };
282
289
  }
283
290
 
291
+ /**
292
+ * Which Aside requests are a Home decision, and the profiles each may enable: a toggle of one
293
+ * profile or all of them, or a profile restore. Undefined for reads, previews, journal and sync.
294
+ */
295
+ async function asideDecisionScope(ctx: ManagementContext, known: unknown): Promise<readonly number[] | "all" | undefined> {
296
+ // The paths handleAsideProfileRoutes owns: the whole set, the profile collection, one profile,
297
+ // and one profile's restore.
298
+ const match = /^\/api\/client-integrations\/aside(?:\/profiles(?:\/(0|[1-9][0-9]*)(\/restore)?)?)?$/.exec(ctx.url.pathname);
299
+ if (!match) return undefined;
300
+ const restore = match[2] !== undefined && ctx.req.method === "POST";
301
+ const toggle = match[2] === undefined && ctx.req.method === "PUT";
302
+ if (!toggle && !restore) return undefined;
303
+ const raw = match[1] ?? ctx.url.searchParams.get("profile");
304
+ const id = raw !== null && /^(0|[1-9][0-9]*)$/.test(raw) && Number.isSafeInteger(Number(raw)) ? Number(raw) : undefined;
305
+ if (restore) return id === undefined ? [] : [id];
306
+ const body = known !== undefined ? known : await readJsonBody({ ...ctx, req: ctx.req.clone() });
307
+ if (!isPlainRecord(body) || body.enabled !== true) return [];
308
+ return id === undefined ? "all" : [id];
309
+ }
310
+
311
+ /** A file client's Home decision as its ownership record stands after a restore. */
312
+ function ownedIntent(store: IntegrationStateStore, clientId: IntegrationClientId): RouteClientIntent {
313
+ const owner = store.readRecords()[clientId];
314
+ return { enabled: Boolean(owner),
315
+ ...(owner?.modelNames && (clientId === "hermes" || clientId === "commandcode") ? { modelNames: owner.modelNames } : {}) };
316
+ }
317
+
284
318
  async function buildIntegrationWriteInput(
285
319
  clientId: IntegrationClientId,
286
320
  ctx: ManagementContext,
@@ -309,13 +343,13 @@ async function buildIntegrationWriteInput(
309
343
  * that persists configuration. Everything else is shared, so a preview and the commit that follows
310
344
  * it cannot disagree for any reason except the state genuinely moving.
311
345
  */
312
- async function buildIntegrationPreviewInput(
346
+ function buildIntegrationPreviewInput(
313
347
  clientId: IntegrationClientId,
314
348
  ctx: ManagementContext,
315
349
  store: IntegrationStateStore,
316
350
  droidReasoningDefaults?: Record<string, string>,
317
351
  modelNames?: ExportModelNames,
318
- ): Promise<{ input: IntegrationWriteInput; identity: string } | null> {
352
+ ): { input: IntegrationWriteInput; identity: string } | null {
319
353
  const snapshot = previewExportSnapshot(ctx.config);
320
354
  // No cached roster means no honest snapshot to plan against. Gathering one here would make a
321
355
  // read refresh credentials and write the provider cache, which is the thing preview must not do.
@@ -530,6 +564,34 @@ async function readJsonBody(ctx: ManagementContext): Promise<unknown | Response>
530
564
  }
531
565
  }
532
566
 
567
+ /**
568
+ * `ocx sync` refreshes an already-connected Pi file through this route instead of rebuilding it
569
+ * in the CLI process. Pi may carry raw nested selectors, and a raw selector is only safe when the
570
+ * proxy that will serve it proves it routes to the same model (#8172). Proving it against the
571
+ * CLI's own saved configuration and router cache could write a selector this proxy routes
572
+ * elsewhere, so the refresh runs here, against this process's config, router and roster.
573
+ */
574
+ export const PI_SYNC_PATH = "/api/client-integrations/pi/sync";
575
+
576
+ async function piSyncResponse(ctx: ManagementContext): Promise<Response> {
577
+ const body = await readJsonBody(ctx);
578
+ if (body instanceof Response) return body;
579
+ if (!isPlainRecord(body) || Object.keys(body).length !== 0) {
580
+ return jsonResponse({ error: "Pi sync expects an empty object", code: "invalid_pi_sync_body" }, 400, ctx.req, ctx.config);
581
+ }
582
+ const { refreshOwnedCatalogIntegrations } = await import("../../integrations/catalog-refresh");
583
+ const results = await refreshOwnedCatalogIntegrations({
584
+ config: ctx.config,
585
+ port: managementInferencePort(ctx),
586
+ models: () => loadExportModels(ctx.config),
587
+ store: integrationStore(),
588
+ ...pathOverrides(),
589
+ ...(integrationMutationTestHooks?.io ? { io: integrationMutationTestHooks.io } : {}),
590
+ }, ["pi"]);
591
+ const ok = results.every(result => result.ok);
592
+ return jsonResponse({ ok, clientId: "pi", results }, ok ? 200 : 207, ctx.req, ctx.config);
593
+ }
594
+
533
595
  function writerFailureResponse(
534
596
  clientId: IntegrationClientId,
535
597
  /*
@@ -686,10 +748,12 @@ async function handleJournalDelete(ctx: ManagementContext): Promise<Response> {
686
748
  export async function handleIntegrationRoutes(ctx: ManagementContext): Promise<Response | null> {
687
749
  // Aside delegates before the ordinary client handler. Reject unsupported intent before that
688
750
  // delegation can enumerate profiles, load catalogs, or write a different preference.
751
+ let asideBody: unknown;
689
752
  if (/^\/api\/client-integrations\/aside\/profiles(?:\/|$)/.test(ctx.url.pathname)
690
753
  && (ctx.req.method === "PUT" || ctx.req.method === "POST")) {
691
754
  const body = await readJsonBody({ ...ctx, req: ctx.req.clone() });
692
755
  if (body instanceof Response) return body;
756
+ asideBody = body;
693
757
  if (isPlainRecord(body)) {
694
758
  const naming = readModelNames(ctx, body, "aside", "apply");
695
759
  if (naming instanceof Response) return naming;
@@ -708,8 +772,22 @@ export async function handleIntegrationRoutes(ctx: ManagementContext): Promise<R
708
772
  if (hermesScoped) ctx = hermesScoped;
709
773
  const { req, url } = ctx;
710
774
  const profileOptions = asideOptions(ctx);
711
- const aside = await handleAsideProfileRoutes(ctx, profileOptions);
775
+ // An Aside profile change is the Home's decision (home-integration-decision.ts).
776
+ const asideDecision = ctx.config.runtimeRole === "client" ? undefined : await asideDecisionScope(ctx, asideBody);
777
+ let aside: Response | null;
778
+ try {
779
+ aside = asideDecision === undefined ? await handleAsideProfileRoutes(ctx, profileOptions) : await withLinkApply(async () => {
780
+ const refused = prepareHomeIntegrationDecision(ctx, "aside", asideDecision);
781
+ if (refused) return refused;
782
+ const response = await handleAsideProfileRoutes(ctx, profileOptions);
783
+ return response && response.status >= 200 && response.status < 300 ? recordHomeIntegrationDecision(ctx, "aside", response) : response;
784
+ });
785
+ } catch (error) {
786
+ if (error instanceof LinkApplyBusyError) return jsonResponse({ error: "integration mutation busy", code: "integration_mutation_busy", clientId: "aside" }, 409, req, ctx.config);
787
+ throw error;
788
+ }
712
789
  if (aside) return aside;
790
+ if (url.pathname === PI_SYNC_PATH && req.method === "POST") return piSyncResponse(ctx);
713
791
  if (url.searchParams.has("profile")
714
792
  && (url.pathname === INTEGRATION_COLLECTION_PATH || url.pathname.startsWith(INTEGRATION_ROUTE_PREFIX))
715
793
  && !INTEGRATION_HISTORY_PATHS.includes(url.pathname)) {
@@ -966,12 +1044,27 @@ export async function handleIntegrationRoutes(ctx: ManagementContext): Promise<R
966
1044
  // The binding travels with the request. Dropping it here routed a bound Aside restore into
967
1045
  // the unbound path, which executed the mutation while its confirmation went unexamined.
968
1046
  // A Hermes-scoped restore never delegates: its operation lives in the selected Hermes store.
969
- const asideRestore = hermesRequestScope(req) ? null : await asideRestoreResponse(ctx, {
1047
+ // A restore on the Home is its decision (home-integration-decision.ts); a Hermes profile's is not.
1048
+ const restoreDecides = ctx.config.runtimeRole !== "client" && !hermesRequestScope(req)?.resolvedPaths;
1049
+ const restoreAside = () => asideRestoreResponse(ctx, {
970
1050
  opId,
971
1051
  confirmDrift,
972
1052
  ...(parsed.operation === undefined ? {} : { operation: parsed.operation }),
973
1053
  ...(parsed.planFingerprint === undefined ? {} : { planFingerprint: parsed.planFingerprint }),
974
1054
  }, profileOptions);
1055
+ let asideRestore: Response | null;
1056
+ try {
1057
+ const rootEntry = integrationStore(ctx).findOperation(opId);
1058
+ asideRestore = hermesRequestScope(req) ? null : rootEntry && rootEntry.clientId !== "aside" ? await restoreAside() : restoreDecides ? await withLinkApply(async () => {
1059
+ const refused = prepareHomeIntegrationDecision(ctx, undefined);
1060
+ if (refused) return refused;
1061
+ const response = await restoreAside();
1062
+ return response && response.status >= 200 && response.status < 300 ? recordHomeIntegrationDecision(ctx, "aside", response) : response;
1063
+ }) : await restoreAside();
1064
+ } catch (error) {
1065
+ if (error instanceof LinkApplyBusyError) return jsonResponse({ error: "integration mutation busy", code: "integration_mutation_busy" }, 409, req, ctx.config);
1066
+ return internalErrorResponse(error, ctx);
1067
+ }
975
1068
  if (asideRestore) return asideRestore;
976
1069
  let restoreClientId: IntegrationClientId | undefined;
977
1070
  try {
@@ -994,53 +1087,63 @@ export async function handleIntegrationRoutes(ctx: ManagementContext): Promise<R
994
1087
  }, 410, req, ctx.config);
995
1088
  }
996
1089
 
1090
+ // Every caller must hold a current passive roster before it can join a flight.
997
1091
  const boundRestore = restoreBinding === "none"
998
1092
  ? null
999
1093
  : await buildIntegrationPreviewInput(operation.clientId, ctx, store);
1000
1094
  if (restoreBinding !== "none" && boundRestore === null) return previewUnavailableResponse(ctx);
1001
- const writeInput = boundRestore
1002
- ? boundRestore.input
1003
- : await buildIntegrationWriteInput(operation.clientId, ctx, store);
1004
- const restoreGuard = restoreBinding === "none" ? null : stalePlanGuard(
1005
- operation.clientId,
1006
- ctx,
1007
- store,
1008
- { operation: "restore", opId, confirmDrift },
1009
- restoreBinding.fingerprint,
1010
- boundRestore === null ? null : boundRestore.identity,
1011
- );
1012
- const restoreInput: IntegrationRestoreInput = {
1013
- ...writeInput,
1014
- opId,
1015
- confirmDrift,
1016
- };
1017
- const result = await runIntegrationMutationFlight(
1095
+ if (boundRestore && integrationMutationTestHooks?.afterBoundSnapshot) await integrationMutationTestHooks.afterBoundSnapshot();
1096
+ if (boundRestore && exportSnapshotIdentity(ctx.config) !== boundRestore.identity) {
1097
+ const current = buildIntegrationPreviewInput(operation.clientId, ctx, store);
1098
+ return current === null ? previewUnavailableResponse(ctx) : jsonResponse({
1099
+ error: "integration preview is stale", code: "integration_preview_stale",
1100
+ plan: previewIntegration(current.input, { operation: "restore", opId, confirmDrift }),
1101
+ }, 409, req, ctx.config);
1102
+ }
1103
+
1104
+ const response = await runIntegrationMutationFlight(
1018
1105
  operation.clientId,
1019
- scopedFlightKey(ctx, `restore:${opId}:${confirmDrift}`),
1020
- writeInput.io?.now ?? Date.now,
1021
- () => restoreIntegrationCoordinated(restoreInput, {
1022
- lockSeams: integrationMutationTestHooks?.lockSeams,
1023
- ...(restoreGuard ? { revalidate: restoreGuard.revalidate } : {}),
1024
- restoreGuard: () => hermesBoundaryRefusal(ctx),
1025
- }),
1106
+ scopedFlightKey(ctx, `restore:${opId}:${confirmDrift}:${restoreBinding === "none" ? "unbound" : JSON.stringify([restoreBinding.fingerprint, boundRestore?.identity])}`),
1107
+ integrationMutationTestHooks?.io?.now ?? Date.now,
1108
+ async () => {
1109
+ const apply = async () => {
1110
+ if (restoreDecides) {
1111
+ const refused = prepareHomeIntegrationDecision(ctx, operation.clientId);
1112
+ if (refused) return refused;
1113
+ }
1114
+ const writeInput = boundRestore
1115
+ ? boundRestore.input
1116
+ : await buildIntegrationWriteInput(operation.clientId, ctx, store);
1117
+ const restoreGuard = restoreBinding === "none" ? null : stalePlanGuard(
1118
+ operation.clientId,
1119
+ ctx,
1120
+ store,
1121
+ { operation: "restore", opId, confirmDrift },
1122
+ restoreBinding.fingerprint,
1123
+ boundRestore === null ? null : boundRestore.identity,
1124
+ );
1125
+ const restoreInput: IntegrationRestoreInput = {
1126
+ ...writeInput,
1127
+ opId,
1128
+ confirmDrift,
1129
+ };
1130
+ const result = await restoreIntegrationCoordinated(restoreInput, {
1131
+ lockSeams: integrationMutationTestHooks?.lockSeams,
1132
+ ...(restoreGuard ? { revalidate: restoreGuard.revalidate } : {}),
1133
+ restoreGuard: () => hermesBoundaryRefusal(ctx),
1134
+ });
1135
+ const stale = restoreGuard?.response();
1136
+ if (stale) return stale;
1137
+ if (!result.ok) return writerFailureResponse(operation.clientId, result, ctx);
1138
+ const restored = jsonResponse(result satisfies IntegrationRestoreEnvelope, 200, req, ctx.config);
1139
+ return restoreDecides ? recordHomeIntegrationDecision(ctx, operation.clientId, restored, () => ownedIntent(store, operation.clientId)) : restored;
1140
+ };
1141
+ return restoreDecides ? withLinkApply(apply) : apply();
1142
+ },
1026
1143
  );
1027
- const restoreStale = restoreGuard?.response();
1028
- if (restoreStale) return restoreStale;
1029
- if (!result.ok) {
1030
- /*
1031
- * Drift is NOT special-cased here.
1032
- *
1033
- * It used to be, and the hand-written branch dropped the writer's
1034
- * `message` — which is the only thing that tells the user WHICH file
1035
- * drifted and where its backup went. Every refusal leaves through the
1036
- * one serializer, so a refusal cannot lose its recovery fields by
1037
- * being routed through a shorter path.
1038
- */
1039
- return writerFailureResponse(operation.clientId, result, ctx);
1040
- }
1041
- return jsonResponse(result satisfies IntegrationRestoreEnvelope, 200, req, ctx.config);
1144
+ return jsonResponse(await response.clone().json(), response.status, req, ctx.config);
1042
1145
  } catch (error) {
1043
- if (error instanceof IntegrationMutationBusyError || error instanceof IntegrationWriterLockBusyError) {
1146
+ if (error instanceof IntegrationMutationBusyError || error instanceof IntegrationWriterLockBusyError || error instanceof LinkApplyBusyError) {
1044
1147
  return jsonResponse({
1045
1148
  error: "integration mutation busy",
1046
1149
  code: "integration_mutation_busy",
@@ -1131,55 +1234,79 @@ export async function handleIntegrationRoutes(ctx: ManagementContext): Promise<R
1131
1234
  }
1132
1235
 
1133
1236
  try {
1237
+ // The toggle is the Home's decision (home-integration-decision.ts): Children's defaults are
1238
+ // saved first, an unreadable route-intent.json refuses while nothing has changed, and the
1239
+ // result is recorded below. A selected Hermes profile is not the Home's client.
1240
+ const recordsDecision = ctx.config.runtimeRole !== "client" && isRouteClientId(requestedClient) && !hermesRequestScope(req)?.resolvedPaths;
1241
+ const boundToggle = binding === "none"
1242
+ ? null
1243
+ : await buildIntegrationPreviewInput(requestedClient, ctx, integrationStore(ctx), droidDefaults, modelNames);
1244
+ if (binding !== "none" && boundToggle === null) return previewUnavailableResponse(ctx);
1245
+ if (boundToggle && integrationMutationTestHooks?.afterBoundSnapshot) await integrationMutationTestHooks.afterBoundSnapshot();
1134
1246
  /*
1135
1247
  * A bound request is built from the same passive roster the guard re-plans against, and an
1136
1248
  * unbound one keeps its existing refreshing path. Building the refreshing input first would
1137
1249
  * have had the mutation and its own confirmation check disagree about the roster by
1138
1250
  * construction, which is the disagreement this binding exists to detect.
1139
1251
  */
1140
- const boundToggle = binding === "none"
1141
- ? null
1142
- : await buildIntegrationPreviewInput(requestedClient, ctx, integrationStore(ctx), droidDefaults, modelNames);
1143
- if (binding !== "none" && boundToggle === null) return previewUnavailableResponse(ctx);
1144
- const input = boundToggle
1145
- ? boundToggle.input
1146
- : await buildIntegrationWriteInput(requestedClient, ctx, integrationStore(ctx), droidDefaults, modelNames);
1147
- if (droidDefaults !== undefined) {
1148
- const invalid = validateDroidReasoningDefaults(input.models, droidDefaults);
1149
- if (invalid) return invalidDroidDefaultsResponse(ctx, invalid);
1252
+ if (boundToggle && exportSnapshotIdentity(ctx.config) !== boundToggle.identity) {
1253
+ const current = buildIntegrationPreviewInput(requestedClient, ctx, integrationStore(ctx), droidDefaults, modelNames);
1254
+ return current === null ? previewUnavailableResponse(ctx) : jsonResponse({
1255
+ error: "integration preview is stale", code: "integration_preview_stale",
1256
+ plan: previewIntegration(current.input, { operation: requestedOperation }),
1257
+ }, 409, req, ctx.config);
1150
1258
  }
1151
- const guard = binding === "none" ? null : stalePlanGuard(
1152
- requestedClient,
1153
- ctx,
1154
- integrationStore(ctx),
1155
- { operation: binding.operation },
1156
- binding.fingerprint,
1157
- boundToggle === null ? null : boundToggle.identity,
1158
- droidDefaults,
1159
- modelNames,
1160
- );
1161
- const result = await runIntegrationMutationFlight(
1259
+ const response = await runIntegrationMutationFlight(
1162
1260
  requestedClient,
1163
- scopedFlightKey(ctx, `${requestedOperation}:modelNames:${modelNames ?? "omitted"}`),
1164
- input.io?.now ?? Date.now,
1165
- () => {
1166
- const options = {
1167
- lockSeams: integrationMutationTestHooks?.lockSeams,
1168
- ...(guard ? { revalidate: guard.revalidate } : {}),
1169
- guard: () => hermesBoundaryRefusal(ctx),
1261
+ scopedFlightKey(ctx, `${requestedOperation}:modelNames:${modelNames ?? "omitted"}:binding:${binding === "none" ? "unbound" : JSON.stringify([binding.fingerprint, boundToggle?.identity])}:defaults:${JSON.stringify(droidDefaults ?? null)}`),
1262
+ integrationMutationTestHooks?.io?.now ?? Date.now,
1263
+ async () => {
1264
+ const apply = async () => {
1265
+ if (recordsDecision) {
1266
+ const refused = prepareHomeIntegrationDecision(ctx, requestedClient);
1267
+ if (refused) return refused;
1268
+ }
1269
+ const input = boundToggle
1270
+ ? boundToggle.input
1271
+ : await buildIntegrationWriteInput(requestedClient, ctx, integrationStore(ctx), droidDefaults, modelNames);
1272
+ if (droidDefaults !== undefined) {
1273
+ const invalid = validateDroidReasoningDefaults(input.models, droidDefaults);
1274
+ if (invalid) return invalidDroidDefaultsResponse(ctx, invalid);
1275
+ }
1276
+ const guard = binding === "none" ? null : stalePlanGuard(
1277
+ requestedClient,
1278
+ ctx,
1279
+ integrationStore(ctx),
1280
+ { operation: binding.operation },
1281
+ binding.fingerprint,
1282
+ boundToggle === null ? null : boundToggle.identity,
1283
+ droidDefaults,
1284
+ modelNames,
1285
+ );
1286
+ const options = {
1287
+ lockSeams: integrationMutationTestHooks?.lockSeams,
1288
+ ...(guard ? { revalidate: guard.revalidate } : {}),
1289
+ guard: () => hermesBoundaryRefusal(ctx),
1290
+ };
1291
+ const pending = !parsed.enabled ? disableIntegrationCoordinated(input, options)
1292
+ : parsed.overwriteConflict === true ? overwriteIntegrationCoordinated(input, options)
1293
+ : applyIntegrationCoordinated(input, options);
1294
+ // Coordinators freeze their input synchronously before returning the promise.
1295
+ integrationMutationTestHooks?.afterWriterStart?.();
1296
+ const result = await pending;
1297
+ const stale = guard?.response();
1298
+ if (stale) return stale;
1299
+ if (!result.ok) return writerFailureResponse(requestedClient, result, ctx);
1300
+ const toggled = jsonResponse(result satisfies IntegrationToggleEnvelope, 200, req, ctx.config);
1301
+ return recordsDecision ? recordHomeIntegrationDecision(ctx, requestedClient, toggled, () => ({ enabled: parsed.enabled === true,
1302
+ ...(modelNames !== undefined && (requestedClient === "hermes" || requestedClient === "commandcode") ? { modelNames } : {}) })) : toggled;
1170
1303
  };
1171
- if (!parsed.enabled) return disableIntegrationCoordinated(input, options);
1172
- return parsed.overwriteConflict === true
1173
- ? overwriteIntegrationCoordinated(input, options)
1174
- : applyIntegrationCoordinated(input, options);
1304
+ return recordsDecision ? withLinkApply(apply) : apply();
1175
1305
  },
1176
1306
  );
1177
- const stale = guard?.response();
1178
- if (stale) return stale;
1179
- if (!result.ok) return writerFailureResponse(requestedClient, result, ctx);
1180
- return jsonResponse(result satisfies IntegrationToggleEnvelope, 200, req, ctx.config);
1307
+ return jsonResponse(await response.clone().json(), response.status, req, ctx.config);
1181
1308
  } catch (error) {
1182
- if (error instanceof IntegrationMutationBusyError || error instanceof IntegrationWriterLockBusyError) {
1309
+ if (error instanceof IntegrationMutationBusyError || error instanceof IntegrationWriterLockBusyError || error instanceof LinkApplyBusyError) {
1183
1310
  return jsonResponse({
1184
1311
  error: "integration mutation busy",
1185
1312
  code: "integration_mutation_busy",
@@ -0,0 +1,218 @@
1
+ import { DEFAULT_IDLE_AFTER_MS, isLinkIdle } from "../../link/child-activity";
2
+ import { readChildPolicy, updateChildPolicy, validPolicyPatch } from "../../link/child-policy";
3
+ import { createCatalogRevisionMonitor, type CatalogRevisionMonitor } from "../../link/child-catalog-freshness";
4
+ import { observeChild } from "../../link/child-observe";
5
+ import { patchChildObservation, readChildObservations, updateChildObservations } from "../../link/child-observations";
6
+ import { sharedChildOpsEngine, type ChildOpsEngine, type SubmitRefusal, type SubmitResult } from "../../link/child-ops-engine";
7
+ import { CHILD_OPS, CHILD_OPS_MAX_LINK_IDS, type ChildOp, type ChildOpsEnv, type ChildRestart } from "../../link/child-ops-types";
8
+ import { requireRemotePlatform } from "../../link/remote-platform";
9
+ import { inspectRemoteChildRuntime } from "../../link/remote-plant";
10
+ import { attachLinkChildOps, projectLinkStatus, type LinkStatusDto } from "../../link/status-projection";
11
+ import type { LinkStore } from "../../link/store";
12
+ import { packageVersion } from "../../lib/package-version";
13
+ import { readCatalog, readCodexCatalogPath } from "../../codex/catalog";
14
+ import type { ManagementContext } from "./context";
15
+ import { readManagementJsonBodyOr } from "./body";
16
+ import { auth, fail, isRecord, knownHostsFile, readStoreFor, runnerFor, type LinkRouteState } from "./link-route-state";
17
+
18
+ const LINK_ID = /^lnk_[0-9a-f]{16}$/;
19
+ const JOB_ID = /^ljob_[0-9a-f]{16}$/;
20
+ const MAX_LINK_IDS = CHILD_OPS_MAX_LINK_IDS;
21
+ const JOB_PATH = /^\/api\/link\/children\/jobs\/([^/]+)$/;
22
+ const NO_STORE = { "cache-control": "no-store" };
23
+
24
+ let revisionMonitor: CatalogRevisionMonitor | undefined;
25
+
26
+ /**
27
+ * The production Home catalog revision: the exact bytes `/v1/catalog` serves, hashed like its etag, with the
28
+ * revision persisted as `homeCatalog` in child-observations.json. Created lazily on the first `?children=1` read.
29
+ */
30
+ export function catalogRevisionForRoutes(): CatalogRevisionMonitor {
31
+ return revisionMonitor ??= createCatalogRevisionMonitor({
32
+ catalogPath: () => readCodexCatalogPath(),
33
+ read: path => {
34
+ const catalog = readCatalog(path);
35
+ return catalog ? JSON.stringify(catalog) : null;
36
+ },
37
+ load: () => readChildObservations().homeCatalog,
38
+ persist: revision => { updateChildObservations(file => { file.homeCatalog = revision; }); },
39
+ });
40
+ }
41
+
42
+ /**
43
+ * One engine per Home process (Revision 5). wp2 kept one per route state, which link-routes.ts keys by the config
44
+ * object, so a config reload started a second engine without the first one's locks, and the wp5 scheduler must submit
45
+ * to the engine the routes read. state.childOps stays the seam a direct test can set.
46
+ */
47
+ export function childOpsEngineFor(state: LinkRouteState): ChildOpsEngine {
48
+ return state.childOps ??= sharedChildOpsEngine();
49
+ }
50
+
51
+ const errorName = (error: unknown): string => error instanceof Error ? error.name : "unknown";
52
+
53
+ /** The env captures this request's seams for the job's lifetime; every read is live. wp5 passes the policy idleAfterMs. */
54
+ export function childOpsEnvFor(ctx: ManagementContext, state: LinkRouteState, idleAfterMs = DEFAULT_IDLE_AFTER_MS): ChildOpsEnv {
55
+ const now = ctx.deps.now ?? Date.now;
56
+ const runner = runnerFor(ctx);
57
+ const hosts = knownHostsFile(ctx);
58
+ const homeVersion = packageVersion("0.0.0");
59
+ return {
60
+ readStore: () => readStoreFor(ctx),
61
+ runner, knownHostsFile: hosts, homeVersion, now,
62
+ // The wire state the status route reports, including a recorded compensation failure.
63
+ wireState: linkId => {
64
+ if (state.compensationFailures?.has(linkId)) return "failed";
65
+ return projectLinkStatus(readStoreFor(ctx), state.supervisor.status(), state.listener.status(), ctx.config)
66
+ .links.find(link => link.id === linkId)?.state ?? null;
67
+ },
68
+ activity: linkId => {
69
+ const snapshot = state.listener.linkActivity?.(linkId, now());
70
+ return snapshot ? { inFlight: snapshot.inFlight, idle: isLinkIdle(snapshot, now(), idleAfterMs) } : null;
71
+ },
72
+ sleep: ms => Bun.sleep(ms),
73
+ // wp2's observe deps, unchanged: the peer and activity listeners are optional on LinkRouteListener.
74
+ observe: record => observeChild(record, { runner, knownHostsFile: hosts, homeVersion,
75
+ peer: linkId => state.listener.peerObservation?.(linkId) ?? { observed: null, refused: null },
76
+ platformOf: link => requireRemotePlatform(runner, link.alias, link.explicitRoute ?? null, hosts),
77
+ inspect: inspectRemoteChildRuntime, now: () => new Date(now()) }),
78
+ readObservation: linkId => readChildObservations().children[linkId] ?? null,
79
+ // Never throws into a runner: a cache write failure is logged by error name (ChildOpsEnv contract).
80
+ writeObservation: (linkId, patch) => {
81
+ try { updateChildObservations(file => patchChildObservation(file, linkId, patch, new Date(now()))); }
82
+ catch (error) { console.warn(`[link] child observation write failed linkId=${linkId} error=${errorName(error)}`); }
83
+ },
84
+ // Revision 4: wp2's monitor on LinkRouteState.catalogRevision (catalogEtag hashing); null when the catalog cannot be read.
85
+ catalogEtag: () => {
86
+ try { return (state.catalogRevision ??= catalogRevisionForRoutes()).current()?.etag ?? null; } catch { return null; }
87
+ },
88
+ };
89
+ }
90
+
91
+ export interface ParsedOperation { op: ChildOp; linkIds: string[] | "all"; restart: ChildRestart; ignoreActivity?: true }
92
+
93
+ /**
94
+ * Exactly {op, linkIds, restart?}. A2 / M8: any request that carries a restart (sync with restart, or restart-codex,
95
+ * whose restart defaults to app-server) must name its links; "all" is accepted only when restart is "none".
96
+ * Scope (audit r2 R6): this rule binds this API route and the ocx link verbs only; ocx sync --restart-children (040)
97
+ * and the automatic restart policy (050) select links themselves and apply the same run-time activity check.
98
+ * No body can set trigger: the route always submits manual operations. ignoreActivity (D8, the operator's explicit
99
+ * restart past activity) is accepted only as true, on a sync or restart-codex request with a restart and exactly one
100
+ * link id; an update's own restart keeps the activity gate, so the flag is refused there.
101
+ */
102
+ export function parseOperation(body: unknown): ParsedOperation | null {
103
+ if (!isRecord(body) || Object.keys(body).some(key => key !== "op" && key !== "linkIds" && key !== "restart" && key !== "ignoreActivity")) return null;
104
+ if (!(CHILD_OPS as readonly unknown[]).includes(body.op)) return null;
105
+ const op = body.op as ChildOp;
106
+ if (body.restart !== undefined && body.restart !== "app-server" && body.restart !== "codex") return null;
107
+ if (body.restart !== undefined && op === "observe") return null;
108
+ const restart: ChildRestart = op === "restart-codex" ? (body.restart as ChildRestart | undefined) ?? "app-server"
109
+ : (body.restart as ChildRestart | undefined) ?? "none";
110
+ const ids = body.linkIds;
111
+ let linkIds: string[] | "all";
112
+ if (ids === "all" && restart === "none") linkIds = "all";
113
+ else if (Array.isArray(ids) && ids.length >= 1 && ids.length <= MAX_LINK_IDS
114
+ && ids.every(id => typeof id === "string" && LINK_ID.test(id)) && new Set(ids).size === ids.length) linkIds = [...ids as string[]];
115
+ else return null;
116
+ if (body.ignoreActivity !== undefined && (body.ignoreActivity !== true || (op !== "sync" && op !== "restart-codex") || restart === "none"
117
+ || linkIds === "all" || linkIds.length !== 1)) return null;
118
+ return { op, linkIds, restart, ...(body.ignoreActivity === true ? { ignoreActivity: true as const } : {}) };
119
+ }
120
+
121
+ function refusal(code: SubmitRefusal): Response {
122
+ switch (code) {
123
+ case "link_not_found": return fail(code, "The link was not found.", 404);
124
+ case "link_not_home_initiated": return fail(code, "Only a Home-initiated link can be operated from this computer.", 409);
125
+ case "link_operation_in_progress": return fail(code, "Another operation is running on this link.", 409);
126
+ // Returned only when links.json has no link at all, so the message says exactly that.
127
+ case "no_eligible_links": return fail(code, "This Home has no links.", 409);
128
+ }
129
+ }
130
+
131
+ /** `?children=1` on a Home: attach every row's `child` block. Never fails on the cache or the revision save. */
132
+ export function attachLinkChildOpsForState(dto: LinkStatusDto, state: LinkRouteState, store: LinkStore, now: number = Date.now()): LinkStatusDto {
133
+ // A pull inside the recorder's write window would otherwise reach the file only at the next pull or at shutdown.
134
+ // Best effort: a lock failure is logged by the recorder and retried later; the status read never fails on it.
135
+ state.listener.flushCatalogPulls?.();
136
+ const revision = (state.catalogRevision ??= catalogRevisionForRoutes()).current();
137
+ const observations = readChildObservations();
138
+ const known = new Set(store.links.map(link => link.id));
139
+ return attachLinkChildOps(dto, {
140
+ // The policy threshold governs every idle decision (050 reconciliation item 5).
141
+ homeVersion: packageVersion("0.0.0"), now, idleAfterMs: readChildPolicy().policy.idleAfterMs, revision,
142
+ peerVersion: linkId => state.listener.peerObservation?.(linkId).observed?.version ?? null,
143
+ observation: linkId => known.has(linkId) ? observations.children[linkId] ?? null : null,
144
+ activity: linkId => state.listener.linkActivity?.(linkId, now) ?? null,
145
+ catalogPull: linkId => state.listener.catalogPull?.(linkId) ?? null,
146
+ // The shared engine: a job the wp5 scheduler started shows on a status read that never submitted one.
147
+ activeJob: linkId => childOpsEngineFor(state).activeJob(linkId),
148
+ // D8: present only on a row whose link WebSocket activity holds keep it in flight.
149
+ holds: linkId => state.listener.linkHolds?.(linkId) ?? null,
150
+ });
151
+ }
152
+
153
+ /**
154
+ * D8: the operator's clear of one link's WebSocket activity holds, including an unknown state left by a crash. Never
155
+ * automatic. Exactly {linkId}; the link must exist in links.json. The holds file is written before anything is forgotten.
156
+ */
157
+ async function clearActivityHolds(ctx: ManagementContext, state: LinkRouteState): Promise<Response> {
158
+ if (ctx.config.runtimeRole === "client") return fail("runtime_role_client", "A Child runtime does not operate other Children.", 409);
159
+ const body = await readManagementJsonBodyOr(ctx.req, null);
160
+ if (!isRecord(body) || Object.keys(body).some(key => key !== "linkId") || typeof body.linkId !== "string" || !LINK_ID.test(body.linkId)) {
161
+ return fail("invalid_body", "The body must be exactly {linkId}.", 400);
162
+ }
163
+ const linkId = body.linkId;
164
+ let store: LinkStore;
165
+ try { store = readStoreFor(ctx); } catch { return fail("link_unavailable", "The link store could not be read.", 503); }
166
+ if (!store.links.some(link => link.id === linkId)) return fail("link_not_found", "The link was not found.", 404);
167
+ // A listener without the hook cannot clear anything; answering "nothing held" would hide a wiring gap.
168
+ if (!state.listener.clearLinkHolds) return fail("activity_holds_unavailable", "This Home cannot clear link activity holds.", 503);
169
+ const result = state.listener.clearLinkHolds(linkId);
170
+ if (!result.ok) {
171
+ return result.reason === "links-unreadable"
172
+ ? fail("link_unavailable", "The links could not be listed, so every link stays held; try again once links.json is readable.", 503)
173
+ : fail("activity_holds_write_failed", "The activity holds could not be saved; nothing was cleared.", 503);
174
+ }
175
+ if (result.cleared) console.log(`[link] activity holds cleared by the operator linkId=${linkId} holds=${result.cleared.holds.length} unknown=${result.cleared.unknown ?? "none"}`);
176
+ return Response.json({ linkId, cleared: result.cleared }, { headers: NO_STORE });
177
+ }
178
+
179
+ export async function handleLinkChildOpsRoutes(ctx: ManagementContext, state: LinkRouteState): Promise<Response | null> {
180
+ const { url, req } = ctx;
181
+ const path = url.pathname;
182
+ const denied = auth(ctx, "either");
183
+ if (denied) return denied;
184
+ if (url.pathname === "/api/link/children/operations" && req.method === "POST") {
185
+ if (ctx.config.runtimeRole === "client") return fail("runtime_role_client", "A Child runtime does not operate other Children.", 409);
186
+ const operation = parseOperation(await readManagementJsonBodyOr(req, null));
187
+ if (!operation) return fail("invalid_body", "The body must be exactly {op, linkIds, restart?}; restart is app-server or codex and needs explicit linkIds.", 400);
188
+ let result: SubmitResult;
189
+ try { result = childOpsEngineFor(state).submit({ ...operation, trigger: "manual" }, childOpsEnvFor(ctx, state, readChildPolicy().policy.idleAfterMs)); }
190
+ catch { return fail("link_unavailable", "The link store could not be read.", 503); }
191
+ return result.ok ? Response.json({ job: result.job }, { status: 202, headers: NO_STORE }) : refusal(result.code);
192
+ }
193
+ // 050: the Child policy. The handler-wide auth above admits a dashboard session or the admin token on loopback.
194
+ if (url.pathname === "/api/link/children/policy" && req.method === "GET") return Response.json(readChildPolicy(), { headers: NO_STORE });
195
+ if (url.pathname === "/api/link/children/policy" && req.method === "PUT") {
196
+ // Same refusal as POST operations: a Child's policy file would govern nothing.
197
+ if (ctx.config.runtimeRole === "client") return fail("runtime_role_client", "A Child runtime does not operate other Children.", 409);
198
+ const body = await readManagementJsonBodyOr(req, null);
199
+ const patch = isRecord(body) && Object.keys(body).length > 0 ? validPolicyPatch(body) : null;
200
+ if (!patch) return fail("invalid_body", "Send one or more of catalogFanout, childCodexRestart, updates, idleAfterMs with valid values.", 400);
201
+ try { return Response.json({ policy: updateChildPolicy(patch), warning: null }, { headers: NO_STORE }); }
202
+ catch { return fail("policy_write_failed", "The Child policy could not be saved.", 503); }
203
+ }
204
+ // D8: the operator clears one link's WebSocket activity holds.
205
+ if (url.pathname === "/api/link/children/activity/clear" && req.method === "POST") {
206
+ return clearActivityHolds(ctx, state);
207
+ }
208
+ const jobPath = req.method === "GET" ? JOB_PATH.exec(path) : null;
209
+ if (jobPath) {
210
+ let jobId: string;
211
+ try { jobId = decodeURIComponent(jobPath[1]!); } catch { return fail("invalid_job_id", "The job id is invalid.", 400); }
212
+ if (!JOB_ID.test(jobId)) return fail("invalid_job_id", "The job id is invalid.", 400);
213
+ const job = childOpsEngineFor(state).job(jobId);
214
+ if (!job) return fail("job_not_found", "The job was not found.", 404);
215
+ return Response.json({ job }, { headers: NO_STORE });
216
+ }
217
+ return fail("not_found", "Not found.", 404);
218
+ }