@simulatte/doppler 0.1.5 → 0.1.7

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 (392) hide show
  1. package/CHANGELOG.md +126 -0
  2. package/README.md +25 -17
  3. package/package.json +20 -4
  4. package/src/adapters/adapter-registry.js +12 -1
  5. package/src/adapters/lora-loader.js +23 -6
  6. package/src/bridge/extension-client.d.ts +5 -0
  7. package/src/bridge/extension-client.js +40 -0
  8. package/src/bridge/index.d.ts +2 -1
  9. package/src/bridge/index.js +6 -4
  10. package/src/browser/browser-converter.js +26 -1
  11. package/src/browser/file-picker.js +6 -0
  12. package/src/browser/safetensors-parser-browser.js +84 -1
  13. package/src/browser/shard-io-browser.js +2 -2
  14. package/src/browser/tensor-source-download.js +8 -2
  15. package/src/browser/tensor-source-http.d.ts +1 -0
  16. package/src/browser/tensor-source-http.js +5 -1
  17. package/src/client/doppler-api.browser.js +20 -4
  18. package/src/client/doppler-api.js +19 -3
  19. package/src/client/doppler-provider/generation.js +12 -0
  20. package/src/client/doppler-provider/model-manager.d.ts +10 -0
  21. package/src/client/doppler-provider/model-manager.js +91 -19
  22. package/src/client/doppler-provider/source-runtime.d.ts +2 -1
  23. package/src/client/doppler-provider/source-runtime.js +132 -13
  24. package/src/client/doppler-registry.json +8 -7
  25. package/src/config/backward-registry-loader.js +17 -2
  26. package/src/config/execution-v0-contract-check.js +113 -15
  27. package/src/config/kernel-path-contract-check.js +57 -29
  28. package/src/config/kernel-path-loader.js +5 -36
  29. package/src/config/kernels/kernel-ref-digests.js +39 -39
  30. package/src/config/kernels/registry.js +14 -1
  31. package/src/config/kernels/registry.json +49 -7
  32. package/src/config/loader.d.ts +1 -1
  33. package/src/config/loader.js +43 -4
  34. package/src/config/merge-contract-check.js +59 -4
  35. package/src/config/merge-helpers.js +128 -7
  36. package/src/config/merge.d.ts +1 -0
  37. package/src/config/merge.js +28 -0
  38. package/src/config/param-validator.js +47 -2
  39. package/src/config/presets/kernel-paths/{gemma2-q4k-dequant-f32a.json → gemma2-q4k-dequant-f32a-nosubgroups.json} +3 -3
  40. package/src/config/presets/kernel-paths/gemma3-f16-fused-f32a-online-streamingprefill.json +223 -0
  41. package/src/config/presets/kernel-paths/{gemma3-q4k-dequant-f32a.json → gemma3-q4k-dequant-f32a-nosubgroups.json} +3 -3
  42. package/src/config/presets/kernel-paths/registry.json +29 -8
  43. package/src/config/presets/models/gemma2.json +2 -2
  44. package/src/config/presets/models/qwen3.json +9 -2
  45. package/src/config/presets/models/transformer.json +5 -0
  46. package/src/config/presets/runtime/experiments/bench/gemma3-bench-q4k.json +1 -1
  47. package/src/config/presets/runtime/experiments/debug/gemma3-debug-q4k.json +1 -1
  48. package/src/config/presets/runtime/experiments/verify/gemma3-verify.json +1 -1
  49. package/src/config/presets/runtime/kernels/dequant-f16-q4k.json +6 -13
  50. package/src/config/presets/runtime/kernels/dequant-f32-q4k.json +6 -13
  51. package/src/config/presets/runtime/kernels/embeddinggemma-q4k-dequant-f32a.json +37 -0
  52. package/src/config/presets/runtime/kernels/fused-q4k.json +6 -13
  53. package/src/config/presets/runtime/kernels/gemma2-q4k-dequant-f16a.json +33 -0
  54. package/src/config/presets/runtime/kernels/gemma2-q4k-dequant-f32a-nosubgroups.json +33 -0
  55. package/src/config/presets/runtime/kernels/gemma2-q4k-fused-f32a.json +33 -0
  56. package/src/config/presets/runtime/kernels/safe-q4k.json +6 -13
  57. package/src/config/presets/runtime/platform/metal-apple-q4k.json +1 -1
  58. package/src/config/required-inference-fields-contract-check.js +6 -0
  59. package/src/config/runtime.js +6 -1
  60. package/src/config/schema/debug.schema.d.ts +5 -0
  61. package/src/config/schema/doppler.schema.js +16 -21
  62. package/src/config/schema/inference-defaults.schema.js +6 -3
  63. package/src/config/schema/inference.schema.d.ts +9 -0
  64. package/src/config/schema/kernel-path.schema.d.ts +11 -1
  65. package/src/config/schema/kernel-thresholds.schema.js +12 -4
  66. package/src/config/schema/manifest.schema.d.ts +8 -1
  67. package/src/config/schema/manifest.schema.js +19 -3
  68. package/src/config/training-defaults.js +30 -22
  69. package/src/converter/conversion-plan.js +94 -9
  70. package/src/converter/core.d.ts +7 -0
  71. package/src/converter/core.js +14 -9
  72. package/src/converter/execution-v0-manifest.js +4 -1
  73. package/src/converter/index.d.ts +1 -0
  74. package/src/converter/index.js +1 -0
  75. package/src/converter/manifest-inference.js +43 -12
  76. package/src/converter/parsers/diffusion.js +0 -3
  77. package/src/converter/quantization-info.js +35 -15
  78. package/src/converter/rope-config.js +42 -0
  79. package/src/converter/shard-packer.d.ts +1 -1
  80. package/src/converter/shard-packer.js +4 -1
  81. package/src/debug/config.js +123 -11
  82. package/src/debug/signals.js +7 -1
  83. package/src/debug/tensor.d.ts +2 -0
  84. package/src/debug/tensor.js +13 -2
  85. package/src/distribution/p2p-control-plane.js +52 -12
  86. package/src/distribution/p2p-observability.js +43 -7
  87. package/src/distribution/p2p-webrtc-browser.js +20 -0
  88. package/src/distribution/shard-delivery.js +77 -26
  89. package/src/formats/gguf/types.js +33 -16
  90. package/src/formats/rdrr/groups.d.ts +12 -4
  91. package/src/formats/rdrr/groups.js +3 -6
  92. package/src/formats/rdrr/parsing.js +39 -2
  93. package/src/formats/rdrr/types.d.ts +2 -1
  94. package/src/gpu/command-recorder.js +86 -61
  95. package/src/gpu/device.d.ts +1 -0
  96. package/src/gpu/device.js +131 -19
  97. package/src/gpu/kernel-tuner/benchmarks.js +326 -316
  98. package/src/gpu/kernel-tuner/cache.js +71 -4
  99. package/src/gpu/kernel-tuner/tuner.js +22 -4
  100. package/src/gpu/kernels/attention.js +113 -34
  101. package/src/gpu/kernels/backward/adam.js +62 -58
  102. package/src/gpu/kernels/backward/attention_backward.js +257 -169
  103. package/src/gpu/kernels/backward/conv2d_backward.js +14 -1
  104. package/src/gpu/kernels/bias_add.wgsl +8 -6
  105. package/src/gpu/kernels/bias_add_f16.wgsl +8 -5
  106. package/src/gpu/kernels/cast.js +191 -149
  107. package/src/gpu/kernels/check-stop.js +33 -44
  108. package/src/gpu/kernels/conv2d.js +27 -17
  109. package/src/gpu/kernels/conv2d.wgsl +7 -8
  110. package/src/gpu/kernels/conv2d_f16.wgsl +7 -8
  111. package/src/gpu/kernels/cross_entropy_loss.js +21 -15
  112. package/src/gpu/kernels/depthwise_conv2d.js +37 -26
  113. package/src/gpu/kernels/depthwise_conv2d.wgsl +6 -9
  114. package/src/gpu/kernels/depthwise_conv2d_f16.wgsl +6 -9
  115. package/src/gpu/kernels/dequant.js +178 -126
  116. package/src/gpu/kernels/energy.d.ts +3 -21
  117. package/src/gpu/kernels/energy.js +111 -88
  118. package/src/gpu/kernels/feature-check.js +1 -1
  119. package/src/gpu/kernels/fused_ffn.js +84 -65
  120. package/src/gpu/kernels/fused_matmul_residual.js +56 -33
  121. package/src/gpu/kernels/fused_matmul_rmsnorm.js +62 -45
  122. package/src/gpu/kernels/gather.js +33 -15
  123. package/src/gpu/kernels/gelu.js +19 -11
  124. package/src/gpu/kernels/grouped_pointwise_conv2d.js +34 -23
  125. package/src/gpu/kernels/grouped_pointwise_conv2d.wgsl +6 -9
  126. package/src/gpu/kernels/grouped_pointwise_conv2d_f16.wgsl +6 -9
  127. package/src/gpu/kernels/groupnorm.js +34 -23
  128. package/src/gpu/kernels/kv-quantize.js +5 -2
  129. package/src/gpu/kernels/layernorm.js +35 -19
  130. package/src/gpu/kernels/logit-merge.js +5 -3
  131. package/src/gpu/kernels/matmul.js +83 -39
  132. package/src/gpu/kernels/modulate.js +23 -15
  133. package/src/gpu/kernels/moe.js +221 -175
  134. package/src/gpu/kernels/pixel_shuffle.js +22 -14
  135. package/src/gpu/kernels/pixel_shuffle.wgsl +4 -5
  136. package/src/gpu/kernels/pixel_shuffle_f16.wgsl +4 -5
  137. package/src/gpu/kernels/relu.js +31 -10
  138. package/src/gpu/kernels/relu.wgsl +2 -1
  139. package/src/gpu/kernels/relu_f16.wgsl +2 -1
  140. package/src/gpu/kernels/repeat_channels.js +25 -17
  141. package/src/gpu/kernels/repeat_channels.wgsl +4 -5
  142. package/src/gpu/kernels/repeat_channels_f16.wgsl +4 -5
  143. package/src/gpu/kernels/residual.js +69 -23
  144. package/src/gpu/kernels/residual.wgsl +6 -3
  145. package/src/gpu/kernels/residual_f16.wgsl +2 -1
  146. package/src/gpu/kernels/residual_f16_vec4.wgsl +2 -1
  147. package/src/gpu/kernels/residual_vec4.wgsl +2 -1
  148. package/src/gpu/kernels/rmsnorm.js +96 -28
  149. package/src/gpu/kernels/rmsnorm.wgsl +14 -6
  150. package/src/gpu/kernels/rmsnorm_f16.wgsl +10 -2
  151. package/src/gpu/kernels/rope.d.ts +2 -0
  152. package/src/gpu/kernels/rope.js +14 -1
  153. package/src/gpu/kernels/rope.wgsl +56 -40
  154. package/src/gpu/kernels/sample.js +27 -38
  155. package/src/gpu/kernels/sana_linear_attention.js +19 -12
  156. package/src/gpu/kernels/sana_linear_attention_apply.wgsl +4 -5
  157. package/src/gpu/kernels/sana_linear_attention_apply_f16.wgsl +4 -5
  158. package/src/gpu/kernels/sana_linear_attention_summary.wgsl +4 -0
  159. package/src/gpu/kernels/sana_linear_attention_summary_f16.wgsl +4 -0
  160. package/src/gpu/kernels/scale.js +18 -11
  161. package/src/gpu/kernels/shader-cache.js +4 -2
  162. package/src/gpu/kernels/silu.d.ts +1 -0
  163. package/src/gpu/kernels/silu.js +148 -82
  164. package/src/gpu/kernels/silu.wgsl +19 -9
  165. package/src/gpu/kernels/silu_f16.wgsl +19 -9
  166. package/src/gpu/kernels/softmax.js +44 -25
  167. package/src/gpu/kernels/split_qkv.js +23 -13
  168. package/src/gpu/kernels/transpose.js +31 -10
  169. package/src/gpu/kernels/transpose.wgsl +6 -5
  170. package/src/gpu/kernels/upsample2d.js +22 -13
  171. package/src/gpu/kernels/upsample2d.wgsl +6 -9
  172. package/src/gpu/kernels/upsample2d_f16.wgsl +6 -9
  173. package/src/gpu/kernels/utils.js +35 -13
  174. package/src/gpu/partitioned-buffer-pool.js +10 -2
  175. package/src/gpu/perf-guards.js +2 -9
  176. package/src/gpu/profiler.js +27 -22
  177. package/src/gpu/readback-utils.d.ts +16 -0
  178. package/src/gpu/readback-utils.js +41 -0
  179. package/src/gpu/submit-tracker.js +13 -0
  180. package/src/gpu/uniform-cache.d.ts +1 -0
  181. package/src/gpu/uniform-cache.js +30 -9
  182. package/src/hotswap/intent-bundle.js +6 -0
  183. package/src/hotswap/manifest.d.ts +10 -1
  184. package/src/hotswap/manifest.js +12 -2
  185. package/src/hotswap/runtime.js +30 -8
  186. package/src/index-browser.d.ts +44 -0
  187. package/src/index-browser.js +14 -0
  188. package/src/inference/browser-harness-contract-helpers.d.ts +5 -0
  189. package/src/inference/browser-harness-contract-helpers.js +28 -0
  190. package/src/inference/browser-harness-diffusion-energy-suites.d.ts +2 -0
  191. package/src/inference/browser-harness-diffusion-energy-suites.js +269 -0
  192. package/src/inference/browser-harness-model-helpers.d.ts +16 -0
  193. package/src/inference/browser-harness-model-helpers.js +217 -0
  194. package/src/inference/browser-harness-report-helpers.d.ts +7 -0
  195. package/src/inference/browser-harness-report-helpers.js +42 -0
  196. package/src/inference/browser-harness-runtime-helpers.d.ts +61 -0
  197. package/src/inference/browser-harness-runtime-helpers.js +415 -0
  198. package/src/inference/browser-harness-suite-helpers.d.ts +28 -0
  199. package/src/inference/browser-harness-suite-helpers.js +268 -0
  200. package/src/inference/browser-harness-text-helpers.d.ts +27 -0
  201. package/src/inference/browser-harness-text-helpers.js +788 -0
  202. package/src/inference/browser-harness.d.ts +6 -0
  203. package/src/inference/browser-harness.js +130 -1950
  204. package/src/inference/kv-cache/base.js +140 -94
  205. package/src/inference/kv-cache/tiered.js +5 -3
  206. package/src/inference/moe-router.js +88 -56
  207. package/src/inference/multi-model-network.js +5 -3
  208. package/src/inference/network-evolution.d.ts +11 -2
  209. package/src/inference/network-evolution.js +20 -21
  210. package/src/inference/pipelines/context.d.ts +3 -0
  211. package/src/inference/pipelines/context.js +142 -2
  212. package/src/inference/pipelines/diffusion/helpers.js +7 -2
  213. package/src/inference/pipelines/diffusion/pipeline.js +17 -7
  214. package/src/inference/pipelines/diffusion/sd3-transformer.js +10 -10
  215. package/src/inference/pipelines/diffusion/text-encoder-gpu.d.ts +5 -0
  216. package/src/inference/pipelines/diffusion/text-encoder-gpu.js +27 -15
  217. package/src/inference/pipelines/diffusion/vae.js +3 -7
  218. package/src/inference/pipelines/energy/pipeline.js +27 -21
  219. package/src/inference/pipelines/energy/quintel.d.ts +5 -0
  220. package/src/inference/pipelines/energy/quintel.js +11 -0
  221. package/src/inference/pipelines/energy-head/row-head-pipeline.js +17 -13
  222. package/src/inference/pipelines/structured/json-head-pipeline.js +26 -11
  223. package/src/inference/pipelines/text/attention/projections.js +151 -101
  224. package/src/inference/pipelines/text/attention/record.js +73 -10
  225. package/src/inference/pipelines/text/attention/run.js +73 -10
  226. package/src/inference/pipelines/text/chat-format.js +25 -1
  227. package/src/inference/pipelines/text/config.d.ts +4 -0
  228. package/src/inference/pipelines/text/config.js +71 -5
  229. package/src/inference/pipelines/text/embed.js +2 -8
  230. package/src/inference/pipelines/text/execution-plan.js +64 -50
  231. package/src/inference/pipelines/text/execution-v0-contract-helpers.d.ts +59 -0
  232. package/src/inference/pipelines/text/execution-v0-contract-helpers.js +937 -0
  233. package/src/inference/pipelines/text/execution-v0-runtime-builders.d.ts +15 -0
  234. package/src/inference/pipelines/text/execution-v0-runtime-builders.js +279 -0
  235. package/src/inference/pipelines/text/execution-v0.js +78 -1002
  236. package/src/inference/pipelines/text/ffn/standard.js +3 -0
  237. package/src/inference/pipelines/text/generator-steps.d.ts +46 -0
  238. package/src/inference/pipelines/text/generator-steps.js +298 -207
  239. package/src/inference/pipelines/text/generator.js +6 -23
  240. package/src/inference/pipelines/text/init.d.ts +4 -0
  241. package/src/inference/pipelines/text/init.js +134 -29
  242. package/src/inference/pipelines/text/kernel-path-auto-select.js +2 -0
  243. package/src/inference/pipelines/text/kernel-trace.d.ts +2 -0
  244. package/src/inference/pipelines/text/kernel-trace.js +6 -0
  245. package/src/inference/pipelines/text/layer.js +14 -9
  246. package/src/inference/pipelines/text/linear-attention.d.ts +10 -0
  247. package/src/inference/pipelines/text/linear-attention.js +80 -6
  248. package/src/inference/pipelines/text/logits/gpu.js +10 -5
  249. package/src/inference/pipelines/text/logits/index.js +10 -11
  250. package/src/inference/pipelines/text/logits/utils.d.ts +7 -0
  251. package/src/inference/pipelines/text/logits/utils.js +9 -0
  252. package/src/inference/pipelines/text/lora-apply.js +50 -32
  253. package/src/inference/pipelines/text/model-load.js +279 -104
  254. package/src/inference/pipelines/text/moe-cache.js +5 -4
  255. package/src/inference/pipelines/text/moe-cpu-gptoss.js +74 -69
  256. package/src/inference/pipelines/text/moe-cpu.js +42 -38
  257. package/src/inference/pipelines/text/moe-gpu.js +110 -86
  258. package/src/inference/pipelines/text/ops.js +90 -90
  259. package/src/inference/pipelines/text/probes.js +9 -9
  260. package/src/inference/pipelines/text/weights.js +17 -7
  261. package/src/inference/pipelines/text.js +17 -1
  262. package/src/inference/speculative.d.ts +2 -2
  263. package/src/inference/speculative.js +4 -18
  264. package/src/inference/test-harness.d.ts +1 -1
  265. package/src/inference/test-harness.js +15 -5
  266. package/src/inference/tokenizer.d.ts +0 -5
  267. package/src/inference/tokenizer.js +4 -23
  268. package/src/inference/tokenizers/bpe.js +9 -0
  269. package/src/inference/tokenizers/bundled.js +176 -33
  270. package/src/inference/tokenizers/sentencepiece.js +12 -0
  271. package/src/loader/doppler-loader.js +38 -22
  272. package/src/loader/dtype-utils.js +3 -44
  273. package/src/loader/embedding-loader.js +7 -3
  274. package/src/loader/experts/expert-cache.js +13 -6
  275. package/src/loader/experts/expert-loader.js +10 -6
  276. package/src/loader/final-weights-loader.js +8 -4
  277. package/src/loader/layer-loader.js +2 -1
  278. package/src/loader/loader-state.js +2 -2
  279. package/src/loader/memory-monitor.js +8 -0
  280. package/src/loader/multi-model-loader.d.ts +14 -0
  281. package/src/loader/multi-model-loader.js +70 -24
  282. package/src/loader/shard-cache.js +81 -12
  283. package/src/loader/shard-resolver.js +25 -3
  284. package/src/loader/tensors/tensor-loader.js +209 -144
  285. package/src/loader/tensors/tensor-reader.js +76 -19
  286. package/src/loader/weight-downcast.js +1 -1
  287. package/src/memory/buffer-pool.d.ts +9 -1
  288. package/src/memory/buffer-pool.js +109 -44
  289. package/src/memory/unified-detect.js +1 -1
  290. package/src/rules/inference/kernel-path.rules.json +24 -8
  291. package/src/rules/rule-registry.js +25 -1
  292. package/src/rules/tooling/command-runtime.rules.json +18 -0
  293. package/src/storage/backends/opfs-store.js +68 -24
  294. package/src/storage/downloader.js +364 -83
  295. package/src/storage/index.d.ts +3 -0
  296. package/src/storage/index.js +3 -0
  297. package/src/storage/preflight.d.ts +2 -2
  298. package/src/storage/preflight.js +24 -2
  299. package/src/storage/quickstart-downloader.js +11 -5
  300. package/src/storage/registry.js +10 -4
  301. package/src/storage/reports.js +1 -1
  302. package/src/storage/shard-manager.d.ts +15 -1
  303. package/src/storage/shard-manager.js +51 -3
  304. package/src/storage/source-artifact-store.d.ts +52 -0
  305. package/src/storage/source-artifact-store.js +234 -0
  306. package/src/tooling/command-api-constants.d.ts +9 -0
  307. package/src/tooling/command-api-constants.js +9 -0
  308. package/src/tooling/command-api-family-normalizers.d.ts +9 -0
  309. package/src/tooling/command-api-family-normalizers.js +343 -0
  310. package/src/tooling/command-api-helpers.d.ts +25 -0
  311. package/src/tooling/command-api-helpers.js +262 -0
  312. package/src/tooling/command-api.d.ts +27 -1
  313. package/src/tooling/command-api.js +26 -473
  314. package/src/tooling/command-envelope.js +4 -1
  315. package/src/tooling/command-runner-shared.js +52 -18
  316. package/src/tooling/lean-execution-contract.js +150 -3
  317. package/src/tooling/node-browser-command-runner.d.ts +4 -0
  318. package/src/tooling/node-browser-command-runner.js +218 -273
  319. package/src/tooling/node-command-runner.js +44 -3
  320. package/src/tooling/node-converter.js +27 -1
  321. package/src/tooling/node-source-runtime.d.ts +1 -1
  322. package/src/tooling/node-source-runtime.js +84 -3
  323. package/src/tooling/node-webgpu.js +30 -105
  324. package/src/tooling/opfs-cache.js +21 -4
  325. package/src/tooling/runtime-input-composition.d.ts +38 -0
  326. package/src/tooling/runtime-input-composition.js +86 -0
  327. package/src/tooling/source-runtime-bundle.d.ts +40 -5
  328. package/src/tooling/source-runtime-bundle.js +261 -34
  329. package/src/tooling/source-runtime-materializer.d.ts +6 -0
  330. package/src/tooling/source-runtime-materializer.js +93 -0
  331. package/src/training/attention-backward.js +32 -17
  332. package/src/training/autograd.js +80 -52
  333. package/src/training/checkpoint-watch.d.ts +8 -0
  334. package/src/training/checkpoint-watch.js +139 -0
  335. package/src/training/checkpoint.d.ts +6 -1
  336. package/src/training/checkpoint.js +46 -7
  337. package/src/training/clip.js +2 -1
  338. package/src/training/datasets/token-batch.js +20 -8
  339. package/src/training/distillation/artifacts.d.ts +71 -0
  340. package/src/training/distillation/artifacts.js +132 -0
  341. package/src/training/distillation/checkpoint-watch.d.ts +10 -0
  342. package/src/training/distillation/checkpoint-watch.js +58 -0
  343. package/src/training/distillation/dataset.d.ts +59 -0
  344. package/src/training/distillation/dataset.js +337 -0
  345. package/src/training/distillation/eval.d.ts +34 -0
  346. package/src/training/distillation/eval.js +310 -0
  347. package/src/training/distillation/index.d.ts +29 -0
  348. package/src/training/distillation/index.js +29 -0
  349. package/src/training/distillation/runtime.d.ts +20 -0
  350. package/src/training/distillation/runtime.js +121 -0
  351. package/src/training/distillation/scoreboard.d.ts +6 -0
  352. package/src/training/distillation/scoreboard.js +8 -0
  353. package/src/training/distillation/stage-a.d.ts +45 -0
  354. package/src/training/distillation/stage-a.js +338 -0
  355. package/src/training/distillation/stage-b.d.ts +24 -0
  356. package/src/training/distillation/stage-b.js +20 -0
  357. package/src/training/distillation/student-fixture.d.ts +22 -0
  358. package/src/training/distillation/student-fixture.js +846 -0
  359. package/src/training/distillation/suite-data.d.ts +45 -0
  360. package/src/training/distillation/suite-data.js +189 -0
  361. package/src/training/index.d.ts +10 -0
  362. package/src/training/index.js +10 -0
  363. package/src/training/lora-pipeline.d.ts +40 -0
  364. package/src/training/lora-pipeline.js +793 -0
  365. package/src/training/lora.js +26 -12
  366. package/src/training/loss.js +5 -6
  367. package/src/training/objectives/cross_entropy.js +2 -5
  368. package/src/training/objectives/distill_kd.js +4 -8
  369. package/src/training/objectives/distill_triplet.js +4 -8
  370. package/src/training/objectives/ul_stage2_base.js +4 -8
  371. package/src/training/operator-artifacts.d.ts +62 -0
  372. package/src/training/operator-artifacts.js +140 -0
  373. package/src/training/operator-command.d.ts +5 -0
  374. package/src/training/operator-command.js +455 -0
  375. package/src/training/operator-eval.d.ts +48 -0
  376. package/src/training/operator-eval.js +230 -0
  377. package/src/training/operator-scoreboard.d.ts +5 -0
  378. package/src/training/operator-scoreboard.js +44 -0
  379. package/src/training/optimizer.js +19 -7
  380. package/src/training/runner.d.ts +52 -0
  381. package/src/training/runner.js +31 -5
  382. package/src/training/suite.d.ts +112 -0
  383. package/src/training/suite.js +24 -984
  384. package/src/training/tensor-factory.d.ts +9 -0
  385. package/src/training/tensor-factory.js +13 -0
  386. package/src/training/trainer.js +3 -5
  387. package/src/training/ul_dataset.js +3 -5
  388. package/src/training/workloads.d.ts +164 -0
  389. package/src/training/workloads.js +530 -0
  390. package/src/version.js +1 -1
  391. package/tools/convert-safetensors-node.js +22 -16
  392. package/tools/doppler-cli.js +179 -63
@@ -30,81 +30,86 @@ export async function runGptOssExpertCPU(layerIdx, expertIdx, input, config, exp
30
30
  const inputBuffer = acquireBuffer(input.byteLength, undefined, 'moe_cpu_gptoss_input');
31
31
  device.queue.writeBuffer(inputBuffer, 0, input);
32
32
  const inputTensor = createTensor(inputBuffer, 'f32', [numTokens, hiddenSize], 'moe_cpu_gptoss_input');
33
+ let gateUpWeight = null;
34
+ let downWeight = null;
35
+ let gateUpOut = null;
36
+ let activated = null;
37
+ let downOut = null;
38
+ try {
39
+ gateUpWeight = await dequantizeMXFP4Expert(
40
+ weights.gateUpBlocks,
41
+ weights.gateUpScales,
42
+ expertIdx,
43
+ numExperts,
44
+ outDim,
45
+ gateUpGroups,
46
+ { outputDtype: 'f32', modelType: 'gpt-oss', groupSize: 32, dequantTileShape: 'scalar' }
47
+ );
33
48
 
34
- const gateUpWeight = await dequantizeMXFP4Expert(
35
- weights.gateUpBlocks,
36
- weights.gateUpScales,
37
- expertIdx,
38
- numExperts,
39
- outDim,
40
- gateUpGroups,
41
- { outputDtype: 'f32', modelType: 'gpt-oss', groupSize: 32, dequantTileShape: 'scalar' }
42
- );
49
+ downWeight = await dequantizeMXFP4Expert(
50
+ weights.downBlocks,
51
+ weights.downScales,
52
+ expertIdx,
53
+ numExperts,
54
+ hiddenSize,
55
+ downGroups,
56
+ { outputDtype: 'f32', modelType: 'gpt-oss', groupSize: 32, dequantTileShape: 'scalar' }
57
+ );
43
58
 
44
- const downWeight = await dequantizeMXFP4Expert(
45
- weights.downBlocks,
46
- weights.downScales,
47
- expertIdx,
48
- numExperts,
49
- hiddenSize,
50
- downGroups,
51
- { outputDtype: 'f32', modelType: 'gpt-oss', groupSize: 32, dequantTileShape: 'scalar' }
52
- );
59
+ gateUpOut = await runMatmul(
60
+ inputTensor,
61
+ gateUpWeight.buffer,
62
+ numTokens,
63
+ outDim,
64
+ hiddenSize,
65
+ {
66
+ transposeB: 'auto',
67
+ bDtype: 'f32',
68
+ outputDtype: 'f32',
69
+ role: 'moe_gate_up',
70
+ kernelPath,
71
+ }
72
+ );
53
73
 
54
- const gateUpOut = await runMatmul(
55
- inputTensor,
56
- gateUpWeight.buffer,
57
- numTokens,
58
- outDim,
59
- hiddenSize,
60
- {
61
- transposeB: 'auto',
62
- bDtype: 'f32',
63
- outputDtype: 'f32',
64
- role: 'moe_gate_up',
65
- kernelPath,
66
- }
67
- );
74
+ const biasOffset = expertIdx * outDim * 4;
75
+ const biasTensor = createTensor(weights.gateUpBias, 'f32', [numExperts * outDim], 'moe_cpu_gptoss_bias');
76
+ activated = await runSwiGLURowsplitBias(gateUpOut, biasTensor, numTokens, intermediateSize, {
77
+ biasOffset,
78
+ swigluLimit,
79
+ });
68
80
 
69
- const biasOffset = expertIdx * outDim * 4;
70
- const biasTensor = createTensor(weights.gateUpBias, 'f32', [numExperts * outDim], 'moe_cpu_gptoss_bias');
71
- const activated = await runSwiGLURowsplitBias(gateUpOut, biasTensor, numTokens, intermediateSize, {
72
- biasOffset,
73
- swigluLimit,
74
- });
81
+ downOut = await runMatmul(
82
+ activated,
83
+ downWeight.buffer,
84
+ numTokens,
85
+ hiddenSize,
86
+ intermediateSize,
87
+ {
88
+ transposeB: 'auto',
89
+ bDtype: 'f32',
90
+ outputDtype: 'f32',
91
+ role: 'moe_down',
92
+ kernelPath,
93
+ }
94
+ );
75
95
 
76
- const downOut = await runMatmul(
77
- activated,
78
- downWeight.buffer,
79
- numTokens,
80
- hiddenSize,
81
- intermediateSize,
82
- {
83
- transposeB: 'auto',
84
- bDtype: 'f32',
85
- outputDtype: 'f32',
86
- role: 'moe_down',
87
- kernelPath,
96
+ if (weights.downBias) {
97
+ const downBiasOffset = expertIdx * hiddenSize * 4;
98
+ const downBiasTensor = createTensor(weights.downBias, 'f32', [numExperts * hiddenSize], 'moe_cpu_gptoss_down_bias');
99
+ await runBiasAdd(downOut, downBiasTensor, numTokens, hiddenSize, {
100
+ dataOffset: 0,
101
+ biasOffset: downBiasOffset,
102
+ });
88
103
  }
89
- );
90
104
 
91
- if (weights.downBias) {
92
- const downBiasOffset = expertIdx * hiddenSize * 4;
93
- const downBiasTensor = createTensor(weights.downBias, 'f32', [numExperts * hiddenSize], 'moe_cpu_gptoss_down_bias');
94
- await runBiasAdd(downOut, downBiasTensor, numTokens, hiddenSize, {
95
- dataOffset: 0,
96
- biasOffset: downBiasOffset,
97
- });
105
+ const outputData = await readBuffer(downOut.buffer, input.byteLength);
106
+ return new Float32Array(outputData);
107
+ } finally {
108
+ releaseBuffer(inputBuffer);
109
+ if (gateUpWeight) releaseBuffer(gateUpWeight.buffer);
110
+ if (downWeight) releaseBuffer(downWeight.buffer);
111
+ if (gateUpOut) releaseBuffer(gateUpOut.buffer);
112
+ if (activated) releaseBuffer(activated.buffer);
113
+ if (downOut) releaseBuffer(downOut.buffer);
98
114
  }
99
-
100
- const outputData = await readBuffer(downOut.buffer, input.byteLength);
101
-
102
- releaseBuffer(inputBuffer);
103
- releaseBuffer(gateUpWeight.buffer);
104
- releaseBuffer(downWeight.buffer);
105
- releaseBuffer(gateUpOut.buffer);
106
- releaseBuffer(activated.buffer);
107
- releaseBuffer(downOut.buffer);
108
-
109
- return new Float32Array(outputData);
110
115
  }
@@ -75,42 +75,46 @@ async function runExpertCPU(layerIdx, expertIdx, input, config, expertWeights) {
75
75
  const inputBuffer = acquireBuffer(input.byteLength, undefined, 'expert_input');
76
76
  device.queue.writeBuffer(inputBuffer, 0, input);
77
77
  const inputTensor = createTensor(inputBuffer, 'f32', [numTokens, hiddenSize], 'expert_input');
78
-
79
- const gateOutput = await runMatmul(inputTensor, weights.gate, numTokens, intermediateSize, hiddenSize, {
80
- transposeB: 'auto',
81
- role: 'moe_gate',
82
- kernelPath,
83
- });
84
-
85
- const upOutput = await runMatmul(inputTensor, weights.up, numTokens, intermediateSize, hiddenSize, {
86
- transposeB: 'auto',
87
- role: 'moe_up',
88
- kernelPath,
89
- });
90
-
91
- const activationFn = {
92
- gelu: runGeLU,
93
- silu: runSiLU,
94
- }[selectRuleValue('inference', 'ffn', 'activationOp', { hiddenActivation })];
95
- const activatedOutput = await activationFn(upOutput, {
96
- size: numTokens * intermediateSize,
97
- gate: gateOutput,
98
- swigluLimit,
99
- });
100
-
101
- const output = await runMatmul(activatedOutput, weights.down, numTokens, hiddenSize, intermediateSize, {
102
- transposeB: 'auto',
103
- role: 'moe_down',
104
- kernelPath,
105
- });
106
-
107
- const outputData = await readBuffer(output.buffer, input.byteLength);
108
-
109
- releaseBuffer(inputBuffer);
110
- releaseBuffer(gateOutput.buffer);
111
- releaseBuffer(upOutput.buffer);
112
- releaseBuffer(activatedOutput.buffer);
113
- releaseBuffer(output.buffer);
114
-
115
- return new Float32Array(outputData);
78
+ let gateOutput = null;
79
+ let upOutput = null;
80
+ let activatedOutput = null;
81
+ let output = null;
82
+ try {
83
+ gateOutput = await runMatmul(inputTensor, weights.gate, numTokens, intermediateSize, hiddenSize, {
84
+ transposeB: 'auto',
85
+ role: 'moe_gate',
86
+ kernelPath,
87
+ });
88
+
89
+ upOutput = await runMatmul(inputTensor, weights.up, numTokens, intermediateSize, hiddenSize, {
90
+ transposeB: 'auto',
91
+ role: 'moe_up',
92
+ kernelPath,
93
+ });
94
+
95
+ const activationFn = {
96
+ gelu: runGeLU,
97
+ silu: runSiLU,
98
+ }[selectRuleValue('inference', 'ffn', 'activationOp', { hiddenActivation })];
99
+ activatedOutput = await activationFn(upOutput, {
100
+ size: numTokens * intermediateSize,
101
+ gate: gateOutput,
102
+ swigluLimit,
103
+ });
104
+
105
+ output = await runMatmul(activatedOutput, weights.down, numTokens, hiddenSize, intermediateSize, {
106
+ transposeB: 'auto',
107
+ role: 'moe_down',
108
+ kernelPath,
109
+ });
110
+
111
+ const outputData = await readBuffer(output.buffer, input.byteLength);
112
+ return new Float32Array(outputData);
113
+ } finally {
114
+ releaseBuffer(inputBuffer);
115
+ if (gateOutput) releaseBuffer(gateOutput.buffer);
116
+ if (upOutput) releaseBuffer(upOutput.buffer);
117
+ if (activatedOutput) releaseBuffer(activatedOutput.buffer);
118
+ if (output) releaseBuffer(output.buffer);
119
+ }
116
120
  }
@@ -81,17 +81,27 @@ export async function moeFeedForwardGPU(
81
81
  };
82
82
 
83
83
  const inputTensor = createTensor(inputBuffer, activationDtype, [numTokens, hiddenSize], 'moe_input');
84
+ let logitsBuffer = null;
85
+ let indicesBuffer = null;
86
+ let weightsBuffer = null;
87
+ let gathered = null;
88
+ let tokenCounts = null;
89
+ let tokenMap = null;
90
+ let expertOutputs = null;
91
+ let tokenOffsets = null;
92
+ let outputTensor = null;
84
93
 
85
94
  const layerRouter = layerRouterWeights?.get(layerIdx) || null;
86
95
  if (layerRouter) {
87
96
  moeRouter.loadWeights(layerRouter.weight, layerRouter.bias || null);
88
97
  }
89
98
 
90
- let stepStart = perfMark();
91
- const logitsBuffer = await moeRouter.computeRouterLogitsGPU(inputTensor.buffer, numTokens, null, {
92
- inputDtype: activationDtype,
93
- outputDtype: activationDtype,
94
- });
99
+ try {
100
+ let stepStart = perfMark();
101
+ logitsBuffer = await moeRouter.computeRouterLogitsGPU(inputTensor.buffer, numTokens, null, {
102
+ inputDtype: activationDtype,
103
+ outputDtype: activationDtype,
104
+ });
95
105
  const logitsDtype = moeRouter.lastLogitsDtype ?? activationDtype;
96
106
  perfLog(`MoE L${layerIdx} router`, stepStart, { numTokens, logitsDtype });
97
107
 
@@ -134,18 +144,18 @@ export async function moeFeedForwardGPU(
134
144
  }
135
145
 
136
146
  stepStart = perfMark();
137
- const { indices: indicesBuffer, weights: weightsBuffer } = await runSoftmaxTopK(
138
- logitsBuffer,
139
- numTokens,
140
- numExperts,
141
- topK,
142
- {
143
- normalize: moeRouter.normalizeWeights,
144
- inputDtype: logitsDtype,
145
- weightsDtype: activationDtype,
146
- modelType,
147
- }
148
- );
147
+ ({ indices: indicesBuffer, weights: weightsBuffer } = await runSoftmaxTopK(
148
+ logitsBuffer,
149
+ numTokens,
150
+ numExperts,
151
+ topK,
152
+ {
153
+ normalize: moeRouter.normalizeWeights,
154
+ inputDtype: logitsDtype,
155
+ weightsDtype: activationDtype,
156
+ modelType,
157
+ }
158
+ ));
149
159
  perfLog(`MoE L${layerIdx} topk`, stepStart, {
150
160
  topK,
151
161
  modelType,
@@ -195,7 +205,8 @@ export async function moeFeedForwardGPU(
195
205
  trace.buffers(`MoE L${layerIdx} topk_weights`, { minW, maxW, nanW, dtype: activationDtype });
196
206
  }
197
207
 
198
- releaseBuffer(logitsBuffer);
208
+ releaseBuffer(logitsBuffer);
209
+ logitsBuffer = null;
199
210
 
200
211
  const bytesPerElement = selectRuleValue('shared', 'dtype', 'bytesFromDtype', { dtype: activationDtype });
201
212
  const bytesPerToken = hiddenSize * bytesPerElement;
@@ -207,47 +218,44 @@ export async function moeFeedForwardGPU(
207
218
  );
208
219
  }
209
220
 
210
- let gathered;
211
- let tokenCounts;
212
- let tokenMap;
213
-
214
- stepStart = perfMark();
215
- ({ gathered, tokenCounts, tokenMap } = await runMoEGather(
216
- inputTensor,
217
- indicesBuffer,
218
- numTokens,
219
- hiddenSize,
220
- numExperts,
221
- topK,
222
- { maxTokensPerExpert }
223
- ));
221
+ stepStart = perfMark();
222
+ ({ gathered, tokenCounts, tokenMap } = await runMoEGather(
223
+ inputTensor,
224
+ indicesBuffer,
225
+ numTokens,
226
+ hiddenSize,
227
+ numExperts,
228
+ topK,
229
+ { maxTokensPerExpert }
230
+ ));
224
231
  perfLog(`MoE L${layerIdx} gather`, stepStart, { maxTokensPerExpert });
225
232
 
226
- const expertOutputs = acquireBuffer(
227
- numExperts * maxTokensPerExpert * hiddenSize * bytesPerElement,
228
- undefined,
229
- 'moe_expert_outputs_gathered'
230
- );
233
+ expertOutputs = acquireBuffer(
234
+ numExperts * maxTokensPerExpert * hiddenSize * bytesPerElement,
235
+ undefined,
236
+ 'moe_expert_outputs_gathered'
237
+ );
231
238
 
232
239
  const zeroEncoder = device.createCommandEncoder({ label: 'zero_moe_expert_outputs' });
233
240
  zeroEncoder.clearBuffer(expertOutputs, 0, numExperts * maxTokensPerExpert * hiddenSize * bytesPerElement);
234
241
  device.queue.submit([zeroEncoder.finish()]);
235
242
 
236
- stepStart = perfMark();
237
- const tokenOffsets = await runMoEBuildTokenOffsets(
238
- tokenCounts,
239
- tokenMap,
240
- numTokens,
241
- numExperts,
242
- topK,
243
- maxTokensPerExpert
244
- );
243
+ stepStart = perfMark();
244
+ tokenOffsets = await runMoEBuildTokenOffsets(
245
+ tokenCounts,
246
+ tokenMap,
247
+ numTokens,
248
+ numExperts,
249
+ topK,
250
+ maxTokensPerExpert
251
+ );
245
252
  perfLog(`MoE L${layerIdx} offsets_kernel`, stepStart, {
246
253
  totalSlots: numExperts * maxTokensPerExpert,
247
254
  routingSlots: numTokens * topK,
248
255
  });
249
256
 
250
- releaseBuffer(tokenCounts);
257
+ releaseBuffer(tokenCounts);
258
+ tokenCounts = null;
251
259
 
252
260
  const expertStrideBytes = maxTokensPerExpert * bytesPerToken;
253
261
  const rowsPerExpert = maxTokensPerExpert;
@@ -322,49 +330,65 @@ export async function moeFeedForwardGPU(
322
330
  perfLog(`MoE L${layerIdx} expert_exec`, stepStart, { expertIdx, count });
323
331
  }
324
332
 
325
- const expertOutputsTensor = createTensor(
326
- expertOutputs,
327
- activationDtype,
328
- [numExperts, maxTokensPerExpert, hiddenSize],
329
- 'moe_expert_outputs'
330
- );
331
- stepStart = perfMark();
332
- const outputTensor = await runScatterAddDynamic(
333
- expertOutputsTensor,
334
- indicesBuffer,
335
- weightsBuffer,
336
- tokenOffsets,
337
- numTokens,
338
- hiddenSize,
339
- topK,
340
- { weightsDtype: activationDtype }
341
- );
333
+ const expertOutputsTensor = createTensor(
334
+ expertOutputs,
335
+ activationDtype,
336
+ [numExperts, maxTokensPerExpert, hiddenSize],
337
+ 'moe_expert_outputs'
338
+ );
339
+ stepStart = perfMark();
340
+ outputTensor = await runScatterAddDynamic(
341
+ expertOutputsTensor,
342
+ indicesBuffer,
343
+ weightsBuffer,
344
+ tokenOffsets,
345
+ numTokens,
346
+ hiddenSize,
347
+ topK,
348
+ { weightsDtype: activationDtype }
349
+ );
342
350
  perfLog(`MoE L${layerIdx} scatter`, stepStart, { numTokens, hiddenSize });
343
351
 
344
- releaseBuffer(gathered.buffer);
345
- releaseBuffer(tokenMap);
346
- releaseBuffer(expertOutputs);
347
- releaseBuffer(tokenOffsets);
348
- releaseBuffer(indicesBuffer);
349
- releaseBuffer(weightsBuffer);
352
+ releaseBuffer(gathered.buffer);
353
+ gathered = null;
354
+ releaseBuffer(tokenMap);
355
+ tokenMap = null;
356
+ releaseBuffer(expertOutputs);
357
+ expertOutputs = null;
358
+ releaseBuffer(tokenOffsets);
359
+ tokenOffsets = null;
360
+ releaseBuffer(indicesBuffer);
361
+ indicesBuffer = null;
362
+ releaseBuffer(weightsBuffer);
363
+ weightsBuffer = null;
364
+
365
+ if (perfEnabled) {
366
+ const cacheStats = getDequantCacheStats();
367
+ trace.perf(`MoE L${layerIdx} done`, {
368
+ numTokens,
369
+ topK,
370
+ executedExperts: numExperts,
371
+ rowsPerExpert,
372
+ maxTokensPerExpert,
373
+ dequantCacheHits: cacheStats.hits,
374
+ dequantCacheMisses: cacheStats.misses,
375
+ expertCache: typeof expertLoader?.getExpertCacheStats === 'function'
376
+ ? expertLoader.getExpertCacheStats()
377
+ : null,
378
+ });
379
+ }
350
380
 
351
- if (perfEnabled) {
352
- const cacheStats = getDequantCacheStats();
353
- trace.perf(`MoE L${layerIdx} done`, {
354
- numTokens,
355
- topK,
356
- executedExperts: numExperts,
357
- rowsPerExpert,
358
- maxTokensPerExpert,
359
- dequantCacheHits: cacheStats.hits,
360
- dequantCacheMisses: cacheStats.misses,
361
- expertCache: typeof expertLoader?.getExpertCacheStats === 'function'
362
- ? expertLoader.getExpertCacheStats()
363
- : null,
364
- });
381
+ return outputTensor.buffer;
382
+ } finally {
383
+ if (logitsBuffer) releaseBuffer(logitsBuffer);
384
+ if (tokenCounts) releaseBuffer(tokenCounts);
385
+ if (gathered?.buffer) releaseBuffer(gathered.buffer);
386
+ if (tokenMap) releaseBuffer(tokenMap);
387
+ if (expertOutputs) releaseBuffer(expertOutputs);
388
+ if (tokenOffsets) releaseBuffer(tokenOffsets);
389
+ if (indicesBuffer) releaseBuffer(indicesBuffer);
390
+ if (weightsBuffer) releaseBuffer(weightsBuffer);
365
391
  }
366
-
367
- return outputTensor.buffer;
368
392
  }
369
393
 
370
394
  function inferBufferDtype(buffer, expectedElements) {