doppler-gpu 0.2.0 → 0.2.2

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 +29 -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
@@ -17,7 +17,7 @@
17
17
  "linear_attn.in_proj_a.weight",
18
18
  "linear_attn.in_proj_b.weight"
19
19
  ],
20
- "computePrecision": "f32",
20
+ "computePrecision": "f16",
21
21
  "q4kLayout": "row"
22
22
  },
23
23
  "manifest": {
@@ -29,6 +29,7 @@
29
29
  "attnLogitSoftcapping": null,
30
30
  "slidingWindow": null,
31
31
  "queryKeyNorm": true,
32
+ "valueNorm": false,
32
33
  "causal": true,
33
34
  "attentionBias": false,
34
35
  "attentionOutputGate": true
@@ -43,6 +44,7 @@
43
44
  "ffn": {
44
45
  "activation": "silu",
45
46
  "gatedActivation": true,
47
+ "useDoubleWideMlp": false,
46
48
  "swigluLimit": null
47
49
  },
48
50
  "rope": {
@@ -55,6 +57,9 @@
55
57
  10
56
58
  ],
57
59
  "partialRotaryFactor": 0.25,
60
+ "ropeLocalPartialRotaryFactor": null,
61
+ "ropeFrequencyBaseDim": null,
62
+ "ropeLocalFrequencyBaseDim": null,
58
63
  "ropeScalingType": null,
59
64
  "ropeScalingFactor": 1,
60
65
  "ropeLocalScalingType": null,
@@ -111,27 +116,58 @@
111
116
  "enabled": true
112
117
  }
113
118
  },
114
- "sessionDefaults": {
119
+ "session": {
115
120
  "compute": {
116
121
  "defaults": {
117
- "activationDtype": "f32",
118
- "mathDtype": "f32",
119
- "accumDtype": "f32",
120
- "outputDtype": "f32"
122
+ "activationDtype": "f16",
123
+ "mathDtype": "f16",
124
+ "accumDtype": "f16",
125
+ "outputDtype": "f16"
121
126
  }
122
127
  },
123
128
  "kvcache": {
124
- "kvDtype": "f16"
129
+ "kvDtype": "f16",
130
+ "layout": "contiguous",
131
+ "maxSeqLen": 8192,
132
+ "pageSize": 256,
133
+ "tiering": {
134
+ "mode": "off"
135
+ }
125
136
  },
126
137
  "decodeLoop": {
127
- "batchSize": 4,
138
+ "batchSize": 8,
128
139
  "stopCheckMode": "batch",
129
- "readbackInterval": 1,
140
+ "readbackInterval": 32,
141
+ "readbackMode": "sequential",
142
+ "submitLatencyThresholdMs": null,
130
143
  "ringTokens": 1,
131
144
  "ringStop": 1,
132
145
  "ringStaging": 1,
133
146
  "disableCommandBatching": false
134
147
  },
148
+ "perLayerInputs": {
149
+ "materialization": "auto",
150
+ "rowCache": {
151
+ "mode": "lru",
152
+ "maxRows": 256,
153
+ "maxBytes": 134217728,
154
+ "decodedDtype": "f32"
155
+ },
156
+ "prefetch": {
157
+ "mode": "next_token",
158
+ "rowsAhead": 1
159
+ },
160
+ "gpuUpload": {
161
+ "mode": "per_step_slices",
162
+ "stagingRows": 2
163
+ },
164
+ "hotCache": {
165
+ "mode": "prepared_tokens",
166
+ "maxTokens": 1024,
167
+ "maxBytes": 134217728,
168
+ "outputDtype": "f32"
169
+ }
170
+ },
135
171
  "speculation": {
136
172
  "mode": "self",
137
173
  "tokens": 1,
@@ -149,66 +185,80 @@
149
185
  "digest": "sha256:257973dd762541d8a2c4b16ad8ad1d071199199e81e477ab644dce915961a989"
150
186
  },
151
187
  "rmsnorm": {
152
- "kernel": "rmsnorm.wgsl",
188
+ "kernel": "rmsnorm_f16.wgsl",
153
189
  "entry": "main",
154
- "digest": "sha256:f516b3e4bde2015f2a207c3ca5b8c9820c7809fa8f8d0786f90c568e0f1ac077"
190
+ "digest": "sha256:6ff712c215fa8ea07b653ad51666620854b4ed03b2371b1e97ba2322efdfa665"
155
191
  },
156
192
  "q4_decode": {
157
- "kernel": "fused_matmul_q4.wgsl",
158
- "entry": "main_multicol",
159
- "digest": "sha256:c0262226752914e863e8b5dc34479b523f9c93e2cef69c9057dcbde2b82854ef"
193
+ "kernel": "fused_matmul_q4_multicol_f16a.wgsl",
194
+ "entry": "main_multicol_f16a",
195
+ "digest": "sha256:eb13c120d8c9829adc8bbd45cc44774e9be9f8f14c5e37ea68d747ad41e2eb4b",
196
+ "precision": {
197
+ "inputDtype": "f16",
198
+ "outputDtype": "f16"
199
+ }
160
200
  },
161
201
  "rope": {
162
- "kernel": "rope.wgsl",
202
+ "kernel": "rope_f16.wgsl",
163
203
  "entry": "main",
164
- "digest": "sha256:4c803ad5e0dd065d5572c7aecc1def277c43884dcc02f22a9676914c10111400"
204
+ "digest": "sha256:26ab977df73442f99f3a70c8eb45681bfa12b3f8c4303313207aeb9c668ac044"
165
205
  },
166
206
  "attn_decode": {
167
- "kernel": "attention_decode_online_f16kv.wgsl",
207
+ "kernel": "attention_decode_online_f16.wgsl",
168
208
  "entry": "main",
169
- "digest": "sha256:4c5d8c92a0a111af716d6b46b9559446807c086027445c7fefa150202f43dae4"
209
+ "digest": "sha256:23ac23b33e1ca30bc6a0ebb90d1bcde0236604bf57217c1763186046e0fe03de",
210
+ "precision": {
211
+ "kvDtype": "f16"
212
+ }
170
213
  },
171
214
  "residual": {
172
- "kernel": "residual.wgsl",
215
+ "kernel": "residual_f16.wgsl",
173
216
  "entry": "main",
174
- "digest": "sha256:f1abd88c959c5d8dd27b9353d487e37b2a96850ed9d90c365212e260399cc2a7"
217
+ "digest": "sha256:5e843d5336d093da3c1bc042c39a570562e2744fce8e394bd57c3705076122c7"
175
218
  },
176
219
  "silu": {
177
- "kernel": "silu.wgsl",
220
+ "kernel": "silu_f16.wgsl",
178
221
  "entry": "main",
179
- "digest": "sha256:7b52d30fb741beef2dbf728e0c4ecffe5b08d9661d63c306caecb4cb3ced85e5",
222
+ "digest": "sha256:24ce5e7aba948b074b57953e8d9279196231d9d26732f30bc1199ce979d39941",
180
223
  "constants": {
181
224
  "HAS_GATE": true
182
225
  }
183
226
  },
184
227
  "q4_prefill": {
185
- "kernel": "fused_matmul_q4_batched.wgsl",
186
- "entry": "main_batched",
187
- "digest": "sha256:a513e4170792aaf2f1c22b73f34288721541acf5954756993a0001a412c91209"
228
+ "kernel": "fused_matmul_q4_batched_f16a.wgsl",
229
+ "entry": "main_batched_f16a",
230
+ "digest": "sha256:6f63a9c3b7c8b2ae8570987fb3314c1d8e5ab0b629c1ae1695ed2c45137c8564",
231
+ "precision": {
232
+ "inputDtype": "f16",
233
+ "outputDtype": "f16"
234
+ }
188
235
  },
189
236
  "tiled": {
190
- "kernel": "matmul_f16w_f32a.wgsl",
237
+ "kernel": "matmul_f16.wgsl",
191
238
  "entry": "main",
192
- "digest": "sha256:027a8f1cd9713cbe0b0ada160bd175e0542bb90896ad85441b023522d9a1befc"
239
+ "digest": "sha256:7e9f23f326b5750fc7783a1959334c237aff4a23da6f87176608c5c4eb4fc278"
193
240
  },
194
241
  "attn_stream": {
195
- "kernel": "attention_streaming_f16kv.wgsl",
242
+ "kernel": "attention_small_f16.wgsl",
196
243
  "entry": "main",
197
- "digest": "sha256:b337a2dcf7b40431a733d1726eee8bf23504136fd5f915bec057fb59f3ea7480"
244
+ "digest": "sha256:83f15e3d360f6425c13fc9fa9d0aab04c1de3616447de576eb0c5a6c89cfc4d0",
245
+ "precision": {
246
+ "kvDtype": "f16"
247
+ }
198
248
  },
199
249
  "lm_head_gemv": {
200
- "kernel": "matmul_gemv_subgroup.wgsl",
250
+ "kernel": "matmul_gemv_subgroup_f16a.wgsl",
201
251
  "entry": "main_multicol",
202
- "digest": "sha256:96c38c15e6fed0d7efdc5cd094db5843a8e8ddfe01eee3bc7322fa555dacf3d0",
252
+ "digest": "sha256:cc31df534551ba5dd7feebbddb2822d1c53f7d6a98fd0d772c294620602b51e5",
203
253
  "constants": {
204
254
  "MULTICOL_COLS_PER_WG": 64,
205
255
  "MULTICOL_THREADS_PER_COL": 4
206
256
  }
207
257
  },
208
258
  "sample": {
209
- "kernel": "sample.wgsl",
259
+ "kernel": "sample_f16.wgsl",
210
260
  "entry": "sample_single_pass",
211
- "digest": "sha256:4412357e84113ee2f1bc0dc8bf89e314c2ab482c89c14ca016ea9949d16a9d0c"
261
+ "digest": "sha256:ac0bacc17b3efb877b8b69a21a529f2ef2b21dd3307e3a7ce12f8cc0f785e275"
212
262
  }
213
263
  },
214
264
  "preLayer": [
@@ -21,7 +21,8 @@
21
21
  "queryKeyNorm": false,
22
22
  "causal": false,
23
23
  "attentionBias": false,
24
- "attentionOutputGate": false
24
+ "attentionOutputGate": false,
25
+ "valueNorm": false
25
26
  },
26
27
  "normalization": {
27
28
  "rmsNormEps": 0.00001,
@@ -33,7 +34,8 @@
33
34
  "ffn": {
34
35
  "activation": "silu",
35
36
  "gatedActivation": false,
36
- "swigluLimit": null
37
+ "swigluLimit": null,
38
+ "useDoubleWideMlp": false
37
39
  },
38
40
  "rope": {
39
41
  "ropeTheta": null,
@@ -50,7 +52,10 @@
50
52
  "yarnOriginalMaxPos": null,
51
53
  "ropeLocalYarnBetaFast": null,
52
54
  "ropeLocalYarnBetaSlow": null,
53
- "ropeLocalYarnOriginalMaxPos": null
55
+ "ropeLocalYarnOriginalMaxPos": null,
56
+ "ropeLocalPartialRotaryFactor": null,
57
+ "ropeFrequencyBaseDim": null,
58
+ "ropeLocalFrequencyBaseDim": null
54
59
  },
55
60
  "output": {
56
61
  "finalLogitSoftcapping": null,
@@ -71,7 +76,7 @@
71
76
  "enabled": false
72
77
  }
73
78
  },
74
- "sessionDefaults": {
79
+ "session": {
75
80
  "compute": {
76
81
  "defaults": {
77
82
  "activationDtype": "f16",
@@ -81,7 +86,30 @@
81
86
  }
82
87
  },
83
88
  "kvcache": null,
84
- "decodeLoop": null
89
+ "decodeLoop": null,
90
+ "perLayerInputs": {
91
+ "materialization": "auto",
92
+ "rowCache": {
93
+ "mode": "lru",
94
+ "maxRows": 256,
95
+ "maxBytes": 134217728,
96
+ "decodedDtype": "f32"
97
+ },
98
+ "prefetch": {
99
+ "mode": "next_token",
100
+ "rowsAhead": 1
101
+ },
102
+ "gpuUpload": {
103
+ "mode": "per_step_slices",
104
+ "stagingRows": 2
105
+ },
106
+ "hotCache": {
107
+ "mode": "prepared_tokens",
108
+ "maxTokens": 1024,
109
+ "maxBytes": 134217728,
110
+ "outputDtype": "f32"
111
+ }
112
+ }
85
113
  },
86
114
  "execution": {
87
115
  "kernels": {
@@ -11,7 +11,8 @@ export interface ExecutionContractSessionFacts {
11
11
  decodeBatchSize: number;
12
12
  headDim: number;
13
13
  kvLen: number;
14
- coldQuantMode: 'none' | 'int8' | 'int4';
14
+ coldQuantMode: 'none' | 'int8' | 'int4' | 'turboquant' | 'turboquant_prod';
15
+ contiguousQuantMode: 'none' | 'turboquant' | 'turboquant_prod';
15
16
  }
16
17
 
17
18
  export interface ExecutionContractFacts {
@@ -1,15 +1,28 @@
1
- import { DEFAULT_BATCHING_DEFAULTS, DEFAULT_GENERATION_CONFIG } from './schema/inference-defaults.schema.js';
2
- import { DEFAULT_KVCACHE_CONFIG } from './schema/kvcache.schema.js';
1
+ import { getKernelConfig } from '../gpu/kernels/kernel-configs.js';
2
+ import { selectRuleValue as selectKernelRuleValue } from '../gpu/kernels/rule-registry.js';
3
+ import { EXECUTION_V1_SCHEMA_ID, expandExecutionV1 } from './schema/index.js';
3
4
 
4
5
  const KV_LAYOUTS = new Set(['contiguous', 'paged', 'tiered', 'bdpa']);
5
6
  const PHASES = new Set(['prefill', 'decode', 'both']);
6
- const COLD_QUANT_MODES = new Set(['none', 'int8', 'int4']);
7
+ const TIERED_QUANT_MODES = new Set([
8
+ 'none',
9
+ 'int8',
10
+ 'int4',
11
+ 'turboquant',
12
+ 'turboquant_prod',
13
+ ]);
14
+ const CONTIGUOUS_QUANT_MODES = new Set([
15
+ 'none',
16
+ 'turboquant',
17
+ 'turboquant_prod',
18
+ ]);
7
19
  const ATTENTION_OPS = new Set(['attention']);
8
20
  const EMBED_OPS = new Set(['embed', 'gather']);
9
21
  const SAMPLE_OPS = new Set(['sample']);
10
22
  const BDPA_MAX_HEAD_DIM = 256;
11
23
  const BDPA_MAX_KV_LEN = 2048;
12
- const TIERED_MAX_QUANT_HEAD_DIM = 256;
24
+ const QUANTIZED_KV_MAX_HEAD_DIM = 256;
25
+ const UNSUPPORTED_TURBOQUANT_OUTLIER_MODE = 'turboquant_outlier';
13
26
 
14
27
  function isPlainObject(value) {
15
28
  return value != null && typeof value === 'object' && !Array.isArray(value);
@@ -29,15 +42,33 @@ function assertPositiveInteger(value, label) {
29
42
  return value;
30
43
  }
31
44
 
32
- function assertPositiveIntegerOrDefault(value, fallback, label) {
45
+ function assertRequiredValue(value, label) {
33
46
  if (value == null) {
34
- return assertPositiveInteger(fallback, `${label} fallback`);
47
+ throw new Error(`execution contract: ${label} is required.`);
35
48
  }
36
- return assertPositiveInteger(value, label);
49
+ return value;
50
+ }
51
+
52
+ function assertSupportedTurboQuantMode(mode, label) {
53
+ if (mode !== UNSUPPORTED_TURBOQUANT_OUTLIER_MODE) {
54
+ return mode;
55
+ }
56
+ throw new Error(
57
+ `execution contract: ${label}="${mode}" is not supported. ` +
58
+ 'TurboQuant outlier high-precision buffers and decode kernels are not wired end to end; ' +
59
+ 'use "turboquant" or "turboquant_prod".'
60
+ );
61
+ }
62
+
63
+ function assertBoolean(value, label) {
64
+ if (value !== true && value !== false) {
65
+ throw new Error(`execution contract: ${label} must be boolean.`);
66
+ }
67
+ return value;
37
68
  }
38
69
 
39
70
  function normalizeKVLayout(value) {
40
- const normalized = String(value ?? DEFAULT_KVCACHE_CONFIG.layout).trim().toLowerCase();
71
+ const normalized = String(assertRequiredValue(value, 'session.kvcache.layout')).trim().toLowerCase();
41
72
  if (!KV_LAYOUTS.has(normalized)) {
42
73
  throw new Error(
43
74
  `execution contract: unsupported KV layout "${value}". ` +
@@ -57,20 +88,85 @@ function normalizePhase(value, label) {
57
88
  return normalized;
58
89
  }
59
90
 
60
- function normalizeColdQuantMode(kvcache) {
61
- const tieringMode = String(
62
- kvcache?.tiering?.mode
63
- ?? DEFAULT_KVCACHE_CONFIG.tiering.mode
64
- ).trim().toLowerCase();
65
- if (tieringMode === 'off' || tieringMode === 'fp16') {
91
+ function getRequiredVariantMaxKVLen(operation, variant, errorLabel) {
92
+ const config = getKernelConfig(operation, variant);
93
+ const maxKVLen = config.variantMetadata?.maxKVLen;
94
+ if (!Number.isFinite(maxKVLen) || maxKVLen <= 0) {
95
+ throw new Error(`execution contract: kernel ${errorLabel} "${variant}" is missing variantMetadata.maxKVLen.`);
96
+ }
97
+ return maxKVLen;
98
+ }
99
+
100
+ function getTieredQuantMaxKVLen(mode) {
101
+ const variant = selectKernelRuleValue('attention', 'tieredQuantVariant', { mode });
102
+ return getRequiredVariantMaxKVLen(
103
+ 'attention_tiered_quant',
104
+ variant,
105
+ 'attention_tiered_quant'
106
+ );
107
+ }
108
+
109
+ function getContiguousQuantMaxKVLen(mode) {
110
+ const variant = selectKernelRuleValue('attention', 'contiguousQuantVariant', { mode });
111
+ return getRequiredVariantMaxKVLen(
112
+ 'attention_contiguous_quant',
113
+ variant,
114
+ 'attention_contiguous_quant'
115
+ );
116
+ }
117
+
118
+ function normalizeTieredQuantMode(kvcache) {
119
+ const tieringMode = String(kvcache?.tiering?.mode ?? 'off').trim().toLowerCase();
120
+ assertSupportedTurboQuantMode(tieringMode, 'session.kvcache.tiering.mode');
121
+ const gatingMode = String(kvcache?.tiering?.gating?.mode ?? 'auto').trim().toLowerCase();
122
+ if (gatingMode === 'force_off' || tieringMode === 'off' || tieringMode === 'fp16') {
66
123
  return 'none';
67
124
  }
68
- if (!COLD_QUANT_MODES.has(tieringMode)) {
125
+ const compressionMode = String(
126
+ kvcache?.tiering?.compression?.mode
127
+ ?? (tieringMode === 'int8'
128
+ || tieringMode === 'int4'
129
+ || tieringMode === 'turboquant'
130
+ || tieringMode === 'turboquant_prod'
131
+ ? tieringMode
132
+ : 'none')
133
+ ).trim().toLowerCase();
134
+ assertSupportedTurboQuantMode(compressionMode, 'session.kvcache.tiering.compression.mode');
135
+ if (!TIERED_QUANT_MODES.has(compressionMode)) {
69
136
  throw new Error(
70
- `execution contract: unsupported tiered cold quant mode "${tieringMode}".`
137
+ `execution contract: unsupported tiered cold quant mode "${compressionMode}".`
71
138
  );
72
139
  }
73
- return tieringMode;
140
+ return compressionMode;
141
+ }
142
+
143
+ function normalizeContiguousQuantMode(kvcache) {
144
+ const quantMode = String(kvcache?.quantization?.mode ?? 'none').trim().toLowerCase();
145
+ assertSupportedTurboQuantMode(quantMode, 'session.kvcache.quantization.mode');
146
+ if (!CONTIGUOUS_QUANT_MODES.has(quantMode)) {
147
+ throw new Error(
148
+ `execution contract: unsupported contiguous quant mode "${quantMode}".`
149
+ );
150
+ }
151
+ return quantMode;
152
+ }
153
+
154
+ function resolveSessionKVLen(architectureMaxSeqLen, sessionMaxSeqLen) {
155
+ const architectureKVLen = assertPositiveInteger(
156
+ assertRequiredValue(
157
+ architectureMaxSeqLen ?? sessionMaxSeqLen,
158
+ 'architecture.maxSeqLen'
159
+ ),
160
+ 'architecture.maxSeqLen'
161
+ );
162
+ if (sessionMaxSeqLen == null) {
163
+ return architectureKVLen;
164
+ }
165
+ const sessionKVLen = assertPositiveInteger(sessionMaxSeqLen, 'session.kvcache.maxSeqLen');
166
+ if (sessionKVLen <= 0) {
167
+ throw new Error('execution contract: session.kvcache.maxSeqLen must be greater than zero.');
168
+ }
169
+ return Math.min(architectureKVLen, sessionKVLen);
74
170
  }
75
171
 
76
172
  function classifyOp(op) {
@@ -110,21 +206,20 @@ export function extractExecutionContractFacts(manifest) {
110
206
  const inference = isPlainObject(normalizedManifest.inference)
111
207
  ? normalizedManifest.inference
112
208
  : {};
113
- const sessionDefaults = isPlainObject(inference.sessionDefaults)
114
- ? inference.sessionDefaults
115
- : {};
209
+ const session = isPlainObject(inference.session) ? inference.session : {};
116
210
  const execution = isPlainObject(inference.execution)
117
211
  ? inference.execution
118
212
  : {};
119
- const kvcache = isPlainObject(sessionDefaults.kvcache)
120
- ? sessionDefaults.kvcache
213
+ const kvcache = isPlainObject(session.kvcache)
214
+ ? session.kvcache
121
215
  : {};
122
- const decodeLoop = isPlainObject(sessionDefaults.decodeLoop)
123
- ? sessionDefaults.decodeLoop
216
+ const decodeLoop = isPlainObject(session.decodeLoop)
217
+ ? session.decodeLoop
124
218
  : {};
125
219
 
126
- const steps = Array.isArray(execution.steps)
127
- ? execution.steps.map((step, index) => {
220
+ let steps = [];
221
+ if (Array.isArray(execution.steps)) {
222
+ steps = execution.steps.map((step, index) => {
128
223
  if (!isPlainObject(step)) {
129
224
  throw new Error(`execution contract: execution.steps[${index}] must be an object.`);
130
225
  }
@@ -137,27 +232,35 @@ export function extractExecutionContractFacts(manifest) {
137
232
  phase: normalizePhase(step.phase, `execution.steps[${index}].phase`),
138
233
  opClass: classifyOp(step.op),
139
234
  };
140
- })
141
- : [];
235
+ });
236
+ } else if (
237
+ inference.schema === EXECUTION_V1_SCHEMA_ID
238
+ && isPlainObject(execution.kernels)
239
+ ) {
240
+ const expanded = expandExecutionV1(execution);
241
+ steps = expanded.map((step, index) => ({
242
+ id: `${step.section}_${step.phase}_${index}_${step.op}`,
243
+ phase: normalizePhase(step.phase, `execution graph step ${index} phase`),
244
+ opClass: classifyOp(step.op),
245
+ }));
246
+ }
142
247
 
143
248
  return {
144
249
  modelId,
145
250
  session: {
146
251
  layout: normalizeKVLayout(kvcache.layout),
147
- disableCommandBatching: decodeLoop.disableCommandBatching
148
- ?? DEFAULT_GENERATION_CONFIG.disableCommandBatching,
149
- decodeBatchSize: assertPositiveIntegerOrDefault(
150
- decodeLoop.batchSize,
151
- DEFAULT_BATCHING_DEFAULTS.batchSize,
152
- 'sessionDefaults.decodeLoop.batchSize'
252
+ disableCommandBatching: assertBoolean(
253
+ decodeLoop.disableCommandBatching,
254
+ 'session.decodeLoop.disableCommandBatching'
153
255
  ),
154
- headDim: assertPositiveInteger(architecture.headDim, 'architecture.headDim'),
155
- kvLen: assertPositiveIntegerOrDefault(
156
- architecture.maxSeqLen ?? kvcache.maxSeqLen,
157
- DEFAULT_KVCACHE_CONFIG.maxSeqLen,
158
- 'architecture.maxSeqLen'
256
+ decodeBatchSize: assertPositiveInteger(
257
+ assertRequiredValue(decodeLoop.batchSize, 'session.decodeLoop.batchSize'),
258
+ 'session.decodeLoop.batchSize'
159
259
  ),
160
- coldQuantMode: normalizeColdQuantMode(kvcache),
260
+ headDim: assertPositiveInteger(architecture.headDim, 'architecture.headDim'),
261
+ kvLen: resolveSessionKVLen(architecture.maxSeqLen, kvcache.maxSeqLen),
262
+ coldQuantMode: normalizeTieredQuantMode(kvcache),
263
+ contiguousQuantMode: normalizeContiguousQuantMode(kvcache),
161
264
  },
162
265
  steps,
163
266
  };
@@ -175,7 +278,7 @@ export function validateExecutionContractFacts(facts) {
175
278
  : null;
176
279
  if (incompatibleStep) {
177
280
  errors.push(
178
- `[ExecutionContract] sessionDefaults.kvcache.layout="bdpa" is decode-only, ` +
281
+ `[ExecutionContract] session.kvcache.layout="bdpa" is decode-only, ` +
179
282
  `but step "${incompatibleStep.id}" declares ${incompatibleStep.phase} attention.`
180
283
  );
181
284
  }
@@ -188,25 +291,25 @@ export function validateExecutionContractFacts(facts) {
188
291
  if (session.layout === 'bdpa') {
189
292
  if (session.disableCommandBatching !== true) {
190
293
  errors.push(
191
- '[ExecutionContract] sessionDefaults.kvcache.layout="bdpa" requires ' +
192
- 'sessionDefaults.decodeLoop.disableCommandBatching=true.'
294
+ '[ExecutionContract] session.kvcache.layout="bdpa" requires ' +
295
+ 'session.decodeLoop.disableCommandBatching=true.'
193
296
  );
194
297
  }
195
298
  if (session.decodeBatchSize > 1) {
196
299
  errors.push(
197
- `[ExecutionContract] sessionDefaults.kvcache.layout="bdpa" requires ` +
198
- `sessionDefaults.decodeLoop.batchSize <= 1; got ${session.decodeBatchSize}.`
300
+ `[ExecutionContract] session.kvcache.layout="bdpa" requires ` +
301
+ `session.decodeLoop.batchSize <= 1; got ${session.decodeBatchSize}.`
199
302
  );
200
303
  }
201
304
  if (session.headDim > BDPA_MAX_HEAD_DIM) {
202
305
  errors.push(
203
- `[ExecutionContract] sessionDefaults.kvcache.layout="bdpa" requires architecture.headDim <= ${BDPA_MAX_HEAD_DIM}; ` +
306
+ `[ExecutionContract] session.kvcache.layout="bdpa" requires architecture.headDim <= ${BDPA_MAX_HEAD_DIM}; ` +
204
307
  `got ${session.headDim}.`
205
308
  );
206
309
  }
207
310
  if (session.kvLen > BDPA_MAX_KV_LEN) {
208
311
  errors.push(
209
- `[ExecutionContract] sessionDefaults.kvcache.layout="bdpa" requires architecture.maxSeqLen <= ${BDPA_MAX_KV_LEN}; ` +
312
+ `[ExecutionContract] session.kvcache.layout="bdpa" requires architecture.maxSeqLen <= ${BDPA_MAX_KV_LEN}; ` +
210
313
  `got ${session.kvLen}.`
211
314
  );
212
315
  }
@@ -215,12 +318,39 @@ export function validateExecutionContractFacts(facts) {
215
318
  if (
216
319
  session.layout === 'tiered'
217
320
  && session.coldQuantMode !== 'none'
218
- && session.headDim > TIERED_MAX_QUANT_HEAD_DIM
219
321
  ) {
220
- errors.push(
221
- `[ExecutionContract] sessionDefaults.kvcache.layout="tiered" with cold quantization requires ` +
222
- `architecture.headDim <= ${TIERED_MAX_QUANT_HEAD_DIM}; got ${session.headDim}.`
223
- );
322
+ if (session.headDim > QUANTIZED_KV_MAX_HEAD_DIM) {
323
+ errors.push(
324
+ `[ExecutionContract] session.kvcache.layout="tiered" with cold quantization requires ` +
325
+ `architecture.headDim <= ${QUANTIZED_KV_MAX_HEAD_DIM}; got ${session.headDim}.`
326
+ );
327
+ }
328
+ const maxKVLen = getTieredQuantMaxKVLen(session.coldQuantMode);
329
+ if (session.kvLen > maxKVLen) {
330
+ errors.push(
331
+ `[ExecutionContract] session.kvcache.layout="tiered" with cold quantization requires ` +
332
+ `effective maxSeqLen <= ${maxKVLen}; got ${session.kvLen}.`
333
+ );
334
+ }
335
+ }
336
+
337
+ if (
338
+ session.layout === 'contiguous'
339
+ && session.contiguousQuantMode !== 'none'
340
+ ) {
341
+ if (session.headDim > QUANTIZED_KV_MAX_HEAD_DIM) {
342
+ errors.push(
343
+ `[ExecutionContract] session.kvcache.layout="contiguous" with quantization.mode="${session.contiguousQuantMode}" ` +
344
+ `requires architecture.headDim <= ${QUANTIZED_KV_MAX_HEAD_DIM}; got ${session.headDim}.`
345
+ );
346
+ }
347
+ const maxKVLen = getContiguousQuantMaxKVLen(session.contiguousQuantMode);
348
+ if (session.kvLen > maxKVLen) {
349
+ errors.push(
350
+ `[ExecutionContract] session.kvcache.layout="contiguous" with quantization.mode="${session.contiguousQuantMode}" ` +
351
+ `requires effective maxSeqLen <= ${maxKVLen}; got ${session.kvLen}.`
352
+ );
353
+ }
224
354
  }
225
355
 
226
356
  checks.push({
@@ -248,7 +378,11 @@ export function buildExecutionContractArtifact(manifest) {
248
378
  if (!manifest || typeof manifest !== 'object') {
249
379
  return null;
250
380
  }
251
- if (manifest.modelType === 'diffusion' || manifest.modelType === 'energy') {
381
+ if (
382
+ manifest.modelType === 'diffusion'
383
+ || manifest.modelType === 'energy'
384
+ || manifest.modelType === 'embedding'
385
+ ) {
252
386
  return null;
253
387
  }
254
388
  if (!manifest.architecture || !manifest.inference || typeof manifest.inference !== 'object') {
@@ -89,12 +89,48 @@ export function getKernelPathMatmulConstants(
89
89
  path?: KernelPathSchema | null
90
90
  ): Record<string, number | boolean> | null;
91
91
 
92
+ export function getKernelPathMatmulPrecision(
93
+ role: string | undefined,
94
+ phase: KernelPathPhase,
95
+ layerIndex?: number,
96
+ path?: KernelPathSchema | null
97
+ ): {
98
+ activationDtype?: 'f16' | 'f32';
99
+ kvDtype?: 'f16' | 'f32';
100
+ inputDtype?: 'f16' | 'f32';
101
+ outputDtype?: 'f16' | 'f32';
102
+ } | null;
103
+
104
+ export function getKernelPathStepPrecision(
105
+ op: string | undefined,
106
+ section: KernelPathSection,
107
+ phase: KernelPathPhase,
108
+ layerIndex?: number,
109
+ path?: KernelPathSchema | null
110
+ ): {
111
+ activationDtype?: 'f16' | 'f32';
112
+ kvDtype?: 'f16' | 'f32';
113
+ inputDtype?: 'f16' | 'f32';
114
+ outputDtype?: 'f16' | 'f32';
115
+ } | null;
116
+
92
117
  export function getKernelPathAttentionVariant(
93
118
  phase: KernelPathPhase,
94
119
  layerIndex?: number,
95
120
  path?: KernelPathSchema | null
96
121
  ): string | null;
97
122
 
123
+ export function getKernelPathAttentionPrecision(
124
+ phase: KernelPathPhase,
125
+ layerIndex?: number,
126
+ path?: KernelPathSchema | null
127
+ ): {
128
+ activationDtype?: 'f16' | 'f32';
129
+ kvDtype?: 'f16' | 'f32';
130
+ inputDtype?: 'f16' | 'f32';
131
+ outputDtype?: 'f16' | 'f32';
132
+ } | null;
133
+
98
134
  /**
99
135
  * Set the active kernel path for the current pipeline.
100
136
  * Called by Pipeline when resolving kernel path.