doppler-gpu 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/BRANDING.md +14 -0
- package/CHANGELOG.md +158 -0
- package/LICENSE +201 -0
- package/NOTICE +5 -0
- package/README.md +85 -0
- package/SECURITY.md +19 -0
- package/package.json +195 -0
- package/src/adapters/adapter-manager.d.ts +200 -0
- package/src/adapters/adapter-manager.js +509 -0
- package/src/adapters/adapter-manifest.d.ts +290 -0
- package/src/adapters/adapter-manifest.js +320 -0
- package/src/adapters/adapter-registry.d.ts +192 -0
- package/src/adapters/adapter-registry.js +477 -0
- package/src/adapters/index.d.ts +89 -0
- package/src/adapters/index.js +42 -0
- package/src/adapters/lora-loader.d.ts +105 -0
- package/src/adapters/lora-loader.js +425 -0
- package/src/bootstrap.d.ts +1 -0
- package/src/bootstrap.js +30 -0
- package/src/bridge/extension/background.d.ts +14 -0
- package/src/bridge/extension/background.js +168 -0
- package/src/bridge/extension/manifest.json +34 -0
- package/src/bridge/extension-client.d.ts +114 -0
- package/src/bridge/extension-client.js +409 -0
- package/src/bridge/index.d.ts +69 -0
- package/src/bridge/index.js +53 -0
- package/src/bridge/node-bridge.js +26 -0
- package/src/bridge/protocol.d.ts +96 -0
- package/src/bridge/protocol.js +130 -0
- package/src/browser/browser-converter.d.ts +71 -0
- package/src/browser/browser-converter.js +978 -0
- package/src/browser/file-picker.d.ts +63 -0
- package/src/browser/file-picker.js +281 -0
- package/src/browser/gguf-importer.d.ts +136 -0
- package/src/browser/gguf-importer.js +532 -0
- package/src/browser/gguf-parser-browser.d.ts +14 -0
- package/src/browser/gguf-parser-browser.js +17 -0
- package/src/browser/quantization.d.ts +69 -0
- package/src/browser/quantization.js +328 -0
- package/src/browser/safetensors-parser-browser.d.ts +193 -0
- package/src/browser/safetensors-parser-browser.js +347 -0
- package/src/browser/shard-io-browser.d.ts +57 -0
- package/src/browser/shard-io-browser.js +89 -0
- package/src/browser/tensor-source-download.d.ts +27 -0
- package/src/browser/tensor-source-download.js +245 -0
- package/src/browser/tensor-source-file.d.ts +26 -0
- package/src/browser/tensor-source-file.js +53 -0
- package/src/browser/tensor-source-http.d.ts +29 -0
- package/src/browser/tensor-source-http.js +130 -0
- package/src/cli/config/doppler-cli-policy.json +28 -0
- package/src/cli/doppler-cli.d.ts +28 -0
- package/src/cli/doppler-cli.js +1664 -0
- package/src/client/doppler-api.browser.d.ts +1 -0
- package/src/client/doppler-api.browser.js +389 -0
- package/src/client/doppler-api.d.ts +83 -0
- package/src/client/doppler-api.js +389 -0
- package/src/client/doppler-provider/generation.d.ts +25 -0
- package/src/client/doppler-provider/generation.js +126 -0
- package/src/client/doppler-provider/index.d.ts +2 -0
- package/src/client/doppler-provider/index.js +3 -0
- package/src/client/doppler-provider/model-manager.d.ts +71 -0
- package/src/client/doppler-provider/model-manager.js +739 -0
- package/src/client/doppler-provider/provider.d.ts +5 -0
- package/src/client/doppler-provider/provider.js +102 -0
- package/src/client/doppler-provider/source-runtime.d.ts +23 -0
- package/src/client/doppler-provider/source-runtime.js +677 -0
- package/src/client/doppler-provider/types.d.ts +127 -0
- package/src/client/doppler-provider/types.js +17 -0
- package/src/client/doppler-provider.d.ts +46 -0
- package/src/client/doppler-provider.js +36 -0
- package/src/client/doppler-registry.d.ts +23 -0
- package/src/client/doppler-registry.js +86 -0
- package/src/client/doppler-registry.json +41 -0
- package/src/config/README.md +57 -0
- package/src/config/backward-registry-loader.d.ts +3 -0
- package/src/config/backward-registry-loader.js +23 -0
- package/src/config/conversion/README.md +147 -0
- package/src/config/conversion/embeddinggemma/google-embeddinggemma-300m-q4k-ehf16-af32.json +285 -0
- package/src/config/conversion/gemma3/gemma-3-1b-it-f16-af32.json +321 -0
- package/src/config/conversion/gemma3/gemma-3-1b-it-q4k-ehf16-af32.json +322 -0
- package/src/config/conversion/gemma3/gemma-3-270m-it-q4k-ehf16-af32.json +322 -0
- package/src/config/conversion/gemma3/translategemma-4b-1b-enes-q4k-ehf16-af32.json +322 -0
- package/src/config/conversion/gemma3/translategemma-4b-it-q4k-ehf16-af32.json +323 -0
- package/src/config/conversion/gemma4/gemma-4-moe-q4k-ehf16-af32.json +158 -0
- package/src/config/conversion/gpt-oss-20b-f16-xmxfp4.json +164 -0
- package/src/config/conversion/janus/janus-pro-1b-text-q4k-ehaf16.json +158 -0
- package/src/config/conversion/lfm2/lfm2.5-1.2b-instruct-q4k-ehf16-af32.json +339 -0
- package/src/config/conversion/qwen3/qwen-3-5-0-8b-q4k-ehaf16.json +385 -0
- package/src/config/conversion/qwen3/qwen-3-5-2b-q4k-ehaf16.json +385 -0
- package/src/config/conversion/sana/sana-sprint-0.6b-f16.json +219 -0
- package/src/config/execution-contract-check.d.ts +72 -0
- package/src/config/execution-contract-check.js +290 -0
- package/src/config/index.d.ts +52 -0
- package/src/config/index.js +22 -0
- package/src/config/kernel-path-loader.d.ts +156 -0
- package/src/config/kernel-path-loader.js +396 -0
- package/src/config/kernels/backward-registry.json +99 -0
- package/src/config/kernels/kernel-ref-digests.d.ts +1 -0
- package/src/config/kernels/kernel-ref-digests.js +233 -0
- package/src/config/kernels/kernel-ref.d.ts +17 -0
- package/src/config/kernels/kernel-ref.js +75 -0
- package/src/config/kernels/moe/gpt-oss.paths.json +49 -0
- package/src/config/kernels/moe/mixtral.paths.json +46 -0
- package/src/config/kernels/registry.d.ts +86 -0
- package/src/config/kernels/registry.js +116 -0
- package/src/config/kernels/registry.json +9446 -0
- package/src/config/merge-contract-check.d.ts +16 -0
- package/src/config/merge-contract-check.js +311 -0
- package/src/config/merge-helpers.d.ts +58 -0
- package/src/config/merge-helpers.js +179 -0
- package/src/config/merge.d.ts +153 -0
- package/src/config/merge.js +445 -0
- package/src/config/param-categories.d.ts +17 -0
- package/src/config/param-categories.js +72 -0
- package/src/config/param-validator.d.ts +26 -0
- package/src/config/param-validator.js +274 -0
- package/src/config/platforms/amd-rdna3.json +16 -0
- package/src/config/platforms/apple-m1.json +16 -0
- package/src/config/platforms/apple-m2.json +16 -0
- package/src/config/platforms/apple-m3.json +16 -0
- package/src/config/platforms/generic.json +14 -0
- package/src/config/platforms/loader.d.ts +65 -0
- package/src/config/platforms/loader.js +158 -0
- package/src/config/platforms/nvidia-gb200-8gpu.json +45 -0
- package/src/config/platforms/nvidia-gb200-nvl72.json +45 -0
- package/src/config/platforms/nvidia-gh200-nvl2.json +44 -0
- package/src/config/platforms/nvidia-gh200.json +44 -0
- package/src/config/platforms/nvidia-rtx30.json +16 -0
- package/src/config/platforms/nvidia-rtx40.json +16 -0
- package/src/config/quantization-contract-check.d.ts +12 -0
- package/src/config/quantization-contract-check.js +91 -0
- package/src/config/required-inference-fields-contract-check.d.ts +24 -0
- package/src/config/required-inference-fields-contract-check.js +238 -0
- package/src/config/runtime/compute/f16-activations.json +30 -0
- package/src/config/runtime/compute/f16-batched.json +32 -0
- package/src/config/runtime/default.json +100 -0
- package/src/config/runtime/diagnostics/debug-logits.json +53 -0
- package/src/config/runtime/diagnostics/drift-policies.json +147 -0
- package/src/config/runtime/experiments/bench/gemma3-bench-q4k.json +54 -0
- package/src/config/runtime/experiments/debug/gemma3-debug-q4k.json +210 -0
- package/src/config/runtime/experiments/verify/gemma3-verify.json +39 -0
- package/src/config/runtime/experiments/verify/lfm2-verify.json +46 -0
- package/src/config/runtime/experiments/verify/translategemma-verify.json +39 -0
- package/src/config/runtime/kernels/dequant-f16-q4k.json +13 -0
- package/src/config/runtime/kernels/dequant-f32-q4k.json +13 -0
- package/src/config/runtime/kernels/embeddinggemma-q4k-dequant-f32a.json +37 -0
- package/src/config/runtime/kernels/fused-q4k.json +13 -0
- package/src/config/runtime/kernels/gemma2-q4k-dequant-f16a.json +33 -0
- package/src/config/runtime/kernels/gemma2-q4k-dequant-f32a-nosubgroups.json +33 -0
- package/src/config/runtime/kernels/gemma2-q4k-fused-f32a.json +33 -0
- package/src/config/runtime/kernels/safe-q4k.json +13 -0
- package/src/config/runtime/model/gemma2-debug.json +77 -0
- package/src/config/runtime/model/gemma2-pipeline-debug.json +66 -0
- package/src/config/runtime/model/gemma2-pipeline.json +75 -0
- package/src/config/runtime/model/gemma3-layer-probe.json +85 -0
- package/src/config/runtime/model/qwen3-5-layer-probe.json +52 -0
- package/src/config/runtime/model/qwen3-5-layer3-boundary-probe.json +108 -0
- package/src/config/runtime/model/qwen3-5-linear-attn-debug.json +90 -0
- package/src/config/runtime/overlays/debug-f32a.json +3 -0
- package/src/config/runtime/overlays/trace-config.json +28 -0
- package/src/config/runtime/platform/metal-apple-q4k.json +11 -0
- package/src/config/runtime/profiles/default.json +10 -0
- package/src/config/runtime/profiles/low-memory.json +40 -0
- package/src/config/runtime/profiles/production.json +48 -0
- package/src/config/runtime/profiles/simulation.json +31 -0
- package/src/config/runtime/profiles/throughput.json +37 -0
- package/src/config/runtime/profiles/trace-layers.json +127 -0
- package/src/config/runtime/profiles/vector-stability.json +54 -0
- package/src/config/runtime/profiles/vector-throughput.json +28 -0
- package/src/config/runtime/profiles/verbose-trace.json +39 -0
- package/src/config/runtime/tiers/gemma4-16gb.json +69 -0
- package/src/config/runtime/tiers/gemma4-24gb.json +66 -0
- package/src/config/runtime/tiers/gemma4-32gb.json +66 -0
- package/src/config/runtime-merge.d.ts +5 -0
- package/src/config/runtime-merge.js +30 -0
- package/src/config/runtime.d.ts +28 -0
- package/src/config/runtime.js +69 -0
- package/src/config/schema/adapter.schema.d.ts +53 -0
- package/src/config/schema/adapter.schema.js +60 -0
- package/src/config/schema/backward-registry.schema.d.ts +14 -0
- package/src/config/schema/backward-registry.schema.js +46 -0
- package/src/config/schema/benchmark.schema.d.ts +54 -0
- package/src/config/schema/benchmark.schema.js +74 -0
- package/src/config/schema/bridge.schema.d.ts +25 -0
- package/src/config/schema/bridge.schema.js +22 -0
- package/src/config/schema/browser-suite-metrics.schema.d.ts +16 -0
- package/src/config/schema/browser-suite-metrics.schema.js +44 -0
- package/src/config/schema/buffer-pool.schema.d.ts +92 -0
- package/src/config/schema/buffer-pool.schema.js +50 -0
- package/src/config/schema/conversion-report.schema.d.ts +36 -0
- package/src/config/schema/conversion-report.schema.js +97 -0
- package/src/config/schema/conversion.schema.d.ts +191 -0
- package/src/config/schema/conversion.schema.js +13 -0
- package/src/config/schema/converter.schema.d.ts +117 -0
- package/src/config/schema/converter.schema.js +140 -0
- package/src/config/schema/debug.schema.d.ts +292 -0
- package/src/config/schema/debug.schema.js +134 -0
- package/src/config/schema/diffusion.schema.d.ts +88 -0
- package/src/config/schema/diffusion.schema.js +62 -0
- package/src/config/schema/distill-training.schema.d.ts +48 -0
- package/src/config/schema/distill-training.schema.js +139 -0
- package/src/config/schema/distribution.schema.d.ts +155 -0
- package/src/config/schema/distribution.schema.js +81 -0
- package/src/config/schema/doppler.schema.d.ts +74 -0
- package/src/config/schema/doppler.schema.js +341 -0
- package/src/config/schema/ecosystem.schema.d.ts +255 -0
- package/src/config/schema/ecosystem.schema.js +534 -0
- package/src/config/schema/emulation.schema.d.ts +351 -0
- package/src/config/schema/emulation.schema.js +301 -0
- package/src/config/schema/energy.schema.d.ts +102 -0
- package/src/config/schema/energy.schema.js +72 -0
- package/src/config/schema/execution-v1.schema.d.ts +258 -0
- package/src/config/schema/execution-v1.schema.js +211 -0
- package/src/config/schema/gpu-cache.schema.d.ts +26 -0
- package/src/config/schema/gpu-cache.schema.js +8 -0
- package/src/config/schema/harness.schema.d.ts +34 -0
- package/src/config/schema/harness.schema.js +21 -0
- package/src/config/schema/hotswap.schema.d.ts +55 -0
- package/src/config/schema/hotswap.schema.js +18 -0
- package/src/config/schema/index.d.ts +869 -0
- package/src/config/schema/index.js +498 -0
- package/src/config/schema/inference-defaults.schema.d.ts +276 -0
- package/src/config/schema/inference-defaults.schema.js +189 -0
- package/src/config/schema/inference.schema.d.ts +298 -0
- package/src/config/schema/inference.schema.js +39 -0
- package/src/config/schema/intent-bundle.schema.d.ts +28 -0
- package/src/config/schema/intent-bundle.schema.js +12 -0
- package/src/config/schema/kernel-path.schema.d.ts +184 -0
- package/src/config/schema/kernel-path.schema.js +9 -0
- package/src/config/schema/kernel-registry.schema.d.ts +199 -0
- package/src/config/schema/kernel-registry.schema.js +46 -0
- package/src/config/schema/kernel-thresholds.schema.d.ts +302 -0
- package/src/config/schema/kernel-thresholds.schema.js +195 -0
- package/src/config/schema/kernel-warmup.schema.d.ts +19 -0
- package/src/config/schema/kernel-warmup.schema.js +5 -0
- package/src/config/schema/kvcache.schema.d.ts +131 -0
- package/src/config/schema/kvcache.schema.js +41 -0
- package/src/config/schema/loading.schema.d.ts +153 -0
- package/src/config/schema/loading.schema.js +84 -0
- package/src/config/schema/lora.schema.d.ts +12 -0
- package/src/config/schema/lora.schema.js +12 -0
- package/src/config/schema/manifest.schema.d.ts +520 -0
- package/src/config/schema/manifest.schema.js +145 -0
- package/src/config/schema/memory-limits.schema.d.ts +107 -0
- package/src/config/schema/memory-limits.schema.js +57 -0
- package/src/config/schema/moe.schema.d.ts +78 -0
- package/src/config/schema/moe.schema.js +40 -0
- package/src/config/schema/platform.schema.d.ts +121 -0
- package/src/config/schema/platform.schema.js +1 -0
- package/src/config/schema/quantization-defaults.schema.d.ts +34 -0
- package/src/config/schema/quantization-defaults.schema.js +5 -0
- package/src/config/schema/quantization.schema.d.ts +10 -0
- package/src/config/schema/quantization.schema.js +33 -0
- package/src/config/schema/shared-runtime.schema.d.ts +75 -0
- package/src/config/schema/shared-runtime.schema.js +45 -0
- package/src/config/schema/speculation-self.schema.js +54 -0
- package/src/config/schema/speculative.schema.d.ts +21 -0
- package/src/config/schema/speculative.schema.js +11 -0
- package/src/config/schema/storage.schema.d.ts +123 -0
- package/src/config/schema/storage.schema.js +66 -0
- package/src/config/schema/tooling.schema.d.ts +29 -0
- package/src/config/schema/tooling.schema.js +12 -0
- package/src/config/schema/training-metrics.schema.d.ts +89 -0
- package/src/config/schema/training-metrics.schema.js +374 -0
- package/src/config/schema/training.schema.d.ts +88 -0
- package/src/config/schema/training.schema.js +106 -0
- package/src/config/schema/tuner.schema.d.ts +39 -0
- package/src/config/schema/tuner.schema.js +13 -0
- package/src/config/schema/ul-training.schema.d.ts +61 -0
- package/src/config/schema/ul-training.schema.js +140 -0
- package/src/config/schema/units.schema.d.ts +27 -0
- package/src/config/schema/units.schema.js +30 -0
- package/src/config/training-defaults.d.ts +24 -0
- package/src/config/training-defaults.js +99 -0
- package/src/config/transforms/capability-transform-resolver.d.ts +34 -0
- package/src/config/transforms/capability-transform-resolver.js +62 -0
- package/src/config/transforms/execution-graph-transforms.d.ts +92 -0
- package/src/config/transforms/execution-graph-transforms.js +512 -0
- package/src/converter/conversion-plan.d.ts +54 -0
- package/src/converter/conversion-plan.js +268 -0
- package/src/converter/core.d.ts +263 -0
- package/src/converter/core.js +1530 -0
- package/src/converter/index.d.ts +98 -0
- package/src/converter/index.js +59 -0
- package/src/converter/parsers/diffusion.d.ts +50 -0
- package/src/converter/parsers/diffusion.js +327 -0
- package/src/converter/parsers/gguf.d.ts +22 -0
- package/src/converter/parsers/gguf.js +46 -0
- package/src/converter/parsers/index.d.ts +21 -0
- package/src/converter/parsers/index.js +12 -0
- package/src/converter/parsers/transformer.d.ts +31 -0
- package/src/converter/parsers/transformer.js +198 -0
- package/src/converter/quantization-info.d.ts +37 -0
- package/src/converter/quantization-info.js +422 -0
- package/src/converter/quantizer.d.ts +101 -0
- package/src/converter/quantizer.js +444 -0
- package/src/converter/rope-config.d.ts +15 -0
- package/src/converter/rope-config.js +262 -0
- package/src/converter/shard-packer.d.ts +138 -0
- package/src/converter/shard-packer.js +425 -0
- package/src/converter/tokenizer-utils.d.ts +12 -0
- package/src/converter/tokenizer-utils.js +104 -0
- package/src/debug/capture-policy.d.ts +88 -0
- package/src/debug/capture-policy.js +196 -0
- package/src/debug/config.d.ts +78 -0
- package/src/debug/config.js +347 -0
- package/src/debug/history.d.ts +65 -0
- package/src/debug/history.js +82 -0
- package/src/debug/index.d.ts +268 -0
- package/src/debug/index.js +215 -0
- package/src/debug/log.d.ts +46 -0
- package/src/debug/log.js +132 -0
- package/src/debug/perf.d.ts +33 -0
- package/src/debug/perf.js +51 -0
- package/src/debug/reference/README.md +114 -0
- package/src/debug/reference/hf_attn_debug.py +114 -0
- package/src/debug/reference/hf_embed_check.py +89 -0
- package/src/debug/reference/hf_layer_out.py +100 -0
- package/src/debug/reference/hf_qwen35_linear_attn_debug.py +268 -0
- package/src/debug/reference/hf_rope_check.py +116 -0
- package/src/debug/reference/hf_weights.py +75 -0
- package/src/debug/signals.d.ts +63 -0
- package/src/debug/signals.js +39 -0
- package/src/debug/stats.d.ts +47 -0
- package/src/debug/stats.js +160 -0
- package/src/debug/tensor.d.ts +125 -0
- package/src/debug/tensor.js +268 -0
- package/src/debug/trace.d.ts +17 -0
- package/src/debug/trace.js +188 -0
- package/src/diffusion/config/expansion-lanes.json +29 -0
- package/src/diffusion/image-regression.d.ts +31 -0
- package/src/diffusion/image-regression.js +107 -0
- package/src/diffusion/index.d.ts +8 -0
- package/src/diffusion/index.js +8 -0
- package/src/distribution/p2p-control-plane.d.ts +52 -0
- package/src/distribution/p2p-control-plane.js +272 -0
- package/src/distribution/p2p-observability.d.ts +116 -0
- package/src/distribution/p2p-observability.js +303 -0
- package/src/distribution/p2p-transport-contract.d.ts +57 -0
- package/src/distribution/p2p-transport-contract.js +310 -0
- package/src/distribution/p2p-transport.js +75 -0
- package/src/distribution/p2p-webrtc-browser.d.ts +37 -0
- package/src/distribution/p2p-webrtc-browser.js +454 -0
- package/src/distribution/shard-delivery.d.ts +251 -0
- package/src/distribution/shard-delivery.js +2186 -0
- package/src/energy/index.d.ts +2 -0
- package/src/energy/index.js +2 -0
- package/src/errors/doppler-error.d.ts +20 -0
- package/src/errors/doppler-error.js +37 -0
- package/src/errors/index.d.ts +1 -0
- package/src/errors/index.js +1 -0
- package/src/formats/gguf/index.d.ts +8 -0
- package/src/formats/gguf/index.js +4 -0
- package/src/formats/gguf/types.d.ts +137 -0
- package/src/formats/gguf/types.js +460 -0
- package/src/formats/index.d.ts +51 -0
- package/src/formats/index.js +13 -0
- package/src/formats/rdrr/classification.d.ts +54 -0
- package/src/formats/rdrr/classification.js +329 -0
- package/src/formats/rdrr/groups.d.ts +35 -0
- package/src/formats/rdrr/groups.js +73 -0
- package/src/formats/rdrr/index.d.ts +25 -0
- package/src/formats/rdrr/index.js +19 -0
- package/src/formats/rdrr/manifest.d.ts +32 -0
- package/src/formats/rdrr/manifest.js +108 -0
- package/src/formats/rdrr/parsing.d.ts +27 -0
- package/src/formats/rdrr/parsing.js +167 -0
- package/src/formats/rdrr/tensor-config-validator.d.ts +42 -0
- package/src/formats/rdrr/tensor-config-validator.js +156 -0
- package/src/formats/rdrr/types.d.ts +201 -0
- package/src/formats/rdrr/types.js +16 -0
- package/src/formats/rdrr/validation.d.ts +9 -0
- package/src/formats/rdrr/validation.js +213 -0
- package/src/formats/safetensors/index.d.ts +8 -0
- package/src/formats/safetensors/index.js +4 -0
- package/src/formats/safetensors/types.d.ts +67 -0
- package/src/formats/safetensors/types.js +102 -0
- package/src/formats/tokenizer/index.d.ts +5 -0
- package/src/formats/tokenizer/index.js +3 -0
- package/src/formats/tokenizer/types.d.ts +9 -0
- package/src/formats/tokenizer/types.js +22 -0
- package/src/generation/index.d.ts +18 -0
- package/src/generation/index.js +32 -0
- package/src/gpu/command-recorder.d.ts +175 -0
- package/src/gpu/command-recorder.js +498 -0
- package/src/gpu/device.d.ts +142 -0
- package/src/gpu/device.js +532 -0
- package/src/gpu/kernel-runtime.d.ts +20 -0
- package/src/gpu/kernel-runtime.js +39 -0
- package/src/gpu/kernel-selection-cache.d.ts +13 -0
- package/src/gpu/kernel-selection-cache.js +13 -0
- package/src/gpu/kernel-selection-log.d.ts +12 -0
- package/src/gpu/kernel-selection-log.js +28 -0
- package/src/gpu/kernel-selector.d.ts +11 -0
- package/src/gpu/kernel-selector.js +10 -0
- package/src/gpu/kernel-tuner/benchmarks.d.ts +144 -0
- package/src/gpu/kernel-tuner/benchmarks.js +902 -0
- package/src/gpu/kernel-tuner/cache.d.ts +55 -0
- package/src/gpu/kernel-tuner/cache.js +152 -0
- package/src/gpu/kernel-tuner/index.d.ts +59 -0
- package/src/gpu/kernel-tuner/index.js +38 -0
- package/src/gpu/kernel-tuner/tuner.d.ts +82 -0
- package/src/gpu/kernel-tuner/tuner.js +247 -0
- package/src/gpu/kernel-tuner/types.d.ts +101 -0
- package/src/gpu/kernel-tuner/types.js +4 -0
- package/src/gpu/kernel-tuner.d.ts +33 -0
- package/src/gpu/kernel-tuner.js +12 -0
- package/src/gpu/kernels/README.md +127 -0
- package/src/gpu/kernels/attention.d.ts +236 -0
- package/src/gpu/kernels/attention.js +1437 -0
- package/src/gpu/kernels/attention.wgsl +249 -0
- package/src/gpu/kernels/attention_bdpa_decode_f16.wgsl +246 -0
- package/src/gpu/kernels/attention_decode.wgsl +233 -0
- package/src/gpu/kernels/attention_decode_chunked_f16.wgsl +183 -0
- package/src/gpu/kernels/attention_decode_chunked_f16kv.wgsl +208 -0
- package/src/gpu/kernels/attention_decode_f16.wgsl +202 -0
- package/src/gpu/kernels/attention_decode_f16kv.wgsl +224 -0
- package/src/gpu/kernels/attention_decode_online_f16.wgsl +223 -0
- package/src/gpu/kernels/attention_decode_online_f16kv.wgsl +225 -0
- package/src/gpu/kernels/attention_decode_optimized.wgsl +445 -0
- package/src/gpu/kernels/attention_decode_paged_f16.wgsl +172 -0
- package/src/gpu/kernels/attention_decode_paged_f16kv.wgsl +174 -0
- package/src/gpu/kernels/attention_decode_subgroup.wgsl +233 -0
- package/src/gpu/kernels/attention_decode_tiered_f16.wgsl +218 -0
- package/src/gpu/kernels/attention_decode_tiered_f16kv.wgsl +220 -0
- package/src/gpu/kernels/attention_decode_tiered_int4_f16kv.wgsl +242 -0
- package/src/gpu/kernels/attention_decode_tiered_int8_f16kv.wgsl +242 -0
- package/src/gpu/kernels/attention_f16.wgsl +214 -0
- package/src/gpu/kernels/attention_f16kv.wgsl +242 -0
- package/src/gpu/kernels/attention_small.wgsl +260 -0
- package/src/gpu/kernels/attention_small_f16.wgsl +240 -0
- package/src/gpu/kernels/attention_small_f16kv.wgsl +266 -0
- package/src/gpu/kernels/attention_streaming.wgsl +149 -0
- package/src/gpu/kernels/attention_streaming_f16.wgsl +147 -0
- package/src/gpu/kernels/attention_streaming_f16kv.wgsl +151 -0
- package/src/gpu/kernels/backward/adam.d.ts +28 -0
- package/src/gpu/kernels/backward/adam.js +203 -0
- package/src/gpu/kernels/backward/adam.wgsl +50 -0
- package/src/gpu/kernels/backward/attention_backward.d.ts +22 -0
- package/src/gpu/kernels/backward/attention_backward.js +364 -0
- package/src/gpu/kernels/backward/attention_backward.wgsl +49 -0
- package/src/gpu/kernels/backward/bias_add_backward.d.ts +17 -0
- package/src/gpu/kernels/backward/bias_add_backward.js +24 -0
- package/src/gpu/kernels/backward/bias_add_backward.wgsl +33 -0
- package/src/gpu/kernels/backward/conv2d_backward.d.ts +31 -0
- package/src/gpu/kernels/backward/conv2d_backward.js +148 -0
- package/src/gpu/kernels/backward/conv2d_backward_input.wgsl +83 -0
- package/src/gpu/kernels/backward/conv2d_backward_weight.wgsl +70 -0
- package/src/gpu/kernels/backward/cross_entropy_backward.d.ts +23 -0
- package/src/gpu/kernels/backward/cross_entropy_backward.js +29 -0
- package/src/gpu/kernels/backward/cross_entropy_backward.wgsl +39 -0
- package/src/gpu/kernels/backward/embed_backward.d.ts +29 -0
- package/src/gpu/kernels/backward/embed_backward.js +118 -0
- package/src/gpu/kernels/backward/embed_backward.wgsl +73 -0
- package/src/gpu/kernels/backward/gelu_backward.d.ts +16 -0
- package/src/gpu/kernels/backward/gelu_backward.js +39 -0
- package/src/gpu/kernels/backward/gelu_backward.wgsl +38 -0
- package/src/gpu/kernels/backward/groupnorm_backward.d.ts +24 -0
- package/src/gpu/kernels/backward/groupnorm_backward.js +29 -0
- package/src/gpu/kernels/backward/groupnorm_backward.wgsl +143 -0
- package/src/gpu/kernels/backward/index.d.ts +17 -0
- package/src/gpu/kernels/backward/index.js +23 -0
- package/src/gpu/kernels/backward/layernorm_backward.d.ts +22 -0
- package/src/gpu/kernels/backward/layernorm_backward.js +135 -0
- package/src/gpu/kernels/backward/layernorm_backward.wgsl +194 -0
- package/src/gpu/kernels/backward/matmul_backward.d.ts +32 -0
- package/src/gpu/kernels/backward/matmul_backward.js +124 -0
- package/src/gpu/kernels/backward/matmul_backward.wgsl +90 -0
- package/src/gpu/kernels/backward/matmul_transpose_a.wgsl +84 -0
- package/src/gpu/kernels/backward/pixel_shuffle_backward.d.ts +22 -0
- package/src/gpu/kernels/backward/pixel_shuffle_backward.js +30 -0
- package/src/gpu/kernels/backward/pixel_shuffle_backward.wgsl +54 -0
- package/src/gpu/kernels/backward/rmsnorm_backward.d.ts +24 -0
- package/src/gpu/kernels/backward/rmsnorm_backward.js +101 -0
- package/src/gpu/kernels/backward/rmsnorm_backward.wgsl +78 -0
- package/src/gpu/kernels/backward/rope_backward.d.ts +25 -0
- package/src/gpu/kernels/backward/rope_backward.js +109 -0
- package/src/gpu/kernels/backward/rope_backward.wgsl +59 -0
- package/src/gpu/kernels/backward/scale_backward.d.ts +16 -0
- package/src/gpu/kernels/backward/scale_backward.js +84 -0
- package/src/gpu/kernels/backward/scale_backward.wgsl +27 -0
- package/src/gpu/kernels/backward/silu_backward.d.ts +16 -0
- package/src/gpu/kernels/backward/silu_backward.js +39 -0
- package/src/gpu/kernels/backward/silu_backward.wgsl +31 -0
- package/src/gpu/kernels/backward/softmax_backward.d.ts +16 -0
- package/src/gpu/kernels/backward/softmax_backward.js +43 -0
- package/src/gpu/kernels/backward/softmax_backward.wgsl +44 -0
- package/src/gpu/kernels/backward/upsample2d_backward.d.ts +21 -0
- package/src/gpu/kernels/backward/upsample2d_backward.js +30 -0
- package/src/gpu/kernels/backward/upsample2d_backward.wgsl +59 -0
- package/src/gpu/kernels/backward/utils.d.ts +45 -0
- package/src/gpu/kernels/backward/utils.js +371 -0
- package/src/gpu/kernels/bf16_to_f16.wgsl +54 -0
- package/src/gpu/kernels/bf16_to_f32.wgsl +70 -0
- package/src/gpu/kernels/bias_add.wgsl +42 -0
- package/src/gpu/kernels/bias_add_f16.wgsl +47 -0
- package/src/gpu/kernels/cast.d.ts +67 -0
- package/src/gpu/kernels/cast.js +339 -0
- package/src/gpu/kernels/cast_f16_to_f32.wgsl +31 -0
- package/src/gpu/kernels/cast_f32_to_f16.wgsl +36 -0
- package/src/gpu/kernels/check-finiteness.d.ts +15 -0
- package/src/gpu/kernels/check-finiteness.js +149 -0
- package/src/gpu/kernels/check-stop.d.ts +31 -0
- package/src/gpu/kernels/check-stop.js +170 -0
- package/src/gpu/kernels/clamp.d.ts +22 -0
- package/src/gpu/kernels/clamp.js +42 -0
- package/src/gpu/kernels/clamp.wgsl +24 -0
- package/src/gpu/kernels/codegen/patches/attention_decode_f16.from.attention_decode.diff +213 -0
- package/src/gpu/kernels/codegen/patches/attention_decode_f16kv.from.attention_decode.diff +89 -0
- package/src/gpu/kernels/codegen/patches/attention_f16.from.attention.diff +258 -0
- package/src/gpu/kernels/codegen/patches/attention_f16kv.from.attention.diff +114 -0
- package/src/gpu/kernels/codegen/patches/attention_small_f16.from.attention_small.diff +193 -0
- package/src/gpu/kernels/codegen/patches/attention_small_f16kv.from.attention_small.diff +264 -0
- package/src/gpu/kernels/codegen/patches/attention_streaming_f16.from.attention_streaming.diff +109 -0
- package/src/gpu/kernels/codegen/patches/attention_streaming_f16kv.from.attention_streaming.diff +53 -0
- package/src/gpu/kernels/codegen/patches/bias_add_f16.from.bias_add.diff +54 -0
- package/src/gpu/kernels/codegen/patches/dequant_mxfp4_expert_f16.from.dequant_mxfp4_expert.diff +125 -0
- package/src/gpu/kernels/codegen/patches/fused_ffn_f16.from.fused_ffn.diff +428 -0
- package/src/gpu/kernels/codegen/patches/fused_matmul_q4_batched_f16.from.fused_matmul_q4_batched.diff +114 -0
- package/src/gpu/kernels/codegen/patches/fused_matmul_rmsnorm_f16.from.fused_matmul_rmsnorm.diff +477 -0
- package/src/gpu/kernels/codegen/patches/fused_swiglu_f16.from.fused_swiglu.diff +60 -0
- package/src/gpu/kernels/codegen/patches/gelu_f16.from.gelu.diff +58 -0
- package/src/gpu/kernels/codegen/patches/layernorm_f16.from.layernorm.diff +82 -0
- package/src/gpu/kernels/codegen/patches/matmul_gemv_residual_f16.from.matmul_gemv_residual.diff +87 -0
- package/src/gpu/kernels/codegen/patches/moe_gather_f16.from.moe_gather.diff +181 -0
- package/src/gpu/kernels/codegen/patches/residual_f16.from.residual.diff +62 -0
- package/src/gpu/kernels/codegen/patches/rmsnorm_f16.from.rmsnorm.diff +430 -0
- package/src/gpu/kernels/codegen/patches/rope_f16.from.rope.diff +462 -0
- package/src/gpu/kernels/codegen/patches/sample_f16.from.sample.diff +307 -0
- package/src/gpu/kernels/codegen/patches/scatter_add_dynamic_f16.from.scatter_add_dynamic.diff +65 -0
- package/src/gpu/kernels/codegen/patches/silu_f16.from.silu.diff +81 -0
- package/src/gpu/kernels/codegen/patches/topk_f16.from.topk.diff +231 -0
- package/src/gpu/kernels/codegen/wgsl-patch-variants.js +152 -0
- package/src/gpu/kernels/codegen/wgsl-variants.js +733 -0
- package/src/gpu/kernels/constants.d.ts +168 -0
- package/src/gpu/kernels/constants.js +142 -0
- package/src/gpu/kernels/conv2d.d.ts +34 -0
- package/src/gpu/kernels/conv2d.js +91 -0
- package/src/gpu/kernels/conv2d.wgsl +70 -0
- package/src/gpu/kernels/conv2d_f16.wgsl +72 -0
- package/src/gpu/kernels/cross_entropy_loss.d.ts +21 -0
- package/src/gpu/kernels/cross_entropy_loss.js +60 -0
- package/src/gpu/kernels/cross_entropy_loss.wgsl +39 -0
- package/src/gpu/kernels/depthwise_conv2d.d.ts +29 -0
- package/src/gpu/kernels/depthwise_conv2d.js +109 -0
- package/src/gpu/kernels/depthwise_conv2d.wgsl +55 -0
- package/src/gpu/kernels/depthwise_conv2d_f16.wgsl +59 -0
- package/src/gpu/kernels/dequant.d.ts +108 -0
- package/src/gpu/kernels/dequant.js +575 -0
- package/src/gpu/kernels/dequant_f16_out.wgsl +153 -0
- package/src/gpu/kernels/dequant_f16_out_vec4.wgsl +152 -0
- package/src/gpu/kernels/dequant_f16_rowwise.wgsl +139 -0
- package/src/gpu/kernels/dequant_f32_rowwise.wgsl +133 -0
- package/src/gpu/kernels/dequant_mxfp4.wgsl +120 -0
- package/src/gpu/kernels/dequant_mxfp4_expert.wgsl +129 -0
- package/src/gpu/kernels/dequant_mxfp4_expert_f16.wgsl +105 -0
- package/src/gpu/kernels/dequant_mxfp4_vec4.wgsl +116 -0
- package/src/gpu/kernels/dequant_q6k.wgsl +140 -0
- package/src/gpu/kernels/dequant_q8_0.wgsl +98 -0
- package/src/gpu/kernels/dequant_shared.wgsl +200 -0
- package/src/gpu/kernels/dequant_shared_vec4.wgsl +160 -0
- package/src/gpu/kernels/dequant_subgroup.wgsl +206 -0
- package/src/gpu/kernels/dispatch.d.ts +157 -0
- package/src/gpu/kernels/dispatch.js +235 -0
- package/src/gpu/kernels/energy.d.ts +113 -0
- package/src/gpu/kernels/energy.js +448 -0
- package/src/gpu/kernels/energy_eval.wgsl +26 -0
- package/src/gpu/kernels/energy_eval_f16.wgsl +30 -0
- package/src/gpu/kernels/energy_quintel_grad.wgsl +92 -0
- package/src/gpu/kernels/energy_quintel_grad_f16.wgsl +96 -0
- package/src/gpu/kernels/energy_quintel_reduce.wgsl +112 -0
- package/src/gpu/kernels/energy_quintel_reduce_f16.wgsl +116 -0
- package/src/gpu/kernels/energy_quintel_update.wgsl +92 -0
- package/src/gpu/kernels/energy_quintel_update_f16.wgsl +96 -0
- package/src/gpu/kernels/energy_update.wgsl +25 -0
- package/src/gpu/kernels/energy_update_f16.wgsl +30 -0
- package/src/gpu/kernels/feature-check.d.ts +42 -0
- package/src/gpu/kernels/feature-check.js +70 -0
- package/src/gpu/kernels/fused_ffn.d.ts +65 -0
- package/src/gpu/kernels/fused_ffn.js +326 -0
- package/src/gpu/kernels/fused_ffn.wgsl +420 -0
- package/src/gpu/kernels/fused_ffn_f16.wgsl +213 -0
- package/src/gpu/kernels/fused_ffn_q4k.wgsl +375 -0
- package/src/gpu/kernels/fused_matmul_q4.wgsl +404 -0
- package/src/gpu/kernels/fused_matmul_q4_batched.wgsl +194 -0
- package/src/gpu/kernels/fused_matmul_q4_batched_f16.wgsl +170 -0
- package/src/gpu/kernels/fused_matmul_q4_batched_f16a.wgsl +154 -0
- package/src/gpu/kernels/fused_matmul_q4_f16a.wgsl +219 -0
- package/src/gpu/kernels/fused_matmul_q4_multicol_f16.wgsl +216 -0
- package/src/gpu/kernels/fused_matmul_q4_multicol_f16a.wgsl +204 -0
- package/src/gpu/kernels/fused_matmul_residual.d.ts +46 -0
- package/src/gpu/kernels/fused_matmul_residual.js +175 -0
- package/src/gpu/kernels/fused_matmul_rmsnorm.d.ts +64 -0
- package/src/gpu/kernels/fused_matmul_rmsnorm.js +290 -0
- package/src/gpu/kernels/fused_matmul_rmsnorm.wgsl +324 -0
- package/src/gpu/kernels/fused_matmul_rmsnorm_f16.wgsl +303 -0
- package/src/gpu/kernels/fused_swiglu.wgsl +63 -0
- package/src/gpu/kernels/fused_swiglu_f16.wgsl +57 -0
- package/src/gpu/kernels/gated-short-conv.d.ts +63 -0
- package/src/gpu/kernels/gated-short-conv.js +284 -0
- package/src/gpu/kernels/gather.d.ts +64 -0
- package/src/gpu/kernels/gather.js +137 -0
- package/src/gpu/kernels/gather.wgsl +61 -0
- package/src/gpu/kernels/gather_f16.wgsl +65 -0
- package/src/gpu/kernels/gather_f16_f16_out.wgsl +55 -0
- package/src/gpu/kernels/gather_f16_out.wgsl +55 -0
- package/src/gpu/kernels/gather_f16_vec4.wgsl +76 -0
- package/src/gpu/kernels/gather_f16_vec4_f16_out.wgsl +68 -0
- package/src/gpu/kernels/gather_vec4.wgsl +74 -0
- package/src/gpu/kernels/gather_vec4_f16_out.wgsl +68 -0
- package/src/gpu/kernels/gelu.d.ts +33 -0
- package/src/gpu/kernels/gelu.js +55 -0
- package/src/gpu/kernels/gelu.wgsl +64 -0
- package/src/gpu/kernels/gelu_f16.wgsl +66 -0
- package/src/gpu/kernels/gptoss_mxfp4_expert_fused.wgsl +127 -0
- package/src/gpu/kernels/gptoss_router_topk.wgsl +119 -0
- package/src/gpu/kernels/grouped_pointwise_conv2d.d.ts +27 -0
- package/src/gpu/kernels/grouped_pointwise_conv2d.js +103 -0
- package/src/gpu/kernels/grouped_pointwise_conv2d.wgsl +44 -0
- package/src/gpu/kernels/grouped_pointwise_conv2d_f16.wgsl +48 -0
- package/src/gpu/kernels/groupnorm.d.ts +31 -0
- package/src/gpu/kernels/groupnorm.js +102 -0
- package/src/gpu/kernels/groupnorm_apply.wgsl +41 -0
- package/src/gpu/kernels/groupnorm_apply_f16.wgsl +46 -0
- package/src/gpu/kernels/groupnorm_stats.wgsl +76 -0
- package/src/gpu/kernels/groupnorm_stats_f16.wgsl +79 -0
- package/src/gpu/kernels/index.d.ts +374 -0
- package/src/gpu/kernels/index.js +315 -0
- package/src/gpu/kernels/kernel-base.d.ts +33 -0
- package/src/gpu/kernels/kernel-base.js +46 -0
- package/src/gpu/kernels/kernel-configs.d.ts +65 -0
- package/src/gpu/kernels/kernel-configs.js +60 -0
- package/src/gpu/kernels/kernel-tuning.d.ts +42 -0
- package/src/gpu/kernels/kernel-tuning.js +158 -0
- package/src/gpu/kernels/kv-quantize.d.ts +37 -0
- package/src/gpu/kernels/kv-quantize.js +141 -0
- package/src/gpu/kernels/kv_quantize_int4.wgsl +119 -0
- package/src/gpu/kernels/kv_quantize_int8.wgsl +119 -0
- package/src/gpu/kernels/layernorm.d.ts +37 -0
- package/src/gpu/kernels/layernorm.js +96 -0
- package/src/gpu/kernels/layernorm.wgsl +121 -0
- package/src/gpu/kernels/layernorm_f16.wgsl +103 -0
- package/src/gpu/kernels/linear-attention-core.d.ts +39 -0
- package/src/gpu/kernels/linear-attention-core.js +559 -0
- package/src/gpu/kernels/logit-merge.d.ts +110 -0
- package/src/gpu/kernels/logit-merge.js +394 -0
- package/src/gpu/kernels/matmul-dispatch.d.ts +38 -0
- package/src/gpu/kernels/matmul-dispatch.js +156 -0
- package/src/gpu/kernels/matmul-selection.d.ts +87 -0
- package/src/gpu/kernels/matmul-selection.js +518 -0
- package/src/gpu/kernels/matmul.d.ts +114 -0
- package/src/gpu/kernels/matmul.js +384 -0
- package/src/gpu/kernels/matmul_f16.wgsl +170 -0
- package/src/gpu/kernels/matmul_f16_tiled.wgsl +165 -0
- package/src/gpu/kernels/matmul_f16w_f32a.wgsl +89 -0
- package/src/gpu/kernels/matmul_f16w_f32a_tiled.wgsl +154 -0
- package/src/gpu/kernels/matmul_f32.wgsl +100 -0
- package/src/gpu/kernels/matmul_gemv.wgsl +80 -0
- package/src/gpu/kernels/matmul_gemv_f16a.wgsl +81 -0
- package/src/gpu/kernels/matmul_gemv_residual.wgsl +119 -0
- package/src/gpu/kernels/matmul_gemv_residual_f16.wgsl +78 -0
- package/src/gpu/kernels/matmul_gemv_subgroup.wgsl +429 -0
- package/src/gpu/kernels/matmul_gemv_subgroup_f16a.wgsl +674 -0
- package/src/gpu/kernels/modulate.d.ts +29 -0
- package/src/gpu/kernels/modulate.js +57 -0
- package/src/gpu/kernels/modulate.wgsl +40 -0
- package/src/gpu/kernels/modulate_f16.wgsl +43 -0
- package/src/gpu/kernels/moe.d.ts +164 -0
- package/src/gpu/kernels/moe.js +542 -0
- package/src/gpu/kernels/moe_gather.wgsl +170 -0
- package/src/gpu/kernels/moe_gather_f16.wgsl +82 -0
- package/src/gpu/kernels/moe_gather_vec4.wgsl +74 -0
- package/src/gpu/kernels/moe_offsets.wgsl +48 -0
- package/src/gpu/kernels/pipeline-cache.d.ts +88 -0
- package/src/gpu/kernels/pipeline-cache.js +305 -0
- package/src/gpu/kernels/pixel_shuffle.d.ts +27 -0
- package/src/gpu/kernels/pixel_shuffle.js +57 -0
- package/src/gpu/kernels/pixel_shuffle.wgsl +43 -0
- package/src/gpu/kernels/pixel_shuffle_f16.wgsl +46 -0
- package/src/gpu/kernels/relu.d.ts +18 -0
- package/src/gpu/kernels/relu.js +66 -0
- package/src/gpu/kernels/relu.wgsl +22 -0
- package/src/gpu/kernels/relu_f16.wgsl +24 -0
- package/src/gpu/kernels/rep-penalty.js +103 -0
- package/src/gpu/kernels/rep_penalty.wgsl +57 -0
- package/src/gpu/kernels/rep_penalty_f16.wgsl +54 -0
- package/src/gpu/kernels/repeat_channels.d.ts +21 -0
- package/src/gpu/kernels/repeat_channels.js +68 -0
- package/src/gpu/kernels/repeat_channels.wgsl +28 -0
- package/src/gpu/kernels/repeat_channels_f16.wgsl +30 -0
- package/src/gpu/kernels/residual.d.ts +74 -0
- package/src/gpu/kernels/residual.js +173 -0
- package/src/gpu/kernels/residual.wgsl +56 -0
- package/src/gpu/kernels/residual_f16.wgsl +36 -0
- package/src/gpu/kernels/residual_f16_vec4.wgsl +48 -0
- package/src/gpu/kernels/residual_vec4.wgsl +47 -0
- package/src/gpu/kernels/rmsnorm.d.ts +53 -0
- package/src/gpu/kernels/rmsnorm.js +256 -0
- package/src/gpu/kernels/rmsnorm.wgsl +449 -0
- package/src/gpu/kernels/rmsnorm_f16.wgsl +198 -0
- package/src/gpu/kernels/rope.d.ts +50 -0
- package/src/gpu/kernels/rope.js +91 -0
- package/src/gpu/kernels/rope.wgsl +344 -0
- package/src/gpu/kernels/rope_f16.wgsl +271 -0
- package/src/gpu/kernels/rule-matcher.d.ts +30 -0
- package/src/gpu/kernels/rule-matcher.js +42 -0
- package/src/gpu/kernels/rule-registry.d.ts +7 -0
- package/src/gpu/kernels/rule-registry.js +54 -0
- package/src/gpu/kernels/sample.d.ts +75 -0
- package/src/gpu/kernels/sample.js +565 -0
- package/src/gpu/kernels/sample.wgsl +407 -0
- package/src/gpu/kernels/sample_f16.wgsl +363 -0
- package/src/gpu/kernels/sana_linear_attention.d.ts +27 -0
- package/src/gpu/kernels/sana_linear_attention.js +129 -0
- package/src/gpu/kernels/sana_linear_attention_apply.wgsl +43 -0
- package/src/gpu/kernels/sana_linear_attention_apply_f16.wgsl +46 -0
- package/src/gpu/kernels/sana_linear_attention_summary.wgsl +51 -0
- package/src/gpu/kernels/sana_linear_attention_summary_f16.wgsl +53 -0
- package/src/gpu/kernels/scale.d.ts +35 -0
- package/src/gpu/kernels/scale.js +44 -0
- package/src/gpu/kernels/scale.wgsl +38 -0
- package/src/gpu/kernels/scatter_add.wgsl +88 -0
- package/src/gpu/kernels/scatter_add_dynamic.wgsl +59 -0
- package/src/gpu/kernels/scatter_add_dynamic_f16.wgsl +52 -0
- package/src/gpu/kernels/scatter_add_dynamic_f16_weights.wgsl +50 -0
- package/src/gpu/kernels/scatter_add_vec4.wgsl +70 -0
- package/src/gpu/kernels/shader-cache.d.ts +56 -0
- package/src/gpu/kernels/shader-cache.js +234 -0
- package/src/gpu/kernels/silu.d.ts +76 -0
- package/src/gpu/kernels/silu.js +406 -0
- package/src/gpu/kernels/silu.wgsl +109 -0
- package/src/gpu/kernels/silu_f16.wgsl +108 -0
- package/src/gpu/kernels/softmax.d.ts +57 -0
- package/src/gpu/kernels/softmax.js +125 -0
- package/src/gpu/kernels/softmax.wgsl +388 -0
- package/src/gpu/kernels/softmax_subgroup.wgsl +175 -0
- package/src/gpu/kernels/split_qg.d.ts +50 -0
- package/src/gpu/kernels/split_qg.js +46 -0
- package/src/gpu/kernels/split_qg.wgsl +58 -0
- package/src/gpu/kernels/split_qg_f16.wgsl +62 -0
- package/src/gpu/kernels/split_qkv.d.ts +51 -0
- package/src/gpu/kernels/split_qkv.js +51 -0
- package/src/gpu/kernels/split_qkv.wgsl +71 -0
- package/src/gpu/kernels/split_qkv_f16.wgsl +75 -0
- package/src/gpu/kernels/topk.wgsl +243 -0
- package/src/gpu/kernels/topk_f16.wgsl +108 -0
- package/src/gpu/kernels/topk_f16_weights.wgsl +101 -0
- package/src/gpu/kernels/transpose.d.ts +21 -0
- package/src/gpu/kernels/transpose.js +51 -0
- package/src/gpu/kernels/transpose.wgsl +33 -0
- package/src/gpu/kernels/types.d.ts +21 -0
- package/src/gpu/kernels/types.js +4 -0
- package/src/gpu/kernels/uniform-utils.d.ts +48 -0
- package/src/gpu/kernels/uniform-utils.js +94 -0
- package/src/gpu/kernels/upsample2d.d.ts +25 -0
- package/src/gpu/kernels/upsample2d.js +67 -0
- package/src/gpu/kernels/upsample2d.wgsl +34 -0
- package/src/gpu/kernels/upsample2d_f16.wgsl +38 -0
- package/src/gpu/kernels/utils.d.ts +106 -0
- package/src/gpu/kernels/utils.js +257 -0
- package/src/gpu/multi-model-recorder.d.ts +21 -0
- package/src/gpu/multi-model-recorder.js +31 -0
- package/src/gpu/partitioned-buffer-pool.d.ts +28 -0
- package/src/gpu/partitioned-buffer-pool.js +57 -0
- package/src/gpu/perf-guards.d.ts +25 -0
- package/src/gpu/perf-guards.js +133 -0
- package/src/gpu/profiler.d.ts +114 -0
- package/src/gpu/profiler.js +406 -0
- package/src/gpu/readback-utils.d.ts +16 -0
- package/src/gpu/readback-utils.js +41 -0
- package/src/gpu/submit-tracker.d.ts +111 -0
- package/src/gpu/submit-tracker.js +242 -0
- package/src/gpu/tensor.d.ts +69 -0
- package/src/gpu/tensor.js +75 -0
- package/src/gpu/uniform-cache.d.ts +109 -0
- package/src/gpu/uniform-cache.js +263 -0
- package/src/gpu/weight-buffer.d.ts +121 -0
- package/src/gpu/weight-buffer.js +132 -0
- package/src/hotswap/intent-bundle.d.ts +37 -0
- package/src/hotswap/intent-bundle.js +129 -0
- package/src/hotswap/manifest.d.ts +42 -0
- package/src/hotswap/manifest.js +124 -0
- package/src/hotswap/model-swap.js +42 -0
- package/src/hotswap/runtime.d.ts +31 -0
- package/src/hotswap/runtime.js +150 -0
- package/src/index-browser.d.ts +92 -0
- package/src/index-browser.js +68 -0
- package/src/index-internal.d.ts +2 -0
- package/src/index-internal.js +2 -0
- package/src/index.d.ts +103 -0
- package/src/index.js +76 -0
- package/src/inference/README.md +593 -0
- package/src/inference/browser-harness-contract-helpers.d.ts +5 -0
- package/src/inference/browser-harness-contract-helpers.js +26 -0
- package/src/inference/browser-harness-diffusion-energy-suites.d.ts +2 -0
- package/src/inference/browser-harness-diffusion-energy-suites.js +269 -0
- package/src/inference/browser-harness-model-helpers.d.ts +16 -0
- package/src/inference/browser-harness-model-helpers.js +217 -0
- package/src/inference/browser-harness-report-helpers.d.ts +7 -0
- package/src/inference/browser-harness-report-helpers.js +42 -0
- package/src/inference/browser-harness-runtime-helpers.d.ts +61 -0
- package/src/inference/browser-harness-runtime-helpers.js +416 -0
- package/src/inference/browser-harness-suite-helpers.d.ts +28 -0
- package/src/inference/browser-harness-suite-helpers.js +270 -0
- package/src/inference/browser-harness-text-helpers.d.ts +34 -0
- package/src/inference/browser-harness-text-helpers.js +879 -0
- package/src/inference/browser-harness.d.ts +249 -0
- package/src/inference/browser-harness.js +1150 -0
- package/src/inference/decode-buffers.d.ts +108 -0
- package/src/inference/decode-buffers.js +181 -0
- package/src/inference/decode-ring.d.ts +52 -0
- package/src/inference/decode-ring.js +273 -0
- package/src/inference/expert-router.d.ts +27 -0
- package/src/inference/expert-router.js +55 -0
- package/src/inference/fixtures/embedding-semantic-fixtures.json +382 -0
- package/src/inference/functiongemma.d.ts +15 -0
- package/src/inference/functiongemma.js +1 -0
- package/src/inference/kv-cache/base.d.ts +150 -0
- package/src/inference/kv-cache/base.js +1105 -0
- package/src/inference/kv-cache/basis-decomposed-paged.d.ts +50 -0
- package/src/inference/kv-cache/basis-decomposed-paged.js +276 -0
- package/src/inference/kv-cache/index.d.ts +35 -0
- package/src/inference/kv-cache/index.js +20 -0
- package/src/inference/kv-cache/sliding-window.d.ts +72 -0
- package/src/inference/kv-cache/sliding-window.js +243 -0
- package/src/inference/kv-cache/tiered.d.ts +89 -0
- package/src/inference/kv-cache/tiered.js +576 -0
- package/src/inference/kv-cache/types.d.ts +188 -0
- package/src/inference/kv-cache/types.js +80 -0
- package/src/inference/kv-cache.d.ts +36 -0
- package/src/inference/kv-cache.js +18 -0
- package/src/inference/moe-router.d.ts +212 -0
- package/src/inference/moe-router.js +600 -0
- package/src/inference/multi-model-network.d.ts +139 -0
- package/src/inference/multi-model-network.js +771 -0
- package/src/inference/multi-pipeline-pool.d.ts +62 -0
- package/src/inference/multi-pipeline-pool.js +161 -0
- package/src/inference/network-evolution.d.ts +55 -0
- package/src/inference/network-evolution.js +79 -0
- package/src/inference/pipelines/context.d.ts +21 -0
- package/src/inference/pipelines/context.js +184 -0
- package/src/inference/pipelines/diffusion/helpers.d.ts +29 -0
- package/src/inference/pipelines/diffusion/helpers.js +120 -0
- package/src/inference/pipelines/diffusion/index.d.ts +3 -0
- package/src/inference/pipelines/diffusion/index.js +3 -0
- package/src/inference/pipelines/diffusion/init.d.ts +24 -0
- package/src/inference/pipelines/diffusion/init.js +138 -0
- package/src/inference/pipelines/diffusion/pipeline.d.ts +38 -0
- package/src/inference/pipelines/diffusion/pipeline.js +782 -0
- package/src/inference/pipelines/diffusion/sana-transformer.d.ts +53 -0
- package/src/inference/pipelines/diffusion/sana-transformer.js +738 -0
- package/src/inference/pipelines/diffusion/scheduler.d.ts +35 -0
- package/src/inference/pipelines/diffusion/scheduler.js +153 -0
- package/src/inference/pipelines/diffusion/sd3-transformer.d.ts +20 -0
- package/src/inference/pipelines/diffusion/sd3-transformer.js +1194 -0
- package/src/inference/pipelines/diffusion/sd3-weights.d.ts +21 -0
- package/src/inference/pipelines/diffusion/sd3-weights.js +287 -0
- package/src/inference/pipelines/diffusion/text-encoder-gpu.d.ts +87 -0
- package/src/inference/pipelines/diffusion/text-encoder-gpu.js +1224 -0
- package/src/inference/pipelines/diffusion/text-encoder.d.ts +29 -0
- package/src/inference/pipelines/diffusion/text-encoder.js +195 -0
- package/src/inference/pipelines/diffusion/types.d.ts +116 -0
- package/src/inference/pipelines/diffusion/types.js +1 -0
- package/src/inference/pipelines/diffusion/vae.d.ts +20 -0
- package/src/inference/pipelines/diffusion/vae.js +1375 -0
- package/src/inference/pipelines/diffusion/weights.d.ts +40 -0
- package/src/inference/pipelines/diffusion/weights.js +155 -0
- package/src/inference/pipelines/dream/energy-head-pipeline.d.ts +29 -0
- package/src/inference/pipelines/dream/energy-head-pipeline.js +6 -0
- package/src/inference/pipelines/dream/pipeline.d.ts +17 -0
- package/src/inference/pipelines/dream/pipeline.js +8 -0
- package/src/inference/pipelines/energy/index.d.ts +1 -0
- package/src/inference/pipelines/energy/index.js +1 -0
- package/src/inference/pipelines/energy/pipeline.d.ts +27 -0
- package/src/inference/pipelines/energy/pipeline.js +697 -0
- package/src/inference/pipelines/energy/quintel.d.ts +92 -0
- package/src/inference/pipelines/energy/quintel.js +218 -0
- package/src/inference/pipelines/energy/types.d.ts +63 -0
- package/src/inference/pipelines/energy/types.js +1 -0
- package/src/inference/pipelines/energy-head/index.d.ts +6 -0
- package/src/inference/pipelines/energy-head/index.js +6 -0
- package/src/inference/pipelines/energy-head/row-head-pipeline.d.ts +103 -0
- package/src/inference/pipelines/energy-head/row-head-pipeline.js +491 -0
- package/src/inference/pipelines/factory.d.ts +10 -0
- package/src/inference/pipelines/factory.js +6 -0
- package/src/inference/pipelines/index.d.ts +22 -0
- package/src/inference/pipelines/index.js +19 -0
- package/src/inference/pipelines/registry.d.ts +15 -0
- package/src/inference/pipelines/registry.js +23 -0
- package/src/inference/pipelines/rng.d.ts +2 -0
- package/src/inference/pipelines/rng.js +17 -0
- package/src/inference/pipelines/structured/index.d.ts +8 -0
- package/src/inference/pipelines/structured/index.js +8 -0
- package/src/inference/pipelines/structured/json-head-pipeline.d.ts +58 -0
- package/src/inference/pipelines/structured/json-head-pipeline.js +196 -0
- package/src/inference/pipelines/text/attention/attn-config.d.ts +28 -0
- package/src/inference/pipelines/text/attention/attn-config.js +51 -0
- package/src/inference/pipelines/text/attention/dispatch-params.d.ts +148 -0
- package/src/inference/pipelines/text/attention/dispatch-params.js +251 -0
- package/src/inference/pipelines/text/attention/index.d.ts +24 -0
- package/src/inference/pipelines/text/attention/index.js +17 -0
- package/src/inference/pipelines/text/attention/output-projection.d.ts +12 -0
- package/src/inference/pipelines/text/attention/output-projection.js +8 -0
- package/src/inference/pipelines/text/attention/projections.d.ts +114 -0
- package/src/inference/pipelines/text/attention/projections.js +531 -0
- package/src/inference/pipelines/text/attention/record.d.ts +36 -0
- package/src/inference/pipelines/text/attention/record.js +523 -0
- package/src/inference/pipelines/text/attention/run.d.ts +38 -0
- package/src/inference/pipelines/text/attention/run.js +813 -0
- package/src/inference/pipelines/text/attention/types.d.ts +108 -0
- package/src/inference/pipelines/text/attention/types.js +67 -0
- package/src/inference/pipelines/text/attention.d.ts +23 -0
- package/src/inference/pipelines/text/attention.js +12 -0
- package/src/inference/pipelines/text/bdpa-steamroller.d.ts +22 -0
- package/src/inference/pipelines/text/bdpa-steamroller.js +158 -0
- package/src/inference/pipelines/text/buffer-types.d.ts +7 -0
- package/src/inference/pipelines/text/buffer-types.js +4 -0
- package/src/inference/pipelines/text/chat-format.d.ts +46 -0
- package/src/inference/pipelines/text/chat-format.js +365 -0
- package/src/inference/pipelines/text/config.d.ts +253 -0
- package/src/inference/pipelines/text/config.js +857 -0
- package/src/inference/pipelines/text/debug-utils/config.d.ts +144 -0
- package/src/inference/pipelines/text/debug-utils/config.js +156 -0
- package/src/inference/pipelines/text/debug-utils/index.d.ts +53 -0
- package/src/inference/pipelines/text/debug-utils/index.js +44 -0
- package/src/inference/pipelines/text/debug-utils/logging.d.ts +106 -0
- package/src/inference/pipelines/text/debug-utils/logging.js +152 -0
- package/src/inference/pipelines/text/debug-utils/tensor.d.ts +119 -0
- package/src/inference/pipelines/text/debug-utils/tensor.js +268 -0
- package/src/inference/pipelines/text/debug-utils/utils.d.ts +77 -0
- package/src/inference/pipelines/text/debug-utils/utils.js +139 -0
- package/src/inference/pipelines/text/debug-utils.d.ts +42 -0
- package/src/inference/pipelines/text/debug-utils.js +34 -0
- package/src/inference/pipelines/text/drift-policy.d.ts +57 -0
- package/src/inference/pipelines/text/drift-policy.js +133 -0
- package/src/inference/pipelines/text/dtype-contract.d.ts +38 -0
- package/src/inference/pipelines/text/dtype-contract.js +87 -0
- package/src/inference/pipelines/text/embed.d.ts +67 -0
- package/src/inference/pipelines/text/embed.js +490 -0
- package/src/inference/pipelines/text/execution-plan.d.ts +123 -0
- package/src/inference/pipelines/text/execution-plan.js +371 -0
- package/src/inference/pipelines/text/execution-runtime-builders.d.ts +45 -0
- package/src/inference/pipelines/text/execution-runtime-builders.js +382 -0
- package/src/inference/pipelines/text/execution-v1.d.ts +45 -0
- package/src/inference/pipelines/text/execution-v1.js +288 -0
- package/src/inference/pipelines/text/failure-reduction.d.ts +84 -0
- package/src/inference/pipelines/text/failure-reduction.js +180 -0
- package/src/inference/pipelines/text/ffn/dense.d.ts +40 -0
- package/src/inference/pipelines/text/ffn/dense.js +753 -0
- package/src/inference/pipelines/text/ffn/index.d.ts +23 -0
- package/src/inference/pipelines/text/ffn/index.js +16 -0
- package/src/inference/pipelines/text/ffn/moe.d.ts +21 -0
- package/src/inference/pipelines/text/ffn/moe.js +49 -0
- package/src/inference/pipelines/text/ffn/sandwich.d.ts +25 -0
- package/src/inference/pipelines/text/ffn/sandwich.js +196 -0
- package/src/inference/pipelines/text/ffn/standard.d.ts +23 -0
- package/src/inference/pipelines/text/ffn/standard.js +113 -0
- package/src/inference/pipelines/text/ffn/types.d.ts +30 -0
- package/src/inference/pipelines/text/ffn/types.js +25 -0
- package/src/inference/pipelines/text/ffn.d.ts +31 -0
- package/src/inference/pipelines/text/ffn.js +18 -0
- package/src/inference/pipelines/text/finiteness-guard-status.d.ts +11 -0
- package/src/inference/pipelines/text/finiteness-guard-status.js +21 -0
- package/src/inference/pipelines/text/finiteness-policy.d.ts +35 -0
- package/src/inference/pipelines/text/finiteness-policy.js +45 -0
- package/src/inference/pipelines/text/generator-helpers.d.ts +34 -0
- package/src/inference/pipelines/text/generator-helpers.js +178 -0
- package/src/inference/pipelines/text/generator-runtime.d.ts +95 -0
- package/src/inference/pipelines/text/generator-runtime.js +492 -0
- package/src/inference/pipelines/text/generator-steps.d.ts +136 -0
- package/src/inference/pipelines/text/generator-steps.js +1294 -0
- package/src/inference/pipelines/text/generator.d.ts +46 -0
- package/src/inference/pipelines/text/generator.js +1779 -0
- package/src/inference/pipelines/text/index.d.ts +5 -0
- package/src/inference/pipelines/text/index.js +6 -0
- package/src/inference/pipelines/text/init.d.ts +316 -0
- package/src/inference/pipelines/text/init.js +1187 -0
- package/src/inference/pipelines/text/kernel-trace.d.ts +152 -0
- package/src/inference/pipelines/text/kernel-trace.js +330 -0
- package/src/inference/pipelines/text/layer-plan.d.ts +65 -0
- package/src/inference/pipelines/text/layer-plan.js +249 -0
- package/src/inference/pipelines/text/layer.d.ts +56 -0
- package/src/inference/pipelines/text/layer.js +974 -0
- package/src/inference/pipelines/text/linear-attention.d.ts +109 -0
- package/src/inference/pipelines/text/linear-attention.js +948 -0
- package/src/inference/pipelines/text/logits/cpu.d.ts +81 -0
- package/src/inference/pipelines/text/logits/cpu.js +91 -0
- package/src/inference/pipelines/text/logits/gpu.d.ts +113 -0
- package/src/inference/pipelines/text/logits/gpu.js +419 -0
- package/src/inference/pipelines/text/logits/index.d.ts +62 -0
- package/src/inference/pipelines/text/logits/index.js +316 -0
- package/src/inference/pipelines/text/logits/types.d.ts +46 -0
- package/src/inference/pipelines/text/logits/types.js +4 -0
- package/src/inference/pipelines/text/logits/utils.d.ts +56 -0
- package/src/inference/pipelines/text/logits/utils.js +68 -0
- package/src/inference/pipelines/text/logits.d.ts +27 -0
- package/src/inference/pipelines/text/logits.js +16 -0
- package/src/inference/pipelines/text/lora-apply.d.ts +28 -0
- package/src/inference/pipelines/text/lora-apply.js +76 -0
- package/src/inference/pipelines/text/lora-types.d.ts +39 -0
- package/src/inference/pipelines/text/lora-types.js +18 -0
- package/src/inference/pipelines/text/lora.d.ts +18 -0
- package/src/inference/pipelines/text/lora.js +12 -0
- package/src/inference/pipelines/text/model-load.d.ts +58 -0
- package/src/inference/pipelines/text/model-load.js +778 -0
- package/src/inference/pipelines/text/moe-cache.d.ts +32 -0
- package/src/inference/pipelines/text/moe-cache.js +108 -0
- package/src/inference/pipelines/text/moe-cpu-gptoss.d.ts +9 -0
- package/src/inference/pipelines/text/moe-cpu-gptoss.js +115 -0
- package/src/inference/pipelines/text/moe-cpu.d.ts +13 -0
- package/src/inference/pipelines/text/moe-cpu.js +120 -0
- package/src/inference/pipelines/text/moe-gpu.d.ts +13 -0
- package/src/inference/pipelines/text/moe-gpu.js +653 -0
- package/src/inference/pipelines/text/moe-helpers.d.ts +12 -0
- package/src/inference/pipelines/text/moe-helpers.js +21 -0
- package/src/inference/pipelines/text/moe-impl.d.ts +117 -0
- package/src/inference/pipelines/text/moe-impl.js +9 -0
- package/src/inference/pipelines/text/moe-shape-validator.d.ts +40 -0
- package/src/inference/pipelines/text/moe-shape-validator.js +98 -0
- package/src/inference/pipelines/text/operator-events.d.ts +125 -0
- package/src/inference/pipelines/text/operator-events.js +305 -0
- package/src/inference/pipelines/text/operator-identity.d.ts +60 -0
- package/src/inference/pipelines/text/operator-identity.js +133 -0
- package/src/inference/pipelines/text/ops.d.ts +167 -0
- package/src/inference/pipelines/text/ops.js +437 -0
- package/src/inference/pipelines/text/probes.d.ts +31 -0
- package/src/inference/pipelines/text/probes.js +240 -0
- package/src/inference/pipelines/text/sampling-config.d.ts +54 -0
- package/src/inference/pipelines/text/sampling-config.js +71 -0
- package/src/inference/pipelines/text/sampling.d.ts +54 -0
- package/src/inference/pipelines/text/sampling.js +249 -0
- package/src/inference/pipelines/text/stage-names.d.ts +88 -0
- package/src/inference/pipelines/text/stage-names.js +202 -0
- package/src/inference/pipelines/text/state.d.ts +114 -0
- package/src/inference/pipelines/text/state.js +165 -0
- package/src/inference/pipelines/text/types.d.ts +682 -0
- package/src/inference/pipelines/text/types.js +4 -0
- package/src/inference/pipelines/text/weights.d.ts +110 -0
- package/src/inference/pipelines/text/weights.js +173 -0
- package/src/inference/pipelines/text.d.ts +162 -0
- package/src/inference/pipelines/text.js +852 -0
- package/src/inference/pipelines/vision/encoder.js +386 -0
- package/src/inference/pipelines/vision/image-preprocess.js +157 -0
- package/src/inference/pipelines/vision/index.js +173 -0
- package/src/inference/pipelines/vision/ops.js +78 -0
- package/src/inference/pipelines/vision/patch-embed.js +151 -0
- package/src/inference/speculative.d.ts +239 -0
- package/src/inference/speculative.js +402 -0
- package/src/inference/test-harness.d.ts +178 -0
- package/src/inference/test-harness.js +361 -0
- package/src/inference/tokenizer.d.ts +72 -0
- package/src/inference/tokenizer.js +251 -0
- package/src/inference/tokenizers/base.d.ts +39 -0
- package/src/inference/tokenizers/base.js +69 -0
- package/src/inference/tokenizers/bpe.d.ts +27 -0
- package/src/inference/tokenizers/bpe.js +180 -0
- package/src/inference/tokenizers/bundled.d.ts +63 -0
- package/src/inference/tokenizers/bundled.js +1009 -0
- package/src/inference/tokenizers/sentencepiece.d.ts +28 -0
- package/src/inference/tokenizers/sentencepiece.js +401 -0
- package/src/inference/tokenizers/types.d.ts +166 -0
- package/src/inference/tokenizers/types.js +7 -0
- package/src/loader/doppler-loader.d.ts +139 -0
- package/src/loader/doppler-loader.js +1103 -0
- package/src/loader/dtype-utils.d.ts +40 -0
- package/src/loader/dtype-utils.js +61 -0
- package/src/loader/embedding-loader.d.ts +56 -0
- package/src/loader/embedding-loader.js +211 -0
- package/src/loader/experts/expert-cache.d.ts +156 -0
- package/src/loader/experts/expert-cache.js +386 -0
- package/src/loader/experts/expert-loader.d.ts +108 -0
- package/src/loader/experts/expert-loader.js +392 -0
- package/src/loader/final-weights-loader.d.ts +88 -0
- package/src/loader/final-weights-loader.js +339 -0
- package/src/loader/index.d.ts +150 -0
- package/src/loader/index.js +124 -0
- package/src/loader/layer-loader.d.ts +63 -0
- package/src/loader/layer-loader.js +474 -0
- package/src/loader/loader-state.d.ts +51 -0
- package/src/loader/loader-state.js +142 -0
- package/src/loader/loader-types.d.ts +236 -0
- package/src/loader/loader-types.js +4 -0
- package/src/loader/manifest-config.d.ts +97 -0
- package/src/loader/manifest-config.js +134 -0
- package/src/loader/memory-monitor.d.ts +112 -0
- package/src/loader/memory-monitor.js +284 -0
- package/src/loader/multi-model-loader.d.ts +51 -0
- package/src/loader/multi-model-loader.js +133 -0
- package/src/loader/quantization-constants.d.ts +23 -0
- package/src/loader/quantization-constants.js +14 -0
- package/src/loader/shard-cache.d.ts +60 -0
- package/src/loader/shard-cache.js +663 -0
- package/src/loader/shard-resolver.d.ts +12 -0
- package/src/loader/shard-resolver.js +144 -0
- package/src/loader/tensors/tensor-loader.d.ts +157 -0
- package/src/loader/tensors/tensor-loader.js +652 -0
- package/src/loader/tensors/tensor-reader.d.ts +22 -0
- package/src/loader/tensors/tensor-reader.js +113 -0
- package/src/loader/tensors/tensor-role.d.ts +7 -0
- package/src/loader/tensors/tensor-role.js +12 -0
- package/src/loader/weight-downcast.d.ts +62 -0
- package/src/loader/weight-downcast.js +213 -0
- package/src/loader/weights.d.ts +22 -0
- package/src/loader/weights.js +4 -0
- package/src/memory/address-table.d.ts +104 -0
- package/src/memory/address-table.js +114 -0
- package/src/memory/buffer-pool.d.ts +204 -0
- package/src/memory/buffer-pool.js +867 -0
- package/src/memory/capability.d.ts +49 -0
- package/src/memory/capability.js +95 -0
- package/src/memory/heap-manager.d.ts +104 -0
- package/src/memory/heap-manager.js +264 -0
- package/src/memory/unified-detect.d.ts +59 -0
- package/src/memory/unified-detect.js +192 -0
- package/src/rules/converter/execution.rules.json +20 -0
- package/src/rules/converter/tensor-roles.rules.json +13 -0
- package/src/rules/converter/tokenizer.rules.json +7 -0
- package/src/rules/execution-rules-contract-check.d.ts +17 -0
- package/src/rules/execution-rules-contract-check.js +287 -0
- package/src/rules/inference/attention.rules.json +54 -0
- package/src/rules/inference/capability-transforms.rules.json +24 -0
- package/src/rules/inference/config.rules.json +57 -0
- package/src/rules/inference/dtype.rules.json +99 -0
- package/src/rules/inference/execution.rules.json +56 -0
- package/src/rules/inference/ffn.rules.json +35 -0
- package/src/rules/inference/layer-pattern.rules.json +16 -0
- package/src/rules/inference/layer.rules.json +7 -0
- package/src/rules/inference/moe.rules.json +48 -0
- package/src/rules/kernels/attention.rules.json +61 -0
- package/src/rules/kernels/conv2d.rules.json +6 -0
- package/src/rules/kernels/depthwise-conv2d.rules.json +6 -0
- package/src/rules/kernels/dequant.rules.json +58 -0
- package/src/rules/kernels/energy.rules.json +22 -0
- package/src/rules/kernels/fused-ffn.rules.json +13 -0
- package/src/rules/kernels/fused-matmul-residual.rules.json +6 -0
- package/src/rules/kernels/fused-matmul-rmsnorm.rules.json +8 -0
- package/src/rules/kernels/gather.rules.json +12 -0
- package/src/rules/kernels/gelu.rules.json +11 -0
- package/src/rules/kernels/grouped-pointwise-conv2d.rules.json +6 -0
- package/src/rules/kernels/groupnorm.rules.json +10 -0
- package/src/rules/kernels/kernel-validator.d.ts +24 -0
- package/src/rules/kernels/kernel-validator.js +160 -0
- package/src/rules/kernels/kv_quantize.rules.json +7 -0
- package/src/rules/kernels/layernorm.rules.json +6 -0
- package/src/rules/kernels/matmul.rules.json +60 -0
- package/src/rules/kernels/modulate.rules.json +6 -0
- package/src/rules/kernels/moe.rules.gptoss.json +105 -0
- package/src/rules/kernels/moe.rules.json +11 -0
- package/src/rules/kernels/moe.rules.mixtral.json +75 -0
- package/src/rules/kernels/pixel_shuffle.rules.json +6 -0
- package/src/rules/kernels/relu.rules.json +6 -0
- package/src/rules/kernels/repeat-channels.rules.json +6 -0
- package/src/rules/kernels/residual.rules.json +12 -0
- package/src/rules/kernels/rmsnorm.rules.json +11 -0
- package/src/rules/kernels/rope.rules.json +6 -0
- package/src/rules/kernels/sample.rules.json +6 -0
- package/src/rules/kernels/sana-linear-attention.rules.json +6 -0
- package/src/rules/kernels/scale.rules.json +6 -0
- package/src/rules/kernels/silu.rules.json +21 -0
- package/src/rules/kernels/softmax.rules.json +25 -0
- package/src/rules/kernels/split-qg.rules.json +6 -0
- package/src/rules/kernels/split-qkv.rules.json +6 -0
- package/src/rules/kernels/upsample2d.rules.json +6 -0
- package/src/rules/layer-pattern-contract-check.d.ts +17 -0
- package/src/rules/layer-pattern-contract-check.js +231 -0
- package/src/rules/loader/tensor-loader.rules.json +24 -0
- package/src/rules/loader/weights.rules.json +41 -0
- package/src/rules/rule-registry.d.ts +77 -0
- package/src/rules/rule-registry.js +264 -0
- package/src/rules/tooling/command-runtime.rules.json +65 -0
- package/src/storage/backends/idb-store.d.ts +52 -0
- package/src/storage/backends/idb-store.js +590 -0
- package/src/storage/backends/memory-store.d.ts +36 -0
- package/src/storage/backends/memory-store.js +242 -0
- package/src/storage/backends/opfs-store.d.ts +41 -0
- package/src/storage/backends/opfs-store.js +478 -0
- package/src/storage/blake3.d.ts +17 -0
- package/src/storage/blake3.js +269 -0
- package/src/storage/download-types.d.ts +157 -0
- package/src/storage/download-types.js +48 -0
- package/src/storage/downloader.d.ts +103 -0
- package/src/storage/downloader.js +1121 -0
- package/src/storage/emulated-vram.d.ts +264 -0
- package/src/storage/emulated-vram.js +576 -0
- package/src/storage/export.d.ts +20 -0
- package/src/storage/export.js +159 -0
- package/src/storage/index.d.ts +256 -0
- package/src/storage/index.js +188 -0
- package/src/storage/inventory.d.ts +26 -0
- package/src/storage/inventory.js +218 -0
- package/src/storage/preflight.d.ts +144 -0
- package/src/storage/preflight.js +316 -0
- package/src/storage/quickstart-downloader.d.ts +157 -0
- package/src/storage/quickstart-downloader.js +268 -0
- package/src/storage/quota.d.ts +150 -0
- package/src/storage/quota.js +305 -0
- package/src/storage/registry.d.ts +28 -0
- package/src/storage/registry.js +131 -0
- package/src/storage/reports.d.ts +20 -0
- package/src/storage/reports.js +94 -0
- package/src/storage/shard-manager.d.ts +151 -0
- package/src/storage/shard-manager.js +861 -0
- package/src/storage/source-artifact-store.d.ts +52 -0
- package/src/storage/source-artifact-store.js +234 -0
- package/src/sw.d.ts +1 -0
- package/src/sw.js +187 -0
- package/src/tooling/bench-runner.js +64 -0
- package/src/tooling/browser-command-runner.d.ts +28 -0
- package/src/tooling/browser-command-runner.js +85 -0
- package/src/tooling/command-api-constants.d.ts +9 -0
- package/src/tooling/command-api-constants.js +9 -0
- package/src/tooling/command-api-family-normalizers.d.ts +9 -0
- package/src/tooling/command-api-family-normalizers.js +395 -0
- package/src/tooling/command-api-helpers.d.ts +25 -0
- package/src/tooling/command-api-helpers.js +265 -0
- package/src/tooling/command-api.d.ts +177 -0
- package/src/tooling/command-api.js +82 -0
- package/src/tooling/command-envelope.d.ts +84 -0
- package/src/tooling/command-envelope.js +201 -0
- package/src/tooling/command-runner-shared.d.ts +75 -0
- package/src/tooling/command-runner-shared.js +191 -0
- package/src/tooling/command-runner.html +45 -0
- package/src/tooling/command-validation.js +44 -0
- package/src/tooling/conversion-config-materializer.d.ts +24 -0
- package/src/tooling/conversion-config-materializer.js +96 -0
- package/src/tooling/diagnose-runner.d.ts +28 -0
- package/src/tooling/diagnose-runner.js +333 -0
- package/src/tooling/distill-runner.js +56 -0
- package/src/tooling/hf-registry-utils.d.ts +59 -0
- package/src/tooling/hf-registry-utils.js +324 -0
- package/src/tooling/kernel-path-builder/custom-runtime-facts.d.ts +18 -0
- package/src/tooling/kernel-path-builder/custom-runtime-facts.js +72 -0
- package/src/tooling/kernel-path-builder/index.d.ts +65 -0
- package/src/tooling/kernel-path-builder/index.js +1348 -0
- package/src/tooling/kernel-path-builder/runtime-overlay.d.ts +9 -0
- package/src/tooling/kernel-path-builder/runtime-overlay.js +149 -0
- package/src/tooling/lean-execution-contract-runner.d.ts +43 -0
- package/src/tooling/lean-execution-contract-runner.js +158 -0
- package/src/tooling/lean-execution-contract.d.ts +16 -0
- package/src/tooling/lean-execution-contract.js +228 -0
- package/src/tooling/lora-runner.js +37 -0
- package/src/tooling/node-browser-command-runner.d.ts +34 -0
- package/src/tooling/node-browser-command-runner.js +827 -0
- package/src/tooling/node-command-runner.d.ts +36 -0
- package/src/tooling/node-command-runner.js +187 -0
- package/src/tooling/node-convert-worker-pool.d.ts +16 -0
- package/src/tooling/node-convert-worker-pool.js +186 -0
- package/src/tooling/node-convert-worker.d.ts +1 -0
- package/src/tooling/node-convert-worker.js +60 -0
- package/src/tooling/node-converter.d.ts +1 -0
- package/src/tooling/node-converter.js +1330 -0
- package/src/tooling/node-file-fetch.d.ts +1 -0
- package/src/tooling/node-file-fetch.js +38 -0
- package/src/tooling/node-source-runtime.d.ts +19 -0
- package/src/tooling/node-source-runtime.js +612 -0
- package/src/tooling/node-webgpu.d.ts +16 -0
- package/src/tooling/node-webgpu.js +421 -0
- package/src/tooling/opfs-cache.d.ts +12 -0
- package/src/tooling/opfs-cache.js +260 -0
- package/src/tooling/runtime-input-composition.d.ts +38 -0
- package/src/tooling/runtime-input-composition.js +90 -0
- package/src/tooling/source-runtime-bundle.d.ts +141 -0
- package/src/tooling/source-runtime-bundle.js +712 -0
- package/src/tooling/source-runtime-materializer.d.ts +6 -0
- package/src/tooling/source-runtime-materializer.js +93 -0
- package/src/tooling/verify-runner.js +63 -0
- package/src/tooling-exports.browser.d.ts +7 -0
- package/src/tooling-exports.browser.js +2 -0
- package/src/tooling-exports.d.ts +22 -0
- package/src/tooling-exports.js +7 -0
- package/src/tooling-exports.shared.d.ts +106 -0
- package/src/tooling-exports.shared.js +93 -0
- package/src/training/README.md +153 -0
- package/src/training/artifacts.d.ts +160 -0
- package/src/training/artifacts.js +896 -0
- package/src/training/attention-backward.d.ts +30 -0
- package/src/training/attention-backward.js +232 -0
- package/src/training/attention-forward.d.ts +22 -0
- package/src/training/attention-forward.js +82 -0
- package/src/training/autograd.d.ts +51 -0
- package/src/training/autograd.js +408 -0
- package/src/training/backward-kernels.js +39 -0
- package/src/training/checkpoint-watch.d.ts +8 -0
- package/src/training/checkpoint-watch.js +139 -0
- package/src/training/checkpoint.d.ts +36 -0
- package/src/training/checkpoint.js +281 -0
- package/src/training/clip.d.ts +9 -0
- package/src/training/clip.js +55 -0
- package/src/training/dataloader.d.ts +8 -0
- package/src/training/dataloader.js +44 -0
- package/src/training/datasets/index.d.ts +12 -0
- package/src/training/datasets/index.js +6 -0
- package/src/training/datasets/jsonl.d.ts +11 -0
- package/src/training/datasets/jsonl.js +50 -0
- package/src/training/datasets/reploid.d.ts +3 -0
- package/src/training/datasets/reploid.js +36 -0
- package/src/training/datasets/text-pairs.d.ts +21 -0
- package/src/training/datasets/text-pairs.js +42 -0
- package/src/training/datasets/token-batch.d.ts +21 -0
- package/src/training/datasets/token-batch.js +52 -0
- package/src/training/datasets/translation-pairs.d.ts +34 -0
- package/src/training/datasets/translation-pairs.js +49 -0
- package/src/training/distillation/artifacts.d.ts +71 -0
- package/src/training/distillation/artifacts.js +132 -0
- package/src/training/distillation/checkpoint-watch.d.ts +10 -0
- package/src/training/distillation/checkpoint-watch.js +58 -0
- package/src/training/distillation/dataset.d.ts +59 -0
- package/src/training/distillation/dataset.js +337 -0
- package/src/training/distillation/eval.d.ts +34 -0
- package/src/training/distillation/eval.js +313 -0
- package/src/training/distillation/index.d.ts +29 -0
- package/src/training/distillation/index.js +29 -0
- package/src/training/distillation/runtime.d.ts +20 -0
- package/src/training/distillation/runtime.js +121 -0
- package/src/training/distillation/scoreboard.d.ts +6 -0
- package/src/training/distillation/scoreboard.js +8 -0
- package/src/training/distillation/stage-a.d.ts +45 -0
- package/src/training/distillation/stage-a.js +338 -0
- package/src/training/distillation/stage-b.d.ts +24 -0
- package/src/training/distillation/stage-b.js +20 -0
- package/src/training/distillation/student-fixture.d.ts +22 -0
- package/src/training/distillation/student-fixture.js +846 -0
- package/src/training/distillation/suite-data.d.ts +45 -0
- package/src/training/distillation/suite-data.js +189 -0
- package/src/training/export.d.ts +32 -0
- package/src/training/export.js +112 -0
- package/src/training/index.d.ts +62 -0
- package/src/training/index.js +51 -0
- package/src/training/lora-pipeline.d.ts +40 -0
- package/src/training/lora-pipeline.js +793 -0
- package/src/training/lora.d.ts +19 -0
- package/src/training/lora.js +71 -0
- package/src/training/loss-scaling.d.ts +21 -0
- package/src/training/loss-scaling.js +80 -0
- package/src/training/loss.d.ts +10 -0
- package/src/training/loss.js +40 -0
- package/src/training/objectives/base.d.ts +58 -0
- package/src/training/objectives/base.js +38 -0
- package/src/training/objectives/cross_entropy.d.ts +18 -0
- package/src/training/objectives/cross_entropy.js +34 -0
- package/src/training/objectives/distill_kd.d.ts +16 -0
- package/src/training/objectives/distill_kd.js +369 -0
- package/src/training/objectives/distill_triplet.d.ts +16 -0
- package/src/training/objectives/distill_triplet.js +414 -0
- package/src/training/objectives/index.d.ts +12 -0
- package/src/training/objectives/index.js +6 -0
- package/src/training/objectives/ul_stage1_joint.d.ts +16 -0
- package/src/training/objectives/ul_stage1_joint.js +188 -0
- package/src/training/objectives/ul_stage2_base.d.ts +16 -0
- package/src/training/objectives/ul_stage2_base.js +218 -0
- package/src/training/operator-artifacts.d.ts +62 -0
- package/src/training/operator-artifacts.js +140 -0
- package/src/training/operator-command.d.ts +5 -0
- package/src/training/operator-command.js +455 -0
- package/src/training/operator-eval.d.ts +48 -0
- package/src/training/operator-eval.js +230 -0
- package/src/training/operator-scoreboard.d.ts +5 -0
- package/src/training/operator-scoreboard.js +44 -0
- package/src/training/optimizer.d.ts +22 -0
- package/src/training/optimizer.js +127 -0
- package/src/training/runner.d.ts +248 -0
- package/src/training/runner.js +1236 -0
- package/src/training/suite.d.ts +299 -0
- package/src/training/suite.js +2196 -0
- package/src/training/tensor-factory.d.ts +9 -0
- package/src/training/tensor-factory.js +13 -0
- package/src/training/trainer.d.ts +89 -0
- package/src/training/trainer.js +299 -0
- package/src/training/ul_dataset.d.ts +47 -0
- package/src/training/ul_dataset.js +151 -0
- package/src/training/ul_schedule.d.ts +6 -0
- package/src/training/ul_schedule.js +29 -0
- package/src/training/workload-packs/distill-translategemma-medium.json +103 -0
- package/src/training/workload-packs/distill-translategemma-tiny.json +103 -0
- package/src/training/workload-packs/lora-toy-medium.json +91 -0
- package/src/training/workload-packs/lora-toy-tiny.json +91 -0
- package/src/training/workload-packs/registry.json +98 -0
- package/src/training/workload-packs/ul-training-medium.json +55 -0
- package/src/training/workload-packs/ul-training-tiny.json +55 -0
- package/src/training/workloads.d.ts +164 -0
- package/src/training/workloads.js +530 -0
- package/src/types/chrome.d.ts +36 -0
- package/src/types/chrome.js +1 -0
- package/src/types/gpu.d.ts +185 -0
- package/src/types/gpu.js +5 -0
- package/src/types/index.d.ts +4 -0
- package/src/types/index.js +4 -0
- package/src/types/inference.d.ts +197 -0
- package/src/types/inference.js +5 -0
- package/src/types/model.d.ts +130 -0
- package/src/types/model.js +5 -0
- package/src/utils/format-bytes.js +20 -0
- package/src/utils/hf-resolve-url.d.ts +16 -0
- package/src/utils/hf-resolve-url.js +17 -0
- package/src/utils/index.d.ts +7 -0
- package/src/utils/index.js +7 -0
- package/src/utils/load-json.d.ts +5 -0
- package/src/utils/load-json.js +33 -0
- package/src/utils/plain-object.d.ts +1 -0
- package/src/utils/plain-object.js +3 -0
- package/src/utils/sha256.d.ts +4 -0
- package/src/utils/sha256.js +135 -0
- package/src/version.d.ts +2 -0
- package/src/version.js +2 -0
- package/tools/convert-safetensors-node.js +240 -0
|
@@ -0,0 +1,1664 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
import fs from 'node:fs/promises';
|
|
4
|
+
import path from 'node:path';
|
|
5
|
+
import { fileURLToPath, pathToFileURL } from 'node:url';
|
|
6
|
+
import { runNodeCommand } from '../tooling/node-command-runner.js';
|
|
7
|
+
import { runBrowserCommandInNode } from '../tooling/node-browser-command-runner.js';
|
|
8
|
+
import {
|
|
9
|
+
TOOLING_COMMANDS,
|
|
10
|
+
normalizeToolingCommandRequest,
|
|
11
|
+
} from '../tooling/command-api.js';
|
|
12
|
+
import { createToolingErrorEnvelope } from '../tooling/command-envelope.js';
|
|
13
|
+
import { buildHfResolveBaseUrl } from '../utils/hf-resolve-url.js';
|
|
14
|
+
import { DEFAULT_EXTERNAL_MODELS_ROOT } from '../tooling/hf-registry-utils.js';
|
|
15
|
+
|
|
16
|
+
const NODE_WEBGPU_INCOMPLETE_MESSAGE = 'node command: WebGPU runtime is incomplete in Node';
|
|
17
|
+
const CLI_POLICY_PATH = fileURLToPath(new URL('./config/doppler-cli-policy.json', import.meta.url));
|
|
18
|
+
const DEFAULT_EXTERNAL_RDRR_ROOT = path.join(DEFAULT_EXTERNAL_MODELS_ROOT, 'rdrr');
|
|
19
|
+
const DEFAULT_CLI_POLICY = {
|
|
20
|
+
defaults: {
|
|
21
|
+
surface: {
|
|
22
|
+
default: 'auto',
|
|
23
|
+
allowed: ['auto', 'node', 'browser'],
|
|
24
|
+
},
|
|
25
|
+
bench: {
|
|
26
|
+
cacheMode: 'warm',
|
|
27
|
+
},
|
|
28
|
+
cacheMode: null,
|
|
29
|
+
loadMode: null,
|
|
30
|
+
benchmark: {
|
|
31
|
+
saveDir: './benchmarks/vendors/results',
|
|
32
|
+
},
|
|
33
|
+
},
|
|
34
|
+
surfaceFallback: {
|
|
35
|
+
enabled: true,
|
|
36
|
+
from: 'auto',
|
|
37
|
+
to: 'browser',
|
|
38
|
+
errorFragments: [NODE_WEBGPU_INCOMPLETE_MESSAGE],
|
|
39
|
+
},
|
|
40
|
+
};
|
|
41
|
+
|
|
42
|
+
const COMMON_CLI_FLAGS = Object.freeze([
|
|
43
|
+
'config',
|
|
44
|
+
'surface',
|
|
45
|
+
'pretty',
|
|
46
|
+
'json',
|
|
47
|
+
'help',
|
|
48
|
+
'h',
|
|
49
|
+
'runtime-config',
|
|
50
|
+
]);
|
|
51
|
+
|
|
52
|
+
function asStringOrNull(value) {
|
|
53
|
+
if (value === undefined || value === null) return null;
|
|
54
|
+
if (typeof value === 'string') {
|
|
55
|
+
const trimmed = value.trim();
|
|
56
|
+
if (!trimmed.length) return null;
|
|
57
|
+
return trimmed;
|
|
58
|
+
}
|
|
59
|
+
return String(value);
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
function usage() {
|
|
63
|
+
return [
|
|
64
|
+
'Usage:',
|
|
65
|
+
' doppler convert --config <path|url|json> [--surface auto|node]',
|
|
66
|
+
' doppler debug --config <path|url|json> [--runtime-config <path|url|json>] [--surface auto|node|browser]',
|
|
67
|
+
' doppler bench --config <path|url|json> [--runtime-config <path|url|json>] [--surface auto|node|browser]',
|
|
68
|
+
' doppler verify --config <path|url|json> [--runtime-config <path|url|json>] [--surface auto|node|browser]',
|
|
69
|
+
' doppler lora --config <path|url|json> [--surface auto|node]',
|
|
70
|
+
' doppler distill --config <path|url|json> [--surface auto|node]',
|
|
71
|
+
'',
|
|
72
|
+
'Flags:',
|
|
73
|
+
' --config <path|url|json> Required command config payload (file path, URL, or JSON object string).',
|
|
74
|
+
' --runtime-config <value> Compatibility runtime override alias (JSON object, URL, or file path).',
|
|
75
|
+
' --surface <auto|node|browser> Optional execution surface override.',
|
|
76
|
+
' --pretty Print human-readable summary instead of JSON',
|
|
77
|
+
' --help, -h Show this help message',
|
|
78
|
+
'',
|
|
79
|
+
'Command Config Contract:',
|
|
80
|
+
' The config payload must be a JSON object and may include:',
|
|
81
|
+
' - request: tooling command request fields (workload, modelId, training fields, convertPayload, etc).',
|
|
82
|
+
' May also include `runtimeProfile`, `runtimeConfigUrl`, and `runtimeConfig`.',
|
|
83
|
+
' Unknown top-level keys are disallowed when `request` is used as the envelope key.',
|
|
84
|
+
' - run: CLI-only run controls (surface, browser options, and bench save/compare/manifest settings).',
|
|
85
|
+
' - runtimeProfile: optional runtime profile id.',
|
|
86
|
+
' - runtimeConfigUrl: optional runtime override URL or local JSON path.',
|
|
87
|
+
' - runtimeConfig: optional inline runtime override object.',
|
|
88
|
+
'',
|
|
89
|
+
'Example:',
|
|
90
|
+
' doppler verify --config \'{"request":{"workload":"inference","modelId":"gemma-3-270m-it-f16-af32"}}\'',
|
|
91
|
+
].join('\n');
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
function parseArgs(argv) {
|
|
95
|
+
const out = {
|
|
96
|
+
command: null,
|
|
97
|
+
flags: {},
|
|
98
|
+
};
|
|
99
|
+
|
|
100
|
+
if (!argv.length) return out;
|
|
101
|
+
out.command = asStringOrNull(argv[0]);
|
|
102
|
+
|
|
103
|
+
for (let i = 1; i < argv.length; i += 1) {
|
|
104
|
+
const token = argv[i];
|
|
105
|
+
if (token === '-h') {
|
|
106
|
+
out.flags.h = true;
|
|
107
|
+
continue;
|
|
108
|
+
}
|
|
109
|
+
if (token.startsWith('-') && !token.startsWith('--')) {
|
|
110
|
+
throw new Error(`Unsupported short flag "${token}". Use long-form flags (for example --help).`);
|
|
111
|
+
}
|
|
112
|
+
if (!token.startsWith('--')) {
|
|
113
|
+
throw new Error('Positional arguments are not supported. Use --config for command payloads.');
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
const key = token.slice(2);
|
|
117
|
+
if (
|
|
118
|
+
key === 'json'
|
|
119
|
+
|| key === 'pretty'
|
|
120
|
+
|| key === 'help'
|
|
121
|
+
|| key === 'h'
|
|
122
|
+
) {
|
|
123
|
+
out.flags[key] = true;
|
|
124
|
+
continue;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
const value = argv[i + 1];
|
|
128
|
+
if (value === undefined) {
|
|
129
|
+
throw new Error(`Missing value for --${key}`);
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
if (value.startsWith('--')) {
|
|
133
|
+
throw new Error(`Missing value for --${key}`);
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
out.flags[key] = value;
|
|
137
|
+
i += 1;
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
return out;
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
function levenshteinDistance(a, b) {
|
|
144
|
+
const source = String(a ?? '');
|
|
145
|
+
const target = String(b ?? '');
|
|
146
|
+
if (source === target) return 0;
|
|
147
|
+
if (source.length === 0) return target.length;
|
|
148
|
+
if (target.length === 0) return source.length;
|
|
149
|
+
|
|
150
|
+
const previous = new Array(target.length + 1);
|
|
151
|
+
const current = new Array(target.length + 1);
|
|
152
|
+
|
|
153
|
+
for (let i = 0; i <= target.length; i += 1) {
|
|
154
|
+
previous[i] = i;
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
for (let i = 1; i <= source.length; i += 1) {
|
|
158
|
+
current[0] = i;
|
|
159
|
+
for (let j = 1; j <= target.length; j += 1) {
|
|
160
|
+
const cost = source[i - 1] === target[j - 1] ? 0 : 1;
|
|
161
|
+
current[j] = Math.min(
|
|
162
|
+
previous[j] + 1,
|
|
163
|
+
current[j - 1] + 1,
|
|
164
|
+
previous[j - 1] + cost
|
|
165
|
+
);
|
|
166
|
+
}
|
|
167
|
+
for (let j = 0; j <= target.length; j += 1) {
|
|
168
|
+
previous[j] = current[j];
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
return previous[target.length];
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
function findClosestFlag(flag, allowedFlags) {
|
|
176
|
+
const normalizedFlag = String(flag ?? '').trim();
|
|
177
|
+
if (!normalizedFlag) return null;
|
|
178
|
+
|
|
179
|
+
let candidate = null;
|
|
180
|
+
let distance = Infinity;
|
|
181
|
+
for (const allowedFlag of allowedFlags) {
|
|
182
|
+
const nextDistance = levenshteinDistance(normalizedFlag, allowedFlag);
|
|
183
|
+
if (nextDistance < distance) {
|
|
184
|
+
candidate = allowedFlag;
|
|
185
|
+
distance = nextDistance;
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
return distance <= 3 ? candidate : null;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
function validateCommandFlags(parsed) {
|
|
192
|
+
const command = parsed?.command;
|
|
193
|
+
if (!command || !TOOLING_COMMANDS.includes(command)) {
|
|
194
|
+
return;
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
const allowedFlags = new Set(COMMON_CLI_FLAGS);
|
|
198
|
+
const keys = Object.keys(parsed.flags || {});
|
|
199
|
+
for (const key of keys) {
|
|
200
|
+
if (allowedFlags.has(key)) {
|
|
201
|
+
continue;
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
const suggestion = findClosestFlag(key, allowedFlags);
|
|
205
|
+
if (suggestion) {
|
|
206
|
+
throw new Error(`Unknown flag --${key} for "${command}". Did you mean --${suggestion}?`);
|
|
207
|
+
}
|
|
208
|
+
throw new Error(`Unknown flag --${key} for "${command}".`);
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
function parseJsonObjectFlag(value, label) {
|
|
213
|
+
if (asStringOrNull(value) === null) return null;
|
|
214
|
+
try {
|
|
215
|
+
const parsed = JSON.parse(value);
|
|
216
|
+
if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
|
|
217
|
+
throw new Error('value must be a JSON object');
|
|
218
|
+
}
|
|
219
|
+
return parsed;
|
|
220
|
+
} catch (error) {
|
|
221
|
+
throw new Error(`Invalid ${label}: ${error.message}`);
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
function parseRuntimeConfigUrl(value) {
|
|
226
|
+
const normalized = asStringOrNull(value);
|
|
227
|
+
if (normalized === null) return null;
|
|
228
|
+
return isAbsoluteUrl(normalized)
|
|
229
|
+
? normalized
|
|
230
|
+
: pathToFileURL(path.resolve(normalized)).href;
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
function isAbsoluteUrl(value) {
|
|
234
|
+
const normalized = asStringOrNull(value);
|
|
235
|
+
if (normalized === null) return false;
|
|
236
|
+
try {
|
|
237
|
+
const parsed = new URL(normalized);
|
|
238
|
+
return typeof parsed.protocol === 'string' && parsed.protocol.length > 0;
|
|
239
|
+
} catch {
|
|
240
|
+
return false;
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
function parseUnifiedRuntimeConfig(value) {
|
|
245
|
+
const normalized = asStringOrNull(value);
|
|
246
|
+
if (normalized === null) return null;
|
|
247
|
+
if (normalized.startsWith('{')) {
|
|
248
|
+
return {
|
|
249
|
+
runtimeProfile: null,
|
|
250
|
+
runtimeConfigUrl: null,
|
|
251
|
+
runtimeConfig: parseJsonObjectFlag(normalized, '--runtime-config'),
|
|
252
|
+
};
|
|
253
|
+
}
|
|
254
|
+
if (isAbsoluteUrl(normalized)) {
|
|
255
|
+
return {
|
|
256
|
+
runtimeProfile: null,
|
|
257
|
+
runtimeConfigUrl: normalized,
|
|
258
|
+
runtimeConfig: null,
|
|
259
|
+
};
|
|
260
|
+
}
|
|
261
|
+
return {
|
|
262
|
+
runtimeProfile: null,
|
|
263
|
+
runtimeConfigUrl: parseRuntimeConfigUrl(normalized),
|
|
264
|
+
runtimeConfig: null,
|
|
265
|
+
};
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
function resolveRuntimeConfigFlags(parsed) {
|
|
269
|
+
const unifiedRaw = asStringOrNull(parsed.flags['runtime-config']);
|
|
270
|
+
return parseUnifiedRuntimeConfig(unifiedRaw);
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
async function readJsonObjectFile(filePath, label) {
|
|
274
|
+
const resolved = path.resolve(String(filePath));
|
|
275
|
+
let raw;
|
|
276
|
+
try {
|
|
277
|
+
raw = await fs.readFile(resolved, 'utf8');
|
|
278
|
+
} catch (error) {
|
|
279
|
+
throw new Error(`${label} not found or unreadable: ${resolved}`);
|
|
280
|
+
}
|
|
281
|
+
let parsed;
|
|
282
|
+
try {
|
|
283
|
+
parsed = JSON.parse(raw);
|
|
284
|
+
} catch (error) {
|
|
285
|
+
throw new Error(`${label} must contain valid JSON: ${error.message}`);
|
|
286
|
+
}
|
|
287
|
+
if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
|
|
288
|
+
throw new Error(`${label} must be a JSON object.`);
|
|
289
|
+
}
|
|
290
|
+
return parsed;
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
async function readJsonObjectUrl(rawUrl, label) {
|
|
294
|
+
let response;
|
|
295
|
+
try {
|
|
296
|
+
response = await fetch(rawUrl, {
|
|
297
|
+
headers: {
|
|
298
|
+
Connection: 'close',
|
|
299
|
+
},
|
|
300
|
+
redirect: 'follow',
|
|
301
|
+
signal: AbortSignal.timeout(30000),
|
|
302
|
+
});
|
|
303
|
+
} catch (error) {
|
|
304
|
+
throw new Error(`${label} URL request failed: ${error?.message || String(error)}`);
|
|
305
|
+
}
|
|
306
|
+
if (!response.ok) {
|
|
307
|
+
throw new Error(`${label} URL request failed: HTTP ${response.status}`);
|
|
308
|
+
}
|
|
309
|
+
let raw;
|
|
310
|
+
try {
|
|
311
|
+
raw = await response.text();
|
|
312
|
+
} catch (error) {
|
|
313
|
+
throw new Error(`${label} URL request failed: ${error?.message || String(error)}`);
|
|
314
|
+
}
|
|
315
|
+
return parseJsonObjectFlag(raw, label);
|
|
316
|
+
}
|
|
317
|
+
|
|
318
|
+
async function readJsonObjectInput(inputValue, label) {
|
|
319
|
+
const normalized = asStringOrNull(inputValue);
|
|
320
|
+
if (normalized === null) {
|
|
321
|
+
throw new Error(`${label} is required.`);
|
|
322
|
+
}
|
|
323
|
+
if (normalized.startsWith('{')) {
|
|
324
|
+
return parseJsonObjectFlag(normalized, label);
|
|
325
|
+
}
|
|
326
|
+
if (isAbsoluteUrl(normalized)) {
|
|
327
|
+
return readJsonObjectUrl(normalized, label);
|
|
328
|
+
}
|
|
329
|
+
return readJsonObjectFile(normalized, label);
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
function resolveCommandConfigFlag(parsed) {
|
|
333
|
+
const config = asStringOrNull(parsed.flags.config);
|
|
334
|
+
if (!config) {
|
|
335
|
+
throw new Error('command requires --config <path|url|json>.');
|
|
336
|
+
}
|
|
337
|
+
return config;
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
function parseBooleanFlag(value, label) {
|
|
341
|
+
const normalizedInput = asStringOrNull(value);
|
|
342
|
+
if (normalizedInput === null) return null;
|
|
343
|
+
if (typeof value === 'boolean') return value;
|
|
344
|
+
if (typeof value === 'string') {
|
|
345
|
+
const normalized = normalizedInput.toLowerCase();
|
|
346
|
+
if (normalized === 'true') return true;
|
|
347
|
+
if (normalized === 'false') return false;
|
|
348
|
+
}
|
|
349
|
+
throw new Error(`${label} must be true or false`);
|
|
350
|
+
}
|
|
351
|
+
|
|
352
|
+
function parseNumberFlag(value, label) {
|
|
353
|
+
const normalized = asStringOrNull(value);
|
|
354
|
+
if (normalized === null) return null;
|
|
355
|
+
const parsed = Number(normalized);
|
|
356
|
+
if (!Number.isFinite(parsed)) {
|
|
357
|
+
throw new Error(`${label} must be a number`);
|
|
358
|
+
}
|
|
359
|
+
return parsed;
|
|
360
|
+
}
|
|
361
|
+
|
|
362
|
+
function parseBrowserArgs(value) {
|
|
363
|
+
if (value === undefined || value === null) return [];
|
|
364
|
+
return Array.isArray(value) ? value.map((item) => String(item)) : [String(value)];
|
|
365
|
+
}
|
|
366
|
+
|
|
367
|
+
async function pathExists(filePath) {
|
|
368
|
+
try {
|
|
369
|
+
await fs.access(filePath);
|
|
370
|
+
return true;
|
|
371
|
+
} catch {
|
|
372
|
+
return false;
|
|
373
|
+
}
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
function resolveStaticRootDir(browserOptions = {}) {
|
|
377
|
+
const configured = asStringOrNull(browserOptions.staticRootDir);
|
|
378
|
+
if (configured) {
|
|
379
|
+
return path.resolve(String(configured));
|
|
380
|
+
}
|
|
381
|
+
return process.cwd();
|
|
382
|
+
}
|
|
383
|
+
|
|
384
|
+
function resolveRdrrRoot(options = {}) {
|
|
385
|
+
return path.resolve(asStringOrNull(options.rdrrRoot) || DEFAULT_EXTERNAL_RDRR_ROOT);
|
|
386
|
+
}
|
|
387
|
+
|
|
388
|
+
async function findResolvableModelCandidate(candidates) {
|
|
389
|
+
const discoveredManifestCandidates = [];
|
|
390
|
+
|
|
391
|
+
for (const candidate of candidates) {
|
|
392
|
+
if (!await pathExists(candidate.manifestPath)) {
|
|
393
|
+
continue;
|
|
394
|
+
}
|
|
395
|
+
discoveredManifestCandidates.push(candidate);
|
|
396
|
+
|
|
397
|
+
const modelDir = path.dirname(candidate.manifestPath);
|
|
398
|
+
try {
|
|
399
|
+
const files = await fs.readdir(modelDir, { withFileTypes: true });
|
|
400
|
+
const hasShards = files.some((entry) =>
|
|
401
|
+
entry.isFile() && /^shard_\d+\.bin$/u.test(entry.name)
|
|
402
|
+
);
|
|
403
|
+
if (hasShards) {
|
|
404
|
+
return { candidate, discoveredManifestCandidates };
|
|
405
|
+
}
|
|
406
|
+
} catch {
|
|
407
|
+
return { candidate, discoveredManifestCandidates };
|
|
408
|
+
}
|
|
409
|
+
}
|
|
410
|
+
|
|
411
|
+
return { candidate: null, discoveredManifestCandidates };
|
|
412
|
+
}
|
|
413
|
+
|
|
414
|
+
async function resolveExternalModelDirectory(rdrrRoot, modelId) {
|
|
415
|
+
const directModelDir = path.join(rdrrRoot, modelId);
|
|
416
|
+
const directManifestPath = path.join(directModelDir, 'manifest.json');
|
|
417
|
+
if (await pathExists(directManifestPath)) {
|
|
418
|
+
return {
|
|
419
|
+
modelDir: directModelDir,
|
|
420
|
+
manifestPath: directManifestPath,
|
|
421
|
+
};
|
|
422
|
+
}
|
|
423
|
+
|
|
424
|
+
let entries = [];
|
|
425
|
+
try {
|
|
426
|
+
entries = await fs.readdir(rdrrRoot, { withFileTypes: true });
|
|
427
|
+
} catch {
|
|
428
|
+
return null;
|
|
429
|
+
}
|
|
430
|
+
|
|
431
|
+
const matches = [];
|
|
432
|
+
for (const entry of entries) {
|
|
433
|
+
if (!entry.isDirectory()) {
|
|
434
|
+
continue;
|
|
435
|
+
}
|
|
436
|
+
const manifestPath = path.join(rdrrRoot, entry.name, 'manifest.json');
|
|
437
|
+
if (!await pathExists(manifestPath)) {
|
|
438
|
+
continue;
|
|
439
|
+
}
|
|
440
|
+
let manifest = null;
|
|
441
|
+
try {
|
|
442
|
+
manifest = JSON.parse(await fs.readFile(manifestPath, 'utf8'));
|
|
443
|
+
} catch {
|
|
444
|
+
continue;
|
|
445
|
+
}
|
|
446
|
+
if (manifest?.modelId !== modelId) {
|
|
447
|
+
continue;
|
|
448
|
+
}
|
|
449
|
+
matches.push({
|
|
450
|
+
modelDir: path.join(rdrrRoot, entry.name),
|
|
451
|
+
manifestPath,
|
|
452
|
+
});
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
if (matches.length > 1) {
|
|
456
|
+
const matchPaths = matches.map((match) => match.modelDir).join(', ');
|
|
457
|
+
throw new Error(
|
|
458
|
+
`Model "${modelId}" matched multiple external directories. ` +
|
|
459
|
+
`Disambiguate by setting request.modelUrl in --config. Matches: ${matchPaths}`
|
|
460
|
+
);
|
|
461
|
+
}
|
|
462
|
+
|
|
463
|
+
return matches[0] || null;
|
|
464
|
+
}
|
|
465
|
+
|
|
466
|
+
const CATALOG_PATH = fileURLToPath(new URL('../../models/catalog.json', import.meta.url));
|
|
467
|
+
|
|
468
|
+
async function resolveCatalogEntry(modelId) {
|
|
469
|
+
let catalog;
|
|
470
|
+
try {
|
|
471
|
+
catalog = JSON.parse(await fs.readFile(CATALOG_PATH, 'utf8'));
|
|
472
|
+
} catch {
|
|
473
|
+
return null;
|
|
474
|
+
}
|
|
475
|
+
if (!Array.isArray(catalog?.models)) {
|
|
476
|
+
return null;
|
|
477
|
+
}
|
|
478
|
+
return catalog.models.find((entry) => (
|
|
479
|
+
entry.modelId === modelId
|
|
480
|
+
|| (Array.isArray(entry.aliases) && entry.aliases.includes(modelId))
|
|
481
|
+
)) || null;
|
|
482
|
+
}
|
|
483
|
+
|
|
484
|
+
function buildCatalogModelUrl(entry) {
|
|
485
|
+
if (!entry?.hf?.repoId || !entry?.hf?.path) {
|
|
486
|
+
return null;
|
|
487
|
+
}
|
|
488
|
+
return buildHfResolveBaseUrl(entry.hf);
|
|
489
|
+
}
|
|
490
|
+
|
|
491
|
+
export async function resolveBrowserModelUrl(request, browserOptions = {}) {
|
|
492
|
+
if (request.modelUrl || !request.modelId) {
|
|
493
|
+
return request;
|
|
494
|
+
}
|
|
495
|
+
|
|
496
|
+
const modelId = String(request.modelId);
|
|
497
|
+
const encodedModelId = encodeURIComponent(modelId);
|
|
498
|
+
|
|
499
|
+
if (asStringOrNull(browserOptions.baseUrl)) {
|
|
500
|
+
return {
|
|
501
|
+
...request,
|
|
502
|
+
modelUrl: `/models/${encodedModelId}`,
|
|
503
|
+
};
|
|
504
|
+
}
|
|
505
|
+
|
|
506
|
+
const staticRootDir = resolveStaticRootDir(browserOptions);
|
|
507
|
+
const externalModel = await resolveExternalModelDirectory(resolveRdrrRoot(browserOptions), modelId);
|
|
508
|
+
const candidates = [
|
|
509
|
+
{
|
|
510
|
+
modelUrl: `/models/local/${encodedModelId}`,
|
|
511
|
+
manifestPath: path.join(staticRootDir, 'models', 'local', modelId, 'manifest.json'),
|
|
512
|
+
},
|
|
513
|
+
{
|
|
514
|
+
modelUrl: `/models/${encodedModelId}`,
|
|
515
|
+
manifestPath: path.join(staticRootDir, 'models', modelId, 'manifest.json'),
|
|
516
|
+
},
|
|
517
|
+
{
|
|
518
|
+
modelUrl: `/models/external/${encodeURIComponent(path.basename(externalModel?.modelDir || modelId))}`,
|
|
519
|
+
manifestPath: externalModel?.manifestPath || path.join(resolveRdrrRoot(browserOptions), modelId, 'manifest.json'),
|
|
520
|
+
},
|
|
521
|
+
];
|
|
522
|
+
|
|
523
|
+
const { candidate, discoveredManifestCandidates } = await findResolvableModelCandidate(candidates);
|
|
524
|
+
if (candidate) {
|
|
525
|
+
return {
|
|
526
|
+
...request,
|
|
527
|
+
modelUrl: candidate.modelUrl,
|
|
528
|
+
};
|
|
529
|
+
}
|
|
530
|
+
|
|
531
|
+
if (discoveredManifestCandidates.length > 0) {
|
|
532
|
+
const paths = discoveredManifestCandidates
|
|
533
|
+
.map((candidate) => candidate.modelUrl)
|
|
534
|
+
.join(', ');
|
|
535
|
+
throw new Error(
|
|
536
|
+
`Model "${modelId}" was found, but no shard files (shard_*.bin) are present. ` +
|
|
537
|
+
`Checked: ${paths}. Add shard files beside the manifest, or set request.modelUrl in --config to a complete model directory.`
|
|
538
|
+
);
|
|
539
|
+
}
|
|
540
|
+
|
|
541
|
+
const catalogEntry = await resolveCatalogEntry(modelId);
|
|
542
|
+
if (catalogEntry) {
|
|
543
|
+
const hfUrl = buildCatalogModelUrl(catalogEntry);
|
|
544
|
+
if (hfUrl) {
|
|
545
|
+
return {
|
|
546
|
+
...request,
|
|
547
|
+
modelUrl: hfUrl,
|
|
548
|
+
};
|
|
549
|
+
}
|
|
550
|
+
}
|
|
551
|
+
|
|
552
|
+
return {
|
|
553
|
+
...request,
|
|
554
|
+
modelUrl: `/models/${encodedModelId}`,
|
|
555
|
+
};
|
|
556
|
+
}
|
|
557
|
+
|
|
558
|
+
export async function resolveNodeModelUrl(request, options = {}) {
|
|
559
|
+
if (request.modelUrl || !request.modelId) {
|
|
560
|
+
return request;
|
|
561
|
+
}
|
|
562
|
+
|
|
563
|
+
const modelId = String(request.modelId);
|
|
564
|
+
const rdrrRoot = resolveRdrrRoot(options);
|
|
565
|
+
const externalModel = await resolveExternalModelDirectory(rdrrRoot, modelId);
|
|
566
|
+
|
|
567
|
+
if (externalModel) {
|
|
568
|
+
const modelDir = externalModel.modelDir;
|
|
569
|
+
try {
|
|
570
|
+
const files = await fs.readdir(modelDir, { withFileTypes: true });
|
|
571
|
+
const hasShards = files.some((entry) =>
|
|
572
|
+
entry.isFile() && /^shard_\d+\.bin$/u.test(entry.name)
|
|
573
|
+
);
|
|
574
|
+
if (!hasShards) {
|
|
575
|
+
throw new Error(
|
|
576
|
+
`Model "${modelId}" found at ${modelDir} but no shard files (shard_*.bin) are present. `
|
|
577
|
+
+ 'Add shard files beside the manifest, or set request.modelUrl to a complete model directory.'
|
|
578
|
+
);
|
|
579
|
+
}
|
|
580
|
+
} catch (err) {
|
|
581
|
+
if (err.code === 'ENOENT' || err.code === 'EACCES') {
|
|
582
|
+
throw new Error(
|
|
583
|
+
`Model "${modelId}" resolved to ${modelDir} but the directory is not accessible: ${err.message}`
|
|
584
|
+
);
|
|
585
|
+
}
|
|
586
|
+
throw err;
|
|
587
|
+
}
|
|
588
|
+
return {
|
|
589
|
+
...request,
|
|
590
|
+
modelUrl: pathToFileURL(modelDir).href.replace(/\/$/, ''),
|
|
591
|
+
};
|
|
592
|
+
}
|
|
593
|
+
|
|
594
|
+
const catalogEntry = await resolveCatalogEntry(modelId);
|
|
595
|
+
if (catalogEntry) {
|
|
596
|
+
const hfUrl = buildCatalogModelUrl(catalogEntry);
|
|
597
|
+
if (hfUrl) {
|
|
598
|
+
return {
|
|
599
|
+
...request,
|
|
600
|
+
modelUrl: hfUrl,
|
|
601
|
+
};
|
|
602
|
+
}
|
|
603
|
+
throw new Error(
|
|
604
|
+
`Model "${modelId}" found in catalog as "${catalogEntry.modelId}" but has no HF source configured.`
|
|
605
|
+
);
|
|
606
|
+
}
|
|
607
|
+
|
|
608
|
+
throw new Error(
|
|
609
|
+
`Model "${modelId}" not found. Searched local: ${rdrrRoot}. Not in catalog. `
|
|
610
|
+
+ 'Set request.modelUrl to a file:// or https:// URL, '
|
|
611
|
+
+ 'or set DOPPLER_EXTERNAL_MODELS_ROOT to the parent of your rdrr/ folder.'
|
|
612
|
+
);
|
|
613
|
+
}
|
|
614
|
+
|
|
615
|
+
function parseSurface(value, command, policy = DEFAULT_CLI_POLICY) {
|
|
616
|
+
const normalizedInput = asStringOrNull(value);
|
|
617
|
+
const normalizedSurface = policy.defaults && policy.defaults.surface && policy.defaults.surface.default
|
|
618
|
+
? policy.defaults.surface.default
|
|
619
|
+
: 'auto';
|
|
620
|
+
const allowedSurfaces = policy.defaults && Array.isArray(policy.defaults.surface?.allowed)
|
|
621
|
+
? policy.defaults.surface.allowed
|
|
622
|
+
: ['auto', 'node', 'browser'];
|
|
623
|
+
const normalized = String(normalizedInput === null ? normalizedSurface : normalizedInput).trim().toLowerCase();
|
|
624
|
+
if (!allowedSurfaces.includes(normalized)) {
|
|
625
|
+
throw new Error('--surface must be one of auto, node, browser');
|
|
626
|
+
}
|
|
627
|
+
if (command === 'convert' && normalized === 'browser') {
|
|
628
|
+
throw new Error('convert is not supported on browser relay. Use --surface node or --surface auto.');
|
|
629
|
+
}
|
|
630
|
+
if ((command === 'lora' || command === 'distill') && normalized === 'browser') {
|
|
631
|
+
throw new Error(`${command} is not supported on browser relay. Use --surface node or --surface auto.`);
|
|
632
|
+
}
|
|
633
|
+
return normalized;
|
|
634
|
+
}
|
|
635
|
+
|
|
636
|
+
function isPlainObject(value) {
|
|
637
|
+
return !!value && typeof value === 'object' && !Array.isArray(value);
|
|
638
|
+
}
|
|
639
|
+
|
|
640
|
+
const CONFIG_ENVELOPE_KNOWN_KEYS = new Set([
|
|
641
|
+
'request',
|
|
642
|
+
'run',
|
|
643
|
+
'runtimeProfile',
|
|
644
|
+
'runtimeConfigUrl',
|
|
645
|
+
'runtimeConfig',
|
|
646
|
+
]);
|
|
647
|
+
|
|
648
|
+
function buildRuntimeOverridesFromObject(source = {}, sourceLabel = '--config') {
|
|
649
|
+
const normalizedRuntimeProfile = asStringOrNull(source.runtimeProfile);
|
|
650
|
+
const normalizedRuntimeConfigUrl = asStringOrNull(source.runtimeConfigUrl) == null
|
|
651
|
+
? null
|
|
652
|
+
: parseRuntimeConfigUrl(source.runtimeConfigUrl);
|
|
653
|
+
|
|
654
|
+
const hasInlineRuntimeConfig = Object.prototype.hasOwnProperty.call(source, 'runtimeConfig');
|
|
655
|
+
let runtimeConfig = null;
|
|
656
|
+
if (hasInlineRuntimeConfig) {
|
|
657
|
+
if (!isPlainObject(source.runtimeConfig)) {
|
|
658
|
+
throw new Error(`${sourceLabel} runtimeConfig must be a JSON object when provided.`);
|
|
659
|
+
}
|
|
660
|
+
runtimeConfig = source.runtimeConfig;
|
|
661
|
+
}
|
|
662
|
+
|
|
663
|
+
return {
|
|
664
|
+
runtimeProfile: normalizedRuntimeProfile,
|
|
665
|
+
runtimeConfigUrl: normalizedRuntimeConfigUrl,
|
|
666
|
+
runtimeConfig,
|
|
667
|
+
};
|
|
668
|
+
}
|
|
669
|
+
|
|
670
|
+
function resolveConfigEnvelope(configPayload) {
|
|
671
|
+
if (!isPlainObject(configPayload)) {
|
|
672
|
+
throw new Error('--config must resolve to a JSON object.');
|
|
673
|
+
}
|
|
674
|
+
if (configPayload.request !== undefined && !isPlainObject(configPayload.request)) {
|
|
675
|
+
throw new Error('--config field "request" must be a JSON object when provided.');
|
|
676
|
+
}
|
|
677
|
+
if (configPayload.run !== undefined && !isPlainObject(configPayload.run)) {
|
|
678
|
+
throw new Error('--config field "run" must be a JSON object when provided.');
|
|
679
|
+
}
|
|
680
|
+
if (configPayload.request !== undefined) {
|
|
681
|
+
const topLevelUnknown = Object.keys(configPayload).filter(
|
|
682
|
+
(key) => !CONFIG_ENVELOPE_KNOWN_KEYS.has(key)
|
|
683
|
+
);
|
|
684
|
+
if (topLevelUnknown.length > 0) {
|
|
685
|
+
throw new Error(
|
|
686
|
+
`--config has unknown top-level keys for request envelope: ${topLevelUnknown.join(', ')}.`
|
|
687
|
+
);
|
|
688
|
+
}
|
|
689
|
+
}
|
|
690
|
+
|
|
691
|
+
const hasRequestEnvelope = isPlainObject(configPayload.request);
|
|
692
|
+
const requestPayload = hasRequestEnvelope
|
|
693
|
+
? { ...configPayload.request }
|
|
694
|
+
: { ...configPayload };
|
|
695
|
+
const topLevelRuntimeConfig = hasRequestEnvelope
|
|
696
|
+
? buildRuntimeOverridesFromObject(configPayload, '--config')
|
|
697
|
+
: {
|
|
698
|
+
runtimeProfile: null,
|
|
699
|
+
runtimeConfigUrl: null,
|
|
700
|
+
runtimeConfig: null,
|
|
701
|
+
};
|
|
702
|
+
const requestRuntimeConfig = buildRuntimeOverridesFromObject(requestPayload, '--config.request');
|
|
703
|
+
if (hasRequestEnvelope) {
|
|
704
|
+
if (
|
|
705
|
+
topLevelRuntimeConfig.runtimeProfile != null
|
|
706
|
+
&& requestRuntimeConfig.runtimeProfile != null
|
|
707
|
+
) {
|
|
708
|
+
throw new Error(
|
|
709
|
+
'Cannot set runtimeProfile in both --config payload top-level and --config.request.'
|
|
710
|
+
);
|
|
711
|
+
}
|
|
712
|
+
if (
|
|
713
|
+
topLevelRuntimeConfig.runtimeConfigUrl != null
|
|
714
|
+
&& requestRuntimeConfig.runtimeConfigUrl != null
|
|
715
|
+
) {
|
|
716
|
+
throw new Error(
|
|
717
|
+
'Cannot set runtimeConfigUrl in both --config payload top-level and --config.request.'
|
|
718
|
+
);
|
|
719
|
+
}
|
|
720
|
+
if (
|
|
721
|
+
topLevelRuntimeConfig.runtimeConfig != null
|
|
722
|
+
&& requestRuntimeConfig.runtimeConfig != null
|
|
723
|
+
) {
|
|
724
|
+
throw new Error(
|
|
725
|
+
'Cannot set runtimeConfig in both --config payload top-level and --config.request.'
|
|
726
|
+
);
|
|
727
|
+
}
|
|
728
|
+
}
|
|
729
|
+
|
|
730
|
+
const requestInput = {
|
|
731
|
+
...requestPayload,
|
|
732
|
+
runtimeProfile: (
|
|
733
|
+
topLevelRuntimeConfig.runtimeProfile !== null
|
|
734
|
+
? topLevelRuntimeConfig.runtimeProfile
|
|
735
|
+
: requestRuntimeConfig.runtimeProfile
|
|
736
|
+
),
|
|
737
|
+
runtimeConfigUrl: (
|
|
738
|
+
topLevelRuntimeConfig.runtimeConfigUrl !== null
|
|
739
|
+
? topLevelRuntimeConfig.runtimeConfigUrl
|
|
740
|
+
: requestRuntimeConfig.runtimeConfigUrl
|
|
741
|
+
),
|
|
742
|
+
runtimeConfig: (
|
|
743
|
+
topLevelRuntimeConfig.runtimeConfig !== null
|
|
744
|
+
? topLevelRuntimeConfig.runtimeConfig
|
|
745
|
+
: requestRuntimeConfig.runtimeConfig
|
|
746
|
+
),
|
|
747
|
+
};
|
|
748
|
+
return {
|
|
749
|
+
request: requestInput,
|
|
750
|
+
run: isPlainObject(configPayload.run) ? configPayload.run : {},
|
|
751
|
+
};
|
|
752
|
+
}
|
|
753
|
+
|
|
754
|
+
function applyRuntimeFlagOverride(requestInput, runtimeOverride) {
|
|
755
|
+
if (!runtimeOverride) {
|
|
756
|
+
return;
|
|
757
|
+
}
|
|
758
|
+
const hasInlineRuntime = (
|
|
759
|
+
requestInput.runtimeProfile != null
|
|
760
|
+
|| requestInput.runtimeConfigUrl != null
|
|
761
|
+
|| requestInput.runtimeConfig != null
|
|
762
|
+
);
|
|
763
|
+
if (hasInlineRuntime) {
|
|
764
|
+
throw new Error(
|
|
765
|
+
'--runtime-config cannot be combined with runtimeProfile/runtimeConfigUrl/runtimeConfig values inside --config.'
|
|
766
|
+
);
|
|
767
|
+
}
|
|
768
|
+
requestInput.runtimeProfile = runtimeOverride.runtimeProfile;
|
|
769
|
+
requestInput.runtimeConfigUrl = runtimeOverride.runtimeConfigUrl;
|
|
770
|
+
requestInput.runtimeConfig = runtimeOverride.runtimeConfig;
|
|
771
|
+
}
|
|
772
|
+
|
|
773
|
+
function resolveBenchRunOptions(runConfig, policy = DEFAULT_CLI_POLICY) {
|
|
774
|
+
const benchConfig = isPlainObject(runConfig?.bench) ? runConfig.bench : {};
|
|
775
|
+
const configuredSaveDir = asStringOrNull(benchConfig.saveDir);
|
|
776
|
+
const defaultSaveDir = asStringOrNull(policy?.defaults?.benchmark?.saveDir);
|
|
777
|
+
return {
|
|
778
|
+
shouldSave: benchConfig.save === true,
|
|
779
|
+
saveDir: configuredSaveDir === null
|
|
780
|
+
? defaultSaveDir || './benchmarks/vendors/results'
|
|
781
|
+
: configuredSaveDir,
|
|
782
|
+
comparePath: asStringOrNull(benchConfig.compare),
|
|
783
|
+
manifestPath: asStringOrNull(benchConfig.manifest),
|
|
784
|
+
};
|
|
785
|
+
}
|
|
786
|
+
|
|
787
|
+
function normalizeModelUrl(value) {
|
|
788
|
+
if (typeof value !== 'string' || !value.trim()) {
|
|
789
|
+
return value;
|
|
790
|
+
}
|
|
791
|
+
const trimmed = value.trim();
|
|
792
|
+
if (/^[a-z][a-z0-9+.-]*:\/\//u.test(trimmed)) {
|
|
793
|
+
return trimmed;
|
|
794
|
+
}
|
|
795
|
+
if (trimmed.startsWith('/') || trimmed.startsWith('.')) {
|
|
796
|
+
return pathToFileURL(path.resolve(trimmed)).href.replace(/\/$/, '');
|
|
797
|
+
}
|
|
798
|
+
return trimmed;
|
|
799
|
+
}
|
|
800
|
+
|
|
801
|
+
function resolveSurfaceForCommand(command, parsed, runConfig, policy = DEFAULT_CLI_POLICY) {
|
|
802
|
+
const fromCli = asStringOrNull(parsed.flags.surface);
|
|
803
|
+
const fromRun = asStringOrNull(runConfig?.surface);
|
|
804
|
+
return parseSurface(fromCli ?? fromRun ?? null, command, policy);
|
|
805
|
+
}
|
|
806
|
+
|
|
807
|
+
export async function buildRequest(parsed, policy = DEFAULT_CLI_POLICY) {
|
|
808
|
+
const command = parsed.command;
|
|
809
|
+
if (!command || !TOOLING_COMMANDS.includes(command)) {
|
|
810
|
+
throw new Error(`Unsupported command "${command || ''}"`);
|
|
811
|
+
}
|
|
812
|
+
|
|
813
|
+
const configValue = resolveCommandConfigFlag(parsed);
|
|
814
|
+
const configPayload = await readJsonObjectInput(configValue, '--config');
|
|
815
|
+
const envelope = resolveConfigEnvelope(configPayload);
|
|
816
|
+
const runtimeOverride = resolveRuntimeConfigFlags(parsed);
|
|
817
|
+
|
|
818
|
+
const requestInput = { ...envelope.request };
|
|
819
|
+
if (requestInput.command != null && requestInput.command !== command) {
|
|
820
|
+
throw new Error(
|
|
821
|
+
`--config request command mismatch: CLI command is "${command}" but config command is "${requestInput.command}".`
|
|
822
|
+
);
|
|
823
|
+
}
|
|
824
|
+
requestInput.command = command;
|
|
825
|
+
if (requestInput.modelUrl != null) {
|
|
826
|
+
requestInput.modelUrl = normalizeModelUrl(requestInput.modelUrl);
|
|
827
|
+
}
|
|
828
|
+
|
|
829
|
+
applyRuntimeFlagOverride(requestInput, runtimeOverride);
|
|
830
|
+
|
|
831
|
+
const surfaceFromCli = asStringOrNull(parsed.flags.surface) !== null;
|
|
832
|
+
const surface = resolveSurfaceForCommand(command, parsed, envelope.run, policy);
|
|
833
|
+
|
|
834
|
+
return {
|
|
835
|
+
request: normalizeToolingCommandRequest(requestInput),
|
|
836
|
+
runConfig: envelope.run,
|
|
837
|
+
surface,
|
|
838
|
+
surfaceFromCli,
|
|
839
|
+
benchRunOptions: resolveBenchRunOptions(envelope.run, policy),
|
|
840
|
+
};
|
|
841
|
+
}
|
|
842
|
+
|
|
843
|
+
function buildNodeRunOptions(jsonOutput) {
|
|
844
|
+
return {
|
|
845
|
+
onProgress(progress) {
|
|
846
|
+
if (jsonOutput) return;
|
|
847
|
+
if (!progress?.message) return;
|
|
848
|
+
if (Number.isFinite(progress.current) && Number.isFinite(progress.total)) {
|
|
849
|
+
console.error(`[progress] ${progress.current}/${progress.total} ${progress.message}`);
|
|
850
|
+
} else {
|
|
851
|
+
console.error(`[progress] ${progress.stage ?? 'run'} ${progress.message}`);
|
|
852
|
+
}
|
|
853
|
+
},
|
|
854
|
+
};
|
|
855
|
+
}
|
|
856
|
+
|
|
857
|
+
function buildBrowserRunOptions(runConfig, jsonOutput, request = {}) {
|
|
858
|
+
const browser = isPlainObject(runConfig?.browser) ? runConfig.browser : {};
|
|
859
|
+
|
|
860
|
+
const headed = parseBooleanFlag(browser.headed, 'run.browser.headed') === true;
|
|
861
|
+
const explicitHeadless = parseBooleanFlag(browser.headless, 'run.browser.headless');
|
|
862
|
+
if (headed && explicitHeadless !== null) {
|
|
863
|
+
throw new Error('run.browser.headed is mutually exclusive with run.browser.headless.');
|
|
864
|
+
}
|
|
865
|
+
|
|
866
|
+
const options = {
|
|
867
|
+
channel: asStringOrNull(browser.channel),
|
|
868
|
+
executablePath: asStringOrNull(browser.executablePath),
|
|
869
|
+
runnerPath: asStringOrNull(browser.runnerPath),
|
|
870
|
+
staticRootDir: asStringOrNull(browser.staticRootDir),
|
|
871
|
+
rdrrRoot: asStringOrNull(browser.rdrrRoot),
|
|
872
|
+
baseUrl: asStringOrNull(browser.baseUrl),
|
|
873
|
+
browserArgs: parseBrowserArgs(browser.browserArgs),
|
|
874
|
+
headless: headed ? false : (explicitHeadless ?? true),
|
|
875
|
+
};
|
|
876
|
+
const rdrrRoot = resolveRdrrRoot(options);
|
|
877
|
+
options.staticMounts = [
|
|
878
|
+
{
|
|
879
|
+
urlPrefix: '/models/external',
|
|
880
|
+
rootDir: rdrrRoot,
|
|
881
|
+
},
|
|
882
|
+
];
|
|
883
|
+
|
|
884
|
+
const port = parseNumberFlag(browser.port, 'run.browser.port');
|
|
885
|
+
if (port !== null) {
|
|
886
|
+
options.port = port;
|
|
887
|
+
}
|
|
888
|
+
|
|
889
|
+
const timeoutMs = parseNumberFlag(browser.timeoutMs, 'run.browser.timeoutMs');
|
|
890
|
+
if (timeoutMs !== null) {
|
|
891
|
+
options.timeoutMs = timeoutMs;
|
|
892
|
+
}
|
|
893
|
+
|
|
894
|
+
const opfsCache = parseBooleanFlag(browser.opfsCache, 'run.browser.opfsCache');
|
|
895
|
+
if (opfsCache === false) {
|
|
896
|
+
options.opfsCache = false;
|
|
897
|
+
}
|
|
898
|
+
|
|
899
|
+
const userDataDir = asStringOrNull(browser.userDataDir);
|
|
900
|
+
if (userDataDir) {
|
|
901
|
+
options.userDataDir = userDataDir;
|
|
902
|
+
}
|
|
903
|
+
|
|
904
|
+
if (request.cacheMode === 'cold') {
|
|
905
|
+
options.wipeCacheBeforeLaunch = true;
|
|
906
|
+
}
|
|
907
|
+
|
|
908
|
+
const streamConsole = parseBooleanFlag(browser.console, 'run.browser.console');
|
|
909
|
+
const shouldStreamConsole = streamConsole === true;
|
|
910
|
+
if (shouldStreamConsole && !jsonOutput) {
|
|
911
|
+
options.onConsole = ({ type, text }) => {
|
|
912
|
+
console.error(`[browser:${type}] ${text}`);
|
|
913
|
+
};
|
|
914
|
+
}
|
|
915
|
+
|
|
916
|
+
return options;
|
|
917
|
+
}
|
|
918
|
+
|
|
919
|
+
function isNodeWebGPUFallbackCandidate(error, fallbackPolicy = DEFAULT_CLI_POLICY.surfaceFallback) {
|
|
920
|
+
const message = error?.message || String(error || '');
|
|
921
|
+
const fallbackSignatures = Array.isArray(fallbackPolicy?.errorFragments) && fallbackPolicy.errorFragments.length > 0
|
|
922
|
+
? fallbackPolicy.errorFragments
|
|
923
|
+
: [NODE_WEBGPU_INCOMPLETE_MESSAGE];
|
|
924
|
+
return fallbackSignatures.some((signature) => message.includes(signature));
|
|
925
|
+
}
|
|
926
|
+
|
|
927
|
+
function isTrainingCommandFlow(request) {
|
|
928
|
+
if (!request || typeof request !== 'object') return false;
|
|
929
|
+
if (request.workload === 'training') return true;
|
|
930
|
+
if (request.command === 'lora' || request.command === 'distill') return true;
|
|
931
|
+
return request.command === 'bench' && (request.workload === 'training' || request.workloadType === 'training');
|
|
932
|
+
}
|
|
933
|
+
|
|
934
|
+
function resolveErrorSurface(error, fallbackSurface = null) {
|
|
935
|
+
return (
|
|
936
|
+
asStringOrNull(fallbackSurface)
|
|
937
|
+
|| asStringOrNull(error?.surface)
|
|
938
|
+
|| asStringOrNull(error?.details?.surface)
|
|
939
|
+
|| null
|
|
940
|
+
);
|
|
941
|
+
}
|
|
942
|
+
|
|
943
|
+
export function createCliToolingErrorEnvelope(error, context = {}) {
|
|
944
|
+
return createToolingErrorEnvelope(error, {
|
|
945
|
+
surface: resolveErrorSurface(error, context.surface),
|
|
946
|
+
request: context.request ?? null,
|
|
947
|
+
});
|
|
948
|
+
}
|
|
949
|
+
|
|
950
|
+
export function finalizeCliCommandResponse(response, request) {
|
|
951
|
+
if (!isPlainObject(response) || !Object.prototype.hasOwnProperty.call(response, 'request')) {
|
|
952
|
+
return response;
|
|
953
|
+
}
|
|
954
|
+
return {
|
|
955
|
+
...response,
|
|
956
|
+
request,
|
|
957
|
+
};
|
|
958
|
+
}
|
|
959
|
+
|
|
960
|
+
async function runCommandOnSurface(request, surface, runConfig, jsonOutput) {
|
|
961
|
+
if (surface === 'node') {
|
|
962
|
+
const nodeRequest = await resolveNodeModelUrl(request);
|
|
963
|
+
if (!jsonOutput) {
|
|
964
|
+
console.error('[surface] running on: node');
|
|
965
|
+
if (nodeRequest.modelUrl && nodeRequest.modelUrl !== request.modelUrl) {
|
|
966
|
+
console.error(`[surface] node resolved modelUrl=${nodeRequest.modelUrl}`);
|
|
967
|
+
}
|
|
968
|
+
}
|
|
969
|
+
const response = await runNodeCommand(nodeRequest, buildNodeRunOptions(jsonOutput));
|
|
970
|
+
return finalizeCliCommandResponse(response, request);
|
|
971
|
+
}
|
|
972
|
+
|
|
973
|
+
const browserOptions = buildBrowserRunOptions(runConfig, jsonOutput, request);
|
|
974
|
+
const browserRequest = await resolveBrowserModelUrl(request, browserOptions);
|
|
975
|
+
|
|
976
|
+
if (!jsonOutput) {
|
|
977
|
+
const mode = browserOptions.headless === false ? 'headed' : 'headless';
|
|
978
|
+
console.error(`[surface] running on: browser (${mode})`);
|
|
979
|
+
if (browserRequest.modelUrl && browserRequest.modelUrl !== request.modelUrl) {
|
|
980
|
+
console.error(`[surface] browser resolved modelUrl=${browserRequest.modelUrl}`);
|
|
981
|
+
}
|
|
982
|
+
}
|
|
983
|
+
|
|
984
|
+
const response = await runBrowserCommandInNode(browserRequest, browserOptions);
|
|
985
|
+
return finalizeCliCommandResponse(response, request);
|
|
986
|
+
}
|
|
987
|
+
|
|
988
|
+
async function runWithAutoSurface(request, runConfig, jsonOutput, policy = DEFAULT_CLI_POLICY) {
|
|
989
|
+
if (request.command === 'convert') {
|
|
990
|
+
return runCommandOnSurface(request, 'node', runConfig, jsonOutput);
|
|
991
|
+
}
|
|
992
|
+
const fallbackPolicy = policy?.surfaceFallback || { enabled: false };
|
|
993
|
+
|
|
994
|
+
try {
|
|
995
|
+
return await runCommandOnSurface(request, 'node', runConfig, jsonOutput);
|
|
996
|
+
} catch (error) {
|
|
997
|
+
if (!fallbackPolicy.enabled || !isNodeWebGPUFallbackCandidate(error, fallbackPolicy)) {
|
|
998
|
+
throw error;
|
|
999
|
+
}
|
|
1000
|
+
if (isTrainingCommandFlow(request)) {
|
|
1001
|
+
const downgradeError = new Error(
|
|
1002
|
+
(request.command === 'lora' || request.command === 'distill')
|
|
1003
|
+
? 'Training command auto-surface downgrade is blocked. Re-run with --surface node after fixing Node WebGPU support.'
|
|
1004
|
+
: 'Training command auto-surface downgrade is blocked. Re-run with --surface node after fixing Node WebGPU support, or explicitly choose --surface browser.'
|
|
1005
|
+
);
|
|
1006
|
+
downgradeError.code = 'training_surface_downgrade_blocked';
|
|
1007
|
+
downgradeError.surface = 'node';
|
|
1008
|
+
downgradeError.command = request.command;
|
|
1009
|
+
downgradeError.workload = request.workload;
|
|
1010
|
+
downgradeError.workloadType = request.workloadType || null;
|
|
1011
|
+
downgradeError.fromSurface = 'node';
|
|
1012
|
+
downgradeError.toSurface = fallbackPolicy.to || 'browser';
|
|
1013
|
+
throw downgradeError;
|
|
1014
|
+
}
|
|
1015
|
+
if (fallbackPolicy.to !== 'browser') {
|
|
1016
|
+
throw error;
|
|
1017
|
+
}
|
|
1018
|
+
if (!jsonOutput) {
|
|
1019
|
+
console.error('[surface] node WebGPU unavailable, falling back to browser');
|
|
1020
|
+
}
|
|
1021
|
+
return runCommandOnSurface(request, 'browser', runConfig, jsonOutput);
|
|
1022
|
+
}
|
|
1023
|
+
}
|
|
1024
|
+
|
|
1025
|
+
function toSummary(result) {
|
|
1026
|
+
if (!result || typeof result !== 'object') {
|
|
1027
|
+
return 'ok';
|
|
1028
|
+
}
|
|
1029
|
+
|
|
1030
|
+
if (result.manifest?.modelId) {
|
|
1031
|
+
const contractStatus = result.executionContractArtifact?.ok === true
|
|
1032
|
+
? ' contract=pass'
|
|
1033
|
+
: result.executionContractArtifact
|
|
1034
|
+
? ' contract=fail'
|
|
1035
|
+
: '';
|
|
1036
|
+
return `converted ${result.manifest.modelId} (${result.tensorCount} tensors, ${result.shardCount} shards)${contractStatus}`;
|
|
1037
|
+
}
|
|
1038
|
+
|
|
1039
|
+
if (result.kind === 'lora' || result.kind === 'distill') {
|
|
1040
|
+
const workloadId = result.workloadId || 'unknown';
|
|
1041
|
+
const action = result.action || 'run';
|
|
1042
|
+
const runRoot = result.runRoot || 'n/a';
|
|
1043
|
+
return `${result.kind} ${action} workload=${workloadId} runRoot=${runRoot}`;
|
|
1044
|
+
}
|
|
1045
|
+
|
|
1046
|
+
const suite = result.suite || result.report?.suite || 'suite';
|
|
1047
|
+
const modelId = result.modelId || result.report?.modelId || 'unknown';
|
|
1048
|
+
const passed = Number.isFinite(result.passed) ? result.passed : null;
|
|
1049
|
+
const failed = Number.isFinite(result.failed) ? result.failed : null;
|
|
1050
|
+
const duration = Number.isFinite(result.duration) ? `${result.duration.toFixed(1)}ms` : 'n/a';
|
|
1051
|
+
if (passed !== null && failed !== null) {
|
|
1052
|
+
return `${suite} model=${modelId} passed=${passed} failed=${failed} duration=${duration}`;
|
|
1053
|
+
}
|
|
1054
|
+
return `${suite} model=${modelId}`;
|
|
1055
|
+
}
|
|
1056
|
+
|
|
1057
|
+
function formatNumber(value, digits = 2) {
|
|
1058
|
+
return Number.isFinite(value) ? Number(value).toFixed(digits) : 'n/a';
|
|
1059
|
+
}
|
|
1060
|
+
|
|
1061
|
+
function formatMs(value) {
|
|
1062
|
+
return Number.isFinite(value) ? `${Number(value).toFixed(1)}ms` : 'n/a';
|
|
1063
|
+
}
|
|
1064
|
+
|
|
1065
|
+
function quoteOneLine(value) {
|
|
1066
|
+
const s = String(value ?? '').replace(/\s+/g, ' ').trim();
|
|
1067
|
+
if (!s) return '""';
|
|
1068
|
+
const clipped = s.length > 120 ? `${s.slice(0, 117)}...` : s;
|
|
1069
|
+
return JSON.stringify(clipped);
|
|
1070
|
+
}
|
|
1071
|
+
|
|
1072
|
+
function quoteOneLineOrStructured(value) {
|
|
1073
|
+
if (typeof value === 'string') return quoteOneLine(value);
|
|
1074
|
+
if (value == null) return null;
|
|
1075
|
+
try {
|
|
1076
|
+
return quoteOneLine(JSON.stringify(value));
|
|
1077
|
+
} catch {
|
|
1078
|
+
return quoteOneLine(String(value));
|
|
1079
|
+
}
|
|
1080
|
+
}
|
|
1081
|
+
|
|
1082
|
+
function compactTimestamp() {
|
|
1083
|
+
return new Date().toISOString().replace(/[-:]/g, '').replace(/\.\d+Z$/, '');
|
|
1084
|
+
}
|
|
1085
|
+
|
|
1086
|
+
async function saveBenchResult(result, saveDir) {
|
|
1087
|
+
await fs.mkdir(saveDir, { recursive: true });
|
|
1088
|
+
const modelId = String(result?.modelId || 'unknown').replace(/[^a-zA-Z0-9_-]/g, '_');
|
|
1089
|
+
const ts = compactTimestamp();
|
|
1090
|
+
const filename = `${modelId}_${ts}.json`;
|
|
1091
|
+
const filePath = path.join(saveDir, filename);
|
|
1092
|
+
const json = JSON.stringify(result, null, 2);
|
|
1093
|
+
await fs.writeFile(filePath, json, 'utf-8');
|
|
1094
|
+
await fs.writeFile(path.join(saveDir, 'latest.json'), json, 'utf-8');
|
|
1095
|
+
return filePath;
|
|
1096
|
+
}
|
|
1097
|
+
|
|
1098
|
+
async function loadBaseline(comparePath, saveDir) {
|
|
1099
|
+
const resolved = comparePath === 'last'
|
|
1100
|
+
? path.join(saveDir, 'latest.json')
|
|
1101
|
+
: path.resolve(comparePath);
|
|
1102
|
+
try {
|
|
1103
|
+
const raw = await fs.readFile(resolved, 'utf-8');
|
|
1104
|
+
return JSON.parse(raw);
|
|
1105
|
+
} catch (error) {
|
|
1106
|
+
console.error(`[compare] failed to load baseline from ${resolved}: ${error.message}`);
|
|
1107
|
+
return null;
|
|
1108
|
+
}
|
|
1109
|
+
}
|
|
1110
|
+
|
|
1111
|
+
function normalizeBenchMetrics(result) {
|
|
1112
|
+
const m = result?.metrics;
|
|
1113
|
+
if (!m) return m;
|
|
1114
|
+
return {
|
|
1115
|
+
decodeTokensPerSec: m.decodeTokensPerSec,
|
|
1116
|
+
prefillTokensPerSec: m.prefillTokensPerSec,
|
|
1117
|
+
firstTokenMs: m.firstTokenMs,
|
|
1118
|
+
firstResponseMs: m.firstResponseMs,
|
|
1119
|
+
prefillMs: m.prefillMs,
|
|
1120
|
+
decodeMs: m.decodeMs,
|
|
1121
|
+
totalRunMs: m.totalRunMs,
|
|
1122
|
+
modelLoadMs: m.modelLoadMs,
|
|
1123
|
+
decodeMsPerTokenP50: m.decodeMsPerTokenP50,
|
|
1124
|
+
decodeMsPerTokenP95: m.decodeMsPerTokenP95,
|
|
1125
|
+
decodeMsPerTokenP99: m.decodeMsPerTokenP99,
|
|
1126
|
+
};
|
|
1127
|
+
}
|
|
1128
|
+
|
|
1129
|
+
function compareBenchResults(current, baseline) {
|
|
1130
|
+
const cm = normalizeBenchMetrics(current);
|
|
1131
|
+
const bm = normalizeBenchMetrics(baseline);
|
|
1132
|
+
if (!cm || !bm) {
|
|
1133
|
+
console.error('[compare] missing metrics in current or baseline result');
|
|
1134
|
+
return { regressions: [], improvements: [] };
|
|
1135
|
+
}
|
|
1136
|
+
|
|
1137
|
+
const isCrossEngine = (current?.env?.library) !== (baseline?.env?.library);
|
|
1138
|
+
const regressions = [];
|
|
1139
|
+
const improvements = [];
|
|
1140
|
+
|
|
1141
|
+
const metrics = [
|
|
1142
|
+
{ label: 'decode tok/s', cur: cm.decodeTokensPerSec, base: bm.decodeTokensPerSec, higherBetter: true },
|
|
1143
|
+
{ label: 'prefill tok/s', cur: cm.prefillTokensPerSec, base: bm.prefillTokensPerSec, higherBetter: true },
|
|
1144
|
+
{ label: 'first token', cur: cm.firstTokenMs, base: bm.firstTokenMs, higherBetter: false },
|
|
1145
|
+
{ label: 'prefill ms', cur: cm.prefillMs, base: bm.prefillMs, higherBetter: false },
|
|
1146
|
+
{ label: 'decode ms', cur: cm.decodeMs, base: bm.decodeMs, higherBetter: false },
|
|
1147
|
+
{ label: 'first response', cur: cm.firstResponseMs, base: bm.firstResponseMs, higherBetter: false },
|
|
1148
|
+
{ label: 'total run', cur: cm.totalRunMs, base: bm.totalRunMs, higherBetter: false },
|
|
1149
|
+
{ label: 'model load', cur: cm.modelLoadMs, base: bm.modelLoadMs, higherBetter: false },
|
|
1150
|
+
];
|
|
1151
|
+
|
|
1152
|
+
// GPU phase metrics only available in Doppler-vs-Doppler comparisons
|
|
1153
|
+
const cg = current?.metrics?.gpu;
|
|
1154
|
+
const bg = baseline?.metrics?.gpu;
|
|
1155
|
+
if (cg && bg) {
|
|
1156
|
+
metrics.push(
|
|
1157
|
+
{ label: 'gpu record ms', cur: cg.decodeRecordMs?.median, base: bg.decodeRecordMs?.median, higherBetter: false },
|
|
1158
|
+
{ label: 'gpu submit_wait', cur: cg.decodeSubmitWaitMs?.median, base: bg.decodeSubmitWaitMs?.median, higherBetter: false },
|
|
1159
|
+
{ label: 'gpu readback', cur: cg.decodeReadbackWaitMs?.median, base: bg.decodeReadbackWaitMs?.median, higherBetter: false },
|
|
1160
|
+
);
|
|
1161
|
+
}
|
|
1162
|
+
|
|
1163
|
+
const curLabel = isCrossEngine ? (current?.env?.library || 'current') : 'current';
|
|
1164
|
+
const baseLabel = isCrossEngine ? (baseline?.env?.library || 'baseline') : 'baseline';
|
|
1165
|
+
const baseModelId = baseline.modelId || 'unknown';
|
|
1166
|
+
console.log(`[compare] vs ${baseLabel} model=${baseModelId}`);
|
|
1167
|
+
console.log(`[compare] ${'metric'.padEnd(20)} ${baseLabel.padStart(14)} ${curLabel.padStart(14)} ${'delta'.padStart(10)}`);
|
|
1168
|
+
|
|
1169
|
+
for (const m of metrics) {
|
|
1170
|
+
if (!Number.isFinite(m.cur) || !Number.isFinite(m.base) || m.base === 0) continue;
|
|
1171
|
+
const deltaPct = ((m.cur - m.base) / Math.abs(m.base)) * 100;
|
|
1172
|
+
const sign = deltaPct >= 0 ? '+' : '';
|
|
1173
|
+
const deltaStr = `${sign}${deltaPct.toFixed(1)}%`;
|
|
1174
|
+
const isRegression = m.higherBetter ? deltaPct < -10 : deltaPct > 10;
|
|
1175
|
+
const isImprovement = m.higherBetter ? deltaPct > 10 : deltaPct < -10;
|
|
1176
|
+
const flag = isRegression ? ' !!REGRESSION' : isImprovement ? ' *improved' : '';
|
|
1177
|
+
console.log(`[compare] ${m.label.padEnd(20)} ${formatNumber(m.base, 1).padStart(14)} ${formatNumber(m.cur, 1).padStart(14)} ${deltaStr.padStart(10)}${flag}`);
|
|
1178
|
+
if (isRegression) regressions.push(m.label);
|
|
1179
|
+
if (isImprovement) improvements.push(m.label);
|
|
1180
|
+
}
|
|
1181
|
+
|
|
1182
|
+
if (regressions.length) {
|
|
1183
|
+
console.log(`[compare] ${regressions.length} regression(s) detected (>10% threshold)`);
|
|
1184
|
+
}
|
|
1185
|
+
return { regressions, improvements };
|
|
1186
|
+
}
|
|
1187
|
+
|
|
1188
|
+
async function loadManifest(manifestPath) {
|
|
1189
|
+
const raw = await fs.readFile(path.resolve(manifestPath), 'utf-8');
|
|
1190
|
+
const manifest = JSON.parse(raw);
|
|
1191
|
+
if (!manifest.runs || !Array.isArray(manifest.runs) || manifest.runs.length === 0) {
|
|
1192
|
+
throw new Error('manifest must have a non-empty "runs" array');
|
|
1193
|
+
}
|
|
1194
|
+
return manifest;
|
|
1195
|
+
}
|
|
1196
|
+
|
|
1197
|
+
function mergeRunConfig(base, ...overrides) {
|
|
1198
|
+
const merged = isPlainObject(base) ? { ...base } : {};
|
|
1199
|
+
for (const source of overrides) {
|
|
1200
|
+
if (!isPlainObject(source)) {
|
|
1201
|
+
continue;
|
|
1202
|
+
}
|
|
1203
|
+
for (const [key, value] of Object.entries(source)) {
|
|
1204
|
+
if ((key === 'browser' || key === 'bench') && isPlainObject(value)) {
|
|
1205
|
+
merged[key] = {
|
|
1206
|
+
...(isPlainObject(merged[key]) ? merged[key] : {}),
|
|
1207
|
+
...value,
|
|
1208
|
+
};
|
|
1209
|
+
continue;
|
|
1210
|
+
}
|
|
1211
|
+
merged[key] = value;
|
|
1212
|
+
}
|
|
1213
|
+
}
|
|
1214
|
+
return merged;
|
|
1215
|
+
}
|
|
1216
|
+
|
|
1217
|
+
async function runManifestSweep(manifest, commandContext, jsonOutput, policy = DEFAULT_CLI_POLICY) {
|
|
1218
|
+
const defaults = manifest.defaults || {};
|
|
1219
|
+
const results = [];
|
|
1220
|
+
|
|
1221
|
+
for (let i = 0; i < manifest.runs.length; i++) {
|
|
1222
|
+
const run = manifest.runs[i];
|
|
1223
|
+
const label = run.label || run.modelId || run.request?.modelId || `run-${i}`;
|
|
1224
|
+
if (!jsonOutput) {
|
|
1225
|
+
console.error(`[sweep] (${i + 1}/${manifest.runs.length}) ${label}`);
|
|
1226
|
+
}
|
|
1227
|
+
|
|
1228
|
+
const requestInput = {
|
|
1229
|
+
...commandContext.request,
|
|
1230
|
+
...(isPlainObject(defaults.request) ? defaults.request : {}),
|
|
1231
|
+
...(isPlainObject(run.request) ? run.request : {}),
|
|
1232
|
+
command: commandContext.request.command,
|
|
1233
|
+
};
|
|
1234
|
+
const modelId = asStringOrNull(run.modelId) || asStringOrNull(defaults.modelId);
|
|
1235
|
+
if (modelId) {
|
|
1236
|
+
requestInput.modelId = modelId;
|
|
1237
|
+
}
|
|
1238
|
+
const modelUrl = asStringOrNull(run.modelUrl) || asStringOrNull(defaults.modelUrl);
|
|
1239
|
+
if (modelUrl) {
|
|
1240
|
+
requestInput.modelUrl = modelUrl;
|
|
1241
|
+
}
|
|
1242
|
+
const runtimeProfile = asStringOrNull(run.runtimeProfile)
|
|
1243
|
+
|| asStringOrNull(defaults.runtimeProfile);
|
|
1244
|
+
if (runtimeProfile) {
|
|
1245
|
+
requestInput.runtimeProfile = runtimeProfile;
|
|
1246
|
+
}
|
|
1247
|
+
|
|
1248
|
+
const mergedRunConfig = mergeRunConfig(commandContext.runConfig, defaults.run, run.run);
|
|
1249
|
+
let request = null;
|
|
1250
|
+
let surface = commandContext.surface;
|
|
1251
|
+
try {
|
|
1252
|
+
request = normalizeToolingCommandRequest(requestInput);
|
|
1253
|
+
surface = commandContext.surfaceFromCli
|
|
1254
|
+
? commandContext.surface
|
|
1255
|
+
: resolveSurfaceForCommand(
|
|
1256
|
+
request.command,
|
|
1257
|
+
{ flags: { surface: null } },
|
|
1258
|
+
mergedRunConfig,
|
|
1259
|
+
policy
|
|
1260
|
+
);
|
|
1261
|
+
const response = surface === 'auto'
|
|
1262
|
+
? await runWithAutoSurface(request, mergedRunConfig, jsonOutput, policy)
|
|
1263
|
+
: await runCommandOnSurface(request, surface, mergedRunConfig, jsonOutput);
|
|
1264
|
+
results.push({ label, response, error: null });
|
|
1265
|
+
} catch (error) {
|
|
1266
|
+
results.push({
|
|
1267
|
+
label,
|
|
1268
|
+
response: null,
|
|
1269
|
+
error: createCliToolingErrorEnvelope(error, {
|
|
1270
|
+
surface: surface === 'auto' ? null : surface,
|
|
1271
|
+
request,
|
|
1272
|
+
}),
|
|
1273
|
+
});
|
|
1274
|
+
if (!jsonOutput) {
|
|
1275
|
+
console.error(`[sweep] ${label} FAILED: ${error.message}`);
|
|
1276
|
+
}
|
|
1277
|
+
}
|
|
1278
|
+
}
|
|
1279
|
+
|
|
1280
|
+
return results;
|
|
1281
|
+
}
|
|
1282
|
+
|
|
1283
|
+
function printManifestSummary(results) {
|
|
1284
|
+
const completed = results.filter((r) => r.response && !r.error);
|
|
1285
|
+
const failed = results.filter((r) => r.error);
|
|
1286
|
+
console.log(`[sweep] ${completed.length} completed, ${failed.length} failed`);
|
|
1287
|
+
|
|
1288
|
+
for (const r of results) {
|
|
1289
|
+
if (r.error) {
|
|
1290
|
+
console.log(` ${r.label.padEnd(30)} FAILED`);
|
|
1291
|
+
continue;
|
|
1292
|
+
}
|
|
1293
|
+
const m = r.response?.result?.metrics;
|
|
1294
|
+
if (!m) {
|
|
1295
|
+
console.log(` ${r.label.padEnd(30)} no metrics`);
|
|
1296
|
+
continue;
|
|
1297
|
+
}
|
|
1298
|
+
console.log(
|
|
1299
|
+
` ${r.label.padEnd(30)} ` +
|
|
1300
|
+
`${formatNumber(m.decodeTokensPerSec)} decode tok/s ` +
|
|
1301
|
+
`prefill=${formatNumber(m.prefillTokensPerSec)} ` +
|
|
1302
|
+
`first=${formatMs(m.firstTokenMs)}`
|
|
1303
|
+
);
|
|
1304
|
+
}
|
|
1305
|
+
}
|
|
1306
|
+
|
|
1307
|
+
function formatMB(bytes) {
|
|
1308
|
+
return Number.isFinite(bytes) ? `${(bytes / (1024 * 1024)).toFixed(1)}MB` : 'n/a';
|
|
1309
|
+
}
|
|
1310
|
+
|
|
1311
|
+
function printDeviceInfo(result) {
|
|
1312
|
+
const info = result?.deviceInfo;
|
|
1313
|
+
if (!info) return;
|
|
1314
|
+
const ai = info.adapterInfo;
|
|
1315
|
+
if (ai) {
|
|
1316
|
+
console.log(`[device] vendor=${ai.vendor || 'unknown'} arch=${ai.architecture || 'unknown'} device=${ai.device || 'unknown'}`);
|
|
1317
|
+
}
|
|
1318
|
+
console.log(
|
|
1319
|
+
`[device] f16=${info.hasF16 ? 'yes' : 'no'} subgroups=${info.hasSubgroups ? 'yes' : 'no'} timestamp_query=${info.hasTimestampQuery ? 'yes' : 'no'}`
|
|
1320
|
+
);
|
|
1321
|
+
}
|
|
1322
|
+
|
|
1323
|
+
function printGpuPhases(metrics) {
|
|
1324
|
+
const gpu = metrics?.gpu;
|
|
1325
|
+
if (!gpu) return;
|
|
1326
|
+
const rm = gpu.decodeRecordMs?.median;
|
|
1327
|
+
const sw = gpu.decodeSubmitWaitMs?.median;
|
|
1328
|
+
const rw = gpu.decodeReadbackWaitMs?.median;
|
|
1329
|
+
if (Number.isFinite(rm) || Number.isFinite(sw) || Number.isFinite(rw)) {
|
|
1330
|
+
console.log(`[gpu] decode record=${formatMs(rm)} submit_wait=${formatMs(sw)} readback_wait=${formatMs(rw)} (median)`);
|
|
1331
|
+
}
|
|
1332
|
+
const pm = gpu.prefillMs?.median;
|
|
1333
|
+
const dm = gpu.decodeMs?.median;
|
|
1334
|
+
if (Number.isFinite(pm) || Number.isFinite(dm)) {
|
|
1335
|
+
console.log(`[gpu] prefill=${formatMs(pm)} decode=${formatMs(dm)} (median gpu time)`);
|
|
1336
|
+
}
|
|
1337
|
+
}
|
|
1338
|
+
|
|
1339
|
+
function printMemoryReport(result) {
|
|
1340
|
+
const mem = result?.memoryStats;
|
|
1341
|
+
if (!mem) return;
|
|
1342
|
+
const parts = [`used=${formatMB(mem.used)}`];
|
|
1343
|
+
if (mem.pool && Number.isFinite(mem.pool.currentBytesAllocated)) {
|
|
1344
|
+
parts.push(`pool=${formatMB(mem.pool.currentBytesAllocated)}`);
|
|
1345
|
+
}
|
|
1346
|
+
if (mem.kvCache) {
|
|
1347
|
+
parts.push(`kv_cache=${formatMB(mem.kvCache.allocated)}`);
|
|
1348
|
+
if (Number.isFinite(mem.kvCache.seqLen) && Number.isFinite(mem.kvCache.maxSeqLen)) {
|
|
1349
|
+
parts.push(`(seq=${mem.kvCache.seqLen}/${mem.kvCache.maxSeqLen})`);
|
|
1350
|
+
}
|
|
1351
|
+
}
|
|
1352
|
+
console.log(`[memory] ${parts.join(' ')}`);
|
|
1353
|
+
}
|
|
1354
|
+
|
|
1355
|
+
function printExecutionContractSummary(result) {
|
|
1356
|
+
const artifact = result?.metrics?.executionContractArtifact;
|
|
1357
|
+
if (!artifact || typeof artifact !== 'object') return;
|
|
1358
|
+
const checks = Array.isArray(artifact.checks) ? artifact.checks : [];
|
|
1359
|
+
const passedChecks = checks.filter((entry) => entry?.ok === true).length;
|
|
1360
|
+
const session = artifact.session && typeof artifact.session === 'object'
|
|
1361
|
+
? artifact.session
|
|
1362
|
+
: null;
|
|
1363
|
+
const attentionPhases = artifact.steps?.attentionPhases && typeof artifact.steps.attentionPhases === 'object'
|
|
1364
|
+
? artifact.steps.attentionPhases
|
|
1365
|
+
: null;
|
|
1366
|
+
const parts = [
|
|
1367
|
+
`status=${artifact.ok === true ? 'pass' : 'fail'}`,
|
|
1368
|
+
checks.length > 0 ? `checks=${passedChecks}/${checks.length}` : 'checks=n/a',
|
|
1369
|
+
];
|
|
1370
|
+
if (session?.layout) {
|
|
1371
|
+
parts.push(`layout=${session.layout}`);
|
|
1372
|
+
}
|
|
1373
|
+
if (attentionPhases) {
|
|
1374
|
+
parts.push(
|
|
1375
|
+
`attn(prefill=${attentionPhases.prefill ?? 'n/a'},decode=${attentionPhases.decode ?? 'n/a'},both=${attentionPhases.both ?? 'n/a'})`
|
|
1376
|
+
);
|
|
1377
|
+
}
|
|
1378
|
+
console.log(`[contract] ${parts.join(' ')}`);
|
|
1379
|
+
if (artifact.ok !== true && Array.isArray(artifact.errors)) {
|
|
1380
|
+
for (const error of artifact.errors.slice(0, 3)) {
|
|
1381
|
+
console.log(`[contract] error=${quoteOneLine(error)}`);
|
|
1382
|
+
}
|
|
1383
|
+
}
|
|
1384
|
+
}
|
|
1385
|
+
|
|
1386
|
+
function printSimpleArtifactSummary(label, artifact) {
|
|
1387
|
+
if (!artifact || typeof artifact !== 'object') return;
|
|
1388
|
+
const checks = Array.isArray(artifact.checks) ? artifact.checks : [];
|
|
1389
|
+
const passedChecks = checks.filter((entry) => entry?.ok === true).length;
|
|
1390
|
+
console.log(
|
|
1391
|
+
`[${label}] status=${artifact.ok === true ? 'pass' : 'fail'} ` +
|
|
1392
|
+
`checks=${checks.length > 0 ? `${passedChecks}/${checks.length}` : 'n/a'}`
|
|
1393
|
+
);
|
|
1394
|
+
if (artifact.ok !== true && Array.isArray(artifact.errors)) {
|
|
1395
|
+
for (const error of artifact.errors.slice(0, 2)) {
|
|
1396
|
+
console.log(`[${label}] error=${quoteOneLine(error)}`);
|
|
1397
|
+
}
|
|
1398
|
+
}
|
|
1399
|
+
}
|
|
1400
|
+
|
|
1401
|
+
function printConvertContractSummary(result) {
|
|
1402
|
+
const artifact = result?.executionContractArtifact;
|
|
1403
|
+
if (!artifact || typeof artifact !== 'object') return;
|
|
1404
|
+
const checks = Array.isArray(artifact.checks) ? artifact.checks : [];
|
|
1405
|
+
const passedChecks = checks.filter((entry) => entry?.ok === true).length;
|
|
1406
|
+
const session = artifact.session && typeof artifact.session === 'object'
|
|
1407
|
+
? artifact.session
|
|
1408
|
+
: null;
|
|
1409
|
+
console.log(
|
|
1410
|
+
`[contract] status=${artifact.ok === true ? 'pass' : 'fail'} ` +
|
|
1411
|
+
`checks=${checks.length > 0 ? `${passedChecks}/${checks.length}` : 'n/a'} ` +
|
|
1412
|
+
`layout=${session?.layout ?? 'n/a'}`
|
|
1413
|
+
);
|
|
1414
|
+
if (artifact.ok !== true && Array.isArray(artifact.errors)) {
|
|
1415
|
+
for (const error of artifact.errors.slice(0, 3)) {
|
|
1416
|
+
console.log(`[contract] error=${quoteOneLine(error)}`);
|
|
1417
|
+
}
|
|
1418
|
+
}
|
|
1419
|
+
printSimpleArtifactSummary('layer-pattern', result?.layerPatternContractArtifact);
|
|
1420
|
+
printSimpleArtifactSummary('required-inference', result?.requiredInferenceFieldsArtifact);
|
|
1421
|
+
}
|
|
1422
|
+
|
|
1423
|
+
function printConvertReportSummary(result) {
|
|
1424
|
+
const reportInfo = result?.reportInfo;
|
|
1425
|
+
if (!reportInfo || typeof reportInfo !== 'object') return;
|
|
1426
|
+
if (typeof reportInfo.path !== 'string' || reportInfo.path.length === 0) return;
|
|
1427
|
+
console.log(`[report] ${reportInfo.path}`);
|
|
1428
|
+
}
|
|
1429
|
+
|
|
1430
|
+
function printMetricsSummary(result) {
|
|
1431
|
+
if (!result || typeof result !== 'object') return;
|
|
1432
|
+
if (result.kind === 'distill') {
|
|
1433
|
+
const stageCount = Array.isArray(result.stageResults) ? result.stageResults.length : 0;
|
|
1434
|
+
console.log(
|
|
1435
|
+
`[metrics] kind=distill action=${result.action || 'run'} stages=${stageCount} runRoot=${quoteOneLine(result.runRoot)}`
|
|
1436
|
+
);
|
|
1437
|
+
return;
|
|
1438
|
+
}
|
|
1439
|
+
if (result.kind === 'lora') {
|
|
1440
|
+
const exportCount = Array.isArray(result.exports) ? result.exports.length : 0;
|
|
1441
|
+
console.log(
|
|
1442
|
+
`[metrics] kind=lora action=${result.action || 'run'} exports=${exportCount} runRoot=${quoteOneLine(result.runRoot)}`
|
|
1443
|
+
);
|
|
1444
|
+
return;
|
|
1445
|
+
}
|
|
1446
|
+
const suite = String(result.suite || '');
|
|
1447
|
+
const metrics = result.metrics;
|
|
1448
|
+
if (!metrics || typeof metrics !== 'object') return;
|
|
1449
|
+
|
|
1450
|
+
if (suite === 'inference' || suite === 'debug') {
|
|
1451
|
+
const prompt = quoteOneLine(metrics.prompt);
|
|
1452
|
+
console.log(`[metrics] prompt=${prompt}`);
|
|
1453
|
+
console.log(
|
|
1454
|
+
`[metrics] load=${formatMs(metrics.modelLoadMs)} ` +
|
|
1455
|
+
`prefillTokens=${Number.isFinite(metrics.prefillTokens) ? Math.round(metrics.prefillTokens) : 'n/a'} ` +
|
|
1456
|
+
`decodeTokens=${Number.isFinite(metrics.decodeTokens) ? Math.round(metrics.decodeTokens) : 'n/a'} ` +
|
|
1457
|
+
`maxTokens=${Number.isFinite(metrics.maxTokens) ? Math.round(metrics.maxTokens) : 'n/a'}`
|
|
1458
|
+
);
|
|
1459
|
+
console.log(
|
|
1460
|
+
`[metrics] first=${formatMs(metrics.firstTokenMs)} prefill=${formatMs(metrics.prefillMs)} ` +
|
|
1461
|
+
`decode=${formatMs(metrics.decodeMs)} total=${formatMs(metrics.totalRunMs)}`
|
|
1462
|
+
);
|
|
1463
|
+
console.log(
|
|
1464
|
+
`[metrics] tok/s=${formatNumber(metrics.decodeTokensPerSec)} ` +
|
|
1465
|
+
`prefill=${formatNumber(metrics.prefillTokensPerSec)} ` +
|
|
1466
|
+
`decode=${formatNumber(metrics.decodeTokensPerSec)}`
|
|
1467
|
+
);
|
|
1468
|
+
if (typeof result.output === 'string' && result.output.length > 0) {
|
|
1469
|
+
console.log(`[output] ${quoteOneLine(result.output)}`);
|
|
1470
|
+
}
|
|
1471
|
+
printExecutionContractSummary(result);
|
|
1472
|
+
return;
|
|
1473
|
+
}
|
|
1474
|
+
|
|
1475
|
+
if (suite === 'bench') {
|
|
1476
|
+
if (Number.isFinite(metrics.embeddingDim) || Number.isFinite(metrics.avgEmbeddingMs)) {
|
|
1477
|
+
console.log(`[metrics] prompt=${quoteOneLine(metrics.prompt)}`);
|
|
1478
|
+
console.log(
|
|
1479
|
+
`[metrics] load=${formatMs(metrics.modelLoadMs)} runs=${Number.isFinite(metrics.warmupRuns) ? metrics.warmupRuns : 'n/a'}+${Number.isFinite(metrics.timedRuns) ? metrics.timedRuns : 'n/a'}`
|
|
1480
|
+
);
|
|
1481
|
+
console.log(
|
|
1482
|
+
`[metrics] embedding dim=${Number.isFinite(metrics.embeddingDim) ? Math.round(metrics.embeddingDim) : 'n/a'} ` +
|
|
1483
|
+
`median=${formatMs(metrics.medianEmbeddingMs)} avg=${formatMs(metrics.avgEmbeddingMs)} ` +
|
|
1484
|
+
`eps=${formatNumber(metrics.avgEmbeddingsPerSec)}`
|
|
1485
|
+
);
|
|
1486
|
+
printExecutionContractSummary(result);
|
|
1487
|
+
return;
|
|
1488
|
+
}
|
|
1489
|
+
|
|
1490
|
+
console.log(`[metrics] prompt=${quoteOneLine(metrics.prompt)}`);
|
|
1491
|
+
console.log(
|
|
1492
|
+
`[metrics] load=${formatMs(metrics.modelLoadMs)} runs=${Number.isFinite(metrics.warmupRuns) ? metrics.warmupRuns : 'n/a'}+${Number.isFinite(metrics.timedRuns) ? metrics.timedRuns : 'n/a'} ` +
|
|
1493
|
+
`maxTokens=${Number.isFinite(metrics.maxTokens) ? Math.round(metrics.maxTokens) : 'n/a'}`
|
|
1494
|
+
);
|
|
1495
|
+
console.log(
|
|
1496
|
+
`[metrics] tokens prefill(avg)=${Number.isFinite(metrics.avgPrefillTokens) ? Math.round(metrics.avgPrefillTokens) : 'n/a'} ` +
|
|
1497
|
+
`decode(avg)=${Number.isFinite(metrics.avgDecodeTokens) ? Math.round(metrics.avgDecodeTokens) : 'n/a'} ` +
|
|
1498
|
+
`generated(avg)=${Number.isFinite(metrics.avgTokensGenerated) ? Math.round(metrics.avgTokensGenerated) : 'n/a'}`
|
|
1499
|
+
);
|
|
1500
|
+
console.log(
|
|
1501
|
+
`[metrics] decode tok/s=${formatNumber(metrics.decodeTokensPerSec)} avg=${formatNumber(metrics.avgDecodeTokensPerSec)} ` +
|
|
1502
|
+
`prefill=${formatNumber(metrics.prefillTokensPerSec)} avg=${formatNumber(metrics.avgPrefillTokensPerSec)}`
|
|
1503
|
+
);
|
|
1504
|
+
console.log(
|
|
1505
|
+
`[metrics] latency first=${formatMs(metrics.firstTokenMs)} ` +
|
|
1506
|
+
`prefill=${formatMs(metrics.prefillMs)} decode=${formatMs(metrics.decodeMs)}`
|
|
1507
|
+
);
|
|
1508
|
+
printExecutionContractSummary(result);
|
|
1509
|
+
printDeviceInfo(result);
|
|
1510
|
+
printGpuPhases(metrics);
|
|
1511
|
+
printMemoryReport(result);
|
|
1512
|
+
const samplePrompt = quoteOneLineOrStructured(metrics.promptInput);
|
|
1513
|
+
if (samplePrompt !== null) {
|
|
1514
|
+
console.log(`[sample] prompt=${samplePrompt}`);
|
|
1515
|
+
}
|
|
1516
|
+
if (typeof metrics.generatedText === 'string' && metrics.generatedText.length > 0) {
|
|
1517
|
+
console.log(`[sample] text=${quoteOneLine(metrics.generatedText)}`);
|
|
1518
|
+
}
|
|
1519
|
+
return;
|
|
1520
|
+
}
|
|
1521
|
+
|
|
1522
|
+
if (suite === 'training') {
|
|
1523
|
+
const selectedTests = Array.isArray(metrics.selectedTests)
|
|
1524
|
+
? metrics.selectedTests.length
|
|
1525
|
+
: 'n/a';
|
|
1526
|
+
const availableTests = Array.isArray(metrics.availableTests)
|
|
1527
|
+
? metrics.availableTests.length
|
|
1528
|
+
: 'n/a';
|
|
1529
|
+
const stage = typeof metrics.trainingStage === 'string' ? metrics.trainingStage : 'n/a';
|
|
1530
|
+
console.log(
|
|
1531
|
+
`[metrics] training tests=${Number.isFinite(metrics.testsRun) ? metrics.testsRun : 'n/a'} ` +
|
|
1532
|
+
`selected=${selectedTests} available=${availableTests} stage=${stage}`
|
|
1533
|
+
);
|
|
1534
|
+
}
|
|
1535
|
+
}
|
|
1536
|
+
|
|
1537
|
+
async function main() {
|
|
1538
|
+
const argv = process.argv.slice(2);
|
|
1539
|
+
const jsonOutputRequested = !argv.includes('--pretty');
|
|
1540
|
+
const errorContext = {
|
|
1541
|
+
surface: null,
|
|
1542
|
+
request: null,
|
|
1543
|
+
};
|
|
1544
|
+
|
|
1545
|
+
try {
|
|
1546
|
+
if (!argv.length || argv[0] === '--help' || argv[0] === '-h') {
|
|
1547
|
+
console.log(usage());
|
|
1548
|
+
return;
|
|
1549
|
+
}
|
|
1550
|
+
|
|
1551
|
+
const cliPolicy = await readJsonObjectFile(CLI_POLICY_PATH, '--cli-policy');
|
|
1552
|
+
const parsed = parseArgs(argv);
|
|
1553
|
+
if (parsed.flags.help === true || parsed.flags.h === true) {
|
|
1554
|
+
console.log(usage());
|
|
1555
|
+
return;
|
|
1556
|
+
}
|
|
1557
|
+
validateCommandFlags(parsed);
|
|
1558
|
+
|
|
1559
|
+
const jsonOutput = parsed.flags.pretty !== true;
|
|
1560
|
+
const commandContext = await buildRequest(parsed, cliPolicy);
|
|
1561
|
+
const { request, runConfig, surface, surfaceFromCli, benchRunOptions } = commandContext;
|
|
1562
|
+
errorContext.surface = surface === 'auto' ? null : surface;
|
|
1563
|
+
errorContext.request = request;
|
|
1564
|
+
const { saveDir, shouldSave, comparePath, manifestPath } = benchRunOptions;
|
|
1565
|
+
|
|
1566
|
+
if (manifestPath) {
|
|
1567
|
+
const manifest = await loadManifest(String(manifestPath));
|
|
1568
|
+
const results = await runManifestSweep(
|
|
1569
|
+
manifest,
|
|
1570
|
+
{
|
|
1571
|
+
request,
|
|
1572
|
+
runConfig,
|
|
1573
|
+
surface,
|
|
1574
|
+
surfaceFromCli,
|
|
1575
|
+
},
|
|
1576
|
+
jsonOutput,
|
|
1577
|
+
cliPolicy
|
|
1578
|
+
);
|
|
1579
|
+
|
|
1580
|
+
if (shouldSave) {
|
|
1581
|
+
for (const r of results) {
|
|
1582
|
+
if (r.response?.result) {
|
|
1583
|
+
const savedPath = await saveBenchResult(r.response.result, saveDir);
|
|
1584
|
+
if (!jsonOutput) console.error(`[save] ${r.label}: ${savedPath}`);
|
|
1585
|
+
}
|
|
1586
|
+
}
|
|
1587
|
+
}
|
|
1588
|
+
|
|
1589
|
+
if (jsonOutput) {
|
|
1590
|
+
console.log(JSON.stringify(results.map((r) => r.response ?? r.error), null, 2));
|
|
1591
|
+
return;
|
|
1592
|
+
}
|
|
1593
|
+
|
|
1594
|
+
printManifestSummary(results);
|
|
1595
|
+
for (const r of results) {
|
|
1596
|
+
if (r.response?.result) {
|
|
1597
|
+
console.log(`\n--- ${r.label} ---`);
|
|
1598
|
+
printMetricsSummary(r.response.result);
|
|
1599
|
+
}
|
|
1600
|
+
}
|
|
1601
|
+
return;
|
|
1602
|
+
}
|
|
1603
|
+
|
|
1604
|
+
let response;
|
|
1605
|
+
if (surface === 'auto') {
|
|
1606
|
+
response = await runWithAutoSurface(request, runConfig, jsonOutput, cliPolicy);
|
|
1607
|
+
} else {
|
|
1608
|
+
response = await runCommandOnSurface(request, surface, runConfig, jsonOutput);
|
|
1609
|
+
}
|
|
1610
|
+
|
|
1611
|
+
const isBench = response.result?.suite === 'bench';
|
|
1612
|
+
|
|
1613
|
+
if (comparePath && isBench) {
|
|
1614
|
+
const baseline = await loadBaseline(String(comparePath), saveDir);
|
|
1615
|
+
if (baseline) {
|
|
1616
|
+
compareBenchResults(response.result, baseline);
|
|
1617
|
+
}
|
|
1618
|
+
}
|
|
1619
|
+
|
|
1620
|
+
if (shouldSave && isBench) {
|
|
1621
|
+
const savedPath = await saveBenchResult(response.result, saveDir);
|
|
1622
|
+
if (!jsonOutput) {
|
|
1623
|
+
console.error(`[save] ${savedPath}`);
|
|
1624
|
+
}
|
|
1625
|
+
}
|
|
1626
|
+
|
|
1627
|
+
if (jsonOutput) {
|
|
1628
|
+
const output = response?.result?.report !== undefined
|
|
1629
|
+
? { ...response, result: { ...response.result, report: undefined } }
|
|
1630
|
+
: response;
|
|
1631
|
+
console.log(JSON.stringify(output, null, 2));
|
|
1632
|
+
return;
|
|
1633
|
+
}
|
|
1634
|
+
|
|
1635
|
+
console.log(`[ok] ${toSummary(response.result)}`);
|
|
1636
|
+
printConvertContractSummary(response.result);
|
|
1637
|
+
printConvertReportSummary(response.result);
|
|
1638
|
+
printMetricsSummary(response.result);
|
|
1639
|
+
} catch (error) {
|
|
1640
|
+
if (jsonOutputRequested) {
|
|
1641
|
+
console.log(JSON.stringify(createCliToolingErrorEnvelope(error, errorContext), null, 2));
|
|
1642
|
+
process.exitCode = 1;
|
|
1643
|
+
return;
|
|
1644
|
+
}
|
|
1645
|
+
throw error;
|
|
1646
|
+
}
|
|
1647
|
+
}
|
|
1648
|
+
|
|
1649
|
+
function isMainModule(metaUrl) {
|
|
1650
|
+
const entryPath = process.argv[1];
|
|
1651
|
+
if (!entryPath) {
|
|
1652
|
+
return false;
|
|
1653
|
+
}
|
|
1654
|
+
return path.resolve(fileURLToPath(metaUrl)) === path.resolve(entryPath);
|
|
1655
|
+
}
|
|
1656
|
+
|
|
1657
|
+
if (isMainModule(import.meta.url)) {
|
|
1658
|
+
main().then(() => {
|
|
1659
|
+
process.exit(process.exitCode ?? 0);
|
|
1660
|
+
}).catch((error) => {
|
|
1661
|
+
console.error(`[error] ${error?.message || String(error)}`);
|
|
1662
|
+
process.exit(1);
|
|
1663
|
+
});
|
|
1664
|
+
}
|