doppler-gpu 0.2.0
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.
- package/BRANDING.md +14 -0
- package/CHANGELOG.md +158 -0
- package/LICENSE +201 -0
- package/NOTICE +5 -0
- package/README.md +85 -0
- package/SECURITY.md +19 -0
- package/package.json +195 -0
- package/src/adapters/adapter-manager.d.ts +200 -0
- package/src/adapters/adapter-manager.js +509 -0
- package/src/adapters/adapter-manifest.d.ts +290 -0
- package/src/adapters/adapter-manifest.js +320 -0
- package/src/adapters/adapter-registry.d.ts +192 -0
- package/src/adapters/adapter-registry.js +477 -0
- package/src/adapters/index.d.ts +89 -0
- package/src/adapters/index.js +42 -0
- package/src/adapters/lora-loader.d.ts +105 -0
- package/src/adapters/lora-loader.js +425 -0
- package/src/bootstrap.d.ts +1 -0
- package/src/bootstrap.js +30 -0
- package/src/bridge/extension/background.d.ts +14 -0
- package/src/bridge/extension/background.js +168 -0
- package/src/bridge/extension/manifest.json +34 -0
- package/src/bridge/extension-client.d.ts +114 -0
- package/src/bridge/extension-client.js +409 -0
- package/src/bridge/index.d.ts +69 -0
- package/src/bridge/index.js +53 -0
- package/src/bridge/node-bridge.js +26 -0
- package/src/bridge/protocol.d.ts +96 -0
- package/src/bridge/protocol.js +130 -0
- package/src/browser/browser-converter.d.ts +71 -0
- package/src/browser/browser-converter.js +978 -0
- package/src/browser/file-picker.d.ts +63 -0
- package/src/browser/file-picker.js +281 -0
- package/src/browser/gguf-importer.d.ts +136 -0
- package/src/browser/gguf-importer.js +532 -0
- package/src/browser/gguf-parser-browser.d.ts +14 -0
- package/src/browser/gguf-parser-browser.js +17 -0
- package/src/browser/quantization.d.ts +69 -0
- package/src/browser/quantization.js +328 -0
- package/src/browser/safetensors-parser-browser.d.ts +193 -0
- package/src/browser/safetensors-parser-browser.js +347 -0
- package/src/browser/shard-io-browser.d.ts +57 -0
- package/src/browser/shard-io-browser.js +89 -0
- package/src/browser/tensor-source-download.d.ts +27 -0
- package/src/browser/tensor-source-download.js +245 -0
- package/src/browser/tensor-source-file.d.ts +26 -0
- package/src/browser/tensor-source-file.js +53 -0
- package/src/browser/tensor-source-http.d.ts +29 -0
- package/src/browser/tensor-source-http.js +130 -0
- package/src/cli/config/doppler-cli-policy.json +28 -0
- package/src/cli/doppler-cli.d.ts +28 -0
- package/src/cli/doppler-cli.js +1664 -0
- package/src/client/doppler-api.browser.d.ts +1 -0
- package/src/client/doppler-api.browser.js +389 -0
- package/src/client/doppler-api.d.ts +83 -0
- package/src/client/doppler-api.js +389 -0
- package/src/client/doppler-provider/generation.d.ts +25 -0
- package/src/client/doppler-provider/generation.js +126 -0
- package/src/client/doppler-provider/index.d.ts +2 -0
- package/src/client/doppler-provider/index.js +3 -0
- package/src/client/doppler-provider/model-manager.d.ts +71 -0
- package/src/client/doppler-provider/model-manager.js +739 -0
- package/src/client/doppler-provider/provider.d.ts +5 -0
- package/src/client/doppler-provider/provider.js +102 -0
- package/src/client/doppler-provider/source-runtime.d.ts +23 -0
- package/src/client/doppler-provider/source-runtime.js +677 -0
- package/src/client/doppler-provider/types.d.ts +127 -0
- package/src/client/doppler-provider/types.js +17 -0
- package/src/client/doppler-provider.d.ts +46 -0
- package/src/client/doppler-provider.js +36 -0
- package/src/client/doppler-registry.d.ts +23 -0
- package/src/client/doppler-registry.js +86 -0
- package/src/client/doppler-registry.json +41 -0
- package/src/config/README.md +57 -0
- package/src/config/backward-registry-loader.d.ts +3 -0
- package/src/config/backward-registry-loader.js +23 -0
- package/src/config/conversion/README.md +147 -0
- package/src/config/conversion/embeddinggemma/google-embeddinggemma-300m-q4k-ehf16-af32.json +285 -0
- package/src/config/conversion/gemma3/gemma-3-1b-it-f16-af32.json +321 -0
- package/src/config/conversion/gemma3/gemma-3-1b-it-q4k-ehf16-af32.json +322 -0
- package/src/config/conversion/gemma3/gemma-3-270m-it-q4k-ehf16-af32.json +322 -0
- package/src/config/conversion/gemma3/translategemma-4b-1b-enes-q4k-ehf16-af32.json +322 -0
- package/src/config/conversion/gemma3/translategemma-4b-it-q4k-ehf16-af32.json +323 -0
- package/src/config/conversion/gemma4/gemma-4-moe-q4k-ehf16-af32.json +158 -0
- package/src/config/conversion/gpt-oss-20b-f16-xmxfp4.json +164 -0
- package/src/config/conversion/janus/janus-pro-1b-text-q4k-ehaf16.json +158 -0
- package/src/config/conversion/lfm2/lfm2.5-1.2b-instruct-q4k-ehf16-af32.json +339 -0
- package/src/config/conversion/qwen3/qwen-3-5-0-8b-q4k-ehaf16.json +385 -0
- package/src/config/conversion/qwen3/qwen-3-5-2b-q4k-ehaf16.json +385 -0
- package/src/config/conversion/sana/sana-sprint-0.6b-f16.json +219 -0
- package/src/config/execution-contract-check.d.ts +72 -0
- package/src/config/execution-contract-check.js +290 -0
- package/src/config/index.d.ts +52 -0
- package/src/config/index.js +22 -0
- package/src/config/kernel-path-loader.d.ts +156 -0
- package/src/config/kernel-path-loader.js +396 -0
- package/src/config/kernels/backward-registry.json +99 -0
- package/src/config/kernels/kernel-ref-digests.d.ts +1 -0
- package/src/config/kernels/kernel-ref-digests.js +233 -0
- package/src/config/kernels/kernel-ref.d.ts +17 -0
- package/src/config/kernels/kernel-ref.js +75 -0
- package/src/config/kernels/moe/gpt-oss.paths.json +49 -0
- package/src/config/kernels/moe/mixtral.paths.json +46 -0
- package/src/config/kernels/registry.d.ts +86 -0
- package/src/config/kernels/registry.js +116 -0
- package/src/config/kernels/registry.json +9446 -0
- package/src/config/merge-contract-check.d.ts +16 -0
- package/src/config/merge-contract-check.js +311 -0
- package/src/config/merge-helpers.d.ts +58 -0
- package/src/config/merge-helpers.js +179 -0
- package/src/config/merge.d.ts +153 -0
- package/src/config/merge.js +445 -0
- package/src/config/param-categories.d.ts +17 -0
- package/src/config/param-categories.js +72 -0
- package/src/config/param-validator.d.ts +26 -0
- package/src/config/param-validator.js +274 -0
- package/src/config/platforms/amd-rdna3.json +16 -0
- package/src/config/platforms/apple-m1.json +16 -0
- package/src/config/platforms/apple-m2.json +16 -0
- package/src/config/platforms/apple-m3.json +16 -0
- package/src/config/platforms/generic.json +14 -0
- package/src/config/platforms/loader.d.ts +65 -0
- package/src/config/platforms/loader.js +158 -0
- package/src/config/platforms/nvidia-gb200-8gpu.json +45 -0
- package/src/config/platforms/nvidia-gb200-nvl72.json +45 -0
- package/src/config/platforms/nvidia-gh200-nvl2.json +44 -0
- package/src/config/platforms/nvidia-gh200.json +44 -0
- package/src/config/platforms/nvidia-rtx30.json +16 -0
- package/src/config/platforms/nvidia-rtx40.json +16 -0
- package/src/config/quantization-contract-check.d.ts +12 -0
- package/src/config/quantization-contract-check.js +91 -0
- package/src/config/required-inference-fields-contract-check.d.ts +24 -0
- package/src/config/required-inference-fields-contract-check.js +238 -0
- package/src/config/runtime/compute/f16-activations.json +30 -0
- package/src/config/runtime/compute/f16-batched.json +32 -0
- package/src/config/runtime/default.json +100 -0
- package/src/config/runtime/diagnostics/debug-logits.json +53 -0
- package/src/config/runtime/diagnostics/drift-policies.json +147 -0
- package/src/config/runtime/experiments/bench/gemma3-bench-q4k.json +54 -0
- package/src/config/runtime/experiments/debug/gemma3-debug-q4k.json +210 -0
- package/src/config/runtime/experiments/verify/gemma3-verify.json +39 -0
- package/src/config/runtime/experiments/verify/lfm2-verify.json +46 -0
- package/src/config/runtime/experiments/verify/translategemma-verify.json +39 -0
- package/src/config/runtime/kernels/dequant-f16-q4k.json +13 -0
- package/src/config/runtime/kernels/dequant-f32-q4k.json +13 -0
- package/src/config/runtime/kernels/embeddinggemma-q4k-dequant-f32a.json +37 -0
- package/src/config/runtime/kernels/fused-q4k.json +13 -0
- package/src/config/runtime/kernels/gemma2-q4k-dequant-f16a.json +33 -0
- package/src/config/runtime/kernels/gemma2-q4k-dequant-f32a-nosubgroups.json +33 -0
- package/src/config/runtime/kernels/gemma2-q4k-fused-f32a.json +33 -0
- package/src/config/runtime/kernels/safe-q4k.json +13 -0
- package/src/config/runtime/model/gemma2-debug.json +77 -0
- package/src/config/runtime/model/gemma2-pipeline-debug.json +66 -0
- package/src/config/runtime/model/gemma2-pipeline.json +75 -0
- package/src/config/runtime/model/gemma3-layer-probe.json +85 -0
- package/src/config/runtime/model/qwen3-5-layer-probe.json +52 -0
- package/src/config/runtime/model/qwen3-5-layer3-boundary-probe.json +108 -0
- package/src/config/runtime/model/qwen3-5-linear-attn-debug.json +90 -0
- package/src/config/runtime/overlays/debug-f32a.json +3 -0
- package/src/config/runtime/overlays/trace-config.json +28 -0
- package/src/config/runtime/platform/metal-apple-q4k.json +11 -0
- package/src/config/runtime/profiles/default.json +10 -0
- package/src/config/runtime/profiles/low-memory.json +40 -0
- package/src/config/runtime/profiles/production.json +48 -0
- package/src/config/runtime/profiles/simulation.json +31 -0
- package/src/config/runtime/profiles/throughput.json +37 -0
- package/src/config/runtime/profiles/trace-layers.json +127 -0
- package/src/config/runtime/profiles/vector-stability.json +54 -0
- package/src/config/runtime/profiles/vector-throughput.json +28 -0
- package/src/config/runtime/profiles/verbose-trace.json +39 -0
- package/src/config/runtime/tiers/gemma4-16gb.json +69 -0
- package/src/config/runtime/tiers/gemma4-24gb.json +66 -0
- package/src/config/runtime/tiers/gemma4-32gb.json +66 -0
- package/src/config/runtime-merge.d.ts +5 -0
- package/src/config/runtime-merge.js +30 -0
- package/src/config/runtime.d.ts +28 -0
- package/src/config/runtime.js +69 -0
- package/src/config/schema/adapter.schema.d.ts +53 -0
- package/src/config/schema/adapter.schema.js +60 -0
- package/src/config/schema/backward-registry.schema.d.ts +14 -0
- package/src/config/schema/backward-registry.schema.js +46 -0
- package/src/config/schema/benchmark.schema.d.ts +54 -0
- package/src/config/schema/benchmark.schema.js +74 -0
- package/src/config/schema/bridge.schema.d.ts +25 -0
- package/src/config/schema/bridge.schema.js +22 -0
- package/src/config/schema/browser-suite-metrics.schema.d.ts +16 -0
- package/src/config/schema/browser-suite-metrics.schema.js +44 -0
- package/src/config/schema/buffer-pool.schema.d.ts +92 -0
- package/src/config/schema/buffer-pool.schema.js +50 -0
- package/src/config/schema/conversion-report.schema.d.ts +36 -0
- package/src/config/schema/conversion-report.schema.js +97 -0
- package/src/config/schema/conversion.schema.d.ts +191 -0
- package/src/config/schema/conversion.schema.js +13 -0
- package/src/config/schema/converter.schema.d.ts +117 -0
- package/src/config/schema/converter.schema.js +140 -0
- package/src/config/schema/debug.schema.d.ts +292 -0
- package/src/config/schema/debug.schema.js +134 -0
- package/src/config/schema/diffusion.schema.d.ts +88 -0
- package/src/config/schema/diffusion.schema.js +62 -0
- package/src/config/schema/distill-training.schema.d.ts +48 -0
- package/src/config/schema/distill-training.schema.js +139 -0
- package/src/config/schema/distribution.schema.d.ts +155 -0
- package/src/config/schema/distribution.schema.js +81 -0
- package/src/config/schema/doppler.schema.d.ts +74 -0
- package/src/config/schema/doppler.schema.js +341 -0
- package/src/config/schema/ecosystem.schema.d.ts +255 -0
- package/src/config/schema/ecosystem.schema.js +534 -0
- package/src/config/schema/emulation.schema.d.ts +351 -0
- package/src/config/schema/emulation.schema.js +301 -0
- package/src/config/schema/energy.schema.d.ts +102 -0
- package/src/config/schema/energy.schema.js +72 -0
- package/src/config/schema/execution-v1.schema.d.ts +258 -0
- package/src/config/schema/execution-v1.schema.js +211 -0
- package/src/config/schema/gpu-cache.schema.d.ts +26 -0
- package/src/config/schema/gpu-cache.schema.js +8 -0
- package/src/config/schema/harness.schema.d.ts +34 -0
- package/src/config/schema/harness.schema.js +21 -0
- package/src/config/schema/hotswap.schema.d.ts +55 -0
- package/src/config/schema/hotswap.schema.js +18 -0
- package/src/config/schema/index.d.ts +869 -0
- package/src/config/schema/index.js +498 -0
- package/src/config/schema/inference-defaults.schema.d.ts +276 -0
- package/src/config/schema/inference-defaults.schema.js +189 -0
- package/src/config/schema/inference.schema.d.ts +298 -0
- package/src/config/schema/inference.schema.js +39 -0
- package/src/config/schema/intent-bundle.schema.d.ts +28 -0
- package/src/config/schema/intent-bundle.schema.js +12 -0
- package/src/config/schema/kernel-path.schema.d.ts +184 -0
- package/src/config/schema/kernel-path.schema.js +9 -0
- package/src/config/schema/kernel-registry.schema.d.ts +199 -0
- package/src/config/schema/kernel-registry.schema.js +46 -0
- package/src/config/schema/kernel-thresholds.schema.d.ts +302 -0
- package/src/config/schema/kernel-thresholds.schema.js +195 -0
- package/src/config/schema/kernel-warmup.schema.d.ts +19 -0
- package/src/config/schema/kernel-warmup.schema.js +5 -0
- package/src/config/schema/kvcache.schema.d.ts +131 -0
- package/src/config/schema/kvcache.schema.js +41 -0
- package/src/config/schema/loading.schema.d.ts +153 -0
- package/src/config/schema/loading.schema.js +84 -0
- package/src/config/schema/lora.schema.d.ts +12 -0
- package/src/config/schema/lora.schema.js +12 -0
- package/src/config/schema/manifest.schema.d.ts +520 -0
- package/src/config/schema/manifest.schema.js +145 -0
- package/src/config/schema/memory-limits.schema.d.ts +107 -0
- package/src/config/schema/memory-limits.schema.js +57 -0
- package/src/config/schema/moe.schema.d.ts +78 -0
- package/src/config/schema/moe.schema.js +40 -0
- package/src/config/schema/platform.schema.d.ts +121 -0
- package/src/config/schema/platform.schema.js +1 -0
- package/src/config/schema/quantization-defaults.schema.d.ts +34 -0
- package/src/config/schema/quantization-defaults.schema.js +5 -0
- package/src/config/schema/quantization.schema.d.ts +10 -0
- package/src/config/schema/quantization.schema.js +33 -0
- package/src/config/schema/shared-runtime.schema.d.ts +75 -0
- package/src/config/schema/shared-runtime.schema.js +45 -0
- package/src/config/schema/speculation-self.schema.js +54 -0
- package/src/config/schema/speculative.schema.d.ts +21 -0
- package/src/config/schema/speculative.schema.js +11 -0
- package/src/config/schema/storage.schema.d.ts +123 -0
- package/src/config/schema/storage.schema.js +66 -0
- package/src/config/schema/tooling.schema.d.ts +29 -0
- package/src/config/schema/tooling.schema.js +12 -0
- package/src/config/schema/training-metrics.schema.d.ts +89 -0
- package/src/config/schema/training-metrics.schema.js +374 -0
- package/src/config/schema/training.schema.d.ts +88 -0
- package/src/config/schema/training.schema.js +106 -0
- package/src/config/schema/tuner.schema.d.ts +39 -0
- package/src/config/schema/tuner.schema.js +13 -0
- package/src/config/schema/ul-training.schema.d.ts +61 -0
- package/src/config/schema/ul-training.schema.js +140 -0
- package/src/config/schema/units.schema.d.ts +27 -0
- package/src/config/schema/units.schema.js +30 -0
- package/src/config/training-defaults.d.ts +24 -0
- package/src/config/training-defaults.js +99 -0
- package/src/config/transforms/capability-transform-resolver.d.ts +34 -0
- package/src/config/transforms/capability-transform-resolver.js +62 -0
- package/src/config/transforms/execution-graph-transforms.d.ts +92 -0
- package/src/config/transforms/execution-graph-transforms.js +512 -0
- package/src/converter/conversion-plan.d.ts +54 -0
- package/src/converter/conversion-plan.js +268 -0
- package/src/converter/core.d.ts +263 -0
- package/src/converter/core.js +1530 -0
- package/src/converter/index.d.ts +98 -0
- package/src/converter/index.js +59 -0
- package/src/converter/parsers/diffusion.d.ts +50 -0
- package/src/converter/parsers/diffusion.js +327 -0
- package/src/converter/parsers/gguf.d.ts +22 -0
- package/src/converter/parsers/gguf.js +46 -0
- package/src/converter/parsers/index.d.ts +21 -0
- package/src/converter/parsers/index.js +12 -0
- package/src/converter/parsers/transformer.d.ts +31 -0
- package/src/converter/parsers/transformer.js +198 -0
- package/src/converter/quantization-info.d.ts +37 -0
- package/src/converter/quantization-info.js +422 -0
- package/src/converter/quantizer.d.ts +101 -0
- package/src/converter/quantizer.js +444 -0
- package/src/converter/rope-config.d.ts +15 -0
- package/src/converter/rope-config.js +262 -0
- package/src/converter/shard-packer.d.ts +138 -0
- package/src/converter/shard-packer.js +425 -0
- package/src/converter/tokenizer-utils.d.ts +12 -0
- package/src/converter/tokenizer-utils.js +104 -0
- package/src/debug/capture-policy.d.ts +88 -0
- package/src/debug/capture-policy.js +196 -0
- package/src/debug/config.d.ts +78 -0
- package/src/debug/config.js +347 -0
- package/src/debug/history.d.ts +65 -0
- package/src/debug/history.js +82 -0
- package/src/debug/index.d.ts +268 -0
- package/src/debug/index.js +215 -0
- package/src/debug/log.d.ts +46 -0
- package/src/debug/log.js +132 -0
- package/src/debug/perf.d.ts +33 -0
- package/src/debug/perf.js +51 -0
- package/src/debug/reference/README.md +114 -0
- package/src/debug/reference/hf_attn_debug.py +114 -0
- package/src/debug/reference/hf_embed_check.py +89 -0
- package/src/debug/reference/hf_layer_out.py +100 -0
- package/src/debug/reference/hf_qwen35_linear_attn_debug.py +268 -0
- package/src/debug/reference/hf_rope_check.py +116 -0
- package/src/debug/reference/hf_weights.py +75 -0
- package/src/debug/signals.d.ts +63 -0
- package/src/debug/signals.js +39 -0
- package/src/debug/stats.d.ts +47 -0
- package/src/debug/stats.js +160 -0
- package/src/debug/tensor.d.ts +125 -0
- package/src/debug/tensor.js +268 -0
- package/src/debug/trace.d.ts +17 -0
- package/src/debug/trace.js +188 -0
- package/src/diffusion/config/expansion-lanes.json +29 -0
- package/src/diffusion/image-regression.d.ts +31 -0
- package/src/diffusion/image-regression.js +107 -0
- package/src/diffusion/index.d.ts +8 -0
- package/src/diffusion/index.js +8 -0
- package/src/distribution/p2p-control-plane.d.ts +52 -0
- package/src/distribution/p2p-control-plane.js +272 -0
- package/src/distribution/p2p-observability.d.ts +116 -0
- package/src/distribution/p2p-observability.js +303 -0
- package/src/distribution/p2p-transport-contract.d.ts +57 -0
- package/src/distribution/p2p-transport-contract.js +310 -0
- package/src/distribution/p2p-transport.js +75 -0
- package/src/distribution/p2p-webrtc-browser.d.ts +37 -0
- package/src/distribution/p2p-webrtc-browser.js +454 -0
- package/src/distribution/shard-delivery.d.ts +251 -0
- package/src/distribution/shard-delivery.js +2186 -0
- package/src/energy/index.d.ts +2 -0
- package/src/energy/index.js +2 -0
- package/src/errors/doppler-error.d.ts +20 -0
- package/src/errors/doppler-error.js +37 -0
- package/src/errors/index.d.ts +1 -0
- package/src/errors/index.js +1 -0
- package/src/formats/gguf/index.d.ts +8 -0
- package/src/formats/gguf/index.js +4 -0
- package/src/formats/gguf/types.d.ts +137 -0
- package/src/formats/gguf/types.js +460 -0
- package/src/formats/index.d.ts +51 -0
- package/src/formats/index.js +13 -0
- package/src/formats/rdrr/classification.d.ts +54 -0
- package/src/formats/rdrr/classification.js +329 -0
- package/src/formats/rdrr/groups.d.ts +35 -0
- package/src/formats/rdrr/groups.js +73 -0
- package/src/formats/rdrr/index.d.ts +25 -0
- package/src/formats/rdrr/index.js +19 -0
- package/src/formats/rdrr/manifest.d.ts +32 -0
- package/src/formats/rdrr/manifest.js +108 -0
- package/src/formats/rdrr/parsing.d.ts +27 -0
- package/src/formats/rdrr/parsing.js +167 -0
- package/src/formats/rdrr/tensor-config-validator.d.ts +42 -0
- package/src/formats/rdrr/tensor-config-validator.js +156 -0
- package/src/formats/rdrr/types.d.ts +201 -0
- package/src/formats/rdrr/types.js +16 -0
- package/src/formats/rdrr/validation.d.ts +9 -0
- package/src/formats/rdrr/validation.js +213 -0
- package/src/formats/safetensors/index.d.ts +8 -0
- package/src/formats/safetensors/index.js +4 -0
- package/src/formats/safetensors/types.d.ts +67 -0
- package/src/formats/safetensors/types.js +102 -0
- package/src/formats/tokenizer/index.d.ts +5 -0
- package/src/formats/tokenizer/index.js +3 -0
- package/src/formats/tokenizer/types.d.ts +9 -0
- package/src/formats/tokenizer/types.js +22 -0
- package/src/generation/index.d.ts +18 -0
- package/src/generation/index.js +32 -0
- package/src/gpu/command-recorder.d.ts +175 -0
- package/src/gpu/command-recorder.js +498 -0
- package/src/gpu/device.d.ts +142 -0
- package/src/gpu/device.js +532 -0
- package/src/gpu/kernel-runtime.d.ts +20 -0
- package/src/gpu/kernel-runtime.js +39 -0
- package/src/gpu/kernel-selection-cache.d.ts +13 -0
- package/src/gpu/kernel-selection-cache.js +13 -0
- package/src/gpu/kernel-selection-log.d.ts +12 -0
- package/src/gpu/kernel-selection-log.js +28 -0
- package/src/gpu/kernel-selector.d.ts +11 -0
- package/src/gpu/kernel-selector.js +10 -0
- package/src/gpu/kernel-tuner/benchmarks.d.ts +144 -0
- package/src/gpu/kernel-tuner/benchmarks.js +902 -0
- package/src/gpu/kernel-tuner/cache.d.ts +55 -0
- package/src/gpu/kernel-tuner/cache.js +152 -0
- package/src/gpu/kernel-tuner/index.d.ts +59 -0
- package/src/gpu/kernel-tuner/index.js +38 -0
- package/src/gpu/kernel-tuner/tuner.d.ts +82 -0
- package/src/gpu/kernel-tuner/tuner.js +247 -0
- package/src/gpu/kernel-tuner/types.d.ts +101 -0
- package/src/gpu/kernel-tuner/types.js +4 -0
- package/src/gpu/kernel-tuner.d.ts +33 -0
- package/src/gpu/kernel-tuner.js +12 -0
- package/src/gpu/kernels/README.md +127 -0
- package/src/gpu/kernels/attention.d.ts +236 -0
- package/src/gpu/kernels/attention.js +1437 -0
- package/src/gpu/kernels/attention.wgsl +249 -0
- package/src/gpu/kernels/attention_bdpa_decode_f16.wgsl +246 -0
- package/src/gpu/kernels/attention_decode.wgsl +233 -0
- package/src/gpu/kernels/attention_decode_chunked_f16.wgsl +183 -0
- package/src/gpu/kernels/attention_decode_chunked_f16kv.wgsl +208 -0
- package/src/gpu/kernels/attention_decode_f16.wgsl +202 -0
- package/src/gpu/kernels/attention_decode_f16kv.wgsl +224 -0
- package/src/gpu/kernels/attention_decode_online_f16.wgsl +223 -0
- package/src/gpu/kernels/attention_decode_online_f16kv.wgsl +225 -0
- package/src/gpu/kernels/attention_decode_optimized.wgsl +445 -0
- package/src/gpu/kernels/attention_decode_paged_f16.wgsl +172 -0
- package/src/gpu/kernels/attention_decode_paged_f16kv.wgsl +174 -0
- package/src/gpu/kernels/attention_decode_subgroup.wgsl +233 -0
- package/src/gpu/kernels/attention_decode_tiered_f16.wgsl +218 -0
- package/src/gpu/kernels/attention_decode_tiered_f16kv.wgsl +220 -0
- package/src/gpu/kernels/attention_decode_tiered_int4_f16kv.wgsl +242 -0
- package/src/gpu/kernels/attention_decode_tiered_int8_f16kv.wgsl +242 -0
- package/src/gpu/kernels/attention_f16.wgsl +214 -0
- package/src/gpu/kernels/attention_f16kv.wgsl +242 -0
- package/src/gpu/kernels/attention_small.wgsl +260 -0
- package/src/gpu/kernels/attention_small_f16.wgsl +240 -0
- package/src/gpu/kernels/attention_small_f16kv.wgsl +266 -0
- package/src/gpu/kernels/attention_streaming.wgsl +149 -0
- package/src/gpu/kernels/attention_streaming_f16.wgsl +147 -0
- package/src/gpu/kernels/attention_streaming_f16kv.wgsl +151 -0
- package/src/gpu/kernels/backward/adam.d.ts +28 -0
- package/src/gpu/kernels/backward/adam.js +203 -0
- package/src/gpu/kernels/backward/adam.wgsl +50 -0
- package/src/gpu/kernels/backward/attention_backward.d.ts +22 -0
- package/src/gpu/kernels/backward/attention_backward.js +364 -0
- package/src/gpu/kernels/backward/attention_backward.wgsl +49 -0
- package/src/gpu/kernels/backward/bias_add_backward.d.ts +17 -0
- package/src/gpu/kernels/backward/bias_add_backward.js +24 -0
- package/src/gpu/kernels/backward/bias_add_backward.wgsl +33 -0
- package/src/gpu/kernels/backward/conv2d_backward.d.ts +31 -0
- package/src/gpu/kernels/backward/conv2d_backward.js +148 -0
- package/src/gpu/kernels/backward/conv2d_backward_input.wgsl +83 -0
- package/src/gpu/kernels/backward/conv2d_backward_weight.wgsl +70 -0
- package/src/gpu/kernels/backward/cross_entropy_backward.d.ts +23 -0
- package/src/gpu/kernels/backward/cross_entropy_backward.js +29 -0
- package/src/gpu/kernels/backward/cross_entropy_backward.wgsl +39 -0
- package/src/gpu/kernels/backward/embed_backward.d.ts +29 -0
- package/src/gpu/kernels/backward/embed_backward.js +118 -0
- package/src/gpu/kernels/backward/embed_backward.wgsl +73 -0
- package/src/gpu/kernels/backward/gelu_backward.d.ts +16 -0
- package/src/gpu/kernels/backward/gelu_backward.js +39 -0
- package/src/gpu/kernels/backward/gelu_backward.wgsl +38 -0
- package/src/gpu/kernels/backward/groupnorm_backward.d.ts +24 -0
- package/src/gpu/kernels/backward/groupnorm_backward.js +29 -0
- package/src/gpu/kernels/backward/groupnorm_backward.wgsl +143 -0
- package/src/gpu/kernels/backward/index.d.ts +17 -0
- package/src/gpu/kernels/backward/index.js +23 -0
- package/src/gpu/kernels/backward/layernorm_backward.d.ts +22 -0
- package/src/gpu/kernels/backward/layernorm_backward.js +135 -0
- package/src/gpu/kernels/backward/layernorm_backward.wgsl +194 -0
- package/src/gpu/kernels/backward/matmul_backward.d.ts +32 -0
- package/src/gpu/kernels/backward/matmul_backward.js +124 -0
- package/src/gpu/kernels/backward/matmul_backward.wgsl +90 -0
- package/src/gpu/kernels/backward/matmul_transpose_a.wgsl +84 -0
- package/src/gpu/kernels/backward/pixel_shuffle_backward.d.ts +22 -0
- package/src/gpu/kernels/backward/pixel_shuffle_backward.js +30 -0
- package/src/gpu/kernels/backward/pixel_shuffle_backward.wgsl +54 -0
- package/src/gpu/kernels/backward/rmsnorm_backward.d.ts +24 -0
- package/src/gpu/kernels/backward/rmsnorm_backward.js +101 -0
- package/src/gpu/kernels/backward/rmsnorm_backward.wgsl +78 -0
- package/src/gpu/kernels/backward/rope_backward.d.ts +25 -0
- package/src/gpu/kernels/backward/rope_backward.js +109 -0
- package/src/gpu/kernels/backward/rope_backward.wgsl +59 -0
- package/src/gpu/kernels/backward/scale_backward.d.ts +16 -0
- package/src/gpu/kernels/backward/scale_backward.js +84 -0
- package/src/gpu/kernels/backward/scale_backward.wgsl +27 -0
- package/src/gpu/kernels/backward/silu_backward.d.ts +16 -0
- package/src/gpu/kernels/backward/silu_backward.js +39 -0
- package/src/gpu/kernels/backward/silu_backward.wgsl +31 -0
- package/src/gpu/kernels/backward/softmax_backward.d.ts +16 -0
- package/src/gpu/kernels/backward/softmax_backward.js +43 -0
- package/src/gpu/kernels/backward/softmax_backward.wgsl +44 -0
- package/src/gpu/kernels/backward/upsample2d_backward.d.ts +21 -0
- package/src/gpu/kernels/backward/upsample2d_backward.js +30 -0
- package/src/gpu/kernels/backward/upsample2d_backward.wgsl +59 -0
- package/src/gpu/kernels/backward/utils.d.ts +45 -0
- package/src/gpu/kernels/backward/utils.js +371 -0
- package/src/gpu/kernels/bf16_to_f16.wgsl +54 -0
- package/src/gpu/kernels/bf16_to_f32.wgsl +70 -0
- package/src/gpu/kernels/bias_add.wgsl +42 -0
- package/src/gpu/kernels/bias_add_f16.wgsl +47 -0
- package/src/gpu/kernels/cast.d.ts +67 -0
- package/src/gpu/kernels/cast.js +339 -0
- package/src/gpu/kernels/cast_f16_to_f32.wgsl +31 -0
- package/src/gpu/kernels/cast_f32_to_f16.wgsl +36 -0
- package/src/gpu/kernels/check-finiteness.d.ts +15 -0
- package/src/gpu/kernels/check-finiteness.js +149 -0
- package/src/gpu/kernels/check-stop.d.ts +31 -0
- package/src/gpu/kernels/check-stop.js +170 -0
- package/src/gpu/kernels/clamp.d.ts +22 -0
- package/src/gpu/kernels/clamp.js +42 -0
- package/src/gpu/kernels/clamp.wgsl +24 -0
- package/src/gpu/kernels/codegen/patches/attention_decode_f16.from.attention_decode.diff +213 -0
- package/src/gpu/kernels/codegen/patches/attention_decode_f16kv.from.attention_decode.diff +89 -0
- package/src/gpu/kernels/codegen/patches/attention_f16.from.attention.diff +258 -0
- package/src/gpu/kernels/codegen/patches/attention_f16kv.from.attention.diff +114 -0
- package/src/gpu/kernels/codegen/patches/attention_small_f16.from.attention_small.diff +193 -0
- package/src/gpu/kernels/codegen/patches/attention_small_f16kv.from.attention_small.diff +264 -0
- package/src/gpu/kernels/codegen/patches/attention_streaming_f16.from.attention_streaming.diff +109 -0
- package/src/gpu/kernels/codegen/patches/attention_streaming_f16kv.from.attention_streaming.diff +53 -0
- package/src/gpu/kernels/codegen/patches/bias_add_f16.from.bias_add.diff +54 -0
- package/src/gpu/kernels/codegen/patches/dequant_mxfp4_expert_f16.from.dequant_mxfp4_expert.diff +125 -0
- package/src/gpu/kernels/codegen/patches/fused_ffn_f16.from.fused_ffn.diff +428 -0
- package/src/gpu/kernels/codegen/patches/fused_matmul_q4_batched_f16.from.fused_matmul_q4_batched.diff +114 -0
- package/src/gpu/kernels/codegen/patches/fused_matmul_rmsnorm_f16.from.fused_matmul_rmsnorm.diff +477 -0
- package/src/gpu/kernels/codegen/patches/fused_swiglu_f16.from.fused_swiglu.diff +60 -0
- package/src/gpu/kernels/codegen/patches/gelu_f16.from.gelu.diff +58 -0
- package/src/gpu/kernels/codegen/patches/layernorm_f16.from.layernorm.diff +82 -0
- package/src/gpu/kernels/codegen/patches/matmul_gemv_residual_f16.from.matmul_gemv_residual.diff +87 -0
- package/src/gpu/kernels/codegen/patches/moe_gather_f16.from.moe_gather.diff +181 -0
- package/src/gpu/kernels/codegen/patches/residual_f16.from.residual.diff +62 -0
- package/src/gpu/kernels/codegen/patches/rmsnorm_f16.from.rmsnorm.diff +430 -0
- package/src/gpu/kernels/codegen/patches/rope_f16.from.rope.diff +462 -0
- package/src/gpu/kernels/codegen/patches/sample_f16.from.sample.diff +307 -0
- package/src/gpu/kernels/codegen/patches/scatter_add_dynamic_f16.from.scatter_add_dynamic.diff +65 -0
- package/src/gpu/kernels/codegen/patches/silu_f16.from.silu.diff +81 -0
- package/src/gpu/kernels/codegen/patches/topk_f16.from.topk.diff +231 -0
- package/src/gpu/kernels/codegen/wgsl-patch-variants.js +152 -0
- package/src/gpu/kernels/codegen/wgsl-variants.js +733 -0
- package/src/gpu/kernels/constants.d.ts +168 -0
- package/src/gpu/kernels/constants.js +142 -0
- package/src/gpu/kernels/conv2d.d.ts +34 -0
- package/src/gpu/kernels/conv2d.js +91 -0
- package/src/gpu/kernels/conv2d.wgsl +70 -0
- package/src/gpu/kernels/conv2d_f16.wgsl +72 -0
- package/src/gpu/kernels/cross_entropy_loss.d.ts +21 -0
- package/src/gpu/kernels/cross_entropy_loss.js +60 -0
- package/src/gpu/kernels/cross_entropy_loss.wgsl +39 -0
- package/src/gpu/kernels/depthwise_conv2d.d.ts +29 -0
- package/src/gpu/kernels/depthwise_conv2d.js +109 -0
- package/src/gpu/kernels/depthwise_conv2d.wgsl +55 -0
- package/src/gpu/kernels/depthwise_conv2d_f16.wgsl +59 -0
- package/src/gpu/kernels/dequant.d.ts +108 -0
- package/src/gpu/kernels/dequant.js +575 -0
- package/src/gpu/kernels/dequant_f16_out.wgsl +153 -0
- package/src/gpu/kernels/dequant_f16_out_vec4.wgsl +152 -0
- package/src/gpu/kernels/dequant_f16_rowwise.wgsl +139 -0
- package/src/gpu/kernels/dequant_f32_rowwise.wgsl +133 -0
- package/src/gpu/kernels/dequant_mxfp4.wgsl +120 -0
- package/src/gpu/kernels/dequant_mxfp4_expert.wgsl +129 -0
- package/src/gpu/kernels/dequant_mxfp4_expert_f16.wgsl +105 -0
- package/src/gpu/kernels/dequant_mxfp4_vec4.wgsl +116 -0
- package/src/gpu/kernels/dequant_q6k.wgsl +140 -0
- package/src/gpu/kernels/dequant_q8_0.wgsl +98 -0
- package/src/gpu/kernels/dequant_shared.wgsl +200 -0
- package/src/gpu/kernels/dequant_shared_vec4.wgsl +160 -0
- package/src/gpu/kernels/dequant_subgroup.wgsl +206 -0
- package/src/gpu/kernels/dispatch.d.ts +157 -0
- package/src/gpu/kernels/dispatch.js +235 -0
- package/src/gpu/kernels/energy.d.ts +113 -0
- package/src/gpu/kernels/energy.js +448 -0
- package/src/gpu/kernels/energy_eval.wgsl +26 -0
- package/src/gpu/kernels/energy_eval_f16.wgsl +30 -0
- package/src/gpu/kernels/energy_quintel_grad.wgsl +92 -0
- package/src/gpu/kernels/energy_quintel_grad_f16.wgsl +96 -0
- package/src/gpu/kernels/energy_quintel_reduce.wgsl +112 -0
- package/src/gpu/kernels/energy_quintel_reduce_f16.wgsl +116 -0
- package/src/gpu/kernels/energy_quintel_update.wgsl +92 -0
- package/src/gpu/kernels/energy_quintel_update_f16.wgsl +96 -0
- package/src/gpu/kernels/energy_update.wgsl +25 -0
- package/src/gpu/kernels/energy_update_f16.wgsl +30 -0
- package/src/gpu/kernels/feature-check.d.ts +42 -0
- package/src/gpu/kernels/feature-check.js +70 -0
- package/src/gpu/kernels/fused_ffn.d.ts +65 -0
- package/src/gpu/kernels/fused_ffn.js +326 -0
- package/src/gpu/kernels/fused_ffn.wgsl +420 -0
- package/src/gpu/kernels/fused_ffn_f16.wgsl +213 -0
- package/src/gpu/kernels/fused_ffn_q4k.wgsl +375 -0
- package/src/gpu/kernels/fused_matmul_q4.wgsl +404 -0
- package/src/gpu/kernels/fused_matmul_q4_batched.wgsl +194 -0
- package/src/gpu/kernels/fused_matmul_q4_batched_f16.wgsl +170 -0
- package/src/gpu/kernels/fused_matmul_q4_batched_f16a.wgsl +154 -0
- package/src/gpu/kernels/fused_matmul_q4_f16a.wgsl +219 -0
- package/src/gpu/kernels/fused_matmul_q4_multicol_f16.wgsl +216 -0
- package/src/gpu/kernels/fused_matmul_q4_multicol_f16a.wgsl +204 -0
- package/src/gpu/kernels/fused_matmul_residual.d.ts +46 -0
- package/src/gpu/kernels/fused_matmul_residual.js +175 -0
- package/src/gpu/kernels/fused_matmul_rmsnorm.d.ts +64 -0
- package/src/gpu/kernels/fused_matmul_rmsnorm.js +290 -0
- package/src/gpu/kernels/fused_matmul_rmsnorm.wgsl +324 -0
- package/src/gpu/kernels/fused_matmul_rmsnorm_f16.wgsl +303 -0
- package/src/gpu/kernels/fused_swiglu.wgsl +63 -0
- package/src/gpu/kernels/fused_swiglu_f16.wgsl +57 -0
- package/src/gpu/kernels/gated-short-conv.d.ts +63 -0
- package/src/gpu/kernels/gated-short-conv.js +284 -0
- package/src/gpu/kernels/gather.d.ts +64 -0
- package/src/gpu/kernels/gather.js +137 -0
- package/src/gpu/kernels/gather.wgsl +61 -0
- package/src/gpu/kernels/gather_f16.wgsl +65 -0
- package/src/gpu/kernels/gather_f16_f16_out.wgsl +55 -0
- package/src/gpu/kernels/gather_f16_out.wgsl +55 -0
- package/src/gpu/kernels/gather_f16_vec4.wgsl +76 -0
- package/src/gpu/kernels/gather_f16_vec4_f16_out.wgsl +68 -0
- package/src/gpu/kernels/gather_vec4.wgsl +74 -0
- package/src/gpu/kernels/gather_vec4_f16_out.wgsl +68 -0
- package/src/gpu/kernels/gelu.d.ts +33 -0
- package/src/gpu/kernels/gelu.js +55 -0
- package/src/gpu/kernels/gelu.wgsl +64 -0
- package/src/gpu/kernels/gelu_f16.wgsl +66 -0
- package/src/gpu/kernels/gptoss_mxfp4_expert_fused.wgsl +127 -0
- package/src/gpu/kernels/gptoss_router_topk.wgsl +119 -0
- package/src/gpu/kernels/grouped_pointwise_conv2d.d.ts +27 -0
- package/src/gpu/kernels/grouped_pointwise_conv2d.js +103 -0
- package/src/gpu/kernels/grouped_pointwise_conv2d.wgsl +44 -0
- package/src/gpu/kernels/grouped_pointwise_conv2d_f16.wgsl +48 -0
- package/src/gpu/kernels/groupnorm.d.ts +31 -0
- package/src/gpu/kernels/groupnorm.js +102 -0
- package/src/gpu/kernels/groupnorm_apply.wgsl +41 -0
- package/src/gpu/kernels/groupnorm_apply_f16.wgsl +46 -0
- package/src/gpu/kernels/groupnorm_stats.wgsl +76 -0
- package/src/gpu/kernels/groupnorm_stats_f16.wgsl +79 -0
- package/src/gpu/kernels/index.d.ts +374 -0
- package/src/gpu/kernels/index.js +315 -0
- package/src/gpu/kernels/kernel-base.d.ts +33 -0
- package/src/gpu/kernels/kernel-base.js +46 -0
- package/src/gpu/kernels/kernel-configs.d.ts +65 -0
- package/src/gpu/kernels/kernel-configs.js +60 -0
- package/src/gpu/kernels/kernel-tuning.d.ts +42 -0
- package/src/gpu/kernels/kernel-tuning.js +158 -0
- package/src/gpu/kernels/kv-quantize.d.ts +37 -0
- package/src/gpu/kernels/kv-quantize.js +141 -0
- package/src/gpu/kernels/kv_quantize_int4.wgsl +119 -0
- package/src/gpu/kernels/kv_quantize_int8.wgsl +119 -0
- package/src/gpu/kernels/layernorm.d.ts +37 -0
- package/src/gpu/kernels/layernorm.js +96 -0
- package/src/gpu/kernels/layernorm.wgsl +121 -0
- package/src/gpu/kernels/layernorm_f16.wgsl +103 -0
- package/src/gpu/kernels/linear-attention-core.d.ts +39 -0
- package/src/gpu/kernels/linear-attention-core.js +559 -0
- package/src/gpu/kernels/logit-merge.d.ts +110 -0
- package/src/gpu/kernels/logit-merge.js +394 -0
- package/src/gpu/kernels/matmul-dispatch.d.ts +38 -0
- package/src/gpu/kernels/matmul-dispatch.js +156 -0
- package/src/gpu/kernels/matmul-selection.d.ts +87 -0
- package/src/gpu/kernels/matmul-selection.js +518 -0
- package/src/gpu/kernels/matmul.d.ts +114 -0
- package/src/gpu/kernels/matmul.js +384 -0
- package/src/gpu/kernels/matmul_f16.wgsl +170 -0
- package/src/gpu/kernels/matmul_f16_tiled.wgsl +165 -0
- package/src/gpu/kernels/matmul_f16w_f32a.wgsl +89 -0
- package/src/gpu/kernels/matmul_f16w_f32a_tiled.wgsl +154 -0
- package/src/gpu/kernels/matmul_f32.wgsl +100 -0
- package/src/gpu/kernels/matmul_gemv.wgsl +80 -0
- package/src/gpu/kernels/matmul_gemv_f16a.wgsl +81 -0
- package/src/gpu/kernels/matmul_gemv_residual.wgsl +119 -0
- package/src/gpu/kernels/matmul_gemv_residual_f16.wgsl +78 -0
- package/src/gpu/kernels/matmul_gemv_subgroup.wgsl +429 -0
- package/src/gpu/kernels/matmul_gemv_subgroup_f16a.wgsl +674 -0
- package/src/gpu/kernels/modulate.d.ts +29 -0
- package/src/gpu/kernels/modulate.js +57 -0
- package/src/gpu/kernels/modulate.wgsl +40 -0
- package/src/gpu/kernels/modulate_f16.wgsl +43 -0
- package/src/gpu/kernels/moe.d.ts +164 -0
- package/src/gpu/kernels/moe.js +542 -0
- package/src/gpu/kernels/moe_gather.wgsl +170 -0
- package/src/gpu/kernels/moe_gather_f16.wgsl +82 -0
- package/src/gpu/kernels/moe_gather_vec4.wgsl +74 -0
- package/src/gpu/kernels/moe_offsets.wgsl +48 -0
- package/src/gpu/kernels/pipeline-cache.d.ts +88 -0
- package/src/gpu/kernels/pipeline-cache.js +305 -0
- package/src/gpu/kernels/pixel_shuffle.d.ts +27 -0
- package/src/gpu/kernels/pixel_shuffle.js +57 -0
- package/src/gpu/kernels/pixel_shuffle.wgsl +43 -0
- package/src/gpu/kernels/pixel_shuffle_f16.wgsl +46 -0
- package/src/gpu/kernels/relu.d.ts +18 -0
- package/src/gpu/kernels/relu.js +66 -0
- package/src/gpu/kernels/relu.wgsl +22 -0
- package/src/gpu/kernels/relu_f16.wgsl +24 -0
- package/src/gpu/kernels/rep-penalty.js +103 -0
- package/src/gpu/kernels/rep_penalty.wgsl +57 -0
- package/src/gpu/kernels/rep_penalty_f16.wgsl +54 -0
- package/src/gpu/kernels/repeat_channels.d.ts +21 -0
- package/src/gpu/kernels/repeat_channels.js +68 -0
- package/src/gpu/kernels/repeat_channels.wgsl +28 -0
- package/src/gpu/kernels/repeat_channels_f16.wgsl +30 -0
- package/src/gpu/kernels/residual.d.ts +74 -0
- package/src/gpu/kernels/residual.js +173 -0
- package/src/gpu/kernels/residual.wgsl +56 -0
- package/src/gpu/kernels/residual_f16.wgsl +36 -0
- package/src/gpu/kernels/residual_f16_vec4.wgsl +48 -0
- package/src/gpu/kernels/residual_vec4.wgsl +47 -0
- package/src/gpu/kernels/rmsnorm.d.ts +53 -0
- package/src/gpu/kernels/rmsnorm.js +256 -0
- package/src/gpu/kernels/rmsnorm.wgsl +449 -0
- package/src/gpu/kernels/rmsnorm_f16.wgsl +198 -0
- package/src/gpu/kernels/rope.d.ts +50 -0
- package/src/gpu/kernels/rope.js +91 -0
- package/src/gpu/kernels/rope.wgsl +344 -0
- package/src/gpu/kernels/rope_f16.wgsl +271 -0
- package/src/gpu/kernels/rule-matcher.d.ts +30 -0
- package/src/gpu/kernels/rule-matcher.js +42 -0
- package/src/gpu/kernels/rule-registry.d.ts +7 -0
- package/src/gpu/kernels/rule-registry.js +54 -0
- package/src/gpu/kernels/sample.d.ts +75 -0
- package/src/gpu/kernels/sample.js +565 -0
- package/src/gpu/kernels/sample.wgsl +407 -0
- package/src/gpu/kernels/sample_f16.wgsl +363 -0
- package/src/gpu/kernels/sana_linear_attention.d.ts +27 -0
- package/src/gpu/kernels/sana_linear_attention.js +129 -0
- package/src/gpu/kernels/sana_linear_attention_apply.wgsl +43 -0
- package/src/gpu/kernels/sana_linear_attention_apply_f16.wgsl +46 -0
- package/src/gpu/kernels/sana_linear_attention_summary.wgsl +51 -0
- package/src/gpu/kernels/sana_linear_attention_summary_f16.wgsl +53 -0
- package/src/gpu/kernels/scale.d.ts +35 -0
- package/src/gpu/kernels/scale.js +44 -0
- package/src/gpu/kernels/scale.wgsl +38 -0
- package/src/gpu/kernels/scatter_add.wgsl +88 -0
- package/src/gpu/kernels/scatter_add_dynamic.wgsl +59 -0
- package/src/gpu/kernels/scatter_add_dynamic_f16.wgsl +52 -0
- package/src/gpu/kernels/scatter_add_dynamic_f16_weights.wgsl +50 -0
- package/src/gpu/kernels/scatter_add_vec4.wgsl +70 -0
- package/src/gpu/kernels/shader-cache.d.ts +56 -0
- package/src/gpu/kernels/shader-cache.js +234 -0
- package/src/gpu/kernels/silu.d.ts +76 -0
- package/src/gpu/kernels/silu.js +406 -0
- package/src/gpu/kernels/silu.wgsl +109 -0
- package/src/gpu/kernels/silu_f16.wgsl +108 -0
- package/src/gpu/kernels/softmax.d.ts +57 -0
- package/src/gpu/kernels/softmax.js +125 -0
- package/src/gpu/kernels/softmax.wgsl +388 -0
- package/src/gpu/kernels/softmax_subgroup.wgsl +175 -0
- package/src/gpu/kernels/split_qg.d.ts +50 -0
- package/src/gpu/kernels/split_qg.js +46 -0
- package/src/gpu/kernels/split_qg.wgsl +58 -0
- package/src/gpu/kernels/split_qg_f16.wgsl +62 -0
- package/src/gpu/kernels/split_qkv.d.ts +51 -0
- package/src/gpu/kernels/split_qkv.js +51 -0
- package/src/gpu/kernels/split_qkv.wgsl +71 -0
- package/src/gpu/kernels/split_qkv_f16.wgsl +75 -0
- package/src/gpu/kernels/topk.wgsl +243 -0
- package/src/gpu/kernels/topk_f16.wgsl +108 -0
- package/src/gpu/kernels/topk_f16_weights.wgsl +101 -0
- package/src/gpu/kernels/transpose.d.ts +21 -0
- package/src/gpu/kernels/transpose.js +51 -0
- package/src/gpu/kernels/transpose.wgsl +33 -0
- package/src/gpu/kernels/types.d.ts +21 -0
- package/src/gpu/kernels/types.js +4 -0
- package/src/gpu/kernels/uniform-utils.d.ts +48 -0
- package/src/gpu/kernels/uniform-utils.js +94 -0
- package/src/gpu/kernels/upsample2d.d.ts +25 -0
- package/src/gpu/kernels/upsample2d.js +67 -0
- package/src/gpu/kernels/upsample2d.wgsl +34 -0
- package/src/gpu/kernels/upsample2d_f16.wgsl +38 -0
- package/src/gpu/kernels/utils.d.ts +106 -0
- package/src/gpu/kernels/utils.js +257 -0
- package/src/gpu/multi-model-recorder.d.ts +21 -0
- package/src/gpu/multi-model-recorder.js +31 -0
- package/src/gpu/partitioned-buffer-pool.d.ts +28 -0
- package/src/gpu/partitioned-buffer-pool.js +57 -0
- package/src/gpu/perf-guards.d.ts +25 -0
- package/src/gpu/perf-guards.js +133 -0
- package/src/gpu/profiler.d.ts +114 -0
- package/src/gpu/profiler.js +406 -0
- package/src/gpu/readback-utils.d.ts +16 -0
- package/src/gpu/readback-utils.js +41 -0
- package/src/gpu/submit-tracker.d.ts +111 -0
- package/src/gpu/submit-tracker.js +242 -0
- package/src/gpu/tensor.d.ts +69 -0
- package/src/gpu/tensor.js +75 -0
- package/src/gpu/uniform-cache.d.ts +109 -0
- package/src/gpu/uniform-cache.js +263 -0
- package/src/gpu/weight-buffer.d.ts +121 -0
- package/src/gpu/weight-buffer.js +132 -0
- package/src/hotswap/intent-bundle.d.ts +37 -0
- package/src/hotswap/intent-bundle.js +129 -0
- package/src/hotswap/manifest.d.ts +42 -0
- package/src/hotswap/manifest.js +124 -0
- package/src/hotswap/model-swap.js +42 -0
- package/src/hotswap/runtime.d.ts +31 -0
- package/src/hotswap/runtime.js +150 -0
- package/src/index-browser.d.ts +92 -0
- package/src/index-browser.js +68 -0
- package/src/index-internal.d.ts +2 -0
- package/src/index-internal.js +2 -0
- package/src/index.d.ts +103 -0
- package/src/index.js +76 -0
- package/src/inference/README.md +593 -0
- package/src/inference/browser-harness-contract-helpers.d.ts +5 -0
- package/src/inference/browser-harness-contract-helpers.js +26 -0
- package/src/inference/browser-harness-diffusion-energy-suites.d.ts +2 -0
- package/src/inference/browser-harness-diffusion-energy-suites.js +269 -0
- package/src/inference/browser-harness-model-helpers.d.ts +16 -0
- package/src/inference/browser-harness-model-helpers.js +217 -0
- package/src/inference/browser-harness-report-helpers.d.ts +7 -0
- package/src/inference/browser-harness-report-helpers.js +42 -0
- package/src/inference/browser-harness-runtime-helpers.d.ts +61 -0
- package/src/inference/browser-harness-runtime-helpers.js +416 -0
- package/src/inference/browser-harness-suite-helpers.d.ts +28 -0
- package/src/inference/browser-harness-suite-helpers.js +270 -0
- package/src/inference/browser-harness-text-helpers.d.ts +34 -0
- package/src/inference/browser-harness-text-helpers.js +879 -0
- package/src/inference/browser-harness.d.ts +249 -0
- package/src/inference/browser-harness.js +1150 -0
- package/src/inference/decode-buffers.d.ts +108 -0
- package/src/inference/decode-buffers.js +181 -0
- package/src/inference/decode-ring.d.ts +52 -0
- package/src/inference/decode-ring.js +273 -0
- package/src/inference/expert-router.d.ts +27 -0
- package/src/inference/expert-router.js +55 -0
- package/src/inference/fixtures/embedding-semantic-fixtures.json +382 -0
- package/src/inference/functiongemma.d.ts +15 -0
- package/src/inference/functiongemma.js +1 -0
- package/src/inference/kv-cache/base.d.ts +150 -0
- package/src/inference/kv-cache/base.js +1105 -0
- package/src/inference/kv-cache/basis-decomposed-paged.d.ts +50 -0
- package/src/inference/kv-cache/basis-decomposed-paged.js +276 -0
- package/src/inference/kv-cache/index.d.ts +35 -0
- package/src/inference/kv-cache/index.js +20 -0
- package/src/inference/kv-cache/sliding-window.d.ts +72 -0
- package/src/inference/kv-cache/sliding-window.js +243 -0
- package/src/inference/kv-cache/tiered.d.ts +89 -0
- package/src/inference/kv-cache/tiered.js +576 -0
- package/src/inference/kv-cache/types.d.ts +188 -0
- package/src/inference/kv-cache/types.js +80 -0
- package/src/inference/kv-cache.d.ts +36 -0
- package/src/inference/kv-cache.js +18 -0
- package/src/inference/moe-router.d.ts +212 -0
- package/src/inference/moe-router.js +600 -0
- package/src/inference/multi-model-network.d.ts +139 -0
- package/src/inference/multi-model-network.js +771 -0
- package/src/inference/multi-pipeline-pool.d.ts +62 -0
- package/src/inference/multi-pipeline-pool.js +161 -0
- package/src/inference/network-evolution.d.ts +55 -0
- package/src/inference/network-evolution.js +79 -0
- package/src/inference/pipelines/context.d.ts +21 -0
- package/src/inference/pipelines/context.js +184 -0
- package/src/inference/pipelines/diffusion/helpers.d.ts +29 -0
- package/src/inference/pipelines/diffusion/helpers.js +120 -0
- package/src/inference/pipelines/diffusion/index.d.ts +3 -0
- package/src/inference/pipelines/diffusion/index.js +3 -0
- package/src/inference/pipelines/diffusion/init.d.ts +24 -0
- package/src/inference/pipelines/diffusion/init.js +138 -0
- package/src/inference/pipelines/diffusion/pipeline.d.ts +38 -0
- package/src/inference/pipelines/diffusion/pipeline.js +782 -0
- package/src/inference/pipelines/diffusion/sana-transformer.d.ts +53 -0
- package/src/inference/pipelines/diffusion/sana-transformer.js +738 -0
- package/src/inference/pipelines/diffusion/scheduler.d.ts +35 -0
- package/src/inference/pipelines/diffusion/scheduler.js +153 -0
- package/src/inference/pipelines/diffusion/sd3-transformer.d.ts +20 -0
- package/src/inference/pipelines/diffusion/sd3-transformer.js +1194 -0
- package/src/inference/pipelines/diffusion/sd3-weights.d.ts +21 -0
- package/src/inference/pipelines/diffusion/sd3-weights.js +287 -0
- package/src/inference/pipelines/diffusion/text-encoder-gpu.d.ts +87 -0
- package/src/inference/pipelines/diffusion/text-encoder-gpu.js +1224 -0
- package/src/inference/pipelines/diffusion/text-encoder.d.ts +29 -0
- package/src/inference/pipelines/diffusion/text-encoder.js +195 -0
- package/src/inference/pipelines/diffusion/types.d.ts +116 -0
- package/src/inference/pipelines/diffusion/types.js +1 -0
- package/src/inference/pipelines/diffusion/vae.d.ts +20 -0
- package/src/inference/pipelines/diffusion/vae.js +1375 -0
- package/src/inference/pipelines/diffusion/weights.d.ts +40 -0
- package/src/inference/pipelines/diffusion/weights.js +155 -0
- package/src/inference/pipelines/dream/energy-head-pipeline.d.ts +29 -0
- package/src/inference/pipelines/dream/energy-head-pipeline.js +6 -0
- package/src/inference/pipelines/dream/pipeline.d.ts +17 -0
- package/src/inference/pipelines/dream/pipeline.js +8 -0
- package/src/inference/pipelines/energy/index.d.ts +1 -0
- package/src/inference/pipelines/energy/index.js +1 -0
- package/src/inference/pipelines/energy/pipeline.d.ts +27 -0
- package/src/inference/pipelines/energy/pipeline.js +697 -0
- package/src/inference/pipelines/energy/quintel.d.ts +92 -0
- package/src/inference/pipelines/energy/quintel.js +218 -0
- package/src/inference/pipelines/energy/types.d.ts +63 -0
- package/src/inference/pipelines/energy/types.js +1 -0
- package/src/inference/pipelines/energy-head/index.d.ts +6 -0
- package/src/inference/pipelines/energy-head/index.js +6 -0
- package/src/inference/pipelines/energy-head/row-head-pipeline.d.ts +103 -0
- package/src/inference/pipelines/energy-head/row-head-pipeline.js +491 -0
- package/src/inference/pipelines/factory.d.ts +10 -0
- package/src/inference/pipelines/factory.js +6 -0
- package/src/inference/pipelines/index.d.ts +22 -0
- package/src/inference/pipelines/index.js +19 -0
- package/src/inference/pipelines/registry.d.ts +15 -0
- package/src/inference/pipelines/registry.js +23 -0
- package/src/inference/pipelines/rng.d.ts +2 -0
- package/src/inference/pipelines/rng.js +17 -0
- package/src/inference/pipelines/structured/index.d.ts +8 -0
- package/src/inference/pipelines/structured/index.js +8 -0
- package/src/inference/pipelines/structured/json-head-pipeline.d.ts +58 -0
- package/src/inference/pipelines/structured/json-head-pipeline.js +196 -0
- package/src/inference/pipelines/text/attention/attn-config.d.ts +28 -0
- package/src/inference/pipelines/text/attention/attn-config.js +51 -0
- package/src/inference/pipelines/text/attention/dispatch-params.d.ts +148 -0
- package/src/inference/pipelines/text/attention/dispatch-params.js +251 -0
- package/src/inference/pipelines/text/attention/index.d.ts +24 -0
- package/src/inference/pipelines/text/attention/index.js +17 -0
- package/src/inference/pipelines/text/attention/output-projection.d.ts +12 -0
- package/src/inference/pipelines/text/attention/output-projection.js +8 -0
- package/src/inference/pipelines/text/attention/projections.d.ts +114 -0
- package/src/inference/pipelines/text/attention/projections.js +531 -0
- package/src/inference/pipelines/text/attention/record.d.ts +36 -0
- package/src/inference/pipelines/text/attention/record.js +523 -0
- package/src/inference/pipelines/text/attention/run.d.ts +38 -0
- package/src/inference/pipelines/text/attention/run.js +813 -0
- package/src/inference/pipelines/text/attention/types.d.ts +108 -0
- package/src/inference/pipelines/text/attention/types.js +67 -0
- package/src/inference/pipelines/text/attention.d.ts +23 -0
- package/src/inference/pipelines/text/attention.js +12 -0
- package/src/inference/pipelines/text/bdpa-steamroller.d.ts +22 -0
- package/src/inference/pipelines/text/bdpa-steamroller.js +158 -0
- package/src/inference/pipelines/text/buffer-types.d.ts +7 -0
- package/src/inference/pipelines/text/buffer-types.js +4 -0
- package/src/inference/pipelines/text/chat-format.d.ts +46 -0
- package/src/inference/pipelines/text/chat-format.js +365 -0
- package/src/inference/pipelines/text/config.d.ts +253 -0
- package/src/inference/pipelines/text/config.js +857 -0
- package/src/inference/pipelines/text/debug-utils/config.d.ts +144 -0
- package/src/inference/pipelines/text/debug-utils/config.js +156 -0
- package/src/inference/pipelines/text/debug-utils/index.d.ts +53 -0
- package/src/inference/pipelines/text/debug-utils/index.js +44 -0
- package/src/inference/pipelines/text/debug-utils/logging.d.ts +106 -0
- package/src/inference/pipelines/text/debug-utils/logging.js +152 -0
- package/src/inference/pipelines/text/debug-utils/tensor.d.ts +119 -0
- package/src/inference/pipelines/text/debug-utils/tensor.js +268 -0
- package/src/inference/pipelines/text/debug-utils/utils.d.ts +77 -0
- package/src/inference/pipelines/text/debug-utils/utils.js +139 -0
- package/src/inference/pipelines/text/debug-utils.d.ts +42 -0
- package/src/inference/pipelines/text/debug-utils.js +34 -0
- package/src/inference/pipelines/text/drift-policy.d.ts +57 -0
- package/src/inference/pipelines/text/drift-policy.js +133 -0
- package/src/inference/pipelines/text/dtype-contract.d.ts +38 -0
- package/src/inference/pipelines/text/dtype-contract.js +87 -0
- package/src/inference/pipelines/text/embed.d.ts +67 -0
- package/src/inference/pipelines/text/embed.js +490 -0
- package/src/inference/pipelines/text/execution-plan.d.ts +123 -0
- package/src/inference/pipelines/text/execution-plan.js +371 -0
- package/src/inference/pipelines/text/execution-runtime-builders.d.ts +45 -0
- package/src/inference/pipelines/text/execution-runtime-builders.js +382 -0
- package/src/inference/pipelines/text/execution-v1.d.ts +45 -0
- package/src/inference/pipelines/text/execution-v1.js +288 -0
- package/src/inference/pipelines/text/failure-reduction.d.ts +84 -0
- package/src/inference/pipelines/text/failure-reduction.js +180 -0
- package/src/inference/pipelines/text/ffn/dense.d.ts +40 -0
- package/src/inference/pipelines/text/ffn/dense.js +753 -0
- package/src/inference/pipelines/text/ffn/index.d.ts +23 -0
- package/src/inference/pipelines/text/ffn/index.js +16 -0
- package/src/inference/pipelines/text/ffn/moe.d.ts +21 -0
- package/src/inference/pipelines/text/ffn/moe.js +49 -0
- package/src/inference/pipelines/text/ffn/sandwich.d.ts +25 -0
- package/src/inference/pipelines/text/ffn/sandwich.js +196 -0
- package/src/inference/pipelines/text/ffn/standard.d.ts +23 -0
- package/src/inference/pipelines/text/ffn/standard.js +113 -0
- package/src/inference/pipelines/text/ffn/types.d.ts +30 -0
- package/src/inference/pipelines/text/ffn/types.js +25 -0
- package/src/inference/pipelines/text/ffn.d.ts +31 -0
- package/src/inference/pipelines/text/ffn.js +18 -0
- package/src/inference/pipelines/text/finiteness-guard-status.d.ts +11 -0
- package/src/inference/pipelines/text/finiteness-guard-status.js +21 -0
- package/src/inference/pipelines/text/finiteness-policy.d.ts +35 -0
- package/src/inference/pipelines/text/finiteness-policy.js +45 -0
- package/src/inference/pipelines/text/generator-helpers.d.ts +34 -0
- package/src/inference/pipelines/text/generator-helpers.js +178 -0
- package/src/inference/pipelines/text/generator-runtime.d.ts +95 -0
- package/src/inference/pipelines/text/generator-runtime.js +492 -0
- package/src/inference/pipelines/text/generator-steps.d.ts +136 -0
- package/src/inference/pipelines/text/generator-steps.js +1294 -0
- package/src/inference/pipelines/text/generator.d.ts +46 -0
- package/src/inference/pipelines/text/generator.js +1779 -0
- package/src/inference/pipelines/text/index.d.ts +5 -0
- package/src/inference/pipelines/text/index.js +6 -0
- package/src/inference/pipelines/text/init.d.ts +316 -0
- package/src/inference/pipelines/text/init.js +1187 -0
- package/src/inference/pipelines/text/kernel-trace.d.ts +152 -0
- package/src/inference/pipelines/text/kernel-trace.js +330 -0
- package/src/inference/pipelines/text/layer-plan.d.ts +65 -0
- package/src/inference/pipelines/text/layer-plan.js +249 -0
- package/src/inference/pipelines/text/layer.d.ts +56 -0
- package/src/inference/pipelines/text/layer.js +974 -0
- package/src/inference/pipelines/text/linear-attention.d.ts +109 -0
- package/src/inference/pipelines/text/linear-attention.js +948 -0
- package/src/inference/pipelines/text/logits/cpu.d.ts +81 -0
- package/src/inference/pipelines/text/logits/cpu.js +91 -0
- package/src/inference/pipelines/text/logits/gpu.d.ts +113 -0
- package/src/inference/pipelines/text/logits/gpu.js +419 -0
- package/src/inference/pipelines/text/logits/index.d.ts +62 -0
- package/src/inference/pipelines/text/logits/index.js +316 -0
- package/src/inference/pipelines/text/logits/types.d.ts +46 -0
- package/src/inference/pipelines/text/logits/types.js +4 -0
- package/src/inference/pipelines/text/logits/utils.d.ts +56 -0
- package/src/inference/pipelines/text/logits/utils.js +68 -0
- package/src/inference/pipelines/text/logits.d.ts +27 -0
- package/src/inference/pipelines/text/logits.js +16 -0
- package/src/inference/pipelines/text/lora-apply.d.ts +28 -0
- package/src/inference/pipelines/text/lora-apply.js +76 -0
- package/src/inference/pipelines/text/lora-types.d.ts +39 -0
- package/src/inference/pipelines/text/lora-types.js +18 -0
- package/src/inference/pipelines/text/lora.d.ts +18 -0
- package/src/inference/pipelines/text/lora.js +12 -0
- package/src/inference/pipelines/text/model-load.d.ts +58 -0
- package/src/inference/pipelines/text/model-load.js +778 -0
- package/src/inference/pipelines/text/moe-cache.d.ts +32 -0
- package/src/inference/pipelines/text/moe-cache.js +108 -0
- package/src/inference/pipelines/text/moe-cpu-gptoss.d.ts +9 -0
- package/src/inference/pipelines/text/moe-cpu-gptoss.js +115 -0
- package/src/inference/pipelines/text/moe-cpu.d.ts +13 -0
- package/src/inference/pipelines/text/moe-cpu.js +120 -0
- package/src/inference/pipelines/text/moe-gpu.d.ts +13 -0
- package/src/inference/pipelines/text/moe-gpu.js +653 -0
- package/src/inference/pipelines/text/moe-helpers.d.ts +12 -0
- package/src/inference/pipelines/text/moe-helpers.js +21 -0
- package/src/inference/pipelines/text/moe-impl.d.ts +117 -0
- package/src/inference/pipelines/text/moe-impl.js +9 -0
- package/src/inference/pipelines/text/moe-shape-validator.d.ts +40 -0
- package/src/inference/pipelines/text/moe-shape-validator.js +98 -0
- package/src/inference/pipelines/text/operator-events.d.ts +125 -0
- package/src/inference/pipelines/text/operator-events.js +305 -0
- package/src/inference/pipelines/text/operator-identity.d.ts +60 -0
- package/src/inference/pipelines/text/operator-identity.js +133 -0
- package/src/inference/pipelines/text/ops.d.ts +167 -0
- package/src/inference/pipelines/text/ops.js +437 -0
- package/src/inference/pipelines/text/probes.d.ts +31 -0
- package/src/inference/pipelines/text/probes.js +240 -0
- package/src/inference/pipelines/text/sampling-config.d.ts +54 -0
- package/src/inference/pipelines/text/sampling-config.js +71 -0
- package/src/inference/pipelines/text/sampling.d.ts +54 -0
- package/src/inference/pipelines/text/sampling.js +249 -0
- package/src/inference/pipelines/text/stage-names.d.ts +88 -0
- package/src/inference/pipelines/text/stage-names.js +202 -0
- package/src/inference/pipelines/text/state.d.ts +114 -0
- package/src/inference/pipelines/text/state.js +165 -0
- package/src/inference/pipelines/text/types.d.ts +682 -0
- package/src/inference/pipelines/text/types.js +4 -0
- package/src/inference/pipelines/text/weights.d.ts +110 -0
- package/src/inference/pipelines/text/weights.js +173 -0
- package/src/inference/pipelines/text.d.ts +162 -0
- package/src/inference/pipelines/text.js +852 -0
- package/src/inference/pipelines/vision/encoder.js +386 -0
- package/src/inference/pipelines/vision/image-preprocess.js +157 -0
- package/src/inference/pipelines/vision/index.js +173 -0
- package/src/inference/pipelines/vision/ops.js +78 -0
- package/src/inference/pipelines/vision/patch-embed.js +151 -0
- package/src/inference/speculative.d.ts +239 -0
- package/src/inference/speculative.js +402 -0
- package/src/inference/test-harness.d.ts +178 -0
- package/src/inference/test-harness.js +361 -0
- package/src/inference/tokenizer.d.ts +72 -0
- package/src/inference/tokenizer.js +251 -0
- package/src/inference/tokenizers/base.d.ts +39 -0
- package/src/inference/tokenizers/base.js +69 -0
- package/src/inference/tokenizers/bpe.d.ts +27 -0
- package/src/inference/tokenizers/bpe.js +180 -0
- package/src/inference/tokenizers/bundled.d.ts +63 -0
- package/src/inference/tokenizers/bundled.js +1009 -0
- package/src/inference/tokenizers/sentencepiece.d.ts +28 -0
- package/src/inference/tokenizers/sentencepiece.js +401 -0
- package/src/inference/tokenizers/types.d.ts +166 -0
- package/src/inference/tokenizers/types.js +7 -0
- package/src/loader/doppler-loader.d.ts +139 -0
- package/src/loader/doppler-loader.js +1103 -0
- package/src/loader/dtype-utils.d.ts +40 -0
- package/src/loader/dtype-utils.js +61 -0
- package/src/loader/embedding-loader.d.ts +56 -0
- package/src/loader/embedding-loader.js +211 -0
- package/src/loader/experts/expert-cache.d.ts +156 -0
- package/src/loader/experts/expert-cache.js +386 -0
- package/src/loader/experts/expert-loader.d.ts +108 -0
- package/src/loader/experts/expert-loader.js +392 -0
- package/src/loader/final-weights-loader.d.ts +88 -0
- package/src/loader/final-weights-loader.js +339 -0
- package/src/loader/index.d.ts +150 -0
- package/src/loader/index.js +124 -0
- package/src/loader/layer-loader.d.ts +63 -0
- package/src/loader/layer-loader.js +474 -0
- package/src/loader/loader-state.d.ts +51 -0
- package/src/loader/loader-state.js +142 -0
- package/src/loader/loader-types.d.ts +236 -0
- package/src/loader/loader-types.js +4 -0
- package/src/loader/manifest-config.d.ts +97 -0
- package/src/loader/manifest-config.js +134 -0
- package/src/loader/memory-monitor.d.ts +112 -0
- package/src/loader/memory-monitor.js +284 -0
- package/src/loader/multi-model-loader.d.ts +51 -0
- package/src/loader/multi-model-loader.js +133 -0
- package/src/loader/quantization-constants.d.ts +23 -0
- package/src/loader/quantization-constants.js +14 -0
- package/src/loader/shard-cache.d.ts +60 -0
- package/src/loader/shard-cache.js +663 -0
- package/src/loader/shard-resolver.d.ts +12 -0
- package/src/loader/shard-resolver.js +144 -0
- package/src/loader/tensors/tensor-loader.d.ts +157 -0
- package/src/loader/tensors/tensor-loader.js +652 -0
- package/src/loader/tensors/tensor-reader.d.ts +22 -0
- package/src/loader/tensors/tensor-reader.js +113 -0
- package/src/loader/tensors/tensor-role.d.ts +7 -0
- package/src/loader/tensors/tensor-role.js +12 -0
- package/src/loader/weight-downcast.d.ts +62 -0
- package/src/loader/weight-downcast.js +213 -0
- package/src/loader/weights.d.ts +22 -0
- package/src/loader/weights.js +4 -0
- package/src/memory/address-table.d.ts +104 -0
- package/src/memory/address-table.js +114 -0
- package/src/memory/buffer-pool.d.ts +204 -0
- package/src/memory/buffer-pool.js +867 -0
- package/src/memory/capability.d.ts +49 -0
- package/src/memory/capability.js +95 -0
- package/src/memory/heap-manager.d.ts +104 -0
- package/src/memory/heap-manager.js +264 -0
- package/src/memory/unified-detect.d.ts +59 -0
- package/src/memory/unified-detect.js +192 -0
- package/src/rules/converter/execution.rules.json +20 -0
- package/src/rules/converter/tensor-roles.rules.json +13 -0
- package/src/rules/converter/tokenizer.rules.json +7 -0
- package/src/rules/execution-rules-contract-check.d.ts +17 -0
- package/src/rules/execution-rules-contract-check.js +287 -0
- package/src/rules/inference/attention.rules.json +54 -0
- package/src/rules/inference/capability-transforms.rules.json +24 -0
- package/src/rules/inference/config.rules.json +57 -0
- package/src/rules/inference/dtype.rules.json +99 -0
- package/src/rules/inference/execution.rules.json +56 -0
- package/src/rules/inference/ffn.rules.json +35 -0
- package/src/rules/inference/layer-pattern.rules.json +16 -0
- package/src/rules/inference/layer.rules.json +7 -0
- package/src/rules/inference/moe.rules.json +48 -0
- package/src/rules/kernels/attention.rules.json +61 -0
- package/src/rules/kernels/conv2d.rules.json +6 -0
- package/src/rules/kernels/depthwise-conv2d.rules.json +6 -0
- package/src/rules/kernels/dequant.rules.json +58 -0
- package/src/rules/kernels/energy.rules.json +22 -0
- package/src/rules/kernels/fused-ffn.rules.json +13 -0
- package/src/rules/kernels/fused-matmul-residual.rules.json +6 -0
- package/src/rules/kernels/fused-matmul-rmsnorm.rules.json +8 -0
- package/src/rules/kernels/gather.rules.json +12 -0
- package/src/rules/kernels/gelu.rules.json +11 -0
- package/src/rules/kernels/grouped-pointwise-conv2d.rules.json +6 -0
- package/src/rules/kernels/groupnorm.rules.json +10 -0
- package/src/rules/kernels/kernel-validator.d.ts +24 -0
- package/src/rules/kernels/kernel-validator.js +160 -0
- package/src/rules/kernels/kv_quantize.rules.json +7 -0
- package/src/rules/kernels/layernorm.rules.json +6 -0
- package/src/rules/kernels/matmul.rules.json +60 -0
- package/src/rules/kernels/modulate.rules.json +6 -0
- package/src/rules/kernels/moe.rules.gptoss.json +105 -0
- package/src/rules/kernels/moe.rules.json +11 -0
- package/src/rules/kernels/moe.rules.mixtral.json +75 -0
- package/src/rules/kernels/pixel_shuffle.rules.json +6 -0
- package/src/rules/kernels/relu.rules.json +6 -0
- package/src/rules/kernels/repeat-channels.rules.json +6 -0
- package/src/rules/kernels/residual.rules.json +12 -0
- package/src/rules/kernels/rmsnorm.rules.json +11 -0
- package/src/rules/kernels/rope.rules.json +6 -0
- package/src/rules/kernels/sample.rules.json +6 -0
- package/src/rules/kernels/sana-linear-attention.rules.json +6 -0
- package/src/rules/kernels/scale.rules.json +6 -0
- package/src/rules/kernels/silu.rules.json +21 -0
- package/src/rules/kernels/softmax.rules.json +25 -0
- package/src/rules/kernels/split-qg.rules.json +6 -0
- package/src/rules/kernels/split-qkv.rules.json +6 -0
- package/src/rules/kernels/upsample2d.rules.json +6 -0
- package/src/rules/layer-pattern-contract-check.d.ts +17 -0
- package/src/rules/layer-pattern-contract-check.js +231 -0
- package/src/rules/loader/tensor-loader.rules.json +24 -0
- package/src/rules/loader/weights.rules.json +41 -0
- package/src/rules/rule-registry.d.ts +77 -0
- package/src/rules/rule-registry.js +264 -0
- package/src/rules/tooling/command-runtime.rules.json +65 -0
- package/src/storage/backends/idb-store.d.ts +52 -0
- package/src/storage/backends/idb-store.js +590 -0
- package/src/storage/backends/memory-store.d.ts +36 -0
- package/src/storage/backends/memory-store.js +242 -0
- package/src/storage/backends/opfs-store.d.ts +41 -0
- package/src/storage/backends/opfs-store.js +478 -0
- package/src/storage/blake3.d.ts +17 -0
- package/src/storage/blake3.js +269 -0
- package/src/storage/download-types.d.ts +157 -0
- package/src/storage/download-types.js +48 -0
- package/src/storage/downloader.d.ts +103 -0
- package/src/storage/downloader.js +1121 -0
- package/src/storage/emulated-vram.d.ts +264 -0
- package/src/storage/emulated-vram.js +576 -0
- package/src/storage/export.d.ts +20 -0
- package/src/storage/export.js +159 -0
- package/src/storage/index.d.ts +256 -0
- package/src/storage/index.js +188 -0
- package/src/storage/inventory.d.ts +26 -0
- package/src/storage/inventory.js +218 -0
- package/src/storage/preflight.d.ts +144 -0
- package/src/storage/preflight.js +316 -0
- package/src/storage/quickstart-downloader.d.ts +157 -0
- package/src/storage/quickstart-downloader.js +268 -0
- package/src/storage/quota.d.ts +150 -0
- package/src/storage/quota.js +305 -0
- package/src/storage/registry.d.ts +28 -0
- package/src/storage/registry.js +131 -0
- package/src/storage/reports.d.ts +20 -0
- package/src/storage/reports.js +94 -0
- package/src/storage/shard-manager.d.ts +151 -0
- package/src/storage/shard-manager.js +861 -0
- package/src/storage/source-artifact-store.d.ts +52 -0
- package/src/storage/source-artifact-store.js +234 -0
- package/src/sw.d.ts +1 -0
- package/src/sw.js +187 -0
- package/src/tooling/bench-runner.js +64 -0
- package/src/tooling/browser-command-runner.d.ts +28 -0
- package/src/tooling/browser-command-runner.js +85 -0
- package/src/tooling/command-api-constants.d.ts +9 -0
- package/src/tooling/command-api-constants.js +9 -0
- package/src/tooling/command-api-family-normalizers.d.ts +9 -0
- package/src/tooling/command-api-family-normalizers.js +395 -0
- package/src/tooling/command-api-helpers.d.ts +25 -0
- package/src/tooling/command-api-helpers.js +265 -0
- package/src/tooling/command-api.d.ts +177 -0
- package/src/tooling/command-api.js +82 -0
- package/src/tooling/command-envelope.d.ts +84 -0
- package/src/tooling/command-envelope.js +201 -0
- package/src/tooling/command-runner-shared.d.ts +75 -0
- package/src/tooling/command-runner-shared.js +191 -0
- package/src/tooling/command-runner.html +45 -0
- package/src/tooling/command-validation.js +44 -0
- package/src/tooling/conversion-config-materializer.d.ts +24 -0
- package/src/tooling/conversion-config-materializer.js +96 -0
- package/src/tooling/diagnose-runner.d.ts +28 -0
- package/src/tooling/diagnose-runner.js +333 -0
- package/src/tooling/distill-runner.js +56 -0
- package/src/tooling/hf-registry-utils.d.ts +59 -0
- package/src/tooling/hf-registry-utils.js +324 -0
- package/src/tooling/kernel-path-builder/custom-runtime-facts.d.ts +18 -0
- package/src/tooling/kernel-path-builder/custom-runtime-facts.js +72 -0
- package/src/tooling/kernel-path-builder/index.d.ts +65 -0
- package/src/tooling/kernel-path-builder/index.js +1348 -0
- package/src/tooling/kernel-path-builder/runtime-overlay.d.ts +9 -0
- package/src/tooling/kernel-path-builder/runtime-overlay.js +149 -0
- package/src/tooling/lean-execution-contract-runner.d.ts +43 -0
- package/src/tooling/lean-execution-contract-runner.js +158 -0
- package/src/tooling/lean-execution-contract.d.ts +16 -0
- package/src/tooling/lean-execution-contract.js +228 -0
- package/src/tooling/lora-runner.js +37 -0
- package/src/tooling/node-browser-command-runner.d.ts +34 -0
- package/src/tooling/node-browser-command-runner.js +827 -0
- package/src/tooling/node-command-runner.d.ts +36 -0
- package/src/tooling/node-command-runner.js +187 -0
- package/src/tooling/node-convert-worker-pool.d.ts +16 -0
- package/src/tooling/node-convert-worker-pool.js +186 -0
- package/src/tooling/node-convert-worker.d.ts +1 -0
- package/src/tooling/node-convert-worker.js +60 -0
- package/src/tooling/node-converter.d.ts +1 -0
- package/src/tooling/node-converter.js +1330 -0
- package/src/tooling/node-file-fetch.d.ts +1 -0
- package/src/tooling/node-file-fetch.js +38 -0
- package/src/tooling/node-source-runtime.d.ts +19 -0
- package/src/tooling/node-source-runtime.js +612 -0
- package/src/tooling/node-webgpu.d.ts +16 -0
- package/src/tooling/node-webgpu.js +421 -0
- package/src/tooling/opfs-cache.d.ts +12 -0
- package/src/tooling/opfs-cache.js +260 -0
- package/src/tooling/runtime-input-composition.d.ts +38 -0
- package/src/tooling/runtime-input-composition.js +90 -0
- package/src/tooling/source-runtime-bundle.d.ts +141 -0
- package/src/tooling/source-runtime-bundle.js +712 -0
- package/src/tooling/source-runtime-materializer.d.ts +6 -0
- package/src/tooling/source-runtime-materializer.js +93 -0
- package/src/tooling/verify-runner.js +63 -0
- package/src/tooling-exports.browser.d.ts +7 -0
- package/src/tooling-exports.browser.js +2 -0
- package/src/tooling-exports.d.ts +22 -0
- package/src/tooling-exports.js +7 -0
- package/src/tooling-exports.shared.d.ts +106 -0
- package/src/tooling-exports.shared.js +93 -0
- package/src/training/README.md +153 -0
- package/src/training/artifacts.d.ts +160 -0
- package/src/training/artifacts.js +896 -0
- package/src/training/attention-backward.d.ts +30 -0
- package/src/training/attention-backward.js +232 -0
- package/src/training/attention-forward.d.ts +22 -0
- package/src/training/attention-forward.js +82 -0
- package/src/training/autograd.d.ts +51 -0
- package/src/training/autograd.js +408 -0
- package/src/training/backward-kernels.js +39 -0
- package/src/training/checkpoint-watch.d.ts +8 -0
- package/src/training/checkpoint-watch.js +139 -0
- package/src/training/checkpoint.d.ts +36 -0
- package/src/training/checkpoint.js +281 -0
- package/src/training/clip.d.ts +9 -0
- package/src/training/clip.js +55 -0
- package/src/training/dataloader.d.ts +8 -0
- package/src/training/dataloader.js +44 -0
- package/src/training/datasets/index.d.ts +12 -0
- package/src/training/datasets/index.js +6 -0
- package/src/training/datasets/jsonl.d.ts +11 -0
- package/src/training/datasets/jsonl.js +50 -0
- package/src/training/datasets/reploid.d.ts +3 -0
- package/src/training/datasets/reploid.js +36 -0
- package/src/training/datasets/text-pairs.d.ts +21 -0
- package/src/training/datasets/text-pairs.js +42 -0
- package/src/training/datasets/token-batch.d.ts +21 -0
- package/src/training/datasets/token-batch.js +52 -0
- package/src/training/datasets/translation-pairs.d.ts +34 -0
- package/src/training/datasets/translation-pairs.js +49 -0
- package/src/training/distillation/artifacts.d.ts +71 -0
- package/src/training/distillation/artifacts.js +132 -0
- package/src/training/distillation/checkpoint-watch.d.ts +10 -0
- package/src/training/distillation/checkpoint-watch.js +58 -0
- package/src/training/distillation/dataset.d.ts +59 -0
- package/src/training/distillation/dataset.js +337 -0
- package/src/training/distillation/eval.d.ts +34 -0
- package/src/training/distillation/eval.js +313 -0
- package/src/training/distillation/index.d.ts +29 -0
- package/src/training/distillation/index.js +29 -0
- package/src/training/distillation/runtime.d.ts +20 -0
- package/src/training/distillation/runtime.js +121 -0
- package/src/training/distillation/scoreboard.d.ts +6 -0
- package/src/training/distillation/scoreboard.js +8 -0
- package/src/training/distillation/stage-a.d.ts +45 -0
- package/src/training/distillation/stage-a.js +338 -0
- package/src/training/distillation/stage-b.d.ts +24 -0
- package/src/training/distillation/stage-b.js +20 -0
- package/src/training/distillation/student-fixture.d.ts +22 -0
- package/src/training/distillation/student-fixture.js +846 -0
- package/src/training/distillation/suite-data.d.ts +45 -0
- package/src/training/distillation/suite-data.js +189 -0
- package/src/training/export.d.ts +32 -0
- package/src/training/export.js +112 -0
- package/src/training/index.d.ts +62 -0
- package/src/training/index.js +51 -0
- package/src/training/lora-pipeline.d.ts +40 -0
- package/src/training/lora-pipeline.js +793 -0
- package/src/training/lora.d.ts +19 -0
- package/src/training/lora.js +71 -0
- package/src/training/loss-scaling.d.ts +21 -0
- package/src/training/loss-scaling.js +80 -0
- package/src/training/loss.d.ts +10 -0
- package/src/training/loss.js +40 -0
- package/src/training/objectives/base.d.ts +58 -0
- package/src/training/objectives/base.js +38 -0
- package/src/training/objectives/cross_entropy.d.ts +18 -0
- package/src/training/objectives/cross_entropy.js +34 -0
- package/src/training/objectives/distill_kd.d.ts +16 -0
- package/src/training/objectives/distill_kd.js +369 -0
- package/src/training/objectives/distill_triplet.d.ts +16 -0
- package/src/training/objectives/distill_triplet.js +414 -0
- package/src/training/objectives/index.d.ts +12 -0
- package/src/training/objectives/index.js +6 -0
- package/src/training/objectives/ul_stage1_joint.d.ts +16 -0
- package/src/training/objectives/ul_stage1_joint.js +188 -0
- package/src/training/objectives/ul_stage2_base.d.ts +16 -0
- package/src/training/objectives/ul_stage2_base.js +218 -0
- package/src/training/operator-artifacts.d.ts +62 -0
- package/src/training/operator-artifacts.js +140 -0
- package/src/training/operator-command.d.ts +5 -0
- package/src/training/operator-command.js +455 -0
- package/src/training/operator-eval.d.ts +48 -0
- package/src/training/operator-eval.js +230 -0
- package/src/training/operator-scoreboard.d.ts +5 -0
- package/src/training/operator-scoreboard.js +44 -0
- package/src/training/optimizer.d.ts +22 -0
- package/src/training/optimizer.js +127 -0
- package/src/training/runner.d.ts +248 -0
- package/src/training/runner.js +1236 -0
- package/src/training/suite.d.ts +299 -0
- package/src/training/suite.js +2196 -0
- package/src/training/tensor-factory.d.ts +9 -0
- package/src/training/tensor-factory.js +13 -0
- package/src/training/trainer.d.ts +89 -0
- package/src/training/trainer.js +299 -0
- package/src/training/ul_dataset.d.ts +47 -0
- package/src/training/ul_dataset.js +151 -0
- package/src/training/ul_schedule.d.ts +6 -0
- package/src/training/ul_schedule.js +29 -0
- package/src/training/workload-packs/distill-translategemma-medium.json +103 -0
- package/src/training/workload-packs/distill-translategemma-tiny.json +103 -0
- package/src/training/workload-packs/lora-toy-medium.json +91 -0
- package/src/training/workload-packs/lora-toy-tiny.json +91 -0
- package/src/training/workload-packs/registry.json +98 -0
- package/src/training/workload-packs/ul-training-medium.json +55 -0
- package/src/training/workload-packs/ul-training-tiny.json +55 -0
- package/src/training/workloads.d.ts +164 -0
- package/src/training/workloads.js +530 -0
- package/src/types/chrome.d.ts +36 -0
- package/src/types/chrome.js +1 -0
- package/src/types/gpu.d.ts +185 -0
- package/src/types/gpu.js +5 -0
- package/src/types/index.d.ts +4 -0
- package/src/types/index.js +4 -0
- package/src/types/inference.d.ts +197 -0
- package/src/types/inference.js +5 -0
- package/src/types/model.d.ts +130 -0
- package/src/types/model.js +5 -0
- package/src/utils/format-bytes.js +20 -0
- package/src/utils/hf-resolve-url.d.ts +16 -0
- package/src/utils/hf-resolve-url.js +17 -0
- package/src/utils/index.d.ts +7 -0
- package/src/utils/index.js +7 -0
- package/src/utils/load-json.d.ts +5 -0
- package/src/utils/load-json.js +33 -0
- package/src/utils/plain-object.d.ts +1 -0
- package/src/utils/plain-object.js +3 -0
- package/src/utils/sha256.d.ts +4 -0
- package/src/utils/sha256.js +135 -0
- package/src/version.d.ts +2 -0
- package/src/version.js +2 -0
- package/tools/convert-safetensors-node.js +240 -0
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
import { trace } from '../../../debug/index.js';
|
|
4
|
+
import { getDevice } from '../../../gpu/device.js';
|
|
5
|
+
import { acquireBuffer, releaseBuffer } from '../../../memory/buffer-pool.js';
|
|
6
|
+
import { preprocessImage } from './image-preprocess.js';
|
|
7
|
+
import { patchEmbed } from './patch-embed.js';
|
|
8
|
+
import { runVisionEncoder } from './encoder.js';
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* Encode an image through the Qwen3-VL vision pipeline.
|
|
12
|
+
*
|
|
13
|
+
* Full flow:
|
|
14
|
+
* raw pixels -> preprocess -> patch embed -> ViT blocks -> spatial merge -> visual tokens
|
|
15
|
+
*
|
|
16
|
+
* @param {object} params
|
|
17
|
+
* @param {Uint8Array|Float32Array} params.pixels Raw image pixel data (RGBA or RGB)
|
|
18
|
+
* @param {number} params.width Image width
|
|
19
|
+
* @param {number} params.height Image height
|
|
20
|
+
* @param {object} params.visionConfig Vision config from manifest
|
|
21
|
+
* @param {object} params.weights Vision encoder weight buffers
|
|
22
|
+
* @returns {Promise<VisionEncodeResult>}
|
|
23
|
+
*/
|
|
24
|
+
export async function encodeImage(params) {
|
|
25
|
+
const { pixels, width, height, visionConfig, weights } = params;
|
|
26
|
+
|
|
27
|
+
trace('vision', `encodeImage: ${width}x${height} input`);
|
|
28
|
+
|
|
29
|
+
// Step 1: Preprocess — resize, normalize, compute grid.
|
|
30
|
+
const preprocessed = preprocessImage(pixels, width, height, visionConfig);
|
|
31
|
+
|
|
32
|
+
// Step 2: Patch embedding — conv2d patches -> [numPatches, hiddenSize].
|
|
33
|
+
const { patchBuffer, numPatches } = await patchEmbed({
|
|
34
|
+
imageData: preprocessed.data,
|
|
35
|
+
height: preprocessed.height,
|
|
36
|
+
width: preprocessed.width,
|
|
37
|
+
channels: preprocessed.channels,
|
|
38
|
+
visionConfig,
|
|
39
|
+
weights,
|
|
40
|
+
});
|
|
41
|
+
|
|
42
|
+
// Step 3: Vision encoder — ViT blocks + spatial merge.
|
|
43
|
+
const { features, numTokens } = await runVisionEncoder({
|
|
44
|
+
patchBuffer,
|
|
45
|
+
numPatches,
|
|
46
|
+
visionConfig,
|
|
47
|
+
weights,
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
return {
|
|
51
|
+
features,
|
|
52
|
+
numTokens,
|
|
53
|
+
gridThw: preprocessed.gridThw,
|
|
54
|
+
imageWidth: preprocessed.width,
|
|
55
|
+
imageHeight: preprocessed.height,
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Inject visual tokens into text token embeddings.
|
|
61
|
+
*
|
|
62
|
+
* Replaces positions in the embedding sequence where image_token_id appears
|
|
63
|
+
* with the encoded visual features from the vision encoder.
|
|
64
|
+
*
|
|
65
|
+
* For Qwen3-VL with DeepStack, visual tokens are injected at specific decoder
|
|
66
|
+
* layers (deepstackVisualIndexes), not at the input embedding level.
|
|
67
|
+
* This function handles the simpler input-level injection case.
|
|
68
|
+
* DeepStack injection is handled in the decoder layer loop.
|
|
69
|
+
*
|
|
70
|
+
* @param {object} params
|
|
71
|
+
* @param {Float32Array} params.textEmbeddings [seqLen, hiddenSize]
|
|
72
|
+
* @param {Int32Array} params.tokenIds [seqLen]
|
|
73
|
+
* @param {GPUBuffer} params.visualFeatures [numVisualTokens, outHiddenSize]
|
|
74
|
+
* @param {number} params.numVisualTokens Number of visual tokens
|
|
75
|
+
* @param {number} params.imageTokenId Token ID marking image positions
|
|
76
|
+
* @param {number} params.hiddenSize Text model hidden size
|
|
77
|
+
* @returns {{ mergedEmbeddings: Float32Array, mergedLength: number }}
|
|
78
|
+
*/
|
|
79
|
+
export function mergeVisualTokens(params) {
|
|
80
|
+
const {
|
|
81
|
+
textEmbeddings, tokenIds, visualFeatures,
|
|
82
|
+
numVisualTokens, imageTokenId, hiddenSize,
|
|
83
|
+
} = params;
|
|
84
|
+
|
|
85
|
+
// Count image token positions.
|
|
86
|
+
const imagePositions = [];
|
|
87
|
+
for (let i = 0; i < tokenIds.length; i++) {
|
|
88
|
+
if (tokenIds[i] === imageTokenId) {
|
|
89
|
+
imagePositions.push(i);
|
|
90
|
+
}
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
if (imagePositions.length === 0) {
|
|
94
|
+
trace('vision', 'mergeVisualTokens: no image tokens found, returning text-only');
|
|
95
|
+
return { mergedEmbeddings: textEmbeddings, mergedLength: tokenIds.length };
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
trace('vision', `mergeVisualTokens: replacing ${imagePositions.length} image tokens with ${numVisualTokens} visual tokens`);
|
|
99
|
+
|
|
100
|
+
// The merged sequence replaces contiguous image_token_id runs with visual features.
|
|
101
|
+
// For Qwen3-VL: image tokens appear as a block between vision_start and vision_end tokens.
|
|
102
|
+
// The visual features replace the entire image token block.
|
|
103
|
+
|
|
104
|
+
// Find contiguous image token ranges.
|
|
105
|
+
const ranges = [];
|
|
106
|
+
let rangeStart = imagePositions[0];
|
|
107
|
+
let rangeEnd = imagePositions[0];
|
|
108
|
+
for (let i = 1; i < imagePositions.length; i++) {
|
|
109
|
+
if (imagePositions[i] === rangeEnd + 1) {
|
|
110
|
+
rangeEnd = imagePositions[i];
|
|
111
|
+
} else {
|
|
112
|
+
ranges.push([rangeStart, rangeEnd]);
|
|
113
|
+
rangeStart = imagePositions[i];
|
|
114
|
+
rangeEnd = imagePositions[i];
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
ranges.push([rangeStart, rangeEnd]);
|
|
118
|
+
|
|
119
|
+
// Build merged sequence: text tokens (non-image) + visual tokens replacing each range.
|
|
120
|
+
const textLen = tokenIds.length;
|
|
121
|
+
const replacedCount = imagePositions.length;
|
|
122
|
+
const mergedLength = textLen - replacedCount + numVisualTokens;
|
|
123
|
+
const merged = new Float32Array(mergedLength * hiddenSize);
|
|
124
|
+
|
|
125
|
+
let srcPos = 0;
|
|
126
|
+
let dstPos = 0;
|
|
127
|
+
let visualOffset = 0;
|
|
128
|
+
|
|
129
|
+
for (const [start, end] of ranges) {
|
|
130
|
+
// Copy text tokens before this range.
|
|
131
|
+
const textBefore = start - srcPos;
|
|
132
|
+
if (textBefore > 0) {
|
|
133
|
+
merged.set(
|
|
134
|
+
textEmbeddings.subarray(srcPos * hiddenSize, start * hiddenSize),
|
|
135
|
+
dstPos * hiddenSize,
|
|
136
|
+
);
|
|
137
|
+
dstPos += textBefore;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
// Insert visual tokens replacing this range.
|
|
141
|
+
const rangeLen = end - start + 1;
|
|
142
|
+
const tokensToInsert = Math.min(numVisualTokens - visualOffset, rangeLen);
|
|
143
|
+
// Copy from visual features buffer (CPU side).
|
|
144
|
+
for (let i = 0; i < tokensToInsert; i++) {
|
|
145
|
+
for (let d = 0; d < hiddenSize; d++) {
|
|
146
|
+
merged[(dstPos + i) * hiddenSize + d] = visualFeatures[(visualOffset + i) * hiddenSize + d];
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
dstPos += tokensToInsert;
|
|
150
|
+
visualOffset += tokensToInsert;
|
|
151
|
+
srcPos = end + 1;
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
// Copy remaining text tokens after last range.
|
|
155
|
+
if (srcPos < textLen) {
|
|
156
|
+
merged.set(
|
|
157
|
+
textEmbeddings.subarray(srcPos * hiddenSize, textLen * hiddenSize),
|
|
158
|
+
dstPos * hiddenSize,
|
|
159
|
+
);
|
|
160
|
+
dstPos += textLen - srcPos;
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
return { mergedEmbeddings: merged, mergedLength: dstPos };
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
/**
|
|
167
|
+
* @typedef {object} VisionEncodeResult
|
|
168
|
+
* @property {GPUBuffer} features Encoded visual tokens [numTokens, outHiddenSize]
|
|
169
|
+
* @property {number} numTokens Number of visual tokens after spatial merge
|
|
170
|
+
* @property {number[]} gridThw [temporal, height, width] grid dimensions
|
|
171
|
+
* @property {number} imageWidth Processed image width
|
|
172
|
+
* @property {number} imageHeight Processed image height
|
|
173
|
+
*/
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
import { getDevice } from '../../../gpu/device.js';
|
|
4
|
+
import { acquireBuffer, releaseBuffer } from '../../../memory/buffer-pool.js';
|
|
5
|
+
import { runLayerNorm } from '../../../gpu/kernels/layernorm.js';
|
|
6
|
+
import { dispatchMatmul } from '../../../gpu/kernels/matmul-dispatch.js';
|
|
7
|
+
import { runGelu } from '../../../gpu/kernels/gelu.js';
|
|
8
|
+
import { runResidualAdd } from '../../../gpu/kernels/residual.js';
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* Layer norm on GPU.
|
|
12
|
+
* @param {GPUBuffer} input [seqLen, hiddenSize]
|
|
13
|
+
* @param {GPUBuffer} weight [hiddenSize]
|
|
14
|
+
* @param {GPUBuffer} bias [hiddenSize] or null
|
|
15
|
+
* @param {{ seqLen: number, hiddenSize: number, eps: number }} opts
|
|
16
|
+
* @returns {Promise<GPUBuffer>}
|
|
17
|
+
*/
|
|
18
|
+
export async function doLayerNorm(input, weight, bias, opts) {
|
|
19
|
+
const { seqLen, hiddenSize, eps } = opts;
|
|
20
|
+
const outputSize = seqLen * hiddenSize * 4;
|
|
21
|
+
const output = acquireBuffer(outputSize, 'vision-layernorm');
|
|
22
|
+
await runLayerNorm({
|
|
23
|
+
input,
|
|
24
|
+
weight,
|
|
25
|
+
bias: bias || null,
|
|
26
|
+
output,
|
|
27
|
+
seqLen,
|
|
28
|
+
hiddenSize,
|
|
29
|
+
eps,
|
|
30
|
+
});
|
|
31
|
+
return output;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Matrix multiply on GPU.
|
|
36
|
+
* @param {GPUBuffer} a [M, K]
|
|
37
|
+
* @param {GPUBuffer} b [K, N]
|
|
38
|
+
* @param {{ M: number, K: number, N: number, bias?: GPUBuffer }} opts
|
|
39
|
+
* @returns {Promise<GPUBuffer>}
|
|
40
|
+
*/
|
|
41
|
+
export async function doMatmul(a, b, opts) {
|
|
42
|
+
const { M, K, N, bias } = opts;
|
|
43
|
+
const outputSize = M * N * 4;
|
|
44
|
+
const output = acquireBuffer(outputSize, 'vision-matmul');
|
|
45
|
+
await dispatchMatmul({
|
|
46
|
+
a, b, output,
|
|
47
|
+
M, K, N,
|
|
48
|
+
bias: bias || null,
|
|
49
|
+
});
|
|
50
|
+
return output;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* GELU activation on GPU.
|
|
55
|
+
* @param {GPUBuffer} input Flat buffer
|
|
56
|
+
* @param {{ count: number }} opts Total element count
|
|
57
|
+
* @returns {Promise<GPUBuffer>}
|
|
58
|
+
*/
|
|
59
|
+
export async function doGelu(input, opts) {
|
|
60
|
+
const { count } = opts;
|
|
61
|
+
const output = acquireBuffer(count * 4, 'vision-gelu');
|
|
62
|
+
await runGelu({ input, output, count });
|
|
63
|
+
return output;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* Element-wise residual add on GPU.
|
|
68
|
+
* @param {GPUBuffer} a
|
|
69
|
+
* @param {GPUBuffer} b
|
|
70
|
+
* @param {{ count: number }} opts
|
|
71
|
+
* @returns {Promise<GPUBuffer>}
|
|
72
|
+
*/
|
|
73
|
+
export async function doResidualAdd(a, b, opts) {
|
|
74
|
+
const { count } = opts;
|
|
75
|
+
const output = acquireBuffer(count * 4, 'vision-residual');
|
|
76
|
+
await runResidualAdd({ a, b, output, count });
|
|
77
|
+
return output;
|
|
78
|
+
}
|
|
@@ -0,0 +1,151 @@
|
|
|
1
|
+
|
|
2
|
+
|
|
3
|
+
import { trace } from '../../../debug/index.js';
|
|
4
|
+
import { getDevice } from '../../../gpu/device.js';
|
|
5
|
+
import { acquireBuffer } from '../../../memory/buffer-pool.js';
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* Patch embedding for the vision encoder.
|
|
9
|
+
*
|
|
10
|
+
* Qwen3-VL uses a 3D convolution for temporal+spatial patch extraction:
|
|
11
|
+
* Conv3D(in_channels=3, out_channels=hiddenSize, kernel=[temporalPatchSize, patchSize, patchSize])
|
|
12
|
+
*
|
|
13
|
+
* For single images (T=1), this reduces to a 2D convolution with stride=patchSize.
|
|
14
|
+
* The output is [numPatches, hiddenSize] where numPatches = (H/patchSize) * (W/patchSize).
|
|
15
|
+
*
|
|
16
|
+
* For the initial implementation, this runs on CPU and uploads to GPU.
|
|
17
|
+
* TODO(perf): GPU kernel for patch embedding (conv2d with large stride).
|
|
18
|
+
*
|
|
19
|
+
* @param {object} params
|
|
20
|
+
* @param {Float32Array} params.imageData Preprocessed image [C, H, W] normalized
|
|
21
|
+
* @param {number} params.height Image height (patch-aligned)
|
|
22
|
+
* @param {number} params.width Image width (patch-aligned)
|
|
23
|
+
* @param {number} params.channels Number of channels (3)
|
|
24
|
+
* @param {object} params.visionConfig Vision config
|
|
25
|
+
* @param {object} params.weights Vision encoder weight buffers
|
|
26
|
+
* @returns {Promise<{ patchBuffer: GPUBuffer, numPatches: number }>}
|
|
27
|
+
*/
|
|
28
|
+
export async function patchEmbed(params) {
|
|
29
|
+
const {
|
|
30
|
+
imageData, height, width, channels,
|
|
31
|
+
visionConfig, weights,
|
|
32
|
+
} = params;
|
|
33
|
+
|
|
34
|
+
const {
|
|
35
|
+
patchSize = 16,
|
|
36
|
+
hiddenSize = 1024,
|
|
37
|
+
temporalPatchSize = 2,
|
|
38
|
+
} = visionConfig;
|
|
39
|
+
|
|
40
|
+
const gridH = Math.floor(height / patchSize);
|
|
41
|
+
const gridW = Math.floor(width / patchSize);
|
|
42
|
+
const numPatches = gridH * gridW;
|
|
43
|
+
|
|
44
|
+
trace('vision', `patchEmbed: ${height}x${width} -> ${gridH}x${gridW} = ${numPatches} patches (${hiddenSize}d)`);
|
|
45
|
+
|
|
46
|
+
// Read conv weight from GPU to CPU for the embedding computation.
|
|
47
|
+
// Weight shape: [hiddenSize, channels * temporalPatchSize * patchSize * patchSize]
|
|
48
|
+
// For single image: effectively [hiddenSize, channels * patchSize * patchSize]
|
|
49
|
+
//
|
|
50
|
+
// Qwen3-VL patch_embed is actually:
|
|
51
|
+
// proj = Conv3d(3, embed_dim, kernel_size=(tpp, pp, pp), stride=(tpp, pp, pp))
|
|
52
|
+
// For T=1 frame, temporal dim collapses: input is [1, C, 1, H, W]
|
|
53
|
+
// Output: [1, embed_dim, 1, H/pp, W/pp] -> reshape to [numPatches, embed_dim]
|
|
54
|
+
|
|
55
|
+
const device = getDevice();
|
|
56
|
+
const patchArea = channels * patchSize * patchSize;
|
|
57
|
+
|
|
58
|
+
// Extract patches from image: each patch is [C, patchSize, patchSize] flattened.
|
|
59
|
+
const patches = new Float32Array(numPatches * patchArea);
|
|
60
|
+
for (let ph = 0; ph < gridH; ph++) {
|
|
61
|
+
for (let pw = 0; pw < gridW; pw++) {
|
|
62
|
+
const patchIdx = ph * gridW + pw;
|
|
63
|
+
for (let c = 0; c < channels; c++) {
|
|
64
|
+
for (let py = 0; py < patchSize; py++) {
|
|
65
|
+
for (let px = 0; px < patchSize; px++) {
|
|
66
|
+
const imgY = ph * patchSize + py;
|
|
67
|
+
const imgX = pw * patchSize + px;
|
|
68
|
+
const srcIdx = c * height * width + imgY * width + imgX;
|
|
69
|
+
const dstIdx = patchIdx * patchArea + c * patchSize * patchSize + py * patchSize + px;
|
|
70
|
+
patches[dstIdx] = imageData[srcIdx];
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
// Read the projection weight from GPU.
|
|
78
|
+
// The weight tensor name is visual.patch_embed.proj.weight with shape [hiddenSize, C, tpp, pp, pp].
|
|
79
|
+
// For temporal_patch_size=2 and a single frame, we need to handle the temporal dimension.
|
|
80
|
+
// In practice for a single image, we sum over the temporal kernel dimension.
|
|
81
|
+
const weightKey = 'visual.patch_embed.proj.weight';
|
|
82
|
+
const biasKey = 'visual.patch_embed.proj.bias';
|
|
83
|
+
|
|
84
|
+
const weightBuffer = weights[weightKey];
|
|
85
|
+
const biasBuffer = weights[biasKey] || null;
|
|
86
|
+
|
|
87
|
+
// Full conv weight size: hiddenSize * channels * temporalPatchSize * patchSize * patchSize
|
|
88
|
+
const fullWeightSize = hiddenSize * channels * temporalPatchSize * patchSize * patchSize;
|
|
89
|
+
const weightData = new Float32Array(fullWeightSize);
|
|
90
|
+
{
|
|
91
|
+
const staging = device.createBuffer({
|
|
92
|
+
size: fullWeightSize * 4,
|
|
93
|
+
usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ,
|
|
94
|
+
});
|
|
95
|
+
const encoder = device.createCommandEncoder();
|
|
96
|
+
encoder.copyBufferToBuffer(weightBuffer, 0, staging, 0, fullWeightSize * 4);
|
|
97
|
+
device.queue.submit([encoder.finish()]);
|
|
98
|
+
await staging.mapAsync(GPUMapMode.READ);
|
|
99
|
+
weightData.set(new Float32Array(staging.getMappedRange()));
|
|
100
|
+
staging.unmap();
|
|
101
|
+
staging.destroy();
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// For single frame: average over temporal kernel dimension to get [hiddenSize, C*pp*pp].
|
|
105
|
+
const spatialWeight = new Float32Array(hiddenSize * patchArea);
|
|
106
|
+
const spatialPatchArea = channels * patchSize * patchSize;
|
|
107
|
+
for (let h = 0; h < hiddenSize; h++) {
|
|
108
|
+
for (let s = 0; s < spatialPatchArea; s++) {
|
|
109
|
+
let sum = 0;
|
|
110
|
+
for (let t = 0; t < temporalPatchSize; t++) {
|
|
111
|
+
sum += weightData[h * temporalPatchSize * spatialPatchArea + t * spatialPatchArea + s];
|
|
112
|
+
}
|
|
113
|
+
spatialWeight[h * spatialPatchArea + s] = sum;
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
// Read bias if present.
|
|
118
|
+
let biasData = null;
|
|
119
|
+
if (biasBuffer) {
|
|
120
|
+
biasData = new Float32Array(hiddenSize);
|
|
121
|
+
const staging = device.createBuffer({
|
|
122
|
+
size: hiddenSize * 4,
|
|
123
|
+
usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ,
|
|
124
|
+
});
|
|
125
|
+
const encoder = device.createCommandEncoder();
|
|
126
|
+
encoder.copyBufferToBuffer(biasBuffer, 0, staging, 0, hiddenSize * 4);
|
|
127
|
+
device.queue.submit([encoder.finish()]);
|
|
128
|
+
await staging.mapAsync(GPUMapMode.READ);
|
|
129
|
+
biasData.set(new Float32Array(staging.getMappedRange()));
|
|
130
|
+
staging.unmap();
|
|
131
|
+
staging.destroy();
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
// Compute patch embeddings: patches [numPatches, patchArea] @ spatialWeight^T [patchArea, hiddenSize]
|
|
135
|
+
const embeddings = new Float32Array(numPatches * hiddenSize);
|
|
136
|
+
for (let p = 0; p < numPatches; p++) {
|
|
137
|
+
for (let h = 0; h < hiddenSize; h++) {
|
|
138
|
+
let val = biasData ? biasData[h] : 0;
|
|
139
|
+
for (let k = 0; k < patchArea; k++) {
|
|
140
|
+
val += patches[p * patchArea + k] * spatialWeight[h * patchArea + k];
|
|
141
|
+
}
|
|
142
|
+
embeddings[p * hiddenSize + h] = val;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
// Upload to GPU.
|
|
147
|
+
const patchBuffer = acquireBuffer(numPatches * hiddenSize * 4, 'vision-patch-embed');
|
|
148
|
+
device.queue.writeBuffer(patchBuffer, 0, embeddings);
|
|
149
|
+
|
|
150
|
+
return { patchBuffer, numPatches };
|
|
151
|
+
}
|
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* speculative.ts - Speculative Decoding
|
|
3
|
+
*
|
|
4
|
+
* Implements speculative decoding for faster inference.
|
|
5
|
+
* Uses a draft model to generate candidate tokens, then verifies
|
|
6
|
+
* them in parallel with the main model.
|
|
7
|
+
*
|
|
8
|
+
* Based on: "Fast Inference from Transformers via Speculative Decoding"
|
|
9
|
+
* (Leviathan et al., 2022)
|
|
10
|
+
*
|
|
11
|
+
* @module inference/speculative
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* Draft Model Interface
|
|
16
|
+
* Smaller/faster model used to generate candidate tokens
|
|
17
|
+
*/
|
|
18
|
+
export interface DraftModel {
|
|
19
|
+
/**
|
|
20
|
+
* Forward pass through the model
|
|
21
|
+
* @param inputIds - Token sequence
|
|
22
|
+
* @param kvCache - KV cache state
|
|
23
|
+
* @returns Logits and updated KV cache
|
|
24
|
+
*/
|
|
25
|
+
forward(
|
|
26
|
+
inputIds: number[],
|
|
27
|
+
kvCache?: KVCache
|
|
28
|
+
): Promise<{ logits: Float32Array; newKVCache?: KVCache }>;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Main Model Interface
|
|
33
|
+
* Used for verification of draft tokens
|
|
34
|
+
*/
|
|
35
|
+
export interface MainModel {
|
|
36
|
+
/**
|
|
37
|
+
* Forward pass through the model
|
|
38
|
+
* @param inputIds - Token sequence
|
|
39
|
+
* @param kvCache - KV cache state
|
|
40
|
+
* @returns Logits and updated KV cache
|
|
41
|
+
*/
|
|
42
|
+
forward(
|
|
43
|
+
inputIds: number[],
|
|
44
|
+
kvCache?: KVCache
|
|
45
|
+
): Promise<{ logits: Float32Array; newKVCache?: KVCache }>;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* KV Cache Interface
|
|
50
|
+
* Represents key-value cache state - compatible with KVCache class from kv-cache.ts
|
|
51
|
+
*/
|
|
52
|
+
export interface KVCache {
|
|
53
|
+
clone?(): KVCache;
|
|
54
|
+
currentSeqLen?: number;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* Speculative Decoding Configuration
|
|
59
|
+
*/
|
|
60
|
+
export interface SpeculativeConfig {
|
|
61
|
+
/** Number of tokens to draft */
|
|
62
|
+
numDraftTokens: number;
|
|
63
|
+
/** Max retries after rejection */
|
|
64
|
+
maxRejectionRetries: number;
|
|
65
|
+
/** Use tree-based drafting (experimental) */
|
|
66
|
+
enableTreeDraft: boolean;
|
|
67
|
+
/** Temperature for draft sampling */
|
|
68
|
+
temperature: number;
|
|
69
|
+
/** Deterministic seed for speculative sampling */
|
|
70
|
+
randomSeed: number;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* Verification Result
|
|
75
|
+
* Results from verifying draft tokens against main model
|
|
76
|
+
*/
|
|
77
|
+
export interface VerificationResult {
|
|
78
|
+
/** Number of accepted draft tokens */
|
|
79
|
+
acceptedCount: number;
|
|
80
|
+
/** The accepted token IDs */
|
|
81
|
+
acceptedTokens: number[];
|
|
82
|
+
/** Token sampled from corrected distribution */
|
|
83
|
+
sampledToken: number;
|
|
84
|
+
/** Whether all draft tokens were accepted */
|
|
85
|
+
allAccepted: boolean;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* Token Sampling Result
|
|
90
|
+
*/
|
|
91
|
+
interface SampleResult {
|
|
92
|
+
/** Sampled token ID */
|
|
93
|
+
token: number;
|
|
94
|
+
/** Log probabilities for entire vocabulary */
|
|
95
|
+
logprob: Float32Array;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Draft Generation Result
|
|
100
|
+
*/
|
|
101
|
+
interface DraftResult {
|
|
102
|
+
/** Generated draft tokens */
|
|
103
|
+
tokens: number[];
|
|
104
|
+
/** Log probabilities for each drafted token */
|
|
105
|
+
logprobs: Float32Array[];
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/**
|
|
109
|
+
* Step Result
|
|
110
|
+
* Results from one speculative decoding step
|
|
111
|
+
*/
|
|
112
|
+
export interface StepResult {
|
|
113
|
+
/** New tokens generated (accepted + sampled) */
|
|
114
|
+
newTokens: number[];
|
|
115
|
+
/** Updated main model KV cache */
|
|
116
|
+
mainKVCache?: KVCache;
|
|
117
|
+
/** Acceptance rate for this step */
|
|
118
|
+
acceptRate: number;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* Decoding Statistics
|
|
123
|
+
*/
|
|
124
|
+
export interface DecodingStats {
|
|
125
|
+
/** Total number of tokens drafted */
|
|
126
|
+
totalDrafted: number;
|
|
127
|
+
/** Total number of tokens accepted */
|
|
128
|
+
totalAccepted: number;
|
|
129
|
+
/** Total number of tokens rejected */
|
|
130
|
+
totalRejected: number;
|
|
131
|
+
/** Average acceptance rate */
|
|
132
|
+
averageAcceptRate: number;
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* Statistics with Speedup Estimate
|
|
137
|
+
*/
|
|
138
|
+
export interface StatsWithSpeedup extends DecodingStats {
|
|
139
|
+
/** Estimated speedup factor */
|
|
140
|
+
speedup: number;
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* Speculative Decoder
|
|
145
|
+
* Implements speculative decoding for faster inference
|
|
146
|
+
*/
|
|
147
|
+
export declare class SpeculativeDecoder {
|
|
148
|
+
private numDraftTokens;
|
|
149
|
+
private maxRejectionRetries;
|
|
150
|
+
private enableTreeDraft;
|
|
151
|
+
private temperature;
|
|
152
|
+
private random;
|
|
153
|
+
|
|
154
|
+
// Draft model reference (smaller/faster model)
|
|
155
|
+
protected draftModel: DraftModel | null;
|
|
156
|
+
// Main model reference (for verification)
|
|
157
|
+
private mainModel;
|
|
158
|
+
|
|
159
|
+
// Statistics
|
|
160
|
+
private stats;
|
|
161
|
+
|
|
162
|
+
constructor(config: SpeculativeConfig);
|
|
163
|
+
|
|
164
|
+
/**
|
|
165
|
+
* Set the draft model for speculation
|
|
166
|
+
*/
|
|
167
|
+
setDraftModel(model: DraftModel): void;
|
|
168
|
+
|
|
169
|
+
/**
|
|
170
|
+
* Set the main model for verification
|
|
171
|
+
*/
|
|
172
|
+
setMainModel(model: MainModel): void;
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* Generate draft tokens using the smaller model
|
|
176
|
+
*/
|
|
177
|
+
generateDraftTokens(
|
|
178
|
+
inputIds: number[],
|
|
179
|
+
kvCache?: KVCache,
|
|
180
|
+
numTokens?: number
|
|
181
|
+
): Promise<DraftResult>;
|
|
182
|
+
|
|
183
|
+
/**
|
|
184
|
+
* Sample a token from logits using temperature sampling
|
|
185
|
+
*/
|
|
186
|
+
sampleToken(logits: Float32Array, temperature: number): SampleResult;
|
|
187
|
+
|
|
188
|
+
/**
|
|
189
|
+
* Compute log softmax for numerical stability
|
|
190
|
+
*/
|
|
191
|
+
protected logSoftmax(logits: Float32Array): Float32Array;
|
|
192
|
+
|
|
193
|
+
/**
|
|
194
|
+
* Verify draft tokens against the main model
|
|
195
|
+
* Uses iterative forward passes with explicit logits-shape validation
|
|
196
|
+
*/
|
|
197
|
+
verifyDraftTokens(
|
|
198
|
+
inputIds: number[],
|
|
199
|
+
draftTokens: number[],
|
|
200
|
+
draftLogprobs: Float32Array[],
|
|
201
|
+
kvCache?: KVCache
|
|
202
|
+
): Promise<VerificationResult>;
|
|
203
|
+
|
|
204
|
+
/**
|
|
205
|
+
* Sample from residual distribution after rejection
|
|
206
|
+
*/
|
|
207
|
+
private sampleFromResidual(
|
|
208
|
+
mainLogits: Float32Array,
|
|
209
|
+
draftLogprobs: Float32Array,
|
|
210
|
+
wasRejected: boolean
|
|
211
|
+
): number;
|
|
212
|
+
|
|
213
|
+
/**
|
|
214
|
+
* Run one step of speculative decoding
|
|
215
|
+
*/
|
|
216
|
+
step(
|
|
217
|
+
inputIds: number[],
|
|
218
|
+
mainKVCache?: KVCache,
|
|
219
|
+
draftKVCache?: KVCache
|
|
220
|
+
): Promise<StepResult>;
|
|
221
|
+
|
|
222
|
+
/**
|
|
223
|
+
* Get speculative decoding statistics
|
|
224
|
+
*/
|
|
225
|
+
getStats(): StatsWithSpeedup;
|
|
226
|
+
|
|
227
|
+
/**
|
|
228
|
+
* Estimate speedup from speculative decoding
|
|
229
|
+
* Theoretical: (1 + α*k) where α is accept rate, k is num draft tokens
|
|
230
|
+
*/
|
|
231
|
+
private estimateSpeedup(): number;
|
|
232
|
+
|
|
233
|
+
/**
|
|
234
|
+
* Reset statistics
|
|
235
|
+
*/
|
|
236
|
+
resetStats(): void;
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
export default SpeculativeDecoder;
|