mlx-bun 0.4.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 (601) hide show
  1. package/README.md +1453 -88
  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 +10 -8
  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 +12 -10
  78. package/src/{serve → server}/chat-stage.ts +27 -22
  79. package/src/{client.ts → server/client.ts} +28 -2
  80. package/src/{serve → server}/completion-executor.ts +42 -42
  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 +42 -83
  85. package/src/server/generated-token-history.ts +57 -0
  86. package/src/{serve → server}/http.ts +25 -13
  87. package/src/{serve → server}/inference-request.ts +5 -5
  88. package/src/server/job-routes.ts +20 -0
  89. package/src/server/media-prompt.ts +63 -0
  90. package/src/server/memory-completion-client.ts +46 -0
  91. package/src/server/model-routes.ts +192 -0
  92. package/src/{serve → server}/openai-wire.ts +3 -2
  93. package/src/{serve → server}/pipeline.ts +1 -1
  94. package/src/server/prompt-builder.ts +13 -0
  95. package/src/server/prompt-contracts.ts +17 -0
  96. package/src/server/proxy-routes.ts +187 -0
  97. package/src/server/publishing-routes.ts +41 -0
  98. package/src/{serve → server}/request-plan.ts +8 -8
  99. package/src/{serve → server}/request-prep.ts +82 -68
  100. package/src/{serve → server}/responses-client.ts +30 -13
  101. package/src/{responses.ts → server/responses.ts} +12 -93
  102. package/src/server/routes.ts +205 -0
  103. package/src/server/start.ts +72 -0
  104. package/src/server/status-routes.ts +108 -0
  105. package/src/{serve → server}/text-completion-stage.ts +25 -4
  106. package/src/server/text-prompt.ts +12 -0
  107. package/src/{serve → server}/token-streams.ts +36 -38
  108. package/src/server/worker-routes.ts +311 -0
  109. package/src/storage/paths.ts +61 -0
  110. package/src/web/assets.ts +37 -0
  111. package/src/web/{src → browser}/api.ts +5 -23
  112. package/src/web/browser/chat-host.ts +17 -0
  113. package/src/web/browser/installed-panels.ts +6 -0
  114. package/src/web/browser/main.ts +55 -0
  115. package/src/web/browser/markdown.ts +279 -0
  116. package/src/web/browser/memory-panel.ts +9 -0
  117. package/src/web/browser/palette.ts +64 -0
  118. package/src/web/browser/protocol.ts +13 -0
  119. package/src/web/browser/shell.ts +467 -0
  120. package/src/web/{src → browser}/status.ts +32 -36
  121. package/src/web/build.ts +51 -0
  122. package/src/web/public/app.html +1054 -0
  123. package/src/web/{sw.js → public/sw.js} +4 -3
  124. package/src/web/{vendor → public/vendor}/hljs-theme.css +2 -2
  125. package/src/web/{vendor → public/vendor}/hljs.js +2 -2
  126. package/THIRD_PARTY_LICENSES.md +0 -51
  127. package/docs/README.md +0 -94
  128. package/docs/archive/hlg-sampling.md +0 -350
  129. package/docs/archive/investigations/audio-input-plan.md +0 -356
  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/web-ui-pass-plan.md +0 -213
  174. package/docs/archive/planning/website-readme-pass-plan.md +0 -224
  175. package/docs/design/batching.md +0 -1841
  176. package/docs/design/decode-speed-program.md +0 -2349
  177. package/docs/design/dreaming-nightly-pipeline.md +0 -684
  178. package/docs/design/generic-model-support.md +0 -705
  179. package/docs/design/kv-cache.md +0 -824
  180. package/docs/design/orpo-training.md +0 -680
  181. package/docs/design/speculative-decoding.md +0 -1990
  182. package/docs/design/turboquant.md +0 -2212
  183. package/docs/design/unified-engine-frontier-plan.md +0 -1880
  184. package/docs/design/web-chat-redesign.md +0 -695
  185. package/docs/planning/PRODUCT_ROADMAP.md +0 -594
  186. package/docs/planning/ResearchTopics.md +0 -119
  187. package/docs/planning/release-notes-v0.4.0.md +0 -45
  188. package/docs/planning/video-series.md +0 -421
  189. package/docs/reference/benchmarks.md +0 -3613
  190. package/docs/reference/cli.md +0 -585
  191. package/docs/reference/distribution.md +0 -355
  192. package/docs/reference/environment.md +0 -398
  193. package/docs/reference/glossary.md +0 -39
  194. package/docs/reference/library-api.md +0 -674
  195. package/docs/reference/memory.md +0 -260
  196. package/docs/reference/models.md +0 -334
  197. package/docs/reference/server-api.md +0 -1775
  198. package/docs/reference/server-config.md +0 -846
  199. package/docs/reference/training.md +0 -462
  200. package/docs/reference/troubleshooting.md +0 -158
  201. package/src/admission-plan.ts +0 -18
  202. package/src/audio/conformer.ts +0 -647
  203. package/src/audio/decode.ts +0 -133
  204. package/src/audio/features.ts +0 -202
  205. package/src/audio/transcode.ts +0 -67
  206. package/src/backends/mlx/assistant-target.ts +0 -46
  207. package/src/backends/mlx/autoregressive-draft-rows.ts +0 -120
  208. package/src/backends/mlx/autoregressive.ts +0 -108
  209. package/src/backends/mlx/batch-group.ts +0 -1790
  210. package/src/backends/mlx/cache-attachment.ts +0 -67
  211. package/src/backends/mlx/cache-layout.ts +0 -31
  212. package/src/backends/mlx/checkpoint-state.ts +0 -53
  213. package/src/backends/mlx/continuation-persistence.ts +0 -106
  214. package/src/backends/mlx/continuation-request.ts +0 -43
  215. package/src/backends/mlx/continuation.ts +0 -77
  216. package/src/backends/mlx/diffusion.ts +0 -39
  217. package/src/backends/mlx/draft-target.ts +0 -32
  218. package/src/backends/mlx/evaluation.ts +0 -105
  219. package/src/backends/mlx/fill-append.ts +0 -45
  220. package/src/backends/mlx/full-kv-row-append.ts +0 -32
  221. package/src/backends/mlx/full-kv-row-donor.ts +0 -54
  222. package/src/backends/mlx/full-transitioning-kv-rows.ts +0 -65
  223. package/src/backends/mlx/gateway-binding.ts +0 -130
  224. package/src/backends/mlx/graph.ts +0 -38
  225. package/src/backends/mlx/kv-codec.ts +0 -9
  226. package/src/backends/mlx/kv-maintenance.ts +0 -133
  227. package/src/backends/mlx/kv-tensor-rows.ts +0 -212
  228. package/src/backends/mlx/memory-client.ts +0 -189
  229. package/src/backends/mlx/methods.ts +0 -90
  230. package/src/backends/mlx/model-prompt.ts +0 -164
  231. package/src/backends/mlx/model-serving.ts +0 -79
  232. package/src/backends/mlx/prefill-cohort.ts +0 -89
  233. package/src/backends/mlx/prefill-rows.ts +0 -200
  234. package/src/backends/mlx/prefill.ts +0 -33
  235. package/src/backends/mlx/projected-context-rows.ts +0 -72
  236. package/src/backends/mlx/request-policy.ts +0 -20
  237. package/src/backends/mlx/request-state-policy.ts +0 -41
  238. package/src/backends/mlx/rollback.ts +0 -89
  239. package/src/backends/mlx/row-sampling.ts +0 -49
  240. package/src/backends/mlx/serial-executor.ts +0 -242
  241. package/src/backends/mlx/speculative-group.ts +0 -359
  242. package/src/backends/mlx/speculative-round.ts +0 -161
  243. package/src/backends/mlx/speculative.ts +0 -114
  244. package/src/backends/mlx/state-rows.ts +0 -104
  245. package/src/backends/mlx/state-views.ts +0 -46
  246. package/src/backends/mlx/target-layout-capability.ts +0 -35
  247. package/src/backends/mlx/text-engine.ts +0 -73
  248. package/src/backends/mlx/transitioning-kv-rows.ts +0 -165
  249. package/src/chat-template.ts +0 -382
  250. package/src/cli.ts +0 -3168
  251. package/src/config.ts +0 -399
  252. package/src/contracts/completion.ts +0 -16
  253. package/src/contracts/execution.ts +0 -60
  254. package/src/contracts/generation.ts +0 -103
  255. package/src/contracts/host.ts +0 -7
  256. package/src/contracts/pi-provider.ts +0 -30
  257. package/src/contracts/pi.ts +0 -259
  258. package/src/contracts/prefix-cache.ts +0 -23
  259. package/src/contracts/resources.ts +0 -25
  260. package/src/contracts/sampling.ts +0 -23
  261. package/src/contracts/scheduling.ts +0 -45
  262. package/src/contracts/tsconfig.json +0 -14
  263. package/src/dataset/generators.ts +0 -1087
  264. package/src/dataset/index.ts +0 -12
  265. package/src/dataset/job.ts +0 -81
  266. package/src/dataset/llm.ts +0 -71
  267. package/src/dataset/registry.ts +0 -528
  268. package/src/diffusion/diffusion-generate.ts +0 -507
  269. package/src/download.ts +0 -505
  270. package/src/embed.ts +0 -77
  271. package/src/engine/admission.ts +0 -59
  272. package/src/engine/cancellation.ts +0 -38
  273. package/src/engine/engine.ts +0 -56
  274. package/src/engine/execution-coordinator.ts +0 -70
  275. package/src/engine/execution-plan.ts +0 -53
  276. package/src/engine/resources.ts +0 -53
  277. package/src/engine/scheduler.ts +0 -72
  278. package/src/engine/session.ts +0 -247
  279. package/src/eval/README.md +0 -130
  280. package/src/eval/ifeval.ts +0 -81
  281. package/src/eval/kl-prompts.ts +0 -29
  282. package/src/eval/kl.ts +0 -590
  283. package/src/eval/perplexity.ts +0 -164
  284. package/src/eval/quality-db.ts +0 -92
  285. package/src/eval/reference-logits.ts +0 -207
  286. package/src/eval/runner.ts +0 -124
  287. package/src/eval/score.ts +0 -49
  288. package/src/eval/tasks/bfcl.ts +0 -535
  289. package/src/eval/tasks/gsm8k.ts +0 -98
  290. package/src/eval/tasks/hashhop.ts +0 -139
  291. package/src/eval/tasks/humaneval.ts +0 -275
  292. package/src/eval/tasks/ifeval.ts +0 -525
  293. package/src/eval/tasks/mmlu.ts +0 -157
  294. package/src/eval/ultrafeedback.ts +0 -60
  295. package/src/evaldb.ts +0 -199
  296. package/src/expert-io.ts +0 -393
  297. package/src/expert-offload-build.ts +0 -77
  298. package/src/expert-offload.ts +0 -76
  299. package/src/expert-residency.ts +0 -1134
  300. package/src/expert-usage.ts +0 -415
  301. package/src/fill/echo-index.ts +0 -188
  302. package/src/fill/fill-session.ts +0 -452
  303. package/src/fill/proposal.ts +0 -68
  304. package/src/fill/schema-rows.ts +0 -506
  305. package/src/fill/tool-boundary.ts +0 -103
  306. package/src/fit.ts +0 -249
  307. package/src/generate.ts +0 -1346
  308. package/src/grammar.ts +0 -591
  309. package/src/harness-pi.ts +0 -184
  310. package/src/hf-push.ts +0 -628
  311. package/src/hub-rest.ts +0 -242
  312. package/src/index.ts +0 -63
  313. package/src/inference/denoising.ts +0 -17
  314. package/src/inference/draft-acceptance.ts +0 -41
  315. package/src/inference/draft-output.ts +0 -49
  316. package/src/inference/graph.ts +0 -33
  317. package/src/inference/prefill.ts +0 -39
  318. package/src/inference/rollback.ts +0 -7
  319. package/src/jobs/index.ts +0 -31
  320. package/src/jobs/job-entry.ts +0 -107
  321. package/src/jobs/task-client.ts +0 -19
  322. package/src/jobs/types.ts +0 -2
  323. package/src/kv-scheme.ts +0 -257
  324. package/src/kv-store.ts +0 -1099
  325. package/src/lab/README.md +0 -18
  326. package/src/lab/curve/curve-designer.html +0 -303
  327. package/src/lab/curve/curve-sampler.ts +0 -122
  328. package/src/lab/expert-trace/expert-trace.ts +0 -69
  329. package/src/lab/paged-kv/paged-kv-rows.ts +0 -83
  330. package/src/lab/paged-kv/paged-kv.ts +0 -270
  331. package/src/library.ts +0 -40
  332. package/src/lora.ts +0 -408
  333. package/src/md-modules.d.ts +0 -49
  334. package/src/media-fetch.ts +0 -442
  335. package/src/memory/article.ts +0 -558
  336. package/src/memory/chunk-validation.ts +0 -150
  337. package/src/memory/chunk.ts +0 -318
  338. package/src/memory/cluster.ts +0 -351
  339. package/src/memory/coverage.ts +0 -134
  340. package/src/memory/crosslink.ts +0 -0
  341. package/src/memory/db.ts +0 -253
  342. package/src/memory/entity.ts +0 -203
  343. package/src/memory/gate.ts +0 -187
  344. package/src/memory/history.ts +0 -152
  345. package/src/memory/ingest.ts +0 -335
  346. package/src/memory/model.ts +0 -183
  347. package/src/memory/normalize.ts +0 -671
  348. package/src/memory/parse.ts +0 -22
  349. package/src/memory/pipeline.ts +0 -275
  350. package/src/memory/prompts.ts +0 -65
  351. package/src/memory/query.ts +0 -334
  352. package/src/memory/reconcile.ts +0 -734
  353. package/src/memory/redirect.ts +0 -108
  354. package/src/memory/reindex.ts +0 -325
  355. package/src/memory/resolve.ts +0 -307
  356. package/src/memory/rest.ts +0 -245
  357. package/src/memory/route.ts +0 -272
  358. package/src/memory/schedule.ts +0 -165
  359. package/src/memory/stages.ts +0 -777
  360. package/src/memory/synthesize.ts +0 -1638
  361. package/src/memory/tools.ts +0 -749
  362. package/src/memory/vault.ts +0 -1194
  363. package/src/memory/wikify.ts +0 -1064
  364. package/src/mlx/array.ts +0 -388
  365. package/src/mlx/autograd.ts +0 -304
  366. package/src/mlx/checkpoint.ts +0 -149
  367. package/src/mlx/compile.ts +0 -168
  368. package/src/mlx/custom-vjp.ts +0 -188
  369. package/src/mlx/ffi.ts +0 -512
  370. package/src/mlx/materialize.ts +0 -23
  371. package/src/mlx/metal-kernel.ts +0 -159
  372. package/src/mlx/ops.ts +0 -1021
  373. package/src/mlx/quantized-rows.ts +0 -36
  374. package/src/mlx/token-bitmask.ts +0 -52
  375. package/src/mlx/turboquant-kv-decode.ts +0 -82
  376. package/src/mlx/turboquant-kv-inverse.ts +0 -122
  377. package/src/mlx/turboquant-ops.ts +0 -861
  378. package/src/mlx/turboquant-tables.ts +0 -237
  379. package/src/mmap.ts +0 -90
  380. package/src/model/artifact-identity.ts +0 -73
  381. package/src/model/batched-kv.ts +0 -235
  382. package/src/model/batched-mask.ts +0 -279
  383. package/src/model/batched-quant.ts +0 -212
  384. package/src/model/batched-quantized-kv.ts +0 -144
  385. package/src/model/batched-rotating-quant.ts +0 -353
  386. package/src/model/batched-rotating-state.ts +0 -149
  387. package/src/model/batched-rotating.ts +0 -338
  388. package/src/model/batched-row-storage.ts +0 -179
  389. package/src/model/batched-ssm.ts +0 -52
  390. package/src/model/batched-turboquant-kv.ts +0 -93
  391. package/src/model/compiled-decode.ts +0 -712
  392. package/src/model/decoded-kv-donor.ts +0 -12
  393. package/src/model/delayed-quantized-kv.ts +0 -72
  394. package/src/model/delayed-rotating-quantized-kv.ts +0 -93
  395. package/src/model/delayed-turboquant-kv.ts +0 -55
  396. package/src/model/diffusion-gemma.ts +0 -1026
  397. package/src/model/factory.ts +0 -189
  398. package/src/model/fingerprint.ts +0 -33
  399. package/src/model/flash-attention.ts +0 -694
  400. package/src/model/full-prefill-padding.ts +0 -56
  401. package/src/model/full-prefill-row.ts +0 -105
  402. package/src/model/gemma4-base.ts +0 -2351
  403. package/src/model/gemma4.ts +0 -1315
  404. package/src/model/generated/gemma4-12b.ts +0 -429
  405. package/src/model/generated/gemma4-26b.ts +0 -448
  406. package/src/model/generated/gemma4-e4b.ts +0 -717
  407. package/src/model/generated/index.ts +0 -18
  408. package/src/model/glm52-atlas.ts +0 -511
  409. package/src/model/glm52-cache.ts +0 -792
  410. package/src/model/glm52-config.ts +0 -262
  411. package/src/model/glm52-container.ts +0 -305
  412. package/src/model/glm52-coupling.ts +0 -388
  413. package/src/model/glm52-dsa.ts +0 -606
  414. package/src/model/glm52-expert-layout.ts +0 -253
  415. package/src/model/glm52-layout.ts +0 -152
  416. package/src/model/glm52-memory.ts +0 -500
  417. package/src/model/glm52-mla.ts +0 -792
  418. package/src/model/glm52-moe.ts +0 -223
  419. package/src/model/glm52-pilot.ts +0 -537
  420. package/src/model/glm52-reference.ts +0 -445
  421. package/src/model/glm52-residency.ts +0 -557
  422. package/src/model/glm52-resident-weights.ts +0 -135
  423. package/src/model/glm52-streamed-experts.ts +0 -453
  424. package/src/model/glm52-streamed-metal.ts +0 -610
  425. package/src/model/glm52-weights.ts +0 -503
  426. package/src/model/glm52.ts +0 -1132
  427. package/src/model/implementation.ts +0 -69
  428. package/src/model/kv-attention-view.ts +0 -67
  429. package/src/model/minicpm5.ts +0 -376
  430. package/src/model/profile.ts +0 -443
  431. package/src/model/qwen-append.ts +0 -12
  432. package/src/model/qwen-conv.ts +0 -52
  433. package/src/model/qwen3-delta-state.ts +0 -74
  434. package/src/model/qwen3-delta.ts +0 -451
  435. package/src/model/qwen3-moe.ts +0 -404
  436. package/src/model/qwen3-mrope.ts +0 -252
  437. package/src/model/qwen3.ts +0 -277
  438. package/src/model/qwen3_5-checkpoint.ts +0 -164
  439. package/src/model/qwen3_5.ts +0 -819
  440. package/src/model/rotating-kv-donor.ts +0 -35
  441. package/src/model/rotating-kv-layout.ts +0 -262
  442. package/src/model/rotating-row-transaction.ts +0 -35
  443. package/src/model/speculative-rotating-kv.ts +0 -101
  444. package/src/model/ssm-prefill-padding.ts +0 -39
  445. package/src/model/support.ts +0 -102
  446. package/src/model/trellis-balanced-scatter.ts +0 -51
  447. package/src/model/trellis-linear.ts +0 -672
  448. package/src/model/trellis-shared-m.ts +0 -151
  449. package/src/model/trellis-shared-scatter.ts +0 -144
  450. package/src/model/trellis-splitk-prefill.ts +0 -158
  451. package/src/model/trellis-tiled-prefill.ts +0 -136
  452. package/src/model/trellis-vector-expand.ts +0 -62
  453. package/src/model/trellis-wide-prefill.ts +0 -94
  454. package/src/model/turboquant-codec.ts +0 -83
  455. package/src/model/universal/archs.ts +0 -332
  456. package/src/model/universal/dense.ts +0 -612
  457. package/src/model/universal/modules.ts +0 -170
  458. package/src/model/universal/rope.ts +0 -381
  459. package/src/native/expert_io.c +0 -523
  460. package/src/native/frame_extract.swift +0 -140
  461. package/src/native-pack.ts +0 -162
  462. package/src/pi-provider.ts +0 -53
  463. package/src/pi-session.ts +0 -81
  464. package/src/pi-terminal.ts +0 -274
  465. package/src/pi-web.ts +0 -1932
  466. package/src/preflight.ts +0 -158
  467. package/src/prompt-cache.ts +0 -460
  468. package/src/quantize/allocator.ts +0 -627
  469. package/src/quantize/atomic-output.ts +0 -38
  470. package/src/quantize/calibration.ts +0 -181
  471. package/src/quantize/config-writer.ts +0 -145
  472. package/src/quantize/index.ts +0 -84
  473. package/src/quantize/job.ts +0 -162
  474. package/src/quantize/quantizer.ts +0 -666
  475. package/src/quantize/rotate.ts +0 -603
  476. package/src/quantize/safetensors-writer.ts +0 -249
  477. package/src/quantize/sensitivity.ts +0 -216
  478. package/src/quantize/trellis.ts +0 -586
  479. package/src/quantize/weight-transform.ts +0 -292
  480. package/src/registry.ts +0 -602
  481. package/src/runtime-config.ts +0 -81
  482. package/src/safetensors.ts +0 -158
  483. package/src/sampler.ts +0 -1011
  484. package/src/serve/admin-routes.ts +0 -184
  485. package/src/serve/assets/curve-terrain.html +0 -105
  486. package/src/serve/assets/training-inference-map.html +0 -575
  487. package/src/serve/aux-routes.ts +0 -132
  488. package/src/serve/batch-scheduler.ts +0 -8
  489. package/src/serve/checkpoint-identity.ts +0 -64
  490. package/src/serve/generation-gateway.ts +0 -496
  491. package/src/serve/isolate.ts +0 -609
  492. package/src/serve/kv-budget.ts +0 -14
  493. package/src/serve/lab-routes.ts +0 -341
  494. package/src/serve/lane-registry.ts +0 -45
  495. package/src/serve/model-admin-routes.ts +0 -155
  496. package/src/serve/model-binding.ts +0 -43
  497. package/src/serve/model-host.ts +0 -511
  498. package/src/serve/parent-application.ts +0 -56
  499. package/src/serve/prompt-response-trace.ts +0 -147
  500. package/src/serve/response-lease.ts +0 -24
  501. package/src/serve/session-search.ts +0 -326
  502. package/src/serve/static-routes.ts +0 -101
  503. package/src/server.ts +0 -1314
  504. package/src/spec/assistant-rows.ts +0 -92
  505. package/src/spec/assistant-source.ts +0 -126
  506. package/src/spec/cache-identity.ts +0 -22
  507. package/src/spec/deepspec-rows.ts +0 -29
  508. package/src/spec/deepspec-source.ts +0 -145
  509. package/src/spec/dflash-source.ts +0 -149
  510. package/src/spec/drafter.ts +0 -304
  511. package/src/spec/dspark/ab-stats.ts +0 -136
  512. package/src/spec/dspark/calibration.ts +0 -112
  513. package/src/spec/dspark/data-dflash.ts +0 -156
  514. package/src/spec/dspark/data.ts +0 -201
  515. package/src/spec/dspark/deepspec-module.ts +0 -776
  516. package/src/spec/dspark/generate-dflash.ts +0 -245
  517. package/src/spec/dspark/generate.ts +0 -290
  518. package/src/spec/dspark/loader.ts +0 -23
  519. package/src/spec/dspark/loss.ts +0 -213
  520. package/src/spec/dspark/module-dflash.ts +0 -560
  521. package/src/spec/dspark/module.ts +0 -540
  522. package/src/spec/dspark/quantize-drafter.ts +0 -91
  523. package/src/spec/dspark/sample.ts +0 -112
  524. package/src/spec/generate.ts +0 -276
  525. package/src/spec/glm52-mtp-graph.ts +0 -29
  526. package/src/spec/glm52-mtp-rows.ts +0 -132
  527. package/src/spec/glm52-mtp-source.ts +0 -317
  528. package/src/spec/glm52-mtp-state.ts +0 -33
  529. package/src/spec/ngram-source.ts +0 -204
  530. package/src/spec/projected-draft-rows.ts +0 -73
  531. package/src/spec/qwen-mtp-module.ts +0 -171
  532. package/src/spec/qwen-mtp-rows.ts +0 -219
  533. package/src/spec/qwen-mtp-source.ts +0 -383
  534. package/src/spec/qwen-mtp-state.ts +0 -30
  535. package/src/spec/serve-loop.ts +0 -585
  536. package/src/spec/source.ts +0 -215
  537. package/src/spec/two-model-rows.ts +0 -61
  538. package/src/spec/two-model.ts +0 -113
  539. package/src/ssd-cache.ts +0 -372
  540. package/src/ssd-durability.ts +0 -211
  541. package/src/tokenizer.ts +0 -335
  542. package/src/tool-approvals.ts +0 -131
  543. package/src/tool-call.ts +0 -695
  544. package/src/train/dataset.ts +0 -484
  545. package/src/train/diffusion-lora.ts +0 -216
  546. package/src/train/export.ts +0 -32
  547. package/src/train/flash-cce.ts +0 -1234
  548. package/src/train/forward.ts +0 -266
  549. package/src/train/fuse.ts +0 -243
  550. package/src/train/index.ts +0 -46
  551. package/src/train/job.ts +0 -205
  552. package/src/train/lora-params.ts +0 -254
  553. package/src/train/loss.ts +0 -1591
  554. package/src/train/merge.ts +0 -195
  555. package/src/train/optimizer.ts +0 -183
  556. package/src/train/prefix-shared.ts +0 -490
  557. package/src/train/rank.ts +0 -137
  558. package/src/train/segmented.ts +0 -1828
  559. package/src/train/steel-qmm-header.ts +0 -1461
  560. package/src/train/trainer.ts +0 -1221
  561. package/src/train/watch.ts +0 -542
  562. package/src/vision/diffusion-vision.ts +0 -620
  563. package/src/vision/embedder.ts +0 -168
  564. package/src/vision/preprocess.ts +0 -247
  565. package/src/vision/prompt.ts +0 -373
  566. package/src/vision/qwen3vl-preprocess.ts +0 -409
  567. package/src/vision/qwen3vl-prompt.ts +0 -196
  568. package/src/vision/qwen3vl-tower.ts +0 -555
  569. package/src/vision/siglip.ts +0 -599
  570. package/src/vision/video-frames.ts +0 -148
  571. package/src/web/app.html +0 -2143
  572. package/src/web/app.js +0 -5703
  573. package/src/web/skills/memory/SKILL.md +0 -120
  574. package/src/web/skills/web-research/SKILL.md +0 -46
  575. package/src/web/skills.ts +0 -97
  576. package/src/web/src/adapters-panel.ts +0 -288
  577. package/src/web/src/assistant.ts +0 -451
  578. package/src/web/src/chat.ts +0 -1057
  579. package/src/web/src/composer.ts +0 -959
  580. package/src/web/src/dataset.ts +0 -132
  581. package/src/web/src/finetune.ts +0 -267
  582. package/src/web/src/hub.ts +0 -428
  583. package/src/web/src/main.ts +0 -98
  584. package/src/web/src/markdown.ts +0 -0
  585. package/src/web/src/memory-panel.ts +0 -572
  586. package/src/web/src/model-picker.ts +0 -159
  587. package/src/web/src/palette.ts +0 -346
  588. package/src/web/src/protocol.ts +0 -26
  589. package/src/web/src/quantize.ts +0 -167
  590. package/src/web/src/rag.ts +0 -274
  591. package/src/web/src/sessions.ts +0 -469
  592. package/src/web/src/shell.ts +0 -804
  593. package/src/web/src/ui-catalog.ts +0 -78
  594. package/src/web/vendor/README.md +0 -61
  595. package/src/web-assets.ts +0 -47
  596. package/src/web-tools.ts +0 -478
  597. package/src/weights.ts +0 -255
  598. /package/src/{serve → server}/completion-sink.ts +0 -0
  599. /package/src/web/{icon.svg → public/icon.svg} +0 -0
  600. /package/src/web/{manifest.webmanifest → public/manifest.webmanifest} +0 -0
  601. /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
- }