@bitkyc08/opencodex 2.93.0 → 2.95.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (582) hide show
  1. package/README.md +27 -8
  2. package/bin/ocx.mjs +215 -63
  3. package/gui/dist/assets/App-8yedBkhm.js +58 -0
  4. package/gui/dist/assets/App-B4j-Txmb.css +1 -0
  5. package/gui/dist/assets/Tray-erSMzxPG.js +1 -0
  6. package/gui/dist/assets/index-CHWwDo9L.css +1 -0
  7. package/gui/dist/assets/index-D7DCm5eQ.js +94 -0
  8. package/gui/dist/assets/quota-summary-BK4VuQNc.js +1 -0
  9. package/gui/dist/index.html +2 -2
  10. package/gui/dist/provider-icons/t3code.svg +4 -0
  11. package/package.json +7 -4
  12. package/src/adapters/anthropic/account-metadata.ts +34 -3
  13. package/src/adapters/anthropic/beta-allowlist.ts +5 -5
  14. package/src/adapters/anthropic/passthrough.ts +5 -2
  15. package/src/adapters/anthropic.ts +27 -7
  16. package/src/adapters/antigravity-refusal.ts +29 -0
  17. package/src/adapters/base.ts +11 -1
  18. package/src/adapters/client-fingerprint.ts +43 -9
  19. package/src/adapters/coding-agent/protocol.ts +19 -9
  20. package/src/adapters/command-code-project-context.ts +3 -3
  21. package/src/adapters/command-code.ts +4 -5
  22. package/src/adapters/cursor/catalog.ts +5 -3
  23. package/src/adapters/cursor/claude-id.ts +30 -19
  24. package/src/adapters/cursor/cursor-errors.ts +5 -2
  25. package/src/adapters/cursor/h2-pool.ts +9 -7
  26. package/src/adapters/cursor/http1-bidi.ts +1 -0
  27. package/src/adapters/cursor/live-models.ts +4 -2
  28. package/src/adapters/cursor.ts +4 -1
  29. package/src/adapters/devin/cloud-direct/chat.ts +18 -2
  30. package/src/adapters/google-antigravity-replay.ts +13 -2
  31. package/src/adapters/google-antigravity-wire.ts +8 -3
  32. package/src/adapters/google-errors.ts +33 -0
  33. package/src/adapters/google-http.ts +41 -16
  34. package/src/adapters/google-wire-compiler.ts +4 -0
  35. package/src/adapters/google.ts +21 -10
  36. package/src/adapters/kiro/adapter.ts +7 -1
  37. package/src/adapters/kiro/stream.ts +19 -13
  38. package/src/adapters/kiro-events.ts +1 -0
  39. package/src/adapters/openai-chat/completed-tool-blocks.ts +65 -0
  40. package/src/adapters/openai-chat/messages.ts +42 -17
  41. package/src/adapters/openai-chat/passthrough.ts +4 -2
  42. package/src/adapters/openai-chat/required-tool-result.ts +3 -3
  43. package/src/adapters/openai-chat/serialized-tool-call-content.ts +5 -0
  44. package/src/adapters/openai-chat/single-system.ts +24 -0
  45. package/src/adapters/openai-chat/wire.ts +9 -0
  46. package/src/adapters/openai-chat.ts +18 -17
  47. package/src/adapters/openai-responses/image-gen.ts +15 -1
  48. package/src/adapters/openai-responses/muse-tool-catalog.ts +87 -0
  49. package/src/adapters/openai-responses/passthrough.ts +53 -41
  50. package/src/adapters/openai-responses/prompt-cache.ts +3 -1
  51. package/src/adapters/openai-responses/request-strips.ts +23 -4
  52. package/src/adapters/openai-responses/tool-output-recovery.ts +21 -8
  53. package/src/adapters/openai-responses/tool-schema.ts +20 -8
  54. package/src/adapters/openai-responses/transport.ts +20 -2
  55. package/src/adapters/openai-responses/usage.ts +34 -0
  56. package/src/adapters/opencode-go-additional-tools.ts +39 -6
  57. package/src/adapters/qoder/adapter.ts +9 -15
  58. package/src/adapters/qoder/image-input.ts +52 -0
  59. package/src/adapters/routed-agent-messages.ts +3 -0
  60. package/src/adapters/unique-tool-call-ids.ts +2 -2
  61. package/src/adapters/xai-web-search.ts +6 -3
  62. package/src/adapters/zed-additional-tools.ts +51 -0
  63. package/src/adapters/zed-diagnostic-usage.ts +22 -0
  64. package/src/adapters/zed-json-tokens.ts +166 -0
  65. package/src/adapters/zed-openai-stream.ts +723 -0
  66. package/src/adapters/zed-tool-arguments.ts +79 -0
  67. package/src/adapters/zed.ts +48 -3
  68. package/src/advisor/consult.ts +39 -5
  69. package/src/advisor/runtime.ts +12 -3
  70. package/src/bridge/errors.ts +22 -1
  71. package/src/bridge/max-output-completion.ts +41 -0
  72. package/src/bridge/response-json.ts +13 -5
  73. package/src/bridge/sse.ts +34 -14
  74. package/src/chat/inbound.ts +13 -2
  75. package/src/chatgpt/app-server-shim/bundle-trust-async.ts +111 -0
  76. package/src/chatgpt/app-server-shim/bundle-trust-policy.ts +88 -0
  77. package/src/chatgpt/app-server-shim/bundle-trust.ts +15 -72
  78. package/src/chatgpt/app-server-shim/launcher.ts +40 -6
  79. package/src/claude/compatibility.ts +5 -1
  80. package/src/claude/desktop-3p.ts +27 -6
  81. package/src/claude/desktop-first-party.ts +16 -5
  82. package/src/claude/desktop-gateway-state.ts +4 -0
  83. package/src/claude/desktop-model-visibility.ts +141 -0
  84. package/src/claude/desktop-remote-store-io.ts +8 -8
  85. package/src/claude/inbound-content-options.ts +11 -1
  86. package/src/claude/inbound-tool-loading.ts +93 -0
  87. package/src/claude/intercept/picker-listener.ts +33 -1
  88. package/src/claude/intercept/proxy-auth.ts +16 -16
  89. package/src/claude/model-info.ts +29 -4
  90. package/src/claude/outbound.ts +33 -13
  91. package/src/cli/account-main.ts +44 -5
  92. package/src/cli/capabilities-base.ts +22 -5
  93. package/src/cli/capabilities-integrations.ts +4 -4
  94. package/src/cli/capabilities-provider-models.ts +7 -0
  95. package/src/cli/chatgpt-command.ts +1 -1
  96. package/src/cli/claude-desktop.ts +139 -98
  97. package/src/cli/codex-cli-update.ts +102 -48
  98. package/src/cli/codex-launch-auth.ts +93 -0
  99. package/src/cli/codex-launch-command.ts +32 -0
  100. package/src/cli/codex-launch-diagnostics.ts +37 -0
  101. package/src/cli/codex-launch-ownership.ts +307 -0
  102. package/src/cli/codex-launch-policy.ts +84 -0
  103. package/src/cli/codex-launcher.ts +322 -0
  104. package/src/cli/codex-shim-autorestore.ts +21 -1
  105. package/src/cli/config-command.ts +9 -4
  106. package/src/cli/config-mutation.ts +13 -0
  107. package/src/cli/dispatch.ts +19 -13
  108. package/src/cli/doctor.ts +5 -5
  109. package/src/cli/effort.ts +19 -14
  110. package/src/cli/ensure-desired-integrations.ts +21 -14
  111. package/src/cli/ensure-desktop-cold-start.ts +41 -10
  112. package/src/cli/export-command.ts +8 -4
  113. package/src/cli/help.ts +3 -1
  114. package/src/cli/index.ts +62 -73
  115. package/src/cli/init.ts +2 -2
  116. package/src/cli/integration-input.ts +12 -0
  117. package/src/cli/integration-plan-dto.ts +2 -0
  118. package/src/cli/integration-preview.ts +6 -3
  119. package/src/cli/integrations.ts +2 -1
  120. package/src/cli/internal-command.ts +29 -2
  121. package/src/cli/link-cleanup.ts +8 -23
  122. package/src/cli/link-enrollment.ts +1 -4
  123. package/src/cli/link.ts +1 -1
  124. package/src/cli/loopback-family.ts +2 -31
  125. package/src/cli/models.ts +62 -49
  126. package/src/cli/provider-cc-switch-import.ts +185 -0
  127. package/src/cli/provider.ts +151 -139
  128. package/src/cli/registry.ts +35 -3
  129. package/src/cli/restart-scope.ts +2 -2
  130. package/src/cli/root.ts +8 -6
  131. package/src/cli/start-owner-fence.ts +22 -3
  132. package/src/cli/status-link.ts +28 -0
  133. package/src/cli/status.ts +15 -0
  134. package/src/cli/stop-approval.ts +15 -1
  135. package/src/cli/stop-restore-guard.ts +48 -0
  136. package/src/cli/stop-restore.ts +117 -36
  137. package/src/cli/system-command.ts +2 -0
  138. package/src/cli/v2.ts +86 -23
  139. package/src/client/lifecycle-lock.ts +1 -1
  140. package/src/client/link-connection.ts +19 -0
  141. package/src/client/link-relay-transport.ts +25 -3
  142. package/src/client/link-tunnel.ts +10 -0
  143. package/src/client/machine-api.ts +2 -2
  144. package/src/client/machine-listener.ts +7 -1
  145. package/src/client/restore-ownership.ts +45 -0
  146. package/src/client/runtime.ts +13 -1
  147. package/src/client/state.ts +1 -1
  148. package/src/clients/client-ids.ts +7 -0
  149. package/src/clients/client-path.ts +13 -5
  150. package/src/clients/config-export/agent-clients.ts +3 -6
  151. package/src/clients/config-export/alias-selectors.ts +85 -0
  152. package/src/clients/config-export/contracts.ts +6 -25
  153. package/src/clients/config-export/dsh.ts +8 -1
  154. package/src/clients/config-export/model-metadata.ts +19 -0
  155. package/src/clients/config-export/model-names.ts +31 -0
  156. package/src/clients/config-export/qoder.ts +3 -11
  157. package/src/clients/config-export/t3code.ts +141 -0
  158. package/src/clients/config-export.ts +65 -18
  159. package/src/clients/gentle-shell-path.ts +3 -3
  160. package/src/codex/account-cooldown-response.ts +18 -0
  161. package/src/codex/account-lifecycle.ts +27 -13
  162. package/src/codex/account-store.ts +32 -6
  163. package/src/codex/app-server-processes.ts +84 -1
  164. package/src/codex/app-server-restart-service.ts +2 -2
  165. package/src/codex/auth-api/login-flow.ts +2 -2
  166. package/src/codex/auth-api/main-account-probe.ts +50 -11
  167. package/src/codex/auth-api/pool-mode-gate.ts +16 -8
  168. package/src/codex/auth-api/pool-quota-probe.ts +2 -2
  169. package/src/codex/auth-context.ts +49 -8
  170. package/src/codex/catalog/antigravity-discovery.ts +59 -0
  171. package/src/codex/catalog/build-entries.ts +12 -13
  172. package/src/codex/catalog/bundled.ts +67 -10
  173. package/src/codex/catalog/derive-entry.ts +2 -0
  174. package/src/codex/catalog/gather-capture.ts +3 -0
  175. package/src/codex/catalog/metadata.ts +10 -10
  176. package/src/codex/catalog/model-hints.ts +36 -4
  177. package/src/codex/catalog/native-omission.ts +28 -0
  178. package/src/codex/catalog/native-priority.ts +63 -0
  179. package/src/codex/catalog/native-template.ts +58 -0
  180. package/src/codex/catalog/parsing.ts +3 -29
  181. package/src/codex/catalog/provider-models.ts +22 -5
  182. package/src/codex/catalog/retained-sync.ts +16 -6
  183. package/src/codex/catalog/write-audit.ts +18 -18
  184. package/src/codex/chatgpt-refresh-failure.ts +2 -2
  185. package/src/codex/cli-install-provenance.ts +103 -74
  186. package/src/codex/cli-installation-identity.ts +1 -1
  187. package/src/codex/cli-installation-limits.ts +7 -0
  188. package/src/codex/cli-update-apply.ts +391 -0
  189. package/src/codex/cli-update-artifacts.ts +259 -0
  190. package/src/codex/cli-update-files.ts +100 -0
  191. package/src/codex/cli-update-inspection-context.ts +49 -0
  192. package/src/codex/cli-update-job-execution.ts +77 -0
  193. package/src/codex/cli-update-job-store-windows.ts +1082 -0
  194. package/src/codex/cli-update-job-worker.ts +385 -0
  195. package/src/codex/cli-update-job.ts +369 -0
  196. package/src/codex/cli-update-lease.ts +71 -0
  197. package/src/codex/cli-update-paths.ts +76 -0
  198. package/src/codex/cli-update-plan.ts +180 -47
  199. package/src/codex/cli-update-recovery.ts +282 -0
  200. package/src/codex/cli-update-selection-gate.ts +305 -0
  201. package/src/codex/cli-update-windows-apply.ts +308 -0
  202. package/src/codex/cli-update-windows-layout.ts +110 -0
  203. package/src/codex/cli-update-windows-observation.ts +91 -0
  204. package/src/codex/cli-update-windows-paths.ts +26 -0
  205. package/src/codex/cli-update-worker-recovery.ts +32 -0
  206. package/src/codex/cli-update-worker.ts +185 -0
  207. package/src/codex/cli-windows-plan-provenance.ts +268 -0
  208. package/src/codex/codex-home-owner.ts +9 -8
  209. package/src/codex/convergence.ts +13 -3
  210. package/src/codex/coordinator-doctor.ts +14 -8
  211. package/src/codex/desktop-app/handoff.ts +1 -1
  212. package/src/codex/desktop-app-restart.ts +32 -3
  213. package/src/codex/exec-boundary.ts +229 -0
  214. package/src/codex/forward-transport-headers.ts +80 -0
  215. package/src/codex/history-job.ts +7 -0
  216. package/src/codex/history-provider.ts +16 -12
  217. package/src/codex/history-worker.ts +20 -1
  218. package/src/codex/inject/bounded-config-reader.ts +14 -13
  219. package/src/codex/inject/restore.ts +57 -25
  220. package/src/codex/internal/history-writer.ts +2 -1
  221. package/src/codex/mac-app-bundle.ts +52 -0
  222. package/src/codex/main-account.ts +167 -29
  223. package/src/codex/native-main-auth-temp.ts +3 -2
  224. package/src/codex/native-main-lock-file.ts +13 -12
  225. package/src/codex/native-main-refresh-mode.ts +18 -3
  226. package/src/codex/native-profile-manager.ts +8 -6
  227. package/src/codex/native-profile-store.ts +9 -0
  228. package/src/codex/native-residue.ts +18 -14
  229. package/src/codex/ocx-compaction-history.ts +3 -2
  230. package/src/codex/orca-auth-source.ts +8 -7
  231. package/src/codex/prompt-text-probe.ts +211 -69
  232. package/src/codex/quota-types.ts +5 -0
  233. package/src/codex/quota.ts +58 -7
  234. package/src/codex/role-auto-assign.ts +50 -26
  235. package/src/codex/role-capability.ts +160 -0
  236. package/src/codex/role-model-history.ts +253 -0
  237. package/src/codex/role-sizing.ts +24 -6
  238. package/src/codex/routing/cooldown-math.ts +3 -2
  239. package/src/codex/runtime.ts +161 -72
  240. package/src/codex/shim-fingerprint.ts +11 -9
  241. package/src/codex/shim-inspect.ts +3 -2
  242. package/src/codex/shim-overlay.ts +22 -3
  243. package/src/codex/shim-restore-lock.ts +11 -14
  244. package/src/codex/shim-state-file.ts +22 -14
  245. package/src/codex/shim-templates.ts +5 -2
  246. package/src/codex/shim-wrapper-write.ts +137 -0
  247. package/src/codex/shim.ts +48 -126
  248. package/src/codex/transition-state.ts +5 -4
  249. package/src/codex/windows-cli-child-native.ts +119 -0
  250. package/src/codex/windows-cli-child-pipe.ts +87 -0
  251. package/src/codex/windows-cli-child.ts +260 -0
  252. package/src/codex/windows-cli-recovery-guardian.ts +89 -0
  253. package/src/codex/windows-cli-recovery.ts +39 -0
  254. package/src/codex/windows-installation-files.ts +52 -6
  255. package/src/codex/windows-npm-execution.ts +25 -0
  256. package/src/combos/failover.ts +127 -9
  257. package/src/combos/index.ts +1 -0
  258. package/src/combos/resolve.ts +60 -22
  259. package/src/config/atomic-write.ts +113 -29
  260. package/src/config/diagnostics.ts +21 -10
  261. package/src/config/initialize.ts +6 -6
  262. package/src/config/live-reconcile.ts +11 -3
  263. package/src/config/load-degrade.ts +2 -0
  264. package/src/config/owner-registry.ts +5 -4
  265. package/src/config/persist-unlocked.ts +34 -8
  266. package/src/config/persisted-mutation.ts +7 -0
  267. package/src/config/process-state.ts +32 -10
  268. package/src/config/removed-opencode-free-backup.ts +99 -0
  269. package/src/config/removed-opencode-free.ts +4 -8
  270. package/src/config/salvage.ts +2 -0
  271. package/src/config/schema/config-schema.ts +44 -1
  272. package/src/config/schema/leaf-validators.ts +22 -0
  273. package/src/config/schema/workflow-budget.ts +43 -0
  274. package/src/config/tracked-runtime-inspection.ts +188 -0
  275. package/src/config.ts +4 -4
  276. package/src/generated/compatibility-version.json +962 -434
  277. package/src/grok/inject.ts +2 -1
  278. package/src/grok/sync.ts +5 -2
  279. package/src/images/loop.ts +14 -5
  280. package/src/integrations/aside-profile-context.ts +1 -1
  281. package/src/integrations/catalog-refresh.ts +1 -1
  282. package/src/integrations/droid-settings.ts +4 -4
  283. package/src/integrations/hermes-profiles.ts +3 -3
  284. package/src/integrations/hermes-refresh.ts +28 -0
  285. package/src/integrations/model-name-guard.ts +31 -0
  286. package/src/integrations/mutation-plan.ts +17 -4
  287. package/src/integrations/ownership.ts +3 -0
  288. package/src/integrations/registry.ts +10 -1
  289. package/src/integrations/state.ts +6 -0
  290. package/src/integrations/writer.ts +64 -59
  291. package/src/lib/abort.ts +8 -4
  292. package/src/lib/bounded-body.ts +7 -1
  293. package/src/lib/bounded-file-read.ts +3 -9
  294. package/src/lib/bun-runtime-preflight.ts +9 -8
  295. package/src/lib/config-ownership.ts +4 -0
  296. package/src/lib/errors.ts +2 -0
  297. package/src/lib/eventstream-decoder.ts +3 -2
  298. package/src/lib/file-identity.ts +15 -0
  299. package/src/lib/http-response-semantics.ts +9 -6
  300. package/src/lib/inbound-body-policy.ts +11 -0
  301. package/src/lib/jsonc.ts +7 -2
  302. package/src/lib/local-chat-completion.ts +8 -6
  303. package/src/lib/local-destinations.ts +32 -3
  304. package/src/lib/local-management-capability.ts +3 -1
  305. package/src/lib/local-upstream.ts +22 -26
  306. package/src/lib/loopback-family.ts +31 -0
  307. package/src/lib/plain-data.ts +7 -5
  308. package/src/lib/process-control.ts +30 -5
  309. package/src/lib/redact-folding.ts +9 -0
  310. package/src/lib/shadow-call.ts +55 -1
  311. package/src/lib/spend-pool-alias-validation.ts +6 -6
  312. package/src/lib/state-store-registrations.ts +2 -0
  313. package/src/lib/test-home-guard.ts +37 -9
  314. package/src/lib/tool-argument-integers.ts +99 -7
  315. package/src/lib/upstream-retry.ts +6 -1
  316. package/src/lib/windows-elevation.ts +34 -11
  317. package/src/lib/windows-owner-acl.ts +272 -32
  318. package/src/lib/windows-secret-acl.ts +328 -44
  319. package/src/lib/windows-service-wrappers.ts +10 -7
  320. package/src/lib/winsw.ts +8 -4
  321. package/src/lib/workflow-budget-config.ts +39 -0
  322. package/src/link/relay-auth.ts +38 -1
  323. package/src/link/remote-platform.ts +11 -23
  324. package/src/link/remote-probe.ts +3 -1
  325. package/src/link/remote-windows.ts +150 -0
  326. package/src/link/ssh-argv.ts +13 -5
  327. package/src/link/store.ts +4 -1
  328. package/src/link/supervisor.ts +9 -0
  329. package/src/local-credentials/generation.ts +242 -0
  330. package/src/local-credentials/inventory.ts +405 -0
  331. package/src/local-credentials/observation-lease.ts +83 -0
  332. package/src/local-credentials/publication-fence.ts +81 -0
  333. package/src/local-credentials/references.ts +36 -0
  334. package/src/local-credentials/runtime-observation.ts +28 -0
  335. package/src/messaging/remote-forward-failure.ts +35 -0
  336. package/src/messaging/remote-ports.ts +27 -5
  337. package/src/messaging/remote-process.ts +30 -4
  338. package/src/messaging/remote-tunnels.ts +80 -15
  339. package/src/oauth/account-auto-pause-policy.ts +11 -0
  340. package/src/oauth/anthropic-account-refusal.ts +1 -0
  341. package/src/oauth/anthropic-rate-limit-policy.ts +26 -2
  342. package/src/oauth/anthropic-routing.ts +34 -44
  343. package/src/oauth/anthropic-session-affinity-store.ts +177 -0
  344. package/src/oauth/antigravity-discovery-diagnostics.ts +65 -0
  345. package/src/oauth/chatgpt.ts +11 -9
  346. package/src/oauth/cursor.ts +8 -2
  347. package/src/oauth/generic-account-failover.ts +33 -2
  348. package/src/oauth/generic-session-affinity.ts +7 -0
  349. package/src/oauth/google-antigravity.ts +49 -12
  350. package/src/oauth/index.ts +3 -0
  351. package/src/oauth/kiro-device-login.ts +87 -30
  352. package/src/oauth/kiro-iam-identity-center.ts +107 -0
  353. package/src/oauth/store.ts +41 -11
  354. package/src/protocols/encoders/adapter-events.ts +7 -4
  355. package/src/protocols/encoders/messages.ts +1 -1
  356. package/src/providers/account-quota-disk.ts +18 -4
  357. package/src/providers/antigravity-account-roster.ts +73 -7
  358. package/src/providers/antigravity-models.ts +8 -4
  359. package/src/providers/api-key-resolve.ts +16 -3
  360. package/src/providers/cc-switch-import-bytes.ts +991 -0
  361. package/src/providers/cc-switch-import-source.ts +1083 -0
  362. package/src/providers/cc-switch-import.ts +942 -0
  363. package/src/providers/claude-cli-identity.ts +2 -0
  364. package/src/providers/codex-capacity.ts +3 -2
  365. package/src/providers/derive.ts +6 -0
  366. package/src/providers/free-directory.ts +10 -2
  367. package/src/providers/key-store.ts +7 -2
  368. package/src/providers/model-discovery-diagnostic.ts +4 -0
  369. package/src/providers/model-discovery.ts +4 -4
  370. package/src/providers/model-rename-fields.ts +2 -0
  371. package/src/providers/model-rename-migration.ts +41 -6
  372. package/src/providers/provider-id-rewrite.ts +3 -0
  373. package/src/providers/quota/antigravity.ts +6 -4
  374. package/src/providers/quota/report-cache.ts +17 -4
  375. package/src/providers/quota/vendor-probes-oauth.ts +0 -1
  376. package/src/providers/quota.ts +2 -2
  377. package/src/providers/reasoning-metadata.ts +31 -15
  378. package/src/providers/registry/entries-core.ts +1 -1
  379. package/src/providers/registry/entries-extended.ts +1 -1
  380. package/src/providers/registry/model-ids.ts +1 -0
  381. package/src/providers/registry/model-seeds.ts +2 -1
  382. package/src/providers/registry/types.ts +3 -1
  383. package/src/providers/resolved-model-policy.ts +2 -2
  384. package/src/providers/routed-config.ts +2 -0
  385. package/src/providers/stale-model-roster-migration.ts +8 -1
  386. package/src/providers/xai-transport.ts +4 -4
  387. package/src/quota-pool/assemble.ts +51 -21
  388. package/src/quota-pool/pooled.ts +162 -0
  389. package/src/remote-control/workspace-codex-runtime.ts +63 -20
  390. package/src/remote-control/workspace-executor.ts +14 -13
  391. package/src/responses/apply-patch-envelope.ts +35 -0
  392. package/src/responses/compaction-history-framing.ts +15 -4
  393. package/src/responses/custom-tool-compat.ts +2 -1
  394. package/src/responses/item-provenance.ts +79 -0
  395. package/src/responses/namespace-tool-compat.ts +21 -3
  396. package/src/responses/turn-membership.ts +111 -0
  397. package/src/router.ts +21 -2
  398. package/src/routing/analytics.ts +3 -5
  399. package/src/routing/fallback-policy.ts +7 -3
  400. package/src/routing/health.ts +5 -3
  401. package/src/routing/history/build-file.ts +6 -0
  402. package/src/routing/history/indexer.ts +158 -31
  403. package/src/routing/history/ingest.ts +1 -1
  404. package/src/routing/history/integrity.ts +208 -0
  405. package/src/routing/history/rebuild-job.ts +20 -6
  406. package/src/routing/history/rebuild-protocol.ts +2 -1
  407. package/src/routing/history/rebuild-worker.ts +18 -0
  408. package/src/routing/history/sqlite-errors.ts +9 -0
  409. package/src/server/admission-model-scope.ts +21 -4
  410. package/src/server/advisor-admission-scope.ts +72 -0
  411. package/src/server/audio-upstream.ts +10 -2
  412. package/src/server/auth-cors.ts +28 -2
  413. package/src/server/bind-host.ts +5 -0
  414. package/src/server/capture-admission-policy.ts +91 -0
  415. package/src/server/chat-completions.ts +47 -6
  416. package/src/server/chat-native.ts +16 -11
  417. package/src/server/claude-messages.ts +99 -3
  418. package/src/server/codex-model-list.ts +47 -0
  419. package/src/server/configured-credentials.ts +5 -0
  420. package/src/server/gui-session.ts +5 -2
  421. package/src/server/inbound-body-admission.ts +21 -13
  422. package/src/server/inbound-body-budget.ts +128 -0
  423. package/src/server/index/link-listener.ts +3 -1
  424. package/src/server/index/link-relay-sessions.ts +9 -2
  425. package/src/server/index/optional-listeners.ts +1 -0
  426. package/src/server/index/serve-options.ts +21 -45
  427. package/src/server/index/websocket-handler.ts +10 -0
  428. package/src/server/index.ts +6 -5
  429. package/src/server/inference/client-encoder-delivery.ts +3 -1
  430. package/src/server/lifecycle.ts +8 -1
  431. package/src/server/management/advisor-routes.ts +26 -9
  432. package/src/server/management/agent-settings-routes.ts +455 -549
  433. package/src/server/management/anthropic-reset-grant-routes.ts +2 -1
  434. package/src/server/management/claude-code-settings-patch.ts +211 -0
  435. package/src/server/management/claude-desktop-config-writers.ts +78 -0
  436. package/src/server/management/codex-agent-role-routes.ts +80 -2
  437. package/src/server/management/codex-cli-update-routes.ts +55 -0
  438. package/src/server/management/codex-prompt-routes.ts +2 -1
  439. package/src/server/management/codex-role-auto-assign.ts +50 -6
  440. package/src/server/management/config-routes.ts +459 -384
  441. package/src/server/management/consent-session.ts +6 -0
  442. package/src/server/management/context.ts +3 -0
  443. package/src/server/management/desktop-compatibility-authorization.ts +12 -0
  444. package/src/server/management/desktop-compatibility-routes.ts +3 -2
  445. package/src/server/management/desktop-compatibility-runtime-routes.ts +2 -1
  446. package/src/server/management/desktop-compatibility-settings-routes.ts +2 -1
  447. package/src/server/management/integration-routes.ts +45 -5
  448. package/src/server/management/link-enrollment.ts +21 -32
  449. package/src/server/management/link-route-state.ts +1 -0
  450. package/src/server/management/link-routes.ts +4 -1
  451. package/src/server/management/model-routes.ts +22 -6
  452. package/src/server/management/model-rows.ts +3 -1
  453. package/src/server/management/native-integration-routes.ts +112 -38
  454. package/src/server/management/oauth-account-routes.ts +28 -11
  455. package/src/server/management/provider-overwrite-carry.ts +21 -0
  456. package/src/server/management/provider-routes.ts +3 -1
  457. package/src/server/management/route-registry.ts +10 -3
  458. package/src/server/management/session-routes.ts +20 -2
  459. package/src/server/management/shadow-call-validation.ts +43 -2
  460. package/src/server/management/shared.ts +17 -1
  461. package/src/server/management/sidebar-routes.ts +2 -1
  462. package/src/server/management/system-restart.ts +47 -7
  463. package/src/server/management/workflow-budget-routes.ts +70 -3
  464. package/src/server/management-api.ts +61 -51
  465. package/src/server/management-auth.ts +11 -3
  466. package/src/server/messages-native-eligibility.ts +6 -5
  467. package/src/server/messages-native-scope.ts +6 -1
  468. package/src/server/messages-native.ts +21 -7
  469. package/src/server/messages-shared.ts +161 -29
  470. package/src/server/persistent-gui-session.ts +155 -0
  471. package/src/server/port-reclaim.ts +29 -5
  472. package/src/server/proxy-liveness.ts +110 -33
  473. package/src/server/request-decompress.ts +5 -1
  474. package/src/server/request-log.ts +30 -2
  475. package/src/server/responses/account-change-state.ts +14 -2
  476. package/src/server/responses/adapter-continuation.ts +5 -4
  477. package/src/server/responses/adapter-delivery.ts +24 -5
  478. package/src/server/responses/adapter-dispatch.ts +39 -45
  479. package/src/server/responses/advisor-plan-slot.ts +7 -0
  480. package/src/server/responses/advisor-slot.ts +77 -48
  481. package/src/server/responses/antigravity-model-denial-recovery.ts +70 -0
  482. package/src/server/responses/antigravity-validation-refusal.ts +6 -0
  483. package/src/server/responses/codex-auth-error.ts +5 -1
  484. package/src/server/responses/combo-required-tool-contract.ts +29 -1
  485. package/src/server/responses/combo-required-tool-fulfillments.ts +58 -0
  486. package/src/server/responses/combo-required-tool-stream.ts +119 -0
  487. package/src/server/responses/combo-stream-preflight.ts +47 -7
  488. package/src/server/responses/compact.ts +18 -8
  489. package/src/server/responses/compaction-recovery.ts +2 -1
  490. package/src/server/responses/core-auth.ts +2 -1
  491. package/src/server/responses/core-codex-account.ts +1 -0
  492. package/src/server/responses/core-combo-failure.ts +13 -6
  493. package/src/server/responses/core-combo-native.ts +6 -5
  494. package/src/server/responses/core-combo.ts +159 -25
  495. package/src/server/responses/core-lifetime.ts +4 -0
  496. package/src/server/responses/core-options.ts +16 -0
  497. package/src/server/responses/core.ts +2 -0
  498. package/src/server/responses/fetch-helpers.ts +5 -1
  499. package/src/server/responses/jev-model-invoke.ts +10 -3
  500. package/src/server/responses/memory-models.ts +3 -2
  501. package/src/server/responses/passthrough-delivery.ts +36 -8
  502. package/src/server/responses/passthrough-dispatch.ts +17 -16
  503. package/src/server/responses/policy-fallback.ts +2 -0
  504. package/src/server/responses/request-prepare.ts +14 -6
  505. package/src/server/responses/request-send-budget.ts +2 -1
  506. package/src/server/responses/request-sidecar-auth.ts +1 -0
  507. package/src/server/responses/request-transport.ts +43 -9
  508. package/src/server/responses/run-turn-execution.ts +15 -3
  509. package/src/server/responses/sidecar-execution.ts +26 -5
  510. package/src/server/responses/turn-membership.ts +30 -0
  511. package/src/server/responses-custom-tool-repair.ts +86 -11
  512. package/src/server/responses-image-gen-repair.ts +1 -1
  513. package/src/server/responses-snapshot-repair.ts +18 -4
  514. package/src/server/responses-undeclared-tool-guard.ts +4 -0
  515. package/src/server/restart-parent-ownership.ts +49 -0
  516. package/src/server/stop-teardown.ts +46 -9
  517. package/src/server/windows-tcp-drop.ts +4 -2
  518. package/src/server/workflow-refusal.ts +2 -1
  519. package/src/service/desktop-recovery-process.ts +341 -0
  520. package/src/service/desktop-recovery.ts +172 -0
  521. package/src/service/state-lock.ts +12 -11
  522. package/src/service/windows-ops.ts +6 -3
  523. package/src/service/windows-scheduler.ts +29 -6
  524. package/src/service-manager-probe.ts +53 -8
  525. package/src/stall-timeout.ts +47 -0
  526. package/src/tray/windows.ts +6 -4
  527. package/src/types/admission-policy.ts +13 -0
  528. package/src/types/config.ts +86 -10
  529. package/src/types/provider.ts +10 -0
  530. package/src/types/request.ts +8 -1
  531. package/src/types.ts +2 -0
  532. package/src/update/async-check.ts +4 -3
  533. package/src/update/bind-probe.ts +2 -2
  534. package/src/update/codex-cli-update-launch-policy.mjs +9 -0
  535. package/src/update/guarded-port-reclaim.ts +14 -0
  536. package/src/update/guarded-runtime-ops.ts +58 -0
  537. package/src/update/guarded-tray-ops.ts +9 -0
  538. package/src/update/index.ts +196 -58
  539. package/src/update/job-pinned-start.ts +53 -0
  540. package/src/update/job-supervised-restart.ts +23 -6
  541. package/src/update/job-update-home.ts +62 -0
  542. package/src/update/job-update-tray.ts +29 -0
  543. package/src/update/job-windows-restart.ts +39 -0
  544. package/src/update/job.ts +199 -193
  545. package/src/update/mutation-guard.d.mts +30 -0
  546. package/src/update/mutation-guard.mjs +103 -0
  547. package/src/update/notify.ts +2 -2
  548. package/src/update/npm-cache-preflight.mjs +4 -4
  549. package/src/update/npm-install.mjs +5 -3
  550. package/src/update/pnpm-read-policy.mjs +3 -2
  551. package/src/update/proxy-liveness-probe.mjs +2 -2
  552. package/src/update/service-home-authority.ts +35 -0
  553. package/src/update/service-home-package-only-protocol.json +1 -0
  554. package/src/update/service-home-policy.d.mts +25 -0
  555. package/src/update/service-home-policy.mjs +112 -0
  556. package/src/update/service-home-probe-entry.ts +9 -0
  557. package/src/update/service-home-probe.d.mts +15 -0
  558. package/src/update/service-home-probe.mjs +79 -0
  559. package/src/update/service-home-protocol.json +1 -0
  560. package/src/update/supervised-recovery.d.mts +2 -2
  561. package/src/update/supervised-recovery.mjs +14 -7
  562. package/src/update/transactional-install.d.mts +3 -1
  563. package/src/update/transactional-install.mjs +29 -19
  564. package/src/update/update-failure-guidance.mjs +1 -1
  565. package/src/update/worker-launch.ts +74 -4
  566. package/src/usage/log.ts +25 -4
  567. package/src/vision/anthropic-describe.ts +2 -1
  568. package/src/vision/index.ts +2 -0
  569. package/src/vision/plan.ts +4 -0
  570. package/src/vision/routed-describe.ts +38 -23
  571. package/src/web-search/anthropic-executor.ts +2 -1
  572. package/src/web-search/anthropic-history.ts +1 -0
  573. package/src/web-search/format-result.ts +3 -2
  574. package/src/web-search/header-deadline.ts +3 -2
  575. package/src/web-search/loop.ts +113 -12
  576. package/src/web-search/parse.ts +201 -40
  577. package/gui/dist/assets/App-CizjBqyk.js +0 -58
  578. package/gui/dist/assets/App-DMps4OLk.css +0 -1
  579. package/gui/dist/assets/Tray-DamiMqcX.js +0 -1
  580. package/gui/dist/assets/index-DQsht3vH.js +0 -94
  581. package/gui/dist/assets/index-DRe8Hhfz.css +0 -1
  582. package/gui/dist/assets/quota-summary-BXu4zE8H.js +0 -1
@@ -4,19 +4,23 @@
4
4
  *
5
5
  * Tier of a candidate model, first rule that applies:
6
6
  * 1. codexRoleTiers in the opencodex config lists it under fast, standard or frontier.
7
- * 2. It has a known price. Priced candidates are ranked by input plus output USD per 1M tokens.
7
+ * 2. At least two candidates have a measured score in the role's task domain. Measured candidates
8
+ * are ranked by that score and split across the tiers the same way price splits them below;
9
+ * unmeasured ones are left out rather than placed among measured ones by price.
10
+ * 3. It has a known price. Priced candidates are ranked by input plus output USD per 1M tokens.
8
11
  * Three or more split evenly across the three tiers by rank, cheapest in fast. Fewer than three
9
12
  * cannot fill every tier, so the ranking is anchored at the top: the dearest is frontier,
10
13
  * because it is the strongest model on offer, and each cheaper one sits one tier lower. One
11
14
  * priced model is frontier; two are standard and frontier. The tier left empty is fast, so a
12
15
  * fast role steps up to the cheapest model and a standard role keeps it instead of jumping to
13
16
  * the dearest, which keeps every role on the cheapest sufficient model on offer.
14
- * 3. Otherwise it is unclassified and never proposed.
17
+ * 4. Otherwise it is unclassified and never proposed.
15
18
  *
16
19
  * A role gets the cheapest sufficient model: the lowest tier at or above what it was sized for,
17
- * then the lowest price, then the model the role already uses when it is one of the tied models,
18
- * then the picker's own order. The picker lists native models first, so without the current-model
19
- * step a role on a routed model moved to a native one priced and tiered the same.
20
+ * then the lowest price, then the higher measured score, then the model the role already uses when
21
+ * it is one of the tied models, then the picker's own order. The picker lists native models first,
22
+ * so without the current-model step a role on a routed model moved to a native one priced and
23
+ * tiered the same.
20
24
  *
21
25
  * Effort binds to positions on the chosen model's ladder: glance is the floor, measured is the
22
26
  * model's default or the middle rung, exhaustive is the ceiling, and thorough is the rung above
@@ -25,7 +29,7 @@
25
29
  * above wins because thorough asks for more than the everyday setting. Nothing resolves outside
26
30
  * the ladder.
27
31
  */
28
- import { SIZING_TIERS, type RoleSizingOutcome, type SizingEffort, type SizingTier } from "./role-sizing";
32
+ import { SIZING_TIERS, type RoleSizingOutcome, type SizingDomain, type SizingEffort, type SizingTier } from "./role-sizing";
29
33
  import { CODEX_REASONING_LEVELS } from "../reasoning-effort";
30
34
 
31
35
  export type RoleTierMapping = Partial<Record<SizingTier, readonly string[]>>;
@@ -40,7 +44,9 @@ export interface RoleModelCandidate {
40
44
 
41
45
  export interface ClassifiedCandidate extends RoleModelCandidate {
42
46
  readonly tier: SizingTier | null;
43
- readonly tierSource: "mapping" | "price" | null;
47
+ readonly tierSource: "mapping" | "measured" | "price" | null;
48
+ /** The measured score the tier came from, or null when it came from elsewhere. */
49
+ readonly score: number | null;
44
50
  }
45
51
 
46
52
  const LADDER_ORDER = ["none", "minimal", ...CODEX_REASONING_LEVELS.map(level => level.effort)];
@@ -66,33 +72,45 @@ export function mapEffortToLevel(intent: SizingEffort, efforts: readonly string[
66
72
  }
67
73
  }
68
74
 
75
+ /** Split items ranked weakest first across the tiers; fewer than three are anchored at the top. */
76
+ function tierByRank<T>(ranked: readonly T[]): Map<T, SizingTier> {
77
+ const top = SIZING_TIERS.length - 1;
78
+ return new Map(ranked.map((item, rank) => [item, SIZING_TIERS[ranked.length < SIZING_TIERS.length
79
+ ? top - (ranked.length - 1 - rank)
80
+ : Math.round((rank * top) / (ranked.length - 1))]!]));
81
+ }
82
+
69
83
  export function classifyRoleModelCandidates(
70
84
  candidates: readonly RoleModelCandidate[],
71
85
  mapping: RoleTierMapping = {},
86
+ measured: ReadonlyMap<string, number> = new Map(),
72
87
  ): ClassifiedCandidate[] {
73
88
  const mapped = new Map<string, SizingTier>();
74
89
  for (const tier of SIZING_TIERS) {
75
90
  for (const model of mapping[tier] ?? []) if (!mapped.has(model)) mapped.set(model, tier);
76
91
  }
77
- const priced = candidates
78
- .map((candidate, order) => ({ candidate, order }))
79
- .filter(({ candidate }) => !mapped.has(candidate.model) && candidate.unitPrice !== null)
80
- .sort((a, b) => a.candidate.unitPrice! - b.candidate.unitPrice! || a.order - b.order);
81
- const byPrice = new Map<string, SizingTier>();
82
- priced.forEach(({ candidate }, rank) => {
83
- const top = SIZING_TIERS.length - 1;
84
- const index = priced.length < SIZING_TIERS.length
85
- ? top - (priced.length - 1 - rank)
86
- : Math.round((rank * top) / (priced.length - 1));
87
- byPrice.set(candidate.model, SIZING_TIERS[index]!);
88
- });
92
+ const unmapped = candidates.filter(candidate => !mapped.has(candidate.model));
93
+ const scored = unmapped.filter(candidate => measured.has(candidate.model));
94
+ const scoreTiers = tierByRank([...new Set(scored.map(candidate => measured.get(candidate.model)!))].sort((a, b) => a - b));
95
+ const byScore = scored.length >= 2
96
+ ? new Map(scored.map(candidate => [candidate.model, scoreTiers.get(measured.get(candidate.model)!)!] as const))
97
+ : new Map<string, SizingTier>();
98
+ const byPrice = byScore.size > 0
99
+ ? new Map<string, SizingTier>()
100
+ : tierByRank(unmapped
101
+ .map((candidate, order) => ({ candidate, order }))
102
+ .filter(({ candidate }) => candidate.unitPrice !== null)
103
+ .sort((a, b) => a.candidate.unitPrice! - b.candidate.unitPrice! || a.order - b.order)
104
+ .map(({ candidate }) => candidate.model));
89
105
  return candidates.map(candidate => {
90
106
  const fromMapping = mapped.get(candidate.model);
91
- if (fromMapping) return { ...candidate, tier: fromMapping, tierSource: "mapping" as const };
107
+ if (fromMapping) return { ...candidate, tier: fromMapping, tierSource: "mapping" as const, score: null };
108
+ const fromScore = byScore.get(candidate.model);
109
+ if (fromScore) return { ...candidate, tier: fromScore, tierSource: "measured" as const, score: measured.get(candidate.model)! };
92
110
  const fromPrice = byPrice.get(candidate.model);
93
111
  return fromPrice
94
- ? { ...candidate, tier: fromPrice, tierSource: "price" as const }
95
- : { ...candidate, tier: null, tierSource: null };
112
+ ? { ...candidate, tier: fromPrice, tierSource: "price" as const, score: null }
113
+ : { ...candidate, tier: null, tierSource: null, score: null };
96
114
  });
97
115
  }
98
116
 
@@ -107,6 +125,7 @@ export function cheapestSufficientCandidate(
107
125
  .filter(entry => entry.rank >= need)
108
126
  .sort((a, b) => a.rank - b.rank
109
127
  || (a.candidate.unitPrice ?? Infinity) - (b.candidate.unitPrice ?? Infinity)
128
+ || (b.candidate.score ?? -Infinity) - (a.candidate.score ?? -Infinity)
110
129
  || Number(b.candidate.model === current) - Number(a.candidate.model === current)
111
130
  || a.order - b.order);
112
131
  return ranked[0]?.candidate ?? null;
@@ -123,10 +142,13 @@ export type RoleProposal = RoleProposalInput & (
123
142
  readonly status: "proposed" | "unassigned";
124
143
  readonly tier: SizingTier;
125
144
  readonly effortIntent: SizingEffort;
145
+ readonly domain: SizingDomain;
126
146
  readonly rationale: string;
127
147
  readonly moveUpIf: string;
128
148
  readonly moveDownIf: string;
129
149
  readonly proposedModel: string | null;
150
+ /** Where the picked model's tier came from: a user mapping, a measured score, or price rank. */
151
+ readonly tierSource: ClassifiedCandidate["tierSource"];
130
152
  /** The sized effort on the picked model's ladder; null only when that model has no ladder. */
131
153
  readonly proposedEffort: string | null;
132
154
  readonly reason: string | null;
@@ -138,23 +160,25 @@ export function buildRoleProposals(
138
160
  roles: readonly RoleProposalInput[],
139
161
  sizing: ReadonlyMap<string, RoleSizingOutcome>,
140
162
  classified: readonly ClassifiedCandidate[],
163
+ classifiedByDomain: ReadonlyMap<SizingDomain, readonly ClassifiedCandidate[]> = new Map(),
141
164
  ): RoleProposal[] {
142
165
  return roles.map(role => {
143
166
  const outcome = sizing.get(role.role) ?? { unsized: "the role was not sized" };
144
167
  if ("unsized" in outcome) return { ...role, status: "unsized", reason: outcome.unsized };
145
- const { tier, effort, rationale, moveUpIf, moveDownIf } = outcome.sizing;
146
- const pick = cheapestSufficientCandidate(classified, tier, role.model);
147
- const sized = { ...role, tier, effortIntent: effort, rationale, moveUpIf, moveDownIf };
168
+ const { tier, effort, domain, rationale, moveUpIf, moveDownIf } = outcome.sizing;
169
+ const pick = cheapestSufficientCandidate(classifiedByDomain.get(domain) ?? classified, tier, role.model);
170
+ const sized = { ...role, tier, effortIntent: effort, domain, rationale, moveUpIf, moveDownIf };
148
171
  if (!pick) {
149
172
  return {
150
173
  ...sized,
151
174
  status: "unassigned",
152
175
  proposedModel: null,
176
+ tierSource: null,
153
177
  proposedEffort: null,
154
178
  reason: `no available model is classified ${tier} or above`,
155
179
  };
156
180
  }
157
181
  const proposedEffort = mapEffortToLevel(effort, pick.efforts, pick.defaultEffort);
158
- return { ...sized, status: "proposed", proposedModel: pick.model, proposedEffort, reason: null };
182
+ return { ...sized, status: "proposed", proposedModel: pick.model, tierSource: pick.tierSource, proposedEffort, reason: null };
159
183
  });
160
184
  }
@@ -0,0 +1,160 @@
1
+ /**
2
+ * Measured capability per task domain, so role auto-assign can tier candidates by what they score
3
+ * instead of what they cost. Artificial Analysis is read live when configured:
4
+ *
5
+ * - Artificial Analysis (https://artificialanalysis.ai/api-reference), when the user configures
6
+ * their own API key. Its terms allow that user's internal use with attribution and forbid
7
+ * redistributing the raw data, so its scores never leave this process.
8
+ *
9
+ * Each domain maps to one published index. The source names a model by display name
10
+ * with one row per reasoning setting ("Claude Opus 5.5 (High)"); capabilityModelKey drops the
11
+ * setting and folds the rest to a slug, which matches a catalog id once its provider prefix is
12
+ * gone ("cpa/claude-opus-5-5"). The best setting's score stands for the model, since a role can
13
+ * be given that setting. A candidate with no row is unmeasured, never guessed.
14
+ */
15
+ import { resolveProviderApiKey } from "../providers/api-key-resolve";
16
+ import type { OcxConfig } from "../types";
17
+ import type { SizingDomain } from "./role-sizing";
18
+
19
+ export interface CapabilitySource {
20
+ readonly name: string;
21
+ readonly url: string;
22
+ readonly license: string;
23
+ /** Whether the terms let a response carry the raw scores. */
24
+ readonly redistributable: boolean;
25
+ }
26
+
27
+ export const ARTIFICIAL_ANALYSIS_SOURCE: CapabilitySource = {
28
+ name: "Artificial Analysis",
29
+ url: "https://artificialanalysis.ai",
30
+ license: "Artificial Analysis API terms: internal use, attribution required, no redistribution",
31
+ redistributable: false,
32
+ };
33
+
34
+ const ARTIFICIAL_ANALYSIS_URL = "https://artificialanalysis.ai/api/v2/data/llms/models";
35
+
36
+ /** Per domain, the indexes to read in order; the first one the response carries is used. */
37
+ const INTELLIGENCE_INDEX = "artificial_analysis_intelligence_index";
38
+ const ARTIFICIAL_ANALYSIS_INDEXES: Record<SizingDomain, readonly string[]> = {
39
+ coding: ["artificial_analysis_coding_index", INTELLIGENCE_INDEX],
40
+ agentic: ["artificial_analysis_agentic_index", INTELLIGENCE_INDEX],
41
+ reasoning: ["artificial_analysis_math_index", INTELLIGENCE_INDEX],
42
+ writing: [INTELLIGENCE_INDEX],
43
+ knowledge: [INTELLIGENCE_INDEX],
44
+ general: [INTELLIGENCE_INDEX],
45
+ };
46
+
47
+ const FETCH_TIMEOUT_MS = 30_000;
48
+ /** Each published table is under 1 MB today; 16 MB leaves room to grow and still bounds memory. */
49
+ export const MAX_TABLE_BYTES = 16 * 1024 * 1024;
50
+
51
+ export interface CapabilityTable {
52
+ readonly source: CapabilitySource | null;
53
+ readonly publishedAt: string | null;
54
+ /** Per domain: model key to its best published score. */
55
+ readonly domains: Partial<Record<SizingDomain, ReadonlyMap<string, number>>>;
56
+ /** Why a configured source was passed over for this one. */
57
+ readonly fallbackReason?: string;
58
+ }
59
+
60
+ export type LoadCapability = (config: OcxConfig) => Promise<CapabilityTable>;
61
+
62
+ export function capabilityModelKey(name: string): string {
63
+ return name.toLowerCase().replace(/\([^)]*\)/g, " ").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
64
+ }
65
+
66
+ export function candidateModelKey(slug: string): string {
67
+ return capabilityModelKey(slug.slice(slug.lastIndexOf("/") + 1));
68
+ }
69
+
70
+ function keepBest(scores: Map<string, number>, key: string, value: number) {
71
+ if (key) scores.set(key, Math.max(value, scores.get(key) ?? -Infinity));
72
+ }
73
+
74
+ export function capabilityTableFromArtificialAnalysis(body: unknown): CapabilityTable {
75
+ const rows = (body as { data?: unknown } | null)?.data;
76
+ if (!Array.isArray(rows)) throw new Error("Artificial Analysis returned no model list");
77
+ const domains: Partial<Record<SizingDomain, Map<string, number>>> = {};
78
+ for (const [domain, indexes] of Object.entries(ARTIFICIAL_ANALYSIS_INDEXES) as [SizingDomain, readonly string[]][]) {
79
+ for (const index of indexes) {
80
+ const scores = new Map<string, number>();
81
+ for (const row of rows as Record<string, unknown>[]) {
82
+ const value = (row?.evaluations as Record<string, unknown> | undefined)?.[index];
83
+ if (typeof value !== "number" || !Number.isFinite(value)) continue;
84
+ if (typeof row.name === "string") keepBest(scores, capabilityModelKey(row.name), value);
85
+ if (typeof row.slug === "string") keepBest(scores, capabilityModelKey(row.slug), value);
86
+ }
87
+ if (scores.size > 0) {
88
+ domains[domain] = scores;
89
+ break;
90
+ }
91
+ }
92
+ }
93
+ return { source: ARTIFICIAL_ANALYSIS_SOURCE, publishedAt: null, domains };
94
+ }
95
+
96
+ /** The body's bytes, refused once they pass maxBytes, whatever the transport declared. */
97
+ export async function readBoundedBytes(response: Response, maxBytes: number): Promise<ArrayBuffer> {
98
+ const chunks: Uint8Array[] = [];
99
+ let length = 0;
100
+ const reader = response.body?.getReader();
101
+ if (!reader) return new ArrayBuffer(0);
102
+ for (;;) {
103
+ const { done, value } = await reader.read();
104
+ if (done) break;
105
+ if (length + value.byteLength > maxBytes) {
106
+ await reader.cancel();
107
+ throw new Error("response exceeded byte bound");
108
+ }
109
+ chunks.push(value);
110
+ length += value.byteLength;
111
+ }
112
+ const out = new Uint8Array(length);
113
+ let offset = 0;
114
+ for (const chunk of chunks) {
115
+ out.set(chunk, offset);
116
+ offset += chunk.byteLength;
117
+ }
118
+ return out.buffer;
119
+ }
120
+
121
+ export async function fetchArtificialAnalysisTable(apiKey: string, fetchImpl: typeof fetch = fetch): Promise<CapabilityTable> {
122
+ const response = await fetchImpl(ARTIFICIAL_ANALYSIS_URL, {
123
+ redirect: "error",
124
+ headers: { "x-api-key": apiKey },
125
+ signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
126
+ });
127
+ if (!response.ok) throw new Error(`HTTP ${response.status}`);
128
+ const bytes = await readBoundedBytes(response, MAX_TABLE_BYTES);
129
+ return capabilityTableFromArtificialAnalysis(JSON.parse(new TextDecoder().decode(bytes)));
130
+ }
131
+
132
+ /** One fetch per period key; a failed fetch is forgotten so the next request retries. */
133
+ function periodCache() {
134
+ let slot: { key: string; table: Promise<CapabilityTable> } | null = null;
135
+ return (key: string, fetchTable: () => Promise<CapabilityTable>): Promise<CapabilityTable> => {
136
+ if (slot?.key === key) return slot.table;
137
+ const table = fetchTable();
138
+ slot = { key, table };
139
+ table.catch(() => { if (slot?.table === table) slot = null; });
140
+ return table;
141
+ };
142
+ }
143
+
144
+ const artificialAnalysisCache = periodCache();
145
+
146
+ /**
147
+ * Artificial Analysis when the user's key resolves, read once per UTC day to stay inside the
148
+ * free tier's daily request quota. Absent or unavailable scores leave price ranking in charge.
149
+ */
150
+ export const loadCapabilityTable: LoadCapability = async config => {
151
+ const now = new Date().toISOString();
152
+ const unavailable = (fallbackReason: string): CapabilityTable => ({ source: null, publishedAt: null, domains: {}, fallbackReason });
153
+ const apiKey = resolveProviderApiKey(config.codexRoleCapability?.artificialAnalysis?.apiKey)?.trim();
154
+ if (!apiKey) return unavailable("benchmark data was unavailable: no Artificial Analysis key is configured");
155
+ try {
156
+ return await artificialAnalysisCache(`${now.slice(0, 10)} ${apiKey}`, () => fetchArtificialAnalysisTable(apiKey));
157
+ } catch {
158
+ return unavailable("Artificial Analysis could not be read");
159
+ }
160
+ };
@@ -0,0 +1,253 @@
1
+ /**
2
+ * Every role model write the omo tab and `ocx agent roles set` make, so a role can be put back.
3
+ * The integration journal cannot hold these: it snapshots one client config per operation, and a
4
+ * role write spans `$CODEX_HOME/agents/<role>.toml` and LazyCodex's omo.jsonc mirror. So the
5
+ * values are recorded rather than bytes, and a restore is an ordinary write of the earlier values.
6
+ * Writes made in one action (auto-assign's Apply all) share a batch and are restored together.
7
+ * The server hands out batch ids and a write joins a batch only while the history still holds it whole,
8
+ * so an id compaction dropped can never start over and pass for the beginning of a batch. Every row
9
+ * carries its number in its batch, which keeps the cap durable and lets a read tell a whole batch
10
+ * from a cut one, which is never listed or restored.
11
+ * The file sits under the opencodex config directory, which outlives a switch of Codex home, so every
12
+ * row names the canonical Codex home it was written in and only that home's rows are listed or restored.
13
+ * The file is bounded three ways: a batch holds at most ROLE_HISTORY_LIMIT rows, an append that takes
14
+ * the file past ROLE_HISTORY_MAX_BYTES rewrites it to its newest whole batches, and a read looks at
15
+ * no more than that many bytes and ROLE_HISTORY_MAX_ROWS rows from the end.
16
+ */
17
+ import { appendFileSync, closeSync, fstatSync, openSync, readSync, statSync } from "node:fs";
18
+ import { join } from "node:path";
19
+ import { atomicWriteFile } from "../config/atomic-write";
20
+ import { ensureDir, integrationsDir } from "../integrations/ownership";
21
+
22
+ export interface RoleSetting {
23
+ readonly model: string | null;
24
+ readonly effort: string | null;
25
+ }
26
+
27
+ export interface RoleModelChange {
28
+ readonly at: string;
29
+ readonly batch: string;
30
+ readonly role: string;
31
+ readonly before: RoleSetting;
32
+ readonly after: RoleSetting;
33
+ }
34
+
35
+ interface StoredRoleModelChange extends RoleModelChange {
36
+ readonly codexHome: string;
37
+ /** This row's number in its batch, from 1: a batch is whole when it holds rows 1 to its highest. */
38
+ readonly n: number;
39
+ /** The batch this row's write restored, so compaction keeps that batch while the Restore is kept. */
40
+ readonly restores?: string;
41
+ }
42
+
43
+ /** The batch a write is recorded in and its row number there. */
44
+ export interface BatchSlot {
45
+ readonly batch: string;
46
+ readonly n: number;
47
+ }
48
+
49
+ /** Rows one listing returns, and rows one batch may hold, so a whole batch always fits a listing. */
50
+ export const ROLE_HISTORY_LIMIT = 50;
51
+ export const ROLE_HISTORY_MAX_BYTES = 256 * 1024;
52
+ export const ROLE_HISTORY_MAX_ROWS = 1000;
53
+ const BATCH_PATTERN = /^[A-Za-z0-9-]{1,64}$/;
54
+
55
+ function historyPath(dir: string): string {
56
+ return join(dir, "codex-agent-roles.jsonl");
57
+ }
58
+
59
+ export function isRoleHistoryBatch(value: unknown): value is string {
60
+ return typeof value === "string" && BATCH_PATTERN.test(value);
61
+ }
62
+
63
+ /** `codexHome` is the canonical path `getCodexHome()` returns, so two spellings of one home match. */
64
+ export function recordRoleModelChange(codexHome: string, change: RoleModelChange & { readonly n: number; readonly restores?: string }, dir: string = integrationsDir()): void {
65
+ ensureDir(historyPath(dir));
66
+ const stored: StoredRoleModelChange = { ...change, codexHome };
67
+ // Capture the complete source before this append can move its first row outside either tail limit.
68
+ const tail = tailRows(historyPath(dir));
69
+ // An interrupted JSONL suffix must not swallow the first record returned after restart.
70
+ appendFileSync(historyPath(dir), `${tail.unterminated ? "\n" : ""}${JSON.stringify(stored)}\n`, { encoding: "utf8", mode: 0o600 });
71
+ if (statSync(historyPath(dir)).size <= ROLE_HISTORY_MAX_BYTES && tail.lines < ROLE_HISTORY_MAX_ROWS) return;
72
+ try {
73
+ compact(dir, wholeBatches([stored, ...tail.rows]));
74
+ } catch (cause) {
75
+ // Reads stay bounded without the trim; the next append retries it.
76
+ throw new Error("recorded the change but could not trim the history file", { cause });
77
+ }
78
+ }
79
+
80
+ /**
81
+ * Rewrite the file to its newest rows within half the byte budget and the row budget, so the next
82
+ * compaction is many saves away. A batch the cut falls inside is dropped whole, for every Codex home,
83
+ * so no home is left with part of an Apply all to restore. A kept Restore keeps the batch it restores
84
+ * whole when the Restore and its sources fit both read limits; protected rows displace older batches.
85
+ */
86
+ function compact(dir: string, rows: StoredRoleModelChange[]): void {
87
+ const batches = new Map<string, StoredRoleModelChange[]>();
88
+ for (const row of rows) {
89
+ const key = batchKey(row);
90
+ batches.set(key, [...(batches.get(key) ?? []), row]);
91
+ }
92
+ const keep = new Set<string>();
93
+ let bytes = 0;
94
+ let count = 0;
95
+ for (const key of batches.keys()) {
96
+ if (keep.has(key)) continue;
97
+ const needed = new Set([key]);
98
+ // Include source dependencies before admitting a batch, so they share its byte and row budgets.
99
+ for (const dependency of needed) {
100
+ for (const row of batches.get(dependency) ?? []) {
101
+ if (row.restores) {
102
+ const source = batchKey({ ...row, batch: row.restores });
103
+ if (batches.has(source) && !keep.has(source)) needed.add(source);
104
+ }
105
+ }
106
+ }
107
+ const added = rows.filter(row => needed.has(batchKey(row)));
108
+ const addedBytes = added.reduce((sum, row) => sum + Buffer.byteLength(JSON.stringify(row)) + 1, 0);
109
+ if (bytes + addedBytes > ROLE_HISTORY_MAX_BYTES || count + added.length > ROLE_HISTORY_MAX_ROWS) break;
110
+ // Ordinary batches stay within the half-budget target; Restore sources may use the headroom.
111
+ if (bytes + addedBytes > ROLE_HISTORY_MAX_BYTES / 2 && !added.some(row => row.restores)) break;
112
+ for (const dependency of needed) keep.add(dependency);
113
+ bytes += addedBytes;
114
+ count += added.length;
115
+ if (bytes >= ROLE_HISTORY_MAX_BYTES / 2) break;
116
+ }
117
+ const whole = rows.filter(row => keep.has(batchKey(row))).reverse();
118
+ atomicWriteFile(historyPath(dir), whole.map(row => `${JSON.stringify(row)}\n`).join(""));
119
+ }
120
+
121
+ function batchKey(row: Pick<StoredRoleModelChange, "codexHome" | "batch">): string {
122
+ return `${row.codexHome}\n${row.batch}`;
123
+ }
124
+
125
+ function isSetting(value: unknown): value is RoleSetting {
126
+ const setting = value as RoleSetting | null;
127
+ return typeof setting === "object" && setting !== null
128
+ && (setting.model === null || typeof setting.model === "string")
129
+ && (setting.effort === null || typeof setting.effort === "string");
130
+ }
131
+
132
+ function parseRow(line: string): StoredRoleModelChange | null {
133
+ let value: unknown;
134
+ try {
135
+ value = JSON.parse(line);
136
+ } catch {
137
+ return null;
138
+ }
139
+ const change = value as StoredRoleModelChange | null;
140
+ return typeof change === "object" && change !== null && typeof change.codexHome === "string"
141
+ && typeof change.at === "string" && typeof change.role === "string"
142
+ && isRoleHistoryBatch(change.batch) && isSetting(change.before) && isSetting(change.after)
143
+ && Number.isSafeInteger(change.n) && change.n >= 1
144
+ && (change.restores === undefined || isRoleHistoryBatch(change.restores))
145
+ ? change
146
+ : null;
147
+ }
148
+
149
+ /**
150
+ * Every Codex home's rows, newest first, from at most the last ROLE_HISTORY_MAX_BYTES of the file and
151
+ * at most ROLE_HISTORY_MAX_ROWS of them. When the read starts mid-file, its first partial line is
152
+ * skipped; a batch that continues above the read is left for `wholeBatches` to drop.
153
+ */
154
+ function tailRows(path: string): { rows: StoredRoleModelChange[]; lines: number; unterminated: boolean } {
155
+ let fd: number;
156
+ try {
157
+ fd = openSync(path, "r");
158
+ } catch (error) {
159
+ if ((error as NodeJS.ErrnoException).code === "ENOENT") return { rows: [], lines: 0, unterminated: false };
160
+ throw error;
161
+ }
162
+ let text: string;
163
+ try {
164
+ const stat = fstatSync(fd);
165
+ // Windows opens a directory for reading, so the type is checked rather than left to the read.
166
+ if (!stat.isFile()) throw new Error(`${path} is not a regular file`);
167
+ const size = stat.size;
168
+ const start = Math.max(0, size - ROLE_HISTORY_MAX_BYTES - 1);
169
+ const bytes = Buffer.alloc(size - start);
170
+ let length = 0;
171
+ while (length < bytes.length) {
172
+ const count = readSync(fd, bytes, length, bytes.length - length, start + length);
173
+ if (count === 0) break;
174
+ length += count;
175
+ }
176
+ const read = bytes.subarray(0, length);
177
+ text = (start > 0 ? read.subarray(read.indexOf(10) + 1) : read).toString("utf8");
178
+ } finally {
179
+ closeSync(fd);
180
+ }
181
+ const lines = text.split("\n").filter(line => line.trim()).slice(-ROLE_HISTORY_MAX_ROWS);
182
+ const rows = lines.flatMap(line => {
183
+ const row = parseRow(line);
184
+ return row ? [row] : [];
185
+ }).reverse();
186
+ return { rows, lines: lines.length, unterminated: text.length > 0 && !text.endsWith("\n") };
187
+ }
188
+
189
+ /**
190
+ * The rows of every batch that holds each of its rows 1 to its highest, so a batch the read or a
191
+ * compaction cut into is never offered as if it were whole.
192
+ */
193
+ function wholeBatches(rows: StoredRoleModelChange[]): StoredRoleModelChange[] {
194
+ const numbers = new Map<string, Set<number>>();
195
+ const highest = new Map<string, number>();
196
+ for (const row of rows) {
197
+ const key = batchKey(row);
198
+ numbers.set(key, (numbers.get(key) ?? new Set()).add(row.n));
199
+ highest.set(key, Math.max(highest.get(key) ?? 0, row.n));
200
+ }
201
+ return rows.filter(row => numbers.get(batchKey(row))!.size === highest.get(batchKey(row)));
202
+ }
203
+
204
+ function forHome(rows: StoredRoleModelChange[], codexHome: string): RoleModelChange[] {
205
+ return rows.flatMap(({ codexHome: home, n: _n, restores: _restores, ...change }) => home === codexHome ? [change] : []);
206
+ }
207
+
208
+ /**
209
+ * This Codex home's changes, newest first, in whole batches and never more than `limit` rows: batches
210
+ * are taken newest first until the next would not fit, so Restore never puts back part of an Apply all.
211
+ * A batch larger than `limit` (written before batches were capped) can never be listed whole and is
212
+ * skipped. A torn or foreign line, and a row another Codex home wrote, is skipped, the way the
213
+ * integration journal reads its own.
214
+ */
215
+ export function listRoleModelChanges(codexHome: string, limit: number = ROLE_HISTORY_LIMIT, dir: string = integrationsDir()): RoleModelChange[] {
216
+ const newestFirst = forHome(wholeBatches(tailRows(historyPath(dir)).rows), codexHome);
217
+ const sizes = new Map<string, number>();
218
+ for (const change of newestFirst) sizes.set(change.batch, (sizes.get(change.batch) ?? 0) + 1);
219
+ const listed = new Set<string>();
220
+ let count = 0;
221
+ for (const [batch, size] of sizes) {
222
+ if (size > limit) continue;
223
+ if (count + size > limit) break;
224
+ listed.add(batch);
225
+ count += size;
226
+ }
227
+ return newestFirst.filter(change => listed.has(change.batch));
228
+ }
229
+
230
+ /**
231
+ * Where a write in this Codex home is recorded. Without `batch` it starts a new batch under a fresh id.
232
+ * With one, it joins that batch only while this home's retained history holds the batch whole, and is
233
+ * refused once the batch holds ROLE_HISTORY_LIMIT rows. An id compaction dropped, or one the server
234
+ * never handed out, is closed: it cannot take a row and pass for the start of a batch.
235
+ */
236
+ export function claimBatchRow(codexHome: string, batch: string | undefined, dir: string = integrationsDir()): BatchSlot | "batch_closed" | "batch_full" {
237
+ if (batch === undefined) return { batch: crypto.randomUUID(), n: 1 };
238
+ const held = wholeBatches(tailRows(historyPath(dir)).rows).filter(row => row.codexHome === codexHome && row.batch === batch);
239
+ if (held.length === 0) return "batch_closed";
240
+ return held.length >= ROLE_HISTORY_LIMIT ? "batch_full" : { batch, n: held.length + 1 };
241
+ }
242
+
243
+ /**
244
+ * The setting a Restore of `batch` may put back on `role` in this Codex home: the role's earliest
245
+ * `before` in that batch, or null when this home's retained history has no such change. The server
246
+ * checks a restore against it, so a dashboard still showing another home's history cannot write
247
+ * that home's earlier models here. It reads every retained batch rather than the 50-row listing,
248
+ * because a Restore's own rows push the batch it restores out of that listing before it finishes.
249
+ */
250
+ export function restorableSetting(codexHome: string, batch: string, role: string, dir: string = integrationsDir()): RoleSetting | null {
251
+ const changes = forHome(wholeBatches(tailRows(historyPath(dir)).rows), codexHome).filter(change => change.batch === batch && change.role === role);
252
+ return changes.at(-1)?.before ?? null;
253
+ }
@@ -43,6 +43,10 @@ export type SizingTier = typeof SIZING_TIERS[number];
43
43
  export const SIZING_EFFORTS = ["glance", "measured", "thorough", "exhaustive"] as const;
44
44
  export type SizingEffort = typeof SIZING_EFFORTS[number];
45
45
 
46
+ /** Task domains, the kind of capability a tier is measured in. A label, never a model or a vendor. */
47
+ export const SIZING_DOMAINS = ["coding", "agentic", "reasoning", "writing", "knowledge", "general"] as const;
48
+ export type SizingDomain = typeof SIZING_DOMAINS[number];
49
+
46
50
  const MAX_FIELD_CHARS = 400;
47
51
 
48
52
  export const ROLE_SIZING_SYSTEM_PROMPT = [
@@ -66,6 +70,15 @@ export const ROLE_SIZING_SYSTEM_PROMPT = [
66
70
  "or a strong model needs only a quick call. Effort buys deliberation, never capability, and more",
67
71
  "effort is not more correct.",
68
72
  "",
73
+ "Task domain names the kind of capability the tier is measured in. It sizes nothing; it tells the",
74
+ "mapping which measured strength matters, because models of one price class differ by domain:",
75
+ "- coding: writing, changing, or reviewing code in a repository.",
76
+ "- agentic: long multi-step tool use, where the work is completing a run of actions without derailing.",
77
+ "- reasoning: math, logic, planning, or analysis whose answer is derived rather than looked up.",
78
+ "- writing: prose meant for a reader: documents, messages, copy.",
79
+ "- knowledge: research and factual recall across sources.",
80
+ "- general: none of the above dominates. Pick it rather than guess.",
81
+ "",
69
82
  "Assess risk and complexity once for both dials:",
70
83
  "- file, module, or ownership boundary crossing;",
71
84
  "- reversibility and blast radius;",
@@ -86,8 +99,8 @@ export const ROLE_SIZING_SYSTEM_PROMPT = [
86
99
  "- Use only the neutral words above. Do not name concrete model products, vendors, versions, or vendor effort levels anywhere in the answer.",
87
100
  "",
88
101
  "Answer with one JSON object and nothing else, no prose and no code fence:",
89
- '{"roles":{"<role name>":{"tier":"fast|standard|frontier","effort":"glance|measured|thorough|exhaustive","rationale":"<one sentence covering both dials>","move_up_if":"<signals that would justify a stronger tier or higher effort>","move_down_if":"<signals that would justify a cheaper tier or lower effort>"}}}',
90
- "Include every role you were given, keyed by its exact name, with exactly those five fields.",
102
+ '{"roles":{"<role name>":{"tier":"fast|standard|frontier","effort":"glance|measured|thorough|exhaustive","domain":"coding|agentic|reasoning|writing|knowledge|general","rationale":"<one sentence covering both dials>","move_up_if":"<signals that would justify a stronger tier or higher effort>","move_down_if":"<signals that would justify a cheaper tier or lower effort>"}}}',
103
+ "Include every role you were given, keyed by its exact name, with exactly those six fields.",
91
104
  ].join("\n");
92
105
 
93
106
  /**
@@ -105,6 +118,7 @@ export const DELEGATED_WORK_SIZING_SYSTEM_PROMPT = [
105
118
  export interface RoleSizing {
106
119
  readonly tier: SizingTier;
107
120
  readonly effort: SizingEffort;
121
+ readonly domain: SizingDomain;
108
122
  readonly rationale: string;
109
123
  readonly moveUpIf: string;
110
124
  readonly moveDownIf: string;
@@ -167,13 +181,16 @@ function validateEntry(entry: unknown): RoleSizingOutcome {
167
181
  const fields = entry as Record<string, unknown>;
168
182
  if (!isMember(SIZING_TIERS, fields.tier)) return { unsized: "the sizing answer has no valid tier" };
169
183
  if (!isMember(SIZING_EFFORTS, fields.effort)) return { unsized: "the sizing answer has no valid effort" };
184
+ // A missing or unknown domain still sizes the role on the overall scale: the domain only picks
185
+ // which measured capability ranks the candidates, and "general" is the rubric's own no-signal answer.
186
+ const domain = isMember(SIZING_DOMAINS, fields.domain) ? fields.domain : "general";
170
187
  const rationale = oneLine(fields.rationale);
171
188
  const moveUpIf = oneLine(fields.move_up_if);
172
189
  const moveDownIf = oneLine(fields.move_down_if);
173
190
  if (rationale === null || moveUpIf === null || moveDownIf === null) {
174
191
  return { unsized: "the sizing answer is missing a rationale or a move trigger" };
175
192
  }
176
- return { sizing: { tier: fields.tier, effort: fields.effort, rationale, moveUpIf, moveDownIf } };
193
+ return { sizing: { tier: fields.tier, effort: fields.effort, domain, rationale, moveUpIf, moveDownIf } };
177
194
  }
178
195
 
179
196
  const CODE_FENCE = /^\x60{3}(?:json)?[ \t]*\r?\n([\s\S]*?)\r?\n[ \t]*\x60{3}$/i;
@@ -183,9 +200,10 @@ const CODE_FENCE = /^\x60{3}(?:json)?[ \t]*\r?\n([\s\S]*?)\r?\n[ \t]*\x60{3}$/i;
183
200
  *
184
201
  * The answer must be one JSON object of the shape the rubric asks for. Two leniencies, both for
185
202
  * content the mapping never reads: a single surrounding code fence, which models add out of habit,
186
- * and keys beyond the five fields in a role's entry, which are ignored. Every one of the five must
187
- * still be present and valid. Anything else wrong marks the affected role, or every role when the
188
- * whole answer is unusable, as unsized with the reason.
203
+ * and keys beyond the six fields in a role's entry, which are ignored. Tier, effort, rationale and
204
+ * both move triggers must still be present and valid; a missing domain falls back to "general".
205
+ * Anything else wrong marks the affected role, or every role when the whole answer is unusable,
206
+ * as unsized with the reason.
189
207
  */
190
208
  export function parseRoleSizingResponse(text: string, roles: readonly string[]): Map<string, RoleSizingOutcome> {
191
209
  const out = new Map<string, RoleSizingOutcome>();