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
@@ -1,506 +0,0 @@
1
- // Strict fill rows (K3b) — the chat template is its own oracle.
2
- //
3
- // We render the same conversation several ways, tokenize each rendering,
4
- // and diff the token IDs to find fixed template structure. Those spans become
5
- // rows. The tool parser supplies complete lexical delimiters; a request-local
6
- // context must establish an active tool boundary before a row can assert. Same technique as request-prep.ts::stableLenFor's primer probe,
7
- // applied to the assistant turn instead of the generation prompt.
8
- //
9
- // TWO RULES, both learned the hard way.
10
- //
11
- // 1. EVERY SPAN IS SLICED FROM A RENDERING THE MODEL COULD ACTUALLY PRODUCE —
12
- // real tool names, real schema keys. Never `encode(fragment)` in isolation,
13
- // and never a rendering built from placeholder names. BPE merges across the
14
- // template's own punctuation: Qwen3.5 renders `<function=get_weather>` as
15
- // `< function =get _weather >` — `=get` is ONE token. A probe named
16
- // `zzalphatoolqq` instead splits as `… = zzalpha…`, inventing a boundary
17
- // after `=` that the real stream never has. A scaffold row ending at that
18
- // boundary injects a bare `=`, and the model then emits `get` where it would
19
- // have emitted `=get`: byte-identical text, DIVERGENT token ids, KV that no
20
- // longer matches what a plain decode would have written (caught on
21
- // Qwen3.5-0.8B, 2026-08-31). So the diff's role is only to decide WHERE to
22
- // cut; the ids always come from the real-name rendering, which makes every
23
- // cut a token boundary of a stream the model can produce.
24
- // 2. Every span is anchored at a DISTINCTIVE token (one carrying letters or
25
- // markup, e.g. `<tool_call>` or `function`), with leading whitespace-only
26
- // tokens dropped from the trigger. The engine only fills after the model has
27
- // itself committed to something unambiguous — a bare `}` or `"` never arms a
28
- // row.
29
- //
30
- // Safety is structural: a template that does not render `tool_calls` (or
31
- // renders them without the name/arguments) produces IDENTICAL probes, the diff
32
- // is empty, and no rows are compiled — degrade to no-fill, never wrong output.
33
- import type { ChatMessage, RenderOptions, ToolDefinition } from "../chat-template";
34
- import type { FillRow, StrictFillContext } from "./fill-session";
35
- import { hasCompleteToolValueDelimiter } from "../tool-call";
36
- import { ToolCallFillContext } from "./tool-boundary";
37
-
38
- /** The template surface row compilation needs (ChatTemplate satisfies it). */
39
- export interface FillTemplateLike {
40
- render(messages: ChatMessage[], options: RenderOptions): string;
41
- }
42
-
43
- /** The tokenizer surface row compilation needs (LoadedTokenizer satisfies it). */
44
- export interface FillTokenizerLike {
45
- encode(text: string, addSpecialTokens?: boolean): number[];
46
- decode(ids: number[], skipSpecialTokens?: boolean): string;
47
- readonly bosTokenId: number | null;
48
- }
49
-
50
- // Probe literals. Chosen so no two share a first OR last character run: the
51
- // diff is taken from both ends, and a shared suffix like "…probe" would make
52
- // the call-close span look longer than it is.
53
- //
54
- // NAME_GUARD and KEY_ALT are DIAGNOSTIC ONLY — they answer "does this template
55
- // render the name / the argument keys at all?". Nothing is ever sliced out of
56
- // a rendering that carries them (see rule 1 in the file header).
57
- const NAME_GUARD = "zzalphatoolqq";
58
- const KEY_ALT = "zzalphakeyqq";
59
- const VALUE_A = "zzalphavalqq";
60
- const VALUE_B = "wwbetavalmm";
61
- const VALUE_NUM = 987654;
62
- const CONTENT_A = "zzalphatextqq";
63
- const CONTENT_B = "wwbetatextmm";
64
- // Call ids differ per probe too: a template that renders `tool_calls[].id`
65
- // would otherwise bake a probe id into the "fixed" scaffold and we would
66
- // inject an id the model never chose. Differing ids make that span diverge,
67
- // so the diff stops before it.
68
- const ID_A = "call_zzalphaidqq";
69
- const ID_B = "call_wwbetaidmm";
70
- const ID_N = "call_vvgammaidkk";
71
-
72
- /** Requests above this limit skip strict rows. Probing only a subset would
73
- * incorrectly treat choices from the omitted tools as fixed structure. */
74
- const MAX_TOOLS = 32;
75
- /** A "scaffold" longer than this is a diff that went wrong, not punctuation. */
76
- const MAX_SPAN_TOKENS = 64;
77
- /** Cap on a name row's disambiguating token run (tools whose names tokenize
78
- * alike for longer than this get no row). */
79
- const MAX_NAME_TRIGGER = 8;
80
-
81
- export interface CompileStrictRowsInput {
82
- template: FillTemplateLike;
83
- tokenizer: FillTokenizerLike;
84
- /** The conversation to render around. Row ids are assumed independent of it
85
- * (the assistant turn opens with a special token, and special tokens break
86
- * BPE merges) — the same assumption stableLenFor's memoized primer length
87
- * already makes, which is why callers may cache rows per (mode, tools). */
88
- messages: ChatMessage[];
89
- tools: ToolDefinition[];
90
- /** Template options for this request mode (tools, thinking, effort …).
91
- * `addGenerationPrompt` is set per probe and ignored here. */
92
- renderOptions: Omit<RenderOptions, "addGenerationPrompt">;
93
- }
94
-
95
- export interface StrictRowPlan {
96
- rows: FillRow[];
97
- /** A fresh parser context for each request; compiled rows may be cached. */
98
- createContext?: (promptIds: readonly number[]) => StrictFillContext;
99
- /** Token ids that legitimately END an argument value in this template — the
100
- * closing quote (JSON) or the markup that follows a value (`</parameter`).
101
- * Read off the diff between two value probes: the first non-whitespace
102
- * token their renderings share AFTER the value is what terminates it. The
103
- * echo tier uses these to decide where a copied span may stop (and, with a
104
- * clean stop, may be asserted rather than verified). */
105
- delimiters: number[];
106
- }
107
-
108
- /** Compile the request's strict rows, or an empty plan when the template gives
109
- * no determined span. Never throws: a template that raises on a probe render
110
- * degrades to no rows. */
111
- export function compileStrictFillRows(input: CompileStrictRowsInput): StrictRowPlan {
112
- try {
113
- const plan = compile(input);
114
- if (!plan.rows.length) return plan;
115
- const { tokenizer, tools } = input;
116
- return {
117
- ...plan,
118
- rows: plan.rows.map(row => ({ ...row, requiresContext: true as const })),
119
- createContext: promptIds => new ToolCallFillContext(
120
- ids => tokenizer.decode([...ids], false), tools, tokenizer.decode([...promptIds], false),
121
- ),
122
- };
123
- } catch {
124
- return { rows: [], delimiters: [] };
125
- }
126
- }
127
-
128
- function compile(input: CompileStrictRowsInput): StrictRowPlan {
129
- const { template, tokenizer, messages, tools, renderOptions } = input;
130
- const empty: StrictRowPlan = { rows: [], delimiters: [] };
131
- if (!tools.length || tools.length > MAX_TOOLS) return empty;
132
-
133
- const encode = (text: string): number[] => {
134
- const ids = tokenizer.encode(text);
135
- // The template emits the BOS as text and the post-processor prepends one:
136
- // same de-duplication as request-prep.promptIdsFor.
137
- return ids[0] === ids[1] && ids[0] === tokenizer.bosTokenId ? ids.slice(1) : ids;
138
- };
139
- const distinctive = distinctiveTest(tokenizer);
140
- const whitespace = whitespaceTest(tokenizer);
141
-
142
- // The generation prompt — everything after it is what the model produces.
143
- const baseText = template.render(messages, { ...renderOptions, addGenerationPrompt: true });
144
- const base = encode(baseText);
145
- // A suffix tokenized on its own may get the post-processor's BOS prepended
146
- // (llama-style tokenizers); Qwen-style ones yield [] for "".
147
- const bosPrepended = (() => { const e = tokenizer.encode(""); return e.length === 1 && e[0] === tokenizer.bosTokenId; })();
148
- const encodeSuffix = (text: string): number[] => {
149
- const ids = tokenizer.encode(text);
150
- return bosPrepended && ids[0] === tokenizer.bosTokenId ? ids.slice(1) : ids;
151
- };
152
-
153
- /** Token ids of the assistant turn that follows the generation prompt.
154
- * Preferred: the whole rendering tokenized once, sliced past the primer's
155
- * ids. When the primer's last token MERGES with the reply's first (Qwen3.x
156
- * thinking templates end the primer in `<think>\n` and the reply opens with
157
- * `\n</think>`, so `\n`+`\n` becomes one `\n\n` token and the primer is no
158
- * longer a token prefix), fall back to the TEXT boundary and tokenize the
159
- * reply on its own — that is the stream the model produces after the
160
- * prompt ids anyway. Only a rendering that does not extend the primer text
161
- * at all bails. */
162
- const after = (rendered: string): number[] | null => {
163
- const ids = encode(rendered);
164
- if (startsWith(ids, base)) return ids.slice(base.length);
165
- if (!rendered.startsWith(baseText)) return null; // primer is not a prefix — bail
166
- return encodeSuffix(rendered.slice(baseText.length));
167
- };
168
- const callProbe = (
169
- name: string, args: Record<string, unknown>, id: string,
170
- ): number[] | null =>
171
- after(template.render(
172
- [...messages, {
173
- role: "assistant",
174
- content: "",
175
- tool_calls: [{ id, type: "function", function: { name, arguments: args } }],
176
- }],
177
- { ...renderOptions, addGenerationPrompt: false },
178
- ));
179
- const contentProbe = (text: string): number[] | null =>
180
- after(template.render(
181
- [...messages, { role: "assistant", content: text }],
182
- { ...renderOptions, addGenerationPrompt: false },
183
- ));
184
-
185
- // --- per-tool determined spans, each sliced from its OWN real rendering ---
186
- // `determinedSpan` cuts where a variant diverges, but the ids it returns
187
- // always come from a rendering with this tool's real name and real keys —
188
- // so every cut is a token boundary of a stream the model can produce.
189
- const spans: { name: string; span: number[] }[] = [];
190
- for (const tool of tools.slice(0, MAX_TOOLS)) {
191
- const name = tool.function?.name;
192
- if (typeof name !== "string" || !name) continue;
193
- const span = determinedSpan(tool, name, callProbe);
194
- if (span && span.length && span.length <= MAX_SPAN_TOKENS)
195
- spans.push({ name, span });
196
- }
197
- if (!spans.length) return empty;
198
- // Does the template render the NAME at all? Diagnostic only — a rendering
199
- // carrying NAME_GUARD is never sliced. Identical ⇒ nothing is determined by
200
- // the model's choice of tool, so there is nothing safe to fill.
201
- const first = spans[0]!;
202
- const guard = callProbe(NAME_GUARD, { [KEY_ALT]: VALUE_A }, ID_A);
203
- const real = callProbe(first.name, { [KEY_ALT]: VALUE_A }, ID_A);
204
- if (!guard || !real || sameIds(guard, real)) return empty;
205
-
206
- // Scaffold = what every tool's rendering shares. With ONE tool that is the
207
- // whole determined span (call open + name + fixed structure up to the first
208
- // free value position); with several it ends exactly where the real, merged
209
- // name tokens diverge — `=get` vs `=search`, the only boundary the model's
210
- // own greedy stream can respect.
211
- let scaffold = first.span;
212
- for (const other of spans.slice(1)) scaffold = commonPrefix(scaffold, other.span);
213
- if (scaffold.length === 0) return empty;
214
- // Every trigger is expressed from the SAME anchor as the scaffold row's, so
215
- // the rows chain: after the scaffold fires, the history tail is exactly the
216
- // scaffold, and a name row's trigger (scaffold + disambiguating run) matches.
217
- const anchor = leadingSkip(scaffold, whitespace);
218
-
219
- const rows: FillRow[] = [];
220
- // The scaffold is determined only AFTER the model has chosen to call a tool.
221
- // Everything the call rendering shares with a plain-content rendering (the
222
- // think close, the joins) is not a decision; the first token where they
223
- // diverge — the tool-call opener — is the model's own commitment, and the
224
- // row's trigger must run through it. Measured before this rule (27B strict
225
- // trace, 2026-09-02): a row triggered on `</think>` asserted a tool call the
226
- // model would have answered in prose 2 times out of 5. No content probe ⇒
227
- // no open row (the name and close rows do not depend on it).
228
- const content = contentProbe(CONTENT_A);
229
- if (content) {
230
- let decision = 0;
231
- while (decision < scaffold.length && decision < content.length &&
232
- scaffold[decision] === content[decision]) decision++;
233
- if (decision < scaffold.length) {
234
- const trigger = scaffold.slice(anchor, decision + 1);
235
- const emit = scaffold.slice(decision + 1);
236
- if (trigger.some(distinctive) && emit.length >= 2)
237
- rows.push({ trigger, emit, kind: "scaffold" });
238
- }
239
- }
240
-
241
- // --- per-tool name completion ----------------------------------------
242
- // Fires on the shortest run of tokens after the scaffold that identifies ONE
243
- // tool (a trie over the real name tokenizations), then carries the rest of
244
- // that tool's determined span — for a sole-required-key schema, all the way
245
- // through the key to where the value's own content begins.
246
- for (const { name, span } of spans) {
247
- if (span.length <= scaffold.length) continue;
248
- const k = disambiguationLength(span, scaffold.length, spans);
249
- if (k === null) continue;
250
- const emit = span.slice(scaffold.length + k);
251
- if (emit.length < 2) continue;
252
- rows.push({
253
- trigger: [
254
- ...scaffold.slice(anchor),
255
- ...span.slice(scaffold.length, scaffold.length + k),
256
- ],
257
- emit,
258
- kind: "name",
259
- });
260
- }
261
-
262
- // --- value delimiters, call close, turn end ---------------------------
263
- // Two renderings of the SAME real tool differing only in the VALUE: their
264
- // shared tail is [what closes the value, call close, turn end], sliced from
265
- // a real rendering. (Differing the KEY instead would put the value itself in
266
- // the "shared" tail, and the value is the model's to choose.)
267
- const closeKey = firstKeyOf(tools[0]!) ?? KEY_ALT;
268
- const a = callProbe(first.name, { [closeKey]: VALUE_A }, ID_A);
269
- const b = callProbe(first.name, { [closeKey]: VALUE_B }, ID_B);
270
- if (!a || !b || sameIds(a, b)) return { rows, delimiters: [] };
271
- const sharedTail = commonSuffix(a, b);
272
- // The first NON-whitespace token after the value is what terminates it.
273
- // Whitespace is excluded on purpose: a newline ends nothing in particular,
274
- // and treating it as a delimiter would let the echo tier assert on it.
275
- const delimiters: number[] = [];
276
- const valueEnd = sharedTail.find((id) => !whitespace(id));
277
- if (valueEnd !== undefined) delimiters.push(valueEnd);
278
-
279
- // A close row fires after the FIRST argument value ends, so it is only
280
- // determined when the call must end there: EVERY tool in the request takes
281
- // exactly one, required argument. Otherwise the model may still be about to
282
- // write a second `<parameter=…>` and injecting the close would silently drop
283
- // it — the request's own schema decides whether this row exists at all.
284
- const singleArgRequest = tools.slice(0, MAX_TOOLS).every((tool) => determinedKeyOf(tool) !== null);
285
- if (!singleArgRequest) return { rows, delimiters };
286
- // The shared tail of two plain-content probes is the turn end alone.
287
- const ca = contentProbe(CONTENT_A);
288
- const cb = contentProbe(CONTENT_B);
289
- const turnEnd = ca && cb && !sameIds(ca, cb) ? commonSuffix(ca, cb) : [];
290
- let callClose = sharedTail;
291
- if (scaffold.length + callClose.length >= Math.min(a.length, b.length)) callClose = [];
292
- if (turnEnd.length && endsWith(callClose, turnEnd))
293
- callClose = callClose.slice(0, callClose.length - turnEnd.length);
294
- if (callClose.length && callClose.length <= MAX_SPAN_TOKENS) {
295
- const row = anchoredRow(callClose, "close", distinctive, whitespace,
296
- prefix => hasCompleteToolValueDelimiter(tokenizer.decode(prefix, false)));
297
- if (row) rows.push(row);
298
- }
299
- if (turnEnd.length && turnEnd.length <= MAX_SPAN_TOKENS) {
300
- // Usually inert: a turn end starts at EOS, and FillSession cuts every span
301
- // at the first EOS id. Compiled anyway for templates whose turn end is
302
- // ordinary markup followed by the stop token.
303
- const row = anchoredRow(turnEnd, "turn-end", distinctive, whitespace);
304
- if (row) rows.push(row);
305
- }
306
- return { rows, delimiters };
307
- }
308
-
309
- type CallProbe = (
310
- name: string, args: Record<string, unknown>, id: string,
311
- ) => number[] | null;
312
-
313
- /** Schema keys, in declaration order. */
314
- function keysOf(tool: ToolDefinition): { keys: string[]; required: string[]; closed: boolean } {
315
- const params = tool.function?.parameters as Record<string, unknown> | undefined;
316
- const props = params?.properties as Record<string, unknown> | undefined;
317
- const keys = props && typeof props === "object" ? Object.keys(props) : [];
318
- const required = (Array.isArray(params?.required) ? params!.required : [])
319
- .filter((k): k is string => typeof k === "string");
320
- const patterns = params?.patternProperties;
321
- const closed = params?.additionalProperties === false &&
322
- (patterns === undefined || patterns !== null && typeof patterns === "object" && Object.keys(patterns).length === 0);
323
- return { keys, required, closed };
324
- }
325
-
326
- function firstKeyOf(tool: ToolDefinition): string | null {
327
- return keysOf(tool).keys[0] ?? null;
328
- }
329
-
330
- /** A first key is fixed only when it is required and no other key is legal.
331
- * Optional, additional and pattern properties can otherwise come first. */
332
- function determinedKeyOf(tool: ToolDefinition): string | null {
333
- const { keys, required, closed } = keysOf(tool);
334
- if (closed && keys.length === 1 && required.includes(keys[0]!)) return keys[0]!;
335
- return null;
336
- }
337
-
338
- /** How much of ONE tool's rendering is determined once the model has committed
339
- * to that tool: everything from the call opening through the name, plus the
340
- * template's fixed structure, up to the first position whose content the model
341
- * chooses. The returned ids are ALWAYS a prefix of the real-name rendering
342
- * `a` — variants only decide where to cut (file header, rule 1). */
343
- function determinedSpan(
344
- tool: ToolDefinition, name: string, probe: CallProbe,
345
- ): number[] | null {
346
- const key = determinedKeyOf(tool);
347
- if (key) {
348
- // Real name AND real key: the span runs through the key to where the
349
- // value's own content starts. The NUMBER variant keeps it type-agnostic —
350
- // a string value opens with a quote, an integer does not.
351
- const a = probe(name, { [key]: VALUE_A }, ID_A);
352
- const b = probe(name, { [key]: VALUE_B }, ID_B);
353
- const n = probe(name, { [key]: VALUE_NUM }, ID_N);
354
- if (!a || !b || !n || sameIds(a, b) || sameIds(a, n)) return null;
355
- return commonPrefix(commonPrefix(a, b), n);
356
- }
357
- const { keys, required, closed } = keysOf(tool);
358
- // Compare real key choices when available. Otherwise the alternative only
359
- // locates the boundary; returned IDs still come from the real rendering.
360
- const a = keys.length > 0
361
- ? probe(name, { [keys[0]!]: VALUE_A }, ID_A)
362
- : probe(name, {}, ID_A);
363
- const b = probe(name, { [keys[1] ?? KEY_ALT]: VALUE_A }, ID_B);
364
- if (!a || !b || sameIds(a, b)) return null;
365
- let span = commonPrefix(a, b);
366
- if (!closed && keys.length > 1) {
367
- // Declared keys can share BPE tokens that another legal key does not.
368
- const alternative = probe(name, { [KEY_ALT]: VALUE_A }, ID_B);
369
- if (!alternative) return null;
370
- span = commonPrefix(span, alternative);
371
- }
372
- if (required.length === 0 && keys.length > 0) {
373
- // Keep the empty argument rendering possible when no property is required.
374
- const empty = probe(name, {}, ID_A);
375
- if (!empty) return null;
376
- span = commonPrefix(span, empty);
377
- }
378
- return span;
379
- }
380
-
381
- /** Length of the shortest token run after `at` that no OTHER tool's span
382
- * shares — the trie disambiguation for a name row. null when this tool is
383
- * still ambiguous within the cap (e.g. two tools whose names tokenize alike
384
- * for many tokens): no row rather than a row that could fire for the wrong
385
- * tool. */
386
- function disambiguationLength(
387
- span: readonly number[],
388
- at: number,
389
- all: readonly { span: number[] }[],
390
- ): number | null {
391
- const cap = Math.min(MAX_NAME_TRIGGER, span.length - at);
392
- for (let k = 1; k <= cap; k++) {
393
- let unique = true;
394
- for (const other of all) {
395
- if (other.span === span) continue;
396
- if (other.span.length < at + k) continue;
397
- let same = true;
398
- for (let i = 0; i < k; i++) {
399
- if (other.span[at + i] !== span[at + i]) { same = false; break; }
400
- }
401
- if (same) { unique = false; break; }
402
- }
403
- if (unique) return k;
404
- }
405
- return null;
406
- }
407
-
408
- /** Split a determined span into (trigger the model must produce itself,
409
- * tokens we append). Two rules:
410
- * - LEADING WHITESPACE IS DROPPED. A template's determined span often opens
411
- * with the newline that JOINS the previous message, which the model does
412
- * not emit; keeping it in the trigger would mean the row never fires.
413
- * - The trigger runs through the first DISTINCTIVE token, so a span opening
414
- * with bare punctuation can never fire on a coincidental `}` or `"` in the
415
- * middle of an arguments object.
416
- * Returns null when the span carries no distinctive token, or when nothing is
417
- * left to save. */
418
- function anchoredRow(
419
- span: number[],
420
- kind: FillRow["kind"],
421
- distinctive: (id: number) => boolean,
422
- whitespace: (id: number) => boolean,
423
- complete?: (prefix: number[]) => boolean,
424
- ): FillRow | null {
425
- const rest = span.slice(leadingSkip(span, whitespace));
426
- let k = rest.findIndex(distinctive);
427
- if (k === -1) return null;
428
- if (complete) {
429
- while (k < rest.length && !complete(rest.slice(0, k + 1))) k++;
430
- if (k === rest.length) return null;
431
- }
432
- const emit = rest.slice(k + 1);
433
- if (emit.length < 2) return null;
434
- return { trigger: rest.slice(0, k + 1), emit, kind };
435
- }
436
-
437
- /** Count of leading whitespace-only tokens. */
438
- function leadingSkip(span: readonly number[], whitespace: (id: number) => boolean): number {
439
- let j = 0;
440
- while (j < span.length && whitespace(span[j]!)) j++;
441
- return j;
442
- }
443
-
444
- /** A token is distinctive when its piece carries letters or markup — i.e. it
445
- * is content, not JSON punctuation the model could emit anywhere. */
446
- function distinctiveTest(tokenizer: FillTokenizerLike): (id: number) => boolean {
447
- // A LETTER, not merely markup. `</` is markup and passes a `[<>]` test, but
448
- // it is also the first token of every closing tag the model might write in
449
- // ordinary prose or a code block — arming a row on it would inject tool-call
450
- // markup into an HTML snippet. `</parameter` (two tokens, letters in the
451
- // second) is specific to the template's tool syntax.
452
- return pieceTest(tokenizer, (piece) => /[A-Za-z]/.test(piece));
453
- }
454
-
455
- /** A token whose piece is nothing but whitespace (template joins). */
456
- function whitespaceTest(tokenizer: FillTokenizerLike): (id: number) => boolean {
457
- return pieceTest(tokenizer, (piece) => piece.length > 0 && /^\s+$/.test(piece));
458
- }
459
-
460
- function pieceTest(
461
- tokenizer: FillTokenizerLike,
462
- predicate: (piece: string) => boolean,
463
- ): (id: number) => boolean {
464
- const memo = new Map<number, boolean>();
465
- return (id: number): boolean => {
466
- const hit = memo.get(id);
467
- if (hit !== undefined) return hit;
468
- let value = false;
469
- try {
470
- value = predicate(tokenizer.decode([id], false));
471
- } catch { value = false; }
472
- memo.set(id, value);
473
- return value;
474
- };
475
- }
476
-
477
- function commonPrefix(a: readonly number[], b: readonly number[]): number[] {
478
- const n = Math.min(a.length, b.length);
479
- let i = 0;
480
- while (i < n && a[i] === b[i]) i++;
481
- return a.slice(0, i);
482
- }
483
-
484
- function commonSuffix(a: readonly number[], b: readonly number[]): number[] {
485
- const n = Math.min(a.length, b.length);
486
- let i = 0;
487
- while (i < n && a[a.length - 1 - i] === b[b.length - 1 - i]) i++;
488
- return a.slice(a.length - i);
489
- }
490
-
491
- function startsWith(ids: readonly number[], prefix: readonly number[]): boolean {
492
- if (prefix.length > ids.length) return false;
493
- for (let i = 0; i < prefix.length; i++) if (ids[i] !== prefix[i]) return false;
494
- return true;
495
- }
496
-
497
- function endsWith(ids: readonly number[], suffix: readonly number[]): boolean {
498
- if (suffix.length > ids.length) return false;
499
- const base = ids.length - suffix.length;
500
- for (let i = 0; i < suffix.length; i++) if (ids[base + i] !== suffix[i]) return false;
501
- return true;
502
- }
503
-
504
- function sameIds(a: readonly number[], b: readonly number[]): boolean {
505
- return a.length === b.length && a.every((v, i) => v === b[i]);
506
- }
@@ -1,103 +0,0 @@
1
- import type { ToolDefinition } from "../chat-template";
2
- import { parseStrictToolCall } from "../tool-call";
3
- import type { FillRow, StrictFillContext } from "./fill-session";
4
-
5
- const OPEN = "<tool_call>", CLOSE = "</tool_call>";
6
- const THINK_OPEN = "<think>", THINK_CLOSE = "</think>";
7
- const MAX_CONTEXT_TOKENS = 65_536;
8
-
9
- /** Conservative for raw XML argument text. An unfinished literal can still
10
- * contain a closing-tag example; leaving it to generation loses only a fill. */
11
- function literalsClosed(text: string): boolean {
12
- let quote = "", escaped = false;
13
- for (const c of text) {
14
- if (escaped) { escaped = false; continue; }
15
- if (c === "\\" && quote !== "'") { escaped = true; continue; }
16
- if (quote) { if (c === quote) quote = ""; }
17
- else if (c === '"' || c === "'" || c === "`") quote = c;
18
- }
19
- return quote === "" && !escaped;
20
- }
21
-
22
- function reasoningClosed(text: string): boolean {
23
- if (text.includes(THINK_OPEN)) return false;
24
- let fence = "", prose = "";
25
- for (const line of text.split("\n")) {
26
- const marker = /^\s*(`{3,}|~{3,})(.*)$/.exec(line);
27
- if (fence) {
28
- if (marker && marker[1]![0] === fence[0] &&
29
- marker[1]!.length >= fence.length && !marker[2]!.trim()) fence = "";
30
- } else if (marker) fence = marker[1]!;
31
- else prose += line + "\n";
32
- }
33
- return !fence && literalsClosed(prose);
34
- }
35
-
36
- /** Request-local proof for template-derived rows. Only a tool-only assistant
37
- * turn, optionally following its reasoning block, qualifies. Prose, quoted
38
- * examples and unsupported formats retain ordinary generation. Decode runs
39
- * only when a full token trigger matches, not for every generated token. */
40
- export class ToolCallFillContext implements StrictFillContext {
41
- #ids: number[] = [];
42
- #overflow = false;
43
- readonly #startsInReasoning: boolean;
44
-
45
- constructor(
46
- readonly decode: (ids: readonly number[]) => string,
47
- readonly tools: ToolDefinition[],
48
- promptText: string,
49
- ) {
50
- this.#startsInReasoning = /<think>\s*$/.test(promptText);
51
- }
52
-
53
- observe(ids: readonly number[]): void {
54
- if (this.#overflow) return;
55
- if (this.#ids.length + ids.length > MAX_CONTEXT_TOKENS) {
56
- this.#overflow = true;
57
- this.#ids = [];
58
- return;
59
- }
60
- for (const id of ids) this.#ids.push(id);
61
- }
62
-
63
- allows(row: FillRow): boolean {
64
- if (this.#overflow) return false;
65
- let text = this.decode(this.#ids);
66
- if (this.#startsInReasoning) {
67
- const end = text.indexOf(THINK_CLOSE);
68
- if (end < 0 || !reasoningClosed(text.slice(0, end))) return false;
69
- text = text.slice(end + THINK_CLOSE.length);
70
- }
71
- text = text.trimStart();
72
- if (text.startsWith(THINK_OPEN)) {
73
- const end = text.indexOf(THINK_CLOSE, THINK_OPEN.length);
74
- if (end < 0 || !reasoningClosed(text.slice(THINK_OPEN.length, end))) return false;
75
- text = text.slice(end + THINK_CLOSE.length).trimStart();
76
- }
77
- // Earlier calls must be complete and valid before another can open.
78
- for (;;) {
79
- if (!text.startsWith(OPEN)) return false;
80
- const end = text.indexOf(CLOSE, OPEN.length);
81
- if (end < 0) break;
82
- const stop = end + CLOSE.length;
83
- if (!parseStrictToolCall(text.slice(0, stop), this.tools)) return false;
84
- text = text.slice(stop).trimStart();
85
- }
86
- if (text.indexOf(OPEN, OPEN.length) !== -1) return false;
87
- if (row.kind === "scaffold" || row.kind === "name" || row.kind === "key") {
88
- const trigger = this.decode(row.trigger);
89
- const start = trigger.indexOf(OPEN);
90
- return start >= 0 && text === trigger.slice(start);
91
- }
92
- if (row.kind !== "close") return false;
93
- const call = parseStrictToolCall(text + this.decode(row.emit), this.tools);
94
- if (!call) return false;
95
- const tool = this.tools.find(tool => tool.function?.name === call.name);
96
- const schema = tool?.function?.parameters;
97
- const required = schema?.required;
98
- if (!Array.isArray(required) || required.length !== 1 ||
99
- Object.keys(call.arguments).length !== 1 || !Object.hasOwn(call.arguments, required[0])) return false;
100
- const value = call.arguments[required[0]];
101
- return typeof value !== "string" || literalsClosed(value);
102
- }
103
- }