mlx-bun 0.5.0 → 1.0.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 (640) hide show
  1. package/README.md +1449 -109
  2. package/THIRD_PARTY_NOTICES.md +882 -0
  3. package/bin/mlx-bun.convert.mjs +4 -0
  4. package/bin/mlx-bun.fuse.mjs +4 -0
  5. package/bin/mlx-bun.generate.mjs +4 -0
  6. package/bin/mlx-bun.lora.mjs +4 -0
  7. package/bin/mlx-bun.mjs +13 -21
  8. package/bin/mlx-bun.server.mjs +4 -0
  9. package/bin/mlx-bun.upload.mjs +4 -0
  10. package/dist/web/app.js +9584 -0
  11. package/package.json +50 -53
  12. package/src/cli/ane-install.ts +76 -0
  13. package/src/cli/args.ts +179 -0
  14. package/src/cli/engine-entry.ts +68 -0
  15. package/src/cli/inference.ts +214 -0
  16. package/src/cli/job-entry.ts +97 -0
  17. package/src/cli/library-host.ts +117 -0
  18. package/src/cli/main.ts +57 -0
  19. package/src/cli/memory-engine.ts +163 -0
  20. package/src/cli/memory.ts +36 -0
  21. package/src/cli/mlx-lm-aliases.ts +309 -0
  22. package/src/cli/model-choice.ts +33 -0
  23. package/src/cli/model-selection.ts +84 -0
  24. package/src/cli/module-host.ts +11 -0
  25. package/src/cli/module-verbs.ts +50 -0
  26. package/src/cli/numerical-policy.ts +12 -0
  27. package/src/cli/perplexity.ts +89 -0
  28. package/src/cli/serve-host.ts +423 -0
  29. package/src/cli/serve-isolated.ts +217 -0
  30. package/src/cli/serve-options.ts +106 -0
  31. package/src/cli/serve-state.ts +205 -0
  32. package/src/cli/serve.ts +500 -0
  33. package/src/cli/served-model-host.ts +102 -0
  34. package/src/cli/server-entry.ts +148 -0
  35. package/src/cli/serving-unit.ts +177 -0
  36. package/src/{tui.ts → cli/terminal.ts} +13 -8
  37. package/src/cli/worker-adapters.ts +34 -0
  38. package/src/cli/worker-entry.ts +272 -0
  39. package/src/cli/worker-unit.ts +179 -0
  40. package/src/engine/adapter-operation.ts +26 -0
  41. package/src/engine/cache-services.ts +114 -0
  42. package/src/engine/completion.ts +39 -0
  43. package/src/engine/generation-gateway.ts +358 -0
  44. package/src/engine/index.ts +59 -0
  45. package/src/engine/kv-budget.ts +120 -0
  46. package/src/engine/media-preparation.ts +232 -0
  47. package/src/engine/model-binding.ts +24 -0
  48. package/src/engine/model-host.ts +513 -0
  49. package/src/engine/model-serving.ts +89 -0
  50. package/src/{serve → engine}/preparation.ts +7 -5
  51. package/src/{serve → engine}/session-completion-engine.ts +6 -6
  52. package/src/engine/telemetry.ts +109 -0
  53. package/src/hub/downloads.ts +116 -0
  54. package/src/jobs/db.ts +16 -7
  55. package/src/jobs/events.ts +29 -0
  56. package/src/jobs/executable.ts +5 -0
  57. package/src/jobs/host.ts +51 -0
  58. package/src/jobs/in-process.ts +55 -0
  59. package/src/{contracts/jobs.ts → jobs/protocol.ts} +7 -9
  60. package/src/jobs/runner.ts +150 -231
  61. package/src/jobs/service.ts +75 -0
  62. package/src/jobs/sse.ts +59 -23
  63. package/src/jobs/worker-memory.ts +46 -0
  64. package/src/jobs/worker-process.ts +163 -0
  65. package/src/jobs/worker-supervisor.ts +258 -0
  66. package/src/modules.ts +58 -0
  67. package/src/publishing/catalog-hub.ts +18 -0
  68. package/src/publishing/credentials.ts +31 -0
  69. package/src/publishing/upload.ts +37 -0
  70. package/src/residency/leased-adapters.ts +21 -0
  71. package/src/residency/local-records.ts +16 -0
  72. package/src/residency/model-residency.ts +405 -0
  73. package/src/residency/record-index.ts +28 -0
  74. package/src/residency/resident-estimate.ts +50 -0
  75. package/src/{anthropic.ts → server/anthropic.ts} +3 -81
  76. package/src/server/cache-routes.ts +36 -0
  77. package/src/{serve → server}/chat-request.ts +10 -10
  78. package/src/{serve → server}/chat-stage.ts +14 -14
  79. package/src/{client.ts → server/client.ts} +28 -2
  80. package/src/{serve → server}/completion-executor.ts +33 -41
  81. package/src/server/decision-body.ts +55 -0
  82. package/src/server/decision-routes.ts +134 -0
  83. package/src/server/decision-wire.ts +228 -0
  84. package/src/{serve → server}/discovery-routes.ts +25 -82
  85. package/src/{serve → server}/http.ts +25 -13
  86. package/src/{serve → server}/inference-request.ts +5 -5
  87. package/src/server/job-routes.ts +20 -0
  88. package/src/server/media-prompt.ts +63 -0
  89. package/src/server/memory-completion-client.ts +46 -0
  90. package/src/server/model-routes.ts +192 -0
  91. package/src/{serve → server}/openai-wire.ts +3 -2
  92. package/src/{serve → server}/pipeline.ts +1 -1
  93. package/src/server/prompt-builder.ts +13 -0
  94. package/src/server/prompt-contracts.ts +17 -0
  95. package/src/server/proxy-routes.ts +187 -0
  96. package/src/server/publishing-routes.ts +41 -0
  97. package/src/{serve → server}/request-plan.ts +6 -8
  98. package/src/{serve → server}/request-prep.ts +47 -50
  99. package/src/{serve → server}/responses-client.ts +30 -13
  100. package/src/{responses.ts → server/responses.ts} +12 -93
  101. package/src/server/routes.ts +205 -0
  102. package/src/server/start.ts +72 -0
  103. package/src/server/status-routes.ts +108 -0
  104. package/src/{serve → server}/text-completion-stage.ts +25 -4
  105. package/src/server/text-prompt.ts +12 -0
  106. package/src/{serve → server}/token-streams.ts +36 -38
  107. package/src/server/worker-routes.ts +311 -0
  108. package/src/storage/paths.ts +61 -0
  109. package/src/web/assets.ts +37 -0
  110. package/src/web/{src → browser}/api.ts +5 -23
  111. package/src/web/browser/chat-host.ts +17 -0
  112. package/src/web/browser/installed-panels.ts +6 -0
  113. package/src/web/browser/main.ts +55 -0
  114. package/src/web/browser/markdown.ts +279 -0
  115. package/src/web/browser/memory-panel.ts +9 -0
  116. package/src/web/browser/palette.ts +64 -0
  117. package/src/web/browser/protocol.ts +13 -0
  118. package/src/web/browser/shell.ts +467 -0
  119. package/src/web/{src → browser}/status.ts +32 -36
  120. package/src/web/build.ts +51 -0
  121. package/src/web/public/app.html +1054 -0
  122. package/src/web/{sw.js → public/sw.js} +4 -3
  123. package/src/web/{vendor → public/vendor}/hljs-theme.css +2 -2
  124. package/src/web/{vendor → public/vendor}/hljs.js +2 -2
  125. package/THIRD_PARTY_LICENSES.md +0 -51
  126. package/docs/README.md +0 -107
  127. package/docs/archive/hlg-sampling.md +0 -350
  128. package/docs/archive/investigations/audio-input-plan.md +0 -356
  129. package/docs/archive/investigations/benchmark-ledger-through-v0.4.0.md +0 -3617
  130. package/docs/archive/investigations/chunk-finetune-experiment.md +0 -84
  131. package/docs/archive/investigations/colibri-glm52-port.md +0 -1486
  132. package/docs/archive/investigations/colibri-oracle-pin.md +0 -1284
  133. package/docs/archive/investigations/curve-bisector-routing.md +0 -123
  134. package/docs/archive/investigations/decode-roofline-lookagain.md +0 -348
  135. package/docs/archive/investigations/diffusion-gemma-port.md +0 -602
  136. package/docs/archive/investigations/dspark-handoff.md +0 -224
  137. package/docs/archive/investigations/expert-offload-single-user-moe.md +0 -292
  138. package/docs/archive/investigations/faithful-l1-consolidation.md +0 -310
  139. package/docs/archive/investigations/hlg-sampling-investigation.md +0 -970
  140. package/docs/archive/investigations/indexshare-performance-spike.md +0 -357
  141. package/docs/archive/investigations/kernel-perf-review-2026-07.md +0 -171
  142. package/docs/archive/investigations/lab-build-journal.md +0 -157
  143. package/docs/archive/investigations/minicpm5-decode-megakernel.md +0 -489
  144. package/docs/archive/investigations/openjarvis-fit.md +0 -198
  145. package/docs/archive/investigations/openwiki-evaluation.md +0 -249
  146. package/docs/archive/investigations/optimization_plan.md +0 -346
  147. package/docs/archive/investigations/orpo-base-uf-experiment-and-directions.md +0 -120
  148. package/docs/archive/investigations/orpo-flash-cce-pin-leak.md +0 -167
  149. package/docs/archive/investigations/orpo-uf-testing-handoff.md +0 -126
  150. package/docs/archive/investigations/pareto-specialized-runtime-findings.md +0 -92
  151. package/docs/archive/investigations/pi-builtin-investigation.md +0 -308
  152. package/docs/archive/investigations/pre-colibri-stabilization.md +0 -329
  153. package/docs/archive/investigations/qwen38-27b-campaign-log.md +0 -1092
  154. package/docs/archive/investigations/segmented-backward-handoff.md +0 -148
  155. package/docs/archive/investigations/starter-model-port-handoff.md +0 -342
  156. package/docs/archive/investigations/steel-flash-cce-handoff.md +0 -489
  157. package/docs/archive/investigations/the-dreaming-handoff.md +0 -141
  158. package/docs/archive/investigations/trainer-validation-experiment.md +0 -173
  159. package/docs/archive/planning/chat-ui-vision-memory-first.md +0 -199
  160. package/docs/archive/planning/chat-ui-vision.md +0 -50
  161. package/docs/archive/planning/chunk-task-roadmap.md +0 -77
  162. package/docs/archive/planning/curve-sampler-research-plan.md +0 -331
  163. package/docs/archive/planning/journal.md +0 -316
  164. package/docs/archive/planning/memory-docs-and-dag-plan.md +0 -194
  165. package/docs/archive/planning/pi-integration-review.md +0 -178
  166. package/docs/archive/planning/release-notes-v0.0.10.md +0 -57
  167. package/docs/archive/planning/release-notes-v0.0.11.md +0 -239
  168. package/docs/archive/planning/release-notes-v0.0.12.md +0 -80
  169. package/docs/archive/planning/release-notes-v0.0.13.md +0 -77
  170. package/docs/archive/planning/release-notes-v0.0.9.md +0 -122
  171. package/docs/archive/planning/release-notes-v0.2.0.md +0 -49
  172. package/docs/archive/planning/release-notes-v0.3.0.md +0 -35
  173. package/docs/archive/planning/release-notes-v0.4.0.md +0 -45
  174. package/docs/archive/planning/release-notes-v0.5.0.md +0 -37
  175. package/docs/archive/planning/web-ui-pass-plan.md +0 -213
  176. package/docs/archive/planning/website-readme-pass-plan.md +0 -224
  177. package/docs/design/batching.md +0 -2054
  178. package/docs/design/decode-speed-program.md +0 -2404
  179. package/docs/design/dreaming-nightly-pipeline.md +0 -684
  180. package/docs/design/generic-model-support.md +0 -821
  181. package/docs/design/kv-cache.md +0 -993
  182. package/docs/design/orpo-training.md +0 -680
  183. package/docs/design/speculative-decoding.md +0 -2129
  184. package/docs/design/turboquant.md +0 -2225
  185. package/docs/design/unified-engine-frontier-plan.md +0 -1987
  186. package/docs/design/web-chat-redesign.md +0 -695
  187. package/docs/planning/PRODUCT_ROADMAP.md +0 -593
  188. package/docs/planning/ResearchTopics.md +0 -119
  189. package/docs/planning/public-readiness-handoff.md +0 -244
  190. package/docs/planning/public-readiness.md +0 -149
  191. package/docs/planning/video-series.md +0 -421
  192. package/docs/reference/benchmarks.md +0 -3587
  193. package/docs/reference/cli.md +0 -646
  194. package/docs/reference/distribution.md +0 -380
  195. package/docs/reference/environment.md +0 -494
  196. package/docs/reference/glossary.md +0 -39
  197. package/docs/reference/library-api.md +0 -688
  198. package/docs/reference/memory.md +0 -260
  199. package/docs/reference/models.md +0 -346
  200. package/docs/reference/server-api.md +0 -1945
  201. package/docs/reference/server-config.md +0 -973
  202. package/docs/reference/training.md +0 -462
  203. package/docs/reference/troubleshooting.md +0 -158
  204. package/src/admission-plan.ts +0 -18
  205. package/src/audio/audiotoolbox.ts +0 -112
  206. package/src/audio/conformer.ts +0 -655
  207. package/src/audio/decode.ts +0 -133
  208. package/src/audio/features.ts +0 -202
  209. package/src/audio/mic-capture.ts +0 -98
  210. package/src/audio/silero-vad.ts +0 -379
  211. package/src/audio/transcode.ts +0 -67
  212. package/src/audio/whisper-decode.ts +0 -774
  213. package/src/audio/whisper-fast.ts +0 -732
  214. package/src/audio/whisper-format.ts +0 -73
  215. package/src/audio/whisper-mel.ts +0 -185
  216. package/src/audio/whisper-timing.ts +0 -274
  217. package/src/audio/whisper-tokenizer.ts +0 -239
  218. package/src/audio/whisper-transcribe.ts +0 -410
  219. package/src/backends/mlx/assistant-target.ts +0 -46
  220. package/src/backends/mlx/autoregressive-draft-rows.ts +0 -120
  221. package/src/backends/mlx/autoregressive.ts +0 -129
  222. package/src/backends/mlx/batch-group.ts +0 -1874
  223. package/src/backends/mlx/cache-attachment.ts +0 -67
  224. package/src/backends/mlx/cache-layout.ts +0 -31
  225. package/src/backends/mlx/checkpoint-state.ts +0 -53
  226. package/src/backends/mlx/continuation-persistence.ts +0 -107
  227. package/src/backends/mlx/continuation-request.ts +0 -43
  228. package/src/backends/mlx/continuation.ts +0 -77
  229. package/src/backends/mlx/diffusion.ts +0 -39
  230. package/src/backends/mlx/draft-target.ts +0 -32
  231. package/src/backends/mlx/encoder-cache.ts +0 -25
  232. package/src/backends/mlx/evaluation.ts +0 -105
  233. package/src/backends/mlx/fill-append.ts +0 -58
  234. package/src/backends/mlx/fill-group.ts +0 -497
  235. package/src/backends/mlx/full-kv-row-append.ts +0 -32
  236. package/src/backends/mlx/full-kv-row-donor.ts +0 -54
  237. package/src/backends/mlx/full-transitioning-kv-rows.ts +0 -65
  238. package/src/backends/mlx/gateway-binding.ts +0 -174
  239. package/src/backends/mlx/graph.ts +0 -38
  240. package/src/backends/mlx/kv-codec.ts +0 -9
  241. package/src/backends/mlx/kv-maintenance.ts +0 -161
  242. package/src/backends/mlx/kv-tensor-rows.ts +0 -212
  243. package/src/backends/mlx/memory-client.ts +0 -189
  244. package/src/backends/mlx/methods.ts +0 -90
  245. package/src/backends/mlx/mixed-iteration.ts +0 -62
  246. package/src/backends/mlx/model-prompt.ts +0 -178
  247. package/src/backends/mlx/model-serving.ts +0 -80
  248. package/src/backends/mlx/paged-cache-codec.ts +0 -27
  249. package/src/backends/mlx/prefill-cohort.ts +0 -100
  250. package/src/backends/mlx/prefill-policy.ts +0 -26
  251. package/src/backends/mlx/prefill-rows.ts +0 -244
  252. package/src/backends/mlx/prefill.ts +0 -33
  253. package/src/backends/mlx/projected-context-rows.ts +0 -72
  254. package/src/backends/mlx/prompt-input.ts +0 -29
  255. package/src/backends/mlx/qwen-prompt-input.ts +0 -40
  256. package/src/backends/mlx/request-policy.ts +0 -20
  257. package/src/backends/mlx/request-state-policy.ts +0 -54
  258. package/src/backends/mlx/rollback.ts +0 -92
  259. package/src/backends/mlx/row-sampling.ts +0 -49
  260. package/src/backends/mlx/serial-executor.ts +0 -251
  261. package/src/backends/mlx/speculative-group.ts +0 -438
  262. package/src/backends/mlx/speculative-round.ts +0 -161
  263. package/src/backends/mlx/speculative.ts +0 -131
  264. package/src/backends/mlx/state-rows.ts +0 -104
  265. package/src/backends/mlx/state-views.ts +0 -46
  266. package/src/backends/mlx/target-layout-capability.ts +0 -35
  267. package/src/backends/mlx/text-engine.ts +0 -73
  268. package/src/backends/mlx/transitioning-kv-rows.ts +0 -173
  269. package/src/chat-template.ts +0 -382
  270. package/src/cli.ts +0 -3490
  271. package/src/config.ts +0 -399
  272. package/src/contracts/completion.ts +0 -16
  273. package/src/contracts/execution.ts +0 -70
  274. package/src/contracts/generation.ts +0 -103
  275. package/src/contracts/host.ts +0 -7
  276. package/src/contracts/object-cache.ts +0 -8
  277. package/src/contracts/pi-provider.ts +0 -30
  278. package/src/contracts/pi.ts +0 -261
  279. package/src/contracts/prefix-cache.ts +0 -33
  280. package/src/contracts/resources.ts +0 -25
  281. package/src/contracts/sampling.ts +0 -23
  282. package/src/contracts/scheduling.ts +0 -54
  283. package/src/contracts/tsconfig.json +0 -14
  284. package/src/dataset/generators.ts +0 -1087
  285. package/src/dataset/index.ts +0 -12
  286. package/src/dataset/job.ts +0 -81
  287. package/src/dataset/llm.ts +0 -71
  288. package/src/dataset/registry.ts +0 -528
  289. package/src/diffusion/diffusion-generate.ts +0 -507
  290. package/src/download.ts +0 -505
  291. package/src/embed.ts +0 -77
  292. package/src/engine/admission.ts +0 -59
  293. package/src/engine/cancellation.ts +0 -38
  294. package/src/engine/engine.ts +0 -56
  295. package/src/engine/execution-coordinator.ts +0 -70
  296. package/src/engine/execution-plan.ts +0 -64
  297. package/src/engine/execution-tasks.ts +0 -44
  298. package/src/engine/namespaced-cache.ts +0 -13
  299. package/src/engine/resources.ts +0 -53
  300. package/src/engine/scheduler.ts +0 -92
  301. package/src/engine/session.ts +0 -247
  302. package/src/eval/README.md +0 -130
  303. package/src/eval/ifeval.ts +0 -81
  304. package/src/eval/kl-prompts.ts +0 -29
  305. package/src/eval/kl.ts +0 -590
  306. package/src/eval/perplexity.ts +0 -164
  307. package/src/eval/quality-db.ts +0 -92
  308. package/src/eval/reference-logits.ts +0 -207
  309. package/src/eval/runner.ts +0 -124
  310. package/src/eval/score.ts +0 -49
  311. package/src/eval/tasks/bfcl.ts +0 -535
  312. package/src/eval/tasks/gsm8k.ts +0 -98
  313. package/src/eval/tasks/hashhop.ts +0 -139
  314. package/src/eval/tasks/humaneval.ts +0 -275
  315. package/src/eval/tasks/ifeval.ts +0 -525
  316. package/src/eval/tasks/mmlu.ts +0 -157
  317. package/src/eval/ultrafeedback.ts +0 -60
  318. package/src/evaldb.ts +0 -199
  319. package/src/expert-io.ts +0 -393
  320. package/src/expert-offload-build.ts +0 -77
  321. package/src/expert-offload.ts +0 -76
  322. package/src/expert-residency.ts +0 -1134
  323. package/src/expert-usage.ts +0 -415
  324. package/src/fill/echo-index.ts +0 -188
  325. package/src/fill/fill-session.ts +0 -463
  326. package/src/fill/proposal.ts +0 -68
  327. package/src/fill/schema-rows.ts +0 -506
  328. package/src/fill/tool-boundary.ts +0 -103
  329. package/src/fit.ts +0 -249
  330. package/src/generate.ts +0 -1352
  331. package/src/grammar.ts +0 -604
  332. package/src/harness-pi.ts +0 -184
  333. package/src/hf-push.ts +0 -628
  334. package/src/hub-rest.ts +0 -242
  335. package/src/index.ts +0 -63
  336. package/src/inference/denoising.ts +0 -17
  337. package/src/inference/draft-acceptance.ts +0 -41
  338. package/src/inference/draft-output.ts +0 -49
  339. package/src/inference/graph.ts +0 -33
  340. package/src/inference/prefill.ts +0 -45
  341. package/src/inference/rollback.ts +0 -7
  342. package/src/jobs/index.ts +0 -31
  343. package/src/jobs/job-entry.ts +0 -107
  344. package/src/jobs/task-client.ts +0 -19
  345. package/src/jobs/types.ts +0 -2
  346. package/src/kv-scheme.ts +0 -279
  347. package/src/kv-store.ts +0 -1135
  348. package/src/lab/README.md +0 -22
  349. package/src/lab/curve/curve-designer.html +0 -303
  350. package/src/lab/curve/curve-sampler.ts +0 -122
  351. package/src/lab/expert-trace/expert-trace.ts +0 -69
  352. package/src/lab/paged-kv/paged-attention.ts +0 -117
  353. package/src/lab/paged-kv/paged-kv-rows.ts +0 -111
  354. package/src/lab/paged-kv/paged-kv.ts +0 -336
  355. package/src/library.ts +0 -40
  356. package/src/lora.ts +0 -408
  357. package/src/md-modules.d.ts +0 -54
  358. package/src/media-fetch.ts +0 -442
  359. package/src/memory/article.ts +0 -558
  360. package/src/memory/chunk-validation.ts +0 -150
  361. package/src/memory/chunk.ts +0 -318
  362. package/src/memory/cluster.ts +0 -351
  363. package/src/memory/coverage.ts +0 -134
  364. package/src/memory/crosslink.ts +0 -0
  365. package/src/memory/db.ts +0 -253
  366. package/src/memory/entity.ts +0 -203
  367. package/src/memory/gate.ts +0 -187
  368. package/src/memory/history.ts +0 -152
  369. package/src/memory/ingest.ts +0 -335
  370. package/src/memory/model.ts +0 -183
  371. package/src/memory/normalize.ts +0 -671
  372. package/src/memory/parse.ts +0 -22
  373. package/src/memory/pipeline.ts +0 -275
  374. package/src/memory/prompts.ts +0 -65
  375. package/src/memory/query.ts +0 -334
  376. package/src/memory/reconcile.ts +0 -734
  377. package/src/memory/redirect.ts +0 -108
  378. package/src/memory/reindex.ts +0 -325
  379. package/src/memory/resolve.ts +0 -307
  380. package/src/memory/rest.ts +0 -245
  381. package/src/memory/route.ts +0 -272
  382. package/src/memory/schedule.ts +0 -165
  383. package/src/memory/stages.ts +0 -777
  384. package/src/memory/synthesize.ts +0 -1638
  385. package/src/memory/tools.ts +0 -749
  386. package/src/memory/vault.ts +0 -1194
  387. package/src/memory/wikify.ts +0 -1064
  388. package/src/mlx/array.ts +0 -425
  389. package/src/mlx/autograd.ts +0 -304
  390. package/src/mlx/checkpoint.ts +0 -149
  391. package/src/mlx/compile.ts +0 -168
  392. package/src/mlx/custom-vjp.ts +0 -188
  393. package/src/mlx/ffi.ts +0 -531
  394. package/src/mlx/materialize.ts +0 -23
  395. package/src/mlx/metal-kernel.ts +0 -159
  396. package/src/mlx/normalized-argmax.ts +0 -116
  397. package/src/mlx/ops.ts +0 -1108
  398. package/src/mlx/quantized-rows.ts +0 -36
  399. package/src/mlx/token-bitmask.ts +0 -52
  400. package/src/mlx/turboquant-kv-decode.ts +0 -82
  401. package/src/mlx/turboquant-kv-inverse.ts +0 -122
  402. package/src/mlx/turboquant-ops.ts +0 -861
  403. package/src/mlx/turboquant-tables.ts +0 -237
  404. package/src/mmap.ts +0 -90
  405. package/src/model/artifact-identity.ts +0 -73
  406. package/src/model/batched-kv.ts +0 -235
  407. package/src/model/batched-mask.ts +0 -279
  408. package/src/model/batched-quant.ts +0 -212
  409. package/src/model/batched-quantized-kv.ts +0 -144
  410. package/src/model/batched-rotating-quant.ts +0 -353
  411. package/src/model/batched-rotating-state.ts +0 -149
  412. package/src/model/batched-rotating.ts +0 -338
  413. package/src/model/batched-row-storage.ts +0 -179
  414. package/src/model/batched-ssm.ts +0 -52
  415. package/src/model/batched-turboquant-kv.ts +0 -94
  416. package/src/model/compiled-decode.ts +0 -712
  417. package/src/model/decoded-kv-donor.ts +0 -12
  418. package/src/model/delayed-quantized-kv.ts +0 -72
  419. package/src/model/delayed-rotating-quantized-kv.ts +0 -93
  420. package/src/model/delayed-turboquant-kv.ts +0 -57
  421. package/src/model/diffusion-gemma.ts +0 -1026
  422. package/src/model/factory.ts +0 -215
  423. package/src/model/fingerprint.ts +0 -45
  424. package/src/model/flash-attention.ts +0 -694
  425. package/src/model/full-prefill-padding.ts +0 -56
  426. package/src/model/full-prefill-row.ts +0 -105
  427. package/src/model/gemma4-base.ts +0 -2370
  428. package/src/model/gemma4.ts +0 -1395
  429. package/src/model/generated/gemma4-12b.ts +0 -429
  430. package/src/model/generated/gemma4-26b.ts +0 -448
  431. package/src/model/generated/gemma4-e4b.ts +0 -717
  432. package/src/model/generated/index.ts +0 -18
  433. package/src/model/glm52-atlas.ts +0 -511
  434. package/src/model/glm52-cache.ts +0 -792
  435. package/src/model/glm52-config.ts +0 -262
  436. package/src/model/glm52-container.ts +0 -305
  437. package/src/model/glm52-coupling.ts +0 -388
  438. package/src/model/glm52-dsa.ts +0 -606
  439. package/src/model/glm52-expert-layout.ts +0 -253
  440. package/src/model/glm52-layout.ts +0 -152
  441. package/src/model/glm52-memory.ts +0 -500
  442. package/src/model/glm52-mla.ts +0 -792
  443. package/src/model/glm52-moe.ts +0 -223
  444. package/src/model/glm52-pilot.ts +0 -537
  445. package/src/model/glm52-reference.ts +0 -445
  446. package/src/model/glm52-residency.ts +0 -557
  447. package/src/model/glm52-resident-weights.ts +0 -135
  448. package/src/model/glm52-streamed-experts.ts +0 -453
  449. package/src/model/glm52-streamed-metal.ts +0 -610
  450. package/src/model/glm52-weights.ts +0 -503
  451. package/src/model/glm52.ts +0 -1132
  452. package/src/model/implementation.ts +0 -69
  453. package/src/model/kv-attention-view.ts +0 -70
  454. package/src/model/minicpm5.ts +0 -376
  455. package/src/model/profile.ts +0 -468
  456. package/src/model/quantized-append-attention.ts +0 -31
  457. package/src/model/qwen-append.ts +0 -12
  458. package/src/model/qwen-conv.ts +0 -52
  459. package/src/model/qwen3-delta-state.ts +0 -74
  460. package/src/model/qwen3-delta.ts +0 -451
  461. package/src/model/qwen3-moe.ts +0 -404
  462. package/src/model/qwen3-mrope.ts +0 -250
  463. package/src/model/qwen3.ts +0 -277
  464. package/src/model/qwen3_5-checkpoint.ts +0 -164
  465. package/src/model/qwen3_5.ts +0 -881
  466. package/src/model/rotating-kv-donor.ts +0 -35
  467. package/src/model/rotating-kv-layout.ts +0 -262
  468. package/src/model/rotating-row-transaction.ts +0 -35
  469. package/src/model/speculative-rotating-kv.ts +0 -101
  470. package/src/model/ssm-prefill-padding.ts +0 -39
  471. package/src/model/support.ts +0 -110
  472. package/src/model/token-groups.ts +0 -66
  473. package/src/model/trellis-balanced-scatter.ts +0 -51
  474. package/src/model/trellis-linear.ts +0 -672
  475. package/src/model/trellis-shared-m.ts +0 -151
  476. package/src/model/trellis-shared-scatter.ts +0 -144
  477. package/src/model/trellis-splitk-prefill.ts +0 -158
  478. package/src/model/trellis-tiled-prefill.ts +0 -136
  479. package/src/model/trellis-vector-expand.ts +0 -62
  480. package/src/model/trellis-wide-prefill.ts +0 -94
  481. package/src/model/turboquant-codec.ts +0 -89
  482. package/src/model/universal/archs.ts +0 -332
  483. package/src/model/universal/dense.ts +0 -612
  484. package/src/model/universal/modules.ts +0 -170
  485. package/src/model/universal/rope.ts +0 -381
  486. package/src/model/whisper.ts +0 -435
  487. package/src/native/expert_io.c +0 -523
  488. package/src/native/frame_extract.swift +0 -140
  489. package/src/native/mic_capture.swift +0 -92
  490. package/src/native-pack.ts +0 -163
  491. package/src/pi-provider.ts +0 -53
  492. package/src/pi-session.ts +0 -81
  493. package/src/pi-terminal.ts +0 -274
  494. package/src/pi-web.ts +0 -1940
  495. package/src/preflight.ts +0 -158
  496. package/src/prompt-cache.ts +0 -682
  497. package/src/quantize/allocator.ts +0 -627
  498. package/src/quantize/atomic-output.ts +0 -38
  499. package/src/quantize/calibration.ts +0 -181
  500. package/src/quantize/config-writer.ts +0 -145
  501. package/src/quantize/index.ts +0 -84
  502. package/src/quantize/job.ts +0 -162
  503. package/src/quantize/quantizer.ts +0 -666
  504. package/src/quantize/rotate.ts +0 -603
  505. package/src/quantize/safetensors-writer.ts +0 -249
  506. package/src/quantize/sensitivity.ts +0 -216
  507. package/src/quantize/trellis.ts +0 -586
  508. package/src/quantize/weight-transform.ts +0 -292
  509. package/src/registry.ts +0 -602
  510. package/src/runtime-config.ts +0 -77
  511. package/src/safetensors.ts +0 -165
  512. package/src/sampler.ts +0 -1012
  513. package/src/serve/admin-routes.ts +0 -184
  514. package/src/serve/assets/curve-terrain.html +0 -105
  515. package/src/serve/assets/training-inference-map.html +0 -575
  516. package/src/serve/audio-routes.ts +0 -323
  517. package/src/serve/aux-routes.ts +0 -132
  518. package/src/serve/batch-scheduler.ts +0 -8
  519. package/src/serve/checkpoint-identity.ts +0 -64
  520. package/src/serve/generation-gateway.ts +0 -537
  521. package/src/serve/isolate.ts +0 -609
  522. package/src/serve/kv-budget.ts +0 -14
  523. package/src/serve/lab-routes.ts +0 -341
  524. package/src/serve/lane-registry.ts +0 -45
  525. package/src/serve/model-admin-routes.ts +0 -155
  526. package/src/serve/model-binding.ts +0 -49
  527. package/src/serve/model-host.ts +0 -511
  528. package/src/serve/parent-application.ts +0 -56
  529. package/src/serve/prompt-response-trace.ts +0 -161
  530. package/src/serve/response-lease.ts +0 -24
  531. package/src/serve/session-search.ts +0 -326
  532. package/src/serve/static-routes.ts +0 -101
  533. package/src/serve/transcription-server.ts +0 -64
  534. package/src/serve/transcription-service.ts +0 -502
  535. package/src/server.ts +0 -1282
  536. package/src/spec/assistant-rows.ts +0 -93
  537. package/src/spec/assistant-source.ts +0 -126
  538. package/src/spec/cache-identity.ts +0 -22
  539. package/src/spec/deepspec-rows.ts +0 -29
  540. package/src/spec/deepspec-source.ts +0 -145
  541. package/src/spec/dflash-source.ts +0 -149
  542. package/src/spec/drafter.ts +0 -304
  543. package/src/spec/dspark/ab-stats.ts +0 -136
  544. package/src/spec/dspark/calibration.ts +0 -112
  545. package/src/spec/dspark/data-dflash.ts +0 -156
  546. package/src/spec/dspark/data.ts +0 -201
  547. package/src/spec/dspark/deepspec-module.ts +0 -776
  548. package/src/spec/dspark/generate-dflash.ts +0 -245
  549. package/src/spec/dspark/generate.ts +0 -290
  550. package/src/spec/dspark/loader.ts +0 -23
  551. package/src/spec/dspark/loss.ts +0 -213
  552. package/src/spec/dspark/module-dflash.ts +0 -560
  553. package/src/spec/dspark/module.ts +0 -540
  554. package/src/spec/dspark/quantize-drafter.ts +0 -91
  555. package/src/spec/dspark/sample.ts +0 -112
  556. package/src/spec/generate.ts +0 -276
  557. package/src/spec/glm52-mtp-graph.ts +0 -29
  558. package/src/spec/glm52-mtp-rows.ts +0 -132
  559. package/src/spec/glm52-mtp-source.ts +0 -318
  560. package/src/spec/glm52-mtp-state.ts +0 -33
  561. package/src/spec/ngram-source.ts +0 -226
  562. package/src/spec/projected-draft-rows.ts +0 -73
  563. package/src/spec/qwen-mtp-module.ts +0 -171
  564. package/src/spec/qwen-mtp-rows.ts +0 -230
  565. package/src/spec/qwen-mtp-source.ts +0 -386
  566. package/src/spec/qwen-mtp-state.ts +0 -30
  567. package/src/spec/serve-loop.ts +0 -587
  568. package/src/spec/source.ts +0 -228
  569. package/src/spec/two-model-rows.ts +0 -62
  570. package/src/spec/two-model.ts +0 -113
  571. package/src/ssd-cache.ts +0 -431
  572. package/src/ssd-durability.ts +0 -209
  573. package/src/storage/host-buffer.ts +0 -24
  574. package/src/storage/kv-writer.ts +0 -83
  575. package/src/storage/kv-writer.worker.js +0 -264
  576. package/src/storage/retention-policy.ts +0 -37
  577. package/src/tiered-prompt-cache.ts +0 -45
  578. package/src/tokenizer.ts +0 -335
  579. package/src/tool-approvals.ts +0 -131
  580. package/src/tool-call.ts +0 -695
  581. package/src/train/dataset.ts +0 -484
  582. package/src/train/diffusion-lora.ts +0 -216
  583. package/src/train/export.ts +0 -32
  584. package/src/train/flash-cce.ts +0 -1234
  585. package/src/train/forward.ts +0 -266
  586. package/src/train/fuse.ts +0 -243
  587. package/src/train/index.ts +0 -46
  588. package/src/train/job.ts +0 -205
  589. package/src/train/lora-params.ts +0 -254
  590. package/src/train/loss.ts +0 -1591
  591. package/src/train/merge.ts +0 -195
  592. package/src/train/optimizer.ts +0 -183
  593. package/src/train/prefix-shared.ts +0 -490
  594. package/src/train/rank.ts +0 -137
  595. package/src/train/segmented.ts +0 -1828
  596. package/src/train/steel-qmm-header.ts +0 -1461
  597. package/src/train/trainer.ts +0 -1221
  598. package/src/train/watch.ts +0 -542
  599. package/src/vision/diffusion-vision.ts +0 -620
  600. package/src/vision/embedder.ts +0 -176
  601. package/src/vision/preprocess.ts +0 -247
  602. package/src/vision/prompt.ts +0 -409
  603. package/src/vision/qwen3vl-preprocess.ts +0 -409
  604. package/src/vision/qwen3vl-prompt.ts +0 -233
  605. package/src/vision/qwen3vl-tower.ts +0 -566
  606. package/src/vision/siglip.ts +0 -607
  607. package/src/vision/video-frames.ts +0 -148
  608. package/src/web/app.html +0 -2155
  609. package/src/web/app.js +0 -5863
  610. package/src/web/skills/memory/SKILL.md +0 -120
  611. package/src/web/skills/web-research/SKILL.md +0 -46
  612. package/src/web/skills.ts +0 -97
  613. package/src/web/src/adapters-panel.ts +0 -288
  614. package/src/web/src/assistant.ts +0 -451
  615. package/src/web/src/chat.ts +0 -1060
  616. package/src/web/src/composer.ts +0 -962
  617. package/src/web/src/dataset.ts +0 -132
  618. package/src/web/src/finetune.ts +0 -267
  619. package/src/web/src/hub.ts +0 -428
  620. package/src/web/src/main.ts +0 -98
  621. package/src/web/src/markdown.ts +0 -0
  622. package/src/web/src/memory-panel.ts +0 -572
  623. package/src/web/src/model-picker.ts +0 -159
  624. package/src/web/src/palette.ts +0 -346
  625. package/src/web/src/protocol.ts +0 -26
  626. package/src/web/src/quantize.ts +0 -167
  627. package/src/web/src/rag.ts +0 -274
  628. package/src/web/src/sessions.ts +0 -469
  629. package/src/web/src/shell.ts +0 -804
  630. package/src/web/src/ui-catalog.ts +0 -78
  631. package/src/web/src/voice.ts +0 -141
  632. package/src/web/vendor/README.md +0 -61
  633. package/src/web-assets.ts +0 -47
  634. package/src/web-tools.ts +0 -478
  635. package/src/weights.ts +0 -255
  636. /package/src/{serve → server}/completion-sink.ts +0 -0
  637. /package/src/{serve → server}/generated-token-history.ts +0 -0
  638. /package/src/web/{icon.svg → public/icon.svg} +0 -0
  639. /package/src/web/{manifest.webmanifest → public/manifest.webmanifest} +0 -0
  640. /package/src/web/{vendor → public/vendor}/hljs-LICENSE +0 -0
@@ -0,0 +1,41 @@
1
+ import type { createHfCredentials } from "../publishing/credentials";
2
+ import type { createPublisher, PublishRequest } from "../publishing/upload";
3
+
4
+ /** HTTP parsing and wire errors stay above credential and publishing policy. */
5
+ export function createPublishingRoutes(options: {
6
+ credentials: ReturnType<typeof createHfCredentials>;
7
+ publish: ReturnType<typeof createPublisher>;
8
+ }) {
9
+ const error = (message: string, status = 400) => Response.json({ ok: false, error: message }, { status });
10
+ return { async handle(request: Request): Promise<Response | null> {
11
+ const path = new URL(request.url).pathname;
12
+ const settings = path === "/api/settings/hf-token";
13
+ const push = path.match(/^\/api\/(quantize|finetune|dataset)\/push$/);
14
+ if (!(settings && ["GET", "POST"].includes(request.method)) && !(push && request.method === "POST")) return null;
15
+ try {
16
+ request.signal.throwIfAborted();
17
+ if (settings && request.method === "GET") return Response.json({ ok: true, hasToken: options.credentials.get() !== null });
18
+ const raw: unknown = await request.json().catch(() => null);
19
+ request.signal.throwIfAborted();
20
+ if (!raw || typeof raw !== "object" || Array.isArray(raw)) return error("expected a JSON object");
21
+ const body = raw as Record<string, unknown>;
22
+ if (settings) {
23
+ if (typeof body.token !== "string" || !body.token.trim()) return error("token required");
24
+ options.credentials.save(body.token);
25
+ return Response.json({ ok: true });
26
+ }
27
+ if (typeof body.repo_id !== "string" || !body.repo_id.trim()) return error("repo_id required");
28
+ for (const key of ["job_id", "source_path"] as const) {
29
+ if (body[key] != null && (typeof body[key] !== "string" || !body[key].trim())) return error(`${key} must be a nonempty string`);
30
+ }
31
+ if (body.private != null && typeof body.private !== "boolean") return error("private must be a boolean");
32
+ const result = await options.publish({ kind: push![1] as PublishRequest["kind"], repoId: body.repo_id,
33
+ private: body.private as boolean | undefined, sourcePath: body.source_path as string | undefined,
34
+ jobId: body.job_id as string | undefined, signal: request.signal });
35
+ return Response.json({ ok: true, url: result.url });
36
+ } catch (failure) {
37
+ if (request.signal.aborted) return error("Request cancelled", 499);
38
+ return error(failure instanceof Error ? failure.message : String(failure));
39
+ }
40
+ } };
41
+ }
@@ -1,9 +1,9 @@
1
- import { snapshotGenerationPolicy } from "../backends/mlx/request-policy";
2
- import type { GenerateOptions } from "../generate";
3
- import type { RequestShape } from "./generation-gateway";
4
- import type { DisposableResource } from "../contracts/resources";
5
- import { disposeResources, ownResource } from "../engine/resources";
6
- export type { DisposableResource } from "../contracts/resources";
1
+ import { snapshotGenerationPolicy } from "@mlx-bun/inference/execution/request-policy";
2
+ import type { GenerateOptions } from "@mlx-bun/inference/generation";
3
+ import type { RequestShape } from "../engine/completion";
4
+ import type { DisposableResource } from "@mlx-bun/inference/contracts/portable";
5
+ import { disposeResources, ownResource } from "@mlx-bun/inference/runtime/resources";
6
+ export type { DisposableResource } from "@mlx-bun/inference/contracts/portable";
7
7
 
8
8
  export class RequestOwnership {
9
9
  #owner = ownResource(new Set<DisposableResource>(), disposeResources);
@@ -147,8 +147,6 @@ export function planRequest(input: RequestPlanInput): PlanRequestResult {
147
147
  ),
148
148
  wantsLogprobs: captureLogprobs,
149
149
  userSeed: input.userSeed,
150
- kvQuant: !!(options.kvConfig?.length || options.kvBits),
151
- turboQuant: !!options.turboQuant,
152
150
  hasGrammar: input.hasGrammar,
153
151
  hasDraft: input.hasDraft,
154
152
  };
@@ -1,23 +1,24 @@
1
+ import { requireChatTemplate } from "../engine/model-host";
2
+ import { textPrompt } from "./text-prompt";
1
3
  // Per-request preparation shared by every completion surface (chat,
2
4
  // raw text, /signal, /generate): request → GenerateOptions with the
3
5
  // server/model defaults folded in, chat-template rendering + prompt ids,
4
6
  // the stable prompt-cache boundary probe, grammar compilation, and the
5
7
  // tool-call stream router. Resolved ONCE per server (createRequestPrep) and
6
- // captured by the route handlers. Extracted from src/server.ts (repo-taming
7
- // Phase 4).
8
- import type { ChatMessage, ToolDefinition } from "../chat-template";
8
+ // captured by the route handlers.
9
+ import type { ChatMessage, ToolDefinition } from "@mlx-bun/inference/input";
9
10
  import {
10
11
  fillEchoConfig,
11
12
  fillMaxSpan,
12
13
  FillSession,
13
14
  resolveFillMode,
14
- } from "../fill/fill-session";
15
- import { compileStrictFillRows, type StrictRowPlan } from "../fill/schema-rows";
16
- import type { GenerateOptions } from "../generate";
17
- import { compileGrammarRequest, grammarEnabled, type GrammarRequest } from "../grammar";
18
- import type { KvSchemeOptions } from "../kv-scheme";
19
- import { isMiniCPM5Config } from "../model/support";
20
- import type { HlgConfig } from "../sampler";
15
+ } from "@mlx-bun/inference/generation/fill";
16
+ import { compileStrictFillRows, type StrictRowPlan } from "@mlx-bun/inference/generation/fill";
17
+ import type { GenerateOptions } from "@mlx-bun/inference/generation";
18
+ import type { GrammarRequest } from "@mlx-bun/inference/sampling/grammar";
19
+ import { runtimeValue } from "@mlx-bun/inference/runtime/config";
20
+ import { GENERIC_GENERATION_DEFAULTS } from "@mlx-bun/inference/models/profile";
21
+ import type { HlgConfig } from "@mlx-bun/inference/sampling";
21
22
  import {
22
23
  nextDefaultSeed,
23
24
  normalizeMessages,
@@ -26,7 +27,7 @@ import {
26
27
  resolveHlg,
27
28
  type ChatRequestParams,
28
29
  } from "./chat-request";
29
- import type { ServingContext } from "./model-host";
30
+ import type { LoadedModelContext as ModelContext } from "../engine/model-host";
30
31
  import type { PromptTokenHistory } from "./generated-token-history";
31
32
  import { selectToolStreamMode, ToolAwareStream, type ToolStreamMode } from "./token-streams";
32
33
 
@@ -38,21 +39,18 @@ export interface RequestPrepOptions {
38
39
  defaultTopP?: number;
39
40
  defaultTopK?: number;
40
41
  hlg?: HlgConfig;
41
- pagedKv?: { blockSize?: number };
42
42
  }
43
43
 
44
44
  export function createRequestPrep(input: {
45
- ctx: ServingContext;
45
+ ctx: ModelContext;
46
46
  serverOptions: RequestPrepOptions;
47
- /** The server-wide KV scheme (resolveKvScheme(...).generationOptions),
48
- * spread into every request's GenerateOptions. */
49
- kvScheme: KvSchemeOptions;
50
- /** `--max-tokens` / the GLM memory plan's generation cap; undefined = the
47
+ /** `--max-tokens` / a runtime memory plan's generation cap; undefined = the
51
48
  * surface's own default (chat 65 536, raw completion 512). */
52
49
  defaultGeneratedTokens: number | undefined;
53
50
  tokenHistory?: PromptTokenHistory;
54
51
  }) {
55
- const { ctx, serverOptions, kvScheme, defaultGeneratedTokens } = input;
52
+ const { ctx, serverOptions, defaultGeneratedTokens } = input;
53
+ const generationDefaults = ctx.generationDefaults ?? GENERIC_GENERATION_DEFAULTS;
56
54
 
57
55
  // XTC never removes EOS or the newline token: mlx_lm.server passes
58
56
  // [tokenizer.eos_token_id, tokenizer.encode("\n")] as xtc_special_tokens.
@@ -67,31 +65,31 @@ export function createRequestPrep(input: {
67
65
 
68
66
  // Effective enable_thinking for a request, with the same precedence the chat
69
67
  // template uses (extracted so sampling and template rendering can't disagree):
70
- // explicit chat_template_kwargs.enable_thinking → reasoning_effort ("none" =
71
- // off) → server --thinking default → model default (MiniCPM5 → off). undefined
68
+ // explicit chat_template_kwargs.enable_thinking (null = template default) → reasoning_effort ("none" =
69
+ // off) → server --thinking default → the model's declared default. undefined
72
70
  // means "not a switchable-thinking model / leave the template default".
73
71
  const resolveEnableThinking = (req: ChatRequestParams): boolean | undefined => {
74
72
  const explicit = req.chat_template_kwargs?.enable_thinking;
73
+ if (explicit === null) return undefined;
75
74
  if (typeof explicit === "boolean") return explicit;
76
75
  const effort = req.reasoning_effort;
77
76
  if (effort !== undefined) return effort !== "none";
78
77
  if (serverOptions.defaultThinking !== undefined) return serverOptions.defaultThinking;
79
- return isMiniCPM5Config(ctx.model.config) ? false : undefined;
78
+ return generationDefaults.enableThinking;
80
79
  };
81
80
 
82
81
  const toOptions = (req: ChatRequestParams): GenerateOptions & { stopSequences: string[] } => {
83
82
  // Sampling follows the thinking state — which the web UI's thinking button
84
83
  // drives via enable_thinking. Model authors publish a SINGLE
85
84
  // generation_config temperature (the think-mode value) but recommend a
86
- // cooler one for direct, no-think replies (MiniCPM5 card: 0.9 think / 0.7
87
- // no-think, top_p 0.95 for both). So with no explicit temperature set, a
88
- // no-think turn runs at most NO_THINK_TEMPERATURE while a think turn keeps
89
- // the model's hotter configured default. An explicit request/CLI
90
- // temperature always wins. top_p is unchanged by mode.
91
- const NO_THINK_TEMPERATURE = 0.7;
85
+ // cooler one for direct, no-think replies. So with no explicit temperature
86
+ // set, a no-think turn runs at most the model's declared
87
+ // noThinkTemperatureCap while a think turn keeps the model's hotter
88
+ // configured default. An explicit request/CLI temperature always wins.
89
+ // top_p is unchanged by mode.
92
90
  const genTemp = ctx.genDefaults.temperature ?? 0.7;
93
91
  const defaultTemp = resolveEnableThinking(req) === false
94
- ? Math.min(genTemp, NO_THINK_TEMPERATURE)
92
+ ? Math.min(genTemp, generationDefaults.noThinkTemperatureCap)
95
93
  : genTemp;
96
94
  return {
97
95
  cacheSessionId: typeof req.session_id === "string" ? req.session_id :
@@ -124,10 +122,6 @@ export function createRequestPrep(input: {
124
122
  // decode layer below and halts the loop via onToken → false.
125
123
  stopSequences: (typeof req.stop === "string" ? [req.stop] : req.stop ?? [])
126
124
  .filter((s) => typeof s === "string" && s.length > 0),
127
- ...kvScheme,
128
- // Paged KV is a server-wide mode like the kv scheme above (v1:
129
- // serial bf16 gemma4 — the createServer refusals hold the invariants).
130
- ...(serverOptions.pagedKv ? { pagedKv: serverOptions.pagedKv } : {}),
131
125
  };
132
126
  };
133
127
 
@@ -138,13 +132,14 @@ export function createRequestPrep(input: {
138
132
  * + Warning header (oMLX parity — never 500). Honors MLX_BUN_GRAMMAR=0. */
139
133
  const compileGrammarForRequest = async (
140
134
  req: ChatRequestParams,
141
- ): Promise<{ controller: import("../grammar").GrammarController | null; degradeHint: string | null }> => {
142
- if (!grammarEnabled()) {
135
+ ): Promise<{ controller: import("@mlx-bun/inference/sampling/grammar").GrammarController | null; degradeHint: string | null }> => {
136
+ if (runtimeValue("MLX_BUN_GRAMMAR") === "0") {
143
137
  return {
144
138
  controller: null,
145
139
  degradeHint: "grammar compilation disabled by MLX_BUN_GRAMMAR=0",
146
140
  };
147
141
  }
142
+ const { compileGrammarRequest } = await import("@mlx-bun/inference/sampling/grammar");
148
143
  const r = await compileGrammarRequest(
149
144
  req as GrammarRequest,
150
145
  ctx.tokenizer,
@@ -154,11 +149,11 @@ export function createRequestPrep(input: {
154
149
  return { controller: r.controller, degradeHint: r.degradeHint };
155
150
  };
156
151
 
157
- // Map OpenAI reasoning_effort levels onto the Qwen3.8 template's supported
158
- // set (xhigh|medium|low — the template raises on anything else). "none"
152
+ // Map OpenAI reasoning_effort levels onto the depth set a template that reads
153
+ // `reasoning_effort` supports (xhigh|medium|low — such a template raises on anything else). "none"
159
154
  // means thinking off (handled by resolveEnableThinking), so no depth is
160
155
  // passed. Only consumed for templates with readsReasoningEffort.
161
- const qwenReasoningEffort = (
156
+ const templateReasoningEffort = (
162
157
  effort: ChatRequestParams["reasoning_effort"],
163
158
  ): "xhigh" | "medium" | "low" | undefined => {
164
159
  switch (effort) {
@@ -181,7 +176,7 @@ export function createRequestPrep(input: {
181
176
  return {
182
177
  tools,
183
178
  enableThinking: resolveEnableThinking(req),
184
- reasoningEffort: qwenReasoningEffort(req.reasoning_effort),
179
+ reasoningEffort: templateReasoningEffort(req.reasoning_effort),
185
180
  preserveThinking: req.chat_template_kwargs?.preserve_thinking,
186
181
  };
187
182
  };
@@ -190,12 +185,11 @@ export function createRequestPrep(input: {
190
185
  req: ChatRequestParams,
191
186
  tools: ToolDefinition[] | null,
192
187
  ): { ids: number[]; startInThinking: boolean } => {
188
+ // A context without a template serves only through a supplied prompt builder.
189
+ requireChatTemplate(ctx);
193
190
  const opts = templateOptionsFor(req, tools);
194
- const rendered = ctx.template.render(normalizeMessages(req.messages), opts);
195
- const ids = ctx.tokenizer.encode(rendered);
196
- // template includes <bos>; tokenizer post-processor also prepends one
197
- const trimmed = ids[0] === ids[1] && ids[0] === ctx.tokenizer.bosTokenId ? ids.slice(1) : ids;
198
- return { ids: input.tokenHistory?.resolve(rendered, trimmed) ?? trimmed,
191
+ const { rendered, ids } = textPrompt(ctx.template, ctx.tokenizer, normalizeMessages(req.messages), opts);
192
+ return { ids: input.tokenHistory?.resolve(rendered, ids) ?? ids,
199
193
  startInThinking: promptEndsInOpenThink(rendered) };
200
194
  };
201
195
 
@@ -218,6 +212,8 @@ export function createRequestPrep(input: {
218
212
  tools: ToolDefinition[] | null,
219
213
  trimmed: number[],
220
214
  ): number => {
215
+ // Outside the best-effort probe: a builder asking for it needs a template.
216
+ requireChatTemplate(ctx);
221
217
  const opts = templateOptionsFor(req, tools);
222
218
  const mode = `${opts.enableThinking}|${!!tools?.length}|${opts.reasoningEffort ?? ""}|${opts.preserveThinking ?? ""}`;
223
219
  const primer = primerLenByMode.get(mode);
@@ -260,16 +256,15 @@ export function createRequestPrep(input: {
260
256
  };
261
257
 
262
258
  const toolStreamMode = (tools: ToolDefinition[] | null): ToolStreamMode =>
263
- // Gemma-4 keeps the token-level sentinel path; every other family
264
- // (MiniCPM5, Qwen3/3.5, Tier-0 generics) emits tool calls as DECODED TEXT
265
- // — see selectToolStreamMode for why sentinel ids must stay family-gated.
266
- selectToolStreamMode(ctx.model.config.modelType, !!tools?.length);
259
+ // A model that declares sentinel tokens keeps the token-level path; every
260
+ // other model emits tool calls as DECODED TEXT — see selectToolStreamMode.
261
+ selectToolStreamMode(ctx.sentinels, !!tools?.length);
267
262
 
268
263
  const toolRouter = (
269
264
  tools: ToolDefinition[] | null,
270
265
  onParseFailure?: () => void,
271
266
  ): ToolAwareStream =>
272
- new ToolAwareStream(ctx.tokenizer, toolStreamMode(tools), tools, onParseFailure);
267
+ new ToolAwareStream(ctx.tokenizer, toolStreamMode(tools), tools, onParseFailure, ctx.sentinels);
273
268
 
274
269
  /** Strict fill rows are a function of (template mode, tool signature) only —
275
270
  * they are token spans of the assistant turn, which opens with a special
@@ -285,13 +280,13 @@ export function createRequestPrep(input: {
285
280
  (t.function?.parameters?.additionalProperties as unknown) ?? null,
286
281
  ]));
287
282
 
288
- /** Token fast-forwarding (docs/design/speculative-decoding.md "Token
283
+ /** Token fast-forwarding (`02d723a:docs/design/speculative-decoding.md` §7 "Token
289
284
  * fast-forwarding"): compile this request's determined-span table, or null
290
285
  * when the feature is off or the request's shape refuses it.
291
286
  *
292
287
  * Refusals owned here (body-level); the ones only ChatStage can see —
293
288
  * a compiled grammar, media prompts and a mounted draft model — are applied
294
- * there. The execution binding owns cache-format and method support. Strict
289
+ * there. The execution binding owns method support (every cache serves it). Strict
295
290
  * shared execution keeps the sampler's absolute token positions, including
296
291
  * known tokens; an explicit seed therefore remains replayable.
297
292
  *
@@ -306,6 +301,8 @@ export function createRequestPrep(input: {
306
301
  const mode = resolveFillMode();
307
302
  if (mode === "off") return null;
308
303
  if (!tools?.length) return null;
304
+ // The determined spans come from the template; a builder-only context has none.
305
+ if (!ctx.template) return null;
309
306
  // Seed support is selected by the execution binding after placement.
310
307
  // Injected tokens are never sampled — they have no logprob row.
311
308
  if (req.logprobs === true) return null;
@@ -1,21 +1,32 @@
1
- import { ResponseStore, resolveResponsesConversation, type ResponseHistory, type ResponsesRequest } from "../responses";
1
+ // The parent's Responses conversation history in the isolated server (main's
2
+ // responses-client.ts): `previous_response_id` resolves against the parent's
3
+ // store, the resolved conversation goes to the worker without one, and the
4
+ // completed record is remembered here, so history survives worker restarts.
5
+ // The worker keeps its own bounded store for the requests it answers; the
6
+ // parent never consults it.
7
+ import { ResponseStore, resolveResponsesConversation, type ResponseHistory, type ResponsesRequest } from "./responses";
8
+
9
+ const responsesError = (status: number, message: string) => Response.json({ error: {
10
+ message, type: "invalid_request_error", param: null, code: null,
11
+ } }, { status });
2
12
 
3
- /** Application-owned conversation history over a data-only HTTP host. Workers
4
- * translate/run the request; the parent stores only completed response records. */
5
13
  export function createResponsesClient(store: ResponseHistory = new ResponseStore()) {
6
14
  return {
7
15
  get stats() { return { entries: store.size, bytes: store.totalBytes, max_bytes: store.maxBytes, ttl_ms: store.ttlMs }; },
16
+ /** `forward` sends the rewritten request to the worker and returns its response as is. */
8
17
  async forward(request: Request, forward: (request: Request) => Promise<Response>): Promise<Response> {
9
- const error = (status: number, message: string) => Response.json({ error: {
10
- message, type: "invalid_request_error", param: null, code: null,
11
- } }, { status });
12
18
  let body: ResponsesRequest;
13
19
  try { body = await request.json() as ResponsesRequest; }
14
- catch { return error(400, "invalid JSON body"); }
15
- if (!body || typeof body !== "object" || Array.isArray(body)) return error(400, "invalid JSON body");
20
+ catch { return responsesError(400, "invalid JSON body"); }
21
+ if (!body || typeof body !== "object" || Array.isArray(body)) return responsesError(400, "invalid JSON body");
22
+ // The container is validated before the previous id resolves, as the
23
+ // worker does: only a missing or expired previous response is a 404.
24
+ if ((body.input != null && typeof body.input !== "string" && !Array.isArray(body.input)) ||
25
+ (body.previous_response_id != null && typeof body.previous_response_id !== "string"))
26
+ return responsesError(400, "input must be a string or array; previous_response_id must be a string");
16
27
  let conversation: ReturnType<typeof resolveResponsesConversation>;
17
28
  try { conversation = resolveResponsesConversation(body, store); }
18
- catch (e) { return error(404, (e as Error).message); }
29
+ catch (error) { return responsesError(404, error instanceof Error ? error.message : String(error)); }
19
30
  const headers = new Headers(request.headers);
20
31
  headers.delete("content-length");
21
32
  headers.set("x-mlx-bun-response-owner", "parent");
@@ -32,15 +43,20 @@ export function createResponsesClient(store: ResponseHistory = new ResponseStore
32
43
  if (!body.stream) {
33
44
  const value = await response.json() as Record<string, unknown>;
34
45
  remember(value);
35
- const headers = new Headers(response.headers); headers.delete("content-length");
36
- return Response.json(restorePrevious(value), { status: response.status, headers });
46
+ const outputHeaders = new Headers(response.headers);
47
+ outputHeaders.delete("content-length");
48
+ return Response.json(restorePrevious(value), { status: response.status, headers: outputHeaders });
37
49
  }
38
50
  if (!response.body) return response;
39
51
  const decoder = new TextDecoder(), encoder = new TextEncoder();
40
52
  let pending = "";
53
+ // Frames the worker did not shape as JSON (keep-alive comments, [DONE])
54
+ // pass through; `response.completed` is remembered and every response
55
+ // object gets the previous id the caller sent.
41
56
  const rewrite = (frame: string): string => frame.replace(/^data: (.+)$/m, (line, data: string) => {
42
57
  if (data === "[DONE]") return line;
43
- const event = JSON.parse(data) as Record<string, unknown>;
58
+ let event: Record<string, unknown>;
59
+ try { event = JSON.parse(data) as Record<string, unknown>; } catch { return line; }
44
60
  if (event.response && typeof event.response === "object") {
45
61
  const value = event.response as Record<string, unknown>;
46
62
  if (event.type === "response.completed") remember(value);
@@ -48,7 +64,8 @@ export function createResponsesClient(store: ResponseHistory = new ResponseStore
48
64
  }
49
65
  return `data: ${JSON.stringify(event)}`;
50
66
  });
51
- const outputHeaders = new Headers(response.headers); outputHeaders.delete("content-length");
67
+ const outputHeaders = new Headers(response.headers);
68
+ outputHeaders.delete("content-length");
52
69
  return new Response(response.body.pipeThrough(new TransformStream<Uint8Array, Uint8Array>({
53
70
  transform(chunk, controller) {
54
71
  pending += decoder.decode(chunk, { stream: true });
@@ -1,5 +1,5 @@
1
1
  // OpenAI Responses API translation layer + response store for the
2
- // mlx-bun server (Phase 11).
2
+ // mlx-bun server.
3
3
  //
4
4
  // Ported from: mlx-optiq optiq/responses_shim.py (MIT) —
5
5
  // responses_to_openai_body / openai_to_responses_response /
@@ -20,7 +20,7 @@
20
20
  import type {
21
21
  CompletionEvent,
22
22
  CompletionStreamProtocol,
23
- } from "./serve/completion-sink";
23
+ } from "./completion-sink";
24
24
 
25
25
  // ---------------------------------------------------------------------
26
26
  // Response store (previous_response_id resumption)
@@ -815,6 +815,7 @@ export function createResponsesStreamProtocol(
815
815
  ): CompletionStreamProtocol {
816
816
  const translator = new ResponsesStreamTranslator(model, previousResponseId);
817
817
  const chunk = (delta: Record<string, unknown>) => ({ choices: [{ delta }] });
818
+ let failure: string | undefined;
818
819
  return {
819
820
  start: () => translator.addChunk(chunk({ role: "assistant", content: "" })),
820
821
  addEvents(events: CompletionEvent[]) {
@@ -831,14 +832,19 @@ export function createResponsesStreamProtocol(
831
832
  });
832
833
  },
833
834
  finish(reason, usage) {
834
- const frames = [
835
- ...translator.addChunk({ choices: [{ delta: {}, finish_reason: reason }], usage }),
836
- ...translator.finalize(),
837
- ];
835
+ const frames = translator.addChunk({ choices: [{ delta: {}, finish_reason: reason }], usage });
836
+ // The shared sink finishes after reporting an error. Give clients a
837
+ // terminal response without saving failed output as resumable history.
838
+ if (failure !== undefined) return [...frames, sse("response.failed", {
839
+ type: "response.failed", response: { ...translator.finalResponse(), status: "failed",
840
+ error: { code: "server_error", message: failure } },
841
+ })];
842
+ frames.push(...translator.finalize());
838
843
  onComplete(translator.finalResponse());
839
844
  return frames;
840
845
  },
841
846
  error(message) {
847
+ failure = message;
842
848
  return [sse("error", {
843
849
  type: "error",
844
850
  code: "server_error",
@@ -848,90 +854,3 @@ export function createResponsesStreamProtocol(
848
854
  },
849
855
  };
850
856
  }
851
-
852
- /** Wrap our OpenAI SSE byte stream as a Responses SSE byte stream.
853
- * onComplete fires after response.completed with the final payload so
854
- * the route can store it for previous_response_id resumption. */
855
- export function translateOpenAiSseToResponses(
856
- upstream: ReadableStream<Uint8Array>,
857
- model: string,
858
- previousResponseId: string | null,
859
- onComplete: (final: Record<string, unknown>) => void,
860
- ): ReadableStream<Uint8Array> {
861
- const translator = new ResponsesStreamTranslator(model, previousResponseId);
862
- const enc = new TextEncoder();
863
- const dec = new TextDecoder();
864
- let buf = "";
865
- let finalized = false;
866
- let reader: ReadableStreamDefaultReader<Uint8Array> | null = null;
867
- let cancelled = false;
868
- return new ReadableStream<Uint8Array>({
869
- start(controller) {
870
- const emit = (frames: string[]) => {
871
- for (const f of frames) controller.enqueue(enc.encode(f));
872
- };
873
- const finish = () => {
874
- if (finalized) return;
875
- finalized = true;
876
- emit(translator.finalize());
877
- onComplete(translator.finalResponse());
878
- };
879
- reader = upstream.getReader();
880
- void (async () => {
881
- try {
882
- while (!cancelled) {
883
- const { done, value } = await reader!.read();
884
- if (done) break;
885
- buf += dec.decode(value, { stream: true });
886
- let sep: number;
887
- while ((sep = buf.indexOf("\n\n")) !== -1) {
888
- const frame = buf.slice(0, sep);
889
- buf = buf.slice(sep + 2);
890
- const data = frame
891
- .split("\n")
892
- .find((l) => l.startsWith("data: "))
893
- ?.slice(6);
894
- if (data == null) continue;
895
- if (data === "[DONE]" || data === '"[DONE]"') {
896
- finish();
897
- continue;
898
- }
899
- const parsed = JSON.parse(data);
900
- if (parsed?.error) {
901
- emit([
902
- sse("error", {
903
- type: "error",
904
- code: "server_error",
905
- message: parsed.error.message ?? "generation failed",
906
- param: null,
907
- }),
908
- ]);
909
- continue;
910
- }
911
- emit(translator.addChunk(parsed));
912
- }
913
- }
914
- if (!cancelled) finish();
915
- } catch (e) {
916
- if (!cancelled)
917
- emit([
918
- sse("error", {
919
- type: "error",
920
- code: "server_error",
921
- message: (e as Error).message,
922
- param: null,
923
- }),
924
- ]);
925
- } finally {
926
- reader?.releaseLock();
927
- reader = null;
928
- if (!cancelled) controller.close();
929
- }
930
- })();
931
- },
932
- async cancel(reason) {
933
- cancelled = true;
934
- await reader?.cancel(reason);
935
- },
936
- });
937
- }