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
|
@@ -3,6 +3,24 @@ import { getDevice } from '../../gpu/device.js';
|
|
|
3
3
|
import { runKVQuantize, recordKVQuantize } from '../../gpu/kernel-selector.js';
|
|
4
4
|
import { KVCache } from './base.js';
|
|
5
5
|
import { SlidingWindowKVCache } from './sliding-window.js';
|
|
6
|
+
import {
|
|
7
|
+
computePackedStride,
|
|
8
|
+
retainTurboQuantSharedBuffers,
|
|
9
|
+
} from '../../gpu/kernels/turboquant-codebook.js';
|
|
10
|
+
|
|
11
|
+
function isTurboQuantMode(mode) {
|
|
12
|
+
return mode === 'turboquant' || mode === 'turboquant_prod';
|
|
13
|
+
}
|
|
14
|
+
|
|
15
|
+
function assertSupportedTurboQuantMode(mode, label) {
|
|
16
|
+
if (mode !== 'turboquant_outlier') {
|
|
17
|
+
return mode;
|
|
18
|
+
}
|
|
19
|
+
throw new Error(
|
|
20
|
+
`TieredKVCache ${label}="${mode}" is not supported yet. ` +
|
|
21
|
+
'TurboQuant outlier high-precision buffers and decode kernels are not wired end to end.'
|
|
22
|
+
);
|
|
23
|
+
}
|
|
6
24
|
|
|
7
25
|
// ============================================================================
|
|
8
26
|
// TieredKVCache (hot ring + cold paged)
|
|
@@ -55,9 +73,10 @@ export class TieredKVCache {
|
|
|
55
73
|
|
|
56
74
|
this.tieringMode = tiering.mode;
|
|
57
75
|
|
|
58
|
-
const
|
|
59
|
-
|
|
60
|
-
|
|
76
|
+
const turboQuantModes = ['turboquant', 'turboquant_prod'];
|
|
77
|
+
const defaultCompressionMode = turboQuantModes.includes(tiering.mode)
|
|
78
|
+
? tiering.mode
|
|
79
|
+
: (tiering.mode === 'int8' ? 'int8' : (tiering.mode === 'int4' ? 'int4' : 'none'));
|
|
61
80
|
this.compression = tiering.compression ?? { mode: defaultCompressionMode, blockSize: 1 };
|
|
62
81
|
|
|
63
82
|
this.gating = tiering.gating ?? { mode: 'force_off', minAluBwRatio: 0.0 };
|
|
@@ -82,13 +101,37 @@ export class TieredKVCache {
|
|
|
82
101
|
throw new Error('TieredKVCache currently requires f16 KV storage.');
|
|
83
102
|
}
|
|
84
103
|
|
|
104
|
+
assertSupportedTurboQuantMode(this.tieringMode, 'tiering.mode');
|
|
105
|
+
assertSupportedTurboQuantMode(this.compression?.mode ?? 'none', 'tiering.compression.mode');
|
|
85
106
|
this.coldQuantMode = this._resolveCompressionMode(this.compression, this.gating);
|
|
107
|
+
assertSupportedTurboQuantMode(this.coldQuantMode, 'resolved cold quant mode');
|
|
86
108
|
if (this.coldQuantMode !== 'none' && this.compression.blockSize !== 1) {
|
|
87
|
-
throw new Error('TieredKVCache compression.blockSize must be 1 (per-token) for
|
|
109
|
+
throw new Error('TieredKVCache compression.blockSize must be 1 (per-token) for quantized cold tiers.');
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
this.isTurboQuant = isTurboQuantMode(this.coldQuantMode);
|
|
113
|
+
this.isProdMode = this.coldQuantMode === 'turboquant_prod';
|
|
114
|
+
this.turboQuantBitWidth = this.compression.bitWidth ?? 4;
|
|
115
|
+
|
|
116
|
+
if (this.isTurboQuant) {
|
|
117
|
+
this.coldPackedStride = computePackedStride(this.headDim, this.turboQuantBitWidth);
|
|
118
|
+
if (this.isProdMode) {
|
|
119
|
+
const mseBitWidth = this.turboQuantBitWidth - 1;
|
|
120
|
+
this.msePackedStride = computePackedStride(this.headDim, mseBitWidth);
|
|
121
|
+
this.residualPackedStride = Math.ceil(this.headDim / 32);
|
|
122
|
+
}
|
|
123
|
+
} else {
|
|
124
|
+
this.coldPackedStride = this.coldQuantMode === 'int4'
|
|
125
|
+
? Math.ceil(this.headDim / 8)
|
|
126
|
+
: Math.ceil(this.headDim / 4);
|
|
88
127
|
}
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
128
|
+
|
|
129
|
+
// Shared TurboQuant GPU buffers (allocated lazily in _createColdQuantizedLayers)
|
|
130
|
+
this.rotationMatrixBuffer = null;
|
|
131
|
+
this.codebookCentroidsBuffer = null;
|
|
132
|
+
this.codebookBoundariesBuffer = null;
|
|
133
|
+
this.qjlMatrixBuffer = null;
|
|
134
|
+
this.releaseSharedBuffers = null;
|
|
92
135
|
|
|
93
136
|
if (this.coldQuantMode !== 'none' && !this.useGPU) {
|
|
94
137
|
throw new Error('TieredKVCache quantization requires GPU.');
|
|
@@ -168,44 +211,115 @@ export class TieredKVCache {
|
|
|
168
211
|
if (!device) {
|
|
169
212
|
throw new Error('GPU device not initialized.');
|
|
170
213
|
}
|
|
214
|
+
|
|
215
|
+
// Upload shared TurboQuant buffers if needed
|
|
216
|
+
if (this.isTurboQuant) {
|
|
217
|
+
const sharedBuffers = retainTurboQuantSharedBuffers(device, {
|
|
218
|
+
headDim: this.headDim,
|
|
219
|
+
bitWidth: this.turboQuantBitWidth,
|
|
220
|
+
prodMode: this.isProdMode,
|
|
221
|
+
});
|
|
222
|
+
this.rotationMatrixBuffer = sharedBuffers.rotationMatrixBuffer;
|
|
223
|
+
this.codebookCentroidsBuffer = sharedBuffers.codebookCentroidsBuffer;
|
|
224
|
+
this.codebookBoundariesBuffer = sharedBuffers.codebookBoundariesBuffer;
|
|
225
|
+
this.qjlMatrixBuffer = sharedBuffers.qjlMatrixBuffer;
|
|
226
|
+
this.releaseSharedBuffers = sharedBuffers.release;
|
|
227
|
+
}
|
|
228
|
+
|
|
171
229
|
const layers = new Array(this.numLayers);
|
|
172
|
-
const packedStride = this.coldPackedStride;
|
|
173
|
-
const packedBytes = this.maxSeqLen * this.numHeads * packedStride * 4;
|
|
174
230
|
const scalesBytes = this.maxSeqLen * this.numHeads * 2;
|
|
231
|
+
const bufUsage = GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST | GPUBufferUsage.COPY_SRC;
|
|
175
232
|
|
|
176
|
-
|
|
177
|
-
const
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
233
|
+
if (this.isProdMode) {
|
|
234
|
+
const msePackedBytes = this.maxSeqLen * this.numHeads * this.msePackedStride * 4;
|
|
235
|
+
const resPackedBytes = this.maxSeqLen * this.numHeads * this.residualPackedStride * 4;
|
|
236
|
+
|
|
237
|
+
for (let l = 0; l < this.numLayers; l++) {
|
|
238
|
+
layers[l] = {
|
|
239
|
+
keysPackedGPU: device.createBuffer({ label: `kv_cache_cold_keys_mse_${l}`, size: msePackedBytes, usage: bufUsage }),
|
|
240
|
+
valuesPackedGPU: device.createBuffer({ label: `kv_cache_cold_values_mse_${l}`, size: msePackedBytes, usage: bufUsage }),
|
|
241
|
+
residualKGPU: device.createBuffer({ label: `kv_cache_cold_res_k_${l}`, size: resPackedBytes, usage: bufUsage }),
|
|
242
|
+
residualVGPU: device.createBuffer({ label: `kv_cache_cold_res_v_${l}`, size: resPackedBytes, usage: bufUsage }),
|
|
243
|
+
residualNormsKGPU: device.createBuffer({ label: `kv_cache_cold_rnorm_k_${l}`, size: scalesBytes, usage: bufUsage }),
|
|
244
|
+
residualNormsVGPU: device.createBuffer({ label: `kv_cache_cold_rnorm_v_${l}`, size: scalesBytes, usage: bufUsage }),
|
|
245
|
+
scalesKGPU: device.createBuffer({ label: `kv_cache_cold_scales_k_${l}`, size: scalesBytes, usage: bufUsage }),
|
|
246
|
+
scalesVGPU: device.createBuffer({ label: `kv_cache_cold_scales_v_${l}`, size: scalesBytes, usage: bufUsage }),
|
|
247
|
+
seqLen: 0,
|
|
248
|
+
};
|
|
249
|
+
}
|
|
250
|
+
} else {
|
|
251
|
+
const packedStride = this.isTurboQuant ? this.coldPackedStride : this.coldPackedStride;
|
|
252
|
+
const packedBytes = this.maxSeqLen * this.numHeads * packedStride * 4;
|
|
253
|
+
|
|
254
|
+
for (let l = 0; l < this.numLayers; l++) {
|
|
255
|
+
layers[l] = {
|
|
256
|
+
keysPackedGPU: device.createBuffer({ label: `kv_cache_cold_keys_packed_layer_${l}`, size: packedBytes, usage: bufUsage }),
|
|
257
|
+
valuesPackedGPU: device.createBuffer({ label: `kv_cache_cold_values_packed_layer_${l}`, size: packedBytes, usage: bufUsage }),
|
|
258
|
+
scalesKGPU: device.createBuffer({ label: `kv_cache_cold_scales_k_layer_${l}`, size: scalesBytes, usage: bufUsage }),
|
|
259
|
+
scalesVGPU: device.createBuffer({ label: `kv_cache_cold_scales_v_layer_${l}`, size: scalesBytes, usage: bufUsage }),
|
|
260
|
+
seqLen: 0,
|
|
261
|
+
};
|
|
262
|
+
}
|
|
204
263
|
}
|
|
205
264
|
return layers;
|
|
206
265
|
}
|
|
207
266
|
|
|
208
267
|
|
|
268
|
+
_buildQuantizeOptions(layer, startPos, numTokens) {
|
|
269
|
+
const base = {
|
|
270
|
+
numKVHeads: this.numHeads,
|
|
271
|
+
headDim: this.headDim,
|
|
272
|
+
startPos,
|
|
273
|
+
numTokens,
|
|
274
|
+
mode: this.coldQuantMode,
|
|
275
|
+
};
|
|
276
|
+
|
|
277
|
+
if (this.isProdMode) {
|
|
278
|
+
return {
|
|
279
|
+
outputKeysBuffer: layer.keysPackedGPU,
|
|
280
|
+
outputValuesBuffer: layer.valuesPackedGPU,
|
|
281
|
+
options: {
|
|
282
|
+
...base,
|
|
283
|
+
packedStride: this.msePackedStride,
|
|
284
|
+
rotationMatrixBuffer: this.rotationMatrixBuffer,
|
|
285
|
+
codebookCentroidsBuffer: this.codebookCentroidsBuffer,
|
|
286
|
+
codebookBoundariesBuffer: this.codebookBoundariesBuffer,
|
|
287
|
+
qjlMatrixBuffer: this.qjlMatrixBuffer,
|
|
288
|
+
residualKBuffer: layer.residualKGPU,
|
|
289
|
+
residualVBuffer: layer.residualVGPU,
|
|
290
|
+
residualNormsKBuffer: layer.residualNormsKGPU,
|
|
291
|
+
residualNormsVBuffer: layer.residualNormsVGPU,
|
|
292
|
+
residualPackedStride: this.residualPackedStride,
|
|
293
|
+
bitWidth: this.turboQuantBitWidth - 1,
|
|
294
|
+
},
|
|
295
|
+
};
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
if (this.isTurboQuant) {
|
|
299
|
+
return {
|
|
300
|
+
outputKeysBuffer: layer.keysPackedGPU,
|
|
301
|
+
outputValuesBuffer: layer.valuesPackedGPU,
|
|
302
|
+
options: {
|
|
303
|
+
...base,
|
|
304
|
+
packedStride: this.coldPackedStride,
|
|
305
|
+
rotationMatrixBuffer: this.rotationMatrixBuffer,
|
|
306
|
+
codebookCentroidsBuffer: this.codebookCentroidsBuffer,
|
|
307
|
+
codebookBoundariesBuffer: this.codebookBoundariesBuffer,
|
|
308
|
+
bitWidth: this.turboQuantBitWidth,
|
|
309
|
+
},
|
|
310
|
+
};
|
|
311
|
+
}
|
|
312
|
+
|
|
313
|
+
return {
|
|
314
|
+
outputKeysBuffer: layer.keysPackedGPU,
|
|
315
|
+
outputValuesBuffer: layer.valuesPackedGPU,
|
|
316
|
+
options: {
|
|
317
|
+
...base,
|
|
318
|
+
packedStride: this.coldPackedStride,
|
|
319
|
+
},
|
|
320
|
+
};
|
|
321
|
+
}
|
|
322
|
+
|
|
209
323
|
_getColdStoreBytes() {
|
|
210
324
|
if (this.coldCache) {
|
|
211
325
|
return this.coldCache.getMemoryStats().theoretical;
|
|
@@ -318,21 +432,15 @@ export class TieredKVCache {
|
|
|
318
432
|
this.totalTokensSeen = this.coldCache.totalTokensSeen;
|
|
319
433
|
} else {
|
|
320
434
|
const layer = this.coldLayers[layerIdx];
|
|
435
|
+
const quantOpts = this._buildQuantizeOptions(layer, startPos, numTokens);
|
|
321
436
|
await runKVQuantize(
|
|
322
437
|
keysBuffer,
|
|
323
438
|
valuesBuffer,
|
|
324
|
-
|
|
325
|
-
|
|
439
|
+
quantOpts.outputKeysBuffer,
|
|
440
|
+
quantOpts.outputValuesBuffer,
|
|
326
441
|
layer.scalesKGPU,
|
|
327
442
|
layer.scalesVGPU,
|
|
328
|
-
|
|
329
|
-
numKVHeads: this.numHeads,
|
|
330
|
-
headDim: this.headDim,
|
|
331
|
-
startPos,
|
|
332
|
-
numTokens,
|
|
333
|
-
packedStride: this.coldPackedStride,
|
|
334
|
-
mode: this.coldQuantMode,
|
|
335
|
-
}
|
|
443
|
+
quantOpts.options
|
|
336
444
|
);
|
|
337
445
|
layer.seqLen = Math.max(layer.seqLen, startPos + numTokens);
|
|
338
446
|
this.currentSeqLen = Math.max(this.currentSeqLen, startPos + numTokens);
|
|
@@ -364,22 +472,16 @@ export class TieredKVCache {
|
|
|
364
472
|
this.coldCache.recordUpdateFromGPU(recorder, layerIdx, keysBuffer, valuesBuffer, startPos, numTokens);
|
|
365
473
|
} else {
|
|
366
474
|
const layer = this.coldLayers[layerIdx];
|
|
475
|
+
const quantOpts = this._buildQuantizeOptions(layer, startPos, numTokens);
|
|
367
476
|
await recordKVQuantize(
|
|
368
477
|
recorder,
|
|
369
478
|
keysBuffer,
|
|
370
479
|
valuesBuffer,
|
|
371
|
-
|
|
372
|
-
|
|
480
|
+
quantOpts.outputKeysBuffer,
|
|
481
|
+
quantOpts.outputValuesBuffer,
|
|
373
482
|
layer.scalesKGPU,
|
|
374
483
|
layer.scalesVGPU,
|
|
375
|
-
|
|
376
|
-
numKVHeads: this.numHeads,
|
|
377
|
-
headDim: this.headDim,
|
|
378
|
-
startPos,
|
|
379
|
-
numTokens,
|
|
380
|
-
packedStride: this.coldPackedStride,
|
|
381
|
-
mode: this.coldQuantMode,
|
|
382
|
-
}
|
|
484
|
+
quantOpts.options
|
|
383
485
|
);
|
|
384
486
|
layer.seqLen = Math.max(layer.seqLen, startPos + numTokens);
|
|
385
487
|
}
|
|
@@ -427,7 +529,7 @@ export class TieredKVCache {
|
|
|
427
529
|
}
|
|
428
530
|
|
|
429
531
|
const coldLayer = this.coldLayers[layerIdx];
|
|
430
|
-
|
|
532
|
+
const result = {
|
|
431
533
|
layout: 'tiered',
|
|
432
534
|
seqLen: totalSeqLen,
|
|
433
535
|
hotKeysGPU: hot.keysGPU,
|
|
@@ -442,9 +544,24 @@ export class TieredKVCache {
|
|
|
442
544
|
coldSeqLen: coldLen,
|
|
443
545
|
coldPageTableGPU: null,
|
|
444
546
|
coldPageSize: 0,
|
|
445
|
-
coldPackedStride: this.coldPackedStride,
|
|
547
|
+
coldPackedStride: this.isProdMode ? this.msePackedStride : this.coldPackedStride,
|
|
446
548
|
coldQuantMode: this.coldQuantMode,
|
|
447
549
|
};
|
|
550
|
+
|
|
551
|
+
if (this.isTurboQuant) {
|
|
552
|
+
result.rotationMatrixBuffer = this.rotationMatrixBuffer;
|
|
553
|
+
result.codebookCentroidsBuffer = this.codebookCentroidsBuffer;
|
|
554
|
+
}
|
|
555
|
+
if (this.isProdMode) {
|
|
556
|
+
result.residualKGPU = coldLayer.residualKGPU;
|
|
557
|
+
result.residualVGPU = coldLayer.residualVGPU;
|
|
558
|
+
result.residualNormsKGPU = coldLayer.residualNormsKGPU;
|
|
559
|
+
result.residualNormsVGPU = coldLayer.residualNormsVGPU;
|
|
560
|
+
result.qjlMatrixBuffer = this.qjlMatrixBuffer;
|
|
561
|
+
result.residualPackedStride = this.residualPackedStride;
|
|
562
|
+
}
|
|
563
|
+
|
|
564
|
+
return result;
|
|
448
565
|
}
|
|
449
566
|
|
|
450
567
|
|
|
@@ -511,12 +628,24 @@ export class TieredKVCache {
|
|
|
511
628
|
this.coldCache.destroy();
|
|
512
629
|
} else if (this.coldLayers) {
|
|
513
630
|
for (const layer of this.coldLayers) {
|
|
514
|
-
layer.keysPackedGPU
|
|
515
|
-
layer.valuesPackedGPU
|
|
516
|
-
layer.scalesKGPU
|
|
517
|
-
layer.scalesVGPU
|
|
631
|
+
layer.keysPackedGPU?.destroy();
|
|
632
|
+
layer.valuesPackedGPU?.destroy();
|
|
633
|
+
layer.scalesKGPU?.destroy();
|
|
634
|
+
layer.scalesVGPU?.destroy();
|
|
635
|
+
layer.residualKGPU?.destroy();
|
|
636
|
+
layer.residualVGPU?.destroy();
|
|
637
|
+
layer.residualNormsKGPU?.destroy();
|
|
638
|
+
layer.residualNormsVGPU?.destroy();
|
|
518
639
|
}
|
|
519
640
|
}
|
|
641
|
+
if (this.releaseSharedBuffers) {
|
|
642
|
+
this.releaseSharedBuffers();
|
|
643
|
+
} else {
|
|
644
|
+
this.rotationMatrixBuffer?.destroy();
|
|
645
|
+
this.codebookCentroidsBuffer?.destroy();
|
|
646
|
+
this.codebookBoundariesBuffer?.destroy();
|
|
647
|
+
this.qjlMatrixBuffer?.destroy();
|
|
648
|
+
}
|
|
520
649
|
}
|
|
521
650
|
|
|
522
651
|
|
|
@@ -551,21 +680,30 @@ export class TieredKVCache {
|
|
|
551
680
|
const packedStride = this.coldPackedStride;
|
|
552
681
|
const packedBytesPerToken = this.numHeads * packedStride * 4;
|
|
553
682
|
const scalesBytesPerToken = this.numHeads * 2;
|
|
683
|
+
const mseBytesPerToken = this.isProdMode ? this.numHeads * this.msePackedStride * 4 : packedBytesPerToken;
|
|
684
|
+
const residualBytesPerToken = this.isProdMode ? this.numHeads * this.residualPackedStride * 4 : 0;
|
|
554
685
|
for (let l = 0; l < this.numLayers; l++) {
|
|
555
686
|
const src = this.coldLayers[l];
|
|
556
687
|
const dst = cloned.coldLayers[l];
|
|
557
688
|
const usedTokens = src.seqLen;
|
|
558
689
|
if (usedTokens > 0) {
|
|
559
|
-
const packedBytes = usedTokens *
|
|
690
|
+
const packedBytes = usedTokens * mseBytesPerToken;
|
|
560
691
|
const scalesBytes = usedTokens * scalesBytesPerToken;
|
|
561
692
|
const encoder = device.createCommandEncoder({ label: `kv_cache_cold_clone_${l}` });
|
|
562
693
|
encoder.copyBufferToBuffer(src.keysPackedGPU, 0, dst.keysPackedGPU, 0, packedBytes);
|
|
563
694
|
encoder.copyBufferToBuffer(src.valuesPackedGPU, 0, dst.valuesPackedGPU, 0, packedBytes);
|
|
564
695
|
encoder.copyBufferToBuffer(src.scalesKGPU, 0, dst.scalesKGPU, 0, scalesBytes);
|
|
565
696
|
encoder.copyBufferToBuffer(src.scalesVGPU, 0, dst.scalesVGPU, 0, scalesBytes);
|
|
697
|
+
if (this.isProdMode) {
|
|
698
|
+
const residualBytes = usedTokens * residualBytesPerToken;
|
|
699
|
+
encoder.copyBufferToBuffer(src.residualKGPU, 0, dst.residualKGPU, 0, residualBytes);
|
|
700
|
+
encoder.copyBufferToBuffer(src.residualVGPU, 0, dst.residualVGPU, 0, residualBytes);
|
|
701
|
+
encoder.copyBufferToBuffer(src.residualNormsKGPU, 0, dst.residualNormsKGPU, 0, scalesBytes);
|
|
702
|
+
encoder.copyBufferToBuffer(src.residualNormsVGPU, 0, dst.residualNormsVGPU, 0, scalesBytes);
|
|
703
|
+
}
|
|
566
704
|
device.queue.submit([encoder.finish()]);
|
|
567
|
-
dst.seqLen = src.seqLen;
|
|
568
705
|
}
|
|
706
|
+
dst.seqLen = src.seqLen;
|
|
569
707
|
}
|
|
570
708
|
}
|
|
571
709
|
|
|
@@ -17,20 +17,30 @@ export interface KVCacheConfig {
|
|
|
17
17
|
headDim: number;
|
|
18
18
|
maxSeqLen: number;
|
|
19
19
|
useGPU: boolean;
|
|
20
|
-
layout: 'contiguous' | 'paged' | 'tiered' | 'bdpa' | 'bdpa_paged';
|
|
20
|
+
layout: 'contiguous' | 'contiguous_quantized' | 'paged' | 'tiered' | 'bdpa' | 'bdpa_paged';
|
|
21
21
|
pageSize: number;
|
|
22
22
|
kvDtype: 'f16' | 'f32';
|
|
23
23
|
/** Window size for sliding window cache */
|
|
24
24
|
windowSize?: number;
|
|
25
25
|
/** Tiered KV cache settings (required when layout = 'tiered') */
|
|
26
26
|
tiering?: {
|
|
27
|
-
mode: 'off' | 'fp16' | 'int8' | 'int4';
|
|
27
|
+
mode: 'off' | 'fp16' | 'int8' | 'int4' | 'turboquant' | 'turboquant_prod';
|
|
28
28
|
hotWindow: number;
|
|
29
29
|
coldPageSize: number;
|
|
30
30
|
coldDtype: 'f16' | 'f32';
|
|
31
|
-
compression: {
|
|
31
|
+
compression: {
|
|
32
|
+
mode: 'none' | 'int8' | 'int4' | 'turboquant' | 'turboquant_prod';
|
|
33
|
+
blockSize: number;
|
|
34
|
+
bitWidth?: number;
|
|
35
|
+
prodMode?: boolean;
|
|
36
|
+
};
|
|
32
37
|
gating: { mode: 'auto' | 'force_on' | 'force_off'; minAluBwRatio: number };
|
|
33
38
|
};
|
|
39
|
+
quantization?: {
|
|
40
|
+
mode: 'none' | 'turboquant' | 'turboquant_prod';
|
|
41
|
+
bitWidth?: number;
|
|
42
|
+
prodMode?: boolean;
|
|
43
|
+
};
|
|
34
44
|
}
|
|
35
45
|
|
|
36
46
|
// ============================================================================
|
|
@@ -94,6 +104,7 @@ export interface StandardGPUBuffersResult {
|
|
|
94
104
|
keysGPU: GPUBuffer;
|
|
95
105
|
valuesGPU: GPUBuffer;
|
|
96
106
|
seqLen: number;
|
|
107
|
+
layout?: 'contiguous' | 'ring' | 'paged';
|
|
97
108
|
pageTableGPU?: GPUBuffer;
|
|
98
109
|
pageSize?: number;
|
|
99
110
|
}
|
|
@@ -114,7 +125,35 @@ export interface TieredGPUBuffersResult {
|
|
|
114
125
|
coldPageTableGPU?: GPUBuffer;
|
|
115
126
|
coldPageSize?: number;
|
|
116
127
|
coldPackedStride?: number;
|
|
117
|
-
coldQuantMode?: 'none' | 'int8' | 'int4';
|
|
128
|
+
coldQuantMode?: 'none' | 'int8' | 'int4' | 'turboquant' | 'turboquant_prod';
|
|
129
|
+
rotationMatrixBuffer?: GPUBuffer;
|
|
130
|
+
codebookCentroidsBuffer?: GPUBuffer;
|
|
131
|
+
residualKGPU?: GPUBuffer;
|
|
132
|
+
residualVGPU?: GPUBuffer;
|
|
133
|
+
residualNormsKGPU?: GPUBuffer;
|
|
134
|
+
residualNormsVGPU?: GPUBuffer;
|
|
135
|
+
qjlMatrixBuffer?: GPUBuffer;
|
|
136
|
+
residualPackedStride?: number;
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
export interface QuantizedGPUBuffersResult {
|
|
140
|
+
layout: 'contiguous_quantized';
|
|
141
|
+
seqLen: number;
|
|
142
|
+
quantMode: 'turboquant' | 'turboquant_prod';
|
|
143
|
+
prodMode: boolean;
|
|
144
|
+
packedStride: number;
|
|
145
|
+
scalesKGPU: GPUBuffer;
|
|
146
|
+
scalesVGPU: GPUBuffer;
|
|
147
|
+
rotationMatrixBuffer: GPUBuffer;
|
|
148
|
+
codebookCentroidsBuffer: GPUBuffer;
|
|
149
|
+
keysPackedGPU: GPUBuffer;
|
|
150
|
+
valuesPackedGPU: GPUBuffer;
|
|
151
|
+
residualKGPU?: GPUBuffer;
|
|
152
|
+
residualVGPU?: GPUBuffer;
|
|
153
|
+
residualNormsKGPU?: GPUBuffer;
|
|
154
|
+
residualNormsVGPU?: GPUBuffer;
|
|
155
|
+
residualPackedStride?: number;
|
|
156
|
+
qjlMatrixBuffer?: GPUBuffer;
|
|
118
157
|
}
|
|
119
158
|
|
|
120
159
|
export interface BDPAGPUBuffersResult {
|
|
@@ -127,7 +166,11 @@ export interface BDPAGPUBuffersResult {
|
|
|
127
166
|
pageSize: number;
|
|
128
167
|
}
|
|
129
168
|
|
|
130
|
-
export type GPUBuffersResult =
|
|
169
|
+
export type GPUBuffersResult =
|
|
170
|
+
| StandardGPUBuffersResult
|
|
171
|
+
| TieredGPUBuffersResult
|
|
172
|
+
| QuantizedGPUBuffersResult
|
|
173
|
+
| BDPAGPUBuffersResult;
|
|
131
174
|
|
|
132
175
|
/**
|
|
133
176
|
* Memory statistics
|
|
@@ -139,7 +182,7 @@ export interface MemoryStats {
|
|
|
139
182
|
efficiency: number;
|
|
140
183
|
seqLen: number;
|
|
141
184
|
maxSeqLen: number;
|
|
142
|
-
layout: 'contiguous' | 'paged' | 'tiered' | 'bdpa_paged';
|
|
185
|
+
layout: 'contiguous' | 'contiguous_quantized' | 'paged' | 'tiered' | 'bdpa_paged';
|
|
143
186
|
}
|
|
144
187
|
|
|
145
188
|
/**
|
|
@@ -17,6 +17,7 @@ export {
|
|
|
17
17
|
type KVGetResult,
|
|
18
18
|
type GPUBuffersResult,
|
|
19
19
|
type TieredGPUBuffersResult,
|
|
20
|
+
type QuantizedGPUBuffersResult,
|
|
20
21
|
type BDPAGPUBuffersResult,
|
|
21
22
|
type MemoryStats,
|
|
22
23
|
type GPUContext,
|
|
@@ -31,6 +32,8 @@ export {
|
|
|
31
32
|
SlidingWindowKVCache,
|
|
32
33
|
TieredKVCache,
|
|
33
34
|
BasisDecomposedPagedCache,
|
|
35
|
+
QuantizedKVCache,
|
|
36
|
+
MixedGeometryKVCache,
|
|
34
37
|
// Default
|
|
35
38
|
KVCache as default,
|
|
36
39
|
} from './kv-cache/index.js';
|
|
@@ -306,6 +306,7 @@ export class MultiModelNetwork {
|
|
|
306
306
|
const samplingDefaults = runtimeDefaults.sampling;
|
|
307
307
|
const batchingDefaults = runtimeDefaults.batching;
|
|
308
308
|
const generationDefaults = runtimeDefaults.generation;
|
|
309
|
+
const sessionDecodeLoopDefaults = runtimeDefaults.session?.decodeLoop ?? {};
|
|
309
310
|
|
|
310
311
|
const opts = {
|
|
311
312
|
maxTokens: options.maxTokens ?? batchingDefaults.maxTokens,
|
|
@@ -321,7 +322,7 @@ export class MultiModelNetwork {
|
|
|
321
322
|
debug: options.debug ?? basePipeline.debug,
|
|
322
323
|
debugLayers: options.debugLayers,
|
|
323
324
|
profile: options.profile ?? generationDefaults.profile,
|
|
324
|
-
disableCommandBatching: options.disableCommandBatching ??
|
|
325
|
+
disableCommandBatching: options.disableCommandBatching ?? sessionDecodeLoopDefaults.disableCommandBatching,
|
|
325
326
|
disableMultiTokenDecode: options.disableMultiTokenDecode ?? generationDefaults.disableMultiTokenDecode,
|
|
326
327
|
batchSize: options.batchSize ?? batchingDefaults.batchSize,
|
|
327
328
|
stopCheckMode: options.stopCheckMode ?? batchingDefaults.stopCheckMode,
|