doppler-gpu 0.4.7 → 0.4.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (610) hide show
  1. package/CHANGELOG.md +64 -0
  2. package/README.md +93 -144
  3. package/models/catalog.json +1575 -0
  4. package/package.json +37 -12
  5. package/src/cli/doppler-cli.js +28 -7
  6. package/src/client/doppler-registry.json +2 -2
  7. package/src/client/runtime/index.js +25 -2
  8. package/src/client/runtime/model-session.d.ts +31 -1
  9. package/src/client/runtime/model-session.js +31 -0
  10. package/src/client/runtime/model-source.d.ts +19 -2
  11. package/src/client/runtime/model-source.js +45 -5
  12. package/src/config/conversion/gemma3/translategemma-4b-1b-enes-q4k-ehf16-af32.json +21 -5
  13. package/src/config/conversion/gemma3/translategemma-4b-it-q4k-ehf16-af32.json +6 -1
  14. package/src/config/conversion/gemma4/gemma-4-e2b-it-q4k-ehf16-af16-int4ple.json +1 -1
  15. package/src/config/conversion/qwen3/qwen-3-reranker-0-6b-q4k-ehf16-af32.json +9 -1
  16. package/src/config/kernel-path-loader.js +1 -0
  17. package/src/config/kernels/kernel-ref-digests.js +26 -17
  18. package/src/config/kernels/registry.json +448 -27
  19. package/src/config/merge.js +11 -0
  20. package/src/config/param-validator.js +25 -0
  21. package/src/config/runtime/default.json +3 -1
  22. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-attn128-candidate.json +20 -0
  23. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-maxbatch64-candidate.json +52 -0
  24. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-normed-ffn-candidate.json +18 -0
  25. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-overlap-ringtokens1-candidate.json +52 -0
  26. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-parity.json +85 -0
  27. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-sequential-candidate.json +52 -0
  28. package/src/config/runtime/profiles/qwen-3-5-0-8b-metal-throughput.json +85 -0
  29. package/src/config/runtime/profiles/qwen-3-5-2b-f16-primary-throughput.json +23 -0
  30. package/src/config/runtime/profiles/qwen-3-5-2b-metal-parity.json +38 -0
  31. package/src/config/runtime/profiles/qwen-3-5-2b-metal-throughput.json +135 -0
  32. package/src/config/runtime/profiles/qwen-3-embedding-0-6b-metal-stability.json +37 -0
  33. package/src/config/runtime/profiles/qwen-3-embedding-0-6b-metal-throughput.json +21 -0
  34. package/src/config/runtime/profiles/qwen-3-reranker-0-6b-metal-stability.json +41 -0
  35. package/src/config/runtime/profiles/qwen-3-reranker-0-6b-metal-throughput.json +41 -0
  36. package/src/config/runtime/profiles/rerank-stability.json +43 -0
  37. package/src/config/runtime/profiles/rerank-throughput.json +40 -0
  38. package/src/config/runtime/profiles/translategemma-1b-nativekd2-q4k-rdna3-throughput-probe.json +22 -0
  39. package/src/config/schema/doppler.schema.js +40 -5
  40. package/src/config/schema/execution-v1.schema.d.ts +41 -0
  41. package/src/config/schema/execution-v1.schema.js +10 -0
  42. package/src/config/schema/index.d.ts +3 -1
  43. package/src/config/schema/speculation-self.schema.d.ts +16 -0
  44. package/src/config/transforms/capability-transform-resolver.js +7 -1
  45. package/src/config/transforms/execution-graph-transforms.js +2 -2
  46. package/src/debug/config.d.ts +4 -0
  47. package/src/experimental/orchestration/index.d.ts +10 -1
  48. package/src/experimental/training/suite.js +1 -1
  49. package/src/formats/rdrr/classification.js +3 -0
  50. package/src/formats/rdrr/integrity.d.ts +0 -2
  51. package/src/formats/rdrr/integrity.js +0 -2
  52. package/src/formats/rdrr/types.d.ts +1 -1
  53. package/src/gpu/kernels/attention.d.ts +2 -0
  54. package/src/gpu/kernels/attention.js +75 -16
  55. package/src/gpu/kernels/attention_decode_online_head256_f16kv_output_gate.wgsl +268 -0
  56. package/src/gpu/kernels/attention_head128_f16kv.wgsl +269 -0
  57. package/src/gpu/kernels/fused_ffn.d.ts +32 -0
  58. package/src/gpu/kernels/fused_ffn.js +540 -19
  59. package/src/gpu/kernels/fused_ffn.wgsl +2 -1
  60. package/src/gpu/kernels/fused_ffn_f16.wgsl +2 -1
  61. package/src/gpu/kernels/fused_ffn_f16w_f32a_batched.wgsl +135 -0
  62. package/src/gpu/kernels/fused_ffn_q4k.wgsl +5 -3
  63. package/src/gpu/kernels/fused_ffn_q4k_f16.wgsl +2 -1
  64. package/src/gpu/kernels/fused_ffn_q4k_metal_simd16.wgsl +183 -0
  65. package/src/gpu/kernels/fused_gate_up_gelu_gated_f16.wgsl +2 -1
  66. package/src/gpu/kernels/fused_matmul_q4.wgsl +15 -6
  67. package/src/gpu/kernels/fused_matmul_q4_metal_simd16.wgsl +144 -0
  68. package/src/gpu/kernels/index.d.ts +21 -0
  69. package/src/gpu/kernels/index.js +13 -0
  70. package/src/gpu/kernels/linear-attention-core.js +413 -15
  71. package/src/gpu/kernels/lm-head-argmax.d.ts +10 -1
  72. package/src/gpu/kernels/lm-head-argmax.js +153 -57
  73. package/src/gpu/kernels/lm-head-select-logits.d.ts +23 -0
  74. package/src/gpu/kernels/lm-head-select-logits.js +186 -0
  75. package/src/gpu/kernels/lm_head_argmax_q4k.wgsl +289 -0
  76. package/src/gpu/kernels/lm_head_select_logits.wgsl +77 -0
  77. package/src/gpu/kernels/matmul-selection.js +5 -1
  78. package/src/gpu/kernels/residual_rmsnorm_pair.wgsl +127 -0
  79. package/src/gpu/kernels/rmsnorm-pair.d.ts +33 -0
  80. package/src/gpu/kernels/rmsnorm-pair.js +113 -0
  81. package/src/gpu/kernels/rmsnorm-stats.d.ts +29 -0
  82. package/src/gpu/kernels/rmsnorm-stats.js +250 -0
  83. package/src/gpu/kernels/silu.wgsl +7 -1
  84. package/src/gpu/kernels/silu_f16.wgsl +7 -1
  85. package/src/gpu/kernels/split-qkv-rmsnorm-rope-qk.js +15 -10
  86. package/src/gpu/kernels/split_qkv_rmsnorm_rope_qk.wgsl +37 -7
  87. package/src/gpu/kernels/split_qkv_rmsnorm_rope_qk_f16kv_cache.wgsl +37 -7
  88. package/src/gpu/tensor.d.ts +1 -0
  89. package/src/index.d.ts +1 -1
  90. package/src/index.js +1 -1
  91. package/src/inference/browser-harness-suite-helpers.js +1 -1
  92. package/src/inference/browser-harness-text-helpers.js +251 -20
  93. package/src/inference/browser-harness.js +221 -3
  94. package/src/inference/kv-cache/base.js +42 -1
  95. package/src/inference/pipelines/structured/json-grammar-mask.d.ts +18 -0
  96. package/src/inference/pipelines/text/attention/dispatch-params.js +8 -3
  97. package/src/inference/pipelines/text/attention/output-gate-fusion.js +37 -0
  98. package/src/inference/pipelines/text/attention/projections.js +174 -4
  99. package/src/inference/pipelines/text/attention/record.js +44 -21
  100. package/src/inference/pipelines/text/attention/run.js +18 -3
  101. package/src/inference/pipelines/text/config.d.ts +18 -0
  102. package/src/inference/pipelines/text/config.js +100 -0
  103. package/src/inference/pipelines/text/execution-plan.d.ts +2 -0
  104. package/src/inference/pipelines/text/execution-plan.js +37 -0
  105. package/src/inference/pipelines/text/execution-v1.d.ts +6 -0
  106. package/src/inference/pipelines/text/execution-v1.js +122 -8
  107. package/src/inference/pipelines/text/ffn/dense.js +239 -21
  108. package/src/inference/pipelines/text/ffn/standard.js +121 -38
  109. package/src/inference/pipelines/text/generator-decode-policy.js +1 -0
  110. package/src/inference/pipelines/text/generator-helpers.js +2 -0
  111. package/src/inference/pipelines/text/generator-runtime.js +1 -0
  112. package/src/inference/pipelines/text/generator-steps.js +2 -2
  113. package/src/inference/pipelines/text/generator.d.ts +18 -1
  114. package/src/inference/pipelines/text/generator.js +297 -19
  115. package/src/inference/pipelines/text/init-qkv-fusion.js +155 -62
  116. package/src/inference/pipelines/text/init.d.ts +22 -3
  117. package/src/inference/pipelines/text/init.js +2 -2
  118. package/src/inference/pipelines/text/layer.js +87 -8
  119. package/src/inference/pipelines/text/linear-attention-ab-fusion.js +208 -0
  120. package/src/inference/pipelines/text/linear-attention.d.ts +1 -0
  121. package/src/inference/pipelines/text/linear-attention.js +173 -16
  122. package/src/inference/pipelines/text/logits/gpu.js +2 -2
  123. package/src/inference/pipelines/text/logits/index.js +62 -1
  124. package/src/inference/pipelines/text/model-load.js +6 -0
  125. package/src/inference/pipelines/text/ops.js +22 -0
  126. package/src/inference/pipelines/text/per-layer-inputs.js +80 -11
  127. package/src/inference/pipelines/text/probes.js +9 -4
  128. package/src/inference/pipelines/text/state.d.ts +4 -4
  129. package/src/inference/pipelines/text/state.js +4 -0
  130. package/src/inference/pipelines/text/types.d.ts +27 -2
  131. package/src/inference/pipelines/text.d.ts +21 -1
  132. package/src/inference/pipelines/text.js +40 -14
  133. package/src/inference/tokenizers/bundled.js +45 -23
  134. package/src/inference/tokenizers/types.d.ts +7 -4
  135. package/src/loader/doppler-loader.js +25 -2
  136. package/src/loader/index.d.ts +3 -1
  137. package/src/loader/index.js +2 -0
  138. package/src/loader/loader-types.d.ts +3 -1
  139. package/src/loader/manifest-config.d.ts +18 -0
  140. package/src/loader/manifest-config.js +11 -3
  141. package/src/loader/shard-cache.d.ts +2 -0
  142. package/src/loader/shard-cache.js +29 -1
  143. package/src/models/gemma4.js +8 -0
  144. package/src/rules/inference/capability-transforms.rules.json +145 -20
  145. package/src/rules/inference/ffn.rules.json +33 -0
  146. package/src/rules/kernels/fused-ffn.rules.json +1 -1
  147. package/src/rules/kernels/lm-head-argmax.rules.json +10 -0
  148. package/src/rules/kernels/matmul.rules.json +1 -0
  149. package/src/rules/kernels/silu.rules.json +1 -0
  150. package/src/rules/rule-registry.js +2 -0
  151. package/src/storage/artifact-storage-context.js +36 -0
  152. package/src/tooling/node-browser-command-runner.js +42 -7
  153. package/src/tooling/opfs-cache.d.ts +21 -1
  154. package/src/tooling/opfs-cache.js +168 -32
  155. package/src/tooling-exports/storage.d.ts +1 -1
  156. package/src/tooling-exports/storage.js +1 -1
  157. package/src/types/gpu.d.ts +25 -0
  158. package/src/version.js +1 -1
  159. package/tests/kernels/browser/kernel-suite.js +1593 -0
  160. package/tests/kernels/browser/test-page.js +2629 -0
  161. package/tests/kernels/harness/benchmark.js +225 -0
  162. package/tests/kernels/harness/buffer-utils.js +88 -0
  163. package/tests/kernels/harness/tolerance.js +174 -0
  164. package/tests/kernels/reference/adam.js +15 -0
  165. package/tests/kernels/reference/attention.js +158 -0
  166. package/tests/kernels/reference/backward.js +96 -0
  167. package/tests/kernels/reference/bias-add.js +20 -0
  168. package/tests/kernels/reference/conv2d.js +58 -0
  169. package/tests/kernels/reference/cross-entropy.js +26 -0
  170. package/tests/kernels/reference/dequant.js +312 -0
  171. package/tests/kernels/reference/embed.js +15 -0
  172. package/tests/kernels/reference/gather.js +61 -0
  173. package/tests/kernels/reference/gelu.js +37 -0
  174. package/tests/kernels/reference/groupnorm.js +36 -0
  175. package/tests/kernels/reference/index.js +89 -0
  176. package/tests/kernels/reference/layernorm.js +22 -0
  177. package/tests/kernels/reference/matmul.js +57 -0
  178. package/tests/kernels/reference/modulate.js +24 -0
  179. package/tests/kernels/reference/moe-gather.js +83 -0
  180. package/tests/kernels/reference/pixel-shuffle.js +20 -0
  181. package/tests/kernels/reference/residual.js +55 -0
  182. package/tests/kernels/reference/rmsnorm.js +52 -0
  183. package/tests/kernels/reference/rope.js +79 -0
  184. package/tests/kernels/reference/sample.js +97 -0
  185. package/tests/kernels/reference/scatter-add.js +58 -0
  186. package/tests/kernels/reference/silu.js +52 -0
  187. package/tests/kernels/reference/softmax.js +86 -0
  188. package/tests/kernels/reference/split-qkv.js +58 -0
  189. package/tests/kernels/reference/topk.js +88 -0
  190. package/tests/kernels/reference/upsample2d.js +37 -0
  191. package/BRANDING.md +0 -14
  192. package/SECURITY.md +0 -19
  193. package/assets/doppler-runtime-map.svg +0 -82
  194. package/src/bootstrap.js +0 -30
  195. package/src/cli/doppler-cli.d.ts +0 -46
  196. package/src/cli/doppler-quickstart.d.ts +0 -45
  197. package/src/cli/doppler-serve.d.ts +0 -210
  198. package/src/cli/runtime-profiles.d.ts +0 -40
  199. package/src/client/doppler-api.browser.d.ts +0 -1
  200. package/src/client/doppler-api.browser.js +0 -25
  201. package/src/client/doppler-registry.d.ts +0 -54
  202. package/src/client/runtime/node-quickstart-cache.d.ts +0 -22
  203. package/src/client/runtime/source-runtime.d.ts +0 -26
  204. package/src/client/runtime/storage.d.ts +0 -5
  205. package/src/config/README.md +0 -61
  206. package/src/config/conversion/README.md +0 -62
  207. package/src/config/goal-completion-matrix.json +0 -552
  208. package/src/config/kernels/kernel-ref-digests.d.ts +0 -1
  209. package/src/config/kernels/moe/gpt-oss.paths.json +0 -49
  210. package/src/config/kernels/moe/mixtral.paths.json +0 -46
  211. package/src/config/kernels/registry.d.ts +0 -51
  212. package/src/config/merge-contract-check.d.ts +0 -16
  213. package/src/config/merge-contract-check.js +0 -319
  214. package/src/config/merge-helpers.d.ts +0 -60
  215. package/src/config/model-lanes/catalog-lane-resolver.d.ts +0 -66
  216. package/src/config/model-lanes/catalog-lane-resolver.js +0 -170
  217. package/src/config/param-categories.d.ts +0 -8
  218. package/src/config/param-validator.d.ts +0 -33
  219. package/src/config/platforms/loader.d.ts +0 -38
  220. package/src/config/quantization-contract-check.d.ts +0 -12
  221. package/src/config/quantization-contract-check.js +0 -91
  222. package/src/config/runtime/README.md +0 -28
  223. package/src/config/runtime-merge.d.ts +0 -5
  224. package/src/config/schema/claim-evidence-contract.schema.json +0 -93
  225. package/src/config/schema/command-surface-contract.schema.json +0 -81
  226. package/src/config/schema/goal-completion-matrix.schema.json +0 -223
  227. package/src/config/schema/model-artifact-contract.schema.json +0 -119
  228. package/src/config/schema/platform.schema.js +0 -1
  229. package/src/config/schema/policy-schema-registry.json +0 -31
  230. package/src/config/schema/subsystem-support-contract.schema.json +0 -48
  231. package/src/config/support-tiers/subsystems.json +0 -502
  232. package/src/config/supported-operations.d.ts +0 -14
  233. package/src/config/transforms/capability-transform-resolver.d.ts +0 -56
  234. package/src/config/transforms/execution-graph-transforms.d.ts +0 -306
  235. package/src/converter/conversion-plan.d.ts +0 -56
  236. package/src/converter/index.d.ts +0 -98
  237. package/src/converter/index.js +0 -59
  238. package/src/converter/parsers/diffusion.d.ts +0 -50
  239. package/src/converter/parsers/gguf.d.ts +0 -31
  240. package/src/converter/parsers/index.d.ts +0 -21
  241. package/src/converter/parsers/index.js +0 -12
  242. package/src/converter/parsers/transformer.d.ts +0 -31
  243. package/src/converter/quantization-info.d.ts +0 -38
  244. package/src/converter/rope-config.d.ts +0 -16
  245. package/src/converter/tokenizer-utils.d.ts +0 -12
  246. package/src/debug/reference/README.md +0 -114
  247. package/src/debug/reference/hf_attn_debug.py +0 -114
  248. package/src/debug/reference/hf_embed_check.py +0 -89
  249. package/src/debug/reference/hf_layer_out.py +0 -100
  250. package/src/debug/reference/hf_qwen35_linear_attn_debug.py +0 -268
  251. package/src/debug/reference/hf_rope_check.py +0 -116
  252. package/src/debug/reference/hf_weights.py +0 -75
  253. package/src/errors/doppler-error.d.ts +0 -20
  254. package/src/experimental/bridge/extension/background.d.ts +0 -14
  255. package/src/experimental/bridge/extension/background.js +0 -168
  256. package/src/experimental/bridge/extension/manifest.json +0 -34
  257. package/src/experimental/bridge/extension-client.d.ts +0 -114
  258. package/src/experimental/bridge/index.d.ts +0 -69
  259. package/src/experimental/bridge/node-bridge.js +0 -24
  260. package/src/experimental/bridge/protocol.d.ts +0 -96
  261. package/src/experimental/browser/gguf-importer.d.ts +0 -136
  262. package/src/experimental/browser/gguf-importer.js +0 -532
  263. package/src/experimental/browser/gguf-parser-browser.d.ts +0 -14
  264. package/src/experimental/browser/quantization.d.ts +0 -74
  265. package/src/experimental/browser/safetensors-parser-browser.d.ts +0 -193
  266. package/src/experimental/browser/shard-io-browser.d.ts +0 -57
  267. package/src/experimental/browser/shard-io-browser.js +0 -89
  268. package/src/experimental/browser/tensor-source-download.d.ts +0 -27
  269. package/src/experimental/diffusion/config/expansion-lanes.json +0 -29
  270. package/src/experimental/distribution/p2p-transport-contract.d.ts +0 -57
  271. package/src/experimental/distribution/p2p-transport.js +0 -75
  272. package/src/experimental/hotswap/intent-bundle.d.ts +0 -37
  273. package/src/experimental/hotswap/manifest.d.ts +0 -42
  274. package/src/experimental/hotswap/model-swap.js +0 -42
  275. package/src/experimental/hotswap/runtime.d.ts +0 -31
  276. package/src/experimental/training/README.md +0 -164
  277. package/src/experimental/training/artifacts.d.ts +0 -160
  278. package/src/experimental/training/attention-backward.d.ts +0 -30
  279. package/src/experimental/training/attention-forward.d.ts +0 -22
  280. package/src/experimental/training/attention-forward.js +0 -82
  281. package/src/experimental/training/autograd.d.ts +0 -51
  282. package/src/experimental/training/backward-kernels.js +0 -39
  283. package/src/experimental/training/checkpoint-watch.d.ts +0 -8
  284. package/src/experimental/training/checkpoint.d.ts +0 -36
  285. package/src/experimental/training/clip.d.ts +0 -9
  286. package/src/experimental/training/dataloader.d.ts +0 -8
  287. package/src/experimental/training/datasets/gepa-frontier.d.ts +0 -41
  288. package/src/experimental/training/datasets/gepa-frontier.js +0 -220
  289. package/src/experimental/training/datasets/index.d.ts +0 -24
  290. package/src/experimental/training/datasets/index.js +0 -13
  291. package/src/experimental/training/datasets/jsonl.d.ts +0 -11
  292. package/src/experimental/training/datasets/reploid.d.ts +0 -3
  293. package/src/experimental/training/datasets/reploid.js +0 -36
  294. package/src/experimental/training/datasets/teacher-traces.d.ts +0 -51
  295. package/src/experimental/training/datasets/teacher-traces.js +0 -279
  296. package/src/experimental/training/datasets/text-pairs.d.ts +0 -66
  297. package/src/experimental/training/datasets/token-batch.d.ts +0 -21
  298. package/src/experimental/training/datasets/token-batch.js +0 -52
  299. package/src/experimental/training/datasets/translation-pairs.d.ts +0 -34
  300. package/src/experimental/training/datasets/translation-pairs.js +0 -49
  301. package/src/experimental/training/distillation/artifacts.d.ts +0 -71
  302. package/src/experimental/training/distillation/checkpoint-watch.d.ts +0 -10
  303. package/src/experimental/training/distillation/dataset.d.ts +0 -59
  304. package/src/experimental/training/distillation/eval.d.ts +0 -34
  305. package/src/experimental/training/distillation/index.d.ts +0 -29
  306. package/src/experimental/training/distillation/runtime.d.ts +0 -20
  307. package/src/experimental/training/distillation/scoreboard.d.ts +0 -6
  308. package/src/experimental/training/distillation/stage-a.d.ts +0 -45
  309. package/src/experimental/training/distillation/stage-b.d.ts +0 -24
  310. package/src/experimental/training/distillation/student-fixture.d.ts +0 -27
  311. package/src/experimental/training/distillation/suite-data.d.ts +0 -45
  312. package/src/experimental/training/export.d.ts +0 -41
  313. package/src/experimental/training/index.d.ts +0 -74
  314. package/src/experimental/training/index.js +0 -63
  315. package/src/experimental/training/lora-pipeline.d.ts +0 -183
  316. package/src/experimental/training/lora.d.ts +0 -19
  317. package/src/experimental/training/loss-scaling.d.ts +0 -21
  318. package/src/experimental/training/loss.d.ts +0 -10
  319. package/src/experimental/training/objectives/base.d.ts +0 -58
  320. package/src/experimental/training/objectives/cross_entropy.d.ts +0 -18
  321. package/src/experimental/training/objectives/distill_kd.d.ts +0 -16
  322. package/src/experimental/training/objectives/distill_triplet.d.ts +0 -16
  323. package/src/experimental/training/objectives/index.d.ts +0 -12
  324. package/src/experimental/training/objectives/index.js +0 -6
  325. package/src/experimental/training/objectives/ul_stage1_joint.d.ts +0 -16
  326. package/src/experimental/training/objectives/ul_stage2_base.d.ts +0 -16
  327. package/src/experimental/training/operator-agent-eval.d.ts +0 -65
  328. package/src/experimental/training/operator-artifacts.d.ts +0 -62
  329. package/src/experimental/training/operator-command.d.ts +0 -5
  330. package/src/experimental/training/operator-eval.d.ts +0 -48
  331. package/src/experimental/training/operator-scoreboard.d.ts +0 -5
  332. package/src/experimental/training/optimizer.d.ts +0 -22
  333. package/src/experimental/training/runner.d.ts +0 -249
  334. package/src/experimental/training/suite.d.ts +0 -299
  335. package/src/experimental/training/tensor-factory.d.ts +0 -9
  336. package/src/experimental/training/trainer.d.ts +0 -89
  337. package/src/experimental/training/ul_dataset.d.ts +0 -47
  338. package/src/experimental/training/ul_schedule.d.ts +0 -6
  339. package/src/experimental/training/workload-packs/distill-glm52-doppler-agent-harness-gemma270m-f16-sft-tiny.json +0 -160
  340. package/src/experimental/training/workload-packs/distill-glm52-doppler-code-agent-gemma270m-f16-sft-tiny.json +0 -175
  341. package/src/experimental/training/workload-packs/distill-glm52-doppler-code-agent-sft-tiny.json +0 -175
  342. package/src/experimental/training/workload-packs/distill-glm52-doppler-js-json-gemma270m-f16-sft-tiny.json +0 -160
  343. package/src/experimental/training/workload-packs/distill-glm52-doppler-review-gemma270m-f16-sft-tiny.json +0 -162
  344. package/src/experimental/training/workload-packs/distill-glm52-doppler-wgsl-gemma270m-f16-sft-tiny.json +0 -160
  345. package/src/experimental/training/workload-packs/distill-translategemma-medium.json +0 -103
  346. package/src/experimental/training/workload-packs/distill-translategemma-tiny.json +0 -103
  347. package/src/experimental/training/workload-packs/lora-doppler-agent-harness-gemma270m-f16-tiny.json +0 -137
  348. package/src/experimental/training/workload-packs/lora-doppler-code-agent-gemma270m-f16-tiny.json +0 -152
  349. package/src/experimental/training/workload-packs/lora-doppler-code-agent-tiny.json +0 -152
  350. package/src/experimental/training/workload-packs/lora-doppler-js-json-gemma270m-f16-tiny.json +0 -137
  351. package/src/experimental/training/workload-packs/lora-doppler-review-gemma270m-f16-tiny.json +0 -139
  352. package/src/experimental/training/workload-packs/lora-doppler-wgsl-gemma270m-f16-tiny.json +0 -137
  353. package/src/experimental/training/workload-packs/lora-toy-medium.json +0 -91
  354. package/src/experimental/training/workload-packs/lora-toy-tiny.json +0 -91
  355. package/src/experimental/training/workload-packs/registry.json +0 -278
  356. package/src/experimental/training/workload-packs/ul-training-medium.json +0 -55
  357. package/src/experimental/training/workload-packs/ul-training-tiny.json +0 -55
  358. package/src/experimental/training/workloads.d.ts +0 -201
  359. package/src/formats/gguf/types.d.ts +0 -74
  360. package/src/formats/index.d.ts +0 -75
  361. package/src/formats/index.js +0 -19
  362. package/src/formats/litert/types.d.ts +0 -74
  363. package/src/formats/rdrr/distributed/parsing.d.ts +0 -6
  364. package/src/formats/rdrr/distributed/validation.d.ts +0 -23
  365. package/src/formats/rdrr/storage-descriptor.d.ts +0 -36
  366. package/src/formats/rdrr/tensor-config-validator.d.ts +0 -33
  367. package/src/formats/safetensors/types.d.ts +0 -67
  368. package/src/formats/tflite/types.d.ts +0 -61
  369. package/src/formats/tokenizer/index.d.ts +0 -5
  370. package/src/formats/tokenizer/index.js +0 -3
  371. package/src/formats/tokenizer/types.d.ts +0 -9
  372. package/src/gpu/kernel-runtime.d.ts +0 -13
  373. package/src/gpu/kernel-selection-cache.d.ts +0 -13
  374. package/src/gpu/kernel-selection-log.d.ts +0 -4
  375. package/src/gpu/kernel-tuner/benchmarks.d.ts +0 -144
  376. package/src/gpu/kernel-tuner/cache.d.ts +0 -55
  377. package/src/gpu/kernel-tuner/index.d.ts +0 -59
  378. package/src/gpu/kernel-tuner/tuner.d.ts +0 -82
  379. package/src/gpu/kernel-tuner/types.d.ts +0 -101
  380. package/src/gpu/kernel-tuner/types.js +0 -4
  381. package/src/gpu/kernel-tuner.d.ts +0 -33
  382. package/src/gpu/kernels/README.md +0 -166
  383. package/src/gpu/kernels/check-finiteness.d.ts +0 -15
  384. package/src/gpu/kernels/check-hot-vocab-stop.d.ts +0 -18
  385. package/src/gpu/kernels/check-stop.d.ts +0 -31
  386. package/src/gpu/kernels/codegen/patches/attention_decode_f16.from.attention_decode.diff +0 -213
  387. package/src/gpu/kernels/codegen/patches/attention_decode_f16kv.from.attention_decode.diff +0 -89
  388. package/src/gpu/kernels/codegen/patches/attention_f16.from.attention.diff +0 -62
  389. package/src/gpu/kernels/codegen/patches/attention_f16kv.from.attention.diff +0 -40
  390. package/src/gpu/kernels/codegen/patches/attention_small_f16.from.attention_small.diff +0 -226
  391. package/src/gpu/kernels/codegen/patches/attention_small_f16kv.from.attention_small.diff +0 -264
  392. package/src/gpu/kernels/codegen/patches/attention_streaming_f16.from.attention_streaming.diff +0 -71
  393. package/src/gpu/kernels/codegen/patches/attention_streaming_f16kv.from.attention_streaming.diff +0 -53
  394. package/src/gpu/kernels/codegen/patches/bias_add_f16.from.bias_add.diff +0 -54
  395. package/src/gpu/kernels/codegen/patches/dequant_mxfp4_expert_f16.from.dequant_mxfp4_expert.diff +0 -125
  396. package/src/gpu/kernels/codegen/patches/fused_ffn_f16.from.fused_ffn.diff +0 -428
  397. package/src/gpu/kernels/codegen/patches/fused_matmul_q4_batched_f16.from.fused_matmul_q4_batched.diff +0 -114
  398. package/src/gpu/kernels/codegen/patches/fused_matmul_rmsnorm_f16.from.fused_matmul_rmsnorm.diff +0 -477
  399. package/src/gpu/kernels/codegen/patches/fused_swiglu_f16.from.fused_swiglu.diff +0 -60
  400. package/src/gpu/kernels/codegen/patches/gelu_f16.from.gelu.diff +0 -41
  401. package/src/gpu/kernels/codegen/patches/layernorm_f16.from.layernorm.diff +0 -82
  402. package/src/gpu/kernels/codegen/patches/matmul_gemv_residual_f16.from.matmul_gemv_residual.diff +0 -87
  403. package/src/gpu/kernels/codegen/patches/moe_gather_f16.from.moe_gather.diff +0 -181
  404. package/src/gpu/kernels/codegen/patches/residual_f16.from.residual.diff +0 -65
  405. package/src/gpu/kernels/codegen/patches/rmsnorm_f16.from.rmsnorm.diff +0 -515
  406. package/src/gpu/kernels/codegen/patches/rope_f16.from.rope.diff +0 -292
  407. package/src/gpu/kernels/codegen/patches/sample_f16.from.sample.diff +0 -336
  408. package/src/gpu/kernels/codegen/patches/scatter_add_dynamic_f16.from.scatter_add_dynamic.diff +0 -65
  409. package/src/gpu/kernels/codegen/patches/silu_f16.from.silu.diff +0 -81
  410. package/src/gpu/kernels/codegen/patches/topk_f16.from.topk.diff +0 -231
  411. package/src/gpu/kernels/codegen/wgsl-patch-variants.js +0 -152
  412. package/src/gpu/kernels/codegen/wgsl-variants.js +0 -885
  413. package/src/gpu/kernels/constants.d.ts +0 -129
  414. package/src/gpu/kernels/dispatch.d.ts +0 -72
  415. package/src/gpu/kernels/gated-short-conv.d.ts +0 -63
  416. package/src/gpu/kernels/kernel-base.d.ts +0 -33
  417. package/src/gpu/kernels/linear-attention-core.d.ts +0 -42
  418. package/src/gpu/kernels/matmul-dispatch.d.ts +0 -49
  419. package/src/gpu/kernels/matmul-selection.d.ts +0 -87
  420. package/src/gpu/kernels/rep-penalty.d.ts +0 -21
  421. package/src/gpu/kernels/rule-matcher.d.ts +0 -30
  422. package/src/gpu/kernels/rule-registry.d.ts +0 -7
  423. package/src/gpu/kernels/types.js +0 -4
  424. package/src/gpu/perf-guards.d.ts +0 -13
  425. package/src/gpu/profiler.d.ts +0 -93
  426. package/src/gpu/readback-utils.d.ts +0 -16
  427. package/src/gpu/readback-utils.js +0 -49
  428. package/src/gpu/submit-probe.d.ts +0 -12
  429. package/src/index-browser.d.ts +0 -2
  430. package/src/index-browser.js +0 -2
  431. package/src/inference/README.md +0 -593
  432. package/src/inference/browser-harness-contract-helpers.d.ts +0 -5
  433. package/src/inference/browser-harness-diffusion-energy-suites.d.ts +0 -2
  434. package/src/inference/browser-harness-model-helpers.d.ts +0 -10
  435. package/src/inference/browser-harness-report-helpers.d.ts +0 -7
  436. package/src/inference/browser-harness-suite-helpers.d.ts +0 -40
  437. package/src/inference/browser-harness-text-helpers.d.ts +0 -152
  438. package/src/inference/model-lanes/execution-lane-resolver.d.ts +0 -61
  439. package/src/inference/model-lanes/execution-lane-resolver.js +0 -126
  440. package/src/inference/network-evolution.js +0 -79
  441. package/src/inference/pipelines/context.d.ts +0 -21
  442. package/src/inference/pipelines/diffusion/helpers.d.ts +0 -29
  443. package/src/inference/pipelines/diffusion/index.d.ts +0 -3
  444. package/src/inference/pipelines/diffusion/index.js +0 -3
  445. package/src/inference/pipelines/diffusion/scheduler.d.ts +0 -35
  446. package/src/inference/pipelines/diffusion/sd3-transformer.d.ts +0 -20
  447. package/src/inference/pipelines/diffusion/sd3-weights.d.ts +0 -21
  448. package/src/inference/pipelines/diffusion/text-encoder-gpu.d.ts +0 -82
  449. package/src/inference/pipelines/diffusion/text-encoder.d.ts +0 -29
  450. package/src/inference/pipelines/diffusion/types.js +0 -1
  451. package/src/inference/pipelines/diffusion/vae.d.ts +0 -20
  452. package/src/inference/pipelines/dream/energy-head-pipeline.d.ts +0 -29
  453. package/src/inference/pipelines/dream/energy-head-pipeline.js +0 -6
  454. package/src/inference/pipelines/dream/pipeline.d.ts +0 -17
  455. package/src/inference/pipelines/dream/pipeline.js +0 -8
  456. package/src/inference/pipelines/energy/index.d.ts +0 -1
  457. package/src/inference/pipelines/energy/index.js +0 -1
  458. package/src/inference/pipelines/energy/types.js +0 -1
  459. package/src/inference/pipelines/energy-head/index.d.ts +0 -6
  460. package/src/inference/pipelines/energy-head/index.js +0 -6
  461. package/src/inference/pipelines/factory.d.ts +0 -10
  462. package/src/inference/pipelines/index.d.ts +0 -22
  463. package/src/inference/pipelines/index.js +0 -19
  464. package/src/inference/pipelines/registry.d.ts +0 -15
  465. package/src/inference/pipelines/rng.d.ts +0 -2
  466. package/src/inference/pipelines/structured/tsv-grammar-mask.js +0 -166
  467. package/src/inference/pipelines/text/attention/attn-config.d.ts +0 -23
  468. package/src/inference/pipelines/text/attention/dispatch-params.d.ts +0 -173
  469. package/src/inference/pipelines/text/attention/index.d.ts +0 -24
  470. package/src/inference/pipelines/text/attention/output-projection.d.ts +0 -12
  471. package/src/inference/pipelines/text/attention/precision-contract.d.ts +0 -36
  472. package/src/inference/pipelines/text/attention/projections.d.ts +0 -208
  473. package/src/inference/pipelines/text/attention/quant-options.d.ts +0 -38
  474. package/src/inference/pipelines/text/attention/record.d.ts +0 -36
  475. package/src/inference/pipelines/text/attention/rmsnorm-fusion-gate.d.ts +0 -8
  476. package/src/inference/pipelines/text/attention/run.d.ts +0 -38
  477. package/src/inference/pipelines/text/attention/types.d.ts +0 -125
  478. package/src/inference/pipelines/text/attention.d.ts +0 -23
  479. package/src/inference/pipelines/text/attention.js +0 -12
  480. package/src/inference/pipelines/text/bdpa-steamroller.d.ts +0 -22
  481. package/src/inference/pipelines/text/buffer-types.js +0 -4
  482. package/src/inference/pipelines/text/debug-utils/config.d.ts +0 -144
  483. package/src/inference/pipelines/text/debug-utils/index.d.ts +0 -53
  484. package/src/inference/pipelines/text/debug-utils/logging.d.ts +0 -106
  485. package/src/inference/pipelines/text/debug-utils/tensor.d.ts +0 -119
  486. package/src/inference/pipelines/text/debug-utils/utils.d.ts +0 -77
  487. package/src/inference/pipelines/text/debug-utils.d.ts +0 -42
  488. package/src/inference/pipelines/text/drift-policy.d.ts +0 -57
  489. package/src/inference/pipelines/text/dtype-contract.d.ts +0 -53
  490. package/src/inference/pipelines/text/embed.d.ts +0 -69
  491. package/src/inference/pipelines/text/execution-runtime-builders.d.ts +0 -49
  492. package/src/inference/pipelines/text/failure-reduction.d.ts +0 -84
  493. package/src/inference/pipelines/text/failure-reduction.js +0 -180
  494. package/src/inference/pipelines/text/ffn/dense.d.ts +0 -99
  495. package/src/inference/pipelines/text/ffn/index.d.ts +0 -23
  496. package/src/inference/pipelines/text/ffn/moe.d.ts +0 -24
  497. package/src/inference/pipelines/text/ffn/sandwich.d.ts +0 -27
  498. package/src/inference/pipelines/text/ffn/standard.d.ts +0 -26
  499. package/src/inference/pipelines/text/ffn/types.d.ts +0 -30
  500. package/src/inference/pipelines/text/ffn.d.ts +0 -31
  501. package/src/inference/pipelines/text/ffn.js +0 -18
  502. package/src/inference/pipelines/text/finiteness-guard-status.d.ts +0 -11
  503. package/src/inference/pipelines/text/finiteness-policy.d.ts +0 -39
  504. package/src/inference/pipelines/text/generator-decode-policy.d.ts +0 -81
  505. package/src/inference/pipelines/text/generator-helpers.d.ts +0 -45
  506. package/src/inference/pipelines/text/generator-prefill-helpers.d.ts +0 -84
  507. package/src/inference/pipelines/text/generator-runtime.d.ts +0 -93
  508. package/src/inference/pipelines/text/generator-steps.d.ts +0 -186
  509. package/src/inference/pipelines/text/index.d.ts +0 -5
  510. package/src/inference/pipelines/text/index.js +0 -6
  511. package/src/inference/pipelines/text/kernel-trace.d.ts +0 -119
  512. package/src/inference/pipelines/text/layer.d.ts +0 -118
  513. package/src/inference/pipelines/text/load-errors.d.ts +0 -21
  514. package/src/inference/pipelines/text/logits/precision-policy.d.ts +0 -11
  515. package/src/inference/pipelines/text/logits/types.js +0 -4
  516. package/src/inference/pipelines/text/logits.d.ts +0 -27
  517. package/src/inference/pipelines/text/logits.js +0 -16
  518. package/src/inference/pipelines/text/lora-apply.d.ts +0 -28
  519. package/src/inference/pipelines/text/moe-cache.d.ts +0 -32
  520. package/src/inference/pipelines/text/moe-cpu-gptoss.d.ts +0 -9
  521. package/src/inference/pipelines/text/moe-cpu.d.ts +0 -13
  522. package/src/inference/pipelines/text/moe-gpu.d.ts +0 -26
  523. package/src/inference/pipelines/text/moe-helpers.d.ts +0 -12
  524. package/src/inference/pipelines/text/moe-shape-validator.d.ts +0 -70
  525. package/src/inference/pipelines/text/operator-events.d.ts +0 -125
  526. package/src/inference/pipelines/text/operator-identity.d.ts +0 -60
  527. package/src/inference/pipelines/text/ops.d.ts +0 -222
  528. package/src/inference/pipelines/text/per-layer-inputs.d.ts +0 -107
  529. package/src/inference/pipelines/text/probes.d.ts +0 -28
  530. package/src/inference/pipelines/text/sampling-config.d.ts +0 -48
  531. package/src/inference/pipelines/text/stage-names.d.ts +0 -88
  532. package/src/inference/pipelines/text/tsir-fixture-writer.d.ts +0 -57
  533. package/src/inference/pipelines/text/types.js +0 -4
  534. package/src/inference/tokenizers/base.d.ts +0 -44
  535. package/src/inference/tokenizers/behavior-flags.d.ts +0 -9
  536. package/src/inference/tokenizers/bpe.d.ts +0 -27
  537. package/src/inference/tokenizers/bundled.d.ts +0 -67
  538. package/src/inference/tokenizers/sentencepiece.d.ts +0 -30
  539. package/src/inference/tokenizers/types.js +0 -7
  540. package/src/loader/embedding-limit-preflight.d.ts +0 -31
  541. package/src/loader/per-layer-input-loader.d.ts +0 -30
  542. package/src/loader/tensors/functional-descriptor-loader.d.ts +0 -9
  543. package/src/loader/tensors/source-transform.d.ts +0 -65
  544. package/src/memory/address-table.d.ts +0 -96
  545. package/src/rules/execution-rules-contract-check.d.ts +0 -21
  546. package/src/rules/layer-pattern-contract-check.d.ts +0 -17
  547. package/src/rules/rule-registry.d.ts +0 -77
  548. package/src/storage/artifact-storage-context.d.ts +0 -63
  549. package/src/storage/backends/idb-store.d.ts +0 -52
  550. package/src/storage/backends/memory-store.d.ts +0 -36
  551. package/src/storage/backends/opfs-store.d.ts +0 -41
  552. package/src/storage/blake3.d.ts +0 -17
  553. package/src/storage/download-types.d.ts +0 -157
  554. package/src/storage/downloader.d.ts +0 -103
  555. package/src/storage/index.d.ts +0 -274
  556. package/src/storage/index.js +0 -201
  557. package/src/storage/preflight.d.ts +0 -144
  558. package/src/storage/preflight.js +0 -360
  559. package/src/storage/quickstart-downloader.d.ts +0 -157
  560. package/src/storage/quickstart-downloader.js +0 -289
  561. package/src/storage/source-artifact-store.d.ts +0 -59
  562. package/src/sw.js +0 -184
  563. package/src/tooling/command-api-constants.d.ts +0 -9
  564. package/src/tooling/command-api-family-normalizers.d.ts +0 -10
  565. package/src/tooling/command-api-helpers.d.ts +0 -23
  566. package/src/tooling/command-runner-shared.d.ts +0 -89
  567. package/src/tooling/conversion-config-materializer.d.ts +0 -14
  568. package/src/tooling/conversion-config-materializer.js +0 -96
  569. package/src/tooling/diagnose-runner.d.ts +0 -28
  570. package/src/tooling/hf-registry-utils.d.ts +0 -55
  571. package/src/tooling/kernel-path-builder/custom-runtime-facts.d.ts +0 -18
  572. package/src/tooling/kernel-path-builder/custom-runtime-facts.js +0 -72
  573. package/src/tooling/kernel-path-builder/index.d.ts +0 -65
  574. package/src/tooling/kernel-path-builder/index.js +0 -1361
  575. package/src/tooling/kernel-path-builder/runtime-overlay.d.ts +0 -9
  576. package/src/tooling/kernel-path-builder/runtime-overlay.js +0 -147
  577. package/src/tooling/lean-execution-contract-runner.d.ts +0 -33
  578. package/src/tooling/lean-execution-contract-runner.js +0 -158
  579. package/src/tooling/lean-execution-contract.d.ts +0 -16
  580. package/src/tooling/lean-execution-contract.js +0 -81
  581. package/src/tooling/litert-package-runtime.d.ts +0 -46
  582. package/src/tooling/node-convert-worker-pool.d.ts +0 -16
  583. package/src/tooling/node-convert-worker.d.ts +0 -1
  584. package/src/tooling/node-converter.d.ts +0 -1
  585. package/src/tooling/node-file-fetch.d.ts +0 -1
  586. package/src/tooling/node-source-runtime.d.ts +0 -24
  587. package/src/tooling/node-webgpu.d.ts +0 -17
  588. package/src/tooling/precision-replay-math.js +0 -174
  589. package/src/tooling/program-bundle-host.d.ts +0 -16
  590. package/src/tooling/program-bundle-host.js +0 -20
  591. package/src/tooling/runtime-input-composition.d.ts +0 -37
  592. package/src/tooling/source-package-profiles.d.ts +0 -50
  593. package/src/tooling/source-runtime-converter-config.d.ts +0 -19
  594. package/src/tooling/source-runtime-materializer.d.ts +0 -6
  595. package/src/tooling/source-runtime-materializer.js +0 -89
  596. package/src/tooling-exports.browser.d.ts +0 -7
  597. package/src/types/chrome.d.ts +0 -36
  598. package/src/types/chrome.js +0 -1
  599. package/src/types/index.d.ts +0 -1
  600. package/src/types/index.js +0 -1
  601. package/src/utils/array-buffer.d.ts +0 -4
  602. package/src/utils/canonical-hash.d.ts +0 -7
  603. package/src/utils/clone-json.d.ts +0 -1
  604. package/src/utils/hf-resolve-url.d.ts +0 -16
  605. package/src/utils/index.d.ts +0 -10
  606. package/src/utils/index.js +0 -10
  607. package/src/utils/load-json.d.ts +0 -5
  608. package/src/utils/plain-object.d.ts +0 -1
  609. package/src/utils/sha256.d.ts +0 -5
  610. package/src/utils/stable-sort-object.d.ts +0 -1
@@ -1,532 +0,0 @@
1
-
2
-
3
- import { parseGGUFHeader } from './gguf-parser-browser.js';
4
- import { canStreamFile } from './file-picker.js';
5
- import {
6
- initStorage,
7
- openModelStore,
8
- saveManifest,
9
- deleteModel,
10
- computeHash,
11
- getStorageBackendType,
12
- } from '../../storage/shard-manager.js';
13
- import {
14
- RDRR_VERSION,
15
- generateShardFilename,
16
- } from '../../formats/rdrr/index.js';
17
- import { log } from '../../debug/index.js';
18
- import { createConverterConfig } from '../../config/index.js';
19
- import { extractArchitecture } from '../../converter/core.js';
20
- import { resolveConversionPlan } from '../../converter/conversion-plan.js';
21
- import { HEADER_READ_SIZE } from '../../config/schema/index.js';
22
- import { registerModel } from '../../storage/registry.js';
23
-
24
- // ============================================================================
25
- // Types
26
- // ============================================================================
27
-
28
-
29
- export const ImportStage = {
30
- PARSING: 'parsing',
31
- SHARDING: 'sharding',
32
- WRITING: 'writing',
33
- COMPLETE: 'complete',
34
- ERROR: 'error',
35
- };
36
-
37
- // ============================================================================
38
- // Helper Functions
39
- // ============================================================================
40
-
41
-
42
- function sanitizeModelId(name) {
43
- const sanitized = name
44
- .toLowerCase()
45
- .replace(/[^a-z0-9_-]/g, '-')
46
- .replace(/-+/g, '-')
47
- .replace(/^-|-$/g, '')
48
- .slice(0, 64);
49
- return sanitized || null;
50
- }
51
-
52
- // ============================================================================
53
- // Main Import Function
54
- // ============================================================================
55
-
56
-
57
- export async function importGGUFFile(
58
- file,
59
- { onProgress, signal, modelId: userModelId, converterConfig } = {}
60
- ) {
61
- let modelId = null;
62
- let modelDir = null;
63
- const shardInfos = [];
64
- const resolvedConverterConfig = converterConfig || createConverterConfig();
65
- const shardingConfig = resolvedConverterConfig.sharding;
66
-
67
- try {
68
- // Initialize OPFS
69
- await initStorage();
70
-
71
- // Report parsing stage
72
- onProgress?.({
73
- stage: ImportStage.PARSING,
74
- message: 'Parsing GGUF header...',
75
- filename: file.name,
76
- });
77
-
78
- // Check for abort
79
- if (signal?.aborted) {
80
- throw new DOMException('Import cancelled', 'AbortError');
81
- }
82
-
83
- // Read header portion for parsing
84
- const headerBlob = file.slice(0, Math.min(HEADER_READ_SIZE, file.size));
85
- const headerBuffer = await headerBlob.arrayBuffer();
86
- const ggufInfo = parseGGUFHeader(headerBuffer);
87
-
88
- // Generate model ID from filename or GGUF metadata
89
- const ggufName = ggufInfo.modelName !== 'unknown'
90
- ? ggufInfo.modelName
91
- : file.name.replace(/\.gguf$/i, '');
92
- modelId = sanitizeModelId(userModelId || ggufName);
93
- if (!modelId) {
94
- throw new Error('Missing modelId. Provide modelId explicitly or include a name in GGUF metadata.');
95
- }
96
-
97
- onProgress?.({
98
- stage: ImportStage.PARSING,
99
- message: `Model: ${modelId}`,
100
- modelId,
101
- architecture: ggufInfo.architecture,
102
- quantization: ggufInfo.quantization,
103
- });
104
-
105
- // Open model directory in OPFS
106
- modelDir = await openModelStore(modelId);
107
- if (!modelDir) {
108
- throw new Error('OPFS required for GGUF import');
109
- }
110
-
111
- // Calculate expected shard count
112
- const totalDataSize = file.size - ggufInfo.tensorDataOffset;
113
- const shardSizeBytes = shardingConfig?.shardSizeBytes;
114
- if (!shardSizeBytes || shardSizeBytes <= 0) {
115
- throw new Error('Invalid converter shard size configuration');
116
- }
117
- const expectedShards = Math.ceil(totalDataSize / shardSizeBytes);
118
-
119
- onProgress?.({
120
- stage: ImportStage.SHARDING,
121
- message: `Preparing ${expectedShards} shards...`,
122
- current: 0,
123
- total: expectedShards,
124
- percent: 0,
125
- });
126
-
127
- // Check for abort
128
- if (signal?.aborted) {
129
- throw new DOMException('Import cancelled', 'AbortError');
130
- }
131
-
132
- // Stream the file and create shards
133
- if (canStreamFile(file)) {
134
- await streamToShards(file, ggufInfo, modelDir, shardInfos, shardSizeBytes, {
135
- converterConfig: resolvedConverterConfig,
136
- onProgress,
137
- signal,
138
- });
139
- } else {
140
- // Fallback for browsers without streaming
141
- await bufferToShards(file, ggufInfo, modelDir, shardInfos, shardSizeBytes, {
142
- converterConfig: resolvedConverterConfig,
143
- onProgress,
144
- signal,
145
- });
146
- }
147
-
148
- // Check for abort before finalizing
149
- if (signal?.aborted) {
150
- throw new DOMException('Import cancelled', 'AbortError');
151
- }
152
-
153
- // Create manifest
154
- const manifest = createManifest(
155
- ggufInfo,
156
- shardInfos,
157
- modelId,
158
- resolvedConverterConfig,
159
- shardSizeBytes
160
- );
161
-
162
- onProgress?.({
163
- stage: ImportStage.WRITING,
164
- message: 'Saving manifest...',
165
- });
166
-
167
- // Save manifest to OPFS
168
- await saveManifest(JSON.stringify(manifest, null, 2));
169
-
170
- try {
171
- await registerModel({
172
- modelId,
173
- totalSize: file.size,
174
- quantization: ggufInfo.quantization,
175
- hashAlgorithm: resolvedConverterConfig.manifest.hashAlgorithm,
176
- backend: getStorageBackendType(),
177
- });
178
- } catch {
179
- // Registry is optional; ignore failures
180
- }
181
-
182
- onProgress?.({
183
- stage: ImportStage.COMPLETE,
184
- message: 'Import complete!',
185
- modelId,
186
- shardCount: shardInfos.length,
187
- totalSize: file.size,
188
- });
189
-
190
- return modelId;
191
- } catch (error) {
192
- // Cleanup on error
193
- if (modelId) {
194
- try {
195
- await deleteModel(modelId);
196
- } catch {
197
- // Ignore cleanup errors
198
- }
199
- }
200
-
201
- onProgress?.({
202
- stage: ImportStage.ERROR,
203
- message: error.message,
204
- error: error,
205
- });
206
-
207
- throw error;
208
- }
209
- }
210
-
211
-
212
- async function streamToShards(
213
- file,
214
- ggufInfo,
215
- modelDir,
216
- shardInfos,
217
- shardSizeBytes,
218
- { converterConfig, onProgress, signal }
219
- ) {
220
- const tensorDataOffset = ggufInfo.tensorDataOffset;
221
- const totalDataSize = file.size - tensorDataOffset;
222
- const expectedShards = Math.ceil(totalDataSize / shardSizeBytes);
223
-
224
- // Slice to just tensor data
225
- const tensorBlob = file.slice(tensorDataOffset);
226
- const stream = tensorBlob.stream();
227
- const reader = stream.getReader();
228
-
229
- let shardIndex = 0;
230
- let shardBuffer = new Uint8Array(shardSizeBytes);
231
- let shardOffset = 0;
232
- let totalProcessed = 0;
233
-
234
- try {
235
- while (true) {
236
- // Check for abort
237
- if (signal?.aborted) {
238
- reader.cancel();
239
- throw new DOMException('Import cancelled', 'AbortError');
240
- }
241
-
242
- const { done, value } = await reader.read();
243
-
244
- if (done) {
245
- // Write final partial shard if any data remains
246
- if (shardOffset > 0) {
247
- await writeShard(
248
- modelDir,
249
- shardIndex,
250
- shardBuffer.slice(0, shardOffset),
251
- shardInfos,
252
- shardSizeBytes,
253
- converterConfig.manifest.hashAlgorithm
254
- );
255
- shardIndex++;
256
- }
257
- break;
258
- }
259
-
260
- // Process chunk
261
- let chunkOffset = 0;
262
- while (chunkOffset < value.length) {
263
- const remaining = shardSizeBytes - shardOffset;
264
- const toCopy = Math.min(remaining, value.length - chunkOffset);
265
-
266
- shardBuffer.set(value.subarray(chunkOffset, chunkOffset + toCopy), shardOffset);
267
- shardOffset += toCopy;
268
- chunkOffset += toCopy;
269
- totalProcessed += toCopy;
270
-
271
- // Shard full, write it
272
- if (shardOffset === shardSizeBytes) {
273
- await writeShard(
274
- modelDir,
275
- shardIndex,
276
- shardBuffer,
277
- shardInfos,
278
- shardSizeBytes,
279
- converterConfig.manifest.hashAlgorithm
280
- );
281
-
282
- shardIndex++;
283
- shardBuffer = new Uint8Array(shardSizeBytes);
284
- shardOffset = 0;
285
-
286
- onProgress?.({
287
- stage: ImportStage.SHARDING,
288
- message: `Writing shard ${shardIndex}/${expectedShards}`,
289
- current: shardIndex,
290
- total: expectedShards,
291
- percent: Math.round((totalProcessed / totalDataSize) * 100),
292
- });
293
- }
294
- }
295
- }
296
- } finally {
297
- reader.releaseLock();
298
- }
299
- }
300
-
301
-
302
- async function bufferToShards(
303
- file,
304
- ggufInfo,
305
- modelDir,
306
- shardInfos,
307
- shardSizeBytes,
308
- { converterConfig, onProgress, signal }
309
- ) {
310
- const tensorDataOffset = ggufInfo.tensorDataOffset;
311
- const totalDataSize = file.size - tensorDataOffset;
312
- const expectedShards = Math.ceil(totalDataSize / shardSizeBytes);
313
-
314
- log.warn('GGUF Import', 'Using buffer fallback - large files may cause memory issues');
315
-
316
- let shardIndex = 0;
317
- let offset = tensorDataOffset;
318
-
319
- while (offset < file.size) {
320
- // Check for abort
321
- if (signal?.aborted) {
322
- throw new DOMException('Import cancelled', 'AbortError');
323
- }
324
-
325
- const end = Math.min(offset + shardSizeBytes, file.size);
326
- const blob = file.slice(offset, end);
327
- const buffer = await blob.arrayBuffer();
328
- const data = new Uint8Array(buffer);
329
-
330
- await writeShard(modelDir, shardIndex, data, shardInfos, shardSizeBytes, converterConfig.manifest.hashAlgorithm);
331
-
332
- shardIndex++;
333
- offset = end;
334
-
335
- onProgress?.({
336
- stage: ImportStage.SHARDING,
337
- message: `Writing shard ${shardIndex}/${expectedShards}`,
338
- current: shardIndex,
339
- total: expectedShards,
340
- percent: Math.round(((offset - tensorDataOffset) / totalDataSize) * 100),
341
- });
342
- }
343
- }
344
-
345
-
346
- async function writeShard(
347
- modelDir,
348
- shardIndex,
349
- data,
350
- shardInfos,
351
- shardSizeBytes,
352
- hashAlgorithm
353
- ) {
354
- const filename = generateShardFilename(shardIndex);
355
- const hash = await computeHash(data, hashAlgorithm);
356
-
357
- // Get file handle and write
358
- const fileHandle = await modelDir.getFileHandle(filename, { create: true });
359
- const writable = await fileHandle.createWritable();
360
- await writable.write(new Uint8Array(data.buffer, data.byteOffset, data.length));
361
- await writable.close();
362
-
363
- // Record shard info
364
- shardInfos.push({
365
- index: shardIndex,
366
- filename,
367
- size: data.length,
368
- hash: hash, // SHA-256 hash
369
- offset: shardIndex * shardSizeBytes,
370
- });
371
- }
372
-
373
-
374
- function createManifest(
375
- ggufInfo,
376
- shardInfos,
377
- modelId,
378
- converterConfig,
379
- shardSizeBytes
380
- ) {
381
- const config = ggufInfo.config;
382
- if (!ggufInfo.architecture) {
383
- throw new Error('Missing GGUF architecture');
384
- }
385
- if (!ggufInfo.quantization) {
386
- throw new Error('Missing GGUF quantization');
387
- }
388
-
389
- const architecture = extractArchitecture({}, config);
390
-
391
- // Build MoE config if applicable
392
- let moeConfig = null;
393
- const expertCount = config.expertCount || config.num_local_experts || config.num_experts;
394
- if (expertCount) {
395
- const expertsPerToken = (
396
- config.expertUsedCount ||
397
- config.num_experts_per_tok ||
398
- config.num_experts_per_token ||
399
- config.experts_per_token
400
- );
401
- if (!expertsPerToken) {
402
- throw new Error('Missing expertsPerToken in GGUF config');
403
- }
404
- const expertFormat = config.expertFormat || config.expert_format;
405
- if (!expertFormat) {
406
- throw new Error('Missing expertFormat in GGUF config');
407
- }
408
- moeConfig = {
409
- numExperts: expertCount,
410
- numExpertsPerToken: expertsPerToken,
411
- expertFormat: expertFormat,
412
- };
413
- }
414
-
415
- // Calculate total size from shards
416
- const totalSize = shardInfos.reduce((sum, s) => sum + s.size, 0);
417
-
418
- const rawConfig = {
419
- model_type: ggufInfo.architecture,
420
- architectures: [ggufInfo.architecture],
421
- };
422
- if (config.ropeFreqBase) {
423
- rawConfig.rope_theta = config.ropeFreqBase;
424
- }
425
- if (config.ropeScalingType || config.ropeScalingFactor) {
426
- rawConfig.rope_scaling = {
427
- type: config.ropeScalingType ?? undefined,
428
- factor: config.ropeScalingFactor ?? undefined,
429
- };
430
- }
431
-
432
- const plan = resolveConversionPlan({
433
- rawConfig,
434
- tensors: ggufInfo.tensors,
435
- converterConfig,
436
- sourceQuantization: ggufInfo.quantization,
437
- modelKind: 'transformer',
438
- architectureHint: ggufInfo.architecture,
439
- architectureConfig: architecture,
440
- headDim: architecture.headDim,
441
- headDimErrorMessage: 'Missing headDim in GGUF architecture',
442
- });
443
- const inference = plan.manifestInference;
444
-
445
- // Build tensor location map
446
- // Maps each tensor to its shard(s) and offset within shard
447
- const tensors = buildTensorLocations(ggufInfo.tensors, ggufInfo.tensorDataOffset, shardSizeBytes);
448
-
449
- return {
450
- version: RDRR_VERSION,
451
- modelId,
452
- modelType: ggufInfo.architecture,
453
- quantization: ggufInfo.quantization,
454
- architecture,
455
- moeConfig,
456
- shards: shardInfos,
457
- tensors,
458
- totalSize,
459
- hashAlgorithm: converterConfig.manifest.hashAlgorithm,
460
- inference,
461
- metadata: {
462
- source: 'browser-import',
463
- originalFile: ggufInfo.modelName,
464
- importedAt: new Date().toISOString(),
465
- ggufVersion: ggufInfo.version,
466
- },
467
- };
468
- }
469
-
470
-
471
- function buildTensorLocations(
472
- ggufTensors,
473
- tensorDataOffset,
474
- shardSizeBytes
475
- ) {
476
- const tensors = {};
477
-
478
- for (const tensor of ggufTensors) {
479
- // Position relative to tensor data start (not file start)
480
- const relativeOffset = tensor.offset - tensorDataOffset;
481
-
482
- // Which shard does this tensor start in?
483
- const startShard = Math.floor(relativeOffset / shardSizeBytes);
484
- const offsetInShard = relativeOffset % shardSizeBytes;
485
-
486
- // Does tensor fit entirely in one shard?
487
- const endOffset = offsetInShard + tensor.size;
488
-
489
- if (endOffset <= shardSizeBytes) {
490
- // Tensor fits in single shard
491
- tensors[tensor.name] = {
492
- shard: startShard,
493
- offset: offsetInShard,
494
- size: tensor.size,
495
- shape: tensor.shape,
496
- dtype: tensor.dtype,
497
- };
498
- } else {
499
- // Tensor spans multiple shards - create spans array
500
- const spans = [];
501
- let remaining = tensor.size;
502
- let currentShard = startShard;
503
- let currentOffset = offsetInShard;
504
-
505
- while (remaining > 0) {
506
- const availableInShard = shardSizeBytes - currentOffset;
507
- const chunkSize = Math.min(remaining, availableInShard);
508
-
509
- spans.push({
510
- shardIndex: currentShard,
511
- offset: currentOffset,
512
- size: chunkSize,
513
- });
514
-
515
- remaining -= chunkSize;
516
- currentShard++;
517
- currentOffset = 0; // Next shard starts at offset 0
518
- }
519
-
520
- tensors[tensor.name] = {
521
- spans,
522
- size: tensor.size,
523
- shape: tensor.shape,
524
- dtype: tensor.dtype,
525
- };
526
- }
527
- }
528
-
529
- return tensors;
530
- }
531
-
532
- export default importGGUFFile;
@@ -1,14 +0,0 @@
1
- /**
2
- * gguf-parser-browser.ts - Browser-safe GGUF Parser
3
- *
4
- * Re-exports the shared GGUF parser for browser usage.
5
- *
6
- * @module browser/gguf-parser-browser
7
- */
8
-
9
- import type { GGUFParseResult } from '../../formats/gguf/types.js';
10
- import type { TensorSource } from './tensor-source-file.js';
11
-
12
- export declare function parseGGUFHeaderFromSource(source: TensorSource | File): Promise<GGUFParseResult & { fileSize: number }>;
13
-
14
- export * from '../../formats/gguf/types.js';
@@ -1,74 +0,0 @@
1
- /**
2
- * quantization.ts - Browser quantization helpers
3
- *
4
- * @module browser/quantization
5
- */
6
-
7
- import type { QuantizationInfoSchema, ConverterConfigSchema } from '../../config/index.js';
8
- import type { ConvertOptions } from '../../converter/core.js';
9
- import type { QuantizeResult } from '../../converter/quantizer.js';
10
-
11
- export declare function normalizeQuantTag(value: string | null | undefined): string;
12
-
13
- export declare function resolveManifestQuantization(quantize: string | null, fallback: string): string;
14
-
15
- export declare function buildQuantizationInfo(
16
- opts: ConvertOptions | ConverterConfigSchema,
17
- originalDtype: string,
18
- embedDtype: string | null,
19
- lmHeadDtype: string | null,
20
- hasVision?: boolean,
21
- hasAudio?: boolean,
22
- hasProjector?: boolean,
23
- modelConfig?: Record<string, unknown> | null
24
- ): QuantizationInfoSchema;
25
-
26
- export declare function resolveModelId(
27
- modelId: string | null,
28
- baseName: string,
29
- variantTag: string | undefined
30
- ): string;
31
-
32
- export declare function toWebGPUDtype(dtype: string): string;
33
-
34
- export declare function resolveEffectiveQuantizationInfo(
35
- baseInfo: QuantizationInfoSchema,
36
- tensors: Record<string, unknown>
37
- ): QuantizationInfoSchema;
38
-
39
- export declare function isMatmulWeight(name: string, shape: number[]): boolean;
40
-
41
- export declare function resolveTensorDtype(
42
- name: string,
43
- shape: number[],
44
- origDtype: string,
45
- quantizationInfo: QuantizationInfoSchema | null
46
- ): string;
47
-
48
- export declare function resolveQ4KLayout(
49
- name: string,
50
- shape: number[],
51
- quantizationInfo: QuantizationInfoSchema | null
52
- ): string | null;
53
-
54
- export declare function getQ4KOutputSize(shape: number[], layout: string | null): number;
55
-
56
- export declare function decodeTensorToFloat32(buffer: ArrayBuffer, sourceDtype: string): Float32Array;
57
-
58
- export declare function createQ4KChunkStream(
59
- chunks: AsyncIterable<Uint8Array>,
60
- sourceDtype: string,
61
- shape: number[],
62
- layout: string | null,
63
- chunkSizeBytes: number
64
- ): AsyncGenerator<Uint8Array>;
65
-
66
- export declare function createF16ChunkStream(
67
- chunks: AsyncIterable<Uint8Array>,
68
- sourceDtype: string
69
- ): AsyncGenerator<Uint8Array>;
70
-
71
- export declare function quantizeToQ4KColumnWise(
72
- data: Float32Array,
73
- shape: [number, number]
74
- ): QuantizeResult & { transposedShape: [number, number] };