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,422 @@
|
|
|
1
|
+
import { getDevice } from '../../gpu/device.js';
|
|
2
|
+
|
|
3
|
+
function normalizeLayerType(layerType) {
|
|
4
|
+
return typeof layerType === 'string' ? layerType.trim().toLowerCase() : '';
|
|
5
|
+
}
|
|
6
|
+
|
|
7
|
+
function isSlidingLayerType(layerType) {
|
|
8
|
+
const normalized = normalizeLayerType(layerType);
|
|
9
|
+
return normalized === 'sliding_attention'
|
|
10
|
+
|| normalized === 'local_attention'
|
|
11
|
+
|| normalized === 'local'
|
|
12
|
+
|| normalized === 'sliding';
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
function buildLayerSpecs(config, bytesPerElem) {
|
|
16
|
+
const layerTypes = Array.isArray(config.layerTypes) ? config.layerTypes : null;
|
|
17
|
+
if (!layerTypes || layerTypes.length !== config.numLayers) {
|
|
18
|
+
throw new Error(
|
|
19
|
+
'MixedGeometryKVCache requires explicit layerTypes for every layer so per-layer KV geometry stays manifest-owned.'
|
|
20
|
+
);
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
const baseHeadDim = Number(config.headDim);
|
|
24
|
+
const globalHeadDim = Number.isFinite(config.globalHeadDim) && config.globalHeadDim > 0
|
|
25
|
+
? Math.trunc(config.globalHeadDim)
|
|
26
|
+
: baseHeadDim;
|
|
27
|
+
const numHeads = Number(config.numHeads);
|
|
28
|
+
const maxSeqLen = Number(config.maxSeqLen);
|
|
29
|
+
const slidingWindow = Number.isFinite(config.slidingWindow) && config.slidingWindow > 0
|
|
30
|
+
? Math.min(Math.trunc(config.slidingWindow), maxSeqLen)
|
|
31
|
+
: null;
|
|
32
|
+
|
|
33
|
+
if (!Number.isFinite(baseHeadDim) || baseHeadDim <= 0) {
|
|
34
|
+
throw new Error('MixedGeometryKVCache requires a positive headDim.');
|
|
35
|
+
}
|
|
36
|
+
if (!Number.isFinite(numHeads) || numHeads <= 0) {
|
|
37
|
+
throw new Error('MixedGeometryKVCache requires a positive numHeads.');
|
|
38
|
+
}
|
|
39
|
+
if (!Number.isFinite(maxSeqLen) || maxSeqLen <= 0) {
|
|
40
|
+
throw new Error('MixedGeometryKVCache requires a positive maxSeqLen.');
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
return layerTypes.map((layerType, layerIdx) => {
|
|
44
|
+
const isSliding = isSlidingLayerType(layerType);
|
|
45
|
+
const headDim = isSliding ? baseHeadDim : globalHeadDim;
|
|
46
|
+
const capacityTokens = isSliding && slidingWindow != null
|
|
47
|
+
? slidingWindow
|
|
48
|
+
: maxSeqLen;
|
|
49
|
+
const kvSize = numHeads * headDim;
|
|
50
|
+
const bytesPerToken = kvSize * bytesPerElem;
|
|
51
|
+
return {
|
|
52
|
+
layerIdx,
|
|
53
|
+
layerType,
|
|
54
|
+
layout: isSliding && slidingWindow != null ? 'ring' : 'contiguous',
|
|
55
|
+
headDim,
|
|
56
|
+
numHeads,
|
|
57
|
+
kvSize,
|
|
58
|
+
capacityTokens,
|
|
59
|
+
bytesPerToken,
|
|
60
|
+
capacityBytes: capacityTokens * bytesPerToken,
|
|
61
|
+
};
|
|
62
|
+
});
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
function createLayerBuffers(device, spec, kvDtype) {
|
|
66
|
+
const usage = GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC;
|
|
67
|
+
const keysGPU = device.createBuffer({
|
|
68
|
+
label: `mixed_kv_keys_layer_${spec.layerIdx}`,
|
|
69
|
+
size: spec.capacityBytes,
|
|
70
|
+
usage,
|
|
71
|
+
});
|
|
72
|
+
const valuesGPU = device.createBuffer({
|
|
73
|
+
label: `mixed_kv_values_layer_${spec.layerIdx}`,
|
|
74
|
+
size: spec.capacityBytes,
|
|
75
|
+
usage,
|
|
76
|
+
});
|
|
77
|
+
return {
|
|
78
|
+
keysGPU,
|
|
79
|
+
valuesGPU,
|
|
80
|
+
seqLen: 0,
|
|
81
|
+
kvDtype,
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
function destroyLayerBuffers(layer) {
|
|
86
|
+
try {
|
|
87
|
+
layer?.keysGPU?.destroy?.();
|
|
88
|
+
} catch {
|
|
89
|
+
// Ignore already-destroyed buffers during rollback.
|
|
90
|
+
}
|
|
91
|
+
try {
|
|
92
|
+
layer?.valuesGPU?.destroy?.();
|
|
93
|
+
} catch {
|
|
94
|
+
// Ignore already-destroyed buffers during rollback.
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
export class MixedGeometryKVCache {
|
|
99
|
+
constructor(config) {
|
|
100
|
+
if (!config || typeof config !== 'object') {
|
|
101
|
+
throw new Error('MixedGeometryKVCache requires a config object.');
|
|
102
|
+
}
|
|
103
|
+
if (config.useGPU !== true) {
|
|
104
|
+
throw new Error(
|
|
105
|
+
'MixedGeometryKVCache requires GPU execution. ' +
|
|
106
|
+
'Mixed-head-dim incremental decode is not supported on CPU.'
|
|
107
|
+
);
|
|
108
|
+
}
|
|
109
|
+
if (!Number.isFinite(config.pageSize) || config.pageSize <= 0) {
|
|
110
|
+
throw new Error('MixedGeometryKVCache requires a positive pageSize.');
|
|
111
|
+
}
|
|
112
|
+
if (config.kvDtype !== 'f16' && config.kvDtype !== 'f32') {
|
|
113
|
+
throw new Error('MixedGeometryKVCache requires kvDtype to be "f16" or "f32".');
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
const device = getDevice();
|
|
117
|
+
if (!device) {
|
|
118
|
+
throw new Error('MixedGeometryKVCache requires an initialized GPU device.');
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
this.numLayers = Math.trunc(config.numLayers);
|
|
122
|
+
this.numHeads = Math.trunc(config.numHeads);
|
|
123
|
+
this.headDim = Math.max(
|
|
124
|
+
Math.trunc(config.headDim),
|
|
125
|
+
Number.isFinite(config.globalHeadDim) ? Math.trunc(config.globalHeadDim) : Math.trunc(config.headDim)
|
|
126
|
+
);
|
|
127
|
+
this.maxSeqLen = Math.trunc(config.maxSeqLen);
|
|
128
|
+
this.useGPU = true;
|
|
129
|
+
this.layout = 'contiguous';
|
|
130
|
+
this.pageSize = Math.trunc(config.pageSize);
|
|
131
|
+
this.kvDtype = config.kvDtype;
|
|
132
|
+
this.bytesPerElem = this.kvDtype === 'f16' ? 2 : 4;
|
|
133
|
+
this.kvSize = this.numHeads * this.headDim;
|
|
134
|
+
this.windowSize = Number.isFinite(config.slidingWindow) && config.slidingWindow > 0
|
|
135
|
+
? Math.min(Math.trunc(config.slidingWindow), this.maxSeqLen)
|
|
136
|
+
: undefined;
|
|
137
|
+
this.currentSeqLen = 0;
|
|
138
|
+
this.totalTokensSeen = 0;
|
|
139
|
+
this.memoryUsage = 0;
|
|
140
|
+
this.gpuContext = { device };
|
|
141
|
+
this._config = {
|
|
142
|
+
...config,
|
|
143
|
+
numLayers: this.numLayers,
|
|
144
|
+
numHeads: this.numHeads,
|
|
145
|
+
headDim: Math.trunc(config.headDim),
|
|
146
|
+
globalHeadDim: Number.isFinite(config.globalHeadDim) ? Math.trunc(config.globalHeadDim) : null,
|
|
147
|
+
maxSeqLen: this.maxSeqLen,
|
|
148
|
+
pageSize: this.pageSize,
|
|
149
|
+
};
|
|
150
|
+
this.layerSpecs = buildLayerSpecs(this._config, this.bytesPerElem);
|
|
151
|
+
this.layers = new Array(this.numLayers);
|
|
152
|
+
|
|
153
|
+
try {
|
|
154
|
+
for (let layerIdx = 0; layerIdx < this.numLayers; layerIdx++) {
|
|
155
|
+
const spec = this.layerSpecs[layerIdx];
|
|
156
|
+
this.layers[layerIdx] = createLayerBuffers(device, spec, this.kvDtype);
|
|
157
|
+
this.memoryUsage += spec.capacityBytes * 2;
|
|
158
|
+
}
|
|
159
|
+
} catch (error) {
|
|
160
|
+
for (const layer of this.layers) {
|
|
161
|
+
destroyLayerBuffers(layer);
|
|
162
|
+
}
|
|
163
|
+
throw error;
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
_assertLayerIndex(layerIdx) {
|
|
168
|
+
if (!Number.isInteger(layerIdx) || layerIdx < 0 || layerIdx >= this.numLayers) {
|
|
169
|
+
throw new Error(`MixedGeometryKVCache layer index out of range: ${layerIdx}`);
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
_assertStartPos(startPos) {
|
|
174
|
+
if (!Number.isInteger(startPos) || startPos < 0) {
|
|
175
|
+
throw new Error('MixedGeometryKVCache startPos must be a non-negative integer.');
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
_assertTokenCount(numTokens, label) {
|
|
180
|
+
if (!Number.isInteger(numTokens) || numTokens < 0) {
|
|
181
|
+
throw new Error(`${label} requires a non-negative integer token count.`);
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
_recordContiguousCopy(encoder, layer, spec, keysBuffer, valuesBuffer, startPos, numTokens) {
|
|
186
|
+
const endPos = startPos + numTokens;
|
|
187
|
+
if (endPos > spec.capacityTokens) {
|
|
188
|
+
throw new Error(
|
|
189
|
+
`MixedGeometryKVCache overflow at layer ${spec.layerIdx}: ${endPos} > ${spec.capacityTokens}.`
|
|
190
|
+
);
|
|
191
|
+
}
|
|
192
|
+
const byteOffset = startPos * spec.bytesPerToken;
|
|
193
|
+
const byteSize = numTokens * spec.bytesPerToken;
|
|
194
|
+
if (byteSize > keysBuffer.size || byteSize > valuesBuffer.size) {
|
|
195
|
+
throw new Error('MixedGeometryKVCache contiguous copy buffer is smaller than the requested write.');
|
|
196
|
+
}
|
|
197
|
+
encoder.copyBufferToBuffer(keysBuffer, 0, layer.keysGPU, byteOffset, byteSize);
|
|
198
|
+
encoder.copyBufferToBuffer(valuesBuffer, 0, layer.valuesGPU, byteOffset, byteSize);
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
_recordRingCopy(encoder, layer, spec, keysBuffer, valuesBuffer, startPos, numTokens) {
|
|
202
|
+
const windowSize = spec.capacityTokens;
|
|
203
|
+
const bytesPerToken = spec.bytesPerToken;
|
|
204
|
+
const fullStart = startPos;
|
|
205
|
+
const fullTokens = numTokens;
|
|
206
|
+
let srcByteOffset = 0;
|
|
207
|
+
|
|
208
|
+
if (numTokens > windowSize) {
|
|
209
|
+
const dropTokens = numTokens - windowSize;
|
|
210
|
+
startPos += dropTokens;
|
|
211
|
+
numTokens = windowSize;
|
|
212
|
+
srcByteOffset = dropTokens * bytesPerToken;
|
|
213
|
+
}
|
|
214
|
+
|
|
215
|
+
const bytesNeeded = srcByteOffset + (numTokens * bytesPerToken);
|
|
216
|
+
if (bytesNeeded > keysBuffer.size || bytesNeeded > valuesBuffer.size) {
|
|
217
|
+
throw new Error('MixedGeometryKVCache ring copy buffer is smaller than the requested write.');
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
const writePos = startPos % windowSize;
|
|
221
|
+
const firstChunkTokens = Math.min(numTokens, windowSize - writePos);
|
|
222
|
+
const firstChunkBytes = firstChunkTokens * bytesPerToken;
|
|
223
|
+
const secondChunkTokens = numTokens - firstChunkTokens;
|
|
224
|
+
const secondChunkBytes = secondChunkTokens * bytesPerToken;
|
|
225
|
+
const destByteOffset1 = writePos * bytesPerToken;
|
|
226
|
+
|
|
227
|
+
encoder.copyBufferToBuffer(keysBuffer, srcByteOffset, layer.keysGPU, destByteOffset1, firstChunkBytes);
|
|
228
|
+
encoder.copyBufferToBuffer(valuesBuffer, srcByteOffset, layer.valuesGPU, destByteOffset1, firstChunkBytes);
|
|
229
|
+
|
|
230
|
+
if (secondChunkTokens > 0) {
|
|
231
|
+
const srcByteOffset2 = srcByteOffset + firstChunkBytes;
|
|
232
|
+
encoder.copyBufferToBuffer(keysBuffer, srcByteOffset2, layer.keysGPU, 0, secondChunkBytes);
|
|
233
|
+
encoder.copyBufferToBuffer(valuesBuffer, srcByteOffset2, layer.valuesGPU, 0, secondChunkBytes);
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
const seen = Math.max(this.totalTokensSeen, fullStart + fullTokens);
|
|
237
|
+
layer.seqLen = Math.min(windowSize, Math.max(layer.seqLen, seen));
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
_updateMetadata(layer, spec, startPos, numTokens) {
|
|
241
|
+
if (spec.layout !== 'ring') {
|
|
242
|
+
layer.seqLen = Math.max(layer.seqLen, Math.min(startPos + numTokens, spec.capacityTokens));
|
|
243
|
+
}
|
|
244
|
+
this.totalTokensSeen = Math.max(this.totalTokensSeen, startPos + numTokens);
|
|
245
|
+
this.currentSeqLen = Math.max(this.currentSeqLen, startPos + numTokens);
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
update() {
|
|
249
|
+
throw new Error(
|
|
250
|
+
'MixedGeometryKVCache requires GPU-buffer updateFromGPU()/recordUpdateFromGPU() writes. ' +
|
|
251
|
+
'CPU shadow copies are intentionally unsupported.'
|
|
252
|
+
);
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
updateFromGPU(layerIdx, keysBuffer, valuesBuffer, startPos, numTokens) {
|
|
256
|
+
this._assertLayerIndex(layerIdx);
|
|
257
|
+
this._assertStartPos(startPos);
|
|
258
|
+
this._assertTokenCount(numTokens, 'MixedGeometryKVCache updateFromGPU');
|
|
259
|
+
if (numTokens === 0) {
|
|
260
|
+
return;
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
const device = getDevice();
|
|
264
|
+
if (!device) {
|
|
265
|
+
throw new Error('MixedGeometryKVCache updateFromGPU requires an initialized GPU device.');
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
const spec = this.layerSpecs[layerIdx];
|
|
269
|
+
const layer = this.layers[layerIdx];
|
|
270
|
+
const encoder = device.createCommandEncoder({ label: `mixed_kv_update_${layerIdx}` });
|
|
271
|
+
if (spec.layout === 'ring') {
|
|
272
|
+
this._recordRingCopy(encoder, layer, spec, keysBuffer, valuesBuffer, startPos, numTokens);
|
|
273
|
+
} else {
|
|
274
|
+
this._recordContiguousCopy(encoder, layer, spec, keysBuffer, valuesBuffer, startPos, numTokens);
|
|
275
|
+
}
|
|
276
|
+
device.queue.submit([encoder.finish()]);
|
|
277
|
+
this._updateMetadata(layer, spec, startPos, numTokens);
|
|
278
|
+
}
|
|
279
|
+
|
|
280
|
+
recordUpdateFromGPU(recorder, layerIdx, keysBuffer, valuesBuffer, startPos, numTokens) {
|
|
281
|
+
this._assertLayerIndex(layerIdx);
|
|
282
|
+
this._assertStartPos(startPos);
|
|
283
|
+
this._assertTokenCount(numTokens, 'MixedGeometryKVCache recordUpdateFromGPU');
|
|
284
|
+
if (numTokens === 0) {
|
|
285
|
+
return;
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
const spec = this.layerSpecs[layerIdx];
|
|
289
|
+
const layer = this.layers[layerIdx];
|
|
290
|
+
const encoder = recorder.getEncoder();
|
|
291
|
+
if (spec.layout === 'ring') {
|
|
292
|
+
this._recordRingCopy(encoder, layer, spec, keysBuffer, valuesBuffer, startPos, numTokens);
|
|
293
|
+
} else {
|
|
294
|
+
this._recordContiguousCopy(encoder, layer, spec, keysBuffer, valuesBuffer, startPos, numTokens);
|
|
295
|
+
}
|
|
296
|
+
this._updateMetadata(layer, spec, startPos, numTokens);
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
get() {
|
|
300
|
+
throw new Error('MixedGeometryKVCache CPU get() is not implemented.');
|
|
301
|
+
}
|
|
302
|
+
|
|
303
|
+
getKeyCache(layerIdx) {
|
|
304
|
+
this._assertLayerIndex(layerIdx);
|
|
305
|
+
return this.layers[layerIdx]?.keysGPU ?? null;
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
getValueCache(layerIdx) {
|
|
309
|
+
this._assertLayerIndex(layerIdx);
|
|
310
|
+
return this.layers[layerIdx]?.valuesGPU ?? null;
|
|
311
|
+
}
|
|
312
|
+
|
|
313
|
+
getGPUBuffers(layerIdx) {
|
|
314
|
+
this._assertLayerIndex(layerIdx);
|
|
315
|
+
const layer = this.layers[layerIdx];
|
|
316
|
+
if (!layer?.keysGPU || !layer?.valuesGPU) {
|
|
317
|
+
return null;
|
|
318
|
+
}
|
|
319
|
+
const spec = this.layerSpecs[layerIdx];
|
|
320
|
+
return {
|
|
321
|
+
layout: spec.layout,
|
|
322
|
+
keysGPU: layer.keysGPU,
|
|
323
|
+
valuesGPU: layer.valuesGPU,
|
|
324
|
+
seqLen: layer.seqLen,
|
|
325
|
+
};
|
|
326
|
+
}
|
|
327
|
+
|
|
328
|
+
hasGPUCache() {
|
|
329
|
+
return this.layers[0]?.keysGPU != null && this.layers[0]?.valuesGPU != null;
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
clear() {
|
|
333
|
+
this.currentSeqLen = 0;
|
|
334
|
+
this.totalTokensSeen = 0;
|
|
335
|
+
for (let layerIdx = 0; layerIdx < this.numLayers; layerIdx++) {
|
|
336
|
+
this.layers[layerIdx].seqLen = 0;
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
clone() {
|
|
341
|
+
const cloned = new MixedGeometryKVCache(this._config);
|
|
342
|
+
cloned.currentSeqLen = this.currentSeqLen;
|
|
343
|
+
cloned.totalTokensSeen = this.totalTokensSeen;
|
|
344
|
+
|
|
345
|
+
const device = getDevice();
|
|
346
|
+
if (!device) {
|
|
347
|
+
throw new Error('MixedGeometryKVCache clone requires an initialized GPU device.');
|
|
348
|
+
}
|
|
349
|
+
|
|
350
|
+
const encoder = device.createCommandEncoder({ label: 'mixed_kv_clone' });
|
|
351
|
+
let hasCopies = false;
|
|
352
|
+
for (let layerIdx = 0; layerIdx < this.numLayers; layerIdx++) {
|
|
353
|
+
const spec = this.layerSpecs[layerIdx];
|
|
354
|
+
const srcLayer = this.layers[layerIdx];
|
|
355
|
+
const dstLayer = cloned.layers[layerIdx];
|
|
356
|
+
dstLayer.seqLen = srcLayer.seqLen;
|
|
357
|
+
const copyBytes = spec.layout === 'ring'
|
|
358
|
+
? spec.capacityBytes
|
|
359
|
+
: srcLayer.seqLen * spec.bytesPerToken;
|
|
360
|
+
if (copyBytes <= 0) {
|
|
361
|
+
continue;
|
|
362
|
+
}
|
|
363
|
+
encoder.copyBufferToBuffer(srcLayer.keysGPU, 0, dstLayer.keysGPU, 0, copyBytes);
|
|
364
|
+
encoder.copyBufferToBuffer(srcLayer.valuesGPU, 0, dstLayer.valuesGPU, 0, copyBytes);
|
|
365
|
+
hasCopies = true;
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
if (hasCopies) {
|
|
369
|
+
device.queue.submit([encoder.finish()]);
|
|
370
|
+
}
|
|
371
|
+
|
|
372
|
+
return cloned;
|
|
373
|
+
}
|
|
374
|
+
|
|
375
|
+
truncate(length) {
|
|
376
|
+
if (!Number.isInteger(length) || length < 0) {
|
|
377
|
+
throw new Error('MixedGeometryKVCache truncate length must be a non-negative integer.');
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
this.currentSeqLen = Math.min(length, this.maxSeqLen);
|
|
381
|
+
this.totalTokensSeen = Math.min(this.totalTokensSeen, this.currentSeqLen);
|
|
382
|
+
for (let layerIdx = 0; layerIdx < this.numLayers; layerIdx++) {
|
|
383
|
+
const spec = this.layerSpecs[layerIdx];
|
|
384
|
+
this.layers[layerIdx].seqLen = Math.min(this.currentSeqLen, spec.capacityTokens);
|
|
385
|
+
}
|
|
386
|
+
}
|
|
387
|
+
|
|
388
|
+
getMemoryStats() {
|
|
389
|
+
let used = 0;
|
|
390
|
+
for (let layerIdx = 0; layerIdx < this.numLayers; layerIdx++) {
|
|
391
|
+
const spec = this.layerSpecs[layerIdx];
|
|
392
|
+
const layer = this.layers[layerIdx];
|
|
393
|
+
used += Math.min(layer.seqLen, spec.capacityTokens) * spec.bytesPerToken * 2;
|
|
394
|
+
}
|
|
395
|
+
return {
|
|
396
|
+
theoretical: this.memoryUsage,
|
|
397
|
+
allocated: this.memoryUsage,
|
|
398
|
+
used,
|
|
399
|
+
efficiency: this.memoryUsage > 0 ? used / this.memoryUsage : 1,
|
|
400
|
+
seqLen: this.currentSeqLen,
|
|
401
|
+
maxSeqLen: this.maxSeqLen,
|
|
402
|
+
layout: this.layout,
|
|
403
|
+
};
|
|
404
|
+
}
|
|
405
|
+
|
|
406
|
+
setGPUContext(gpuContext) {
|
|
407
|
+
this.gpuContext = gpuContext ?? null;
|
|
408
|
+
}
|
|
409
|
+
|
|
410
|
+
async syncToCPU() {
|
|
411
|
+
throw new Error(
|
|
412
|
+
'MixedGeometryKVCache does not support syncToCPU(). ' +
|
|
413
|
+
'Use layer readback helpers directly when debugging mixed-geometry KV state.'
|
|
414
|
+
);
|
|
415
|
+
}
|
|
416
|
+
|
|
417
|
+
destroy() {
|
|
418
|
+
for (const layer of this.layers) {
|
|
419
|
+
destroyLayerBuffers(layer);
|
|
420
|
+
}
|
|
421
|
+
}
|
|
422
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import type { KVCacheConfig, MemoryStats, QuantizedGPUBuffersResult } from './types.js';
|
|
2
|
+
|
|
3
|
+
export class QuantizedKVCache {
|
|
4
|
+
numLayers: number;
|
|
5
|
+
numHeads: number;
|
|
6
|
+
headDim: number;
|
|
7
|
+
maxSeqLen: number;
|
|
8
|
+
useGPU: boolean;
|
|
9
|
+
layout: 'contiguous_quantized';
|
|
10
|
+
kvDtype: 'f16' | 'f32';
|
|
11
|
+
quantMode: 'turboquant' | 'turboquant_prod';
|
|
12
|
+
bitWidth: number;
|
|
13
|
+
prodMode: boolean;
|
|
14
|
+
packFactor: number;
|
|
15
|
+
packedStride: number;
|
|
16
|
+
mseBitWidth?: number;
|
|
17
|
+
msePackFactor?: number;
|
|
18
|
+
msePackedStride?: number;
|
|
19
|
+
residualPackedStride?: number;
|
|
20
|
+
currentSeqLen: number;
|
|
21
|
+
totalTokensSeen: number;
|
|
22
|
+
memoryUsage: number;
|
|
23
|
+
rotationMatrixBuffer: GPUBuffer | null;
|
|
24
|
+
codebookCentroidsBuffer: GPUBuffer | null;
|
|
25
|
+
codebookBoundariesBuffer: GPUBuffer | null;
|
|
26
|
+
qjlMatrixBuffer: GPUBuffer | null;
|
|
27
|
+
|
|
28
|
+
constructor(config: KVCacheConfig & {
|
|
29
|
+
quantMode: 'turboquant' | 'turboquant_prod';
|
|
30
|
+
bitWidth?: number;
|
|
31
|
+
prodMode?: boolean;
|
|
32
|
+
});
|
|
33
|
+
setSharedBuffers(buffers: {
|
|
34
|
+
rotationMatrixBuffer: GPUBuffer;
|
|
35
|
+
codebookCentroidsBuffer: GPUBuffer;
|
|
36
|
+
codebookBoundariesBuffer: GPUBuffer;
|
|
37
|
+
qjlMatrixBuffer?: GPUBuffer | null;
|
|
38
|
+
release?: (() => void) | null;
|
|
39
|
+
}): void;
|
|
40
|
+
updateFromGPU(layerIdx: number, keysBuffer: GPUBuffer, valuesBuffer: GPUBuffer, startPos: number, numTokens: number): Promise<void>;
|
|
41
|
+
recordUpdateFromGPU(
|
|
42
|
+
recorder: import('../../gpu/kernel-selector.js').CommandRecorder,
|
|
43
|
+
layerIdx: number,
|
|
44
|
+
keysBuffer: GPUBuffer,
|
|
45
|
+
valuesBuffer: GPUBuffer,
|
|
46
|
+
startPos: number,
|
|
47
|
+
numTokens: number
|
|
48
|
+
): Promise<void>;
|
|
49
|
+
getGPUBuffers(layerIdx: number): QuantizedGPUBuffersResult | null;
|
|
50
|
+
hasGPUCache(): boolean;
|
|
51
|
+
clear(): void;
|
|
52
|
+
truncate(length: number): void;
|
|
53
|
+
getMemoryStats(): MemoryStats;
|
|
54
|
+
setGPUContext(): void;
|
|
55
|
+
destroy(): void;
|
|
56
|
+
}
|