@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
@@ -11,6 +11,7 @@ export type RunPnpmCandidate = (
11
11
  commandPath: string,
12
12
  args: readonly string[],
13
13
  capture?: boolean,
14
+ owner?: PnpmGlobalOwner,
14
15
  ) => PnpmRunResult;
15
16
 
16
17
  export interface PnpmGlobalOwner {
@@ -21,6 +22,13 @@ export interface PnpmGlobalOwner {
21
22
  /** Actual versioned global group reported by pnpm root/list. */
22
23
  globalRoot: string;
23
24
  globalBinDir: string;
25
+ store?: string;
26
+ /** Lexical versioned store path reported by pnpm and pinned on mutations. */
27
+ storePath?: string;
28
+ globalStore?: boolean;
29
+ virtualStoreDirs?: string[];
30
+ /** pnpm home the store query was anchored at; pinned for every later store re-check. */
31
+ homeAnchor?: string;
24
32
  version?: string;
25
33
  }
26
34
 
@@ -72,6 +80,11 @@ export type PnpmGlobalPackage =
72
80
  globalDir?: string;
73
81
  globalRoot?: string;
74
82
  globalBinDir?: string;
83
+ /** Present only for a global virtual-store owner. */
84
+ store?: string;
85
+ storePath?: string;
86
+ virtualStoreDirs?: string[];
87
+ homeAnchor?: string;
75
88
  }
76
89
  | { ok: false; reason: string };
77
90
 
@@ -84,6 +97,8 @@ export interface PnpmGlobalReadConstraints {
84
97
  /** Set false only for pre-update owner binding; post-update reads verify shims by default. */
85
98
  checkShims?: boolean;
86
99
  platform?: NodeJS.Platform;
100
+ /** Environment the pnpm commands receive; locates pnpm home for the store query. */
101
+ env?: NodeJS.ProcessEnv;
87
102
  verifyShims?: (
88
103
  packageDir: string,
89
104
  globalBinDir: string,
@@ -94,7 +109,7 @@ export interface PnpmGlobalReadConstraints {
94
109
  export declare function readPnpmGlobalPackage(
95
110
  packageName: string,
96
111
  runPnpm: RunPnpm,
97
- verify?: (packageDir: string, expectedVersion?: string) => PnpmVerificationResult,
112
+ verify?: (packageDir: string, expectedVersion?: string, store?: string, globalRoot?: string, lexicalStore?: string) => PnpmVerificationResult,
98
113
  constraints?: PnpmGlobalReadConstraints,
99
114
  ): PnpmGlobalPackage;
100
115
 
@@ -104,8 +119,11 @@ export declare function resolvePnpmGlobalOwner(options: {
104
119
  commandPaths: readonly string[];
105
120
  runningShimPath?: string;
106
121
  runPnpm: RunPnpmCandidate;
107
- verify?: (packageDir: string, expectedVersion?: string) => PnpmVerificationResult;
122
+ verify?: (packageDir: string, expectedVersion?: string, store?: string, globalRoot?: string, lexicalStore?: string) => PnpmVerificationResult;
108
123
  platform?: NodeJS.Platform;
124
+ env?: NodeJS.ProcessEnv;
125
+ /** Re-resolving a store-pinned owner: always run the store proof, whatever the tree's spelling. */
126
+ requireStoreProof?: boolean;
109
127
  }): PnpmGlobalOwnerResult;
110
128
 
111
129
  export type PnpmGlobalUpdateResult =
@@ -139,7 +157,7 @@ export declare function runPnpmGlobalUpdate(options: {
139
157
  owner: PnpmGlobalOwner;
140
158
  runningPackagePath?: string;
141
159
  runPnpm: RunPnpm;
142
- verify?: (packageDir: string, expectedVersion?: string) => PnpmVerificationResult;
160
+ verify?: (packageDir: string, expectedVersion?: string, store?: string, globalRoot?: string, lexicalStore?: string) => PnpmVerificationResult;
143
161
  verifyShims?: (
144
162
  packageDir: string,
145
163
  globalBinDir: string,
@@ -1,10 +1,31 @@
1
- import { existsSync, readFileSync, realpathSync, statSync } from "node:fs";
2
- import { basename, dirname, isAbsolute, join, relative, resolve, win32 } from "node:path";
1
+ import { existsSync, lstatSync, readFileSync, realpathSync, statSync } from "node:fs";
2
+ import { basename, dirname, isAbsolute, join, parse, relative, resolve, win32 } from "node:path";
3
3
  import { pnpmInvocationForPath } from "./pnpm-invocation.mjs";
4
- import { verifyPnpmInstallTree } from "./transactional-install.mjs";
4
+ import { pnpmPackageUsesGlobalStoreLinks, verifyPnpmInstallTree } from "./transactional-install.mjs";
5
5
 
6
6
  export const PNPM_BUILD_APPROVAL = "--allow-build=bun";
7
7
 
8
+ /**
9
+ * pnpm majors whose global virtual-store install and `store path --dir=<pnpm home>` were checked to
10
+ * select the same store (11.20.0, 12.16.1). Another major refuses rather than assumes the same rules.
11
+ */
12
+ const VERIFIED_GLOBAL_STORE_MAJORS = new Set([11, 12]);
13
+
14
+ /** Characters cmd.exe re-parses after quoting (same set as the npm cache preflight). */
15
+ const WINDOWS_CMD_METACHARACTERS = /["%!^&|<>]/;
16
+
17
+ /**
18
+ * On Windows pnpm.cmd re-parses its arguments in cmd.exe after quoting, so a global-store owner whose
19
+ * pnpm home, global directory or global bin directory carries one of these characters is refused
20
+ * before any owner-pinned pnpm command receives them (the npm cache preflight refuses the same set).
21
+ */
22
+ function windowsCmdPathRefusal(owner, env, platform) {
23
+ if (platform !== "win32") return null;
24
+ const paths = [owner?.homeAnchor ?? pnpmHomeAnchor(env, platform), owner?.globalDir, owner?.globalBinDir];
25
+ return paths.some(path => WINDOWS_CMD_METACHARACTERS.test(String(path ?? "")))
26
+ ? { ok: false, reason: "pnpm path contains a character cmd.exe cannot pass safely" } : null;
27
+ }
28
+
8
29
  function outputText(value) {
9
30
  if (typeof value === "string") return value;
10
31
  if (value instanceof Uint8Array) return new TextDecoder().decode(value);
@@ -157,12 +178,18 @@ function ownerGlobalArgs(args, owner) {
157
178
  if (arg === "--config.global-bin-dir") index += 1;
158
179
  continue;
159
180
  }
181
+ if (owner.storePath && (arg === "--store-dir" || arg.startsWith("--store-dir=")
182
+ || arg === "--config.store-dir" || arg.startsWith("--config.store-dir="))) {
183
+ if (arg === "--store-dir" || arg === "--config.store-dir") index += 1;
184
+ continue;
185
+ }
160
186
  rest.push(arg);
161
187
  }
162
188
  return [
163
189
  command,
164
190
  `--global-dir=${owner.globalDir}`,
165
191
  `--config.global-bin-dir=${owner.globalBinDir}`,
192
+ ...(["add", "install", "update", "remove", "uninstall"].includes(command) && owner.storePath ? [`--store-dir=${owner.storePath}`] : []),
166
193
  ...rest,
167
194
  ];
168
195
  }
@@ -295,6 +322,191 @@ export function verifyPnpmGlobalShims(
295
322
  : { ok: false, reason: `pnpm generated shim verification failed (${missing.join(", ")})` };
296
323
  }
297
324
 
325
+ function commandLines(result) {
326
+ return outputText(result?.stdout).split(/\r?\n/).map(line => line.trim()).filter(Boolean);
327
+ }
328
+
329
+ /**
330
+ * The directory pnpm loads its global configuration from (pnpm home): PNPM_HOME, then
331
+ * XDG_DATA_HOME/pnpm, then the platform default. It is read from the environment the pnpm
332
+ * commands receive, so the anchor and the commands agree.
333
+ */
334
+ export function pnpmHomeAnchor(env = process.env, platform = process.platform) {
335
+ const value = key => typeof env?.[key] === "string" && env[key].trim() ? env[key] : null;
336
+ const joinPath = platform === "win32" ? win32.join : join;
337
+ let anchor = null;
338
+ if (value("PNPM_HOME")) anchor = value("PNPM_HOME");
339
+ else if (value("XDG_DATA_HOME")) anchor = joinPath(value("XDG_DATA_HOME"), "pnpm");
340
+ else if (platform === "win32") anchor = value("LOCALAPPDATA") ? win32.join(value("LOCALAPPDATA"), "pnpm") : null;
341
+ else if (value("HOME")) {
342
+ anchor = platform === "darwin" ? join(value("HOME"), "Library", "pnpm") : join(value("HOME"), ".local", "share", "pnpm");
343
+ }
344
+ // A control character could split a cmd.exe command line on Windows; such a home is never trusted.
345
+ return anchor && isAbsolutePath(anchor, platform) && !/[\u0000-\u001f\u007f]/.test(anchor) ? anchor : null;
346
+ }
347
+
348
+ /**
349
+ * Classify a spelling used as a confinement root (pnpm home, store path, global group). It is trusted
350
+ * only when it is already canonical: no "." or ".." segment (path.resolve would delete them without
351
+ * visiting the links they cross), no link or junction component, and realpath returns the same path.
352
+ * Case is folded for the last comparison only; a case-only symlink is caught by the component walk.
353
+ * Returns "link", "noncanonical" or "ok"; throws when the path is missing or not a directory.
354
+ */
355
+ function spellingTrust(path) {
356
+ const raw = String(path);
357
+ const { root } = parse(raw);
358
+ const parts = raw.slice(root.length).split(/[\\/]+/).filter(Boolean);
359
+ if (!root || parts.some(part => part === "." || part === "..")) return "noncanonical";
360
+ let current = root;
361
+ for (const part of parts) {
362
+ current = join(current, part);
363
+ if (lstatSync(current).isSymbolicLink()) return "link";
364
+ }
365
+ if (!statSync(raw).isDirectory()) throw new Error("not a directory");
366
+ const fold = value => resolve(value).replaceAll("\\", "/").replace(/\/+$/, "").toLowerCase();
367
+ return fold(realpathSync.native(raw)) === fold(raw) ? "ok" : "noncanonical";
368
+ }
369
+
370
+ /** Map a spelling's trust to the refusal reason for the named root, or null when trusted. */
371
+ function spellingRefusal(path, label) {
372
+ const trust = spellingTrust(path);
373
+ if (trust === "link") return label + " has a symbolic link component";
374
+ if (trust === "noncanonical") return label + " is not a canonical path";
375
+ return null;
376
+ }
377
+
378
+ /** Appended to a store-proof refusal for an install whose path looks like a pnpm global store. */
379
+ const STORE_PROOF_HINT = "; this install's path looks like a pnpm global store (a store links directory or pnpm store markers), "
380
+ + "so the updater accepts it only when pnpm 11 or 12 names that store. Update with pnpm itself: "
381
+ + "pnpm add -g @bitkyc08/opencodex@latest";
382
+
383
+ /** Filesystem identity of a directory (device and inode), or null when it is not a readable directory. */
384
+ function directoryIdentity(path) {
385
+ try {
386
+ const stat = statSync(path);
387
+ return stat.isDirectory() ? `${stat.dev}:${stat.ino}` : null;
388
+ } catch { return null; }
389
+ }
390
+
391
+ /**
392
+ * A store owner's store and global group are pinned by filesystem identity for one update transaction, so a
393
+ * directory replaced at the same canonical path between the proof and a pnpm mutation (install or rollback)
394
+ * stops the transaction instead of receiving the mutation.
395
+ */
396
+ function pinStoreOwnerIdentity(owner) {
397
+ const group = directoryIdentity(owner.globalRoot), store = directoryIdentity(owner.store);
398
+ return {
399
+ refusal() {
400
+ if (!group || directoryIdentity(owner.globalRoot) !== group) return "pnpm global group was replaced or could not be read";
401
+ if (!store || directoryIdentity(owner.store) !== store) return "pnpm configured store was replaced or could not be read";
402
+ return null;
403
+ },
404
+ };
405
+ }
406
+
407
+ /** Store-proof failures are configuration facts, not package-tree failures. */
408
+ function isStoreProofFailure(reason) {
409
+ return typeof reason === "string" && (reason.startsWith("pnpm configured store")
410
+ || reason.startsWith("pnpm virtual-store") || reason.startsWith("pnpm store path")
411
+ || reason.startsWith("pnpm home") || reason.startsWith("pnpm global-store behavior")
412
+ // A global group that lost its canonical spelling is a configuration fact too: no rollback through it.
413
+ || reason.startsWith("pnpm global group"));
414
+ }
415
+
416
+ /**
417
+ * Ask the selected pnpm which store it uses for its global configuration. The answer counts only
418
+ * when the pnpm version is one whose global-store behavior was checked, the anchor is a real
419
+ * directory with no symbolic link component, and pnpm prints exactly one absolute versioned path.
420
+ * The lexical path and its canonical target are pinned separately and both must stay unchanged.
421
+ */
422
+ function readPnpmStore(runPnpm, owner, platform, env = process.env) {
423
+ const unsafe = windowsCmdPathRefusal(owner, env, platform);
424
+ if (unsafe) return unsafe;
425
+ let pnpmVersion;
426
+ try {
427
+ const result = runPnpm(["--version"], true);
428
+ const lines = commandLines(result);
429
+ if (result?.status === 0 && lines.length === 1) pnpmVersion = lines[0];
430
+ } catch { /* refused below */ }
431
+ const major = /^(\d+)\.\d+\.\d+(?:[-+][0-9A-Za-z.+-]*)?$/.exec(pnpmVersion ?? "")?.[1];
432
+ if (!major || !VERIFIED_GLOBAL_STORE_MAJORS.has(Number(major))) {
433
+ return { ok: false, reason: "pnpm global-store behavior is not verified for this pnpm version" };
434
+ }
435
+
436
+ const homeAnchor = owner?.homeAnchor ?? pnpmHomeAnchor(env, platform);
437
+ if (!homeAnchor) return { ok: false, reason: "pnpm home could not be determined" };
438
+ try {
439
+ const refusal = spellingRefusal(homeAnchor, "pnpm home");
440
+ if (refusal) return { ok: false, reason: refusal };
441
+ } catch {
442
+ return { ok: false, reason: "pnpm home could not be resolved" };
443
+ }
444
+
445
+ let storePath;
446
+ try {
447
+ const probe = runPnpm(["store", "path", `--dir=${homeAnchor}`], true);
448
+ const lines = commandLines(probe);
449
+ if (probe?.status === 0 && lines.length === 1 && isAbsolutePath(lines[0], platform)
450
+ && /^v\d+$/.test(pathBasename(lines[0], platform))) storePath = lines[0];
451
+ } catch { /* refused below */ }
452
+ if (!storePath) return { ok: false, reason: "pnpm store path is not one absolute versioned path" };
453
+ if (platform === "win32" && WINDOWS_CMD_METACHARACTERS.test(storePath)) {
454
+ return { ok: false, reason: "pnpm path contains a character cmd.exe cannot pass safely" };
455
+ }
456
+ // A link inside the store spelling would widen the root every later hop is confined to.
457
+ try {
458
+ const refusal = spellingRefusal(storePath, "pnpm store path");
459
+ if (refusal) return { ok: false, reason: refusal };
460
+ } catch {
461
+ return { ok: false, reason: "pnpm store path could not be resolved" };
462
+ }
463
+ let store;
464
+ try {
465
+ store = realpathSync.native(storePath);
466
+ if (!statSync(store).isDirectory()) throw new Error();
467
+ } catch {
468
+ return { ok: false, reason: "pnpm store path could not be resolved" };
469
+ }
470
+ if (owner?.storePath && lexicalPathKey(storePath, platform) !== lexicalPathKey(owner.storePath, platform)) {
471
+ return { ok: false, reason: "pnpm configured store changed" };
472
+ }
473
+ if (owner?.store && lexicalPathKey(store, platform) !== lexicalPathKey(owner.store, platform)) {
474
+ return { ok: false, reason: "pnpm configured store changed" };
475
+ }
476
+ const virtualStoreDirs = [];
477
+ for (const key of ["virtual-store-dir", "global-virtual-store-dir"]) {
478
+ let value;
479
+ try {
480
+ const args = ["config", "get", key, "-g", `--config.global-dir=${owner.globalDir}`, `--config.global-bin-dir=${owner.globalBinDir}`];
481
+ const result = runPnpm(args, true);
482
+ const lines = outputText(result?.stdout).split(/\r?\n/).map(line => line.trim()).filter(Boolean);
483
+ if (result?.status !== 0 || lines.length !== 1) throw new Error();
484
+ value = lines[0];
485
+ } catch { return { ok: false, reason: "pnpm virtual-store configuration could not be resolved" }; }
486
+ if (/^(?:undefined|null)$/i.test(value)) continue;
487
+ if (!isAbsolutePath(value, platform)) return { ok: false, reason: "pnpm virtual-store directory is not absolute" };
488
+ let path;
489
+ try { path = realpathSync.native(value); if (!statSync(path).isDirectory()) throw new Error(); }
490
+ catch { return { ok: false, reason: "pnpm virtual-store directory could not be resolved" }; }
491
+ const rel = relative(store, path);
492
+ if (rel === ".." || rel.startsWith("../") || rel.startsWith("..\\") || isAbsolute(rel)) {
493
+ return { ok: false, reason: "pnpm virtual-store directory is outside the selected store" };
494
+ }
495
+ virtualStoreDirs.push(path);
496
+ }
497
+ if (owner?.virtualStoreDirs && (owner.virtualStoreDirs.length !== virtualStoreDirs.length
498
+ || virtualStoreDirs.some((path, index) => lexicalPathKey(path, platform) !== lexicalPathKey(owner.virtualStoreDirs[index], platform)))) {
499
+ return { ok: false, reason: "pnpm virtual-store configuration changed" };
500
+ }
501
+ return { ok: true, store, storePath, virtualStoreDirs, homeAnchor };
502
+ }
503
+
504
+ function isPackageInGlobalStore(packagePath, store) {
505
+ const path = realpathSync.native(packagePath);
506
+ const rel = relative(store, path);
507
+ return rel !== ".." && !rel.startsWith("../") && !rel.startsWith("..\\") && !isAbsolute(rel);
508
+ }
509
+
298
510
  /**
299
511
  * Read and verify the package manager's active global link. `owner` constraints
300
512
  * make the listing a proof of the group selected during preflight, not merely a
@@ -310,6 +522,10 @@ export function readPnpmGlobalPackage(
310
522
  const expectedGlobalDir = constraints.expectedGlobalDir ?? constraints.owner?.globalDir;
311
523
  const expectedGlobalRoot = constraints.expectedGlobalRoot ?? constraints.owner?.globalRoot;
312
524
  const globalBinDir = constraints.globalBinDir ?? constraints.owner?.globalBinDir;
525
+ if (constraints.owner?.globalStore === true) {
526
+ const unsafe = windowsCmdPathRefusal(constraints.owner, constraints.env, platform);
527
+ if (unsafe) return unsafe;
528
+ }
313
529
  let result;
314
530
  try {
315
531
  result = runPnpm(ownerGlobalArgs(["list", "-g", "--depth=0", "--json", packageName], constraints.owner), true);
@@ -343,12 +559,35 @@ export function readPnpmGlobalPackage(
343
559
  }
344
560
 
345
561
  let tree;
562
+ // A legacy global group keeps the verification it had before global-store support: no store
563
+ // query, no store argument. The verifier still refuses any package that uses store links
564
+ // without a selected store, so a global-store layout cannot pass on this branch.
565
+ const globalStore = constraints.owner?.globalStore === true;
566
+ let storeResult = { ok: true };
567
+ if (globalStore) {
568
+ storeResult = readPnpmStore(runPnpm, constraints.owner, platform, constraints.env);
569
+ if (!storeResult.ok) return storeResult;
570
+ // The global group is the other hop root; a link in its spelling would widen it the same way.
571
+ try {
572
+ const refusal = rootPath ? spellingRefusal(rootPath, "pnpm global group") : "pnpm global group has a symbolic link component";
573
+ if (refusal) return { ok: false, reason: refusal };
574
+ } catch { return { ok: false, reason: "pnpm global group could not be resolved" }; }
575
+ try {
576
+ if (!isPackageInGlobalStore(packagePath, storeResult.store)) return { ok: false, reason: "pnpm global-store package is outside the selected store" };
577
+ } catch { return { ok: false, reason: "pnpm active package path could not be resolved" }; }
578
+ }
579
+ const verifyPath = path => globalStore
580
+ ? verify(path, version, storeResult.store, rootPath, storeResult.storePath)
581
+ : verify(path, version);
346
582
  try {
347
- tree = verify(packagePath, version);
583
+ tree = verifyPath(packagePath);
584
+ if (tree?.ok && constraints.expectedPackagePath && constraints.expectedPackagePath !== packagePath) {
585
+ tree = verifyPath(constraints.expectedPackagePath);
586
+ }
348
587
  } catch {
349
588
  return { ok: false, reason: "the active pnpm package could not be verified" };
350
589
  }
351
- if (!tree?.ok) return { ok: false, reason: "the active pnpm package failed verification" };
590
+ if (!tree?.ok) return { ok: false, reason: tree?.failures?.[0] ?? "the active pnpm package failed verification" };
352
591
 
353
592
  // A valid package tree/group is enough to bind the owner before an update. The
354
593
  // existing shim may be stale from an older pnpm run; post-update and rollback
@@ -368,6 +607,12 @@ export function readPnpmGlobalPackage(
368
607
  globalDir: expectedGlobalDir,
369
608
  globalRoot: rootPath || expectedGlobalRoot,
370
609
  globalBinDir,
610
+ ...(globalStore ? {
611
+ store: storeResult.store,
612
+ storePath: storeResult.storePath,
613
+ virtualStoreDirs: storeResult.virtualStoreDirs,
614
+ homeAnchor: storeResult.homeAnchor,
615
+ } : {}),
371
616
  };
372
617
  }
373
618
 
@@ -400,9 +645,20 @@ export function resolvePnpmGlobalOwner({
400
645
  runPnpm,
401
646
  verify = verifyPnpmInstallTree,
402
647
  platform = process.platform,
648
+ env = process.env,
649
+ // Re-resolving an owner already pinned to a store (orchestrated post-update verification) always runs
650
+ // the store proof, whatever the new tree's spelling, so a pinned store owner is never demoted.
651
+ requireStoreProof = false,
403
652
  }) {
404
653
  if (!isAbsolutePath(packagePath, platform)) return { ok: false, reason: "running pnpm package path is not absolute" };
405
654
  let lastReason = "no pnpm global installation owns the running package";
655
+ // A running package that looks like a pnpm global store gets the remedy even when no pnpm candidate lists
656
+ // it (a failed listing, or another path), so every refusal of a store-like install says what to run.
657
+ let runningClassified;
658
+ try { runningClassified = requireStoreProof === true || pnpmPackageUsesGlobalStoreLinks(packagePath); }
659
+ catch { runningClassified = true; }
660
+ const withRunningHint = reason => runningClassified && typeof reason === "string" && !reason.endsWith(STORE_PROOF_HINT)
661
+ ? reason + STORE_PROOF_HINT : reason;
406
662
 
407
663
  for (const commandPath of commandPaths ?? []) {
408
664
  const list = listGlobalPackage(commandPath, packageName, runPnpm);
@@ -411,9 +667,22 @@ export function resolvePnpmGlobalOwner({
411
667
  const listedPath = typeof inspected?.entry?.path === "string" ? inspected.entry.path : "";
412
668
  if (!listedPath || !isAbsolutePath(listedPath, platform) || !samePath(listedPath, packagePath, platform)) continue;
413
669
 
670
+ // Classification only decides which proof is required. Either spelling of the running package
671
+ // that passes through pnpm store links demands the store proof; nothing here accepts a package.
672
+ // It runs before any refusal below so every refusal of a store-like install carries the remedy.
673
+ let globalStore;
674
+ try {
675
+ globalStore = requireStoreProof === true
676
+ || pnpmPackageUsesGlobalStoreLinks(listedPath) || pnpmPackageUsesGlobalStoreLinks(packagePath);
677
+ } catch { globalStore = true; }
678
+ // A path that looks like a pnpm global store is accepted only on pnpm's own store answer. Every refusal of
679
+ // such an install says so, so a user whose group merely sits under a store-like directory, or whose pnpm
680
+ // home cannot be passed safely, knows why and what to run instead. The original reason stays the prefix.
681
+ const refusal = reason => globalStore && typeof reason === "string" ? reason + STORE_PROOF_HINT : reason;
682
+
414
683
  const paths = resolveGlobalPaths(commandPath, runPnpm, inspected?.root?.path, platform);
415
684
  if (!paths) {
416
- lastReason = "pnpm owns the running package but did not report its global group and bin directory";
685
+ lastReason = refusal("pnpm owns the running package but did not report its global group and bin directory");
417
686
  continue;
418
687
  }
419
688
  const { globalDir, globalRoot, globalBinDir } = paths;
@@ -427,15 +696,15 @@ export function resolvePnpmGlobalOwner({
427
696
  const shimName = String(runningShimPath).replaceAll("\\", "/").split("/").at(-1)?.toLowerCase();
428
697
  const isCommandShim = ["ocx", "opencodex", "ocx.cmd", "opencodex.cmd", "ocx.ps1", "opencodex.ps1"].includes(shimName ?? "");
429
698
  if (isCommandShim && !samePath(dirname(runningShimPath), globalBinDir, platform)) {
430
- lastReason = "pnpm package owner did not match the running global shim";
699
+ lastReason = refusal("pnpm package owner did not match the running global shim");
431
700
  continue;
432
701
  }
433
702
  }
434
703
 
435
- const owner = { commandPath, packagePath: listedPath, globalDir, globalRoot, globalBinDir };
704
+ const owner = { commandPath, packagePath: listedPath, globalDir, globalRoot, globalBinDir, ...(globalStore ? { globalStore: true } : {}) };
436
705
  const active = readPnpmGlobalPackage(
437
706
  packageName,
438
- (args, capture = false) => runPnpm(commandPath, args, capture),
707
+ (args, capture = false) => runPnpm(commandPath, args, capture, owner),
439
708
  verify,
440
709
  {
441
710
  owner,
@@ -447,12 +716,16 @@ export function resolvePnpmGlobalOwner({
447
716
  // the top-level shim stale; the transaction verifies it after mutation.
448
717
  checkShims: false,
449
718
  platform,
719
+ env,
450
720
  },
451
721
  );
452
- if (active.ok) return { ok: true, owner: { ...owner, packagePath: active.path, version: active.version } };
453
- lastReason = active.reason;
722
+ if (active.ok) {
723
+ return { ok: true, owner: { ...owner, packagePath: active.path, version: active.version,
724
+ ...(globalStore ? { store: active.store, storePath: active.storePath, virtualStoreDirs: active.virtualStoreDirs, homeAnchor: active.homeAnchor } : {}) } };
725
+ }
726
+ lastReason = refusal(active.reason);
454
727
  }
455
- return { ok: false, reason: lastReason };
728
+ return { ok: false, reason: withRunningHint(lastReason) };
456
729
  }
457
730
 
458
731
  /**
@@ -474,6 +747,8 @@ export function runPnpmGlobalUpdate({
474
747
  platform = process.platform,
475
748
  log = () => {},
476
749
  }) {
750
+ // A store owner's refusals during the update carry the same cause and remedy as discovery's.
751
+ const storeOwnerRefusal = reason => owner?.globalStore === true && typeof reason === "string" ? reason + STORE_PROOF_HINT : reason;
477
752
  if (
478
753
  !owner?.commandPath
479
754
  || !owner?.globalDir
@@ -482,8 +757,14 @@ export function runPnpmGlobalUpdate({
482
757
  || !isAbsolutePath(owner.commandPath, platform)
483
758
  || !isAbsolutePath(owner.globalDir, platform)
484
759
  || !isAbsolutePath(owner.globalBinDir, platform)
760
+ || (owner.globalStore && (
761
+ !isAbsolutePath(owner.store, platform)
762
+ || !isAbsolutePath(owner.storePath, platform)
763
+ || !isAbsolutePath(owner.homeAnchor, platform)
764
+ || !Array.isArray(owner.virtualStoreDirs)))
765
+ || (!owner.globalStore && (owner.store !== undefined || owner.storePath !== undefined))
485
766
  ) {
486
- return { ok: false, phase: "preflight", error: "pnpm global owner was not pinned" };
767
+ return { ok: false, phase: "preflight", error: storeOwnerRefusal("pnpm global owner was not pinned") };
487
768
  }
488
769
  const constraints = {
489
770
  owner,
@@ -500,10 +781,13 @@ export function runPnpmGlobalUpdate({
500
781
  verify,
501
782
  { ...constraints, checkShims: false },
502
783
  );
503
- if (!before.ok) return { ok: false, phase: "preflight", error: before.reason };
784
+ if (!before.ok) return { ok: false, phase: "preflight", error: storeOwnerRefusal(before.reason) };
504
785
  if (currentVersion && before.version !== currentVersion) {
505
- return { ok: false, phase: "preflight", error: "pnpm's active package does not match the running package" };
786
+ return { ok: false, phase: "preflight", error: storeOwnerRefusal("pnpm's active package does not match the running package") };
506
787
  }
788
+ const identity = owner.globalStore ? pinStoreOwnerIdentity(owner) : null;
789
+ const identityRefusal = identity?.refusal();
790
+ if (identityRefusal) return { ok: false, phase: "preflight", error: storeOwnerRefusal(identityRefusal) };
507
791
 
508
792
  const requested = targetVersion || tag;
509
793
  const spec = packageSpec(packageName, requested);
@@ -525,6 +809,9 @@ export function runPnpmGlobalUpdate({
525
809
  verify,
526
810
  { ...constraints, expectedPackagePath: undefined },
527
811
  );
812
+ if (!after.ok && isStoreProofFailure(after.reason)) {
813
+ return { ok: false, phase: "install", rolledBack: false, error: storeOwnerRefusal(after.reason) };
814
+ }
528
815
  const targetMatches = after.ok && (!targetVersion || after.version === targetVersion);
529
816
  if (install?.status === 0 && targetMatches) {
530
817
  return {
@@ -541,7 +828,7 @@ export function runPnpmGlobalUpdate({
541
828
  ? `pnpm update failed (${statusText(install?.status)})`
542
829
  : after.ok
543
830
  ? "pnpm update produced an unexpected active package version"
544
- : "pnpm update completed but the active package failed verification";
831
+ : `pnpm update completed but the active package failed verification: ${after.reason}`;
545
832
 
546
833
  // A failed command may have left the original active group intact. Do not create a
547
834
  // second update transaction in that case; the verified previous package is already safe.
@@ -554,10 +841,24 @@ export function runPnpmGlobalUpdate({
554
841
  activePath: after.path,
555
842
  globalDir: owner.globalDir,
556
843
  globalBinDir: owner.globalBinDir,
557
- error: `${installReason}; previous version remains active`,
844
+ error: storeOwnerRefusal(`${installReason}; previous version remains active`),
558
845
  };
559
846
  }
560
847
 
848
+ // A failed listing says nothing about the effective store: bind it again before
849
+ // issuing a rollback mutation, independently of whether readback succeeded.
850
+ if (owner.globalStore) {
851
+ const rollbackStore = readPnpmStore(runPnpm, owner, platform);
852
+ if (!rollbackStore.ok) return { ok: false, phase: "rollback", rolledBack: false, error: storeOwnerRefusal(rollbackStore.reason) };
853
+ // The global group is the other root every link hop is confined to: a rollback must not write through a
854
+ // group that has gained a link component or lost its canonical spelling since discovery.
855
+ let groupRefusal;
856
+ try { groupRefusal = spellingRefusal(owner.globalRoot, "pnpm global group"); }
857
+ catch { groupRefusal = "pnpm global group could not be resolved"; }
858
+ if (groupRefusal) return { ok: false, phase: "rollback", rolledBack: false, error: storeOwnerRefusal(groupRefusal) };
859
+ const replaced = identity?.refusal();
860
+ if (replaced) return { ok: false, phase: "rollback", rolledBack: false, error: storeOwnerRefusal(replaced) };
861
+ }
561
862
  log(`Restoring ${packageName}@${before.version} with pnpm…`);
562
863
  let rollback;
563
864
  try {
@@ -582,9 +883,11 @@ export function runPnpmGlobalUpdate({
582
883
  activePath: restored.path,
583
884
  globalDir: owner.globalDir,
584
885
  globalBinDir: owner.globalBinDir,
585
- error: `${installReason}; previous version restored`,
886
+ error: storeOwnerRefusal(`${installReason}; previous version restored`),
586
887
  };
587
888
  }
889
+ // The readback's own reason (a store-proof failure included) leads, so the user sees why first.
890
+ const unverifiedPrefix = restored.ok || typeof restored.reason !== "string" ? "" : `${restored.reason}; `;
588
891
  return {
589
892
  ok: false,
590
893
  phase: "rollback",
@@ -593,6 +896,6 @@ export function runPnpmGlobalUpdate({
593
896
  ...(restored.ok ? { activePath: restored.path } : {}),
594
897
  globalDir: owner.globalDir,
595
898
  globalBinDir: owner.globalBinDir,
596
- error: `${installReason}; previous version could not be verified after rollback`,
899
+ error: storeOwnerRefusal(`${unverifiedPrefix}${installReason}; previous version could not be verified after rollback`),
597
900
  };
598
901
  }
@@ -0,0 +1,46 @@
1
+ /**
2
+ * pnpm's global virtual store keeps every package instance under
3
+ * `<store>/v<N>/links/...` (pnpm 11 `enableGlobalVirtualStore`). The spelling has one owner so
4
+ * install detection (`install-detection.mjs`) and the pnpm tree verifier
5
+ * (`transactional-install.mjs`) cannot drift apart: detection routed such installs to the pnpm
6
+ * updater while the verifier still rejected their dependency group (#8183).
7
+ *
8
+ * This module is a dependency-free leaf on purpose. `install-detection.mjs` is replaced by
9
+ * `mock.module` in update subprocess tests, so the verifier must not import its spelling from there.
10
+ */
11
+
12
+ /** Default store layout is sufficient for the legacy install-detection signature. */
13
+ export const PNPM_GLOBAL_STORE_LINKS_PATTERN = /(?:^|\/)store\/v\d+\/links(?:\/|$)/i;
14
+
15
+ /** Default spelling or custom layout corroborated by the pnpm store's contents. */
16
+ export function isInPnpmGlobalStoreLinks(path, exists = () => false) {
17
+ const normalized = String(path).replaceAll("\\", "/");
18
+ if (PNPM_GLOBAL_STORE_LINKS_PATTERN.test(normalized)) return true;
19
+ // Global link slots repeat package identity on both sides of node_modules.
20
+ // This identifies an unmarked custom store without treating a generic vN/links
21
+ // ancestor as pnpm evidence.
22
+ const instance = normalized.match(/(?:^|\/)v\d+\/links\/(@[^/]+)\/([^/]+)\/[^/]+\/(?:[^/]+\/)?node_modules\/(?:(@[^/]+)\/)?([^/]+)(?:\/|$)/i);
23
+ if (instance && instance[2].toLowerCase() === instance[4].toLowerCase()
24
+ && (instance[1] === "@" ? !instance[3] : instance[1].toLowerCase() === instance[3]?.toLowerCase())) return true;
25
+ const customStore = normalized.match(/^(.*\/v\d+)\/links\//i)?.[1];
26
+ return !!customStore && exists(`${customStore}/files`)
27
+ && ["index", "index.db", "index.fallback"].some(name => exists(`${customStore}/${name}`));
28
+ }
29
+
30
+ /**
31
+ * A configured alternate directory is evidence only when an enclosing store has pnpm markers. Every
32
+ * versioned ancestor above the package's node_modules is checked, so a nested v<N> directory inside a
33
+ * marked store cannot hide the markers of the store that encloses it.
34
+ */
35
+ export function isInMarkedPnpmCustomStore(path, exists = () => false) {
36
+ const normalized = String(path).replaceAll("\\", "/");
37
+ const lastModules = normalized.toLowerCase().lastIndexOf("/node_modules/");
38
+ if (lastModules < 0) return false;
39
+ const parts = normalized.slice(0, lastModules).split("/");
40
+ for (let index = 0; index < parts.length - 1; index += 1) {
41
+ if (!/^v\d+$/i.test(parts[index])) continue;
42
+ const store = parts.slice(0, index + 1).join("/");
43
+ if (exists(`${store}/files`) && ["index", "index.db", "index.fallback"].some(name => exists(`${store}/${name}`))) return true;
44
+ }
45
+ return false;
46
+ }
@@ -4,7 +4,8 @@ export type Acquisition = { kind: "acquired"; addDelegate(pid: number): void; re
4
4
  export declare function tryAcquireUpdateSyncMutex(home: string, kind: "sync" | "update", deps?: { now?: () => number; processAlive?: (pid: number) => boolean }): Acquisition;
5
5
  export declare function inspectUpdateSyncMutex(home: string): Holder;
6
6
  export declare function parentHoldsSyncMutex(home: string, claimedPid?: string): boolean;
7
- export declare function refuseSync(reason: "update-in-flight" | "sync-in-progress", args: readonly string[]): number;
7
+ export declare function refuseSync(reason: "update-in-flight" | "sync-in-progress", args: readonly string[], hint?: readonly string[]): number;
8
+ export declare function staleUpdateMarkerHint(home: string, platform?: NodeJS.Platform): string[];
8
9
  export declare function acquireSyncGuard(home: string, args: readonly string[]): { kind: "acquired"; addDelegate(pid: number): void; release(): void } | { kind: "refused"; exit: number };
9
- export declare function inspectUpdateMarker(home: string, deps?: { now?: () => number }): Observation;
10
+ export declare function inspectUpdateMarker(home: string, deps?: { now?: () => number; platform?: NodeJS.Platform; signal?: (id: number) => unknown; detail?: { witnessless?: boolean } }): Observation;
10
11
  export declare function isUpdateInFlight(home: string, deps?: { mutex(home: string): Holder; ownershipLease(home: string): Observation; marker(home: string): Observation }): boolean;