doppler-gpu 0.2.0 → 0.2.1

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 (607) hide show
  1. package/CHANGELOG.md +21 -1
  2. package/README.md +97 -29
  3. package/package.json +40 -27
  4. package/src/cli/config/doppler-quickstart.json +10 -0
  5. package/src/cli/doppler-cli.js +66 -22
  6. package/src/cli/doppler-quickstart.d.ts +61 -0
  7. package/src/cli/doppler-quickstart.js +299 -0
  8. package/src/cli/doppler-serve.js +395 -0
  9. package/src/client/doppler-api.browser.js +13 -377
  10. package/src/client/doppler-api.d.ts +35 -56
  11. package/src/client/doppler-api.js +12 -363
  12. package/src/client/doppler-registry.json +55 -2
  13. package/src/client/runtime/index.d.ts +63 -0
  14. package/src/client/runtime/index.js +173 -0
  15. package/src/client/runtime/lora.d.ts +36 -0
  16. package/src/client/runtime/lora.js +165 -0
  17. package/src/client/{doppler-provider → runtime}/model-manager.d.ts +1 -1
  18. package/src/client/{doppler-provider → runtime}/model-manager.js +56 -30
  19. package/src/client/runtime/model-session.d.ts +72 -0
  20. package/src/client/runtime/model-session.js +122 -0
  21. package/src/client/runtime/model-source.d.ts +43 -0
  22. package/src/client/runtime/model-source.js +101 -0
  23. package/src/client/{doppler-provider → runtime}/source-runtime.d.ts +8 -5
  24. package/src/client/runtime/source-runtime.js +919 -0
  25. package/src/client/runtime/storage.d.ts +5 -0
  26. package/src/client/runtime/storage.js +51 -0
  27. package/src/client/{doppler-provider → runtime}/types.d.ts +14 -2
  28. package/src/config/README.md +2 -0
  29. package/src/config/conversion/README.md +47 -7
  30. package/src/config/conversion/embeddinggemma/google-embeddinggemma-300m-q4k-ehf16-af32.json +67 -5
  31. package/src/config/conversion/gemma3/gemma-3-1b-it-f16-af32.json +62 -11
  32. package/src/config/conversion/gemma3/gemma-3-1b-it-q4k-ehf16-af32.json +79 -18
  33. package/src/config/conversion/gemma3/gemma-3-270m-it-q4k-ehf16-af32.json +61 -13
  34. package/src/config/conversion/gemma3/translategemma-4b-1b-enes-q4k-ehf16-af32.json +53 -10
  35. package/src/config/conversion/gemma3/translategemma-4b-it-q4k-ehf16-af32.json +66 -18
  36. package/src/config/conversion/gemma4/gemma-4-e2b-it-q4k-ehf16-af32.json +256 -0
  37. package/src/config/conversion/gemma4/gemma-4-moe-q4k-ehf16-af32.json +49 -8
  38. package/src/config/conversion/gpt-oss-20b-f16-xmxfp4.json +45 -6
  39. package/src/config/conversion/janus/janus-pro-1b-text-q4k-ehaf16.json +45 -6
  40. package/src/config/conversion/lfm2/lfm2.5-1.2b-instruct-q4k-ehf16-af32.json +57 -9
  41. package/src/config/conversion/qwen3/qwen-3-5-0-8b-q4k-ehaf16.json +105 -26
  42. package/src/config/conversion/qwen3/qwen-3-5-2b-q4k-ehaf16.json +83 -33
  43. package/src/config/conversion/sana/sana-sprint-0.6b-f16.json +33 -5
  44. package/src/config/execution-contract-check.d.ts +2 -1
  45. package/src/config/execution-contract-check.js +187 -53
  46. package/src/config/kernel-path-loader.d.ts +36 -0
  47. package/src/config/kernel-path-loader.js +97 -10
  48. package/src/config/kernels/kernel-ref-digests.js +40 -24
  49. package/src/config/kernels/registry.js +0 -1
  50. package/src/config/kernels/registry.json +772 -66
  51. package/src/config/merge-contract-check.js +3 -0
  52. package/src/config/merge.d.ts +18 -1
  53. package/src/config/merge.js +56 -0
  54. package/src/config/param-categories.js +5 -0
  55. package/src/config/param-validator.js +42 -26
  56. package/src/config/platforms/apple-m3.json +1 -1
  57. package/src/config/platforms/loader.js +21 -16
  58. package/src/config/required-inference-fields-contract-check.js +16 -0
  59. package/src/config/runtime/compute/f16-batched.json +2 -0
  60. package/src/config/runtime/default.json +1 -0
  61. package/src/config/runtime/experiments/bench/gemma3-bench-q4k-alt.json +57 -0
  62. package/src/config/runtime/experiments/bench/gemma3-bench-q4k-batched.json +57 -0
  63. package/src/config/runtime/experiments/bench/gemma3-bench-q4k.json +2 -0
  64. package/src/config/runtime/experiments/bench/qwen3-bench-q4k-alt.json +57 -0
  65. package/src/config/runtime/experiments/bench/qwen3-bench-q4k-batched.json +57 -0
  66. package/src/config/runtime/experiments/debug/gemma3-browser-diagnose-q4k.json +81 -0
  67. package/src/config/runtime/experiments/debug/gemma3-debug-q4k.json +5 -0
  68. package/src/config/runtime/experiments/debug/qwen35-browser-diagnose-q4k.json +81 -0
  69. package/src/config/runtime/experiments/verify/gemma4-e2b-verify.json +38 -0
  70. package/src/config/runtime/profiles/gemma4-e2b-low-memory.json +63 -0
  71. package/src/config/runtime/profiles/gemma4-e2b-throughput.json +39 -0
  72. package/src/config/runtime/profiles/low-memory.json +1 -0
  73. package/src/config/runtime/profiles/turboquant-contiguous-prod.json +29 -0
  74. package/src/config/runtime/profiles/turboquant-contiguous.json +29 -0
  75. package/src/config/runtime/profiles/turboquant.json +36 -0
  76. package/src/config/runtime/profiles/vector-stability.json +1 -0
  77. package/src/config/runtime/tiers/gemma4-128gb.json +79 -0
  78. package/src/config/runtime/tiers/gemma4-16gb.json +15 -2
  79. package/src/config/runtime/tiers/gemma4-24gb.json +15 -2
  80. package/src/config/runtime/tiers/gemma4-32gb.json +15 -2
  81. package/src/config/runtime.js +11 -4
  82. package/src/config/schema/converter.schema.d.ts +4 -2
  83. package/src/config/schema/converter.schema.js +7 -5
  84. package/src/config/schema/doppler.schema.d.ts +26 -2
  85. package/src/config/schema/doppler.schema.js +77 -28
  86. package/src/config/schema/execution-v1.schema.d.ts +78 -5
  87. package/src/config/schema/execution-v1.schema.js +62 -1
  88. package/src/config/schema/index.d.ts +22 -29
  89. package/src/config/schema/index.js +15 -17
  90. package/src/config/schema/inference.schema.d.ts +26 -4
  91. package/src/config/schema/kernel-path.schema.d.ts +30 -3
  92. package/src/config/schema/kernel-registry.schema.d.ts +1 -1
  93. package/src/config/schema/kernel-registry.schema.js +1 -0
  94. package/src/config/schema/kvcache.schema.js +7 -0
  95. package/src/config/schema/loading.schema.d.ts +28 -0
  96. package/src/config/schema/loading.schema.js +9 -0
  97. package/src/config/schema/manifest.schema.d.ts +79 -5
  98. package/src/config/schema/manifest.schema.js +7 -1
  99. package/src/config/schema/platform.schema.d.ts +10 -8
  100. package/src/config/schema/speculation-self.schema.js +0 -5
  101. package/src/config/schema/support-tiers.schema.d.ts +53 -0
  102. package/src/config/schema/support-tiers.schema.js +128 -0
  103. package/src/config/source-packages/litert/gemma-4-e2b-it.json +622 -0
  104. package/src/config/source-packages/registry.json +15 -0
  105. package/src/config/support-tiers/subsystems.json +502 -0
  106. package/src/config/transforms/capability-transform-resolver.d.ts +16 -5
  107. package/src/config/transforms/capability-transform-resolver.js +44 -9
  108. package/src/config/transforms/execution-graph-transforms.d.ts +113 -2
  109. package/src/config/transforms/execution-graph-transforms.js +1220 -8
  110. package/src/converter/conversion-plan.js +20 -8
  111. package/src/converter/core.d.ts +48 -1
  112. package/src/converter/core.js +249 -62
  113. package/src/converter/parsers/gguf.d.ts +10 -1
  114. package/src/converter/rope-config.d.ts +1 -0
  115. package/src/converter/rope-config.js +75 -5
  116. package/src/converter/shard-packer.js +2 -2
  117. package/src/debug/tensor.js +13 -1
  118. package/src/{adapters → experimental/adapters}/adapter-manager.d.ts +1 -1
  119. package/src/{adapters → experimental/adapters}/adapter-manager.js +2 -2
  120. package/src/{adapters → experimental/adapters}/adapter-manifest.d.ts +1 -1
  121. package/src/{adapters → experimental/adapters}/adapter-manifest.js +1 -1
  122. package/src/{adapters → experimental/adapters}/adapter-registry.d.ts +1 -1
  123. package/src/{adapters → experimental/adapters}/adapter-registry.js +1 -1
  124. package/src/{adapters → experimental/adapters}/lora-loader.d.ts +1 -1
  125. package/src/{adapters → experimental/adapters}/lora-loader.js +2 -2
  126. package/src/{bridge → experimental/bridge}/extension-client.js +2 -2
  127. package/src/{bridge → experimental/bridge}/node-bridge.js +2 -4
  128. package/src/{bridge → experimental/bridge}/protocol.js +1 -1
  129. package/src/{browser → experimental/browser}/browser-converter.d.ts +4 -4
  130. package/src/{browser → experimental/browser}/browser-converter.js +12 -12
  131. package/src/{browser → experimental/browser}/gguf-importer.d.ts +1 -1
  132. package/src/{browser → experimental/browser}/gguf-importer.js +8 -8
  133. package/src/{browser → experimental/browser}/gguf-parser-browser.d.ts +2 -2
  134. package/src/{browser → experimental/browser}/gguf-parser-browser.js +3 -3
  135. package/src/{browser → experimental/browser}/quantization.d.ts +3 -3
  136. package/src/{browser → experimental/browser}/quantization.js +4 -4
  137. package/src/{browser → experimental/browser}/safetensors-parser-browser.d.ts +3 -3
  138. package/src/{browser → experimental/browser}/safetensors-parser-browser.js +3 -3
  139. package/src/{browser → experimental/browser}/shard-io-browser.d.ts +1 -1
  140. package/src/{browser → experimental/browser}/shard-io-browser.js +2 -2
  141. package/src/{browser → experimental/browser}/tensor-source-download.js +3 -3
  142. package/src/experimental/diffusion/index.d.ts +8 -0
  143. package/src/experimental/diffusion/index.js +8 -0
  144. package/src/{distribution → experimental/distribution}/p2p-transport-contract.js +1 -1
  145. package/src/{distribution → experimental/distribution}/p2p-transport.js +1 -1
  146. package/src/{distribution → experimental/distribution}/shard-delivery.js +5 -5
  147. package/src/experimental/energy/index.d.ts +2 -0
  148. package/src/experimental/energy/index.js +2 -0
  149. package/src/{hotswap → experimental/hotswap}/intent-bundle.d.ts +1 -1
  150. package/src/{hotswap → experimental/hotswap}/intent-bundle.js +2 -2
  151. package/src/{hotswap → experimental/hotswap}/manifest.d.ts +2 -2
  152. package/src/{hotswap → experimental/hotswap}/manifest.js +1 -1
  153. package/src/{hotswap → experimental/hotswap}/model-swap.js +1 -1
  154. package/src/{hotswap → experimental/hotswap}/runtime.d.ts +1 -1
  155. package/src/experimental/orchestration/index.d.ts +12 -0
  156. package/src/experimental/orchestration/index.js +12 -0
  157. package/src/{training → experimental/training}/README.md +1 -1
  158. package/src/{training → experimental/training}/artifacts.d.ts +3 -3
  159. package/src/{training → experimental/training}/artifacts.js +3 -3
  160. package/src/{training → experimental/training}/attention-backward.d.ts +1 -1
  161. package/src/{training → experimental/training}/attention-backward.js +3 -3
  162. package/src/{training → experimental/training}/attention-forward.d.ts +2 -2
  163. package/src/{training → experimental/training}/attention-forward.js +1 -1
  164. package/src/{training → experimental/training}/autograd.d.ts +2 -2
  165. package/src/{training → experimental/training}/autograd.js +7 -7
  166. package/src/{training → experimental/training}/backward-kernels.js +1 -1
  167. package/src/{training → experimental/training}/checkpoint.js +1 -1
  168. package/src/{training → experimental/training}/clip.d.ts +2 -2
  169. package/src/{training → experimental/training}/clip.js +3 -3
  170. package/src/{training → experimental/training}/export.d.ts +2 -2
  171. package/src/{training → experimental/training}/export.js +2 -2
  172. package/src/{training → experimental/training}/lora-pipeline.js +4 -4
  173. package/src/{training → experimental/training}/lora.d.ts +1 -1
  174. package/src/{training → experimental/training}/lora.js +4 -4
  175. package/src/{training → experimental/training}/loss-scaling.d.ts +2 -2
  176. package/src/{training → experimental/training}/loss-scaling.js +3 -3
  177. package/src/{training → experimental/training}/loss.d.ts +2 -2
  178. package/src/{training → experimental/training}/loss.js +1 -1
  179. package/src/{training → experimental/training}/operator-artifacts.js +1 -1
  180. package/src/{training → experimental/training}/optimizer.d.ts +2 -2
  181. package/src/{training → experimental/training}/optimizer.js +3 -3
  182. package/src/{training → experimental/training}/runner.d.ts +2 -2
  183. package/src/{training → experimental/training}/runner.js +5 -5
  184. package/src/{training → experimental/training}/suite.js +16 -16
  185. package/src/{training → experimental/training}/tensor-factory.d.ts +1 -1
  186. package/src/{training → experimental/training}/tensor-factory.js +2 -2
  187. package/src/{training → experimental/training}/trainer.d.ts +3 -3
  188. package/src/{training → experimental/training}/trainer.js +3 -3
  189. package/src/{training → experimental/training}/ul_dataset.d.ts +2 -2
  190. package/src/{training → experimental/training}/ul_dataset.js +1 -1
  191. package/src/{training → experimental/training}/ul_schedule.d.ts +1 -1
  192. package/src/{training → experimental/training}/workloads.js +4 -4
  193. package/src/formats/index.d.ts +24 -0
  194. package/src/formats/index.js +6 -0
  195. package/src/formats/litert/index.d.ts +1 -0
  196. package/src/formats/litert/index.js +1 -0
  197. package/src/formats/litert/types.d.ts +87 -0
  198. package/src/formats/litert/types.js +568 -0
  199. package/src/formats/rdrr/classification.js +16 -8
  200. package/src/formats/rdrr/parsing.d.ts +3 -2
  201. package/src/formats/rdrr/types.d.ts +33 -0
  202. package/src/formats/rdrr/validation.js +16 -5
  203. package/src/formats/tflite/index.d.ts +1 -0
  204. package/src/formats/tflite/index.js +1 -0
  205. package/src/formats/tflite/types.d.ts +84 -0
  206. package/src/formats/tflite/types.js +633 -0
  207. package/src/generation/index.d.ts +16 -14
  208. package/src/generation/index.js +1 -32
  209. package/src/gpu/command-recorder.d.ts +17 -1
  210. package/src/gpu/command-recorder.js +47 -10
  211. package/src/gpu/device.d.ts +3 -1
  212. package/src/gpu/device.js +17 -11
  213. package/src/gpu/kernel-selector.js +3 -1
  214. package/src/gpu/kernels/attention.d.ts +2 -0
  215. package/src/gpu/kernels/attention.js +359 -14
  216. package/src/gpu/kernels/attention.wgsl +20 -1
  217. package/src/gpu/kernels/attention_decode_contiguous_turboquant_f16kv.wgsl +180 -0
  218. package/src/gpu/kernels/attention_decode_contiguous_turboquant_prod_f16kv.wgsl +192 -0
  219. package/src/gpu/kernels/attention_decode_online_f16.wgsl +36 -18
  220. package/src/gpu/kernels/attention_decode_online_f16kv.wgsl +36 -18
  221. package/src/gpu/kernels/attention_decode_tiered_turboquant_f16kv.wgsl +269 -0
  222. package/src/gpu/kernels/attention_decode_tiered_turboquant_prod_f16kv.wgsl +281 -0
  223. package/src/gpu/kernels/attention_head256_f16kv.wgsl +269 -0
  224. package/src/gpu/kernels/attention_streaming.wgsl +22 -3
  225. package/src/gpu/kernels/attention_streaming_f16.wgsl +1 -1
  226. package/src/gpu/kernels/attention_streaming_f16kv.wgsl +1 -1
  227. package/src/gpu/kernels/backward/attention_backward.d.ts +14 -1
  228. package/src/gpu/kernels/check-hot-vocab-stop.d.ts +18 -0
  229. package/src/gpu/kernels/check-hot-vocab-stop.js +108 -0
  230. package/src/gpu/kernels/codegen/patches/attention_streaming_f16.from.attention_streaming.diff +1 -1
  231. package/src/gpu/kernels/codegen/patches/attention_streaming_f16kv.from.attention_streaming.diff +1 -1
  232. package/src/gpu/kernels/codegen/patches/rope_f16.from.rope.diff +126 -194
  233. package/src/gpu/kernels/codegen/wgsl-variants.js +24 -6
  234. package/src/gpu/kernels/depthwise_conv1d.d.ts +23 -0
  235. package/src/gpu/kernels/depthwise_conv1d.js +51 -0
  236. package/src/gpu/kernels/depthwise_conv1d.wgsl +46 -0
  237. package/src/gpu/kernels/feature-check.js +0 -1
  238. package/src/gpu/kernels/fused_ffn.js +67 -22
  239. package/src/gpu/kernels/fused_ffn_q4k.wgsl +48 -43
  240. package/src/gpu/kernels/fused_ffn_q4k_f16.wgsl +329 -0
  241. package/src/gpu/kernels/fused_matmul_q4.wgsl +417 -0
  242. package/src/gpu/kernels/fused_matmul_q4_batched_multicol_shared.wgsl +174 -0
  243. package/src/gpu/kernels/gather.d.ts +4 -0
  244. package/src/gpu/kernels/gather.js +13 -2
  245. package/src/gpu/kernels/gather.wgsl +5 -3
  246. package/src/gpu/kernels/gather_f16.wgsl +5 -3
  247. package/src/gpu/kernels/index.d.ts +7 -0
  248. package/src/gpu/kernels/index.js +6 -0
  249. package/src/gpu/kernels/kernel-configs.js +1 -0
  250. package/src/gpu/kernels/kv-quantize.js +87 -55
  251. package/src/gpu/kernels/kv_quantize_turboquant.wgsl +153 -0
  252. package/src/gpu/kernels/kv_quantize_turboquant_prod.wgsl +230 -0
  253. package/src/gpu/kernels/linear-attention-core.d.ts +3 -0
  254. package/src/gpu/kernels/linear-attention-core.js +145 -56
  255. package/src/gpu/kernels/matmul-dispatch.js +3 -0
  256. package/src/gpu/kernels/matmul-selection.js +31 -42
  257. package/src/gpu/kernels/matmul.d.ts +3 -0
  258. package/src/gpu/kernels/matmul.js +72 -34
  259. package/src/gpu/kernels/residual.d.ts +2 -0
  260. package/src/gpu/kernels/residual.js +43 -4
  261. package/src/gpu/kernels/rope.d.ts +2 -0
  262. package/src/gpu/kernels/rope.js +19 -6
  263. package/src/gpu/kernels/rope.wgsl +24 -12
  264. package/src/gpu/kernels/rope_f16.wgsl +97 -38
  265. package/src/gpu/kernels/scale.d.ts +5 -0
  266. package/src/gpu/kernels/scale.js +6 -1
  267. package/src/gpu/kernels/scale.wgsl +3 -1
  268. package/src/gpu/kernels/scale_f16.wgsl +32 -0
  269. package/src/gpu/kernels/turboquant-codebook.js +564 -0
  270. package/src/gpu/kernels/uniform-utils.js +26 -0
  271. package/src/gpu/kernels/utils.js +6 -1
  272. package/src/gpu/submit-probe.d.ts +12 -0
  273. package/src/gpu/submit-probe.js +77 -0
  274. package/src/gpu/weight-buffer.d.ts +26 -3
  275. package/src/gpu/weight-buffer.js +62 -2
  276. package/src/index-browser.d.ts +1 -91
  277. package/src/index-browser.js +0 -66
  278. package/src/index.d.ts +1 -102
  279. package/src/index.js +0 -74
  280. package/src/inference/browser-harness-model-helpers.d.ts +3 -0
  281. package/src/inference/browser-harness-model-helpers.js +134 -11
  282. package/src/inference/browser-harness-runtime-helpers.js +1 -9
  283. package/src/inference/browser-harness-text-helpers.js +441 -70
  284. package/src/inference/browser-harness.js +61 -4
  285. package/src/inference/decode-ring.d.ts +2 -0
  286. package/src/inference/decode-ring.js +20 -0
  287. package/src/inference/kv-cache/index.d.ts +3 -0
  288. package/src/inference/kv-cache/index.js +2 -0
  289. package/src/inference/kv-cache/mixed-geometry.d.ts +84 -0
  290. package/src/inference/kv-cache/mixed-geometry.js +422 -0
  291. package/src/inference/kv-cache/quantized.d.ts +56 -0
  292. package/src/inference/kv-cache/quantized.js +383 -0
  293. package/src/inference/kv-cache/tiered.d.ts +20 -3
  294. package/src/inference/kv-cache/tiered.js +203 -65
  295. package/src/inference/kv-cache/types.d.ts +49 -6
  296. package/src/inference/kv-cache.d.ts +3 -0
  297. package/src/inference/kv-cache.js +2 -0
  298. package/src/inference/multi-model-network.js +2 -1
  299. package/src/inference/pipelines/audio/gemma4.js +655 -0
  300. package/src/inference/pipelines/audio/index.js +39 -0
  301. package/src/inference/pipelines/audio/mel.js +171 -0
  302. package/src/inference/pipelines/context.js +9 -1
  303. package/src/inference/pipelines/diffusion/text-encoder-gpu.js +2 -0
  304. package/src/inference/pipelines/shared/clipped-linear.js +46 -0
  305. package/src/inference/pipelines/text/attention/dispatch-params.d.ts +2 -1
  306. package/src/inference/pipelines/text/attention/dispatch-params.js +52 -8
  307. package/src/inference/pipelines/text/attention/output-projection.js +3 -3
  308. package/src/inference/pipelines/text/attention/precision-contract.d.ts +36 -0
  309. package/src/inference/pipelines/text/attention/precision-contract.js +115 -0
  310. package/src/inference/pipelines/text/attention/projections.d.ts +23 -0
  311. package/src/inference/pipelines/text/attention/projections.js +182 -15
  312. package/src/inference/pipelines/text/attention/quant-options.js +54 -0
  313. package/src/inference/pipelines/text/attention/record.js +257 -69
  314. package/src/inference/pipelines/text/attention/run.js +306 -94
  315. package/src/inference/pipelines/text/attention/types.d.ts +11 -0
  316. package/src/inference/pipelines/text/chat-format.d.ts +8 -1
  317. package/src/inference/pipelines/text/chat-format.js +89 -5
  318. package/src/inference/pipelines/text/config.d.ts +78 -26
  319. package/src/inference/pipelines/text/config.js +722 -28
  320. package/src/inference/pipelines/text/dtype-contract.d.ts +15 -0
  321. package/src/inference/pipelines/text/dtype-contract.js +38 -0
  322. package/src/inference/pipelines/text/embed.d.ts +4 -0
  323. package/src/inference/pipelines/text/embed.js +165 -172
  324. package/src/inference/pipelines/text/execution-plan.d.ts +19 -0
  325. package/src/inference/pipelines/text/execution-plan.js +112 -20
  326. package/src/inference/pipelines/text/execution-runtime-builders.d.ts +8 -4
  327. package/src/inference/pipelines/text/execution-runtime-builders.js +90 -49
  328. package/src/inference/pipelines/text/execution-v1.d.ts +23 -4
  329. package/src/inference/pipelines/text/execution-v1.js +411 -33
  330. package/src/inference/pipelines/text/ffn/dense.d.ts +59 -0
  331. package/src/inference/pipelines/text/ffn/dense.js +575 -63
  332. package/src/inference/pipelines/text/ffn/moe.js +1 -0
  333. package/src/inference/pipelines/text/ffn/sandwich.js +20 -4
  334. package/src/inference/pipelines/text/ffn/standard.js +28 -4
  335. package/src/inference/pipelines/text/finiteness-policy.d.ts +4 -0
  336. package/src/inference/pipelines/text/finiteness-policy.js +14 -11
  337. package/src/inference/pipelines/text/generator-helpers.d.ts +7 -0
  338. package/src/inference/pipelines/text/generator-helpers.js +39 -4
  339. package/src/inference/pipelines/text/generator-runtime.js +45 -8
  340. package/src/inference/pipelines/text/generator-steps.js +407 -75
  341. package/src/inference/pipelines/text/generator.d.ts +6 -0
  342. package/src/inference/pipelines/text/generator.js +1179 -305
  343. package/src/inference/pipelines/text/init.d.ts +39 -7
  344. package/src/inference/pipelines/text/init.js +525 -110
  345. package/src/inference/pipelines/text/layer-plan.d.ts +1 -0
  346. package/src/inference/pipelines/text/layer-plan.js +2 -0
  347. package/src/inference/pipelines/text/layer.js +402 -19
  348. package/src/inference/pipelines/text/linear-attention.d.ts +4 -0
  349. package/src/inference/pipelines/text/linear-attention.js +112 -41
  350. package/src/inference/pipelines/text/logits/gpu.d.ts +2 -1
  351. package/src/inference/pipelines/text/logits/gpu.js +334 -15
  352. package/src/inference/pipelines/text/logits/index.d.ts +11 -0
  353. package/src/inference/pipelines/text/logits/index.js +227 -29
  354. package/src/inference/pipelines/text/logits/types.d.ts +3 -0
  355. package/src/inference/pipelines/text/logits/utils.js +3 -1
  356. package/src/inference/pipelines/text/lora-apply.js +3 -3
  357. package/src/inference/pipelines/text/model-load.d.ts +2 -1
  358. package/src/inference/pipelines/text/model-load.js +205 -178
  359. package/src/inference/pipelines/text/moe-gpu.js +8 -0
  360. package/src/inference/pipelines/text/moe-impl.d.ts +2 -0
  361. package/src/inference/pipelines/text/ops.d.ts +16 -2
  362. package/src/inference/pipelines/text/ops.js +11 -2
  363. package/src/inference/pipelines/text/per-layer-inputs.d.ts +107 -0
  364. package/src/inference/pipelines/text/per-layer-inputs.js +1581 -0
  365. package/src/inference/pipelines/text/probes.js +6 -0
  366. package/src/inference/pipelines/text/sampling-config.js +9 -1
  367. package/src/inference/pipelines/text/stage-names.js +3 -0
  368. package/src/inference/pipelines/text/state.d.ts +12 -3
  369. package/src/inference/pipelines/text/state.js +19 -0
  370. package/src/inference/pipelines/text/types.d.ts +79 -7
  371. package/src/inference/pipelines/text/weights.d.ts +2 -2
  372. package/src/inference/pipelines/text/weights.js +4 -0
  373. package/src/inference/pipelines/text.d.ts +6 -0
  374. package/src/inference/pipelines/text.js +860 -11
  375. package/src/inference/pipelines/video/frame-sampler.js +36 -0
  376. package/src/inference/pipelines/video/index.js +87 -0
  377. package/src/inference/pipelines/vision/encoder.js +27 -6
  378. package/src/inference/pipelines/vision/gemma4.js +731 -0
  379. package/src/inference/pipelines/vision/image-preprocess.js +22 -7
  380. package/src/inference/pipelines/vision/index.js +35 -10
  381. package/src/inference/pipelines/vision/ops.js +31 -26
  382. package/src/inference/pipelines/vision/patch-embed.js +22 -10
  383. package/src/inference/runtime-model.d.ts +89 -0
  384. package/src/inference/runtime-model.js +152 -0
  385. package/src/inference/test-harness.d.ts +8 -1
  386. package/src/inference/test-harness.js +54 -20
  387. package/src/inference/tokenizer.d.ts +5 -0
  388. package/src/inference/tokenizer.js +43 -0
  389. package/src/inference/tokenizers/base.d.ts +5 -0
  390. package/src/inference/tokenizers/base.js +5 -0
  391. package/src/inference/tokenizers/behavior-flags.d.ts +9 -0
  392. package/src/inference/tokenizers/behavior-flags.js +100 -0
  393. package/src/inference/tokenizers/bundled.d.ts +4 -0
  394. package/src/inference/tokenizers/bundled.js +110 -0
  395. package/src/inference/tokenizers/sentencepiece.d.ts +2 -0
  396. package/src/inference/tokenizers/sentencepiece.js +16 -0
  397. package/src/inference/tokenizers/types.d.ts +2 -0
  398. package/src/loader/doppler-loader.d.ts +10 -3
  399. package/src/loader/doppler-loader.js +103 -5
  400. package/src/loader/embedding-loader.d.ts +5 -1
  401. package/src/loader/embedding-loader.js +57 -6
  402. package/src/loader/final-weights-loader.js +44 -5
  403. package/src/loader/layer-loader.js +210 -8
  404. package/src/loader/loader-state.js +2 -2
  405. package/src/loader/loader-types.d.ts +17 -1
  406. package/src/loader/memory-monitor.d.ts +8 -0
  407. package/src/loader/memory-monitor.js +21 -0
  408. package/src/loader/multi-model-loader.d.ts +9 -1
  409. package/src/loader/multi-model-loader.js +9 -1
  410. package/src/loader/per-layer-input-loader.d.ts +30 -0
  411. package/src/loader/per-layer-input-loader.js +478 -0
  412. package/src/loader/shard-cache.d.ts +4 -3
  413. package/src/loader/shard-resolver.js +2 -0
  414. package/src/loader/tensors/source-transform.d.ts +50 -0
  415. package/src/loader/tensors/source-transform.js +776 -0
  416. package/src/loader/tensors/tensor-loader.d.ts +12 -0
  417. package/src/loader/tensors/tensor-loader.js +208 -123
  418. package/src/loader/tensors/tensor-reader.d.ts +8 -0
  419. package/src/loader/tensors/tensor-reader.js +283 -15
  420. package/src/loaders/index.d.ts +4 -0
  421. package/src/loaders/index.js +4 -0
  422. package/src/memory/buffer-pool.d.ts +4 -0
  423. package/src/memory/buffer-pool.js +36 -0
  424. package/src/rules/execution-rules-contract-check.d.ts +4 -0
  425. package/src/rules/execution-rules-contract-check.js +150 -24
  426. package/src/rules/inference/attention.rules.json +15 -0
  427. package/src/rules/inference/capability-transforms.rules.json +30 -0
  428. package/src/rules/inference/execution.rules.json +54 -2
  429. package/src/rules/inference/ffn.rules.json +33 -0
  430. package/src/rules/kernels/attention.rules.json +7 -0
  431. package/src/rules/kernels/fused-ffn.rules.json +4 -2
  432. package/src/rules/kernels/kv_quantize.rules.json +2 -0
  433. package/src/rules/kernels/matmul.rules.json +14 -0
  434. package/src/rules/kernels/scale.rules.json +2 -0
  435. package/src/rules/loader/tensor-loader.rules.json +1 -0
  436. package/src/storage/artifact-storage-context.d.ts +53 -0
  437. package/src/storage/artifact-storage-context.js +560 -0
  438. package/src/storage/downloader.js +7 -1
  439. package/src/storage/index.d.ts +18 -0
  440. package/src/storage/index.js +13 -0
  441. package/src/storage/preflight.js +22 -0
  442. package/src/storage/quickstart-downloader.js +35 -2
  443. package/src/storage/registry.d.ts +1 -0
  444. package/src/storage/registry.js +26 -4
  445. package/src/storage/shard-manager.d.ts +4 -0
  446. package/src/storage/shard-manager.js +25 -6
  447. package/src/storage/source-artifact-store.d.ts +9 -0
  448. package/src/storage/source-artifact-store.js +134 -0
  449. package/src/tooling/browser-command-runner.js +12 -5
  450. package/src/tooling/command-api-family-normalizers.js +144 -0
  451. package/src/tooling/command-api-helpers.js +1 -0
  452. package/src/tooling/command-api.d.ts +32 -9
  453. package/src/tooling/command-api.js +0 -25
  454. package/src/tooling/command-runner-shared.js +1 -2
  455. package/src/tooling/command-runner.html +5 -2
  456. package/src/tooling/diagnose-runner.js +1 -1
  457. package/src/tooling/kernel-path-builder/index.js +48 -32
  458. package/src/tooling/lean-execution-contract.d.ts +1 -1
  459. package/src/tooling/lean-execution-contract.js +2 -149
  460. package/src/tooling/litert-package-runtime.d.ts +46 -0
  461. package/src/tooling/litert-package-runtime.js +950 -0
  462. package/src/tooling/node-browser-command-runner.d.ts +13 -0
  463. package/src/tooling/node-browser-command-runner.js +163 -3
  464. package/src/tooling/node-command-runner.js +14 -5
  465. package/src/tooling/node-converter.js +226 -63
  466. package/src/tooling/node-source-runtime.d.ts +8 -3
  467. package/src/tooling/node-source-runtime.js +561 -236
  468. package/src/tooling/node-webgpu.js +7 -30
  469. package/src/tooling/opfs-cache.d.ts +18 -1
  470. package/src/tooling/opfs-cache.js +126 -9
  471. package/src/tooling/runtime-input-composition.d.ts +0 -1
  472. package/src/tooling/runtime-input-composition.js +0 -5
  473. package/src/tooling/source-artifact-adapter.d.ts +134 -0
  474. package/src/tooling/source-artifact-adapter.js +366 -0
  475. package/src/tooling/source-package-profiles.d.ts +33 -0
  476. package/src/tooling/source-package-profiles.js +57 -0
  477. package/src/tooling/source-runtime-bundle.d.ts +46 -6
  478. package/src/tooling/source-runtime-bundle.js +371 -60
  479. package/src/tooling/source-runtime-converter-config.d.ts +24 -0
  480. package/src/tooling/source-runtime-converter-config.js +297 -0
  481. package/src/tooling-experimental-exports.browser.js +2 -0
  482. package/src/tooling-experimental-exports.d.ts +7 -0
  483. package/src/tooling-experimental-exports.js +7 -0
  484. package/src/tooling-experimental-exports.shared.d.ts +26 -0
  485. package/src/tooling-experimental-exports.shared.js +29 -0
  486. package/src/tooling-exports.shared.d.ts +0 -23
  487. package/src/tooling-exports.shared.js +6 -28
  488. package/src/version.js +1 -1
  489. package/src/client/doppler-provider/generation.d.ts +0 -25
  490. package/src/client/doppler-provider/generation.js +0 -126
  491. package/src/client/doppler-provider/index.d.ts +0 -2
  492. package/src/client/doppler-provider/index.js +0 -3
  493. package/src/client/doppler-provider/provider.d.ts +0 -5
  494. package/src/client/doppler-provider/provider.js +0 -102
  495. package/src/client/doppler-provider/source-runtime.js +0 -677
  496. package/src/client/doppler-provider.d.ts +0 -46
  497. package/src/client/doppler-provider.js +0 -36
  498. package/src/config/schema/inference-defaults.schema.d.ts +0 -276
  499. package/src/config/schema/inference-defaults.schema.js +0 -189
  500. package/src/diffusion/index.d.ts +0 -8
  501. package/src/diffusion/index.js +0 -8
  502. package/src/energy/index.d.ts +0 -2
  503. package/src/energy/index.js +0 -2
  504. package/src/index-internal.d.ts +0 -2
  505. package/src/index-internal.js +0 -2
  506. /package/src/client/{doppler-provider → runtime}/types.js +0 -0
  507. /package/src/{adapters → experimental/adapters}/index.d.ts +0 -0
  508. /package/src/{adapters → experimental/adapters}/index.js +0 -0
  509. /package/src/{bridge → experimental/bridge}/extension/background.d.ts +0 -0
  510. /package/src/{bridge → experimental/bridge}/extension/background.js +0 -0
  511. /package/src/{bridge → experimental/bridge}/extension/manifest.json +0 -0
  512. /package/src/{bridge → experimental/bridge}/extension-client.d.ts +0 -0
  513. /package/src/{bridge → experimental/bridge}/index.d.ts +0 -0
  514. /package/src/{bridge → experimental/bridge}/index.js +0 -0
  515. /package/src/{bridge → experimental/bridge}/protocol.d.ts +0 -0
  516. /package/src/{browser → experimental/browser}/file-picker.d.ts +0 -0
  517. /package/src/{browser → experimental/browser}/file-picker.js +0 -0
  518. /package/src/{browser → experimental/browser}/tensor-source-download.d.ts +0 -0
  519. /package/src/{browser → experimental/browser}/tensor-source-file.d.ts +0 -0
  520. /package/src/{browser → experimental/browser}/tensor-source-file.js +0 -0
  521. /package/src/{browser → experimental/browser}/tensor-source-http.d.ts +0 -0
  522. /package/src/{browser → experimental/browser}/tensor-source-http.js +0 -0
  523. /package/src/{diffusion → experimental/diffusion}/config/expansion-lanes.json +0 -0
  524. /package/src/{diffusion → experimental/diffusion}/image-regression.d.ts +0 -0
  525. /package/src/{diffusion → experimental/diffusion}/image-regression.js +0 -0
  526. /package/src/{distribution → experimental/distribution}/p2p-control-plane.d.ts +0 -0
  527. /package/src/{distribution → experimental/distribution}/p2p-control-plane.js +0 -0
  528. /package/src/{distribution → experimental/distribution}/p2p-observability.d.ts +0 -0
  529. /package/src/{distribution → experimental/distribution}/p2p-observability.js +0 -0
  530. /package/src/{distribution → experimental/distribution}/p2p-transport-contract.d.ts +0 -0
  531. /package/src/{distribution → experimental/distribution}/p2p-webrtc-browser.d.ts +0 -0
  532. /package/src/{distribution → experimental/distribution}/p2p-webrtc-browser.js +0 -0
  533. /package/src/{distribution → experimental/distribution}/shard-delivery.d.ts +0 -0
  534. /package/src/{hotswap → experimental/hotswap}/runtime.js +0 -0
  535. /package/src/{training → experimental/training}/checkpoint-watch.d.ts +0 -0
  536. /package/src/{training → experimental/training}/checkpoint-watch.js +0 -0
  537. /package/src/{training → experimental/training}/checkpoint.d.ts +0 -0
  538. /package/src/{training → experimental/training}/dataloader.d.ts +0 -0
  539. /package/src/{training → experimental/training}/dataloader.js +0 -0
  540. /package/src/{training → experimental/training}/datasets/index.d.ts +0 -0
  541. /package/src/{training → experimental/training}/datasets/index.js +0 -0
  542. /package/src/{training → experimental/training}/datasets/jsonl.d.ts +0 -0
  543. /package/src/{training → experimental/training}/datasets/jsonl.js +0 -0
  544. /package/src/{training → experimental/training}/datasets/reploid.d.ts +0 -0
  545. /package/src/{training → experimental/training}/datasets/reploid.js +0 -0
  546. /package/src/{training → experimental/training}/datasets/text-pairs.d.ts +0 -0
  547. /package/src/{training → experimental/training}/datasets/text-pairs.js +0 -0
  548. /package/src/{training → experimental/training}/datasets/token-batch.d.ts +0 -0
  549. /package/src/{training → experimental/training}/datasets/token-batch.js +0 -0
  550. /package/src/{training → experimental/training}/datasets/translation-pairs.d.ts +0 -0
  551. /package/src/{training → experimental/training}/datasets/translation-pairs.js +0 -0
  552. /package/src/{training → experimental/training}/distillation/artifacts.d.ts +0 -0
  553. /package/src/{training → experimental/training}/distillation/artifacts.js +0 -0
  554. /package/src/{training → experimental/training}/distillation/checkpoint-watch.d.ts +0 -0
  555. /package/src/{training → experimental/training}/distillation/checkpoint-watch.js +0 -0
  556. /package/src/{training → experimental/training}/distillation/dataset.d.ts +0 -0
  557. /package/src/{training → experimental/training}/distillation/dataset.js +0 -0
  558. /package/src/{training → experimental/training}/distillation/eval.d.ts +0 -0
  559. /package/src/{training → experimental/training}/distillation/eval.js +0 -0
  560. /package/src/{training → experimental/training}/distillation/index.d.ts +0 -0
  561. /package/src/{training → experimental/training}/distillation/index.js +0 -0
  562. /package/src/{training → experimental/training}/distillation/runtime.d.ts +0 -0
  563. /package/src/{training → experimental/training}/distillation/runtime.js +0 -0
  564. /package/src/{training → experimental/training}/distillation/scoreboard.d.ts +0 -0
  565. /package/src/{training → experimental/training}/distillation/scoreboard.js +0 -0
  566. /package/src/{training → experimental/training}/distillation/stage-a.d.ts +0 -0
  567. /package/src/{training → experimental/training}/distillation/stage-a.js +0 -0
  568. /package/src/{training → experimental/training}/distillation/stage-b.d.ts +0 -0
  569. /package/src/{training → experimental/training}/distillation/stage-b.js +0 -0
  570. /package/src/{training → experimental/training}/distillation/student-fixture.d.ts +0 -0
  571. /package/src/{training → experimental/training}/distillation/student-fixture.js +0 -0
  572. /package/src/{training → experimental/training}/distillation/suite-data.d.ts +0 -0
  573. /package/src/{training → experimental/training}/distillation/suite-data.js +0 -0
  574. /package/src/{training → experimental/training}/index.d.ts +0 -0
  575. /package/src/{training → experimental/training}/index.js +0 -0
  576. /package/src/{training → experimental/training}/lora-pipeline.d.ts +0 -0
  577. /package/src/{training → experimental/training}/objectives/base.d.ts +0 -0
  578. /package/src/{training → experimental/training}/objectives/base.js +0 -0
  579. /package/src/{training → experimental/training}/objectives/cross_entropy.d.ts +0 -0
  580. /package/src/{training → experimental/training}/objectives/cross_entropy.js +0 -0
  581. /package/src/{training → experimental/training}/objectives/distill_kd.d.ts +0 -0
  582. /package/src/{training → experimental/training}/objectives/distill_kd.js +0 -0
  583. /package/src/{training → experimental/training}/objectives/distill_triplet.d.ts +0 -0
  584. /package/src/{training → experimental/training}/objectives/distill_triplet.js +0 -0
  585. /package/src/{training → experimental/training}/objectives/index.d.ts +0 -0
  586. /package/src/{training → experimental/training}/objectives/index.js +0 -0
  587. /package/src/{training → experimental/training}/objectives/ul_stage1_joint.d.ts +0 -0
  588. /package/src/{training → experimental/training}/objectives/ul_stage1_joint.js +0 -0
  589. /package/src/{training → experimental/training}/objectives/ul_stage2_base.d.ts +0 -0
  590. /package/src/{training → experimental/training}/objectives/ul_stage2_base.js +0 -0
  591. /package/src/{training → experimental/training}/operator-artifacts.d.ts +0 -0
  592. /package/src/{training → experimental/training}/operator-command.d.ts +0 -0
  593. /package/src/{training → experimental/training}/operator-command.js +0 -0
  594. /package/src/{training → experimental/training}/operator-eval.d.ts +0 -0
  595. /package/src/{training → experimental/training}/operator-eval.js +0 -0
  596. /package/src/{training → experimental/training}/operator-scoreboard.d.ts +0 -0
  597. /package/src/{training → experimental/training}/operator-scoreboard.js +0 -0
  598. /package/src/{training → experimental/training}/suite.d.ts +0 -0
  599. /package/src/{training → experimental/training}/ul_schedule.js +0 -0
  600. /package/src/{training → experimental/training}/workload-packs/distill-translategemma-medium.json +0 -0
  601. /package/src/{training → experimental/training}/workload-packs/distill-translategemma-tiny.json +0 -0
  602. /package/src/{training → experimental/training}/workload-packs/lora-toy-medium.json +0 -0
  603. /package/src/{training → experimental/training}/workload-packs/lora-toy-tiny.json +0 -0
  604. /package/src/{training → experimental/training}/workload-packs/registry.json +0 -0
  605. /package/src/{training → experimental/training}/workload-packs/ul-training-medium.json +0 -0
  606. /package/src/{training → experimental/training}/workload-packs/ul-training-tiny.json +0 -0
  607. /package/src/{training → experimental/training}/workloads.d.ts +0 -0
@@ -20,9 +20,10 @@ struct Uniforms {
20
20
  vocab_size: u32, // Vocabulary size (for bounds checking)
21
21
  transpose: u32, // 1 if embeddings are [hidden_size, vocab_size] (GGUF layout), 0 otherwise
22
22
  index_offset: u32, // Starting index into indices buffer
23
+ input_hidden_size: u32, // Source embedding row width before hidden slicing
24
+ hidden_offset: u32, // Starting hidden dimension inside each embedding row
23
25
  _pad0: u32,
24
26
  _pad1: u32,
25
- _pad2: u32,
26
27
  }
27
28
 
28
29
  @group(0) @binding(0) var<uniform> u: Uniforms;
@@ -56,10 +57,11 @@ fn main(@builtin(global_invocation_id) gid: vec3<u32>) {
56
57
  // For GGUF layout [hidden_size, vocab_size]: offset = dim_idx * vocab_size + token_id
57
58
  // For standard layout [vocab_size, hidden_size]: offset = token_id * hidden_size + dim_idx
58
59
  var embed_offset: u32;
60
+ let source_dim = u.hidden_offset + dim_idx;
59
61
  if (u.transpose == 1u) {
60
- embed_offset = dim_idx * u.vocab_size + token_id;
62
+ embed_offset = source_dim * u.vocab_size + token_id;
61
63
  } else {
62
- embed_offset = token_id * u.hidden_size + dim_idx;
64
+ embed_offset = token_id * u.input_hidden_size + source_dim;
63
65
  }
64
66
  output[tid] = f32(embeddings[embed_offset]);
65
67
  }
@@ -136,6 +136,7 @@ export {
136
136
 
137
137
  // Scale (Element-wise Multiply by Scalar)
138
138
  export {
139
+ selectScaleKernel,
139
140
  runScale,
140
141
  recordScale,
141
142
  type ScaleOptions,
@@ -180,6 +181,12 @@ export {
180
181
  type DepthwiseConv2DOptions,
181
182
  } from './depthwise_conv2d.js';
182
183
 
184
+ export {
185
+ runDepthwiseConv1D,
186
+ recordDepthwiseConv1D,
187
+ type DepthwiseConv1DOptions,
188
+ } from './depthwise_conv1d.js';
189
+
183
190
  export {
184
191
  runGroupedPointwiseConv2D,
185
192
  recordGroupedPointwiseConv2D,
@@ -109,6 +109,7 @@ export {
109
109
 
110
110
  // Scale (Element-wise Multiply by Scalar)
111
111
  export {
112
+ selectScaleKernel,
112
113
  runScale,
113
114
  recordScale,
114
115
  } from './scale.js';
@@ -144,6 +145,11 @@ export {
144
145
  recordDepthwiseConv2D,
145
146
  } from './depthwise_conv2d.js';
146
147
 
148
+ export {
149
+ runDepthwiseConv1D,
150
+ recordDepthwiseConv1D,
151
+ } from './depthwise_conv1d.js';
152
+
147
153
  export {
148
154
  runGroupedPointwiseConv2D,
149
155
  recordGroupedPointwiseConv2D,
@@ -30,6 +30,7 @@ export const KERNEL_CONFIGS = Object.fromEntries(
30
30
  wgslOverrides: resolved.wgslOverrides,
31
31
  sharedMemory: resolved.sharedMemory,
32
32
  outputDtype: resolved.outputDtype ?? undefined,
33
+ weightDtype: resolved.weightDtype ?? undefined,
33
34
  variantMetadata: resolved.variantMetadata ?? undefined,
34
35
  },
35
36
  ];
@@ -6,9 +6,19 @@ import { selectRuleValue as selectKernelRuleValue } from './rule-registry.js';
6
6
 
7
7
 
8
8
  function resolveQuantizeVariant(mode) {
9
+ if (mode === 'turboquant_outlier') {
10
+ throw new Error(
11
+ 'TurboQuant outlier KV quantize is not supported yet. ' +
12
+ 'Outlier-mode high-precision buffers are not wired end to end.'
13
+ );
14
+ }
9
15
  return selectKernelRuleValue('kv_quantize', 'variant', { mode });
10
16
  }
11
17
 
18
+ function isTurboQuantMode(mode) {
19
+ return mode === 'turboquant' || mode === 'turboquant_prod';
20
+ }
21
+
12
22
 
13
23
  function createQuantizeUniformBuffer(device, recorder, params) {
14
24
  return createUniformBufferWithView(
@@ -28,7 +38,52 @@ function createQuantizeUniformBuffer(device, recorder, params) {
28
38
  }
29
39
 
30
40
 
31
- export async function runKVQuantize(
41
+ function buildTurboQuantBindEntries(uniformBuffer, keys, values, outputKeys, outputValues, scalesK, scalesV, options) {
42
+ const entries = [
43
+ { binding: 0, resource: { buffer: uniformBuffer } },
44
+ { binding: 1, resource: { buffer: keys } },
45
+ { binding: 2, resource: { buffer: values } },
46
+ { binding: 3, resource: { buffer: outputKeys } },
47
+ { binding: 4, resource: { buffer: outputValues } },
48
+ { binding: 5, resource: { buffer: scalesK } },
49
+ { binding: 6, resource: { buffer: scalesV } },
50
+ { binding: 7, resource: { buffer: options.rotationMatrixBuffer } },
51
+ { binding: 8, resource: { buffer: options.codebookBoundariesBuffer } },
52
+ ];
53
+
54
+ if (options.mode === 'turboquant_prod') {
55
+ // Prod mode: bindings 7-14 (residual + rotation + codebook + QJL)
56
+ entries.length = 7;
57
+ entries.push(
58
+ { binding: 7, resource: { buffer: options.residualKBuffer } },
59
+ { binding: 8, resource: { buffer: options.residualVBuffer } },
60
+ { binding: 9, resource: { buffer: options.residualNormsKBuffer } },
61
+ { binding: 10, resource: { buffer: options.residualNormsVBuffer } },
62
+ { binding: 11, resource: { buffer: options.rotationMatrixBuffer } },
63
+ { binding: 12, resource: { buffer: options.codebookCentroidsBuffer } },
64
+ { binding: 13, resource: { buffer: options.codebookBoundariesBuffer } },
65
+ { binding: 14, resource: { buffer: options.qjlMatrixBuffer } },
66
+ );
67
+ }
68
+ return entries;
69
+ }
70
+
71
+
72
+ function dispatchQuantize(device, pipeline, bindGroup, workgroups, uniformBuffer, recorder) {
73
+ if (recorder) {
74
+ recordDispatch(recorder, pipeline, bindGroup, workgroups, 'kv_quantize');
75
+ } else {
76
+ try {
77
+ dispatch(device, pipeline, bindGroup, workgroups, 'kv_quantize');
78
+ } finally {
79
+ uniformBuffer.destroy();
80
+ }
81
+ }
82
+ }
83
+
84
+
85
+ async function executeKVQuantize(
86
+ recorder,
32
87
  keys,
33
88
  values,
34
89
  outputKeys,
@@ -37,7 +92,7 @@ export async function runKVQuantize(
37
92
  scalesV,
38
93
  options = {}
39
94
  ) {
40
- const device = getDevice();
95
+ const device = recorder?.device || getDevice();
41
96
  const {
42
97
  numKVHeads,
43
98
  headDim,
@@ -55,7 +110,7 @@ export async function runKVQuantize(
55
110
  }
56
111
 
57
112
  const pipeline = await createPipeline('kv_quantize', variant);
58
- const uniformBuffer = createQuantizeUniformBuffer(device, null, {
113
+ const uniformBuffer = createQuantizeUniformBuffer(device, recorder, {
59
114
  numKVHeads,
60
115
  headDim,
61
116
  startPos,
@@ -63,10 +118,13 @@ export async function runKVQuantize(
63
118
  packedStride,
64
119
  });
65
120
 
66
- const bindGroup = device.createBindGroup({
67
- label: 'kv_quantize_bind_group',
68
- layout: pipeline.getBindGroupLayout(0),
69
- entries: [
121
+ let entries;
122
+ if (isTurboQuantMode(mode)) {
123
+ entries = buildTurboQuantBindEntries(
124
+ uniformBuffer, keys, values, outputKeys, outputValues, scalesK, scalesV, options
125
+ );
126
+ } else {
127
+ entries = [
70
128
  { binding: 0, resource: { buffer: uniformBuffer } },
71
129
  { binding: 1, resource: { buffer: keys } },
72
130
  { binding: 2, resource: { buffer: values } },
@@ -74,20 +132,21 @@ export async function runKVQuantize(
74
132
  { binding: 4, resource: { buffer: outputValues } },
75
133
  { binding: 5, resource: { buffer: scalesK } },
76
134
  { binding: 6, resource: { buffer: scalesV } },
77
- ],
135
+ ];
136
+ }
137
+
138
+ const bindGroup = device.createBindGroup({
139
+ label: 'kv_quantize_bind_group',
140
+ layout: pipeline.getBindGroupLayout(0),
141
+ entries,
78
142
  });
79
143
 
80
144
  const workgroups = [numKVHeads, numTokens, 1];
81
- try {
82
- dispatch(device, pipeline, bindGroup, workgroups, 'kv_quantize');
83
- } finally {
84
- uniformBuffer.destroy();
85
- }
145
+ dispatchQuantize(device, pipeline, bindGroup, workgroups, uniformBuffer, recorder);
86
146
  }
87
147
 
88
148
 
89
- export async function recordKVQuantize(
90
- recorder,
149
+ export async function runKVQuantize(
91
150
  keys,
92
151
  values,
93
152
  outputKeys,
@@ -96,46 +155,19 @@ export async function recordKVQuantize(
96
155
  scalesV,
97
156
  options = {}
98
157
  ) {
99
- const device = recorder.device;
100
- const {
101
- numKVHeads,
102
- headDim,
103
- startPos,
104
- numTokens,
105
- packedStride,
106
- mode = 'int8',
107
- } = options;
108
-
109
- const variant = resolveQuantizeVariant(mode);
110
- const config = getKernelConfig('kv_quantize', variant);
111
- const caps = getKernelCapabilities();
112
- if (!hasRequiredFeatures(config.requires, caps)) {
113
- throw new Error(`KV quantize kernel "${variant}" requires unsupported GPU features.`);
114
- }
115
-
116
- const pipeline = await createPipeline('kv_quantize', variant);
117
- const uniformBuffer = createQuantizeUniformBuffer(device, recorder, {
118
- numKVHeads,
119
- headDim,
120
- startPos,
121
- numTokens,
122
- packedStride,
123
- });
158
+ return executeKVQuantize(null, keys, values, outputKeys, outputValues, scalesK, scalesV, options);
159
+ }
124
160
 
125
- const bindGroup = device.createBindGroup({
126
- label: 'kv_quantize_bind_group',
127
- layout: pipeline.getBindGroupLayout(0),
128
- entries: [
129
- { binding: 0, resource: { buffer: uniformBuffer } },
130
- { binding: 1, resource: { buffer: keys } },
131
- { binding: 2, resource: { buffer: values } },
132
- { binding: 3, resource: { buffer: outputKeys } },
133
- { binding: 4, resource: { buffer: outputValues } },
134
- { binding: 5, resource: { buffer: scalesK } },
135
- { binding: 6, resource: { buffer: scalesV } },
136
- ],
137
- });
138
161
 
139
- const workgroups = [numKVHeads, numTokens, 1];
140
- recordDispatch(recorder, pipeline, bindGroup, workgroups, 'kv_quantize');
162
+ export async function recordKVQuantize(
163
+ recorder,
164
+ keys,
165
+ values,
166
+ outputKeys,
167
+ outputValues,
168
+ scalesK,
169
+ scalesV,
170
+ options = {}
171
+ ) {
172
+ return executeKVQuantize(recorder, keys, values, outputKeys, outputValues, scalesK, scalesV, options);
141
173
  }
@@ -0,0 +1,153 @@
1
+ // TurboQuant KV Quantization Kernel (MSE-optimal, no outlier)
2
+ //
3
+ // Applies random rotation Π, then scalar-quantizes each coordinate via
4
+ // Max-Lloyd codebook lookup. Stores packed indices + L2 norm as scale.
5
+
6
+ enable f16;
7
+
8
+ const MAX_WORKGROUP_SIZE: u32 = 256u;
9
+ const MAX_HEAD_DIM: u32 = 256u;
10
+
11
+ override WORKGROUP_SIZE: u32 = 256u;
12
+ override BIT_WIDTH: u32 = 4u;
13
+ override PACK_FACTOR: u32 = 8u;
14
+ override NUM_CENTROIDS: u32 = 16u;
15
+ override NUM_BOUNDARIES: u32 = 15u;
16
+
17
+ struct Uniforms {
18
+ num_kv_heads: u32,
19
+ head_dim: u32,
20
+ start_pos: u32,
21
+ num_tokens: u32,
22
+ packed_stride: u32,
23
+ _pad0: u32,
24
+ _pad1: u32,
25
+ _pad2: u32,
26
+ }
27
+
28
+ @group(0) @binding(0) var<uniform> u: Uniforms;
29
+ @group(0) @binding(1) var<storage, read> input_k: array<f16>;
30
+ @group(0) @binding(2) var<storage, read> input_v: array<f16>;
31
+ @group(0) @binding(3) var<storage, read_write> output_k: array<u32>;
32
+ @group(0) @binding(4) var<storage, read_write> output_v: array<u32>;
33
+ @group(0) @binding(5) var<storage, read_write> scales_k: array<f16>;
34
+ @group(0) @binding(6) var<storage, read_write> scales_v: array<f16>;
35
+ @group(0) @binding(7) var<storage, read> rotation_matrix: array<f32>;
36
+ @group(0) @binding(8) var<storage, read> codebook_boundaries: array<f32>;
37
+
38
+ var<workgroup> shared_k: array<f32, MAX_HEAD_DIM>;
39
+ var<workgroup> shared_v: array<f32, MAX_HEAD_DIM>;
40
+ var<workgroup> shared_rotated_k: array<f32, MAX_HEAD_DIM>;
41
+ var<workgroup> shared_rotated_v: array<f32, MAX_HEAD_DIM>;
42
+ var<workgroup> shared_qk: array<u32, MAX_HEAD_DIM>;
43
+ var<workgroup> shared_qv: array<u32, MAX_HEAD_DIM>;
44
+ var<workgroup> shared_norm_k: f32;
45
+ var<workgroup> shared_norm_v: f32;
46
+
47
+ fn quantize_scalar(val: f32, num_boundaries: u32, boundaries_offset: u32) -> u32 {
48
+ var idx: u32 = 0u;
49
+ for (var b: u32 = 0u; b < num_boundaries; b++) {
50
+ if (val > codebook_boundaries[boundaries_offset + b]) {
51
+ idx = b + 1u;
52
+ }
53
+ }
54
+ return idx;
55
+ }
56
+
57
+ @compute @workgroup_size(WORKGROUP_SIZE, 1, 1)
58
+ fn main(
59
+ @builtin(local_invocation_id) local_id: vec3<u32>,
60
+ @builtin(workgroup_id) workgroup_id: vec3<u32>,
61
+ ) {
62
+ let head_idx = workgroup_id.x;
63
+ let token_idx = workgroup_id.y;
64
+ let tid = local_id.x;
65
+ let head_dim = u.head_dim;
66
+
67
+ if (head_idx >= u.num_kv_heads || token_idx >= u.num_tokens) {
68
+ return;
69
+ }
70
+ if (head_dim > MAX_HEAD_DIM) {
71
+ return;
72
+ }
73
+
74
+ let valid = tid < head_dim;
75
+ let token_base = token_idx * u.num_kv_heads + head_idx;
76
+ let input_base = token_base * head_dim;
77
+
78
+ // Step 1: Load K/V into shared memory
79
+ if (valid) {
80
+ shared_k[tid] = f32(input_k[input_base + tid]);
81
+ shared_v[tid] = f32(input_v[input_base + tid]);
82
+ }
83
+ workgroupBarrier();
84
+
85
+ // Step 2: Compute L2 norms (thread 0 reduces)
86
+ if (tid == 0u) {
87
+ var sum_k: f32 = 0.0;
88
+ var sum_v: f32 = 0.0;
89
+ for (var d: u32 = 0u; d < head_dim; d++) {
90
+ sum_k += shared_k[d] * shared_k[d];
91
+ sum_v += shared_v[d] * shared_v[d];
92
+ }
93
+ shared_norm_k = sqrt(sum_k);
94
+ shared_norm_v = sqrt(sum_v);
95
+ }
96
+ workgroupBarrier();
97
+
98
+ let norm_k = shared_norm_k;
99
+ let norm_v = shared_norm_v;
100
+ let inv_norm_k = select(0.0, 1.0 / norm_k, norm_k > 0.0);
101
+ let inv_norm_v = select(0.0, 1.0 / norm_v, norm_v > 0.0);
102
+
103
+ // Step 3: Apply rotation Π and normalize to unit vector
104
+ if (valid) {
105
+ var rot_k: f32 = 0.0;
106
+ var rot_v: f32 = 0.0;
107
+ let row_base = tid * head_dim;
108
+ for (var j: u32 = 0u; j < head_dim; j++) {
109
+ let pi_val = rotation_matrix[row_base + j];
110
+ rot_k += pi_val * shared_k[j] * inv_norm_k;
111
+ rot_v += pi_val * shared_v[j] * inv_norm_v;
112
+ }
113
+ shared_rotated_k[tid] = rot_k;
114
+ shared_rotated_v[tid] = rot_v;
115
+ }
116
+ workgroupBarrier();
117
+
118
+ // Step 4: Scalar quantize each rotated coordinate
119
+ if (valid) {
120
+ shared_qk[tid] = quantize_scalar(shared_rotated_k[tid], NUM_BOUNDARIES, 0u);
121
+ shared_qv[tid] = quantize_scalar(shared_rotated_v[tid], NUM_BOUNDARIES, 0u);
122
+ }
123
+ workgroupBarrier();
124
+
125
+ // Step 5: Pack low-bit indices into u32
126
+ let out_token = u.start_pos + token_idx;
127
+ let packed_base = (out_token * u.num_kv_heads + head_idx) * u.packed_stride;
128
+
129
+ if (valid && (tid % PACK_FACTOR) == 0u) {
130
+ let pack_idx = tid / PACK_FACTOR;
131
+ if (pack_idx < u.packed_stride) {
132
+ var packed_k: u32 = 0u;
133
+ var packed_v: u32 = 0u;
134
+ let bit_mask = (1u << BIT_WIDTH) - 1u;
135
+ for (var i: u32 = 0u; i < PACK_FACTOR; i++) {
136
+ let lane = tid + i;
137
+ if (lane < head_dim) {
138
+ packed_k |= (shared_qk[lane] & bit_mask) << (BIT_WIDTH * i);
139
+ packed_v |= (shared_qv[lane] & bit_mask) << (BIT_WIDTH * i);
140
+ }
141
+ }
142
+ output_k[packed_base + pack_idx] = packed_k;
143
+ output_v[packed_base + pack_idx] = packed_v;
144
+ }
145
+ }
146
+
147
+ // Step 6: Store L2 norms as scales
148
+ if (tid == 0u) {
149
+ let scale_idx = out_token * u.num_kv_heads + head_idx;
150
+ scales_k[scale_idx] = f16(norm_k);
151
+ scales_v[scale_idx] = f16(norm_v);
152
+ }
153
+ }
@@ -0,0 +1,230 @@
1
+ // TurboQuant KV Quantization Kernel (TURBOQUANTprod)
2
+ //
3
+ // Two-stage quantization for unbiased inner products:
4
+ // Stage 1: MSE-optimal scalar quantization at (b-1) bits
5
+ // Stage 2: 1-bit QJL transform on the residual
6
+ // Total: b bits per coordinate.
7
+
8
+ enable f16;
9
+
10
+ const MAX_WORKGROUP_SIZE: u32 = 256u;
11
+ const MAX_HEAD_DIM: u32 = 256u;
12
+
13
+ override WORKGROUP_SIZE: u32 = 256u;
14
+ override BIT_WIDTH_MSE: u32 = 3u;
15
+ override PACK_FACTOR_MSE: u32 = 10u;
16
+ override NUM_CENTROIDS_MSE: u32 = 8u;
17
+ override NUM_BOUNDARIES_MSE: u32 = 7u;
18
+
19
+ struct Uniforms {
20
+ num_kv_heads: u32,
21
+ head_dim: u32,
22
+ start_pos: u32,
23
+ num_tokens: u32,
24
+ packed_stride_mse: u32,
25
+ packed_stride_residual: u32,
26
+ _pad0: u32,
27
+ _pad1: u32,
28
+ }
29
+
30
+ @group(0) @binding(0) var<uniform> u: Uniforms;
31
+ @group(0) @binding(1) var<storage, read> input_k: array<f16>;
32
+ @group(0) @binding(2) var<storage, read> input_v: array<f16>;
33
+ // Stage 1 (MSE) outputs:
34
+ @group(0) @binding(3) var<storage, read_write> output_k_mse: array<u32>;
35
+ @group(0) @binding(4) var<storage, read_write> output_v_mse: array<u32>;
36
+ @group(0) @binding(5) var<storage, read_write> scales_k: array<f16>;
37
+ @group(0) @binding(6) var<storage, read_write> scales_v: array<f16>;
38
+ // Stage 2 (QJL 1-bit residual) outputs:
39
+ @group(0) @binding(7) var<storage, read_write> residual_k: array<u32>;
40
+ @group(0) @binding(8) var<storage, read_write> residual_v: array<u32>;
41
+ @group(0) @binding(9) var<storage, read_write> residual_norms_k: array<f16>;
42
+ @group(0) @binding(10) var<storage, read_write> residual_norms_v: array<f16>;
43
+ // Shared data:
44
+ @group(0) @binding(11) var<storage, read> rotation_matrix: array<f32>;
45
+ @group(0) @binding(12) var<storage, read> codebook_centroids: array<f32>;
46
+ @group(0) @binding(13) var<storage, read> codebook_boundaries: array<f32>;
47
+ @group(0) @binding(14) var<storage, read> qjl_matrix: array<f32>;
48
+
49
+ var<workgroup> shared_k: array<f32, MAX_HEAD_DIM>;
50
+ var<workgroup> shared_v: array<f32, MAX_HEAD_DIM>;
51
+ var<workgroup> shared_rotated_k: array<f32, MAX_HEAD_DIM>;
52
+ var<workgroup> shared_rotated_v: array<f32, MAX_HEAD_DIM>;
53
+ var<workgroup> shared_residual_k: array<f32, MAX_HEAD_DIM>;
54
+ var<workgroup> shared_residual_v: array<f32, MAX_HEAD_DIM>;
55
+ var<workgroup> shared_qk: array<u32, MAX_HEAD_DIM>;
56
+ var<workgroup> shared_qv: array<u32, MAX_HEAD_DIM>;
57
+ var<workgroup> shared_norm_k: f32;
58
+ var<workgroup> shared_norm_v: f32;
59
+ var<workgroup> shared_rnorm_k: f32;
60
+ var<workgroup> shared_rnorm_v: f32;
61
+
62
+ fn quantize_scalar(val: f32) -> u32 {
63
+ var idx: u32 = 0u;
64
+ for (var b: u32 = 0u; b < NUM_BOUNDARIES_MSE; b++) {
65
+ if (val > codebook_boundaries[b]) {
66
+ idx = b + 1u;
67
+ }
68
+ }
69
+ return idx;
70
+ }
71
+
72
+ fn dequant_centroid(idx: u32) -> f32 {
73
+ return codebook_centroids[idx];
74
+ }
75
+
76
+ @compute @workgroup_size(WORKGROUP_SIZE, 1, 1)
77
+ fn main(
78
+ @builtin(local_invocation_id) local_id: vec3<u32>,
79
+ @builtin(workgroup_id) workgroup_id: vec3<u32>,
80
+ ) {
81
+ let head_idx = workgroup_id.x;
82
+ let token_idx = workgroup_id.y;
83
+ let tid = local_id.x;
84
+ let head_dim = u.head_dim;
85
+
86
+ if (head_idx >= u.num_kv_heads || token_idx >= u.num_tokens) {
87
+ return;
88
+ }
89
+ if (head_dim > MAX_HEAD_DIM) {
90
+ return;
91
+ }
92
+
93
+ let valid = tid < head_dim;
94
+ let token_base = token_idx * u.num_kv_heads + head_idx;
95
+ let input_base = token_base * head_dim;
96
+
97
+ // Step 1: Load K/V
98
+ if (valid) {
99
+ shared_k[tid] = f32(input_k[input_base + tid]);
100
+ shared_v[tid] = f32(input_v[input_base + tid]);
101
+ }
102
+ workgroupBarrier();
103
+
104
+ // Step 2: Compute L2 norms
105
+ if (tid == 0u) {
106
+ var sum_k: f32 = 0.0;
107
+ var sum_v: f32 = 0.0;
108
+ for (var d: u32 = 0u; d < head_dim; d++) {
109
+ sum_k += shared_k[d] * shared_k[d];
110
+ sum_v += shared_v[d] * shared_v[d];
111
+ }
112
+ shared_norm_k = sqrt(sum_k);
113
+ shared_norm_v = sqrt(sum_v);
114
+ }
115
+ workgroupBarrier();
116
+
117
+ let norm_k = shared_norm_k;
118
+ let norm_v = shared_norm_v;
119
+ let inv_norm_k = select(0.0, 1.0 / norm_k, norm_k > 0.0);
120
+ let inv_norm_v = select(0.0, 1.0 / norm_v, norm_v > 0.0);
121
+
122
+ // Step 3: Apply rotation Π and normalize
123
+ if (valid) {
124
+ var rot_k: f32 = 0.0;
125
+ var rot_v: f32 = 0.0;
126
+ let row_base = tid * head_dim;
127
+ for (var j: u32 = 0u; j < head_dim; j++) {
128
+ let pi_val = rotation_matrix[row_base + j];
129
+ rot_k += pi_val * shared_k[j] * inv_norm_k;
130
+ rot_v += pi_val * shared_v[j] * inv_norm_v;
131
+ }
132
+ shared_rotated_k[tid] = rot_k;
133
+ shared_rotated_v[tid] = rot_v;
134
+ }
135
+ workgroupBarrier();
136
+
137
+ // Step 4: Stage 1 — MSE-optimal quantization at (b-1) bits
138
+ if (valid) {
139
+ let qk_idx = quantize_scalar(shared_rotated_k[tid]);
140
+ let qv_idx = quantize_scalar(shared_rotated_v[tid]);
141
+ shared_qk[tid] = qk_idx;
142
+ shared_qv[tid] = qv_idx;
143
+
144
+ // Compute residual: r = rotated - dequant(quant(rotated))
145
+ shared_residual_k[tid] = shared_rotated_k[tid] - dequant_centroid(qk_idx);
146
+ shared_residual_v[tid] = shared_rotated_v[tid] - dequant_centroid(qv_idx);
147
+ }
148
+ workgroupBarrier();
149
+
150
+ // Step 5: Pack MSE indices
151
+ let out_token = u.start_pos + token_idx;
152
+ let mse_packed_base = (out_token * u.num_kv_heads + head_idx) * u.packed_stride_mse;
153
+
154
+ if (valid && (tid % PACK_FACTOR_MSE) == 0u) {
155
+ let pack_idx = tid / PACK_FACTOR_MSE;
156
+ if (pack_idx < u.packed_stride_mse) {
157
+ var packed_k: u32 = 0u;
158
+ var packed_v: u32 = 0u;
159
+ let bit_mask = (1u << BIT_WIDTH_MSE) - 1u;
160
+ for (var i: u32 = 0u; i < PACK_FACTOR_MSE; i++) {
161
+ let lane = tid + i;
162
+ let qk = select(0u, shared_qk[lane], lane < head_dim);
163
+ let qv = select(0u, shared_qv[lane], lane < head_dim);
164
+ packed_k |= (qk & bit_mask) << (BIT_WIDTH_MSE * i);
165
+ packed_v |= (qv & bit_mask) << (BIT_WIDTH_MSE * i);
166
+ }
167
+ output_k_mse[mse_packed_base + pack_idx] = packed_k;
168
+ output_v_mse[mse_packed_base + pack_idx] = packed_v;
169
+ }
170
+ }
171
+
172
+ // Step 6: Stage 2 — 1-bit QJL on residual
173
+ // Compute P * residual and store sign bits
174
+ // Each thread computes one projected coordinate and contributes 1 sign bit
175
+ if (valid) {
176
+ var proj_k: f32 = 0.0;
177
+ var proj_v: f32 = 0.0;
178
+ let row_base = tid * head_dim;
179
+ for (var j: u32 = 0u; j < head_dim; j++) {
180
+ let p_val = qjl_matrix[row_base + j];
181
+ proj_k += p_val * shared_residual_k[j];
182
+ proj_v += p_val * shared_residual_v[j];
183
+ }
184
+ // Store sign bit: 1 = positive, 0 = negative
185
+ shared_qk[tid] = select(0u, 1u, proj_k >= 0.0);
186
+ shared_qv[tid] = select(0u, 1u, proj_v >= 0.0);
187
+ }
188
+ workgroupBarrier();
189
+
190
+ // Compute residual norms (thread 0)
191
+ if (tid == 0u) {
192
+ var rnorm_k: f32 = 0.0;
193
+ var rnorm_v: f32 = 0.0;
194
+ for (var d: u32 = 0u; d < head_dim; d++) {
195
+ rnorm_k += shared_residual_k[d] * shared_residual_k[d];
196
+ rnorm_v += shared_residual_v[d] * shared_residual_v[d];
197
+ }
198
+ shared_rnorm_k = sqrt(rnorm_k);
199
+ shared_rnorm_v = sqrt(rnorm_v);
200
+ }
201
+ workgroupBarrier();
202
+
203
+ // Pack 1-bit signs into u32 (32 signs per u32)
204
+ let residual_packed_base = (out_token * u.num_kv_heads + head_idx) * u.packed_stride_residual;
205
+ if (tid == 0u) {
206
+ let num_words = u.packed_stride_residual;
207
+ for (var w: u32 = 0u; w < num_words; w++) {
208
+ var packed_k: u32 = 0u;
209
+ var packed_v: u32 = 0u;
210
+ for (var b: u32 = 0u; b < 32u; b++) {
211
+ let d = w * 32u + b;
212
+ if (d < head_dim) {
213
+ packed_k |= (shared_qk[d] << b);
214
+ packed_v |= (shared_qv[d] << b);
215
+ }
216
+ }
217
+ residual_k[residual_packed_base + w] = packed_k;
218
+ residual_v[residual_packed_base + w] = packed_v;
219
+ }
220
+ }
221
+
222
+ // Store norms
223
+ if (tid == 0u) {
224
+ let scale_idx = out_token * u.num_kv_heads + head_idx;
225
+ scales_k[scale_idx] = f16(norm_k);
226
+ scales_v[scale_idx] = f16(norm_v);
227
+ residual_norms_k[scale_idx] = f16(shared_rnorm_k);
228
+ residual_norms_v[scale_idx] = f16(shared_rnorm_v);
229
+ }
230
+ }
@@ -1,5 +1,6 @@
1
1
  import type { Tensor } from '../tensor.js';
2
2
  import type { CommandRecorder } from '../command-recorder.js';
3
+ import type { ExecutionV1PoliciesSchema } from '../../config/schema/execution-v1.schema.js';
3
4
 
4
5
  export interface LinearAttentionCoreLayerState {
5
6
  convDim: number;
@@ -27,6 +28,8 @@ export interface RunLinearAttentionCoreGPUOptions {
27
28
  layerIdx?: number;
28
29
  qkL2NormEps?: number;
29
30
  recorder?: CommandRecorder | null;
31
+ outputDtype?: 'f16' | 'f32';
32
+ executionPolicies?: ExecutionV1PoliciesSchema | null;
30
33
  }
31
34
 
32
35
  export declare function runLinearAttentionCoreGPU(