@zergai/ztc 0.4.0-beta.1 → 0.5.0-beta.1

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 (718) hide show
  1. package/README.md +398 -45
  2. package/RUST_THIRD_PARTY_LICENSES.txt +1080 -822
  3. package/THIRD_PARTY_NOTICES.md +273 -12
  4. package/bin/zmux-darwin-arm64 +0 -0
  5. package/bin/ztc-audio-darwin-arm64 +0 -0
  6. package/bin/ztc-capture-darwin-arm64 +0 -0
  7. package/bin/ztc-computer-darwin-arm64 +0 -0
  8. package/bin/ztc-llm-darwin-arm64 +0 -0
  9. package/bin/ztc-tts-darwin-arm64 +0 -0
  10. package/bin/ztc-tui-darwin-arm64 +0 -0
  11. package/bin/ztc-zlicky-overlay-darwin-arm64 +0 -0
  12. package/bin/zterm-darwin-arm64 +0 -0
  13. package/dist/App.js +1206 -209
  14. package/dist/agent/agent.d.ts +74 -8
  15. package/dist/agent/agent.js +1073 -184
  16. package/dist/agent/backends/account_rotation.d.ts +4 -0
  17. package/dist/agent/backends/account_rotation.js +8 -2
  18. package/dist/agent/backends/anthropic.d.ts +13 -0
  19. package/dist/agent/backends/anthropic.js +169 -28
  20. package/dist/agent/backends/claude_cli.js +18 -8
  21. package/dist/agent/backends/codex_app_server.d.ts +1 -0
  22. package/dist/agent/backends/codex_app_server.js +55 -3
  23. package/dist/agent/backends/codex_auth.d.ts +1 -0
  24. package/dist/agent/backends/codex_auth.js +67 -13
  25. package/dist/agent/backends/codex_buffered_recovery.d.ts +27 -0
  26. package/dist/agent/backends/codex_buffered_recovery.js +293 -0
  27. package/dist/agent/backends/gemini.js +3 -1
  28. package/dist/agent/backends/http_error.d.ts +26 -0
  29. package/dist/agent/backends/http_error.js +221 -0
  30. package/dist/agent/backends/index.d.ts +9 -2
  31. package/dist/agent/backends/index.js +22 -2
  32. package/dist/agent/backends/openai.d.ts +0 -6
  33. package/dist/agent/backends/openai.js +5 -2
  34. package/dist/agent/backends/openai_compatible.d.ts +5 -4
  35. package/dist/agent/backends/openai_compatible.js +26 -19
  36. package/dist/agent/backends/openai_responses.d.ts +8 -3
  37. package/dist/agent/backends/openai_responses.js +77 -33
  38. package/dist/agent/backends/provider_ids.d.ts +1 -0
  39. package/dist/agent/backends/provider_ids.js +4 -0
  40. package/dist/agent/backends/request_metrics.js +12 -2
  41. package/dist/agent/backends/types.d.ts +109 -6
  42. package/dist/agent/backends/types.js +5 -1
  43. package/dist/agent/backends/zrouter_stream.d.ts +6 -1
  44. package/dist/agent/backends/zrouter_stream.js +160 -42
  45. package/dist/agent/background_registry.d.ts +2 -0
  46. package/dist/agent/background_registry.js +1 -0
  47. package/dist/agent/claim_observation.d.ts +6 -0
  48. package/dist/agent/claim_observation.js +54 -0
  49. package/dist/agent/commands/accounts.js +46 -177
  50. package/dist/agent/commands/attention.d.ts +2 -0
  51. package/dist/agent/commands/attention.js +67 -0
  52. package/dist/agent/commands/auth.js +18 -2
  53. package/dist/agent/commands/board.d.ts +2 -0
  54. package/dist/agent/commands/board.js +169 -0
  55. package/dist/agent/commands/clipboard.js +50 -1
  56. package/dist/agent/commands/compact.js +21 -13
  57. package/dist/agent/commands/config.js +4 -1
  58. package/dist/agent/commands/context.js +6 -1
  59. package/dist/agent/commands/desktop.d.ts +2 -0
  60. package/dist/agent/commands/desktop.js +29 -0
  61. package/dist/agent/commands/effort.js +14 -6
  62. package/dist/agent/commands/environment.d.ts +3 -0
  63. package/dist/agent/commands/environment.js +109 -0
  64. package/dist/agent/commands/evidence.d.ts +2 -0
  65. package/dist/agent/commands/evidence.js +9 -0
  66. package/dist/agent/commands/fork.js +4 -3
  67. package/dist/agent/commands/goal.d.ts +33 -1
  68. package/dist/agent/commands/goal.js +174 -14
  69. package/dist/agent/commands/goal_exit.d.ts +36 -0
  70. package/dist/agent/commands/goal_exit.js +120 -0
  71. package/dist/agent/commands/help.js +3 -1
  72. package/dist/agent/commands/history.js +3 -1
  73. package/dist/agent/commands/inbox.d.ts +2 -0
  74. package/dist/agent/commands/inbox.js +148 -0
  75. package/dist/agent/commands/index.js +16 -1
  76. package/dist/agent/commands/input_mode.js +8 -6
  77. package/dist/agent/commands/job.d.ts +2 -0
  78. package/dist/agent/commands/job.js +93 -0
  79. package/dist/agent/commands/keybindings.js +4 -1
  80. package/dist/agent/commands/label.d.ts +2 -0
  81. package/dist/agent/commands/label.js +77 -0
  82. package/dist/agent/commands/layout.d.ts +2 -0
  83. package/dist/agent/commands/layout.js +20 -0
  84. package/dist/agent/commands/mirror.js +16 -1
  85. package/dist/agent/commands/model.js +12 -2
  86. package/dist/agent/commands/permissions.d.ts +3 -1
  87. package/dist/agent/commands/permissions.js +79 -89
  88. package/dist/agent/commands/plan.js +5 -15
  89. package/dist/agent/commands/profile.js +21 -2
  90. package/dist/agent/commands/provider_selection.js +20 -1
  91. package/dist/agent/commands/rename.js +1 -1
  92. package/dist/agent/commands/resources.d.ts +2 -0
  93. package/dist/agent/commands/resources.js +67 -0
  94. package/dist/agent/commands/rewind.d.ts +3 -0
  95. package/dist/agent/commands/rewind.js +16 -0
  96. package/dist/agent/commands/runbooks.d.ts +2 -0
  97. package/dist/agent/commands/runbooks.js +73 -0
  98. package/dist/agent/commands/runbooks_lazy.d.ts +2 -0
  99. package/dist/agent/commands/runbooks_lazy.js +8 -0
  100. package/dist/agent/commands/sessions.d.ts +1 -1
  101. package/dist/agent/commands/sessions.js +33 -5
  102. package/dist/agent/commands/settings.js +185 -39
  103. package/dist/agent/commands/setup.d.ts +2 -0
  104. package/dist/agent/commands/setup.js +78 -0
  105. package/dist/agent/commands/share.d.ts +2 -0
  106. package/dist/agent/commands/share.js +64 -0
  107. package/dist/agent/commands/status.js +14 -2
  108. package/dist/agent/commands/types.d.ts +99 -6
  109. package/dist/agent/commands/update.js +8 -0
  110. package/dist/agent/commands/usage.d.ts +2 -0
  111. package/dist/agent/commands/usage.js +8 -0
  112. package/dist/agent/factory.d.ts +11 -0
  113. package/dist/agent/factory.js +113 -88
  114. package/dist/agent/loop_policy.d.ts +6 -3
  115. package/dist/agent/loop_policy.js +12 -3
  116. package/dist/agent/measurement_guidance.d.ts +2 -0
  117. package/dist/agent/measurement_guidance.js +5 -0
  118. package/dist/agent/request_encoder.d.ts +8 -1
  119. package/dist/agent/request_encoder.js +95 -23
  120. package/dist/agent/runtime/benchmark_comparison.d.ts +30 -0
  121. package/dist/agent/runtime/benchmark_comparison.js +94 -0
  122. package/dist/agent/runtime/benchmark_contract.d.ts +48 -0
  123. package/dist/agent/runtime/benchmark_contract.js +90 -0
  124. package/dist/agent/runtime/checked_commands.d.ts +32 -0
  125. package/dist/agent/runtime/checked_commands.js +119 -0
  126. package/dist/agent/runtime/command_execution_policy.d.ts +26 -0
  127. package/dist/agent/runtime/command_execution_policy.js +91 -0
  128. package/dist/agent/runtime/command_jobs.d.ts +36 -18
  129. package/dist/agent/runtime/command_jobs.js +151 -13
  130. package/dist/agent/runtime/command_panes.d.ts +59 -0
  131. package/dist/agent/runtime/command_panes.js +398 -0
  132. package/dist/agent/runtime/command_wait.d.ts +19 -0
  133. package/dist/agent/runtime/command_wait.js +167 -0
  134. package/dist/agent/runtime/cpu_benchmark.d.ts +30 -0
  135. package/dist/agent/runtime/cpu_benchmark.js +126 -0
  136. package/dist/agent/runtime/delegated_evidence.d.ts +26 -0
  137. package/dist/agent/runtime/delegated_evidence.js +80 -0
  138. package/dist/agent/runtime/evidence.d.ts +127 -0
  139. package/dist/agent/runtime/evidence.js +468 -0
  140. package/dist/agent/runtime/execution_context.d.ts +7 -0
  141. package/dist/agent/runtime/execution_context.js +39 -3
  142. package/dist/agent/runtime/json_verifier_recipe.d.ts +8 -0
  143. package/dist/agent/runtime/json_verifier_recipe.js +66 -0
  144. package/dist/agent/runtime/measurements.d.ts +110 -0
  145. package/dist/agent/runtime/measurements.js +317 -0
  146. package/dist/agent/runtime/policy.d.ts +4 -0
  147. package/dist/agent/runtime/policy.js +31 -20
  148. package/dist/agent/runtime/provider_native_evidence.d.ts +20 -0
  149. package/dist/agent/runtime/provider_native_evidence.js +86 -0
  150. package/dist/agent/runtime/recovery.d.ts +2 -0
  151. package/dist/agent/runtime/recovery.js +45 -2
  152. package/dist/agent/runtime/remote_broker_transport.d.ts +10 -0
  153. package/dist/agent/runtime/remote_broker_transport.js +84 -0
  154. package/dist/agent/runtime/remote_deletion_receipts.d.ts +3 -0
  155. package/dist/agent/runtime/remote_deletion_receipts.js +43 -0
  156. package/dist/agent/runtime/remote_journal_replay.d.ts +13 -0
  157. package/dist/agent/runtime/remote_journal_replay.js +233 -0
  158. package/dist/agent/runtime/remote_mutation_journal.d.ts +25 -0
  159. package/dist/agent/runtime/remote_mutation_journal.js +208 -0
  160. package/dist/agent/runtime/remote_resource_endpoint.d.ts +7 -0
  161. package/dist/agent/runtime/remote_resource_endpoint.js +6 -0
  162. package/dist/agent/runtime/remote_resource_errors.d.ts +5 -0
  163. package/dist/agent/runtime/remote_resource_errors.js +9 -0
  164. package/dist/agent/runtime/remote_resource_script.d.ts +2 -0
  165. package/dist/agent/runtime/remote_resource_script.js +1009 -0
  166. package/dist/agent/runtime/remote_resources.d.ts +29 -0
  167. package/dist/agent/runtime/remote_resources.js +160 -0
  168. package/dist/agent/runtime/source_verification.d.ts +12 -0
  169. package/dist/agent/runtime/source_verification.js +210 -0
  170. package/dist/agent/runtime/source_verification_contract.d.ts +75 -0
  171. package/dist/agent/runtime/source_verification_contract.js +203 -0
  172. package/dist/agent/runtime/tool_checkpoints.d.ts +11 -0
  173. package/dist/agent/runtime/tool_checkpoints.js +26 -0
  174. package/dist/agent/runtime/tool_effects.d.ts +5 -0
  175. package/dist/agent/runtime/tool_progress.d.ts +12 -0
  176. package/dist/agent/runtime/tool_progress.js +76 -0
  177. package/dist/agent/runtime/tool_runtime.d.ts +16 -1
  178. package/dist/agent/runtime/tool_runtime.js +204 -10
  179. package/dist/agent/runtime/tracing.d.ts +1 -1
  180. package/dist/agent/runtime/verifier_capture.d.ts +9 -0
  181. package/dist/agent/runtime/verifier_capture.js +100 -0
  182. package/dist/agent/runtime/verifier_contract.d.ts +24 -0
  183. package/dist/agent/runtime/verifier_contract.js +41 -0
  184. package/dist/agent/subagent.d.ts +20 -10
  185. package/dist/agent/subagent.js +266 -29
  186. package/dist/agent/tool_response_directory.d.ts +24 -0
  187. package/dist/agent/tool_response_directory.js +61 -0
  188. package/dist/agent/tool_response_source.d.ts +8 -0
  189. package/dist/agent/tool_response_source.js +49 -0
  190. package/dist/agent/tool_response_store.d.ts +75 -4
  191. package/dist/agent/tool_response_store.js +583 -64
  192. package/dist/agent/tools/ask_user.d.ts +3 -1
  193. package/dist/agent/tools/ask_user.js +30 -11
  194. package/dist/agent/tools/background.js +1 -0
  195. package/dist/agent/tools/benchmark_cpu.d.ts +2 -0
  196. package/dist/agent/tools/benchmark_cpu.js +102 -0
  197. package/dist/agent/tools/compare_benchmarks.d.ts +2 -0
  198. package/dist/agent/tools/compare_benchmarks.js +53 -0
  199. package/dist/agent/tools/deferred.js +1 -0
  200. package/dist/agent/tools/delegate.js +18 -2
  201. package/dist/agent/tools/helper_requirements.d.ts +7 -0
  202. package/dist/agent/tools/helper_requirements.js +19 -0
  203. package/dist/agent/tools/index.d.ts +1 -0
  204. package/dist/agent/tools/index.js +3 -0
  205. package/dist/agent/tools/measurement_report.d.ts +22 -0
  206. package/dist/agent/tools/measurement_report.js +190 -0
  207. package/dist/agent/tools/pane.d.ts +0 -7
  208. package/dist/agent/tools/pane.js +5 -4
  209. package/dist/agent/tools/project_context.d.ts +3 -0
  210. package/dist/agent/tools/project_context.js +45 -0
  211. package/dist/agent/tools/recall_tool_response.d.ts +3 -5
  212. package/dist/agent/tools/recall_tool_response.js +19 -29
  213. package/dist/agent/tools/registry.d.ts +1 -0
  214. package/dist/agent/tools/registry.js +23 -0
  215. package/dist/agent/tools/related_sessions.d.ts +2 -0
  216. package/dist/agent/tools/related_sessions.js +156 -0
  217. package/dist/agent/tools/routine.js +13 -3
  218. package/dist/agent/tools/session_evidence.d.ts +3 -0
  219. package/dist/agent/tools/session_evidence.js +72 -0
  220. package/dist/agent/tools/shell.d.ts +4 -3
  221. package/dist/agent/tools/shell.js +174 -47
  222. package/dist/agent/tools/tool_search.js +3 -2
  223. package/dist/agent/tools/types.d.ts +28 -0
  224. package/dist/agent/tools/verify_artifact.d.ts +2 -0
  225. package/dist/agent/tools/verify_artifact.js +60 -0
  226. package/dist/agent/tools/workflow.js +1 -0
  227. package/dist/app/activity.d.ts +6 -1
  228. package/dist/app/activity.js +81 -12
  229. package/dist/app/agent_runner.d.ts +6 -1
  230. package/dist/app/agent_runner.js +34 -19
  231. package/dist/app/command_context.js +106 -10
  232. package/dist/app/controller.d.ts +15 -4
  233. package/dist/app/controller.js +29 -3
  234. package/dist/app/escape_stop.d.ts +11 -0
  235. package/dist/app/escape_stop.js +15 -0
  236. package/dist/app/liveness.d.ts +6 -4
  237. package/dist/app/liveness.js +13 -3
  238. package/dist/app/model_catalog_cache.d.ts +5 -0
  239. package/dist/app/model_catalog_cache.js +138 -0
  240. package/dist/app/ordered_transcript.js +43 -4
  241. package/dist/app/prompt_turn.d.ts +14 -0
  242. package/dist/app/prompt_turn.js +53 -0
  243. package/dist/app/recap.d.ts +3 -0
  244. package/dist/app/recap.js +9 -3
  245. package/dist/app/restart.d.ts +3 -2
  246. package/dist/app/restart.js +22 -7
  247. package/dist/app/rewind.d.ts +3 -3
  248. package/dist/app/rewind.js +3 -3
  249. package/dist/app/selection_completion.d.ts +17 -2
  250. package/dist/app/selection_completion.js +84 -9
  251. package/dist/app/session_manager.d.ts +38 -6
  252. package/dist/app/session_manager.js +263 -60
  253. package/dist/app/session_messages.d.ts +3 -0
  254. package/dist/app/session_messages.js +60 -0
  255. package/dist/app/task_scope_router.d.ts +20 -0
  256. package/dist/app/task_scope_router.js +173 -0
  257. package/dist/app/transcript_window.d.ts +2 -0
  258. package/dist/app/transcript_window.js +4 -0
  259. package/dist/app/workspace_admission_details.d.ts +3 -0
  260. package/dist/app/workspace_admission_details.js +26 -0
  261. package/dist/app/workspace_layout_controller.d.ts +11 -0
  262. package/dist/app/workspace_layout_controller.js +88 -0
  263. package/dist/app/workspace_monitor.d.ts +1 -0
  264. package/dist/app/workspace_monitor.js +216 -0
  265. package/dist/app/workspace_presets.d.ts +29 -0
  266. package/dist/app/workspace_presets.js +192 -0
  267. package/dist/attention/queue.d.ts +37 -0
  268. package/dist/attention/queue.js +183 -0
  269. package/dist/bench/rf_shared.d.ts +2 -0
  270. package/dist/board/binding.d.ts +42 -0
  271. package/dist/board/binding.js +38 -0
  272. package/dist/board/client.d.ts +42 -0
  273. package/dist/board/client.js +60 -0
  274. package/dist/cli.js +1 -1
  275. package/dist/cli_args.js +19 -17
  276. package/dist/cli_main.js +110 -13
  277. package/dist/cli_ratatui.d.ts +183 -16
  278. package/dist/cli_ratatui.js +3989 -1255
  279. package/dist/components/ActivityLine.d.ts +3 -2
  280. package/dist/components/ActivityLine.js +2 -2
  281. package/dist/components/InputArea.d.ts +19 -1
  282. package/dist/components/InputArea.js +264 -190
  283. package/dist/components/MessageList.d.ts +2 -0
  284. package/dist/components/MessageList.js +3 -1
  285. package/dist/components/SingleMessage.d.ts +2 -0
  286. package/dist/components/SingleMessage.js +4 -2
  287. package/dist/components/StatusBar.d.ts +4 -2
  288. package/dist/components/StatusBar.js +3 -1
  289. package/dist/conductor_branch.js +3 -0
  290. package/dist/config/api_retry.d.ts +6 -1
  291. package/dist/config/api_retry.js +19 -1
  292. package/dist/config/defaults.d.ts +2 -1
  293. package/dist/config/defaults.js +9 -2
  294. package/dist/config/message_display.d.ts +1 -0
  295. package/dist/config/message_display.js +17 -2
  296. package/dist/config/permissions.d.ts +21 -0
  297. package/dist/config/permissions.js +89 -0
  298. package/dist/config/resolved.d.ts +2 -2
  299. package/dist/config/types.d.ts +32 -5
  300. package/dist/config.d.ts +38 -4
  301. package/dist/config.js +290 -42
  302. package/dist/context/project_intelligence.d.ts +44 -0
  303. package/dist/context/project_intelligence.js +246 -0
  304. package/dist/desktop/cli_launch.d.ts +8 -0
  305. package/dist/desktop/cli_launch.js +6 -0
  306. package/dist/desktop/cli_shim.d.ts +8 -0
  307. package/dist/desktop/cli_shim.js +120 -0
  308. package/dist/desktop/runtime.d.ts +16 -0
  309. package/dist/desktop/runtime.js +161 -0
  310. package/dist/desktop/worker_launch.d.ts +7 -0
  311. package/dist/desktop/worker_launch.js +7 -0
  312. package/dist/diagnostics/cargo_mutants_selection.d.ts +27 -0
  313. package/dist/diagnostics/cargo_mutants_selection.js +48 -0
  314. package/dist/diagnostics/native_terminal_benchmark.d.ts +58 -0
  315. package/dist/diagnostics/native_terminal_benchmark.js +1247 -0
  316. package/dist/diagnostics/session_evidence_package.d.ts +40 -0
  317. package/dist/diagnostics/session_evidence_package.js +234 -0
  318. package/dist/diagnostics/session_export.d.ts +93 -0
  319. package/dist/diagnostics/session_export.js +634 -0
  320. package/dist/emulation/tool_adapters.js +48 -18
  321. package/dist/emulation/ztc_addendum.d.ts +1 -0
  322. package/dist/emulation/ztc_addendum.js +13 -12
  323. package/dist/environment/service_runner.d.ts +1 -0
  324. package/dist/environment/service_runner.js +68 -0
  325. package/dist/environment/store.d.ts +120 -0
  326. package/dist/environment/store.js +387 -0
  327. package/dist/events.d.ts +40 -1
  328. package/dist/events.js +10 -17
  329. package/dist/goal_contract.d.ts +25 -0
  330. package/dist/goal_contract.js +44 -0
  331. package/dist/headless.d.ts +31 -0
  332. package/dist/headless.js +578 -70
  333. package/dist/headless_cli.js +8 -0
  334. package/dist/headless_cli_args.d.ts +1 -0
  335. package/dist/headless_cli_args.js +1 -0
  336. package/dist/intake/cli.d.ts +1 -0
  337. package/dist/intake/cli.js +33 -0
  338. package/dist/intake/format.d.ts +2 -0
  339. package/dist/intake/format.js +14 -0
  340. package/dist/intake/notifications.d.ts +16 -0
  341. package/dist/intake/notifications.js +132 -0
  342. package/dist/intake/store.d.ts +56 -0
  343. package/dist/intake/store.js +238 -0
  344. package/dist/library.d.ts +8 -0
  345. package/dist/library.js +19 -10
  346. package/dist/mcp/client.d.ts +1 -0
  347. package/dist/mcp/client.js +20 -0
  348. package/dist/modes/builtin/plan.yaml +2 -2
  349. package/dist/modes/handlers.js +1 -1
  350. package/dist/onboarding/first_run.d.ts +3 -0
  351. package/dist/onboarding/first_run.js +33 -25
  352. package/dist/onboarding/setup.d.ts +32 -0
  353. package/dist/onboarding/setup.js +133 -0
  354. package/dist/onboarding/setup_agent_health.d.ts +17 -0
  355. package/dist/onboarding/setup_agent_health.js +79 -0
  356. package/dist/onboarding/setup_environment.d.ts +66 -0
  357. package/dist/onboarding/setup_environment.js +219 -0
  358. package/dist/onboarding/setup_workspace.d.ts +17 -0
  359. package/dist/onboarding/setup_workspace.js +129 -0
  360. package/dist/optimize/adapters/index.d.ts +4 -1
  361. package/dist/optimize/adapters/index.js +7 -0
  362. package/dist/optimize/adapters/kernelbench.js +14 -5
  363. package/dist/optimize/adapters/popcorn.js +3 -2
  364. package/dist/optimize/adapters/profile_benchmark.js +13 -7
  365. package/dist/optimize/adapters/rfbench.js +25 -14
  366. package/dist/optimize/adapters/types.d.ts +3 -0
  367. package/dist/optimize/adapters/zergpod.js +5 -2
  368. package/dist/optimize/baseline.js +10 -21
  369. package/dist/optimize/branch.js +9 -12
  370. package/dist/optimize/combine.js +2 -3
  371. package/dist/optimize/executor.js +34 -48
  372. package/dist/optimize/measurements.d.ts +55 -0
  373. package/dist/optimize/measurements.js +173 -0
  374. package/dist/optimize/results.d.ts +1 -0
  375. package/dist/optimize/results.js +11 -33
  376. package/dist/optimize/tge.js +2 -1
  377. package/dist/panes/initial_input.d.ts +19 -0
  378. package/dist/panes/initial_input.js +206 -0
  379. package/dist/panes/labels.d.ts +16 -0
  380. package/dist/panes/labels.js +42 -0
  381. package/dist/panes/model_catalog.d.ts +3 -3
  382. package/dist/panes/model_catalog.js +28 -4
  383. package/dist/panes/pane_registry.js +6 -2
  384. package/dist/panes/types.d.ts +3 -0
  385. package/dist/panes/ztc_launch.js +19 -0
  386. package/dist/plugin/optimization.d.ts +2 -0
  387. package/dist/plugin/optimization.js +1 -0
  388. package/dist/plugin/runtime.d.ts +2 -0
  389. package/dist/plugin/simulation.d.ts +6 -1
  390. package/dist/plugin/simulation_contract.d.ts +836 -1
  391. package/dist/plugin/simulation_documents.d.ts +22 -0
  392. package/dist/plugin/simulation_documents.js +1 -0
  393. package/dist/plugin/simulation_interventions.d.ts +103 -0
  394. package/dist/plugin/simulation_interventions.js +1 -0
  395. package/dist/plugin/simulation_living.d.ts +1 -0
  396. package/dist/plugin/simulation_living.js +3 -0
  397. package/dist/plugin/simulation_meetings.d.ts +121 -0
  398. package/dist/plugin/simulation_meetings.js +1 -0
  399. package/dist/plugin/simulation_story_review.d.ts +111 -0
  400. package/dist/plugin/simulation_story_review.js +1 -0
  401. package/dist/plugin/simulation_storyteller.d.ts +91 -0
  402. package/dist/plugin/simulation_storyteller.js +1 -0
  403. package/dist/plugin/simulation_structured.d.ts +2 -0
  404. package/dist/plugin/simulation_structured.js +2 -0
  405. package/dist/plugin/simulation_toolkit.d.ts +21 -0
  406. package/dist/plugin/simulation_toolkit.js +24 -0
  407. package/dist/prompts/tool_delegate_task.j2 +1 -1
  408. package/dist/remote-broker/Dockerfile +10 -0
  409. package/dist/remote-broker/archive.py +1227 -0
  410. package/dist/remote-broker/cutover.py +761 -0
  411. package/dist/remote-broker/requirements.txt +5 -0
  412. package/dist/remote-broker/resources.json +6 -0
  413. package/dist/remote-broker/resources.write-staging.example.json +18 -0
  414. package/dist/remote-broker/retained.py +686 -0
  415. package/dist/remote-broker/retained_cleanup.py +550 -0
  416. package/dist/remote-broker/server.py +648 -0
  417. package/dist/remote-broker/worker.py +1007 -0
  418. package/dist/router_auth.d.ts +31 -0
  419. package/dist/router_auth.js +155 -9
  420. package/dist/runbooks/catalog.d.ts +3 -0
  421. package/dist/runbooks/catalog.js +26 -0
  422. package/dist/runbooks/library.d.ts +11 -0
  423. package/dist/runbooks/library.js +95 -0
  424. package/dist/runbooks/package.d.ts +43 -0
  425. package/dist/runbooks/package.js +102 -0
  426. package/dist/session.d.ts +65 -13
  427. package/dist/session.js +548 -43
  428. package/dist/session_handoff.d.ts +25 -0
  429. package/dist/session_handoff.js +322 -0
  430. package/dist/session_handoff_contract.d.ts +89 -0
  431. package/dist/session_handoff_contract.js +179 -0
  432. package/dist/session_media.d.ts +41 -0
  433. package/dist/session_media.js +357 -0
  434. package/dist/session_ownership.d.ts +16 -0
  435. package/dist/session_ownership.js +221 -0
  436. package/dist/session_public.d.ts +10 -2
  437. package/dist/session_public.js +6 -1
  438. package/dist/simulation/dynamic_history.d.ts +42 -0
  439. package/dist/simulation/dynamic_history.js +173 -0
  440. package/dist/simulation/engines/swarm/pane_manager.js +7 -6
  441. package/dist/simulation/inference.d.ts +3 -1
  442. package/dist/simulation/inference.js +19 -1
  443. package/dist/simulation/intervention_generation.d.ts +27 -0
  444. package/dist/simulation/intervention_generation.js +246 -0
  445. package/dist/simulation/intervention_material.d.ts +4 -0
  446. package/dist/simulation/intervention_material.js +81 -0
  447. package/dist/simulation/living/context.d.ts +3130 -0
  448. package/dist/simulation/living/context.js +944 -0
  449. package/dist/simulation/living/definer.d.ts +12 -0
  450. package/dist/simulation/living/definer.js +223 -0
  451. package/dist/simulation/living/definition.d.ts +257 -0
  452. package/dist/simulation/living/definition.js +341 -0
  453. package/dist/simulation/living/frame.d.ts +259 -0
  454. package/dist/simulation/living/frame.js +223 -0
  455. package/dist/simulation/living/identifiers.d.ts +2 -0
  456. package/dist/simulation/living/identifiers.js +12 -0
  457. package/dist/simulation/living/index.d.ts +15 -0
  458. package/dist/simulation/living/index.js +15 -0
  459. package/dist/simulation/living/inference.d.ts +219 -0
  460. package/dist/simulation/living/inference.js +576 -0
  461. package/dist/simulation/living/mechanics.d.ts +54 -0
  462. package/dist/simulation/living/mechanics.js +588 -0
  463. package/dist/simulation/living/model-input.d.ts +25 -0
  464. package/dist/simulation/living/model-input.js +215 -0
  465. package/dist/simulation/living/open-world.d.ts +257 -0
  466. package/dist/simulation/living/open-world.js +102 -0
  467. package/dist/simulation/living/projection.d.ts +7 -0
  468. package/dist/simulation/living/projection.js +31 -0
  469. package/dist/simulation/living/recall.d.ts +17 -0
  470. package/dist/simulation/living/recall.js +25 -0
  471. package/dist/simulation/living/reduce.d.ts +15 -0
  472. package/dist/simulation/living/reduce.js +1853 -0
  473. package/dist/simulation/living/replay.d.ts +6 -0
  474. package/dist/simulation/living/replay.js +22 -0
  475. package/dist/simulation/living/runtime.d.ts +140 -0
  476. package/dist/simulation/living/runtime.js +3020 -0
  477. package/dist/simulation/living/shared-kinds.d.ts +24 -0
  478. package/dist/simulation/living/shared-kinds.js +96 -0
  479. package/dist/simulation/living/types.d.ts +2785 -0
  480. package/dist/simulation/living/types.js +669 -0
  481. package/dist/simulation/llm.d.ts +3 -1
  482. package/dist/simulation/llm.js +90 -30
  483. package/dist/simulation/memory/embedding.d.ts +1 -1
  484. package/dist/simulation/memory/embedding.js +9 -3
  485. package/dist/simulation/memory/filesystem.d.ts +2 -0
  486. package/dist/simulation/memory/filesystem.js +5 -1
  487. package/dist/simulation/memory/filesystem_file_tree.d.ts +4 -1
  488. package/dist/simulation/memory/filesystem_file_tree.js +41 -10
  489. package/dist/simulation/memory/filesystem_invariants.js +1 -2
  490. package/dist/simulation/memory/filesystem_types.d.ts +1 -0
  491. package/dist/simulation/memory/memory.d.ts +2 -0
  492. package/dist/simulation/memory/memory.js +5 -1
  493. package/dist/simulation/orchestration/intent.js +0 -2
  494. package/dist/simulation/orchestration/lifecycle.js +0 -2
  495. package/dist/simulation/plugin_host.d.ts +25 -1
  496. package/dist/simulation/plugin_host.js +334 -17
  497. package/dist/simulation/session_documents.d.ts +20 -0
  498. package/dist/simulation/session_documents.js +62 -0
  499. package/dist/simulation/session_input_validation.d.ts +43 -0
  500. package/dist/simulation/session_input_validation.js +364 -0
  501. package/dist/simulation/session_inputs.d.ts +32 -0
  502. package/dist/simulation/session_inputs.js +154 -0
  503. package/dist/simulation/telemetry.d.ts +11 -14
  504. package/dist/simulation/telemetry.js +177 -54
  505. package/dist/simulation/toolkit/bounded_turns.d.ts +13 -0
  506. package/dist/simulation/toolkit/bounded_turns.js +80 -0
  507. package/dist/simulation/toolkit/dynamic_agents.d.ts +25 -0
  508. package/dist/simulation/toolkit/dynamic_agents.js +218 -0
  509. package/dist/simulation/toolkit/dynamic_digest.d.ts +1 -0
  510. package/dist/simulation/toolkit/dynamic_digest.js +8 -0
  511. package/dist/simulation/toolkit/dynamic_documents.d.ts +7 -0
  512. package/dist/simulation/toolkit/dynamic_documents.js +71 -0
  513. package/dist/simulation/toolkit/dynamic_driver.d.ts +8 -0
  514. package/dist/simulation/toolkit/dynamic_driver.js +269 -0
  515. package/dist/simulation/toolkit/dynamic_game.d.ts +53 -0
  516. package/dist/simulation/toolkit/dynamic_game.js +805 -0
  517. package/dist/simulation/toolkit/dynamic_knowledge.d.ts +15 -0
  518. package/dist/simulation/toolkit/dynamic_knowledge.js +91 -0
  519. package/dist/simulation/toolkit/dynamic_mechanics.d.ts +22 -0
  520. package/dist/simulation/toolkit/dynamic_mechanics.js +910 -0
  521. package/dist/simulation/toolkit/dynamic_meetings.d.ts +239 -0
  522. package/dist/simulation/toolkit/dynamic_meetings.js +350 -0
  523. package/dist/simulation/toolkit/dynamic_progress.d.ts +131 -0
  524. package/dist/simulation/toolkit/dynamic_progress.js +214 -0
  525. package/dist/simulation/toolkit/dynamic_projection.d.ts +9 -0
  526. package/dist/simulation/toolkit/dynamic_projection.js +219 -0
  527. package/dist/simulation/toolkit/dynamic_runtime.d.ts +412 -0
  528. package/dist/simulation/toolkit/dynamic_runtime.js +6536 -0
  529. package/dist/simulation/toolkit/dynamic_state.d.ts +111 -0
  530. package/dist/simulation/toolkit/dynamic_state.js +1967 -0
  531. package/dist/simulation/toolkit/dynamic_story_review.d.ts +508 -0
  532. package/dist/simulation/toolkit/dynamic_story_review.js +333 -0
  533. package/dist/simulation/toolkit/dynamic_storyteller.d.ts +77 -0
  534. package/dist/simulation/toolkit/dynamic_storyteller.js +114 -0
  535. package/dist/simulation/toolkit/dynamic_storyteller_runtime.d.ts +26 -0
  536. package/dist/simulation/toolkit/dynamic_storyteller_runtime.js +126 -0
  537. package/dist/simulation/toolkit/dynamic_world.d.ts +22 -0
  538. package/dist/simulation/toolkit/dynamic_world.js +377 -0
  539. package/dist/simulation/toolkit/structured_output.d.ts +5 -0
  540. package/dist/simulation/toolkit/structured_output.js +321 -0
  541. package/dist/simulation/types/world.d.ts +2 -0
  542. package/dist/simulation/world/artifact_store.js +1 -1
  543. package/dist/simulation/world/memory_manager.d.ts +5 -0
  544. package/dist/simulation/world/memory_manager.js +17 -2
  545. package/dist/simulation/world/state.d.ts +3 -2
  546. package/dist/simulation/world/state.js +15 -5
  547. package/dist/skills/bundled/measurement-validation/SKILL.md +144 -0
  548. package/dist/terminal_attach.d.ts +1 -0
  549. package/dist/terminal_attach.js +113 -0
  550. package/dist/tool_progress.d.ts +3 -0
  551. package/dist/tool_progress.js +27 -0
  552. package/dist/types.d.ts +145 -10
  553. package/dist/types.js +3 -0
  554. package/dist/ui/core/input.d.ts +3 -0
  555. package/dist/ui/core/input_segments.d.ts +18 -1
  556. package/dist/ui/core/input_segments.js +131 -47
  557. package/dist/ui/core/input_state.d.ts +12 -0
  558. package/dist/ui/core/layout_yoga.d.ts +1 -1
  559. package/dist/ui/core/turn_metadata.d.ts +5 -0
  560. package/dist/ui/core/turn_metadata.js +22 -0
  561. package/dist/ui/ink/render.d.ts +2 -1
  562. package/dist/ui/ink/render.js +6 -5
  563. package/dist/ui/ratatui/headless_pane_manager.d.ts +14 -1
  564. package/dist/ui/ratatui/headless_pane_manager.js +293 -104
  565. package/dist/ui/ratatui/index.d.ts +1 -0
  566. package/dist/ui/ratatui/input.d.ts +4 -0
  567. package/dist/ui/ratatui/input.js +15 -0
  568. package/dist/ui/ratatui/ipc_path.d.ts +2 -0
  569. package/dist/ui/ratatui/ipc_path.js +29 -1
  570. package/dist/ui/ratatui/mux_persistence.d.ts +3 -1
  571. package/dist/ui/ratatui/mux_persistence.js +139 -1
  572. package/dist/ui/ratatui/pane_relay.d.ts +1 -1
  573. package/dist/ui/ratatui/pane_relay.js +55 -27
  574. package/dist/ui/ratatui/process.d.ts +17 -1
  575. package/dist/ui/ratatui/process.js +80 -7
  576. package/dist/ui/ratatui/protocol.d.ts +236 -1
  577. package/dist/ui/ratatui/protocol.js +90 -0
  578. package/dist/ui/scrollback.d.ts +2 -1
  579. package/dist/ui/scrollback.js +9 -4
  580. package/dist/ui/stream_typewriter.d.ts +8 -3
  581. package/dist/ui/stream_typewriter.js +30 -1
  582. package/dist/ui/streaming_scrollback.d.ts +1 -0
  583. package/dist/ui/streaming_scrollback.js +1 -1
  584. package/dist/ui/transcript_render_cache.js +10 -0
  585. package/dist/ui/views/activity_line.d.ts +5 -3
  586. package/dist/ui/views/activity_line.js +65 -7
  587. package/dist/ui/views/app.d.ts +6 -3
  588. package/dist/ui/views/app.js +17 -6
  589. package/dist/ui/views/completion_menu.js +10 -5
  590. package/dist/ui/views/input_area.d.ts +7 -3
  591. package/dist/ui/views/input_area.js +15 -9
  592. package/dist/ui/views/message_list.d.ts +4 -1
  593. package/dist/ui/views/message_list.js +89 -19
  594. package/dist/ui/views/queue_panel.d.ts +3 -1
  595. package/dist/ui/views/queue_panel.js +9 -2
  596. package/dist/ui/views/status_bar.d.ts +4 -2
  597. package/dist/ui/views/status_bar.js +28 -13
  598. package/dist/ui/views/theme.d.ts +2 -0
  599. package/dist/ui/views/theme.js +2 -0
  600. package/dist/ui/widgets/color_panel.js +18 -0
  601. package/dist/ui/widgets/form.js +8 -0
  602. package/dist/ui/widgets/log_view.js +7 -0
  603. package/dist/ui/widgets/navigator_panel.js +8 -0
  604. package/dist/ui/widgets/prompt_viewer.js +2 -0
  605. package/dist/ui/widgets/questionnaire.d.ts +2 -0
  606. package/dist/ui/widgets/questionnaire.js +79 -16
  607. package/dist/ui/widgets/resume_panel.d.ts +2 -0
  608. package/dist/ui/widgets/resume_panel.js +26 -15
  609. package/dist/ui/widgets/rewind_panel.d.ts +2 -2
  610. package/dist/ui/widgets/rewind_panel.js +4 -2
  611. package/dist/ui/widgets/select.js +16 -27
  612. package/dist/ui/widgets/settings_panel.js +16 -0
  613. package/dist/ui/widgets/status_line_panel.d.ts +1 -0
  614. package/dist/ui/widgets/status_line_panel.js +30 -4
  615. package/dist/ui/widgets/text_input.d.ts +2 -0
  616. package/dist/ui/widgets/text_input.js +15 -1
  617. package/dist/ui/widgets/types.d.ts +2 -0
  618. package/dist/usage_projection.d.ts +24 -0
  619. package/dist/usage_projection.js +130 -0
  620. package/dist/usage_snapshot.d.ts +36 -0
  621. package/dist/usage_snapshot.js +131 -0
  622. package/dist/utils/assistant_message.d.ts +2 -0
  623. package/dist/utils/assistant_message.js +5 -0
  624. package/dist/utils/atomic_write.d.ts +6 -2
  625. package/dist/utils/atomic_write.js +29 -4
  626. package/dist/utils/checked_shell.d.ts +25 -0
  627. package/dist/utils/checked_shell.js +107 -0
  628. package/dist/utils/compaction.d.ts +4 -1
  629. package/dist/utils/compaction.js +31 -7
  630. package/dist/utils/context.d.ts +4 -4
  631. package/dist/utils/context.js +14 -12
  632. package/dist/utils/deepseek.d.ts +2 -2
  633. package/dist/utils/deepseek.js +13 -5
  634. package/dist/utils/ephemeral.js +4 -0
  635. package/dist/utils/ephemeral_tools.d.ts +18 -0
  636. package/dist/utils/ephemeral_tools.js +97 -0
  637. package/dist/utils/jev_client.d.ts +4 -0
  638. package/dist/utils/jev_client.js +15 -0
  639. package/dist/utils/model_cache.d.ts +15 -0
  640. package/dist/utils/model_cache.js +143 -0
  641. package/dist/utils/models.d.ts +4 -2
  642. package/dist/utils/models.js +12 -16
  643. package/dist/utils/reasoning.d.ts +8 -1
  644. package/dist/utils/reasoning.js +31 -11
  645. package/dist/utils/router_catalog.d.ts +49 -0
  646. package/dist/utils/router_catalog.js +271 -0
  647. package/dist/utils/sandbox.d.ts +9 -0
  648. package/dist/utils/sandbox.js +118 -15
  649. package/dist/utils/shell.d.ts +7 -0
  650. package/dist/utils/shell.js +98 -34
  651. package/dist/utils/subprocess_env.d.ts +3 -0
  652. package/dist/utils/subprocess_env.js +27 -1
  653. package/dist/web/accounts_mirror.d.ts +3 -1
  654. package/dist/web/accounts_mirror.js +13 -9
  655. package/dist/web/child_publication.d.ts +17 -0
  656. package/dist/web/child_publication.js +45 -0
  657. package/dist/web/mirror_authenticator.d.ts +31 -11
  658. package/dist/web/mirror_authenticator.js +67 -17
  659. package/dist/web/mirror_client.d.ts +31 -4
  660. package/dist/web/mirror_client.js +189 -23
  661. package/dist/web/mirror_stream.d.ts +84 -22
  662. package/dist/web/mirror_stream.js +676 -95
  663. package/dist/web/observer_query_redaction.d.ts +6 -0
  664. package/dist/web/observer_query_redaction.js +58 -0
  665. package/dist/web/pane_registry.d.ts +2 -0
  666. package/dist/web/pane_registry.js +86 -22
  667. package/dist/web/tool_image.d.ts +6 -0
  668. package/dist/web/tool_image.js +17 -0
  669. package/dist/web/view_plugin.d.ts +14 -0
  670. package/dist/web/view_plugin.js +23 -1
  671. package/dist/worker/executor.js +31 -12
  672. package/dist/worker/index.d.ts +1 -0
  673. package/dist/worker/toolsets.js +3 -1
  674. package/dist/worker/types.d.ts +12 -1
  675. package/dist/workflows/registry.js +1 -0
  676. package/dist/workflows/registry_handle.d.ts +2 -0
  677. package/dist/workflows/runtime.d.ts +2 -0
  678. package/dist/workflows/runtime.js +1 -0
  679. package/dist/workspace_agent.d.ts +7 -0
  680. package/dist/workspace_agent.js +36 -0
  681. package/dist/workspace_collision.d.ts +76 -0
  682. package/dist/workspace_collision.js +688 -0
  683. package/dist/workspace_layout.d.ts +18 -0
  684. package/dist/workspace_layout.js +121 -0
  685. package/dist/workspace_runtime.d.ts +44 -0
  686. package/dist/workspace_runtime.js +82 -0
  687. package/dist/workspace_session_context.d.ts +62 -0
  688. package/dist/workspace_session_context.js +160 -0
  689. package/dist/zlm-embed.mjs +32518 -9615
  690. package/dist/zlm.js +1 -0
  691. package/node_modules/@zerg/model-contracts/LICENSE.md +375 -0
  692. package/node_modules/@zerg/model-contracts/README.md +90 -0
  693. package/node_modules/@zerg/model-contracts/index.d.ts +20 -0
  694. package/node_modules/@zerg/model-contracts/index.js +223 -0
  695. package/node_modules/@zerg/model-contracts/package.json +8 -0
  696. package/node_modules/glob/node_modules/brace-expansion/index.js +78 -22
  697. package/node_modules/glob/node_modules/brace-expansion/package.json +1 -1
  698. package/node_modules/readdir-glob/node_modules/brace-expansion/index.js +78 -22
  699. package/node_modules/readdir-glob/node_modules/brace-expansion/package.json +1 -1
  700. package/package.json +45 -24
  701. package/packages/model-contracts/LICENSE.md +375 -0
  702. package/packages/model-contracts/README.md +90 -0
  703. package/packages/model-contracts/index.d.ts +20 -0
  704. package/packages/model-contracts/index.js +223 -0
  705. package/packages/model-contracts/package.json +8 -0
  706. package/remote-broker/Dockerfile +10 -0
  707. package/remote-broker/README.md +308 -0
  708. package/remote-broker/archive.py +1227 -0
  709. package/remote-broker/cutover.py +761 -0
  710. package/remote-broker/requirements.txt +5 -0
  711. package/remote-broker/resources.example.json +6 -0
  712. package/remote-broker/resources.write-staging.example.json +18 -0
  713. package/remote-broker/retained.py +686 -0
  714. package/remote-broker/retained_cleanup.py +550 -0
  715. package/remote-broker/server.py +648 -0
  716. package/scripts/build-remote-broker.mjs +13 -0
  717. package/scripts/ensure-local-packages.mjs +6 -0
  718. package/scripts/node-pty-helpers.mjs +103 -0
@@ -0,0 +1,223 @@
1
+ // Exact reviewed contracts. Add a model here after checking its provider wire
2
+ // and effective controls; names and catalog membership are not capability proof.
3
+ const MODEL_CONTRACTS = new Map([
4
+ ["openai", new Map([
5
+ ["gpt-4o", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":16384}, fallbackRouting: true }],
6
+ ["gpt-4o-mini", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":16384}, fallbackRouting: true }],
7
+ ["gpt-5", { reasoningEfforts: ["minimal","low","medium","high"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
8
+ ["gpt-5-mini", { reasoningEfforts: ["minimal","low","medium","high"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
9
+ ["gpt-5.2", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
10
+ ["gpt-5.2-codex", { reasoningEfforts: [], maxOutputTokens: null, fallbackRouting: false }],
11
+ ["gpt-5.3-codex", { reasoningEfforts: ["low","medium","high","xhigh"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: false }],
12
+ ["gpt-5.4", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], chatToolReasoningEfforts: ["none"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
13
+ ["gpt-5.4-mini", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], chatToolReasoningEfforts: ["none"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
14
+ ["gpt-5.5", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], chatToolReasoningEfforts: ["none"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
15
+ ["gpt-5.6", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], chatToolReasoningEfforts: ["none"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
16
+ ["gpt-5.6-current", { reasoningEfforts: [], maxOutputTokens: null, fallbackRouting: true }],
17
+ ["gpt-5.6-luna", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], chatToolReasoningEfforts: ["none"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
18
+ ["gpt-5.6-sol", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], chatToolReasoningEfforts: ["none"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
19
+ ["gpt-5.6-terra", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], chatToolReasoningEfforts: ["none"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
20
+ ["gpt-6-sol", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], chatToolReasoningEfforts: ["none"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
21
+ ["gpt-6-luna", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], chatToolReasoningEfforts: ["none"], maxOutputTokens: {"min":256,"max":128000}, fallbackRouting: true }],
22
+ ])],
23
+ ["anthropic", new Map([
24
+ ["claude-3-5-haiku-20241022", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":8192}, fallbackRouting: true }],
25
+ ["claude-3-5-sonnet-20241022", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":8192}, fallbackRouting: true }],
26
+ ["claude-opus-4-6", { reasoningEfforts: ["low","medium","high","max"], maxOutputTokens: {"min":256,"max":8192}, fallbackRouting: true }],
27
+ ["claude-opus-4.8", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: {"min":256,"max":8192}, fallbackRouting: true }],
28
+ ["claude-sonnet-4", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":64000}, fallbackRouting: true }],
29
+ ["claude-sonnet-4-5", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":64000}, fallbackRouting: true }],
30
+ ["claude-sonnet-4-6", { reasoningEfforts: ["low","medium","high","max"], maxOutputTokens: {"min":256,"max":64000}, fallbackRouting: true }],
31
+ ["claude-sonnet-4-20250514", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":64000}, fallbackRouting: true }],
32
+ ["claude-opus-4-5", { reasoningEfforts: ["low","medium","high","max"], maxOutputTokens: null, fallbackRouting: true }],
33
+ ["claude-opus-4-8", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: true }],
34
+ ["claude-opus-4-7", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: true }],
35
+ ["claude-opus-5", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: true }],
36
+ ["claude-opus-5-5", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: true }],
37
+ ["claude-sonnet-5", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: true }],
38
+ ["claude-sonnet-5-5", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: true }],
39
+ ["claude-fable-5", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: true }],
40
+ ["claude-fable-5-1", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: true }],
41
+ ["claude-mythos-5", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: true }],
42
+ ["claude-mythos-5-1", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: true }],
43
+ ])],
44
+ ["gemini", new Map([
45
+ ["gemini-2.0-flash", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":8192}, fallbackRouting: true }],
46
+ ["gemini-2.5-flash", { reasoningEfforts: ["none","low","medium","high"], maxOutputTokens: {"min":256,"max":65536}, fallbackRouting: true }],
47
+ ["gemini-2.5-pro", { reasoningEfforts: ["low","medium","high"], maxOutputTokens: {"min":256,"max":65536}, fallbackRouting: true }],
48
+ ["gemini-3.6-flash", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":8192}, fallbackRouting: true }],
49
+ ["gemini-2.5-flash-lite", { reasoningEfforts: ["none","low","medium","high"], maxOutputTokens: {"min":256,"max":65536}, fallbackRouting: true }],
50
+ ["gemini-3-flash-preview", { reasoningEfforts: ["minimal","low","medium","high"], maxOutputTokens: {"min":256,"max":65536}, fallbackRouting: true }],
51
+ ["gemini-3.5-flash", { reasoningEfforts: ["minimal","low","medium","high"], maxOutputTokens: {"min":256,"max":65536}, fallbackRouting: true }],
52
+ ["gemini-3.8-flash", { reasoningEfforts: ["minimal","low","medium","high"], maxOutputTokens: {"min":256,"max":65536}, fallbackRouting: true }],
53
+ ["gemini-3.1-pro-preview", { reasoningEfforts: ["low","high"], maxOutputTokens: {"min":256,"max":65536}, fallbackRouting: true }],
54
+ ])],
55
+ ["deepseek", new Map([
56
+ ["deepseek-flash", { reasoningEfforts: ["none","low","high","max"], maxOutputTokens: {"min":256,"max":384000}, fallbackRouting: true }],
57
+ ["deepseek-chat", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":8192}, fallbackRouting: true }],
58
+ ["deepseek-reasoner", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":8192}, fallbackRouting: true }],
59
+ ["deepseek-v4-flash", { reasoningEfforts: ["none","low","high","max"], maxOutputTokens: {"min":256,"max":384000}, fallbackRouting: true }],
60
+ ["deepseek-v4-flash-vision-exp", { reasoningEfforts: ["none","low","high","max"], maxOutputTokens: {"min":256,"max":384000}, fallbackRouting: true }],
61
+ ["deepseek-v4-pro", { reasoningEfforts: ["none","low","high","max"], maxOutputTokens: {"min":256,"max":384000}, fallbackRouting: true }],
62
+ ])],
63
+ ["kimi", new Map([
64
+ ["kimi-for-coding", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":32000}, fallbackRouting: true }],
65
+ ["kimi-for-coding-highspeed", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":32000}, fallbackRouting: true }],
66
+ ["kimi-k2.6", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":32000}, fallbackRouting: true }],
67
+ ["kimi-k2.7-code", { reasoningEfforts: [], maxOutputTokens: null, fallbackRouting: true }],
68
+ ["kimi-k2.7-code-highspeed", { reasoningEfforts: [], maxOutputTokens: null, fallbackRouting: true }],
69
+ ["kimi-k3", { reasoningEfforts: ["low","high","max"], maxOutputTokens: {"min":256,"max":64000}, fallbackRouting: true }],
70
+ ])],
71
+ ["cohere", new Map([
72
+ ["command-a-03-2025", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":4096}, fallbackRouting: true }],
73
+ ["command-r", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":4096}, fallbackRouting: true }],
74
+ ["command-r-plus", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":4096}, fallbackRouting: true }],
75
+ ["command-a-reasoning-08-2025", { reasoningEfforts: ["none","high"], maxOutputTokens: {"min":256,"max":32000}, fallbackRouting: true }],
76
+ ])],
77
+ ["zai", new Map([
78
+ ["glm-4-air", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":4096}, fallbackRouting: true }],
79
+ ["glm-4-flash", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":4096}, fallbackRouting: true }],
80
+ ["glm-4-plus", { reasoningEfforts: [], maxOutputTokens: {"min":256,"max":4096}, fallbackRouting: true }],
81
+ ["glm-4.5", { reasoningEfforts: ["none","high"], maxOutputTokens: {"min":256,"max":4096}, fallbackRouting: true }],
82
+ ["glm-4.6", { reasoningEfforts: ["none","high"], maxOutputTokens: {"min":256,"max":4096}, fallbackRouting: true }],
83
+ ["glm-4.5-air", { reasoningEfforts: ["none","high"], maxOutputTokens: null, fallbackRouting: true }],
84
+ ["glm-4.7", { reasoningEfforts: ["none","high"], maxOutputTokens: null, fallbackRouting: true }],
85
+ ["glm-5", { reasoningEfforts: ["none","high"], maxOutputTokens: null, fallbackRouting: true }],
86
+ ["glm-5.1", { reasoningEfforts: ["none","high"], maxOutputTokens: null, fallbackRouting: true }],
87
+ ["glm-5.2", { reasoningEfforts: ["none","high","max"], maxOutputTokens: null, fallbackRouting: true }],
88
+ ["glm-5.3", { reasoningEfforts: ["low","high","max"], maxOutputTokens: null, fallbackRouting: true }],
89
+ ["glm-5.3-flash", { reasoningEfforts: ["low","high","max"], maxOutputTokens: null, fallbackRouting: true }],
90
+ ])],
91
+ ["codex", new Map([
92
+ ["gpt-5.2", { reasoningEfforts: ["low","medium","high","xhigh"], maxOutputTokens: null, fallbackRouting: false }],
93
+ ["gpt-5.3-codex", { reasoningEfforts: ["low","medium","high","xhigh"], maxOutputTokens: null, fallbackRouting: false }],
94
+ ["gpt-5.3-codex-spark", { reasoningEfforts: [], maxOutputTokens: null, fallbackRouting: false }],
95
+ ["gpt-5.4", { reasoningEfforts: ["low","medium","high","xhigh"], maxOutputTokens: null, fallbackRouting: false }],
96
+ ["gpt-5.4-mini", { reasoningEfforts: ["low","medium","high","xhigh"], maxOutputTokens: null, fallbackRouting: false }],
97
+ ["gpt-5.5", { reasoningEfforts: ["low","medium","high","xhigh"], maxOutputTokens: null, fallbackRouting: false }],
98
+ ["gpt-5.5-codex", { reasoningEfforts: [], maxOutputTokens: null, fallbackRouting: false }],
99
+ ["gpt-5.6", { reasoningEfforts: ["low","medium","high","xhigh","max","ultra"], maxOutputTokens: null, fallbackRouting: false }],
100
+ ["gpt-5.6-luna", { reasoningEfforts: ["low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: false }],
101
+ ["gpt-5.6-sol", { reasoningEfforts: ["low","medium","high","xhigh","max","ultra"], maxOutputTokens: null, fallbackRouting: false }],
102
+ ["gpt-5.6-terra", { reasoningEfforts: ["low","medium","high","xhigh","max","ultra"], maxOutputTokens: null, fallbackRouting: false }],
103
+ ])],
104
+ ["openai_compatible", new Map([
105
+ ["gpt-6-sol", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], chatToolReasoningEfforts: ["none"], maxOutputTokens: null, fallbackRouting: false }],
106
+ ["gpt-6-luna", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], chatToolReasoningEfforts: ["none"], maxOutputTokens: null, fallbackRouting: false }],
107
+ ])],
108
+ ["modal", new Map([
109
+ ["deepseek-v4.1-flash", { reasoningEfforts: ["none","low","high","xhigh","max"], maxOutputTokens: {"min":256,"max":1048576}, fallbackRouting: false }],
110
+ ["epoch--ep-deepseek-v4-1-flash-server.us-west.modal.direct", { reasoningEfforts: ["none","low","high","xhigh","max"], maxOutputTokens: {"min":256,"max":1048576}, fallbackRouting: false }],
111
+ ["kimi-k3", { reasoningEfforts: ["low","high","max"], maxOutputTokens: null, fallbackRouting: false }],
112
+ ["moonshot--kimi-k3-fast.modal.run", { reasoningEfforts: ["low","high","max"], maxOutputTokens: null, fallbackRouting: false }],
113
+ ])],
114
+ ["fireworks", new Map([
115
+ // Fireworks serverless model library and model specification, verified 2026-10-07.
116
+ // https://fireworks.ai/models/deepseek-ai/deepseek-v4p1-flash
117
+ ["deepseek-v4p1-flash", { reasoningEfforts: ["none","low","high","max"], contextWindow: 1048576, maxOutputTokens: {"min":256,"max":384000}, fallbackRouting: true }],
118
+ ["deepseek-v4-pro-0813", { reasoningEfforts: ["none","low","high","max"], maxOutputTokens: {"min":256,"max":384000}, fallbackRouting: true }],
119
+ ["deepseek-v4-flash-0731", { reasoningEfforts: ["none","low","high","max"], maxOutputTokens: {"min":256,"max":384000}, fallbackRouting: true }],
120
+ ["deepseek-v4-flash-vision-exp", { reasoningEfforts: ["none","low","high","max"], maxOutputTokens: {"min":256,"max":384000}, fallbackRouting: true }],
121
+ ["kimi-k3", { reasoningEfforts: ["none","low","high","max"], maxOutputTokens: null, fallbackRouting: true }],
122
+ ["gpt-oss-120b", { reasoningEfforts: ["low","medium","high"], maxOutputTokens: null, fallbackRouting: true }],
123
+ ["qwen3p8-max", { reasoningEfforts: ["none","low","medium","high","xhigh","max"], maxOutputTokens: null, fallbackRouting: true }],
124
+ ["glm-5p2", { reasoningEfforts: ["none","high","max"], maxOutputTokens: null, fallbackRouting: true }],
125
+ ["glm-5p3", { reasoningEfforts: ["low","high","max"], maxOutputTokens: null, fallbackRouting: true }],
126
+ ["glm-5p3-flash", { reasoningEfforts: ["low","high","max"], maxOutputTokens: null, fallbackRouting: true }],
127
+ ["ember-1", { reasoningEfforts: ["none","high"], maxOutputTokens: null, fallbackRouting: true }],
128
+ ["minimax-m3", { reasoningEfforts: ["none","high"], maxOutputTokens: null, fallbackRouting: true }],
129
+ ["nemotron-lightning-3p5-30b-a3b", { reasoningEfforts: ["none","high"], maxOutputTokens: null, fallbackRouting: true }],
130
+ ["muse-glimmer-30b", { reasoningEfforts: [], maxOutputTokens: null, fallbackRouting: false }],
131
+ ["kimi-k2p7-code", { reasoningEfforts: [], maxOutputTokens: null, fallbackRouting: false }],
132
+ ["nemotron-3-ultra-nvfp4", { reasoningEfforts: [], maxOutputTokens: null, fallbackRouting: false }],
133
+ ["inkling", { reasoningEfforts: [], maxOutputTokens: null, fallbackRouting: false }],
134
+ ["kimi-k2p6", { reasoningEfforts: [], maxOutputTokens: null, fallbackRouting: false }],
135
+ ])],
136
+ ]);
137
+
138
+ export const CONTRACT_PROVIDERS = Object.freeze(["anthropic","openai","gemini","deepseek","fireworks","kimi","voyage","cohere","elevenlabs","replicate","fal","zai","modal","codex","self_hosted","openai_compatible","typesafe"]);
139
+
140
+ export function normalizeContractProvider(provider) {
141
+ const normalized = provider.trim().toLowerCase();
142
+ return normalized === 'moonshot' ? 'kimi' : normalized === 'claude' ? 'anthropic' : normalized;
143
+ }
144
+
145
+ export function normalizeContractModel(provider, model) {
146
+ const canonicalProvider = normalizeContractProvider(provider);
147
+ let id = model.trim().toLowerCase();
148
+ if (id.startsWith(`${canonicalProvider}/`)) id = id.slice(canonicalProvider.length + 1);
149
+ if (canonicalProvider === 'fireworks' && id.startsWith('accounts/fireworks/models/')) {
150
+ id = id.slice('accounts/fireworks/models/'.length);
151
+ }
152
+ return id;
153
+ }
154
+
155
+ export function modelContract(provider, model, surface = 'native_api') {
156
+ const canonicalProvider = normalizeContractProvider(provider);
157
+ const id = normalizeContractModel(canonicalProvider, model);
158
+ const contracts = MODEL_CONTRACTS.get(canonicalProvider);
159
+ const contract = contracts?.get(id)
160
+ ?? (canonicalProvider === 'anthropic' ? contracts?.get(id.replace(/-\d{8}$/, '')) : undefined);
161
+ if (contract === undefined) return undefined;
162
+ // Callers cannot modify the shared policy through a returned array/range.
163
+ return {
164
+ reasoningEfforts: [...(surface === 'chat_tools' ? contract.chatToolReasoningEfforts ?? contract.reasoningEfforts : contract.reasoningEfforts)],
165
+ ...(contract.chatToolReasoningEfforts ? { chatToolReasoningEfforts: [...contract.chatToolReasoningEfforts] } : {}),
166
+ ...(contract.contextWindow === undefined ? {} : { contextWindow: contract.contextWindow }),
167
+ maxOutputTokens: contract.maxOutputTokens === null ? null : { ...contract.maxOutputTokens },
168
+ fallbackRouting: contract.fallbackRouting,
169
+ };
170
+ }
171
+
172
+ export function reasoningRequestParams(provider, model, effort) {
173
+ const canonicalProvider = normalizeContractProvider(provider);
174
+ const id = normalizeContractModel(canonicalProvider, model);
175
+ const contract = modelContract(canonicalProvider, id);
176
+ const selected = typeof effort === 'string' && contract?.reasoningEfforts.includes(effort) ? effort : null;
177
+ // Direct DeepSeek Flash historically enables thinking by default. Fireworks
178
+ // forbids sending thinking alongside reasoning_effort, so never infer its
179
+ // request format from the DeepSeek family name.
180
+ if (canonicalProvider === 'deepseek' && contract?.reasoningEfforts.length) {
181
+ if (selected === 'none') return { thinking: { type: 'disabled' } };
182
+ return { thinking: { type: 'enabled' }, reasoning_effort: selected ?? 'high' };
183
+ }
184
+ if (selected === null) return {};
185
+ if (canonicalProvider === 'anthropic') return { output_config: { effort: selected } };
186
+ if (canonicalProvider === 'gemini') {
187
+ const thinkingConfig = id.startsWith('gemini-2.5-')
188
+ ? { thinkingBudget: selected === 'none' ? 0 : selected === 'low' ? 1024 : selected === 'medium' ? 8192 : id === 'gemini-2.5-pro' ? 32768 : 24576 }
189
+ : { thinkingLevel: selected };
190
+ return { generationConfig: { thinkingConfig } };
191
+ }
192
+ if (canonicalProvider === 'zai') {
193
+ const thinking = { type: selected === 'none' ? 'disabled' : 'enabled' };
194
+ return id === 'glm-5.2' || id === 'glm-5.3' || id === 'glm-5.3-flash'
195
+ ? { thinking, ...(selected === 'none' ? {} : { reasoning_effort: selected }) }
196
+ : { thinking };
197
+ }
198
+ if (canonicalProvider === 'cohere') return { thinking: { type: selected === 'none' ? 'disabled' : 'enabled' } };
199
+ return { reasoning_effort: selected };
200
+ }
201
+
202
+ export function applyReasoningSettings(body, provider, model, effort) {
203
+ // A fallback can cross API dialects. Each attempt owns these fields; remove
204
+ // inherited controls, including provider-native settings supplied by a sandbox.
205
+ for (const field of ['reasoning_effort', 'reasoning', 'thinking', 'output_config',
206
+ 'thinking_config', 'reasoning_history', 'chat_template_kwargs']) delete body[field];
207
+ if (body.generationConfig && typeof body.generationConfig === 'object') {
208
+ const { thinkingConfig, ...rest } = body.generationConfig;
209
+ if (Object.keys(rest).length) body.generationConfig = rest;
210
+ else delete body.generationConfig;
211
+ }
212
+ // Router's canonical OpenAI-shaped envelope stays neutral until dispatch.
213
+ const contract = modelContract(provider, model, 'chat_tools');
214
+ if (typeof effort === 'string' && contract?.reasoningEfforts.includes(effort)) body.reasoning_effort = effort;
215
+ }
216
+
217
+ export function fireworksRequestModel(model) {
218
+ // Direct keys may target a customer's deployment. Router independently
219
+ // enforces its serverless allowlist; this helper never expands that admission.
220
+ const upstream = model.trim().replace(/^fireworks\//i, '');
221
+ if (upstream.startsWith('accounts/')) return upstream;
222
+ return `accounts/fireworks/models/${normalizeContractModel('fireworks', model)}`;
223
+ }
@@ -0,0 +1,8 @@
1
+ {
2
+ "name": "@zerg/model-contracts",
3
+ "version": "0.1.0",
4
+ "type": "module",
5
+ "exports": { ".": { "types": "./index.d.ts", "import": "./index.js" } },
6
+ "files": ["index.js", "index.d.ts", "README.md", "LICENSE.md"],
7
+ "license": "SEE LICENSE IN LICENSE.md"
8
+ }
@@ -23,6 +23,26 @@ var EXPANSION_MAX = 100000
23
23
  // characters) so legitimate input is unaffected.
24
24
  var EXPANSION_MAX_LENGTH = 4000000
25
25
 
26
+ // `expand` recurses once per level of brace *nesting* - both when expanding a
27
+ // set's comma members and when re-wrapping a set whose body is a single part.
28
+ // The CVE-2026-14257 fix made the *tail* iterative (recursion on `m.post`, one
29
+ // level per chained group), which left nesting depth unbounded: about 3,100
30
+ // levels of `{{{...a,b...}}}` - only ~6KB of input - exhausted the native stack
31
+ // and crashed the process. `EXPANSION_MAX_DEPTH` bounds how deep the parser
32
+ // will follow nesting. It sits far above any realistic pattern and well below
33
+ // the depth at which the stack runs out.
34
+ var EXPANSION_MAX_DEPTH = 1000
35
+
36
+ // Bash keeps a quirk where a brace group followed by a comma set still expands
37
+ // (`{a},b}`). The parser implements it by rewriting the string and restarting
38
+ // the scan, absorbing one `}` per pass. `n` trailing braces therefore cost `n`
39
+ // full passes over a string that itself grows by one `escClose` sentinel each
40
+ // time - quadratic in `n`, with a ~26x constant from the sentinel's length.
41
+ // 128KB of `'{a}' + '}'.repeat(n) + ',z}'` blocked the event loop for 27
42
+ // seconds to produce two results. `EXPANSION_MAX_REWRITES` bounds how many
43
+ // times the scan may restart. Real `{a},b}` input needs a handful.
44
+ var EXPANSION_MAX_REWRITES = 1000
45
+
26
46
  function numeric(str) {
27
47
  return parseInt(str, 10) == str
28
48
  ? parseInt(str, 10)
@@ -46,34 +66,54 @@ function unescapeBraces(str) {
46
66
  }
47
67
 
48
68
 
69
+ // Like `target.push(...items)` but doesn't overflow the stack
70
+ function pushAll(target, items) {
71
+ for (var i = 0; i < items.length; i++) {
72
+ target.push(items[i]);
73
+ }
74
+ }
75
+
49
76
  // Basically just str.split(","), but handling cases
50
77
  // where we have nested braced sections, which should be
51
78
  // treated as individual members, like {a,{b,c},d}
52
79
  function parseCommaParts(str) {
53
- if (!str)
54
- return [''];
55
-
56
80
  var parts = [];
57
- var m = balanced('{', '}', str);
58
81
 
59
- if (!m)
60
- return str.split(',');
82
+ // Walk the brace groups iteratively. Recursing on `post` once per group let a
83
+ // chain of them exhaust the stack - the parsing-side counterpart to
84
+ // the `expand` overflow fixed for CVE-2026-14257, and not something `max` or
85
+ // `maxLength` can bound, since it happens before expansion.
86
+ //
87
+ // The part the next chunk continues
88
+ var carry = '';
61
89
 
62
- var pre = m.pre;
63
- var body = m.body;
64
- var post = m.post;
65
- var p = pre.split(',');
90
+ for (;;) {
91
+ var m = balanced('{', '}', str);
66
92
 
67
- p[p.length-1] += '{' + body + '}';
68
- var postParts = parseCommaParts(post);
69
- if (post.length) {
70
- p[p.length-1] += postParts.shift();
71
- p.push.apply(p, postParts);
72
- }
93
+ if (!m) {
94
+ var tail = str.split(',');
95
+ tail[0] = carry + tail[0];
96
+ pushAll(parts, tail);
97
+ return parts;
98
+ }
73
99
 
74
- parts.push.apply(parts, p);
100
+ var pre = m.pre;
101
+ var body = m.body;
102
+ var post = m.post;
103
+ var p = pre.split(',');
75
104
 
76
- return parts;
105
+ p[0] = carry + p[0];
106
+ p[p.length-1] += '{' + body + '}';
107
+
108
+ if (!post.length) {
109
+ pushAll(parts, p);
110
+ return parts;
111
+ }
112
+
113
+ carry = p.pop();
114
+ pushAll(parts, p);
115
+ str = post;
116
+ }
77
117
  }
78
118
 
79
119
  function expandTop(str, options) {
@@ -83,6 +123,8 @@ function expandTop(str, options) {
83
123
  options = options || {};
84
124
  var max = options.max == null ? EXPANSION_MAX : options.max;
85
125
  var maxLength = options.maxLength == null ? EXPANSION_MAX_LENGTH : options.maxLength;
126
+ var maxDepth = options.maxDepth == null ? EXPANSION_MAX_DEPTH : options.maxDepth;
127
+ var maxRewrites = options.maxRewrites == null ? EXPANSION_MAX_REWRITES : options.maxRewrites;
86
128
 
87
129
  // I don't know why Bash 4.3 does this, but it does.
88
130
  // Anything starting with {} will have the first two bytes preserved
@@ -94,7 +136,7 @@ function expandTop(str, options) {
94
136
  str = '\\{\\}' + str.substr(2);
95
137
  }
96
138
 
97
- return expand(escapeBraces(str), max, maxLength, true).map(unescapeBraces);
139
+ return expand(escapeBraces(str), max, maxLength, maxDepth, 0, maxRewrites, true).map(unescapeBraces);
98
140
  }
99
141
 
100
142
  function identity(e) {
@@ -218,8 +260,18 @@ function expand(
218
260
  str,
219
261
  max,
220
262
  maxLength,
263
+ maxDepth,
264
+ depth,
265
+ maxRewrites,
221
266
  isTop
222
267
  ) {
268
+ // Too deeply nested to keep following: treat the rest as literal, the same
269
+ // way a group that cannot expand is already handled. Truncating rather than
270
+ // throwing keeps expansion total, matching `max` and `maxLength`.
271
+ if (depth > maxDepth) {
272
+ return [str];
273
+ }
274
+
223
275
  // Consume the string's top-level brace groups left to right, threading a
224
276
  // running set of combined prefixes (`acc`). Expanding the tail iteratively -
225
277
  // rather than recursing on `m.post` once per group - keeps the native stack
@@ -240,6 +292,9 @@ function expand(
240
292
  // `accBase[a]` records how much of `acc[a]` predates the current run;
241
293
  // `combine` treats an expansion as empty when it adds nothing past that.
242
294
  var accBase = [0]
295
+ // How many times the `{a},b}` rewrite below has restarted the scan. Each pass
296
+ // re-reads the whole string, so leaving this unbounded is quadratic.
297
+ var rewrites = 0
243
298
  var dropEmpties = false
244
299
  var firstGroup = true
245
300
  var nextBase
@@ -271,7 +326,8 @@ function expand(
271
326
  var isOptions = m.body.indexOf(',') >= 0;
272
327
  if (!isSequence && !isOptions) {
273
328
  // {a},b}
274
- if (m.post.match(/,(?!,).*\}/)) {
329
+ if (rewrites < maxRewrites && m.post.match(/,(?!,).*\}/)) {
330
+ rewrites++;
275
331
  str = m.pre + '{' + m.body + escClose + m.post;
276
332
  // The rewritten string is expanded as if it were a fresh top-level one,
277
333
  // so start a new empty-drop run: anchor the baseline at what `acc`
@@ -310,7 +366,7 @@ function expand(
310
366
  var n = parseCommaParts(m.body);
311
367
  if (n.length === 1 && n[0] !== undefined) {
312
368
  // x{{a,b}}y ==> x{a}y x{b}y
313
- n = expand(n[0], max, maxLength, false).map(embrace);
369
+ n = expand(n[0], max, maxLength, maxDepth, depth + 1, maxRewrites, false).map(embrace);
314
370
  //XXX is this necessary? Can't seem to hit it in tests.
315
371
  /* c8 ignore start */
316
372
  if (n.length === 1) {
@@ -349,7 +405,7 @@ function expand(
349
405
  values = []
350
406
  var valuesLength = 0
351
407
  outer: for (var j = 0; j < n.length; j++) {
352
- var expanded = expand(n[j], max, maxLength, false)
408
+ var expanded = expand(n[j], max, maxLength, maxDepth, depth + 1, maxRewrites, false)
353
409
  for (var k = 0; k < expanded.length; k++) {
354
410
  var v = expanded[k]
355
411
  if (dropsEmpties && !v) continue
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "brace-expansion",
3
3
  "description": "Brace expansion as known from sh/bash",
4
- "version": "1.1.18",
4
+ "version": "1.1.21",
5
5
  "repository": {
6
6
  "type": "git",
7
7
  "url": "git://github.com/juliangruber/brace-expansion.git"
@@ -22,6 +22,26 @@ var EXPANSION_MAX = 100000
22
22
  // characters) so legitimate input is unaffected.
23
23
  var EXPANSION_MAX_LENGTH = 4000000
24
24
 
25
+ // `expand` recurses once per level of brace *nesting* - both when expanding a
26
+ // set's comma members and when re-wrapping a set whose body is a single part.
27
+ // The CVE-2026-14257 fix made the *tail* iterative (recursion on `m.post`, one
28
+ // level per chained group), which left nesting depth unbounded: about 3,100
29
+ // levels of `{{{...a,b...}}}` - only ~6KB of input - exhausted the native stack
30
+ // and crashed the process. `EXPANSION_MAX_DEPTH` bounds how deep the parser
31
+ // will follow nesting. It sits far above any realistic pattern and well below
32
+ // the depth at which the stack runs out.
33
+ var EXPANSION_MAX_DEPTH = 1000
34
+
35
+ // Bash keeps a quirk where a brace group followed by a comma set still expands
36
+ // (`{a},b}`). The parser implements it by rewriting the string and restarting
37
+ // the scan, absorbing one `}` per pass. `n` trailing braces therefore cost `n`
38
+ // full passes over a string that itself grows by one `escClose` sentinel each
39
+ // time - quadratic in `n`, with a ~26x constant from the sentinel's length.
40
+ // 128KB of `'{a}' + '}'.repeat(n) + ',z}'` blocked the event loop for 27
41
+ // seconds to produce two results. `EXPANSION_MAX_REWRITES` bounds how many
42
+ // times the scan may restart. Real `{a},b}` input needs a handful.
43
+ var EXPANSION_MAX_REWRITES = 1000
44
+
25
45
  function numeric(str) {
26
46
  return parseInt(str, 10) == str
27
47
  ? parseInt(str, 10)
@@ -45,34 +65,54 @@ function unescapeBraces(str) {
45
65
  }
46
66
 
47
67
 
68
+ // Like `target.push(...items)` but doesn't overflow the stack
69
+ function pushAll(target, items) {
70
+ for (var i = 0; i < items.length; i++) {
71
+ target.push(items[i]);
72
+ }
73
+ }
74
+
48
75
  // Basically just str.split(","), but handling cases
49
76
  // where we have nested braced sections, which should be
50
77
  // treated as individual members, like {a,{b,c},d}
51
78
  function parseCommaParts(str) {
52
- if (!str)
53
- return [''];
54
-
55
79
  var parts = [];
56
- var m = balanced('{', '}', str);
57
80
 
58
- if (!m)
59
- return str.split(',');
81
+ // Walk the brace groups iteratively. Recursing on `post` once per group let a
82
+ // chain of them exhaust the stack - the parsing-side counterpart to
83
+ // the `expand` overflow fixed for CVE-2026-14257, and not something `max` or
84
+ // `maxLength` can bound, since it happens before expansion.
85
+ //
86
+ // The part the next chunk continues
87
+ var carry = '';
60
88
 
61
- var pre = m.pre;
62
- var body = m.body;
63
- var post = m.post;
64
- var p = pre.split(',');
89
+ for (;;) {
90
+ var m = balanced('{', '}', str);
65
91
 
66
- p[p.length-1] += '{' + body + '}';
67
- var postParts = parseCommaParts(post);
68
- if (post.length) {
69
- p[p.length-1] += postParts.shift();
70
- p.push.apply(p, postParts);
71
- }
92
+ if (!m) {
93
+ var tail = str.split(',');
94
+ tail[0] = carry + tail[0];
95
+ pushAll(parts, tail);
96
+ return parts;
97
+ }
98
+
99
+ var pre = m.pre;
100
+ var body = m.body;
101
+ var post = m.post;
102
+ var p = pre.split(',');
103
+
104
+ p[0] = carry + p[0];
105
+ p[p.length-1] += '{' + body + '}';
72
106
 
73
- parts.push.apply(parts, p);
107
+ if (!post.length) {
108
+ pushAll(parts, p);
109
+ return parts;
110
+ }
74
111
 
75
- return parts;
112
+ carry = p.pop();
113
+ pushAll(parts, p);
114
+ str = post;
115
+ }
76
116
  }
77
117
 
78
118
  function expandTop(str, options) {
@@ -82,6 +122,8 @@ function expandTop(str, options) {
82
122
  options = options || {};
83
123
  var max = options.max == null ? EXPANSION_MAX : options.max;
84
124
  var maxLength = options.maxLength == null ? EXPANSION_MAX_LENGTH : options.maxLength;
125
+ var maxDepth = options.maxDepth == null ? EXPANSION_MAX_DEPTH : options.maxDepth;
126
+ var maxRewrites = options.maxRewrites == null ? EXPANSION_MAX_REWRITES : options.maxRewrites;
85
127
 
86
128
  // I don't know why Bash 4.3 does this, but it does.
87
129
  // Anything starting with {} will have the first two bytes preserved
@@ -93,7 +135,7 @@ function expandTop(str, options) {
93
135
  str = '\\{\\}' + str.substr(2);
94
136
  }
95
137
 
96
- return expand(escapeBraces(str), max, maxLength, true).map(unescapeBraces);
138
+ return expand(escapeBraces(str), max, maxLength, maxDepth, 0, maxRewrites, true).map(unescapeBraces);
97
139
  }
98
140
 
99
141
  function embrace(str) {
@@ -205,8 +247,18 @@ function expand(
205
247
  str,
206
248
  max,
207
249
  maxLength,
250
+ maxDepth,
251
+ depth,
252
+ maxRewrites,
208
253
  isTop
209
254
  ) {
255
+ // Too deeply nested to keep following: treat the rest as literal, the same
256
+ // way a group that cannot expand is already handled. Truncating rather than
257
+ // throwing keeps expansion total, matching `max` and `maxLength`.
258
+ if (depth > maxDepth) {
259
+ return [str];
260
+ }
261
+
210
262
  // Consume the string's top-level brace groups left to right, threading a
211
263
  // running set of combined prefixes (`acc`). Expanding the tail iteratively -
212
264
  // rather than recursing on `m.post` once per group - keeps the native stack
@@ -219,6 +271,9 @@ function expand(
219
271
  // comma set - a sequence like `{a..\}` may legitimately yield ''. The drop
220
272
  // is on the final strings, so it is applied to whichever `combine` produces
221
273
  // them (the one with no brace set left in the tail).
274
+ // How many times the `{a},b}` rewrite below has restarted the scan. Each pass
275
+ // re-reads the whole string, so leaving this unbounded is quadratic.
276
+ var rewrites = 0
222
277
  var dropEmpties = false
223
278
  var firstGroup = true
224
279
 
@@ -254,7 +309,8 @@ function expand(
254
309
  var isOptions = m.body.indexOf(',') >= 0;
255
310
  if (!isSequence && !isOptions) {
256
311
  // {a},b}
257
- if (m.post.match(/,(?!,).*\}/)) {
312
+ if (rewrites < maxRewrites && m.post.match(/,(?!,).*\}/)) {
313
+ rewrites++;
258
314
  str = m.pre + '{' + m.body + escClose + m.post;
259
315
  isTop = true;
260
316
  continue;
@@ -282,7 +338,7 @@ function expand(
282
338
  var n = parseCommaParts(m.body);
283
339
  if (n.length === 1 && n[0] !== undefined) {
284
340
  // x{{a,b}}y ==> x{a}y x{b}y
285
- n = expand(n[0], max, maxLength, false).map(embrace);
341
+ n = expand(n[0], max, maxLength, maxDepth, depth + 1, maxRewrites, false).map(embrace);
286
342
  //XXX is this necessary? Can't seem to hit it in tests.
287
343
  /* c8 ignore start */
288
344
  if (n.length === 1) {
@@ -316,7 +372,7 @@ function expand(
316
372
  values = []
317
373
  var valuesLength = 0
318
374
  outer: for (var j = 0; j < n.length; j++) {
319
- var expanded = expand(n[j], max, maxLength, false)
375
+ var expanded = expand(n[j], max, maxLength, maxDepth, depth + 1, maxRewrites, false)
320
376
  for (var k = 0; k < expanded.length; k++) {
321
377
  var v = expanded[k]
322
378
  if (dropsEmpties && !v) continue
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "brace-expansion",
3
3
  "description": "Brace expansion as known from sh/bash",
4
- "version": "2.1.4",
4
+ "version": "2.1.7",
5
5
  "repository": {
6
6
  "type": "git",
7
7
  "url": "git://github.com/juliangruber/brace-expansion.git"