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
@@ -0,0 +1,502 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "source": "doppler",
4
+ "updatedAtUtc": "2026-04-13T00:00:00.000Z",
5
+ "subsystems": [
6
+ {
7
+ "id": "api.root-facade",
8
+ "label": "Root app-facing facade",
9
+ "scope": "api",
10
+ "tier": "tier1",
11
+ "owner": "client-surface",
12
+ "userFacing": true,
13
+ "demoDefault": false,
14
+ "exported": true,
15
+ "claimVisibility": "primary",
16
+ "packageExport": ".",
17
+ "command": null,
18
+ "docs": [
19
+ "README.md",
20
+ "docs/api/root.md"
21
+ ],
22
+ "entrypoints": [
23
+ "src/index.js",
24
+ "src/client/doppler-api.js"
25
+ ],
26
+ "notes": "Preferred public surface for application authors."
27
+ },
28
+ {
29
+ "id": "cli.quickstart",
30
+ "label": "Quickstart CLI",
31
+ "scope": "cli",
32
+ "tier": "tier1",
33
+ "owner": "client-surface",
34
+ "userFacing": true,
35
+ "demoDefault": false,
36
+ "exported": false,
37
+ "claimVisibility": "primary",
38
+ "packageExport": null,
39
+ "command": "doppler-gpu",
40
+ "docs": [
41
+ "README.md",
42
+ "docs/getting-started.md"
43
+ ],
44
+ "entrypoints": [
45
+ "src/cli/doppler-quickstart.js"
46
+ ],
47
+ "notes": "Canonical zero-install proof path for local text inference from the terminal."
48
+ },
49
+ {
50
+ "id": "cli.openai-compatible-server",
51
+ "label": "OpenAI-compatible localhost server",
52
+ "scope": "cli",
53
+ "tier": "tier1",
54
+ "owner": "tooling",
55
+ "userFacing": true,
56
+ "demoDefault": false,
57
+ "exported": false,
58
+ "claimVisibility": "primary",
59
+ "packageExport": null,
60
+ "command": "doppler-serve",
61
+ "docs": [
62
+ "README.md",
63
+ "docs/cli.md"
64
+ ],
65
+ "entrypoints": [
66
+ "src/cli/doppler-serve.js"
67
+ ],
68
+ "notes": "Compatibility bridge for existing OpenAI-style apps and eval workflows."
69
+ },
70
+ {
71
+ "id": "demo.browser-workspace",
72
+ "label": "Hosted browser demo workspace",
73
+ "scope": "demo",
74
+ "tier": "tier1",
75
+ "owner": "demo",
76
+ "userFacing": true,
77
+ "demoDefault": true,
78
+ "exported": false,
79
+ "claimVisibility": "primary",
80
+ "packageExport": null,
81
+ "command": null,
82
+ "docs": [
83
+ "README.md",
84
+ "docs/getting-started.md"
85
+ ],
86
+ "entrypoints": [
87
+ "demo/index.html",
88
+ "demo/boot.js"
89
+ ],
90
+ "notes": "Canonical hosted proof surface for browser-native local text inference."
91
+ },
92
+ {
93
+ "id": "runtime.text-inference",
94
+ "label": "Text inference runtime",
95
+ "scope": "runtime",
96
+ "tier": "tier1",
97
+ "owner": "core-runtime",
98
+ "userFacing": true,
99
+ "demoDefault": true,
100
+ "exported": false,
101
+ "claimVisibility": "primary",
102
+ "packageExport": null,
103
+ "command": null,
104
+ "docs": [
105
+ "README.md",
106
+ "docs/architecture.md",
107
+ "docs/pipeline-contract.md"
108
+ ],
109
+ "entrypoints": [
110
+ "src/inference/pipelines/text.js",
111
+ "src/inference/pipelines/text/model-load.js"
112
+ ],
113
+ "notes": "Mainline runtime contract for verified browser and Node text generation workloads."
114
+ },
115
+ {
116
+ "id": "format.rdrr-runtime",
117
+ "label": "RDRR artifact runtime",
118
+ "scope": "format",
119
+ "tier": "tier1",
120
+ "owner": "model-io",
121
+ "userFacing": true,
122
+ "demoDefault": true,
123
+ "exported": false,
124
+ "claimVisibility": "secondary",
125
+ "packageExport": null,
126
+ "command": null,
127
+ "docs": [
128
+ "docs/rdrr-format.md",
129
+ "docs/architecture.md"
130
+ ],
131
+ "entrypoints": [
132
+ "src/formats/rdrr/manifest.js",
133
+ "src/storage/artifact-storage-context.js"
134
+ ],
135
+ "notes": "Primary artifact format for the verified quickstart and hosted model path."
136
+ },
137
+ {
138
+ "id": "format.direct-source-runtime",
139
+ "label": "Direct-source runtime inputs",
140
+ "scope": "format",
141
+ "tier": "experimental",
142
+ "owner": "model-io",
143
+ "userFacing": true,
144
+ "demoDefault": false,
145
+ "exported": false,
146
+ "claimVisibility": "secondary",
147
+ "packageExport": null,
148
+ "command": null,
149
+ "docs": [
150
+ "docs/rdrr-format.md",
151
+ "docs/architecture.md"
152
+ ],
153
+ "entrypoints": [
154
+ "src/tooling/source-artifact-adapter.js",
155
+ "src/client/runtime/source-runtime.js",
156
+ "src/tooling/litert-package-runtime.js"
157
+ ],
158
+ "notes": "Available direct-source path for safetensors, gguf, .tflite, .task, and .litertlm inputs, but not part of the quickstart or canonical demo proof."
159
+ },
160
+ {
161
+ "id": "api.loaders-subpath",
162
+ "label": "Loaders subpath",
163
+ "scope": "api",
164
+ "tier": "tier1",
165
+ "owner": "model-io",
166
+ "userFacing": true,
167
+ "demoDefault": false,
168
+ "exported": true,
169
+ "claimVisibility": "secondary",
170
+ "packageExport": "./loaders",
171
+ "command": null,
172
+ "docs": [
173
+ "docs/api/loaders.md",
174
+ "docs/api/advanced-root-exports.md"
175
+ ],
176
+ "entrypoints": [
177
+ "src/loaders/index.js"
178
+ ],
179
+ "notes": "Supported advanced surface for explicit loading flows beyond the root facade."
180
+ },
181
+ {
182
+ "id": "api.tooling-subpath",
183
+ "label": "Tooling subpath",
184
+ "scope": "api",
185
+ "tier": "tier1",
186
+ "owner": "tooling",
187
+ "userFacing": true,
188
+ "demoDefault": false,
189
+ "exported": true,
190
+ "claimVisibility": "secondary",
191
+ "packageExport": "./tooling",
192
+ "command": null,
193
+ "docs": [
194
+ "docs/api/tooling-experimental.md",
195
+ "docs/api/advanced-root-exports.md"
196
+ ],
197
+ "entrypoints": [
198
+ "src/tooling-exports.js",
199
+ "src/tooling/command-api.js"
200
+ ],
201
+ "notes": "Supported advanced surface for the tier1 command contract, diagnostics, storage, and registry tooling. Some helper groups exported on the same subpath remain experimental and are classified separately below."
202
+ },
203
+ {
204
+ "id": "api.tooling-browser-import-helpers",
205
+ "label": "Tooling browser import helpers",
206
+ "scope": "api",
207
+ "tier": "experimental",
208
+ "owner": "model-io",
209
+ "userFacing": true,
210
+ "demoDefault": false,
211
+ "exported": true,
212
+ "claimVisibility": "none",
213
+ "packageExport": "./tooling-experimental",
214
+ "command": null,
215
+ "docs": [
216
+ "docs/api/tooling-experimental.md",
217
+ "docs/api/advanced-root-exports.md"
218
+ ],
219
+ "entrypoints": [
220
+ "src/tooling-exports.shared.js",
221
+ "src/experimental/browser/browser-converter.js"
222
+ ],
223
+ "notes": "Browser conversion and file-picker helpers ship on the dedicated tooling-experimental subpath for advanced workflows, but they are not part of the tier1 quickstart or demo-default contract."
224
+ },
225
+ {
226
+ "id": "api.tooling-p2p-helpers",
227
+ "label": "Tooling P2P helpers",
228
+ "scope": "api",
229
+ "tier": "experimental",
230
+ "owner": "distribution",
231
+ "userFacing": true,
232
+ "demoDefault": false,
233
+ "exported": true,
234
+ "claimVisibility": "none",
235
+ "packageExport": "./tooling-experimental",
236
+ "command": null,
237
+ "docs": [
238
+ "docs/api/tooling.md",
239
+ "docs/api/advanced-root-exports.md"
240
+ ],
241
+ "entrypoints": [
242
+ "src/tooling-exports.shared.js",
243
+ "src/experimental/distribution/p2p-control-plane.js"
244
+ ],
245
+ "notes": "P2P and distribution helpers are exported on the dedicated tooling-experimental subpath for advanced tooling flows, but they remain outside the current tier1 local text inference story."
246
+ },
247
+ {
248
+ "id": "api.tooling-operator-commands",
249
+ "label": "Tooling operator commands",
250
+ "scope": "api",
251
+ "tier": "experimental",
252
+ "owner": "research-runtime",
253
+ "userFacing": true,
254
+ "demoDefault": false,
255
+ "exported": true,
256
+ "claimVisibility": "none",
257
+ "packageExport": "./tooling",
258
+ "command": null,
259
+ "docs": [
260
+ "docs/api/tooling.md"
261
+ ],
262
+ "entrypoints": [
263
+ "src/tooling/node-command-runner.js",
264
+ "src/experimental/training/index.js"
265
+ ],
266
+ "notes": "Node-only `diagnose`, `lora`, and `distill` operator flows share the tooling contract surface, but they are still experimental research/operator lanes rather than tier1 product behavior."
267
+ },
268
+ {
269
+ "id": "api.generation-subpath",
270
+ "label": "Generation subpath",
271
+ "scope": "api",
272
+ "tier": "tier1",
273
+ "owner": "core-runtime",
274
+ "userFacing": true,
275
+ "demoDefault": false,
276
+ "exported": true,
277
+ "claimVisibility": "secondary",
278
+ "packageExport": "./generation",
279
+ "command": null,
280
+ "docs": [
281
+ "docs/api/generation.md",
282
+ "docs/api/advanced-root-exports.md"
283
+ ],
284
+ "entrypoints": [
285
+ "src/generation/index.js",
286
+ "src/inference/pipelines/text.js"
287
+ ],
288
+ "notes": "Supported advanced surface for direct text-pipeline construction."
289
+ },
290
+ {
291
+ "id": "api.orchestration-subpath",
292
+ "label": "Orchestration subpath",
293
+ "scope": "api",
294
+ "tier": "experimental",
295
+ "owner": "client-surface",
296
+ "userFacing": true,
297
+ "demoDefault": false,
298
+ "exported": true,
299
+ "claimVisibility": "secondary",
300
+ "packageExport": "./orchestration",
301
+ "command": null,
302
+ "docs": [
303
+ "docs/api/orchestration.md",
304
+ "docs/api/advanced-root-exports.md"
305
+ ],
306
+ "entrypoints": [
307
+ "src/experimental/orchestration/index.js"
308
+ ],
309
+ "notes": "Mixed advanced surface for adapters, routers, heads, and multi-model helpers; available, but not part of the mainline proof story."
310
+ },
311
+ {
312
+ "id": "runtime.lora-hot-swap",
313
+ "label": "LoRA hot-swap",
314
+ "scope": "runtime",
315
+ "tier": "experimental",
316
+ "owner": "client-surface",
317
+ "userFacing": true,
318
+ "demoDefault": false,
319
+ "exported": false,
320
+ "claimVisibility": "primary",
321
+ "packageExport": null,
322
+ "command": null,
323
+ "docs": [
324
+ "README.md",
325
+ "docs/api/root.md"
326
+ ],
327
+ "entrypoints": [
328
+ "src/experimental/adapters/lora-loader.js",
329
+ "src/experimental/adapters/adapter-manager.js"
330
+ ],
331
+ "notes": "User-visible adapter swap capability that remains outside the canonical quickstart and demo-default proof path."
332
+ },
333
+ {
334
+ "id": "runtime.multi-model-orchestration",
335
+ "label": "Multi-model orchestration",
336
+ "scope": "runtime",
337
+ "tier": "experimental",
338
+ "owner": "client-surface",
339
+ "userFacing": true,
340
+ "demoDefault": false,
341
+ "exported": false,
342
+ "claimVisibility": "secondary",
343
+ "packageExport": null,
344
+ "command": null,
345
+ "docs": [
346
+ "docs/architecture.md",
347
+ "docs/api/orchestration.md"
348
+ ],
349
+ "entrypoints": [
350
+ "src/inference/multi-model-network.js",
351
+ "src/experimental/orchestration/index.js"
352
+ ],
353
+ "notes": "Available for advanced experimentation, but not part of the tier1 demo or quickstart contract."
354
+ },
355
+ {
356
+ "id": "runtime.hotswap-bundles",
357
+ "label": "Runtime hotswap bundle system",
358
+ "scope": "runtime",
359
+ "tier": "experimental",
360
+ "owner": "runtime-policy",
361
+ "userFacing": false,
362
+ "demoDefault": false,
363
+ "exported": false,
364
+ "claimVisibility": "none",
365
+ "packageExport": null,
366
+ "command": null,
367
+ "docs": [
368
+ "docs/architecture.md"
369
+ ],
370
+ "entrypoints": [
371
+ "src/experimental/hotswap/runtime.js",
372
+ "src/experimental/hotswap/model-swap.js"
373
+ ],
374
+ "notes": "Checked-in experimental runtime machinery, not part of the public package contract."
375
+ },
376
+ {
377
+ "id": "runtime.distribution-p2p",
378
+ "label": "P2P and shard distribution runtime",
379
+ "scope": "runtime",
380
+ "tier": "experimental",
381
+ "owner": "distribution",
382
+ "userFacing": false,
383
+ "demoDefault": false,
384
+ "exported": false,
385
+ "claimVisibility": "none",
386
+ "packageExport": null,
387
+ "command": null,
388
+ "docs": [
389
+ "docs/architecture.md"
390
+ ],
391
+ "entrypoints": [
392
+ "src/experimental/distribution/shard-delivery.js",
393
+ "src/experimental/distribution/p2p-control-plane.js"
394
+ ],
395
+ "notes": "Strategic distribution lane that exists in the repo but is not part of the public tier1 runtime claim set."
396
+ },
397
+ {
398
+ "id": "api.diffusion-subpath",
399
+ "label": "Diffusion API subpath",
400
+ "scope": "api",
401
+ "tier": "experimental",
402
+ "owner": "research-runtime",
403
+ "userFacing": true,
404
+ "demoDefault": false,
405
+ "exported": true,
406
+ "claimVisibility": "none",
407
+ "packageExport": "./diffusion",
408
+ "command": null,
409
+ "docs": [
410
+ "docs/api/diffusion.md"
411
+ ],
412
+ "entrypoints": [
413
+ "src/experimental/diffusion/index.js"
414
+ ],
415
+ "notes": "Shipped advanced surface for diffusion/image workflows, outside the main tier1 local text inference story."
416
+ },
417
+ {
418
+ "id": "api.energy-subpath",
419
+ "label": "Energy API subpath",
420
+ "scope": "api",
421
+ "tier": "experimental",
422
+ "owner": "research-runtime",
423
+ "userFacing": true,
424
+ "demoDefault": false,
425
+ "exported": true,
426
+ "claimVisibility": "none",
427
+ "packageExport": "./energy",
428
+ "command": null,
429
+ "docs": [
430
+ "docs/api/energy.md"
431
+ ],
432
+ "entrypoints": [
433
+ "src/experimental/energy/index.js"
434
+ ],
435
+ "notes": "Shipped specialized surface, but not part of the mainline README or demo-default claim set."
436
+ },
437
+ {
438
+ "id": "runtime.training-and-distillation",
439
+ "label": "Training and distillation surfaces",
440
+ "scope": "runtime",
441
+ "tier": "experimental",
442
+ "owner": "research-runtime",
443
+ "userFacing": true,
444
+ "demoDefault": false,
445
+ "exported": false,
446
+ "claimVisibility": "none",
447
+ "packageExport": null,
448
+ "command": null,
449
+ "docs": [
450
+ "docs/training-handbook.md",
451
+ "src/experimental/training/README.md"
452
+ ],
453
+ "entrypoints": [
454
+ "src/experimental/training/index.js",
455
+ "src/experimental/training/distillation/index.js"
456
+ ],
457
+ "notes": "Repo-supported research and operator lane, but not part of the current tier1 app/runtime contract."
458
+ },
459
+ {
460
+ "id": "integration.bridge-layer",
461
+ "label": "Bridge and extension integration layer",
462
+ "scope": "integration",
463
+ "tier": "internal-only",
464
+ "owner": "integration",
465
+ "userFacing": false,
466
+ "demoDefault": false,
467
+ "exported": false,
468
+ "claimVisibility": "none",
469
+ "packageExport": null,
470
+ "command": null,
471
+ "docs": [
472
+ "docs/architecture.md"
473
+ ],
474
+ "entrypoints": [
475
+ "src/experimental/bridge/index.js",
476
+ "src/experimental/bridge/extension-client.js"
477
+ ],
478
+ "notes": "Repo integration machinery, not part of the public package or hosted demo contract."
479
+ },
480
+ {
481
+ "id": "browser.import-helpers",
482
+ "label": "Browser import and conversion helpers",
483
+ "scope": "browser",
484
+ "tier": "internal-only",
485
+ "owner": "model-io",
486
+ "userFacing": false,
487
+ "demoDefault": false,
488
+ "exported": false,
489
+ "claimVisibility": "none",
490
+ "packageExport": null,
491
+ "command": null,
492
+ "docs": [
493
+ "docs/architecture.md"
494
+ ],
495
+ "entrypoints": [
496
+ "src/experimental/browser/browser-converter.js",
497
+ "src/experimental/browser/tensor-source-http.js"
498
+ ],
499
+ "notes": "Repo-internal browser import plumbing that supports the demo and tooling flows."
500
+ }
501
+ ]
502
+ }
@@ -22,13 +22,24 @@ export interface ResolvedTransforms {
22
22
  export declare function resolveCapabilityTransforms(
23
23
  capabilities: TransformContext['capabilities'],
24
24
  platform: TransformContext['platform'],
25
- graphContext: { activationDtype: string; kvDtype: string }
25
+ graphContext: {
26
+ activationDtype: string;
27
+ kvDtype: string;
28
+ modelId?: string;
29
+ layerTypes?: string[] | null;
30
+ hasDensePrefillProjectionKernel?: boolean;
31
+ hasQ4DecodeProjectionKernel?: boolean;
32
+ hasQ4PrefillProjectionKernel?: boolean;
33
+ hasAvailableQ4PrefillProjectionKernel?: boolean;
34
+ requiresF16ActivationNarrowing?: boolean;
35
+ }
26
36
  ): ResolvedTransforms;
27
37
 
28
38
  /**
29
- * Resolve the finiteness fallback transform (widenToF32Activations when activation is f16).
30
- * Returns null when already f32 (no fallback available).
39
+ * Resolve the explicit alternate-plan transform for finiteness handling
40
+ * (widenToF32Activations when activation is f16).
41
+ * Returns null when already f32 (no alternate plan available).
31
42
  */
32
43
  export declare function resolveFinitenessFallbackTransform(
33
- activationDtype: string
34
- ): ExecutionGraphTransform | null;
44
+ graphContext: { activationDtype: string; kvDtype: string; modelId?: string; layerTypes?: string[] | null }
45
+ ): { transform: ExecutionGraphTransform; name: string } | null;
@@ -13,13 +13,36 @@ const rules = await loadJson(
13
13
  * determine which transforms need to be applied.
14
14
  *
15
15
  * @param {Object} capabilities - { hasSubgroups, hasF16, hasSubgroupsF16, maxWorkgroupSize, maxBufferSize }
16
+ * `hasSubgroupsF16` is a derived convenience bit (`hasSubgroups && hasF16`), not a separate WebGPU feature.
16
17
  * @param {Object} platform - { id, vendor, architecture }
17
- * @param {Object} graphContext - { activationDtype, kvDtype }
18
+ * @param {Object} graphContext - execution-v1 graph/dtype summary
19
+ * { activationDtype, kvDtype, modelId?, layerTypes?,
20
+ * hasDensePrefillProjectionKernel?,
21
+ * hasQ4DecodeProjectionKernel?, hasQ4PrefillProjectionKernel?,
22
+ * hasAvailableQ4PrefillProjectionKernel? }
18
23
  * @returns {{ transforms: Function[], names: string[], reason: string }}
19
24
  */
20
25
  export function resolveCapabilityTransforms(capabilities, platform, graphContext) {
26
+ const normalizedGraphContext = graphContext ?? {};
27
+ const matchContext = {
28
+ ...capabilities,
29
+ ...normalizedGraphContext,
30
+ activationDtype: normalizedGraphContext.activationDtype ?? null,
31
+ kvDtype: normalizedGraphContext.kvDtype ?? null,
32
+ modelId: normalizedGraphContext.modelId ?? 'unknown',
33
+ platformId: platform?.id ?? 'unknown',
34
+ platformVendor: platform?.vendor
35
+ ?? platform?.detection?.vendor
36
+ ?? capabilities?.adapterInfo?.vendor
37
+ ?? 'unknown',
38
+ platformArchitecture: platform?.architecture
39
+ ?? platform?.detection?.architecture
40
+ ?? capabilities?.adapterInfo?.architecture
41
+ ?? 'unknown',
42
+ };
43
+
21
44
  for (const rule of rules.capabilityTransforms) {
22
- if (matchesRule(rule.match, capabilities)) {
45
+ if (matchesRule(rule.match, matchContext)) {
23
46
  const transforms = rule.transforms.map(name => {
24
47
  const fn = TRANSFORMS[name];
25
48
  if (!fn) {
@@ -40,22 +63,34 @@ export function resolveCapabilityTransforms(capabilities, platform, graphContext
40
63
 
41
64
  throw new Error(
42
65
  'CapabilityTransformResolver: no rule matched capabilities ' +
43
- JSON.stringify(capabilities)
66
+ JSON.stringify(matchContext)
44
67
  );
45
68
  }
46
69
 
47
70
  /**
48
- * Returns widenToF32Activations when current activationDtype is f16,
49
- * or null when already f32 (no fallback available).
71
+ * Returns the safest alternate-plan widening transform for an f16 primary plan.
72
+ *
73
+ * Large-head models such as Gemma 4 E2B use decode attention geometry that the
74
+ * generic full-f32 decode kernel cannot execute. On shader-f16 hardware, keep
75
+ * KV on the f16 lane and widen activations only so the fallback plan stays
76
+ * executable for headDim > 64.
50
77
  *
51
- * @param {Object} graphContext - { activationDtype, kvDtype }
52
- * @returns {{ transform: Function, name: string } | null}
78
+ * @param {Object} graphContext - { activationDtype, kvDtype, headDim?, modelId?, layerTypes? }
79
+ * @returns {{ transform: Function, name: string, fallbackKvDtype: 'f16' | 'f32' } | null}
53
80
  */
54
81
  export function resolveFinitenessFallbackTransform(graphContext) {
55
82
  if (graphContext.activationDtype === 'f16') {
83
+ if (Number.isFinite(graphContext.headDim) && graphContext.headDim > 64) {
84
+ return {
85
+ transform: TRANSFORMS.widenToF32Activations,
86
+ name: 'widenToF32Activations',
87
+ fallbackKvDtype: 'f16',
88
+ };
89
+ }
56
90
  return {
57
- transform: TRANSFORMS.widenToF32Activations,
58
- name: 'widenToF32Activations',
91
+ transform: TRANSFORMS.widenToF32CorrectnessFallback,
92
+ name: 'widenToF32CorrectnessFallback',
93
+ fallbackKvDtype: 'f32',
59
94
  };
60
95
  }
61
96
  return null;