doppler-gpu 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +21 -1
- package/README.md +97 -29
- package/package.json +40 -27
- package/src/cli/config/doppler-quickstart.json +10 -0
- package/src/cli/doppler-cli.js +66 -22
- package/src/cli/doppler-quickstart.d.ts +61 -0
- package/src/cli/doppler-quickstart.js +299 -0
- package/src/cli/doppler-serve.js +395 -0
- package/src/client/doppler-api.browser.js +13 -377
- package/src/client/doppler-api.d.ts +35 -56
- package/src/client/doppler-api.js +12 -363
- package/src/client/doppler-registry.json +55 -2
- package/src/client/runtime/index.d.ts +63 -0
- package/src/client/runtime/index.js +173 -0
- package/src/client/runtime/lora.d.ts +36 -0
- package/src/client/runtime/lora.js +165 -0
- package/src/client/{doppler-provider → runtime}/model-manager.d.ts +1 -1
- package/src/client/{doppler-provider → runtime}/model-manager.js +56 -30
- package/src/client/runtime/model-session.d.ts +72 -0
- package/src/client/runtime/model-session.js +122 -0
- package/src/client/runtime/model-source.d.ts +43 -0
- package/src/client/runtime/model-source.js +101 -0
- package/src/client/{doppler-provider → runtime}/source-runtime.d.ts +8 -5
- package/src/client/runtime/source-runtime.js +919 -0
- package/src/client/runtime/storage.d.ts +5 -0
- package/src/client/runtime/storage.js +51 -0
- package/src/client/{doppler-provider → runtime}/types.d.ts +14 -2
- package/src/config/README.md +2 -0
- package/src/config/conversion/README.md +47 -7
- package/src/config/conversion/embeddinggemma/google-embeddinggemma-300m-q4k-ehf16-af32.json +67 -5
- package/src/config/conversion/gemma3/gemma-3-1b-it-f16-af32.json +62 -11
- package/src/config/conversion/gemma3/gemma-3-1b-it-q4k-ehf16-af32.json +79 -18
- package/src/config/conversion/gemma3/gemma-3-270m-it-q4k-ehf16-af32.json +61 -13
- package/src/config/conversion/gemma3/translategemma-4b-1b-enes-q4k-ehf16-af32.json +53 -10
- package/src/config/conversion/gemma3/translategemma-4b-it-q4k-ehf16-af32.json +66 -18
- package/src/config/conversion/gemma4/gemma-4-e2b-it-q4k-ehf16-af32.json +256 -0
- package/src/config/conversion/gemma4/gemma-4-moe-q4k-ehf16-af32.json +49 -8
- package/src/config/conversion/gpt-oss-20b-f16-xmxfp4.json +45 -6
- package/src/config/conversion/janus/janus-pro-1b-text-q4k-ehaf16.json +45 -6
- package/src/config/conversion/lfm2/lfm2.5-1.2b-instruct-q4k-ehf16-af32.json +57 -9
- package/src/config/conversion/qwen3/qwen-3-5-0-8b-q4k-ehaf16.json +105 -26
- package/src/config/conversion/qwen3/qwen-3-5-2b-q4k-ehaf16.json +83 -33
- package/src/config/conversion/sana/sana-sprint-0.6b-f16.json +33 -5
- package/src/config/execution-contract-check.d.ts +2 -1
- package/src/config/execution-contract-check.js +187 -53
- package/src/config/kernel-path-loader.d.ts +36 -0
- package/src/config/kernel-path-loader.js +97 -10
- package/src/config/kernels/kernel-ref-digests.js +40 -24
- package/src/config/kernels/registry.js +0 -1
- package/src/config/kernels/registry.json +772 -66
- package/src/config/merge-contract-check.js +3 -0
- package/src/config/merge.d.ts +18 -1
- package/src/config/merge.js +56 -0
- package/src/config/param-categories.js +5 -0
- package/src/config/param-validator.js +42 -26
- package/src/config/platforms/apple-m3.json +1 -1
- package/src/config/platforms/loader.js +21 -16
- package/src/config/required-inference-fields-contract-check.js +16 -0
- package/src/config/runtime/compute/f16-batched.json +2 -0
- package/src/config/runtime/default.json +1 -0
- package/src/config/runtime/experiments/bench/gemma3-bench-q4k-alt.json +57 -0
- package/src/config/runtime/experiments/bench/gemma3-bench-q4k-batched.json +57 -0
- package/src/config/runtime/experiments/bench/gemma3-bench-q4k.json +2 -0
- package/src/config/runtime/experiments/bench/qwen3-bench-q4k-alt.json +57 -0
- package/src/config/runtime/experiments/bench/qwen3-bench-q4k-batched.json +57 -0
- package/src/config/runtime/experiments/debug/gemma3-browser-diagnose-q4k.json +81 -0
- package/src/config/runtime/experiments/debug/gemma3-debug-q4k.json +5 -0
- package/src/config/runtime/experiments/debug/qwen35-browser-diagnose-q4k.json +81 -0
- package/src/config/runtime/experiments/verify/gemma4-e2b-verify.json +38 -0
- package/src/config/runtime/profiles/gemma4-e2b-low-memory.json +63 -0
- package/src/config/runtime/profiles/gemma4-e2b-throughput.json +39 -0
- package/src/config/runtime/profiles/low-memory.json +1 -0
- package/src/config/runtime/profiles/turboquant-contiguous-prod.json +29 -0
- package/src/config/runtime/profiles/turboquant-contiguous.json +29 -0
- package/src/config/runtime/profiles/turboquant.json +36 -0
- package/src/config/runtime/profiles/vector-stability.json +1 -0
- package/src/config/runtime/tiers/gemma4-128gb.json +79 -0
- package/src/config/runtime/tiers/gemma4-16gb.json +15 -2
- package/src/config/runtime/tiers/gemma4-24gb.json +15 -2
- package/src/config/runtime/tiers/gemma4-32gb.json +15 -2
- package/src/config/runtime.js +11 -4
- package/src/config/schema/converter.schema.d.ts +4 -2
- package/src/config/schema/converter.schema.js +7 -5
- package/src/config/schema/doppler.schema.d.ts +26 -2
- package/src/config/schema/doppler.schema.js +77 -28
- package/src/config/schema/execution-v1.schema.d.ts +78 -5
- package/src/config/schema/execution-v1.schema.js +62 -1
- package/src/config/schema/index.d.ts +22 -29
- package/src/config/schema/index.js +15 -17
- package/src/config/schema/inference.schema.d.ts +26 -4
- package/src/config/schema/kernel-path.schema.d.ts +30 -3
- package/src/config/schema/kernel-registry.schema.d.ts +1 -1
- package/src/config/schema/kernel-registry.schema.js +1 -0
- package/src/config/schema/kvcache.schema.js +7 -0
- package/src/config/schema/loading.schema.d.ts +28 -0
- package/src/config/schema/loading.schema.js +9 -0
- package/src/config/schema/manifest.schema.d.ts +79 -5
- package/src/config/schema/manifest.schema.js +7 -1
- package/src/config/schema/platform.schema.d.ts +10 -8
- package/src/config/schema/speculation-self.schema.js +0 -5
- package/src/config/schema/support-tiers.schema.d.ts +53 -0
- package/src/config/schema/support-tiers.schema.js +128 -0
- package/src/config/source-packages/litert/gemma-4-e2b-it.json +622 -0
- package/src/config/source-packages/registry.json +15 -0
- package/src/config/support-tiers/subsystems.json +502 -0
- package/src/config/transforms/capability-transform-resolver.d.ts +16 -5
- package/src/config/transforms/capability-transform-resolver.js +44 -9
- package/src/config/transforms/execution-graph-transforms.d.ts +113 -2
- package/src/config/transforms/execution-graph-transforms.js +1220 -8
- package/src/converter/conversion-plan.js +20 -8
- package/src/converter/core.d.ts +48 -1
- package/src/converter/core.js +249 -62
- package/src/converter/parsers/gguf.d.ts +10 -1
- package/src/converter/rope-config.d.ts +1 -0
- package/src/converter/rope-config.js +75 -5
- package/src/converter/shard-packer.js +2 -2
- package/src/debug/tensor.js +13 -1
- package/src/{adapters → experimental/adapters}/adapter-manager.d.ts +1 -1
- package/src/{adapters → experimental/adapters}/adapter-manager.js +2 -2
- package/src/{adapters → experimental/adapters}/adapter-manifest.d.ts +1 -1
- package/src/{adapters → experimental/adapters}/adapter-manifest.js +1 -1
- package/src/{adapters → experimental/adapters}/adapter-registry.d.ts +1 -1
- package/src/{adapters → experimental/adapters}/adapter-registry.js +1 -1
- package/src/{adapters → experimental/adapters}/lora-loader.d.ts +1 -1
- package/src/{adapters → experimental/adapters}/lora-loader.js +2 -2
- package/src/{bridge → experimental/bridge}/extension-client.js +2 -2
- package/src/{bridge → experimental/bridge}/node-bridge.js +2 -4
- package/src/{bridge → experimental/bridge}/protocol.js +1 -1
- package/src/{browser → experimental/browser}/browser-converter.d.ts +4 -4
- package/src/{browser → experimental/browser}/browser-converter.js +12 -12
- package/src/{browser → experimental/browser}/gguf-importer.d.ts +1 -1
- package/src/{browser → experimental/browser}/gguf-importer.js +8 -8
- package/src/{browser → experimental/browser}/gguf-parser-browser.d.ts +2 -2
- package/src/{browser → experimental/browser}/gguf-parser-browser.js +3 -3
- package/src/{browser → experimental/browser}/quantization.d.ts +3 -3
- package/src/{browser → experimental/browser}/quantization.js +4 -4
- package/src/{browser → experimental/browser}/safetensors-parser-browser.d.ts +3 -3
- package/src/{browser → experimental/browser}/safetensors-parser-browser.js +3 -3
- package/src/{browser → experimental/browser}/shard-io-browser.d.ts +1 -1
- package/src/{browser → experimental/browser}/shard-io-browser.js +2 -2
- package/src/{browser → experimental/browser}/tensor-source-download.js +3 -3
- package/src/experimental/diffusion/index.d.ts +8 -0
- package/src/experimental/diffusion/index.js +8 -0
- package/src/{distribution → experimental/distribution}/p2p-transport-contract.js +1 -1
- package/src/{distribution → experimental/distribution}/p2p-transport.js +1 -1
- package/src/{distribution → experimental/distribution}/shard-delivery.js +5 -5
- package/src/experimental/energy/index.d.ts +2 -0
- package/src/experimental/energy/index.js +2 -0
- package/src/{hotswap → experimental/hotswap}/intent-bundle.d.ts +1 -1
- package/src/{hotswap → experimental/hotswap}/intent-bundle.js +2 -2
- package/src/{hotswap → experimental/hotswap}/manifest.d.ts +2 -2
- package/src/{hotswap → experimental/hotswap}/manifest.js +1 -1
- package/src/{hotswap → experimental/hotswap}/model-swap.js +1 -1
- package/src/{hotswap → experimental/hotswap}/runtime.d.ts +1 -1
- package/src/experimental/orchestration/index.d.ts +12 -0
- package/src/experimental/orchestration/index.js +12 -0
- package/src/{training → experimental/training}/README.md +1 -1
- package/src/{training → experimental/training}/artifacts.d.ts +3 -3
- package/src/{training → experimental/training}/artifacts.js +3 -3
- package/src/{training → experimental/training}/attention-backward.d.ts +1 -1
- package/src/{training → experimental/training}/attention-backward.js +3 -3
- package/src/{training → experimental/training}/attention-forward.d.ts +2 -2
- package/src/{training → experimental/training}/attention-forward.js +1 -1
- package/src/{training → experimental/training}/autograd.d.ts +2 -2
- package/src/{training → experimental/training}/autograd.js +7 -7
- package/src/{training → experimental/training}/backward-kernels.js +1 -1
- package/src/{training → experimental/training}/checkpoint.js +1 -1
- package/src/{training → experimental/training}/clip.d.ts +2 -2
- package/src/{training → experimental/training}/clip.js +3 -3
- package/src/{training → experimental/training}/export.d.ts +2 -2
- package/src/{training → experimental/training}/export.js +2 -2
- package/src/{training → experimental/training}/lora-pipeline.js +4 -4
- package/src/{training → experimental/training}/lora.d.ts +1 -1
- package/src/{training → experimental/training}/lora.js +4 -4
- package/src/{training → experimental/training}/loss-scaling.d.ts +2 -2
- package/src/{training → experimental/training}/loss-scaling.js +3 -3
- package/src/{training → experimental/training}/loss.d.ts +2 -2
- package/src/{training → experimental/training}/loss.js +1 -1
- package/src/{training → experimental/training}/operator-artifacts.js +1 -1
- package/src/{training → experimental/training}/optimizer.d.ts +2 -2
- package/src/{training → experimental/training}/optimizer.js +3 -3
- package/src/{training → experimental/training}/runner.d.ts +2 -2
- package/src/{training → experimental/training}/runner.js +5 -5
- package/src/{training → experimental/training}/suite.js +16 -16
- package/src/{training → experimental/training}/tensor-factory.d.ts +1 -1
- package/src/{training → experimental/training}/tensor-factory.js +2 -2
- package/src/{training → experimental/training}/trainer.d.ts +3 -3
- package/src/{training → experimental/training}/trainer.js +3 -3
- package/src/{training → experimental/training}/ul_dataset.d.ts +2 -2
- package/src/{training → experimental/training}/ul_dataset.js +1 -1
- package/src/{training → experimental/training}/ul_schedule.d.ts +1 -1
- package/src/{training → experimental/training}/workloads.js +4 -4
- package/src/formats/index.d.ts +24 -0
- package/src/formats/index.js +6 -0
- package/src/formats/litert/index.d.ts +1 -0
- package/src/formats/litert/index.js +1 -0
- package/src/formats/litert/types.d.ts +87 -0
- package/src/formats/litert/types.js +568 -0
- package/src/formats/rdrr/classification.js +16 -8
- package/src/formats/rdrr/parsing.d.ts +3 -2
- package/src/formats/rdrr/types.d.ts +33 -0
- package/src/formats/rdrr/validation.js +16 -5
- package/src/formats/tflite/index.d.ts +1 -0
- package/src/formats/tflite/index.js +1 -0
- package/src/formats/tflite/types.d.ts +84 -0
- package/src/formats/tflite/types.js +633 -0
- package/src/generation/index.d.ts +16 -14
- package/src/generation/index.js +1 -32
- package/src/gpu/command-recorder.d.ts +17 -1
- package/src/gpu/command-recorder.js +47 -10
- package/src/gpu/device.d.ts +3 -1
- package/src/gpu/device.js +17 -11
- package/src/gpu/kernel-selector.js +3 -1
- package/src/gpu/kernels/attention.d.ts +2 -0
- package/src/gpu/kernels/attention.js +359 -14
- package/src/gpu/kernels/attention.wgsl +20 -1
- package/src/gpu/kernels/attention_decode_contiguous_turboquant_f16kv.wgsl +180 -0
- package/src/gpu/kernels/attention_decode_contiguous_turboquant_prod_f16kv.wgsl +192 -0
- package/src/gpu/kernels/attention_decode_online_f16.wgsl +36 -18
- package/src/gpu/kernels/attention_decode_online_f16kv.wgsl +36 -18
- package/src/gpu/kernels/attention_decode_tiered_turboquant_f16kv.wgsl +269 -0
- package/src/gpu/kernels/attention_decode_tiered_turboquant_prod_f16kv.wgsl +281 -0
- package/src/gpu/kernels/attention_head256_f16kv.wgsl +269 -0
- package/src/gpu/kernels/attention_streaming.wgsl +22 -3
- package/src/gpu/kernels/attention_streaming_f16.wgsl +1 -1
- package/src/gpu/kernels/attention_streaming_f16kv.wgsl +1 -1
- package/src/gpu/kernels/backward/attention_backward.d.ts +14 -1
- package/src/gpu/kernels/check-hot-vocab-stop.d.ts +18 -0
- package/src/gpu/kernels/check-hot-vocab-stop.js +108 -0
- package/src/gpu/kernels/codegen/patches/attention_streaming_f16.from.attention_streaming.diff +1 -1
- package/src/gpu/kernels/codegen/patches/attention_streaming_f16kv.from.attention_streaming.diff +1 -1
- package/src/gpu/kernels/codegen/patches/rope_f16.from.rope.diff +126 -194
- package/src/gpu/kernels/codegen/wgsl-variants.js +24 -6
- package/src/gpu/kernels/depthwise_conv1d.d.ts +23 -0
- package/src/gpu/kernels/depthwise_conv1d.js +51 -0
- package/src/gpu/kernels/depthwise_conv1d.wgsl +46 -0
- package/src/gpu/kernels/feature-check.js +0 -1
- package/src/gpu/kernels/fused_ffn.js +67 -22
- package/src/gpu/kernels/fused_ffn_q4k.wgsl +48 -43
- package/src/gpu/kernels/fused_ffn_q4k_f16.wgsl +329 -0
- package/src/gpu/kernels/fused_matmul_q4.wgsl +417 -0
- package/src/gpu/kernels/fused_matmul_q4_batched_multicol_shared.wgsl +174 -0
- package/src/gpu/kernels/gather.d.ts +4 -0
- package/src/gpu/kernels/gather.js +13 -2
- package/src/gpu/kernels/gather.wgsl +5 -3
- package/src/gpu/kernels/gather_f16.wgsl +5 -3
- package/src/gpu/kernels/index.d.ts +7 -0
- package/src/gpu/kernels/index.js +6 -0
- package/src/gpu/kernels/kernel-configs.js +1 -0
- package/src/gpu/kernels/kv-quantize.js +87 -55
- package/src/gpu/kernels/kv_quantize_turboquant.wgsl +153 -0
- package/src/gpu/kernels/kv_quantize_turboquant_prod.wgsl +230 -0
- package/src/gpu/kernels/linear-attention-core.d.ts +3 -0
- package/src/gpu/kernels/linear-attention-core.js +145 -56
- package/src/gpu/kernels/matmul-dispatch.js +3 -0
- package/src/gpu/kernels/matmul-selection.js +31 -42
- package/src/gpu/kernels/matmul.d.ts +3 -0
- package/src/gpu/kernels/matmul.js +72 -34
- package/src/gpu/kernels/residual.d.ts +2 -0
- package/src/gpu/kernels/residual.js +43 -4
- package/src/gpu/kernels/rope.d.ts +2 -0
- package/src/gpu/kernels/rope.js +19 -6
- package/src/gpu/kernels/rope.wgsl +24 -12
- package/src/gpu/kernels/rope_f16.wgsl +97 -38
- package/src/gpu/kernels/scale.d.ts +5 -0
- package/src/gpu/kernels/scale.js +6 -1
- package/src/gpu/kernels/scale.wgsl +3 -1
- package/src/gpu/kernels/scale_f16.wgsl +32 -0
- package/src/gpu/kernels/turboquant-codebook.js +564 -0
- package/src/gpu/kernels/uniform-utils.js +26 -0
- package/src/gpu/kernels/utils.js +6 -1
- package/src/gpu/submit-probe.d.ts +12 -0
- package/src/gpu/submit-probe.js +77 -0
- package/src/gpu/weight-buffer.d.ts +26 -3
- package/src/gpu/weight-buffer.js +62 -2
- package/src/index-browser.d.ts +1 -91
- package/src/index-browser.js +0 -66
- package/src/index.d.ts +1 -102
- package/src/index.js +0 -74
- package/src/inference/browser-harness-model-helpers.d.ts +3 -0
- package/src/inference/browser-harness-model-helpers.js +134 -11
- package/src/inference/browser-harness-runtime-helpers.js +1 -9
- package/src/inference/browser-harness-text-helpers.js +441 -70
- package/src/inference/browser-harness.js +61 -4
- package/src/inference/decode-ring.d.ts +2 -0
- package/src/inference/decode-ring.js +20 -0
- package/src/inference/kv-cache/index.d.ts +3 -0
- package/src/inference/kv-cache/index.js +2 -0
- package/src/inference/kv-cache/mixed-geometry.d.ts +84 -0
- package/src/inference/kv-cache/mixed-geometry.js +422 -0
- package/src/inference/kv-cache/quantized.d.ts +56 -0
- package/src/inference/kv-cache/quantized.js +383 -0
- package/src/inference/kv-cache/tiered.d.ts +20 -3
- package/src/inference/kv-cache/tiered.js +203 -65
- package/src/inference/kv-cache/types.d.ts +49 -6
- package/src/inference/kv-cache.d.ts +3 -0
- package/src/inference/kv-cache.js +2 -0
- package/src/inference/multi-model-network.js +2 -1
- package/src/inference/pipelines/audio/gemma4.js +655 -0
- package/src/inference/pipelines/audio/index.js +39 -0
- package/src/inference/pipelines/audio/mel.js +171 -0
- package/src/inference/pipelines/context.js +9 -1
- package/src/inference/pipelines/diffusion/text-encoder-gpu.js +2 -0
- package/src/inference/pipelines/shared/clipped-linear.js +46 -0
- package/src/inference/pipelines/text/attention/dispatch-params.d.ts +2 -1
- package/src/inference/pipelines/text/attention/dispatch-params.js +52 -8
- package/src/inference/pipelines/text/attention/output-projection.js +3 -3
- package/src/inference/pipelines/text/attention/precision-contract.d.ts +36 -0
- package/src/inference/pipelines/text/attention/precision-contract.js +115 -0
- package/src/inference/pipelines/text/attention/projections.d.ts +23 -0
- package/src/inference/pipelines/text/attention/projections.js +182 -15
- package/src/inference/pipelines/text/attention/quant-options.js +54 -0
- package/src/inference/pipelines/text/attention/record.js +257 -69
- package/src/inference/pipelines/text/attention/run.js +306 -94
- package/src/inference/pipelines/text/attention/types.d.ts +11 -0
- package/src/inference/pipelines/text/chat-format.d.ts +8 -1
- package/src/inference/pipelines/text/chat-format.js +89 -5
- package/src/inference/pipelines/text/config.d.ts +78 -26
- package/src/inference/pipelines/text/config.js +722 -28
- package/src/inference/pipelines/text/dtype-contract.d.ts +15 -0
- package/src/inference/pipelines/text/dtype-contract.js +38 -0
- package/src/inference/pipelines/text/embed.d.ts +4 -0
- package/src/inference/pipelines/text/embed.js +165 -172
- package/src/inference/pipelines/text/execution-plan.d.ts +19 -0
- package/src/inference/pipelines/text/execution-plan.js +112 -20
- package/src/inference/pipelines/text/execution-runtime-builders.d.ts +8 -4
- package/src/inference/pipelines/text/execution-runtime-builders.js +90 -49
- package/src/inference/pipelines/text/execution-v1.d.ts +23 -4
- package/src/inference/pipelines/text/execution-v1.js +411 -33
- package/src/inference/pipelines/text/ffn/dense.d.ts +59 -0
- package/src/inference/pipelines/text/ffn/dense.js +575 -63
- package/src/inference/pipelines/text/ffn/moe.js +1 -0
- package/src/inference/pipelines/text/ffn/sandwich.js +20 -4
- package/src/inference/pipelines/text/ffn/standard.js +28 -4
- package/src/inference/pipelines/text/finiteness-policy.d.ts +4 -0
- package/src/inference/pipelines/text/finiteness-policy.js +14 -11
- package/src/inference/pipelines/text/generator-helpers.d.ts +7 -0
- package/src/inference/pipelines/text/generator-helpers.js +39 -4
- package/src/inference/pipelines/text/generator-runtime.js +45 -8
- package/src/inference/pipelines/text/generator-steps.js +407 -75
- package/src/inference/pipelines/text/generator.d.ts +6 -0
- package/src/inference/pipelines/text/generator.js +1179 -305
- package/src/inference/pipelines/text/init.d.ts +39 -7
- package/src/inference/pipelines/text/init.js +525 -110
- package/src/inference/pipelines/text/layer-plan.d.ts +1 -0
- package/src/inference/pipelines/text/layer-plan.js +2 -0
- package/src/inference/pipelines/text/layer.js +402 -19
- package/src/inference/pipelines/text/linear-attention.d.ts +4 -0
- package/src/inference/pipelines/text/linear-attention.js +112 -41
- package/src/inference/pipelines/text/logits/gpu.d.ts +2 -1
- package/src/inference/pipelines/text/logits/gpu.js +334 -15
- package/src/inference/pipelines/text/logits/index.d.ts +11 -0
- package/src/inference/pipelines/text/logits/index.js +227 -29
- package/src/inference/pipelines/text/logits/types.d.ts +3 -0
- package/src/inference/pipelines/text/logits/utils.js +3 -1
- package/src/inference/pipelines/text/lora-apply.js +3 -3
- package/src/inference/pipelines/text/model-load.d.ts +2 -1
- package/src/inference/pipelines/text/model-load.js +205 -178
- package/src/inference/pipelines/text/moe-gpu.js +8 -0
- package/src/inference/pipelines/text/moe-impl.d.ts +2 -0
- package/src/inference/pipelines/text/ops.d.ts +16 -2
- package/src/inference/pipelines/text/ops.js +11 -2
- package/src/inference/pipelines/text/per-layer-inputs.d.ts +107 -0
- package/src/inference/pipelines/text/per-layer-inputs.js +1581 -0
- package/src/inference/pipelines/text/probes.js +6 -0
- package/src/inference/pipelines/text/sampling-config.js +9 -1
- package/src/inference/pipelines/text/stage-names.js +3 -0
- package/src/inference/pipelines/text/state.d.ts +12 -3
- package/src/inference/pipelines/text/state.js +19 -0
- package/src/inference/pipelines/text/types.d.ts +79 -7
- package/src/inference/pipelines/text/weights.d.ts +2 -2
- package/src/inference/pipelines/text/weights.js +4 -0
- package/src/inference/pipelines/text.d.ts +6 -0
- package/src/inference/pipelines/text.js +860 -11
- package/src/inference/pipelines/video/frame-sampler.js +36 -0
- package/src/inference/pipelines/video/index.js +87 -0
- package/src/inference/pipelines/vision/encoder.js +27 -6
- package/src/inference/pipelines/vision/gemma4.js +731 -0
- package/src/inference/pipelines/vision/image-preprocess.js +22 -7
- package/src/inference/pipelines/vision/index.js +35 -10
- package/src/inference/pipelines/vision/ops.js +31 -26
- package/src/inference/pipelines/vision/patch-embed.js +22 -10
- package/src/inference/runtime-model.d.ts +89 -0
- package/src/inference/runtime-model.js +152 -0
- package/src/inference/test-harness.d.ts +8 -1
- package/src/inference/test-harness.js +54 -20
- package/src/inference/tokenizer.d.ts +5 -0
- package/src/inference/tokenizer.js +43 -0
- package/src/inference/tokenizers/base.d.ts +5 -0
- package/src/inference/tokenizers/base.js +5 -0
- package/src/inference/tokenizers/behavior-flags.d.ts +9 -0
- package/src/inference/tokenizers/behavior-flags.js +100 -0
- package/src/inference/tokenizers/bundled.d.ts +4 -0
- package/src/inference/tokenizers/bundled.js +110 -0
- package/src/inference/tokenizers/sentencepiece.d.ts +2 -0
- package/src/inference/tokenizers/sentencepiece.js +16 -0
- package/src/inference/tokenizers/types.d.ts +2 -0
- package/src/loader/doppler-loader.d.ts +10 -3
- package/src/loader/doppler-loader.js +103 -5
- package/src/loader/embedding-loader.d.ts +5 -1
- package/src/loader/embedding-loader.js +57 -6
- package/src/loader/final-weights-loader.js +44 -5
- package/src/loader/layer-loader.js +210 -8
- package/src/loader/loader-state.js +2 -2
- package/src/loader/loader-types.d.ts +17 -1
- package/src/loader/memory-monitor.d.ts +8 -0
- package/src/loader/memory-monitor.js +21 -0
- package/src/loader/multi-model-loader.d.ts +9 -1
- package/src/loader/multi-model-loader.js +9 -1
- package/src/loader/per-layer-input-loader.d.ts +30 -0
- package/src/loader/per-layer-input-loader.js +478 -0
- package/src/loader/shard-cache.d.ts +4 -3
- package/src/loader/shard-resolver.js +2 -0
- package/src/loader/tensors/source-transform.d.ts +50 -0
- package/src/loader/tensors/source-transform.js +776 -0
- package/src/loader/tensors/tensor-loader.d.ts +12 -0
- package/src/loader/tensors/tensor-loader.js +208 -123
- package/src/loader/tensors/tensor-reader.d.ts +8 -0
- package/src/loader/tensors/tensor-reader.js +283 -15
- package/src/loaders/index.d.ts +4 -0
- package/src/loaders/index.js +4 -0
- package/src/memory/buffer-pool.d.ts +4 -0
- package/src/memory/buffer-pool.js +36 -0
- package/src/rules/execution-rules-contract-check.d.ts +4 -0
- package/src/rules/execution-rules-contract-check.js +150 -24
- package/src/rules/inference/attention.rules.json +15 -0
- package/src/rules/inference/capability-transforms.rules.json +30 -0
- package/src/rules/inference/execution.rules.json +54 -2
- package/src/rules/inference/ffn.rules.json +33 -0
- package/src/rules/kernels/attention.rules.json +7 -0
- package/src/rules/kernels/fused-ffn.rules.json +4 -2
- package/src/rules/kernels/kv_quantize.rules.json +2 -0
- package/src/rules/kernels/matmul.rules.json +14 -0
- package/src/rules/kernels/scale.rules.json +2 -0
- package/src/rules/loader/tensor-loader.rules.json +1 -0
- package/src/storage/artifact-storage-context.d.ts +53 -0
- package/src/storage/artifact-storage-context.js +560 -0
- package/src/storage/downloader.js +7 -1
- package/src/storage/index.d.ts +18 -0
- package/src/storage/index.js +13 -0
- package/src/storage/preflight.js +22 -0
- package/src/storage/quickstart-downloader.js +35 -2
- package/src/storage/registry.d.ts +1 -0
- package/src/storage/registry.js +26 -4
- package/src/storage/shard-manager.d.ts +4 -0
- package/src/storage/shard-manager.js +25 -6
- package/src/storage/source-artifact-store.d.ts +9 -0
- package/src/storage/source-artifact-store.js +134 -0
- package/src/tooling/browser-command-runner.js +12 -5
- package/src/tooling/command-api-family-normalizers.js +144 -0
- package/src/tooling/command-api-helpers.js +1 -0
- package/src/tooling/command-api.d.ts +32 -9
- package/src/tooling/command-api.js +0 -25
- package/src/tooling/command-runner-shared.js +1 -2
- package/src/tooling/command-runner.html +5 -2
- package/src/tooling/diagnose-runner.js +1 -1
- package/src/tooling/kernel-path-builder/index.js +48 -32
- package/src/tooling/lean-execution-contract.d.ts +1 -1
- package/src/tooling/lean-execution-contract.js +2 -149
- package/src/tooling/litert-package-runtime.d.ts +46 -0
- package/src/tooling/litert-package-runtime.js +950 -0
- package/src/tooling/node-browser-command-runner.d.ts +13 -0
- package/src/tooling/node-browser-command-runner.js +163 -3
- package/src/tooling/node-command-runner.js +14 -5
- package/src/tooling/node-converter.js +226 -63
- package/src/tooling/node-source-runtime.d.ts +8 -3
- package/src/tooling/node-source-runtime.js +561 -236
- package/src/tooling/node-webgpu.js +7 -30
- package/src/tooling/opfs-cache.d.ts +18 -1
- package/src/tooling/opfs-cache.js +126 -9
- package/src/tooling/runtime-input-composition.d.ts +0 -1
- package/src/tooling/runtime-input-composition.js +0 -5
- package/src/tooling/source-artifact-adapter.d.ts +134 -0
- package/src/tooling/source-artifact-adapter.js +366 -0
- package/src/tooling/source-package-profiles.d.ts +33 -0
- package/src/tooling/source-package-profiles.js +57 -0
- package/src/tooling/source-runtime-bundle.d.ts +46 -6
- package/src/tooling/source-runtime-bundle.js +371 -60
- package/src/tooling/source-runtime-converter-config.d.ts +24 -0
- package/src/tooling/source-runtime-converter-config.js +297 -0
- package/src/tooling-experimental-exports.browser.js +2 -0
- package/src/tooling-experimental-exports.d.ts +7 -0
- package/src/tooling-experimental-exports.js +7 -0
- package/src/tooling-experimental-exports.shared.d.ts +26 -0
- package/src/tooling-experimental-exports.shared.js +29 -0
- package/src/tooling-exports.shared.d.ts +0 -23
- package/src/tooling-exports.shared.js +6 -28
- package/src/version.js +1 -1
- package/src/client/doppler-provider/generation.d.ts +0 -25
- package/src/client/doppler-provider/generation.js +0 -126
- package/src/client/doppler-provider/index.d.ts +0 -2
- package/src/client/doppler-provider/index.js +0 -3
- package/src/client/doppler-provider/provider.d.ts +0 -5
- package/src/client/doppler-provider/provider.js +0 -102
- package/src/client/doppler-provider/source-runtime.js +0 -677
- package/src/client/doppler-provider.d.ts +0 -46
- package/src/client/doppler-provider.js +0 -36
- package/src/config/schema/inference-defaults.schema.d.ts +0 -276
- package/src/config/schema/inference-defaults.schema.js +0 -189
- package/src/diffusion/index.d.ts +0 -8
- package/src/diffusion/index.js +0 -8
- package/src/energy/index.d.ts +0 -2
- package/src/energy/index.js +0 -2
- package/src/index-internal.d.ts +0 -2
- package/src/index-internal.js +0 -2
- /package/src/client/{doppler-provider → runtime}/types.js +0 -0
- /package/src/{adapters → experimental/adapters}/index.d.ts +0 -0
- /package/src/{adapters → experimental/adapters}/index.js +0 -0
- /package/src/{bridge → experimental/bridge}/extension/background.d.ts +0 -0
- /package/src/{bridge → experimental/bridge}/extension/background.js +0 -0
- /package/src/{bridge → experimental/bridge}/extension/manifest.json +0 -0
- /package/src/{bridge → experimental/bridge}/extension-client.d.ts +0 -0
- /package/src/{bridge → experimental/bridge}/index.d.ts +0 -0
- /package/src/{bridge → experimental/bridge}/index.js +0 -0
- /package/src/{bridge → experimental/bridge}/protocol.d.ts +0 -0
- /package/src/{browser → experimental/browser}/file-picker.d.ts +0 -0
- /package/src/{browser → experimental/browser}/file-picker.js +0 -0
- /package/src/{browser → experimental/browser}/tensor-source-download.d.ts +0 -0
- /package/src/{browser → experimental/browser}/tensor-source-file.d.ts +0 -0
- /package/src/{browser → experimental/browser}/tensor-source-file.js +0 -0
- /package/src/{browser → experimental/browser}/tensor-source-http.d.ts +0 -0
- /package/src/{browser → experimental/browser}/tensor-source-http.js +0 -0
- /package/src/{diffusion → experimental/diffusion}/config/expansion-lanes.json +0 -0
- /package/src/{diffusion → experimental/diffusion}/image-regression.d.ts +0 -0
- /package/src/{diffusion → experimental/diffusion}/image-regression.js +0 -0
- /package/src/{distribution → experimental/distribution}/p2p-control-plane.d.ts +0 -0
- /package/src/{distribution → experimental/distribution}/p2p-control-plane.js +0 -0
- /package/src/{distribution → experimental/distribution}/p2p-observability.d.ts +0 -0
- /package/src/{distribution → experimental/distribution}/p2p-observability.js +0 -0
- /package/src/{distribution → experimental/distribution}/p2p-transport-contract.d.ts +0 -0
- /package/src/{distribution → experimental/distribution}/p2p-webrtc-browser.d.ts +0 -0
- /package/src/{distribution → experimental/distribution}/p2p-webrtc-browser.js +0 -0
- /package/src/{distribution → experimental/distribution}/shard-delivery.d.ts +0 -0
- /package/src/{hotswap → experimental/hotswap}/runtime.js +0 -0
- /package/src/{training → experimental/training}/checkpoint-watch.d.ts +0 -0
- /package/src/{training → experimental/training}/checkpoint-watch.js +0 -0
- /package/src/{training → experimental/training}/checkpoint.d.ts +0 -0
- /package/src/{training → experimental/training}/dataloader.d.ts +0 -0
- /package/src/{training → experimental/training}/dataloader.js +0 -0
- /package/src/{training → experimental/training}/datasets/index.d.ts +0 -0
- /package/src/{training → experimental/training}/datasets/index.js +0 -0
- /package/src/{training → experimental/training}/datasets/jsonl.d.ts +0 -0
- /package/src/{training → experimental/training}/datasets/jsonl.js +0 -0
- /package/src/{training → experimental/training}/datasets/reploid.d.ts +0 -0
- /package/src/{training → experimental/training}/datasets/reploid.js +0 -0
- /package/src/{training → experimental/training}/datasets/text-pairs.d.ts +0 -0
- /package/src/{training → experimental/training}/datasets/text-pairs.js +0 -0
- /package/src/{training → experimental/training}/datasets/token-batch.d.ts +0 -0
- /package/src/{training → experimental/training}/datasets/token-batch.js +0 -0
- /package/src/{training → experimental/training}/datasets/translation-pairs.d.ts +0 -0
- /package/src/{training → experimental/training}/datasets/translation-pairs.js +0 -0
- /package/src/{training → experimental/training}/distillation/artifacts.d.ts +0 -0
- /package/src/{training → experimental/training}/distillation/artifacts.js +0 -0
- /package/src/{training → experimental/training}/distillation/checkpoint-watch.d.ts +0 -0
- /package/src/{training → experimental/training}/distillation/checkpoint-watch.js +0 -0
- /package/src/{training → experimental/training}/distillation/dataset.d.ts +0 -0
- /package/src/{training → experimental/training}/distillation/dataset.js +0 -0
- /package/src/{training → experimental/training}/distillation/eval.d.ts +0 -0
- /package/src/{training → experimental/training}/distillation/eval.js +0 -0
- /package/src/{training → experimental/training}/distillation/index.d.ts +0 -0
- /package/src/{training → experimental/training}/distillation/index.js +0 -0
- /package/src/{training → experimental/training}/distillation/runtime.d.ts +0 -0
- /package/src/{training → experimental/training}/distillation/runtime.js +0 -0
- /package/src/{training → experimental/training}/distillation/scoreboard.d.ts +0 -0
- /package/src/{training → experimental/training}/distillation/scoreboard.js +0 -0
- /package/src/{training → experimental/training}/distillation/stage-a.d.ts +0 -0
- /package/src/{training → experimental/training}/distillation/stage-a.js +0 -0
- /package/src/{training → experimental/training}/distillation/stage-b.d.ts +0 -0
- /package/src/{training → experimental/training}/distillation/stage-b.js +0 -0
- /package/src/{training → experimental/training}/distillation/student-fixture.d.ts +0 -0
- /package/src/{training → experimental/training}/distillation/student-fixture.js +0 -0
- /package/src/{training → experimental/training}/distillation/suite-data.d.ts +0 -0
- /package/src/{training → experimental/training}/distillation/suite-data.js +0 -0
- /package/src/{training → experimental/training}/index.d.ts +0 -0
- /package/src/{training → experimental/training}/index.js +0 -0
- /package/src/{training → experimental/training}/lora-pipeline.d.ts +0 -0
- /package/src/{training → experimental/training}/objectives/base.d.ts +0 -0
- /package/src/{training → experimental/training}/objectives/base.js +0 -0
- /package/src/{training → experimental/training}/objectives/cross_entropy.d.ts +0 -0
- /package/src/{training → experimental/training}/objectives/cross_entropy.js +0 -0
- /package/src/{training → experimental/training}/objectives/distill_kd.d.ts +0 -0
- /package/src/{training → experimental/training}/objectives/distill_kd.js +0 -0
- /package/src/{training → experimental/training}/objectives/distill_triplet.d.ts +0 -0
- /package/src/{training → experimental/training}/objectives/distill_triplet.js +0 -0
- /package/src/{training → experimental/training}/objectives/index.d.ts +0 -0
- /package/src/{training → experimental/training}/objectives/index.js +0 -0
- /package/src/{training → experimental/training}/objectives/ul_stage1_joint.d.ts +0 -0
- /package/src/{training → experimental/training}/objectives/ul_stage1_joint.js +0 -0
- /package/src/{training → experimental/training}/objectives/ul_stage2_base.d.ts +0 -0
- /package/src/{training → experimental/training}/objectives/ul_stage2_base.js +0 -0
- /package/src/{training → experimental/training}/operator-artifacts.d.ts +0 -0
- /package/src/{training → experimental/training}/operator-command.d.ts +0 -0
- /package/src/{training → experimental/training}/operator-command.js +0 -0
- /package/src/{training → experimental/training}/operator-eval.d.ts +0 -0
- /package/src/{training → experimental/training}/operator-eval.js +0 -0
- /package/src/{training → experimental/training}/operator-scoreboard.d.ts +0 -0
- /package/src/{training → experimental/training}/operator-scoreboard.js +0 -0
- /package/src/{training → experimental/training}/suite.d.ts +0 -0
- /package/src/{training → experimental/training}/ul_schedule.js +0 -0
- /package/src/{training → experimental/training}/workload-packs/distill-translategemma-medium.json +0 -0
- /package/src/{training → experimental/training}/workload-packs/distill-translategemma-tiny.json +0 -0
- /package/src/{training → experimental/training}/workload-packs/lora-toy-medium.json +0 -0
- /package/src/{training → experimental/training}/workload-packs/lora-toy-tiny.json +0 -0
- /package/src/{training → experimental/training}/workload-packs/registry.json +0 -0
- /package/src/{training → experimental/training}/workload-packs/ul-training-medium.json +0 -0
- /package/src/{training → experimental/training}/workload-packs/ul-training-tiny.json +0 -0
- /package/src/{training → experimental/training}/workloads.d.ts +0 -0
|
@@ -0,0 +1,383 @@
|
|
|
1
|
+
|
|
2
|
+
import { getDevice } from '../../gpu/device.js';
|
|
3
|
+
import { runKVQuantize, recordKVQuantize } from '../../gpu/kernel-selector.js';
|
|
4
|
+
|
|
5
|
+
// =============================================================================
|
|
6
|
+
// QuantizedKVCache — Contiguous quantized KV cache for full-attention models
|
|
7
|
+
//
|
|
8
|
+
// All KV entries are quantized (no hot/cold split). For models like Qwen 3.5
|
|
9
|
+
// and LFM that force contiguous layout due to full global attention.
|
|
10
|
+
// =============================================================================
|
|
11
|
+
|
|
12
|
+
export class QuantizedKVCache {
|
|
13
|
+
|
|
14
|
+
constructor(config) {
|
|
15
|
+
if (!config) {
|
|
16
|
+
throw new Error('QuantizedKVCache requires a config.');
|
|
17
|
+
}
|
|
18
|
+
if (!config.quantMode) {
|
|
19
|
+
throw new Error('QuantizedKVCache requires a quantMode.');
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
this.numLayers = config.numLayers;
|
|
23
|
+
this.numHeads = config.numHeads;
|
|
24
|
+
this.headDim = config.headDim;
|
|
25
|
+
this.maxSeqLen = config.maxSeqLen;
|
|
26
|
+
this.useGPU = config.useGPU;
|
|
27
|
+
this.layout = 'contiguous_quantized';
|
|
28
|
+
this.kvDtype = config.kvDtype ?? 'f16';
|
|
29
|
+
this.quantMode = config.quantMode;
|
|
30
|
+
this.bitWidth = config.bitWidth ?? 4;
|
|
31
|
+
this.prodMode = config.prodMode === true;
|
|
32
|
+
this.currentSeqLen = 0;
|
|
33
|
+
this.totalTokensSeen = 0;
|
|
34
|
+
|
|
35
|
+
if (this.kvDtype !== 'f16') {
|
|
36
|
+
throw new Error('QuantizedKVCache requires f16 KV input.');
|
|
37
|
+
}
|
|
38
|
+
if (this.quantMode === 'turboquant_outlier') {
|
|
39
|
+
throw new Error(
|
|
40
|
+
'QuantizedKVCache quantMode="turboquant_outlier" is not supported yet. ' +
|
|
41
|
+
'TurboQuant outlier high-precision buffers and decode kernels are not wired end to end.'
|
|
42
|
+
);
|
|
43
|
+
}
|
|
44
|
+
if (!this.useGPU) {
|
|
45
|
+
throw new Error('QuantizedKVCache requires GPU.');
|
|
46
|
+
}
|
|
47
|
+
if (this.headDim > 256) {
|
|
48
|
+
throw new Error('QuantizedKVCache requires headDim <= 256.');
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
// Packing parameters
|
|
52
|
+
this.packFactor = Math.floor(32 / this.bitWidth);
|
|
53
|
+
this.packedStride = Math.ceil(this.headDim / this.packFactor);
|
|
54
|
+
|
|
55
|
+
// Prod-mode packing (b-1 bits for MSE, 1-bit for residual)
|
|
56
|
+
if (this.prodMode) {
|
|
57
|
+
this.mseBitWidth = this.bitWidth - 1;
|
|
58
|
+
this.msePackFactor = Math.floor(32 / this.mseBitWidth);
|
|
59
|
+
this.msePackedStride = Math.ceil(this.headDim / this.msePackFactor);
|
|
60
|
+
this.residualPackedStride = Math.ceil(this.headDim / 32);
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
// Shared buffers (rotation matrix, codebook, QJL matrix)
|
|
64
|
+
this.rotationMatrixBuffer = null;
|
|
65
|
+
this.codebookCentroidsBuffer = null;
|
|
66
|
+
this.codebookBoundariesBuffer = null;
|
|
67
|
+
this.qjlMatrixBuffer = null;
|
|
68
|
+
this.releaseSharedBuffers = null;
|
|
69
|
+
|
|
70
|
+
// Per-layer quantized storage
|
|
71
|
+
this.layers = this._createLayers();
|
|
72
|
+
this.memoryUsage = this._computeMemoryUsage();
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
_createLayers() {
|
|
76
|
+
const device = getDevice();
|
|
77
|
+
if (!device) {
|
|
78
|
+
throw new Error('GPU device not initialized.');
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
const layers = new Array(this.numLayers);
|
|
82
|
+
for (let l = 0; l < this.numLayers; l++) {
|
|
83
|
+
layers[l] = this._createLayerBuffers(device, l);
|
|
84
|
+
}
|
|
85
|
+
return layers;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
_createLayerBuffers(device, layerIdx) {
|
|
89
|
+
const layer = { seqLen: 0 };
|
|
90
|
+
|
|
91
|
+
if (this.prodMode) {
|
|
92
|
+
// MSE stage buffers
|
|
93
|
+
const msePacked = this.maxSeqLen * this.numHeads * this.msePackedStride * 4;
|
|
94
|
+
layer.keysPackedMSE = device.createBuffer({
|
|
95
|
+
label: `qkv_cache_keys_mse_L${layerIdx}`,
|
|
96
|
+
size: msePacked,
|
|
97
|
+
usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
|
|
98
|
+
});
|
|
99
|
+
layer.valuesPackedMSE = device.createBuffer({
|
|
100
|
+
label: `qkv_cache_values_mse_L${layerIdx}`,
|
|
101
|
+
size: msePacked,
|
|
102
|
+
usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
|
|
103
|
+
});
|
|
104
|
+
|
|
105
|
+
// Residual buffers (1-bit packed)
|
|
106
|
+
const resPacked = this.maxSeqLen * this.numHeads * this.residualPackedStride * 4;
|
|
107
|
+
layer.residualK = device.createBuffer({
|
|
108
|
+
label: `qkv_cache_res_k_L${layerIdx}`,
|
|
109
|
+
size: resPacked,
|
|
110
|
+
usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
|
|
111
|
+
});
|
|
112
|
+
layer.residualV = device.createBuffer({
|
|
113
|
+
label: `qkv_cache_res_v_L${layerIdx}`,
|
|
114
|
+
size: resPacked,
|
|
115
|
+
usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
|
|
116
|
+
});
|
|
117
|
+
|
|
118
|
+
// Residual norms
|
|
119
|
+
const normBytes = this.maxSeqLen * this.numHeads * 2;
|
|
120
|
+
layer.residualNormsK = device.createBuffer({
|
|
121
|
+
label: `qkv_cache_rnorm_k_L${layerIdx}`,
|
|
122
|
+
size: normBytes,
|
|
123
|
+
usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
|
|
124
|
+
});
|
|
125
|
+
layer.residualNormsV = device.createBuffer({
|
|
126
|
+
label: `qkv_cache_rnorm_v_L${layerIdx}`,
|
|
127
|
+
size: normBytes,
|
|
128
|
+
usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
|
|
129
|
+
});
|
|
130
|
+
} else {
|
|
131
|
+
// MSE-only buffers
|
|
132
|
+
const packedBytes = this.maxSeqLen * this.numHeads * this.packedStride * 4;
|
|
133
|
+
layer.keysPacked = device.createBuffer({
|
|
134
|
+
label: `qkv_cache_keys_packed_L${layerIdx}`,
|
|
135
|
+
size: packedBytes,
|
|
136
|
+
usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
|
|
137
|
+
});
|
|
138
|
+
layer.valuesPacked = device.createBuffer({
|
|
139
|
+
label: `qkv_cache_values_packed_L${layerIdx}`,
|
|
140
|
+
size: packedBytes,
|
|
141
|
+
usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
|
|
142
|
+
});
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
// Scales (shared between MSE-only and prod)
|
|
146
|
+
const scalesBytes = this.maxSeqLen * this.numHeads * 2;
|
|
147
|
+
layer.scalesK = device.createBuffer({
|
|
148
|
+
label: `qkv_cache_scales_k_L${layerIdx}`,
|
|
149
|
+
size: scalesBytes,
|
|
150
|
+
usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
|
|
151
|
+
});
|
|
152
|
+
layer.scalesV = device.createBuffer({
|
|
153
|
+
label: `qkv_cache_scales_v_L${layerIdx}`,
|
|
154
|
+
size: scalesBytes,
|
|
155
|
+
usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC,
|
|
156
|
+
});
|
|
157
|
+
|
|
158
|
+
return layer;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
_computeMemoryUsage() {
|
|
162
|
+
let bytesPerToken;
|
|
163
|
+
if (this.prodMode) {
|
|
164
|
+
const mseBytes = this.numHeads * this.msePackedStride * 4 * 2; // K + V
|
|
165
|
+
const resBytes = this.numHeads * this.residualPackedStride * 4 * 2;
|
|
166
|
+
const normBytes = this.numHeads * 2 * 4; // scales + residual norms, K + V
|
|
167
|
+
bytesPerToken = mseBytes + resBytes + normBytes;
|
|
168
|
+
} else {
|
|
169
|
+
const packedBytes = this.numHeads * this.packedStride * 4 * 2;
|
|
170
|
+
const scaleBytes = this.numHeads * 2 * 2;
|
|
171
|
+
bytesPerToken = packedBytes + scaleBytes;
|
|
172
|
+
}
|
|
173
|
+
return this.numLayers * this.maxSeqLen * bytesPerToken;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
/**
|
|
177
|
+
* Set shared TurboQuant buffers (rotation matrix, codebook, QJL).
|
|
178
|
+
* Must be called before first updateFromGPU.
|
|
179
|
+
*/
|
|
180
|
+
setSharedBuffers(buffers) {
|
|
181
|
+
this.rotationMatrixBuffer = buffers.rotationMatrixBuffer;
|
|
182
|
+
this.codebookCentroidsBuffer = buffers.codebookCentroidsBuffer;
|
|
183
|
+
this.codebookBoundariesBuffer = buffers.codebookBoundariesBuffer;
|
|
184
|
+
this.releaseSharedBuffers = typeof buffers.release === 'function' ? buffers.release : null;
|
|
185
|
+
if (this.prodMode) {
|
|
186
|
+
this.qjlMatrixBuffer = buffers.qjlMatrixBuffer;
|
|
187
|
+
}
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
async updateFromGPU(layerIdx, keysBuffer, valuesBuffer, startPos, numTokens) {
|
|
191
|
+
if (!Number.isInteger(startPos) || startPos < 0) {
|
|
192
|
+
throw new Error('QuantizedKVCache updateFromGPU requires non-negative startPos.');
|
|
193
|
+
}
|
|
194
|
+
if (!Number.isInteger(numTokens) || numTokens <= 0) {
|
|
195
|
+
return;
|
|
196
|
+
}
|
|
197
|
+
if (startPos + numTokens > this.maxSeqLen) {
|
|
198
|
+
throw new Error(`Cache overflow: ${startPos + numTokens} > ${this.maxSeqLen}`);
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
const layer = this.layers[layerIdx];
|
|
202
|
+
const quantOpts = this._buildQuantizeOptions(layer, startPos, numTokens);
|
|
203
|
+
|
|
204
|
+
await runKVQuantize(
|
|
205
|
+
keysBuffer, valuesBuffer,
|
|
206
|
+
quantOpts.outputKeysBuffer, quantOpts.outputValuesBuffer,
|
|
207
|
+
layer.scalesK, layer.scalesV,
|
|
208
|
+
quantOpts.options
|
|
209
|
+
);
|
|
210
|
+
|
|
211
|
+
layer.seqLen = Math.max(layer.seqLen, startPos + numTokens);
|
|
212
|
+
this.currentSeqLen = Math.max(this.currentSeqLen, startPos + numTokens);
|
|
213
|
+
this.totalTokensSeen = Math.max(this.totalTokensSeen, startPos + numTokens);
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
async recordUpdateFromGPU(recorder, layerIdx, keysBuffer, valuesBuffer, startPos, numTokens) {
|
|
217
|
+
if (!Number.isInteger(startPos) || startPos < 0) {
|
|
218
|
+
throw new Error('QuantizedKVCache recordUpdateFromGPU requires non-negative startPos.');
|
|
219
|
+
}
|
|
220
|
+
if (!Number.isInteger(numTokens) || numTokens <= 0) {
|
|
221
|
+
return;
|
|
222
|
+
}
|
|
223
|
+
if (startPos + numTokens > this.maxSeqLen) {
|
|
224
|
+
throw new Error(`Cache overflow: ${startPos + numTokens} > ${this.maxSeqLen}`);
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
const layer = this.layers[layerIdx];
|
|
228
|
+
const quantOpts = this._buildQuantizeOptions(layer, startPos, numTokens);
|
|
229
|
+
|
|
230
|
+
await recordKVQuantize(
|
|
231
|
+
recorder,
|
|
232
|
+
keysBuffer, valuesBuffer,
|
|
233
|
+
quantOpts.outputKeysBuffer, quantOpts.outputValuesBuffer,
|
|
234
|
+
layer.scalesK, layer.scalesV,
|
|
235
|
+
quantOpts.options
|
|
236
|
+
);
|
|
237
|
+
|
|
238
|
+
layer.seqLen = Math.max(layer.seqLen, startPos + numTokens);
|
|
239
|
+
this.currentSeqLen = Math.max(this.currentSeqLen, startPos + numTokens);
|
|
240
|
+
this.totalTokensSeen = Math.max(this.totalTokensSeen, startPos + numTokens);
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
_buildQuantizeOptions(layer, startPos, numTokens) {
|
|
244
|
+
if (this.prodMode) {
|
|
245
|
+
return {
|
|
246
|
+
outputKeysBuffer: layer.keysPackedMSE,
|
|
247
|
+
outputValuesBuffer: layer.valuesPackedMSE,
|
|
248
|
+
options: {
|
|
249
|
+
numKVHeads: this.numHeads,
|
|
250
|
+
headDim: this.headDim,
|
|
251
|
+
startPos,
|
|
252
|
+
numTokens,
|
|
253
|
+
packedStride: this.msePackedStride,
|
|
254
|
+
mode: 'turboquant_prod',
|
|
255
|
+
rotationMatrixBuffer: this.rotationMatrixBuffer,
|
|
256
|
+
codebookCentroidsBuffer: this.codebookCentroidsBuffer,
|
|
257
|
+
codebookBoundariesBuffer: this.codebookBoundariesBuffer,
|
|
258
|
+
qjlMatrixBuffer: this.qjlMatrixBuffer,
|
|
259
|
+
residualKBuffer: layer.residualK,
|
|
260
|
+
residualVBuffer: layer.residualV,
|
|
261
|
+
residualNormsKBuffer: layer.residualNormsK,
|
|
262
|
+
residualNormsVBuffer: layer.residualNormsV,
|
|
263
|
+
residualPackedStride: this.residualPackedStride,
|
|
264
|
+
bitWidth: this.mseBitWidth,
|
|
265
|
+
},
|
|
266
|
+
};
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
return {
|
|
270
|
+
outputKeysBuffer: layer.keysPacked,
|
|
271
|
+
outputValuesBuffer: layer.valuesPacked,
|
|
272
|
+
options: {
|
|
273
|
+
numKVHeads: this.numHeads,
|
|
274
|
+
headDim: this.headDim,
|
|
275
|
+
startPos,
|
|
276
|
+
numTokens,
|
|
277
|
+
packedStride: this.packedStride,
|
|
278
|
+
mode: this.quantMode,
|
|
279
|
+
rotationMatrixBuffer: this.rotationMatrixBuffer,
|
|
280
|
+
codebookCentroidsBuffer: this.codebookCentroidsBuffer,
|
|
281
|
+
codebookBoundariesBuffer: this.codebookBoundariesBuffer,
|
|
282
|
+
bitWidth: this.bitWidth,
|
|
283
|
+
},
|
|
284
|
+
};
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
getGPUBuffers(layerIdx) {
|
|
288
|
+
const layer = this.layers[layerIdx];
|
|
289
|
+
if (!layer) return null;
|
|
290
|
+
|
|
291
|
+
const base = {
|
|
292
|
+
layout: 'contiguous_quantized',
|
|
293
|
+
seqLen: this.currentSeqLen,
|
|
294
|
+
quantMode: this.quantMode,
|
|
295
|
+
prodMode: this.prodMode,
|
|
296
|
+
packedStride: this.prodMode ? this.msePackedStride : this.packedStride,
|
|
297
|
+
scalesKGPU: layer.scalesK,
|
|
298
|
+
scalesVGPU: layer.scalesV,
|
|
299
|
+
rotationMatrixBuffer: this.rotationMatrixBuffer,
|
|
300
|
+
codebookCentroidsBuffer: this.codebookCentroidsBuffer,
|
|
301
|
+
};
|
|
302
|
+
|
|
303
|
+
if (this.prodMode) {
|
|
304
|
+
return {
|
|
305
|
+
...base,
|
|
306
|
+
keysPackedGPU: layer.keysPackedMSE,
|
|
307
|
+
valuesPackedGPU: layer.valuesPackedMSE,
|
|
308
|
+
residualKGPU: layer.residualK,
|
|
309
|
+
residualVGPU: layer.residualV,
|
|
310
|
+
residualNormsKGPU: layer.residualNormsK,
|
|
311
|
+
residualNormsVGPU: layer.residualNormsV,
|
|
312
|
+
residualPackedStride: this.residualPackedStride,
|
|
313
|
+
qjlMatrixBuffer: this.qjlMatrixBuffer,
|
|
314
|
+
};
|
|
315
|
+
}
|
|
316
|
+
|
|
317
|
+
return {
|
|
318
|
+
...base,
|
|
319
|
+
keysPackedGPU: layer.keysPacked,
|
|
320
|
+
valuesPackedGPU: layer.valuesPacked,
|
|
321
|
+
};
|
|
322
|
+
}
|
|
323
|
+
|
|
324
|
+
hasGPUCache() {
|
|
325
|
+
return Array.isArray(this.layers);
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
clear() {
|
|
329
|
+
for (const layer of this.layers) {
|
|
330
|
+
layer.seqLen = 0;
|
|
331
|
+
}
|
|
332
|
+
this.currentSeqLen = 0;
|
|
333
|
+
this.totalTokensSeen = 0;
|
|
334
|
+
}
|
|
335
|
+
|
|
336
|
+
truncate(length) {
|
|
337
|
+
this.currentSeqLen = Math.min(this.currentSeqLen, length);
|
|
338
|
+
for (const layer of this.layers) {
|
|
339
|
+
layer.seqLen = Math.min(layer.seqLen, length);
|
|
340
|
+
}
|
|
341
|
+
this.totalTokensSeen = Math.min(this.totalTokensSeen, this.currentSeqLen);
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
getMemoryStats() {
|
|
345
|
+
return {
|
|
346
|
+
theoretical: this.memoryUsage,
|
|
347
|
+
allocated: this.memoryUsage,
|
|
348
|
+
used: this.memoryUsage,
|
|
349
|
+
efficiency: 1.0,
|
|
350
|
+
seqLen: this.currentSeqLen,
|
|
351
|
+
maxSeqLen: this.maxSeqLen,
|
|
352
|
+
layout: this.layout,
|
|
353
|
+
};
|
|
354
|
+
}
|
|
355
|
+
|
|
356
|
+
setGPUContext() { /* no-op for quantized cache */ }
|
|
357
|
+
|
|
358
|
+
destroy() {
|
|
359
|
+
for (const layer of this.layers) {
|
|
360
|
+
if (this.prodMode) {
|
|
361
|
+
layer.keysPackedMSE?.destroy();
|
|
362
|
+
layer.valuesPackedMSE?.destroy();
|
|
363
|
+
layer.residualK?.destroy();
|
|
364
|
+
layer.residualV?.destroy();
|
|
365
|
+
layer.residualNormsK?.destroy();
|
|
366
|
+
layer.residualNormsV?.destroy();
|
|
367
|
+
} else {
|
|
368
|
+
layer.keysPacked?.destroy();
|
|
369
|
+
layer.valuesPacked?.destroy();
|
|
370
|
+
}
|
|
371
|
+
layer.scalesK?.destroy();
|
|
372
|
+
layer.scalesV?.destroy();
|
|
373
|
+
}
|
|
374
|
+
if (this.releaseSharedBuffers) {
|
|
375
|
+
this.releaseSharedBuffers();
|
|
376
|
+
} else {
|
|
377
|
+
this.rotationMatrixBuffer?.destroy();
|
|
378
|
+
this.codebookCentroidsBuffer?.destroy();
|
|
379
|
+
this.codebookBoundariesBuffer?.destroy();
|
|
380
|
+
this.qjlMatrixBuffer?.destroy();
|
|
381
|
+
}
|
|
382
|
+
}
|
|
383
|
+
}
|
|
@@ -27,10 +27,15 @@ export class TieredKVCache {
|
|
|
27
27
|
hotWindow: number;
|
|
28
28
|
coldPageSize: number;
|
|
29
29
|
coldDtype: 'f16' | 'f32';
|
|
30
|
-
tieringMode: 'off' | 'fp16' | 'int8' | 'int4';
|
|
31
|
-
coldQuantMode: 'none' | 'int8' | 'int4';
|
|
30
|
+
tieringMode: 'off' | 'fp16' | 'int8' | 'int4' | 'turboquant' | 'turboquant_prod';
|
|
31
|
+
coldQuantMode: 'none' | 'int8' | 'int4' | 'turboquant' | 'turboquant_prod';
|
|
32
32
|
coldPackedStride: number;
|
|
33
|
-
compression: {
|
|
33
|
+
compression: {
|
|
34
|
+
mode: 'none' | 'int8' | 'int4' | 'turboquant' | 'turboquant_prod';
|
|
35
|
+
blockSize: number;
|
|
36
|
+
bitWidth?: number;
|
|
37
|
+
prodMode?: boolean;
|
|
38
|
+
};
|
|
34
39
|
gating: { mode: 'auto' | 'force_on' | 'force_off'; minAluBwRatio: number };
|
|
35
40
|
currentSeqLen: number;
|
|
36
41
|
totalTokensSeen: number;
|
|
@@ -42,11 +47,19 @@ export class TieredKVCache {
|
|
|
42
47
|
coldStoreChunks: string[];
|
|
43
48
|
hotCache: SlidingWindowKVCache;
|
|
44
49
|
coldCache: KVCache | null;
|
|
50
|
+
rotationMatrixBuffer: GPUBuffer | null;
|
|
51
|
+
codebookCentroidsBuffer: GPUBuffer | null;
|
|
52
|
+
codebookBoundariesBuffer: GPUBuffer | null;
|
|
53
|
+
qjlMatrixBuffer: GPUBuffer | null;
|
|
45
54
|
coldLayers: Array<{
|
|
46
55
|
keysPackedGPU: GPUBuffer;
|
|
47
56
|
valuesPackedGPU: GPUBuffer;
|
|
48
57
|
scalesKGPU: GPUBuffer;
|
|
49
58
|
scalesVGPU: GPUBuffer;
|
|
59
|
+
residualKGPU?: GPUBuffer;
|
|
60
|
+
residualVGPU?: GPUBuffer;
|
|
61
|
+
residualNormsKGPU?: GPUBuffer;
|
|
62
|
+
residualNormsVGPU?: GPUBuffer;
|
|
50
63
|
seqLen: number;
|
|
51
64
|
}> | null;
|
|
52
65
|
|
|
@@ -60,6 +73,10 @@ export class TieredKVCache {
|
|
|
60
73
|
valuesPackedGPU: GPUBuffer;
|
|
61
74
|
scalesKGPU: GPUBuffer;
|
|
62
75
|
scalesVGPU: GPUBuffer;
|
|
76
|
+
residualKGPU?: GPUBuffer;
|
|
77
|
+
residualVGPU?: GPUBuffer;
|
|
78
|
+
residualNormsKGPU?: GPUBuffer;
|
|
79
|
+
residualNormsVGPU?: GPUBuffer;
|
|
63
80
|
seqLen: number;
|
|
64
81
|
}> | null;
|
|
65
82
|
coldStore?: EmulatedVramStore | null;
|