@simulatte/doppler 0.1.6 → 0.1.8

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 (355) hide show
  1. package/CHANGELOG.md +145 -0
  2. package/README.md +16 -23
  3. package/package.json +30 -32
  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 +31 -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 +5 -20
  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.d.ts +5 -0
  29. package/src/config/kernel-path-loader.js +18 -36
  30. package/src/config/kernels/kernel-ref-digests.js +1 -1
  31. package/src/config/kernels/registry.js +14 -1
  32. package/src/config/kernels/registry.json +81 -5
  33. package/src/config/loader.d.ts +1 -1
  34. package/src/config/loader.js +15 -2
  35. package/src/config/merge-contract-check.js +66 -4
  36. package/src/config/merge-helpers.js +128 -7
  37. package/src/config/merge.d.ts +1 -0
  38. package/src/config/merge.js +10 -0
  39. package/src/config/param-validator.js +47 -2
  40. package/src/config/presets/kernel-paths/{gemma2-q4k-dequant-f32a.json → gemma2-q4k-dequant-f32a-nosubgroups.json} +3 -3
  41. package/src/config/presets/kernel-paths/gemma3-f16-fused-f32a-online-streamingprefill.json +223 -0
  42. package/src/config/presets/kernel-paths/{gemma3-q4k-dequant-f32a.json → gemma3-q4k-dequant-f32a-nosubgroups.json} +3 -3
  43. package/src/config/presets/kernel-paths/gemma3-q4k-dequant-f32w-f32a-online.json +56 -0
  44. package/src/config/presets/kernel-paths/lfm2-q4k-dequant-f32a-nosubgroups.json +61 -0
  45. package/src/config/presets/kernel-paths/registry.json +43 -8
  46. package/src/config/presets/models/gemma2.json +3 -2
  47. package/src/config/presets/models/gemma3.json +2 -0
  48. package/src/config/presets/models/qwen3.json +4 -3
  49. package/src/config/presets/models/qwen3_5.json +16 -0
  50. package/src/config/presets/runtime/experiments/bench/gemma3-bench-q4k.json +1 -1
  51. package/src/config/presets/runtime/experiments/debug/gemma3-debug-q4k.json +1 -1
  52. package/src/config/presets/runtime/experiments/verify/gemma3-verify.json +1 -1
  53. package/src/config/presets/runtime/kernels/dequant-f16-q4k.json +6 -13
  54. package/src/config/presets/runtime/kernels/dequant-f32-q4k.json +6 -13
  55. package/src/config/presets/runtime/kernels/embeddinggemma-q4k-dequant-f32a.json +37 -0
  56. package/src/config/presets/runtime/kernels/fused-q4k.json +6 -13
  57. package/src/config/presets/runtime/kernels/gemma2-q4k-dequant-f16a.json +33 -0
  58. package/src/config/presets/runtime/kernels/gemma2-q4k-dequant-f32a-nosubgroups.json +33 -0
  59. package/src/config/presets/runtime/kernels/gemma2-q4k-fused-f32a.json +33 -0
  60. package/src/config/presets/runtime/kernels/safe-q4k.json +6 -13
  61. package/src/config/presets/runtime/model/qwen3-5-layer-probe.json +52 -0
  62. package/src/config/presets/runtime/model/qwen3-5-linear-attn-debug.json +90 -0
  63. package/src/config/presets/runtime/platform/metal-apple-q4k.json +1 -1
  64. package/src/config/runtime.js +6 -1
  65. package/src/config/schema/conversion.schema.d.ts +1 -0
  66. package/src/config/schema/debug.schema.d.ts +5 -0
  67. package/src/config/schema/doppler.schema.js +16 -21
  68. package/src/config/schema/inference-defaults.schema.js +3 -3
  69. package/src/config/schema/kernel-path.schema.d.ts +5 -1
  70. package/src/config/schema/kernel-thresholds.schema.js +12 -4
  71. package/src/config/schema/manifest.schema.d.ts +3 -2
  72. package/src/config/schema/manifest.schema.js +17 -4
  73. package/src/config/schema/storage.schema.js +1 -1
  74. package/src/config/training-defaults.js +30 -22
  75. package/src/converter/conversion-plan.js +104 -11
  76. package/src/converter/core.d.ts +7 -0
  77. package/src/converter/core.js +16 -9
  78. package/src/converter/execution-v0-manifest.js +4 -1
  79. package/src/converter/index.d.ts +1 -0
  80. package/src/converter/index.js +1 -0
  81. package/src/converter/manifest-inference.js +50 -29
  82. package/src/converter/parsers/diffusion.js +0 -3
  83. package/src/converter/parsers/transformer.js +4 -0
  84. package/src/converter/quantization-info.js +40 -16
  85. package/src/converter/quantizer.js +19 -12
  86. package/src/converter/rope-config.js +8 -6
  87. package/src/converter/shard-packer.d.ts +1 -1
  88. package/src/converter/shard-packer.js +4 -1
  89. package/src/converter/tokenizer-utils.d.ts +1 -0
  90. package/src/converter/tokenizer-utils.js +4 -1
  91. package/src/debug/config.js +123 -11
  92. package/src/debug/reference/hf_qwen35_linear_attn_debug.py +268 -0
  93. package/src/debug/signals.js +7 -1
  94. package/src/debug/tensor.d.ts +2 -0
  95. package/src/debug/tensor.js +13 -2
  96. package/src/distribution/p2p-control-plane.js +52 -12
  97. package/src/distribution/p2p-observability.js +43 -7
  98. package/src/distribution/p2p-webrtc-browser.js +20 -0
  99. package/src/distribution/shard-delivery.js +83 -27
  100. package/src/formats/gguf/types.js +33 -16
  101. package/src/formats/rdrr/groups.d.ts +12 -4
  102. package/src/formats/rdrr/groups.js +3 -6
  103. package/src/formats/rdrr/parsing.d.ts +4 -0
  104. package/src/formats/rdrr/parsing.js +53 -3
  105. package/src/formats/rdrr/types.d.ts +2 -1
  106. package/src/gpu/command-recorder.js +86 -61
  107. package/src/gpu/device.d.ts +1 -0
  108. package/src/gpu/device.js +73 -19
  109. package/src/gpu/kernel-tuner/benchmarks.js +326 -316
  110. package/src/gpu/kernel-tuner/cache.js +71 -4
  111. package/src/gpu/kernel-tuner/tuner.js +22 -4
  112. package/src/gpu/kernels/attention.js +15 -34
  113. package/src/gpu/kernels/backward/adam.js +62 -58
  114. package/src/gpu/kernels/backward/attention_backward.js +257 -169
  115. package/src/gpu/kernels/backward/conv2d_backward.js +14 -1
  116. package/src/gpu/kernels/cast.js +191 -149
  117. package/src/gpu/kernels/check-stop.js +33 -44
  118. package/src/gpu/kernels/conv2d.js +27 -17
  119. package/src/gpu/kernels/cross_entropy_loss.js +21 -15
  120. package/src/gpu/kernels/depthwise_conv2d.js +36 -26
  121. package/src/gpu/kernels/dequant.js +178 -126
  122. package/src/gpu/kernels/energy.d.ts +3 -21
  123. package/src/gpu/kernels/energy.js +111 -88
  124. package/src/gpu/kernels/feature-check.js +1 -1
  125. package/src/gpu/kernels/fused_ffn.js +84 -65
  126. package/src/gpu/kernels/fused_matmul_residual.js +56 -33
  127. package/src/gpu/kernels/fused_matmul_rmsnorm.js +62 -45
  128. package/src/gpu/kernels/gather.js +33 -15
  129. package/src/gpu/kernels/gelu.js +19 -11
  130. package/src/gpu/kernels/grouped_pointwise_conv2d.js +33 -23
  131. package/src/gpu/kernels/groupnorm.js +34 -23
  132. package/src/gpu/kernels/index.d.ts +8 -0
  133. package/src/gpu/kernels/index.js +6 -0
  134. package/src/gpu/kernels/kv-quantize.js +5 -2
  135. package/src/gpu/kernels/layernorm.js +35 -19
  136. package/src/gpu/kernels/logit-merge.js +5 -3
  137. package/src/gpu/kernels/matmul-selection.js +47 -4
  138. package/src/gpu/kernels/matmul.d.ts +2 -0
  139. package/src/gpu/kernels/matmul.js +59 -40
  140. package/src/gpu/kernels/modulate.js +23 -15
  141. package/src/gpu/kernels/moe.js +221 -175
  142. package/src/gpu/kernels/pixel_shuffle.js +22 -14
  143. package/src/gpu/kernels/relu.js +18 -10
  144. package/src/gpu/kernels/repeat_channels.js +25 -17
  145. package/src/gpu/kernels/residual.js +37 -27
  146. package/src/gpu/kernels/rmsnorm.js +66 -43
  147. package/src/gpu/kernels/rope.js +3 -0
  148. package/src/gpu/kernels/sample.js +27 -38
  149. package/src/gpu/kernels/sana_linear_attention.js +18 -10
  150. package/src/gpu/kernels/scale.js +18 -11
  151. package/src/gpu/kernels/shader-cache.js +4 -2
  152. package/src/gpu/kernels/silu.js +120 -72
  153. package/src/gpu/kernels/softmax.js +44 -25
  154. package/src/gpu/kernels/split_qg.d.ts +50 -0
  155. package/src/gpu/kernels/split_qg.js +46 -0
  156. package/src/gpu/kernels/split_qg.wgsl +58 -0
  157. package/src/gpu/kernels/split_qg_f16.wgsl +62 -0
  158. package/src/gpu/kernels/split_qkv.js +23 -13
  159. package/src/gpu/kernels/transpose.js +18 -10
  160. package/src/gpu/kernels/transpose.wgsl +5 -3
  161. package/src/gpu/kernels/upsample2d.js +21 -13
  162. package/src/gpu/kernels/utils.js +20 -13
  163. package/src/gpu/partitioned-buffer-pool.js +10 -2
  164. package/src/gpu/perf-guards.js +2 -9
  165. package/src/gpu/profiler.js +27 -22
  166. package/src/gpu/readback-utils.d.ts +16 -0
  167. package/src/gpu/readback-utils.js +41 -0
  168. package/src/gpu/submit-tracker.js +13 -0
  169. package/src/gpu/uniform-cache.d.ts +1 -0
  170. package/src/gpu/uniform-cache.js +30 -9
  171. package/src/gpu/weight-buffer.d.ts +1 -1
  172. package/src/gpu/weight-buffer.js +1 -1
  173. package/src/hotswap/intent-bundle.js +6 -0
  174. package/src/hotswap/manifest.d.ts +10 -1
  175. package/src/hotswap/manifest.js +12 -2
  176. package/src/hotswap/runtime.js +30 -8
  177. package/src/index-browser.d.ts +44 -0
  178. package/src/index-browser.js +14 -0
  179. package/src/inference/browser-harness-contract-helpers.d.ts +5 -0
  180. package/src/inference/browser-harness-contract-helpers.js +28 -0
  181. package/src/inference/browser-harness-diffusion-energy-suites.d.ts +2 -0
  182. package/src/inference/browser-harness-diffusion-energy-suites.js +269 -0
  183. package/src/inference/browser-harness-model-helpers.d.ts +16 -0
  184. package/src/inference/browser-harness-model-helpers.js +217 -0
  185. package/src/inference/browser-harness-report-helpers.d.ts +7 -0
  186. package/src/inference/browser-harness-report-helpers.js +42 -0
  187. package/src/inference/browser-harness-runtime-helpers.d.ts +61 -0
  188. package/src/inference/browser-harness-runtime-helpers.js +415 -0
  189. package/src/inference/browser-harness-suite-helpers.d.ts +28 -0
  190. package/src/inference/browser-harness-suite-helpers.js +268 -0
  191. package/src/inference/browser-harness-text-helpers.d.ts +27 -0
  192. package/src/inference/browser-harness-text-helpers.js +788 -0
  193. package/src/inference/browser-harness.d.ts +8 -0
  194. package/src/inference/browser-harness.js +149 -1996
  195. package/src/inference/kv-cache/base.js +140 -94
  196. package/src/inference/kv-cache/tiered.js +5 -3
  197. package/src/inference/moe-router.js +88 -56
  198. package/src/inference/multi-model-network.js +5 -3
  199. package/src/inference/network-evolution.d.ts +11 -2
  200. package/src/inference/network-evolution.js +20 -21
  201. package/src/inference/pipelines/context.d.ts +3 -0
  202. package/src/inference/pipelines/context.js +142 -2
  203. package/src/inference/pipelines/diffusion/helpers.js +10 -2
  204. package/src/inference/pipelines/diffusion/pipeline.js +2 -1
  205. package/src/inference/pipelines/diffusion/sd3-transformer.js +10 -10
  206. package/src/inference/pipelines/diffusion/text-encoder-gpu.js +8 -2
  207. package/src/inference/pipelines/diffusion/vae.js +3 -7
  208. package/src/inference/pipelines/energy/pipeline.js +27 -21
  209. package/src/inference/pipelines/energy/quintel.d.ts +5 -0
  210. package/src/inference/pipelines/energy/quintel.js +11 -0
  211. package/src/inference/pipelines/energy-head/row-head-pipeline.js +17 -13
  212. package/src/inference/pipelines/structured/json-head-pipeline.js +26 -11
  213. package/src/inference/pipelines/text/attention/output-projection.d.ts +12 -0
  214. package/src/inference/pipelines/text/attention/output-projection.js +8 -0
  215. package/src/inference/pipelines/text/attention/projections.d.ts +10 -1
  216. package/src/inference/pipelines/text/attention/projections.js +192 -112
  217. package/src/inference/pipelines/text/attention/record.js +77 -14
  218. package/src/inference/pipelines/text/attention/run.js +112 -14
  219. package/src/inference/pipelines/text/config.js +17 -4
  220. package/src/inference/pipelines/text/embed.js +2 -8
  221. package/src/inference/pipelines/text/execution-plan.js +46 -23
  222. package/src/inference/pipelines/text/execution-v0-contract-helpers.d.ts +59 -0
  223. package/src/inference/pipelines/text/execution-v0-contract-helpers.js +937 -0
  224. package/src/inference/pipelines/text/execution-v0-runtime-builders.d.ts +15 -0
  225. package/src/inference/pipelines/text/execution-v0-runtime-builders.js +279 -0
  226. package/src/inference/pipelines/text/execution-v0.js +62 -1013
  227. package/src/inference/pipelines/text/generator-runtime.js +5 -0
  228. package/src/inference/pipelines/text/generator-steps.d.ts +52 -0
  229. package/src/inference/pipelines/text/generator-steps.js +340 -221
  230. package/src/inference/pipelines/text/generator.js +56 -40
  231. package/src/inference/pipelines/text/init.d.ts +13 -0
  232. package/src/inference/pipelines/text/init.js +94 -25
  233. package/src/inference/pipelines/text/kernel-path-auto-select.js +2 -0
  234. package/src/inference/pipelines/text/kernel-trace.d.ts +2 -0
  235. package/src/inference/pipelines/text/kernel-trace.js +6 -0
  236. package/src/inference/pipelines/text/layer.js +4 -9
  237. package/src/inference/pipelines/text/linear-attention.d.ts +15 -0
  238. package/src/inference/pipelines/text/linear-attention.js +113 -9
  239. package/src/inference/pipelines/text/logits/gpu.js +12 -7
  240. package/src/inference/pipelines/text/logits/index.d.ts +6 -1
  241. package/src/inference/pipelines/text/logits/index.js +13 -12
  242. package/src/inference/pipelines/text/logits/utils.d.ts +7 -0
  243. package/src/inference/pipelines/text/logits/utils.js +9 -0
  244. package/src/inference/pipelines/text/lora-apply.js +50 -32
  245. package/src/inference/pipelines/text/model-load.js +282 -104
  246. package/src/inference/pipelines/text/moe-cache.js +5 -4
  247. package/src/inference/pipelines/text/moe-cpu-gptoss.js +74 -69
  248. package/src/inference/pipelines/text/moe-cpu.js +42 -38
  249. package/src/inference/pipelines/text/moe-gpu.js +110 -86
  250. package/src/inference/pipelines/text/ops.js +90 -90
  251. package/src/inference/pipelines/text/probes.js +9 -9
  252. package/src/inference/pipelines/text/sampling.js +52 -6
  253. package/src/inference/pipelines/text/weights.js +17 -7
  254. package/src/inference/pipelines/text.js +13 -1
  255. package/src/inference/speculative.d.ts +2 -2
  256. package/src/inference/speculative.js +4 -18
  257. package/src/inference/test-harness.d.ts +1 -1
  258. package/src/inference/test-harness.js +17 -7
  259. package/src/inference/tokenizer.d.ts +0 -5
  260. package/src/inference/tokenizer.js +4 -23
  261. package/src/inference/tokenizers/bpe.js +9 -0
  262. package/src/inference/tokenizers/bundled.js +20 -0
  263. package/src/inference/tokenizers/sentencepiece.js +12 -0
  264. package/src/loader/doppler-loader.js +38 -22
  265. package/src/loader/dtype-utils.js +3 -44
  266. package/src/loader/embedding-loader.js +7 -3
  267. package/src/loader/experts/expert-cache.js +13 -6
  268. package/src/loader/experts/expert-loader.js +10 -6
  269. package/src/loader/final-weights-loader.js +10 -4
  270. package/src/loader/layer-loader.js +2 -1
  271. package/src/loader/loader-state.js +2 -2
  272. package/src/loader/memory-monitor.js +8 -0
  273. package/src/loader/multi-model-loader.d.ts +14 -0
  274. package/src/loader/multi-model-loader.js +70 -24
  275. package/src/loader/shard-cache.js +84 -14
  276. package/src/loader/shard-resolver.js +25 -3
  277. package/src/loader/tensors/tensor-loader.js +214 -144
  278. package/src/loader/tensors/tensor-reader.js +76 -19
  279. package/src/loader/weight-downcast.js +1 -1
  280. package/src/memory/buffer-pool.d.ts +9 -1
  281. package/src/memory/buffer-pool.js +109 -44
  282. package/src/memory/unified-detect.js +1 -1
  283. package/src/rules/inference/dtype.rules.json +5 -0
  284. package/src/rules/inference/kernel-path.rules.json +24 -8
  285. package/src/rules/kernels/split-qg.rules.json +6 -0
  286. package/src/rules/rule-registry.js +27 -1
  287. package/src/storage/backends/opfs-store.js +68 -24
  288. package/src/storage/downloader.js +365 -83
  289. package/src/storage/index.d.ts +3 -0
  290. package/src/storage/index.js +3 -0
  291. package/src/storage/preflight.d.ts +2 -2
  292. package/src/storage/preflight.js +24 -2
  293. package/src/storage/quickstart-downloader.js +11 -5
  294. package/src/storage/registry.js +10 -4
  295. package/src/storage/reports.js +1 -1
  296. package/src/storage/shard-manager.d.ts +15 -1
  297. package/src/storage/shard-manager.js +55 -6
  298. package/src/storage/source-artifact-store.d.ts +52 -0
  299. package/src/storage/source-artifact-store.js +234 -0
  300. package/src/tooling/command-api-constants.d.ts +9 -0
  301. package/src/tooling/command-api-constants.js +9 -0
  302. package/src/tooling/command-api-family-normalizers.d.ts +9 -0
  303. package/src/tooling/command-api-family-normalizers.js +343 -0
  304. package/src/tooling/command-api-helpers.d.ts +25 -0
  305. package/src/tooling/command-api-helpers.js +262 -0
  306. package/src/tooling/command-api.js +16 -602
  307. package/src/tooling/command-envelope.js +4 -1
  308. package/src/tooling/command-runner-shared.js +52 -18
  309. package/src/tooling/conversion-config-materializer.js +3 -5
  310. package/src/tooling/lean-execution-contract.js +150 -3
  311. package/src/tooling/node-browser-command-runner.js +161 -271
  312. package/src/tooling/node-command-runner.js +29 -3
  313. package/src/tooling/node-converter.js +30 -1
  314. package/src/tooling/node-source-runtime.d.ts +1 -1
  315. package/src/tooling/node-source-runtime.js +120 -3
  316. package/src/tooling/node-webgpu.js +24 -21
  317. package/src/tooling/opfs-cache.js +21 -4
  318. package/src/tooling/runtime-input-composition.d.ts +38 -0
  319. package/src/tooling/runtime-input-composition.js +86 -0
  320. package/src/tooling/source-runtime-bundle.d.ts +40 -5
  321. package/src/tooling/source-runtime-bundle.js +261 -34
  322. package/src/tooling/source-runtime-materializer.d.ts +6 -0
  323. package/src/tooling/source-runtime-materializer.js +93 -0
  324. package/src/training/attention-backward.js +32 -17
  325. package/src/training/autograd.js +80 -52
  326. package/src/training/checkpoint-watch.d.ts +2 -1
  327. package/src/training/checkpoint-watch.js +39 -6
  328. package/src/training/checkpoint.js +40 -11
  329. package/src/training/clip.js +2 -1
  330. package/src/training/datasets/token-batch.js +20 -8
  331. package/src/training/distillation/checkpoint-watch.js +1 -0
  332. package/src/training/distillation/student-fixture.d.ts +22 -0
  333. package/src/training/distillation/student-fixture.js +846 -0
  334. package/src/training/distillation/suite-data.d.ts +45 -0
  335. package/src/training/distillation/suite-data.js +189 -0
  336. package/src/training/lora-pipeline.js +4 -7
  337. package/src/training/lora.js +26 -12
  338. package/src/training/loss.js +5 -6
  339. package/src/training/objectives/cross_entropy.js +2 -5
  340. package/src/training/objectives/distill_kd.js +4 -8
  341. package/src/training/objectives/distill_triplet.js +4 -8
  342. package/src/training/objectives/ul_stage2_base.js +4 -8
  343. package/src/training/operator-command.js +2 -0
  344. package/src/training/optimizer.js +19 -7
  345. package/src/training/runner.js +2 -1
  346. package/src/training/suite.js +18 -978
  347. package/src/training/tensor-factory.d.ts +9 -0
  348. package/src/training/tensor-factory.js +13 -0
  349. package/src/training/trainer.js +3 -5
  350. package/src/training/ul_dataset.js +3 -5
  351. package/src/training/workloads.js +70 -79
  352. package/src/types/model.d.ts +5 -0
  353. package/src/version.js +1 -1
  354. package/tools/convert-safetensors-node.js +22 -16
  355. package/tools/doppler-cli.js +50 -26
@@ -1,4 +1,4 @@
1
- import { getDevice } from '../device.js';
1
+ import { getDevice, getKernelCapabilities } from '../device.js';
2
2
  import { createTensor } from '../tensor.js';
3
3
  import { getBuffer, getLayout, getWeightDtype } from '../weight-buffer.js';
4
4
  import { log, trace, isTraceEnabled } from '../../debug/index.js';
@@ -110,6 +110,7 @@ async function executeMatmul(recorder, A, B, M, N, K, options = {}) {
110
110
  const mode = isRecord ? 'record' : 'run';
111
111
  const opLabel = isRecord ? 'recordMatmul' : 'runMatmul';
112
112
  const device = recorder?.device || getDevice();
113
+ const capabilities = getKernelCapabilities();
113
114
 
114
115
  const {
115
116
  alpha = 1.0,
@@ -139,6 +140,13 @@ async function executeMatmul(recorder, A, B, M, N, K, options = {}) {
139
140
  const bDtype = toMatmulDtype(weightDtype ?? options.bDtype);
140
141
  const requestedOutputDtype = options.outputDtype || A.dtype;
141
142
 
143
+ if (bDtype === 'f16' && capabilities?.hasF16 !== true) {
144
+ throw new Error(`[${opLabel}] f16 weights require shader-f16 support.`);
145
+ }
146
+ if (requestedOutputDtype === 'f16' && capabilities?.hasF16 !== true) {
147
+ throw new Error(`[${opLabel}] f16 output requires shader-f16 support.`);
148
+ }
149
+
142
150
  if (!isRecord && isTraceEnabled('kernels') && !weightDtype && !options.bDtype && M <= 2) {
143
151
  log.warn('Matmul', `runMatmul: B buffer dtype unknown! size=${bBuffer.size}, M=${M}, N=${N}, K=${K}. Assuming f32.`);
144
152
  }
@@ -157,7 +165,7 @@ async function executeMatmul(recorder, A, B, M, N, K, options = {}) {
157
165
  options
158
166
  );
159
167
 
160
- const phase = resolveMatmulPhase(M);
168
+ const phase = resolveMatmulPhase(M, options.phaseOverride ?? null);
161
169
  const constants = resolveMatmulConstants(options, phase);
162
170
 
163
171
  let matmulInput = A;
@@ -228,6 +236,7 @@ async function executeMatmul(recorder, A, B, M, N, K, options = {}) {
228
236
  N,
229
237
  outputBuffer
230
238
  );
239
+ const ownsOutput = outputBuffer == null;
231
240
 
232
241
  if (!Number.isFinite(outputSize) || outputSize <= 0) {
233
242
  throw new Error(`[${opLabel}] Invalid output size: ${outputSize} (M=${M}, N=${N})`);
@@ -239,50 +248,60 @@ async function executeMatmul(recorder, A, B, M, N, K, options = {}) {
239
248
  }
240
249
 
241
250
  const dispatchPlan = calculateMatmulDispatch(variant, useQ4KFused, useGemv, M, N, config);
242
- const uniformBuffer = createMatmulUniformBuffer(
243
- 'matmul_uniforms',
244
- M,
245
- N,
246
- K,
247
- alpha,
248
- useQ4KFused,
249
- transposeB,
250
- dispatchPlan.uniformWorkgroupsX,
251
- recorder || null,
252
- device
253
- );
251
+ let uniformBuffer = null;
252
+ let completed = false;
253
+ try {
254
+ uniformBuffer = createMatmulUniformBuffer(
255
+ 'matmul_uniforms',
256
+ M,
257
+ N,
258
+ K,
259
+ alpha,
260
+ useQ4KFused,
261
+ transposeB,
262
+ dispatchPlan.uniformWorkgroupsX,
263
+ recorder || null,
264
+ device
265
+ );
254
266
 
255
- const entries = createMatmulBindGroupEntries(
256
- variant,
257
- uniformBuffer,
258
- matmulInput,
259
- bBuffer,
260
- C,
261
- { aOffset, bOffset, cOffset },
262
- {
263
- aBindingSize: bindingSizes.aBindingSize,
264
- bBindingSize: bindingSizes.bBindingSize,
265
- cBindingSize,
266
- }
267
- );
267
+ const entries = createMatmulBindGroupEntries(
268
+ variant,
269
+ uniformBuffer,
270
+ matmulInput,
271
+ bBuffer,
272
+ C,
273
+ { aOffset, bOffset, cOffset },
274
+ {
275
+ aBindingSize: bindingSizes.aBindingSize,
276
+ bBindingSize: bindingSizes.bBindingSize,
277
+ cBindingSize,
278
+ }
279
+ );
268
280
 
269
- const bindGroup = device.createBindGroup({
270
- label: 'matmul_bind_group',
271
- layout: pipeline.getBindGroupLayout(0),
272
- entries,
273
- });
281
+ const bindGroup = device.createBindGroup({
282
+ label: 'matmul_bind_group',
283
+ layout: pipeline.getBindGroupLayout(0),
284
+ entries,
285
+ });
274
286
 
275
- if (isRecord) {
276
- kernel.record(recorder, pipeline, bindGroup, dispatchPlan.workgroups, buildProfileLabel(options));
277
- } else {
278
- kernel.dispatch(pipeline, bindGroup, dispatchPlan.workgroups);
279
- releaseUniformBuffer(uniformBuffer);
280
- if (castedInput) {
287
+ if (isRecord) {
288
+ kernel.record(recorder, pipeline, bindGroup, dispatchPlan.workgroups, buildProfileLabel(options));
289
+ } else {
290
+ kernel.dispatch(pipeline, bindGroup, dispatchPlan.workgroups);
291
+ }
292
+ completed = true;
293
+ return createTensor(C, actualOutputDtype, [M, N], 'matmul_output');
294
+ } finally {
295
+ if (!isRecord && uniformBuffer) {
296
+ releaseUniformBuffer(uniformBuffer);
297
+ }
298
+ if (!isRecord && castedInput) {
281
299
  releaseBuffer(castedInput.buffer);
282
300
  }
301
+ if (!completed && ownsOutput) {
302
+ releaseBuffer(C);
303
+ }
283
304
  }
284
-
285
- return createTensor(C, actualOutputDtype, [M, N], 'matmul_output');
286
305
  }
287
306
 
288
307
 
@@ -1,4 +1,4 @@
1
- import { acquireBuffer } from '../../memory/buffer-pool.js';
1
+ import { acquireBuffer, releaseBuffer } from '../../memory/buffer-pool.js';
2
2
  import { createTensor, dtypeBytes } from '../tensor.js';
3
3
  import { unifiedKernelWrapper } from './utils.js';
4
4
  import { selectRuleValue } from './rule-registry.js';
@@ -24,20 +24,28 @@ async function _modulate(target, input, mod, options = {}) {
24
24
  const bytesPerElement = dtypeBytes(input.dtype);
25
25
  const outputSize = numTokens * hiddenSize * bytesPerElement;
26
26
  const output = outputBuffer || acquireBuffer(outputSize, undefined, 'modulate_output');
27
-
28
- await unifiedKernelWrapper(
29
- 'modulate', target, variant,
30
- [input, mod, output],
31
- {
32
- num_tokens: numTokens, hidden_size: hiddenSize,
33
- scale_offset: scaleOffset, shift_offset: shiftOffset,
34
- gate_offset: gateOffset, has_gate: hasGate ? 1 : 0,
35
- add_one: addOne ? 1 : 0, _pad0: 0,
36
- },
37
- Math.ceil((numTokens * hiddenSize) / WORKGROUP_SIZES.DEFAULT)
38
- );
39
-
40
- return createTensor(output, input.dtype, [numTokens, hiddenSize], 'modulate_output');
27
+ const ownedOutput = outputBuffer ? null : output;
28
+
29
+ try {
30
+ await unifiedKernelWrapper(
31
+ 'modulate', target, variant,
32
+ [input, mod, output],
33
+ {
34
+ num_tokens: numTokens, hidden_size: hiddenSize,
35
+ scale_offset: scaleOffset, shift_offset: shiftOffset,
36
+ gate_offset: gateOffset, has_gate: hasGate ? 1 : 0,
37
+ add_one: addOne ? 1 : 0, _pad0: 0,
38
+ },
39
+ Math.ceil((numTokens * hiddenSize) / WORKGROUP_SIZES.DEFAULT)
40
+ );
41
+
42
+ return createTensor(output, input.dtype, [numTokens, hiddenSize], 'modulate_output');
43
+ } catch (error) {
44
+ if (ownedOutput) {
45
+ releaseBuffer(ownedOutput);
46
+ }
47
+ throw error;
48
+ }
41
49
  }
42
50
 
43
51
  export async function runModulate(input, mod, options = {}) {
@@ -1,7 +1,7 @@
1
1
 
2
2
 
3
3
  import { getDevice, getDeviceEpoch } from '../device.js';
4
- import { acquireBuffer } from '../../memory/buffer-pool.js';
4
+ import { acquireBuffer, releaseBuffer } from '../../memory/buffer-pool.js';
5
5
  import { createTensor } from '../tensor.js';
6
6
  import { WORKGROUP_SIZES, GPU_LIMITS } from './constants.js';
7
7
  import { dispatch, recordDispatch } from './dispatch.js';
@@ -61,6 +61,15 @@ function releaseUniformBuffer(execution, uniformBuffer) {
61
61
  }
62
62
  }
63
63
 
64
+ function releaseTemporaryBuffer(execution, buffer) {
65
+ if (!buffer) return;
66
+ if (execution.recorder) {
67
+ execution.recorder.trackTemporaryBuffer(buffer);
68
+ } else {
69
+ releaseBuffer(buffer);
70
+ }
71
+ }
72
+
64
73
  async function executeTopK(recorder, probs, numTokens, numExperts, topK, options = {}) {
65
74
  const execution = resolveExecution(recorder);
66
75
  const { normalize = true } = options;
@@ -79,21 +88,26 @@ async function executeTopK(recorder, probs, numTokens, numExperts, topK, options
79
88
  view.setUint32(12, normalize ? 1 : 0, true);
80
89
  });
81
90
 
82
- const bindGroup = execution.device.createBindGroup({
83
- label: 'topk_bind_group',
84
- layout: pipeline.getBindGroupLayout(0),
85
- entries: [
86
- { binding: 0, resource: { buffer: uniformBuffer } },
87
- { binding: 1, resource: { buffer: probs } },
88
- { binding: 2, resource: { buffer: indices } },
89
- { binding: 3, resource: { buffer: weights } },
90
- ],
91
- });
92
-
93
- dispatchTopK(execution, pipeline, bindGroup, numTokens);
94
- releaseUniformBuffer(execution, uniformBuffer);
95
-
96
- return { indices, weights };
91
+ try {
92
+ const bindGroup = execution.device.createBindGroup({
93
+ label: 'topk_bind_group',
94
+ layout: pipeline.getBindGroupLayout(0),
95
+ entries: [
96
+ { binding: 0, resource: { buffer: uniformBuffer } },
97
+ { binding: 1, resource: { buffer: probs } },
98
+ { binding: 2, resource: { buffer: indices } },
99
+ { binding: 3, resource: { buffer: weights } },
100
+ ],
101
+ });
102
+ dispatchTopK(execution, pipeline, bindGroup, numTokens);
103
+ return { indices, weights };
104
+ } catch (error) {
105
+ releaseTemporaryBuffer(execution, indices);
106
+ releaseTemporaryBuffer(execution, weights);
107
+ throw error;
108
+ } finally {
109
+ releaseUniformBuffer(execution, uniformBuffer);
110
+ }
97
111
  }
98
112
 
99
113
  export async function runTopK(probs, numTokens, numExperts, topK, options = {}) {
@@ -225,65 +239,72 @@ async function executeMoEGather(recorder, hiddenStates, expertIndices, numTokens
225
239
  view.setUint32(28, 0, true);
226
240
  });
227
241
 
228
- const bindGroup = await createBindGroupWithValidation(execution.device, {
229
- label: 'moe_gather_bind_group',
230
- layout: explicitLayout,
231
- entries: [
232
- { binding: 0, resource: { buffer: uniformBuffer } },
233
- { binding: 1, resource: { buffer: hiddenStates.buffer } },
234
- { binding: 2, resource: { buffer: expertIndices } },
235
- { binding: 3, resource: { buffer: gatheredBuffer } },
236
- { binding: 4, resource: { buffer: tokenCounts } },
237
- { binding: 5, resource: { buffer: tokenMap } },
238
- ],
239
- }, `moe_gather:${dtypeLabel}`);
240
-
241
- const countWorkgroups = Math.ceil((numTokens * topK) / WORKGROUP_SIZES.DEFAULT);
242
-
243
- if (execution.recorder) {
244
- const encoder = execution.recorder.getEncoder();
245
- encoder.clearBuffer(tokenCounts);
246
-
247
- const countPass = execution.recorder.beginComputePass('moe_gather_count');
248
- countPass.setPipeline(countPipeline);
249
- countPass.setBindGroup(0, bindGroup);
250
- countPass.dispatchWorkgroups(countWorkgroups);
251
- countPass.end();
252
-
253
- const gatherPass = execution.recorder.beginComputePass('moe_gather_gather');
254
- gatherPass.setPipeline(gatherPipeline);
255
- gatherPass.setBindGroup(0, bindGroup);
256
- gatherPass.dispatchWorkgroups(gatherDispatch.x, gatherDispatch.y, 1);
257
- gatherPass.end();
258
- } else {
259
- const encoder = execution.device.createCommandEncoder({ label: 'moe_gather_encoder' });
260
- encoder.clearBuffer(tokenCounts);
261
-
262
- const countPass = encoder.beginComputePass({ label: 'moe_gather_count_pass' });
263
- countPass.setPipeline(countPipeline);
264
- countPass.setBindGroup(0, bindGroup);
265
- countPass.dispatchWorkgroups(countWorkgroups);
266
- countPass.end();
267
-
268
- const gatherPass = encoder.beginComputePass({ label: 'moe_gather_gather_pass' });
269
- gatherPass.setPipeline(gatherPipeline);
270
- gatherPass.setBindGroup(0, bindGroup);
271
- gatherPass.dispatchWorkgroups(gatherDispatch.x, gatherDispatch.y, 1);
272
- gatherPass.end();
273
-
274
- execution.device.queue.submit([encoder.finish()]);
242
+ try {
243
+ const bindGroup = await createBindGroupWithValidation(execution.device, {
244
+ label: 'moe_gather_bind_group',
245
+ layout: explicitLayout,
246
+ entries: [
247
+ { binding: 0, resource: { buffer: uniformBuffer } },
248
+ { binding: 1, resource: { buffer: hiddenStates.buffer } },
249
+ { binding: 2, resource: { buffer: expertIndices } },
250
+ { binding: 3, resource: { buffer: gatheredBuffer } },
251
+ { binding: 4, resource: { buffer: tokenCounts } },
252
+ { binding: 5, resource: { buffer: tokenMap } },
253
+ ],
254
+ }, `moe_gather:${dtypeLabel}`);
255
+
256
+ const countWorkgroups = Math.ceil((numTokens * topK) / WORKGROUP_SIZES.DEFAULT);
257
+
258
+ if (execution.recorder) {
259
+ const encoder = execution.recorder.getEncoder();
260
+ encoder.clearBuffer(tokenCounts);
261
+
262
+ const countPass = execution.recorder.beginComputePass('moe_gather_count');
263
+ countPass.setPipeline(countPipeline);
264
+ countPass.setBindGroup(0, bindGroup);
265
+ countPass.dispatchWorkgroups(countWorkgroups);
266
+ countPass.end();
267
+
268
+ const gatherPass = execution.recorder.beginComputePass('moe_gather_gather');
269
+ gatherPass.setPipeline(gatherPipeline);
270
+ gatherPass.setBindGroup(0, bindGroup);
271
+ gatherPass.dispatchWorkgroups(gatherDispatch.x, gatherDispatch.y, 1);
272
+ gatherPass.end();
273
+ } else {
274
+ const encoder = execution.device.createCommandEncoder({ label: 'moe_gather_encoder' });
275
+ encoder.clearBuffer(tokenCounts);
276
+
277
+ const countPass = encoder.beginComputePass({ label: 'moe_gather_count_pass' });
278
+ countPass.setPipeline(countPipeline);
279
+ countPass.setBindGroup(0, bindGroup);
280
+ countPass.dispatchWorkgroups(countWorkgroups);
281
+ countPass.end();
282
+
283
+ const gatherPass = encoder.beginComputePass({ label: 'moe_gather_gather_pass' });
284
+ gatherPass.setPipeline(gatherPipeline);
285
+ gatherPass.setBindGroup(0, bindGroup);
286
+ gatherPass.dispatchWorkgroups(gatherDispatch.x, gatherDispatch.y, 1);
287
+ gatherPass.end();
288
+
289
+ execution.device.queue.submit([encoder.finish()]);
290
+ }
291
+
292
+ const gathered = createTensor(
293
+ gatheredBuffer,
294
+ hiddenStates.dtype,
295
+ [numExperts, maxTokensPerExpert, hiddenSize],
296
+ 'moe_gathered'
297
+ );
298
+
299
+ return { gathered, tokenCounts, tokenMap, maxTokensPerExpert };
300
+ } catch (error) {
301
+ releaseTemporaryBuffer(execution, gatheredBuffer);
302
+ releaseTemporaryBuffer(execution, tokenCounts);
303
+ releaseTemporaryBuffer(execution, tokenMap);
304
+ throw error;
305
+ } finally {
306
+ releaseUniformBuffer(execution, uniformBuffer);
275
307
  }
276
-
277
- releaseUniformBuffer(execution, uniformBuffer);
278
-
279
- const gathered = createTensor(
280
- gatheredBuffer,
281
- hiddenStates.dtype,
282
- [numExperts, maxTokensPerExpert, hiddenSize],
283
- 'moe_gathered'
284
- );
285
-
286
- return { gathered, tokenCounts, tokenMap, maxTokensPerExpert };
287
308
  }
288
309
 
289
310
  export async function runMoEGather(hiddenStates, expertIndices, numTokens, hiddenSize, numExperts, topK, options = {}) {
@@ -298,6 +319,7 @@ export async function recordMoEGather(recorder, hiddenStates, expertIndices, num
298
319
  async function executeScatterAdd(recorder, expertOutputs, indices, weights, numTokens, hiddenSize, numExperts, topK, options = {}) {
299
320
  const execution = resolveExecution(recorder);
300
321
  const { outputBuffer = null } = options;
322
+ const ownsOutput = outputBuffer == null;
301
323
 
302
324
  const pipeline = await createPipeline('scatter_add', 'default');
303
325
 
@@ -312,42 +334,49 @@ async function executeScatterAdd(recorder, expertOutputs, indices, weights, numT
312
334
  view.setUint32(12, numExperts, true);
313
335
  });
314
336
 
315
- const bindGroup = execution.device.createBindGroup({
316
- label: 'scatter_add_bind_group',
317
- layout: pipeline.getBindGroupLayout(0),
318
- entries: [
319
- { binding: 0, resource: { buffer: uniformBuffer } },
320
- { binding: 1, resource: { buffer: expertOutputs.buffer } },
321
- { binding: 2, resource: { buffer: indices } },
322
- { binding: 3, resource: { buffer: weights } },
323
- { binding: 4, resource: { buffer: outputBuf } },
324
- ],
325
- });
326
-
327
- const workgroups = Math.ceil((numTokens * hiddenSize) / WORKGROUP_SIZES.DEFAULT);
328
-
329
- if (execution.recorder) {
330
- execution.recorder.getEncoder().clearBuffer(outputBuf);
337
+ try {
338
+ const bindGroup = execution.device.createBindGroup({
339
+ label: 'scatter_add_bind_group',
340
+ layout: pipeline.getBindGroupLayout(0),
341
+ entries: [
342
+ { binding: 0, resource: { buffer: uniformBuffer } },
343
+ { binding: 1, resource: { buffer: expertOutputs.buffer } },
344
+ { binding: 2, resource: { buffer: indices } },
345
+ { binding: 3, resource: { buffer: weights } },
346
+ { binding: 4, resource: { buffer: outputBuf } },
347
+ ],
348
+ });
331
349
 
332
- const pass = execution.recorder.beginComputePass('scatter_add');
333
- pass.setPipeline(pipeline);
334
- pass.setBindGroup(0, bindGroup);
335
- pass.dispatchWorkgroups(workgroups);
336
- pass.end();
337
- } else {
338
- const encoder = execution.device.createCommandEncoder({ label: 'scatter_add_encoder' });
339
- encoder.clearBuffer(outputBuf);
340
- const pass = encoder.beginComputePass({ label: 'scatter_add_pass' });
341
- pass.setPipeline(pipeline);
342
- pass.setBindGroup(0, bindGroup);
343
- pass.dispatchWorkgroups(workgroups);
344
- pass.end();
345
- execution.device.queue.submit([encoder.finish()]);
350
+ const workgroups = Math.ceil((numTokens * hiddenSize) / WORKGROUP_SIZES.DEFAULT);
351
+
352
+ if (execution.recorder) {
353
+ execution.recorder.getEncoder().clearBuffer(outputBuf);
354
+
355
+ const pass = execution.recorder.beginComputePass('scatter_add');
356
+ pass.setPipeline(pipeline);
357
+ pass.setBindGroup(0, bindGroup);
358
+ pass.dispatchWorkgroups(workgroups);
359
+ pass.end();
360
+ } else {
361
+ const encoder = execution.device.createCommandEncoder({ label: 'scatter_add_encoder' });
362
+ encoder.clearBuffer(outputBuf);
363
+ const pass = encoder.beginComputePass({ label: 'scatter_add_pass' });
364
+ pass.setPipeline(pipeline);
365
+ pass.setBindGroup(0, bindGroup);
366
+ pass.dispatchWorkgroups(workgroups);
367
+ pass.end();
368
+ execution.device.queue.submit([encoder.finish()]);
369
+ }
370
+
371
+ return createTensor(outputBuf, expertOutputs.dtype, [numTokens, hiddenSize], 'scatter_add_output');
372
+ } catch (error) {
373
+ if (ownsOutput) {
374
+ releaseTemporaryBuffer(execution, outputBuf);
375
+ }
376
+ throw error;
377
+ } finally {
378
+ releaseUniformBuffer(execution, uniformBuffer);
346
379
  }
347
-
348
- releaseUniformBuffer(execution, uniformBuffer);
349
-
350
- return createTensor(outputBuf, expertOutputs.dtype, [numTokens, hiddenSize], 'scatter_add_output');
351
380
  }
352
381
 
353
382
  export async function runScatterAdd(expertOutputs, indices, weights, numTokens, hiddenSize, numExperts, topK, options = {}) {
@@ -362,6 +391,7 @@ export async function recordScatterAdd(recorder, expertOutputs, indices, weights
362
391
  async function executeMoEBuildTokenOffsets(recorder, tokenCounts, tokenMap, numTokens, numExperts, topK, maxTokensPerExpert, options = {}) {
363
392
  const execution = resolveExecution(recorder);
364
393
  const { outputBuffer = null } = options;
394
+ const ownsOutput = outputBuffer == null;
365
395
 
366
396
  const explicitLayout = getMoEOffsetsBindGroupLayout(execution.device);
367
397
  const pipeline = await createPipeline('moe_offsets', 'default', explicitLayout);
@@ -380,38 +410,46 @@ async function executeMoEBuildTokenOffsets(recorder, tokenCounts, tokenMap, numT
380
410
  view.setUint32(28, 0, true);
381
411
  });
382
412
 
383
- const bindGroup = await createBindGroupWithValidation(execution.device, {
384
- label: 'moe_offsets_bind_group',
385
- layout: explicitLayout,
386
- entries: [
387
- { binding: 0, resource: { buffer: uniformBuffer } },
388
- { binding: 1, resource: { buffer: tokenCounts } },
389
- { binding: 2, resource: { buffer: tokenMap } },
390
- { binding: 3, resource: { buffer: tokenOffsets } },
391
- ],
392
- }, 'moe_offsets');
393
-
394
- const totalSlots = numExperts * maxTokensPerExpert;
395
- const workgroups = Math.ceil(totalSlots / WORKGROUP_SIZES.DEFAULT);
396
-
397
- if (execution.recorder) {
398
- const pass = execution.recorder.beginComputePass('moe_offsets');
399
- pass.setPipeline(pipeline);
400
- pass.setBindGroup(0, bindGroup);
401
- pass.dispatchWorkgroups(workgroups);
402
- pass.end();
403
- } else {
404
- const encoder = execution.device.createCommandEncoder({ label: 'moe_offsets_encoder' });
405
- const pass = encoder.beginComputePass({ label: 'moe_offsets_pass' });
406
- pass.setPipeline(pipeline);
407
- pass.setBindGroup(0, bindGroup);
408
- pass.dispatchWorkgroups(workgroups);
409
- pass.end();
410
- execution.device.queue.submit([encoder.finish()]);
413
+ try {
414
+ const bindGroup = await createBindGroupWithValidation(execution.device, {
415
+ label: 'moe_offsets_bind_group',
416
+ layout: explicitLayout,
417
+ entries: [
418
+ { binding: 0, resource: { buffer: uniformBuffer } },
419
+ { binding: 1, resource: { buffer: tokenCounts } },
420
+ { binding: 2, resource: { buffer: tokenMap } },
421
+ { binding: 3, resource: { buffer: tokenOffsets } },
422
+ ],
423
+ }, 'moe_offsets');
424
+
425
+ const totalSlots = numExperts * maxTokensPerExpert;
426
+ const workgroups = Math.ceil(totalSlots / WORKGROUP_SIZES.DEFAULT);
427
+
428
+ if (execution.recorder) {
429
+ const pass = execution.recorder.beginComputePass('moe_offsets');
430
+ pass.setPipeline(pipeline);
431
+ pass.setBindGroup(0, bindGroup);
432
+ pass.dispatchWorkgroups(workgroups);
433
+ pass.end();
434
+ } else {
435
+ const encoder = execution.device.createCommandEncoder({ label: 'moe_offsets_encoder' });
436
+ const pass = encoder.beginComputePass({ label: 'moe_offsets_pass' });
437
+ pass.setPipeline(pipeline);
438
+ pass.setBindGroup(0, bindGroup);
439
+ pass.dispatchWorkgroups(workgroups);
440
+ pass.end();
441
+ execution.device.queue.submit([encoder.finish()]);
442
+ }
443
+
444
+ return tokenOffsets;
445
+ } catch (error) {
446
+ if (ownsOutput) {
447
+ releaseTemporaryBuffer(execution, tokenOffsets);
448
+ }
449
+ throw error;
450
+ } finally {
451
+ releaseUniformBuffer(execution, uniformBuffer);
411
452
  }
412
-
413
- releaseUniformBuffer(execution, uniformBuffer);
414
- return tokenOffsets;
415
453
  }
416
454
 
417
455
  export async function runMoEBuildTokenOffsets(tokenCounts, tokenMap, numTokens, numExperts, topK, maxTokensPerExpert, options = {}) {
@@ -425,6 +463,7 @@ export async function recordMoEBuildTokenOffsets(recorder, tokenCounts, tokenMap
425
463
  async function executeScatterAddDynamic(recorder, expertOutputs, indices, weights, tokenOffsets, numTokens, hiddenSize, topK, options = {}) {
426
464
  const execution = resolveExecution(recorder);
427
465
  const { outputBuffer = null, weightsDtype = 'f32' } = options;
466
+ const ownsOutput = outputBuffer == null;
428
467
 
429
468
  if (weightsDtype === 'f16' && expertOutputs.dtype !== 'f16') {
430
469
  throw new Error('ScatterAddDynamic f16 weights require f16 expert outputs');
@@ -447,43 +486,50 @@ async function executeScatterAddDynamic(recorder, expertOutputs, indices, weight
447
486
  view.setUint32(8, topK, true);
448
487
  });
449
488
 
450
- const bindGroup = await createBindGroupWithValidation(execution.device, {
451
- label: 'scatter_add_dynamic_bind_group',
452
- layout: pipeline.getBindGroupLayout(0),
453
- entries: [
454
- { binding: 0, resource: { buffer: uniformBuffer } },
455
- { binding: 1, resource: { buffer: expertOutputs.buffer } },
456
- { binding: 2, resource: { buffer: indices } },
457
- { binding: 3, resource: { buffer: weights } },
458
- { binding: 4, resource: { buffer: tokenOffsets } },
459
- { binding: 5, resource: { buffer: outputBuf } },
460
- ],
461
- }, `scatter_add_dynamic:${variant}`);
462
-
463
- const workgroups = Math.ceil((numTokens * topK * hiddenSize) / WORKGROUP_SIZES.DEFAULT);
464
-
465
- if (execution.recorder) {
466
- execution.recorder.getEncoder().clearBuffer(outputBuf);
467
-
468
- const pass = execution.recorder.beginComputePass('scatter_add_dynamic');
469
- pass.setPipeline(pipeline);
470
- pass.setBindGroup(0, bindGroup);
471
- pass.dispatchWorkgroups(workgroups);
472
- pass.end();
473
- } else {
474
- const encoder = execution.device.createCommandEncoder({ label: 'scatter_add_dynamic_encoder' });
475
- encoder.clearBuffer(outputBuf);
476
- const pass = encoder.beginComputePass({ label: 'scatter_add_dynamic_pass' });
477
- pass.setPipeline(pipeline);
478
- pass.setBindGroup(0, bindGroup);
479
- pass.dispatchWorkgroups(workgroups);
480
- pass.end();
481
- execution.device.queue.submit([encoder.finish()]);
489
+ try {
490
+ const bindGroup = await createBindGroupWithValidation(execution.device, {
491
+ label: 'scatter_add_dynamic_bind_group',
492
+ layout: pipeline.getBindGroupLayout(0),
493
+ entries: [
494
+ { binding: 0, resource: { buffer: uniformBuffer } },
495
+ { binding: 1, resource: { buffer: expertOutputs.buffer } },
496
+ { binding: 2, resource: { buffer: indices } },
497
+ { binding: 3, resource: { buffer: weights } },
498
+ { binding: 4, resource: { buffer: tokenOffsets } },
499
+ { binding: 5, resource: { buffer: outputBuf } },
500
+ ],
501
+ }, `scatter_add_dynamic:${variant}`);
502
+
503
+ const workgroups = Math.ceil((numTokens * topK * hiddenSize) / WORKGROUP_SIZES.DEFAULT);
504
+
505
+ if (execution.recorder) {
506
+ execution.recorder.getEncoder().clearBuffer(outputBuf);
507
+
508
+ const pass = execution.recorder.beginComputePass('scatter_add_dynamic');
509
+ pass.setPipeline(pipeline);
510
+ pass.setBindGroup(0, bindGroup);
511
+ pass.dispatchWorkgroups(workgroups);
512
+ pass.end();
513
+ } else {
514
+ const encoder = execution.device.createCommandEncoder({ label: 'scatter_add_dynamic_encoder' });
515
+ encoder.clearBuffer(outputBuf);
516
+ const pass = encoder.beginComputePass({ label: 'scatter_add_dynamic_pass' });
517
+ pass.setPipeline(pipeline);
518
+ pass.setBindGroup(0, bindGroup);
519
+ pass.dispatchWorkgroups(workgroups);
520
+ pass.end();
521
+ execution.device.queue.submit([encoder.finish()]);
522
+ }
523
+
524
+ return createTensor(outputBuf, expertOutputs.dtype, [numTokens, hiddenSize], 'scatter_add_dynamic_output');
525
+ } catch (error) {
526
+ if (ownsOutput) {
527
+ releaseTemporaryBuffer(execution, outputBuf);
528
+ }
529
+ throw error;
530
+ } finally {
531
+ releaseUniformBuffer(execution, uniformBuffer);
482
532
  }
483
-
484
- releaseUniformBuffer(execution, uniformBuffer);
485
-
486
- return createTensor(outputBuf, expertOutputs.dtype, [numTokens, hiddenSize], 'scatter_add_dynamic_output');
487
533
  }
488
534
 
489
535
  export async function runScatterAddDynamic(expertOutputs, indices, weights, tokenOffsets, numTokens, hiddenSize, topK, options = {}) {