@qvac/inference 0.0.0 → 0.17.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/LICENSE +179 -0
- package/NOTICE +986 -0
- package/README.md +138 -0
- package/dist/api/audio-gen.d.ts +18 -0
- package/dist/api/audio-gen.js +148 -0
- package/dist/api/batch-completion.d.ts +14 -0
- package/dist/api/batch-completion.js +332 -0
- package/dist/api/bci-transcribe.d.ts +56 -0
- package/dist/api/bci-transcribe.js +172 -0
- package/dist/api/cancel.d.ts +34 -0
- package/dist/api/cancel.js +82 -0
- package/dist/api/classify.d.ts +22 -0
- package/dist/api/classify.js +46 -0
- package/dist/api/completion-stream.d.ts +106 -0
- package/dist/api/completion-stream.js +351 -0
- package/dist/api/delete-cache.d.ts +29 -0
- package/dist/api/delete-cache.js +49 -0
- package/dist/api/diffusion.d.ts +92 -0
- package/dist/api/diffusion.js +176 -0
- package/dist/api/download-asset.d.ts +49 -0
- package/dist/api/download-asset.js +87 -0
- package/dist/api/embed.d.ts +41 -0
- package/dist/api/embed.js +29 -0
- package/dist/api/finetune.d.ts +89 -0
- package/dist/api/finetune.js +138 -0
- package/dist/api/get-loaded-model-info.d.ts +24 -0
- package/dist/api/get-loaded-model-info.js +34 -0
- package/dist/api/get-model-info.d.ts +43 -0
- package/dist/api/get-model-info.js +21 -0
- package/dist/api/get-system-resources.d.ts +2 -0
- package/dist/api/get-system-resources.js +16 -0
- package/dist/api/heartbeat.d.ts +29 -0
- package/dist/api/heartbeat.js +37 -0
- package/dist/api/index.d.ts +35 -0
- package/dist/api/index.js +35 -0
- package/dist/api/invoke-plugin.d.ts +30 -0
- package/dist/api/invoke-plugin.js +54 -0
- package/dist/api/load-model.d.ts +169 -0
- package/dist/api/load-model.js +129 -0
- package/dist/api/logging-stream-registry.d.ts +4 -0
- package/dist/api/logging-stream-registry.js +61 -0
- package/dist/api/logging-stream.d.ts +23 -0
- package/dist/api/logging-stream.js +36 -0
- package/dist/api/ocr.d.ts +30 -0
- package/dist/api/ocr.js +88 -0
- package/dist/api/parse-input.d.ts +2 -0
- package/dist/api/parse-input.js +14 -0
- package/dist/api/provide.d.ts +23 -0
- package/dist/api/provide.js +32 -0
- package/dist/api/rag.d.ts +251 -0
- package/dist/api/rag.js +485 -0
- package/dist/api/registry.d.ts +39 -0
- package/dist/api/registry.js +63 -0
- package/dist/api/resume.d.ts +29 -0
- package/dist/api/resume.js +36 -0
- package/dist/api/state.d.ts +22 -0
- package/dist/api/state.js +29 -0
- package/dist/api/stop-provider.d.ts +20 -0
- package/dist/api/stop-provider.js +30 -0
- package/dist/api/subscribe-logs.d.ts +27 -0
- package/dist/api/subscribe-logs.js +43 -0
- package/dist/api/suspend.d.ts +30 -0
- package/dist/api/suspend.js +37 -0
- package/dist/api/text-to-speech.d.ts +64 -0
- package/dist/api/text-to-speech.js +434 -0
- package/dist/api/transcribe.d.ts +75 -0
- package/dist/api/transcribe.js +256 -0
- package/dist/api/translate.d.ts +47 -0
- package/dist/api/translate.js +115 -0
- package/dist/api/unload-model.d.ts +17 -0
- package/dist/api/unload-model.js +42 -0
- package/dist/api/upscale.d.ts +44 -0
- package/dist/api/upscale.js +99 -0
- package/dist/api/video.d.ts +86 -0
- package/dist/api/video.js +176 -0
- package/dist/api/vla-helpers.d.ts +43 -0
- package/dist/api/vla-helpers.js +124 -0
- package/dist/api/vla.d.ts +68 -0
- package/dist/api/vla.js +113 -0
- package/dist/config/config-utils.d.ts +4 -0
- package/dist/config/config-utils.js +18 -0
- package/dist/config/resolve-config.d.ts +8 -0
- package/dist/config/resolve-config.js +74 -0
- package/dist/constants/audio.d.ts +1 -0
- package/dist/constants/audio.js +1 -0
- package/dist/constants/index.d.ts +2 -0
- package/dist/constants/index.js +2 -0
- package/dist/constants/registry.d.ts +1 -0
- package/dist/constants/registry.js +1 -0
- package/dist/dispatch.d.ts +18 -0
- package/dist/dispatch.js +271 -0
- package/dist/engine.d.ts +5 -0
- package/dist/engine.js +27 -0
- package/dist/errors/index.d.ts +416 -0
- package/dist/errors/index.js +681 -0
- package/dist/errors/options.d.ts +2 -0
- package/dist/errors/options.js +13 -0
- package/dist/handlers/cancelHandler.d.ts +29 -0
- package/dist/handlers/cancelHandler.js +67 -0
- package/dist/handlers/completion-orchestrate.d.ts +41 -0
- package/dist/handlers/completion-orchestrate.js +190 -0
- package/dist/handlers/delete-cache.d.ts +11 -0
- package/dist/handlers/delete-cache.js +37 -0
- package/dist/handlers/download-asset.d.ts +2 -0
- package/dist/handlers/download-asset.js +146 -0
- package/dist/handlers/finetune.d.ts +2 -0
- package/dist/handlers/finetune.js +18 -0
- package/dist/handlers/get-loaded-model-info.d.ts +2 -0
- package/dist/handlers/get-loaded-model-info.js +45 -0
- package/dist/handlers/get-model-info.d.ts +2 -0
- package/dist/handlers/get-model-info.js +173 -0
- package/dist/handlers/get-system-resources.d.ts +2 -0
- package/dist/handlers/get-system-resources.js +53 -0
- package/dist/handlers/heartbeat.d.ts +2 -0
- package/dist/handlers/heartbeat.js +3 -0
- package/dist/handlers/load-model/download-manager.d.ts +95 -0
- package/dist/handlers/load-model/download-manager.js +306 -0
- package/dist/handlers/load-model/download-stats.d.ts +7 -0
- package/dist/handlers/load-model/download-stats.js +126 -0
- package/dist/handlers/load-model/handler.d.ts +2 -0
- package/dist/handlers/load-model/handler.js +287 -0
- package/dist/handlers/load-model/http.d.ts +3 -0
- package/dist/handlers/load-model/http.js +857 -0
- package/dist/handlers/load-model/hyperdrive.d.ts +4 -0
- package/dist/handlers/load-model/hyperdrive.js +560 -0
- package/dist/handlers/load-model/index.d.ts +2 -0
- package/dist/handlers/load-model/index.js +2 -0
- package/dist/handlers/load-model/registry-client-options.d.ts +27 -0
- package/dist/handlers/load-model/registry-client-options.js +18 -0
- package/dist/handlers/load-model/registry-companion-set.d.ts +22 -0
- package/dist/handlers/load-model/registry-companion-set.js +206 -0
- package/dist/handlers/load-model/registry-download-utils.d.ts +23 -0
- package/dist/handlers/load-model/registry-download-utils.js +112 -0
- package/dist/handlers/load-model/registry-metadata.d.ts +10 -0
- package/dist/handlers/load-model/registry-metadata.js +23 -0
- package/dist/handlers/load-model/registry.d.ts +4 -0
- package/dist/handlers/load-model/registry.js +298 -0
- package/dist/handlers/load-model/resolve-session.d.ts +33 -0
- package/dist/handlers/load-model/resolve-session.js +62 -0
- package/dist/handlers/load-model/resolve.d.ts +5 -0
- package/dist/handlers/load-model/resolve.js +158 -0
- package/dist/handlers/load-model/types.d.ts +59 -0
- package/dist/handlers/load-model/types.js +28 -0
- package/dist/handlers/logging-stream.d.ts +2 -0
- package/dist/handlers/logging-stream.js +39 -0
- package/dist/handlers/plugin-dispatch.d.ts +3 -0
- package/dist/handlers/plugin-dispatch.js +63 -0
- package/dist/handlers/plugin-invoke.d.ts +3 -0
- package/dist/handlers/plugin-invoke.js +81 -0
- package/dist/handlers/registry.d.ts +4 -0
- package/dist/handlers/registry.js +156 -0
- package/dist/handlers/resume.d.ts +2 -0
- package/dist/handlers/resume.js +11 -0
- package/dist/handlers/state.d.ts +2 -0
- package/dist/handlers/state.js +7 -0
- package/dist/handlers/suspend.d.ts +2 -0
- package/dist/handlers/suspend.js +11 -0
- package/dist/handlers/types.d.ts +13 -0
- package/dist/handlers/types.js +1 -0
- package/dist/handlers/unload-model.d.ts +2 -0
- package/dist/handlers/unload-model.js +29 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +12 -0
- package/dist/logging/addon.d.ts +5 -0
- package/dist/logging/addon.js +75 -0
- package/dist/logging/index.d.ts +5 -0
- package/dist/logging/index.js +4 -0
- package/dist/logging/logger.d.ts +41 -0
- package/dist/logging/logger.js +209 -0
- package/dist/logging/namespaces.d.ts +6 -0
- package/dist/logging/namespaces.js +7 -0
- package/dist/logging/types.d.ts +37 -0
- package/dist/logging/types.js +1 -0
- package/dist/logging/utils.d.ts +5 -0
- package/dist/logging/utils.js +113 -0
- package/dist/models/registry/index.d.ts +18 -0
- package/dist/models/registry/index.js +21 -0
- package/dist/models/registry/models.d.ts +22680 -0
- package/dist/models/registry/models.js +23908 -0
- package/dist/p2p/cancel-delegated.d.ts +3 -0
- package/dist/p2p/cancel-delegated.js +64 -0
- package/dist/p2p/completion-stream-delegated.d.ts +4 -0
- package/dist/p2p/completion-stream-delegated.js +51 -0
- package/dist/p2p/delegate-client.d.ts +9 -0
- package/dist/p2p/delegate-client.js +219 -0
- package/dist/p2p/delegate-connect-diagnostics.d.ts +8 -0
- package/dist/p2p/delegate-connect-diagnostics.js +38 -0
- package/dist/p2p/delegate-transport.d.ts +18 -0
- package/dist/p2p/delegate-transport.js +237 -0
- package/dist/p2p/error-handlers.d.ts +4 -0
- package/dist/p2p/error-handlers.js +31 -0
- package/dist/p2p/handle-request.d.ts +2 -0
- package/dist/p2p/handle-request.js +171 -0
- package/dist/p2p/handler-utils.d.ts +19 -0
- package/dist/p2p/handler-utils.js +180 -0
- package/dist/p2p/heartbeat-delegated.d.ts +3 -0
- package/dist/p2p/heartbeat-delegated.js +32 -0
- package/dist/p2p/load-model-delegated.d.ts +6 -0
- package/dist/p2p/load-model-delegated.js +132 -0
- package/dist/p2p/progress-throttle.d.ts +7 -0
- package/dist/p2p/progress-throttle.js +47 -0
- package/dist/p2p/provideHandler/connection.d.ts +2 -0
- package/dist/p2p/provideHandler/connection.js +38 -0
- package/dist/p2p/provideHandler/handler.d.ts +2 -0
- package/dist/p2p/provideHandler/handler.js +66 -0
- package/dist/p2p/provideHandler/proxy.d.ts +2 -0
- package/dist/p2p/provideHandler/proxy.js +24 -0
- package/dist/p2p/provideHandler.d.ts +1 -0
- package/dist/p2p/provideHandler.js +2 -0
- package/dist/p2p/rpc-utils.d.ts +4 -0
- package/dist/p2p/rpc-utils.js +8 -0
- package/dist/p2p/stopProvideHandler.d.ts +2 -0
- package/dist/p2p/stopProvideHandler.js +29 -0
- package/dist/p2p/swarm.d.ts +9 -0
- package/dist/p2p/swarm.js +103 -0
- package/dist/p2p/transport-selector.d.ts +2 -0
- package/dist/p2p/transport-selector.js +18 -0
- package/dist/p2p/unload-model-delegated.d.ts +2 -0
- package/dist/p2p/unload-model-delegated.js +31 -0
- package/dist/plugins/builtin/asr-ggml/config.d.ts +31 -0
- package/dist/plugins/builtin/asr-ggml/config.js +46 -0
- package/dist/plugins/builtin/asr-ggml/logging.d.ts +10 -0
- package/dist/plugins/builtin/asr-ggml/logging.js +12 -0
- package/dist/plugins/builtin/audiogen-ggml/config.d.ts +17 -0
- package/dist/plugins/builtin/audiogen-ggml/config.js +23 -0
- package/dist/plugins/builtin/audiogen-ggml/ops/audio-gen-stream.d.ts +2 -0
- package/dist/plugins/builtin/audiogen-ggml/ops/audio-gen-stream.js +163 -0
- package/dist/plugins/builtin/audiogen-ggml/plugin.d.ts +212 -0
- package/dist/plugins/builtin/audiogen-ggml/plugin.js +58 -0
- package/dist/plugins/builtin/bci-whispercpp-transcription/args.d.ts +2 -0
- package/dist/plugins/builtin/bci-whispercpp-transcription/args.js +13 -0
- package/dist/plugins/builtin/bci-whispercpp-transcription/plugin.d.ts +173 -0
- package/dist/plugins/builtin/bci-whispercpp-transcription/plugin.js +111 -0
- package/dist/plugins/builtin/bci-whispercpp-transcription/resolve-config.d.ts +74 -0
- package/dist/plugins/builtin/bci-whispercpp-transcription/resolve-config.js +11 -0
- package/dist/plugins/builtin/ggml-classification/ops/classify.d.ts +5 -0
- package/dist/plugins/builtin/ggml-classification/ops/classify.js +31 -0
- package/dist/plugins/builtin/ggml-classification/plugin.d.ts +31 -0
- package/dist/plugins/builtin/ggml-classification/plugin.js +55 -0
- package/dist/plugins/builtin/ggml-ocr/ops/ocr-stream.d.ts +7 -0
- package/dist/plugins/builtin/ggml-ocr/ops/ocr-stream.js +119 -0
- package/dist/plugins/builtin/ggml-ocr/plugin.d.ts +102 -0
- package/dist/plugins/builtin/ggml-ocr/plugin.js +110 -0
- package/dist/plugins/builtin/ggml-ocr/resolve-config.d.ts +5 -0
- package/dist/plugins/builtin/ggml-ocr/resolve-config.js +72 -0
- package/dist/plugins/builtin/ggml-vla/ops/vla-hparams.d.ts +2 -0
- package/dist/plugins/builtin/ggml-vla/ops/vla-hparams.js +12 -0
- package/dist/plugins/builtin/ggml-vla/ops/vla-run.d.ts +2 -0
- package/dist/plugins/builtin/ggml-vla/ops/vla-run.js +78 -0
- package/dist/plugins/builtin/ggml-vla/plugin.d.ts +65 -0
- package/dist/plugins/builtin/ggml-vla/plugin.js +57 -0
- package/dist/plugins/builtin/index.d.ts +11 -0
- package/dist/plugins/builtin/index.js +11 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/batch-cancelled.d.ts +22 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/batch-cancelled.js +30 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/batch-completion-stream.d.ts +31 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/batch-completion-stream.js +99 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/cache-logger.d.ts +6 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/cache-logger.js +36 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/completion-stats.d.ts +20 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/completion-stats.js +48 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/completion-stream.d.ts +45 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/completion-stream.js +374 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/context-overflow.d.ts +28 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/context-overflow.js +65 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/finetune.d.ts +10 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/finetune.js +209 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/kv-cache-session.d.ts +163 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/kv-cache-session.js +581 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/kv-cache-state.d.ts +56 -0
- package/dist/plugins/builtin/llamacpp-completion/ops/kv-cache-state.js +58 -0
- package/dist/plugins/builtin/llamacpp-completion/plugin.d.ts +671 -0
- package/dist/plugins/builtin/llamacpp-completion/plugin.js +481 -0
- package/dist/plugins/builtin/llamacpp-completion/transform.d.ts +9 -0
- package/dist/plugins/builtin/llamacpp-completion/transform.js +34 -0
- package/dist/plugins/builtin/llamacpp-embedding/plugin.d.ts +76 -0
- package/dist/plugins/builtin/llamacpp-embedding/plugin.js +101 -0
- package/dist/plugins/builtin/nmtcpp-translation/plugin.d.ts +457 -0
- package/dist/plugins/builtin/nmtcpp-translation/plugin.js +143 -0
- package/dist/plugins/builtin/nmtcpp-translation/resolve-vocab.d.ts +31 -0
- package/dist/plugins/builtin/nmtcpp-translation/resolve-vocab.js +114 -0
- package/dist/plugins/builtin/parakeet-transcription/plugin.d.ts +133 -0
- package/dist/plugins/builtin/parakeet-transcription/plugin.js +130 -0
- package/dist/plugins/builtin/sdcpp-generation/ops/diffusion.d.ts +2 -0
- package/dist/plugins/builtin/sdcpp-generation/ops/diffusion.js +64 -0
- package/dist/plugins/builtin/sdcpp-generation/ops/upscale.d.ts +2 -0
- package/dist/plugins/builtin/sdcpp-generation/ops/upscale.js +41 -0
- package/dist/plugins/builtin/sdcpp-generation/ops/video.d.ts +5 -0
- package/dist/plugins/builtin/sdcpp-generation/ops/video.js +239 -0
- package/dist/plugins/builtin/sdcpp-generation/plugin.d.ts +757 -0
- package/dist/plugins/builtin/sdcpp-generation/plugin.js +310 -0
- package/dist/plugins/builtin/tts-ggml/ops/parler-options.d.ts +6 -0
- package/dist/plugins/builtin/tts-ggml/ops/parler-options.js +30 -0
- package/dist/plugins/builtin/tts-ggml/ops/text-to-speech-stream.d.ts +7 -0
- package/dist/plugins/builtin/tts-ggml/ops/text-to-speech-stream.js +106 -0
- package/dist/plugins/builtin/tts-ggml/ops/text-to-speech.d.ts +6 -0
- package/dist/plugins/builtin/tts-ggml/ops/text-to-speech.js +91 -0
- package/dist/plugins/builtin/tts-ggml/plugin.d.ts +196 -0
- package/dist/plugins/builtin/tts-ggml/plugin.js +305 -0
- package/dist/plugins/builtin/whispercpp-transcription/plugin.d.ts +346 -0
- package/dist/plugins/builtin/whispercpp-transcription/plugin.js +169 -0
- package/dist/plugins/index.d.ts +9 -0
- package/dist/plugins/index.js +12 -0
- package/dist/plugins/ops/bci-transcribe.d.ts +13 -0
- package/dist/plugins/ops/bci-transcribe.js +248 -0
- package/dist/plugins/ops/cancel.d.ts +25 -0
- package/dist/plugins/ops/cancel.js +43 -0
- package/dist/plugins/ops/embed.d.ts +15 -0
- package/dist/plugins/ops/embed.js +193 -0
- package/dist/plugins/ops/kv-cache-retention.d.ts +11 -0
- package/dist/plugins/ops/kv-cache-retention.js +121 -0
- package/dist/plugins/ops/kv-cache-utils.d.ts +21 -0
- package/dist/plugins/ops/kv-cache-utils.js +120 -0
- package/dist/plugins/ops/load-model.d.ts +8 -0
- package/dist/plugins/ops/load-model.js +82 -0
- package/dist/plugins/ops/transcribe.d.ts +20 -0
- package/dist/plugins/ops/transcribe.js +343 -0
- package/dist/plugins/ops/translate.d.ts +7 -0
- package/dist/plugins/ops/translate.js +256 -0
- package/dist/plugins/ops/unload-model.d.ts +2 -0
- package/dist/plugins/ops/unload-model.js +45 -0
- package/dist/plugins/registry.d.ts +9 -0
- package/dist/plugins/registry.js +107 -0
- package/dist/profiling/aggregator.d.ts +14 -0
- package/dist/profiling/aggregator.js +100 -0
- package/dist/profiling/backend-diagnostics.d.ts +8 -0
- package/dist/profiling/backend-diagnostics.js +36 -0
- package/dist/profiling/clock.d.ts +8 -0
- package/dist/profiling/clock.js +23 -0
- package/dist/profiling/controller.d.ts +34 -0
- package/dist/profiling/controller.js +130 -0
- package/dist/profiling/delegation-profiler.d.ts +31 -0
- package/dist/profiling/delegation-profiler.js +155 -0
- package/dist/profiling/envelope.d.ts +10 -0
- package/dist/profiling/envelope.js +45 -0
- package/dist/profiling/events.d.ts +19 -0
- package/dist/profiling/events.js +35 -0
- package/dist/profiling/exporters.d.ts +9 -0
- package/dist/profiling/exporters.js +242 -0
- package/dist/profiling/index.d.ts +91 -0
- package/dist/profiling/index.js +87 -0
- package/dist/profiling/model-execution.d.ts +15 -0
- package/dist/profiling/model-execution.js +34 -0
- package/dist/profiling/operation-metrics.d.ts +24 -0
- package/dist/profiling/operation-metrics.js +370 -0
- package/dist/profiling/operation-wrappers.d.ts +17 -0
- package/dist/profiling/operation-wrappers.js +196 -0
- package/dist/profiling/profiler.d.ts +27 -0
- package/dist/profiling/profiler.js +127 -0
- package/dist/profiling/ring-buffer.d.ts +18 -0
- package/dist/profiling/ring-buffer.js +83 -0
- package/dist/profiling/types.d.ts +52 -0
- package/dist/profiling/types.js +1 -0
- package/dist/rag/handler.d.ts +2 -0
- package/dist/rag/handler.js +272 -0
- package/dist/rag/handlers/chunk.d.ts +2 -0
- package/dist/rag/handlers/chunk.js +7 -0
- package/dist/rag/handlers/close-workspace.d.ts +2 -0
- package/dist/rag/handlers/close-workspace.js +9 -0
- package/dist/rag/handlers/delete-embeddings.d.ts +2 -0
- package/dist/rag/handlers/delete-embeddings.js +11 -0
- package/dist/rag/handlers/delete-workspace.d.ts +2 -0
- package/dist/rag/handlers/delete-workspace.js +14 -0
- package/dist/rag/handlers/ingest.d.ts +9 -0
- package/dist/rag/handlers/ingest.js +19 -0
- package/dist/rag/handlers/list-workspaces.d.ts +2 -0
- package/dist/rag/handlers/list-workspaces.js +4 -0
- package/dist/rag/handlers/reindex.d.ts +9 -0
- package/dist/rag/handlers/reindex.js +16 -0
- package/dist/rag/handlers/save-embeddings.d.ts +9 -0
- package/dist/rag/handlers/save-embeddings.js +15 -0
- package/dist/rag/handlers/search.d.ts +2 -0
- package/dist/rag/handlers/search.js +16 -0
- package/dist/rag/index.d.ts +11 -0
- package/dist/rag/index.js +11 -0
- package/dist/rag/rag-operation-manager.d.ts +28 -0
- package/dist/rag/rag-operation-manager.js +76 -0
- package/dist/rag/rag-workspace-manager.d.ts +14 -0
- package/dist/rag/rag-workspace-manager.js +143 -0
- package/dist/registry.d.ts +2 -0
- package/dist/registry.js +166 -0
- package/dist/resources/collector.d.ts +643 -0
- package/dist/resources/collector.js +226 -0
- package/dist/resources/instance.d.ts +4 -0
- package/dist/resources/instance.js +15 -0
- package/dist/resources/native.d.ts +2 -0
- package/dist/resources/native.js +35 -0
- package/dist/resources/normalize.d.ts +12 -0
- package/dist/resources/normalize.js +73 -0
- package/dist/resources/types.d.ts +65 -0
- package/dist/resources/types.js +1 -0
- package/dist/runtime/cache-lock.d.ts +2 -0
- package/dist/runtime/cache-lock.js +67 -0
- package/dist/runtime/disposable-scope.d.ts +35 -0
- package/dist/runtime/disposable-scope.js +69 -0
- package/dist/runtime/env.d.ts +16 -0
- package/dist/runtime/env.js +53 -0
- package/dist/runtime/index.d.ts +5 -0
- package/dist/runtime/index.js +2 -0
- package/dist/runtime/lifecycle.d.ts +20 -0
- package/dist/runtime/lifecycle.js +102 -0
- package/dist/runtime/logging-stream-registry.d.ts +27 -0
- package/dist/runtime/logging-stream-registry.js +133 -0
- package/dist/runtime/model-config-utils.d.ts +14 -0
- package/dist/runtime/model-config-utils.js +128 -0
- package/dist/runtime/model-registry.d.ts +74 -0
- package/dist/runtime/model-registry.js +130 -0
- package/dist/runtime/registry-client.d.ts +4 -0
- package/dist/runtime/registry-client.js +118 -0
- package/dist/runtime/request-context.d.ts +72 -0
- package/dist/runtime/request-context.js +114 -0
- package/dist/runtime/request-id.d.ts +17 -0
- package/dist/runtime/request-id.js +29 -0
- package/dist/runtime/request-registry.d.ts +194 -0
- package/dist/runtime/request-registry.js +546 -0
- package/dist/runtime/runtime-lifecycle.d.ts +37 -0
- package/dist/runtime/runtime-lifecycle.js +163 -0
- package/dist/runtime/state.d.ts +26 -0
- package/dist/runtime/state.js +138 -0
- package/dist/schemas/audio-gen.d.ts +252 -0
- package/dist/schemas/audio-gen.js +69 -0
- package/dist/schemas/batch-completion-stream.d.ts +467 -0
- package/dist/schemas/batch-completion-stream.js +123 -0
- package/dist/schemas/bci-config.d.ts +74 -0
- package/dist/schemas/bci-config.js +58 -0
- package/dist/schemas/bci.d.ts +178 -0
- package/dist/schemas/bci.js +89 -0
- package/dist/schemas/cancel.d.ts +203 -0
- package/dist/schemas/cancel.js +135 -0
- package/dist/schemas/classification.d.ts +52 -0
- package/dist/schemas/classification.js +33 -0
- package/dist/schemas/common.d.ts +6420 -0
- package/dist/schemas/common.js +133 -0
- package/dist/schemas/completion-event.d.ts +248 -0
- package/dist/schemas/completion-event.js +94 -0
- package/dist/schemas/completion-stream.d.ts +475 -0
- package/dist/schemas/completion-stream.js +236 -0
- package/dist/schemas/config.d.ts +5022 -0
- package/dist/schemas/config.js +169 -0
- package/dist/schemas/delegate.d.ts +29 -0
- package/dist/schemas/delegate.js +40 -0
- package/dist/schemas/download-asset.d.ts +225 -0
- package/dist/schemas/download-asset.js +71 -0
- package/dist/schemas/embed.d.ts +41 -0
- package/dist/schemas/embed.js +35 -0
- package/dist/schemas/engine-addon-map.d.ts +20 -0
- package/dist/schemas/engine-addon-map.js +78 -0
- package/dist/schemas/error.d.ts +40 -0
- package/dist/schemas/error.js +65 -0
- package/dist/schemas/errors.d.ts +119 -0
- package/dist/schemas/errors.js +615 -0
- package/dist/schemas/finetune.d.ts +621 -0
- package/dist/schemas/finetune.js +163 -0
- package/dist/schemas/index.d.ts +45 -0
- package/dist/schemas/index.js +45 -0
- package/dist/schemas/json-schema.d.ts +15 -0
- package/dist/schemas/json-schema.js +2 -0
- package/dist/schemas/lifecycle.d.ts +38 -0
- package/dist/schemas/lifecycle.js +21 -0
- package/dist/schemas/llamacpp-config.d.ts +403 -0
- package/dist/schemas/llamacpp-config.js +133 -0
- package/dist/schemas/load-model.d.ts +25635 -0
- package/dist/schemas/load-model.js +629 -0
- package/dist/schemas/logging-stream.d.ts +33 -0
- package/dist/schemas/logging-stream.js +17 -0
- package/dist/schemas/mcp-adapter.d.ts +46 -0
- package/dist/schemas/mcp-adapter.js +1 -0
- package/dist/schemas/model-file.d.ts +27 -0
- package/dist/schemas/model-file.js +29 -0
- package/dist/schemas/model-info.d.ts +197 -0
- package/dist/schemas/model-info.js +144 -0
- package/dist/schemas/model-ops.d.ts +36 -0
- package/dist/schemas/model-ops.js +40 -0
- package/dist/schemas/model-src-utils.d.ts +192 -0
- package/dist/schemas/model-src-utils.js +61 -0
- package/dist/schemas/model-types.d.ts +275 -0
- package/dist/schemas/model-types.js +223 -0
- package/dist/schemas/ocr.d.ts +138 -0
- package/dist/schemas/ocr.js +59 -0
- package/dist/schemas/path-validation.d.ts +9 -0
- package/dist/schemas/path-validation.js +22 -0
- package/dist/schemas/plugin.d.ts +341 -0
- package/dist/schemas/plugin.js +241 -0
- package/dist/schemas/profiling.d.ts +695 -0
- package/dist/schemas/profiling.js +100 -0
- package/dist/schemas/provide.d.ts +50 -0
- package/dist/schemas/provide.js +32 -0
- package/dist/schemas/rag.d.ts +301 -0
- package/dist/schemas/rag.js +211 -0
- package/dist/schemas/registry.d.ts +453 -0
- package/dist/schemas/registry.js +104 -0
- package/dist/schemas/reload-config.d.ts +585 -0
- package/dist/schemas/reload-config.js +42 -0
- package/dist/schemas/runtime-context.d.ts +18 -0
- package/dist/schemas/runtime-context.js +7 -0
- package/dist/schemas/sdcpp-config.d.ts +1126 -0
- package/dist/schemas/sdcpp-config.js +748 -0
- package/dist/schemas/system-resources.d.ts +3966 -0
- package/dist/schemas/system-resources.js +149 -0
- package/dist/schemas/text-to-speech.d.ts +1352 -0
- package/dist/schemas/text-to-speech.js +364 -0
- package/dist/schemas/tools.d.ts +80 -0
- package/dist/schemas/tools.js +52 -0
- package/dist/schemas/transcription-config.d.ts +161 -0
- package/dist/schemas/transcription-config.js +156 -0
- package/dist/schemas/transcription.d.ts +261 -0
- package/dist/schemas/transcription.js +145 -0
- package/dist/schemas/translate.d.ts +138 -0
- package/dist/schemas/translate.js +103 -0
- package/dist/schemas/translation-config.d.ts +1031 -0
- package/dist/schemas/translation-config.js +170 -0
- package/dist/schemas/vla.d.ts +110 -0
- package/dist/schemas/vla.js +151 -0
- package/dist/selection.d.ts +8 -0
- package/dist/selection.js +14 -0
- package/dist/surface.d.ts +18 -0
- package/dist/surface.js +30 -0
- package/dist/utils/addon-responses.d.ts +58 -0
- package/dist/utils/addon-responses.js +1 -0
- package/dist/utils/aggregate-events.d.ts +25 -0
- package/dist/utils/aggregate-events.js +73 -0
- package/dist/utils/archive.d.ts +4 -0
- package/dist/utils/archive.js +180 -0
- package/dist/utils/asr-events.d.ts +14 -0
- package/dist/utils/asr-events.js +30 -0
- package/dist/utils/audio/decoder.d.ts +4 -0
- package/dist/utils/audio/decoder.js +80 -0
- package/dist/utils/audio-input.d.ts +9 -0
- package/dist/utils/audio-input.js +34 -0
- package/dist/utils/cache/auto-history.d.ts +3 -0
- package/dist/utils/cache/auto-history.js +26 -0
- package/dist/utils/cache/paths.d.ts +42 -0
- package/dist/utils/cache/paths.js +133 -0
- package/dist/utils/cache/types.d.ts +7 -0
- package/dist/utils/cache/types.js +1 -0
- package/dist/utils/cache-normalize.d.ts +9 -0
- package/dist/utils/cache-normalize.js +20 -0
- package/dist/utils/checksum.d.ts +3 -0
- package/dist/utils/checksum.js +29 -0
- package/dist/utils/clear-storage.d.ts +4 -0
- package/dist/utils/clear-storage.js +14 -0
- package/dist/utils/completion-normalizer.d.ts +17 -0
- package/dist/utils/completion-normalizer.js +453 -0
- package/dist/utils/config-transform.d.ts +2 -0
- package/dist/utils/config-transform.js +21 -0
- package/dist/utils/decorate-promise.d.ts +33 -0
- package/dist/utils/decorate-promise.js +35 -0
- package/dist/utils/encoding.d.ts +16 -0
- package/dist/utils/encoding.js +27 -0
- package/dist/utils/expand-gguf-shards.d.ts +2 -0
- package/dist/utils/expand-gguf-shards.js +22 -0
- package/dist/utils/formatting.d.ts +18 -0
- package/dist/utils/formatting.js +56 -0
- package/dist/utils/gguf-tensor-extractor.d.ts +14 -0
- package/dist/utils/gguf-tensor-extractor.js +311 -0
- package/dist/utils/global-singleton.d.ts +1 -0
- package/dist/utils/global-singleton.js +10 -0
- package/dist/utils/index.d.ts +11 -0
- package/dist/utils/index.js +11 -0
- package/dist/utils/load-model-validation.d.ts +6 -0
- package/dist/utils/load-model-validation.js +18 -0
- package/dist/utils/mcp-adapter.d.ts +11 -0
- package/dist/utils/mcp-adapter.js +96 -0
- package/dist/utils/multi-gpu-mobile.d.ts +4 -0
- package/dist/utils/multi-gpu-mobile.js +10 -0
- package/dist/utils/object.d.ts +1 -0
- package/dist/utils/object.js +3 -0
- package/dist/utils/path-security.d.ts +22 -0
- package/dist/utils/path-security.js +69 -0
- package/dist/utils/qvac-paths.d.ts +1 -0
- package/dist/utils/qvac-paths.js +5 -0
- package/dist/utils/response-format.d.ts +2 -0
- package/dist/utils/response-format.js +20 -0
- package/dist/utils/shard-utils.d.ts +47 -0
- package/dist/utils/shard-utils.js +123 -0
- package/dist/utils/tool-helpers.d.ts +24 -0
- package/dist/utils/tool-helpers.js +111 -0
- package/dist/utils/tool-integration.d.ts +23 -0
- package/dist/utils/tool-integration.js +29 -0
- package/dist/utils/tools/dialect.d.ts +7 -0
- package/dist/utils/tools/dialect.js +20 -0
- package/dist/utils/tools/index.d.ts +2 -0
- package/dist/utils/tools/index.js +2 -0
- package/dist/utils/tools/parser.d.ts +5 -0
- package/dist/utils/tools/parser.js +69 -0
- package/dist/utils/tools/parsers/dsml.d.ts +3 -0
- package/dist/utils/tools/parsers/dsml.js +177 -0
- package/dist/utils/tools/parsers/gemma4native.d.ts +3 -0
- package/dist/utils/tools/parsers/gemma4native.js +65 -0
- package/dist/utils/tools/parsers/harmony.d.ts +3 -0
- package/dist/utils/tools/parsers/harmony.js +57 -0
- package/dist/utils/tools/parsers/hermes.d.ts +3 -0
- package/dist/utils/tools/parsers/hermes.js +122 -0
- package/dist/utils/tools/parsers/json.d.ts +5 -0
- package/dist/utils/tools/parsers/json.js +115 -0
- package/dist/utils/tools/parsers/pythonic.d.ts +3 -0
- package/dist/utils/tools/parsers/pythonic.js +267 -0
- package/dist/utils/tools/parsers/qwen35.d.ts +3 -0
- package/dist/utils/tools/parsers/qwen35.js +125 -0
- package/dist/utils/tools/shared.d.ts +17 -0
- package/dist/utils/tools/shared.js +52 -0
- package/dist/utils/transcribe-metadata.d.ts +20 -0
- package/dist/utils/transcribe-metadata.js +28 -0
- package/dist/utils/tts-stats.d.ts +25 -0
- package/dist/utils/tts-stats.js +16 -0
- package/dist/utils/withTimeout.d.ts +17 -0
- package/dist/utils/withTimeout.js +47 -0
- package/dist/utils/zod-error.d.ts +2 -0
- package/dist/utils/zod-error.js +4 -0
- package/package.json +266 -1
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Generic wrappers for profiling handler execution.
|
|
3
|
+
* Used to wrap dispatch/invoke functions with timing capture.
|
|
4
|
+
*/
|
|
5
|
+
import { PROFILING_KEY, OPERATION_EVENT_KEY } from '../schemas/index.js';
|
|
6
|
+
import { nowMs, generateProfileId } from '../profiling/clock.js';
|
|
7
|
+
import { record, shouldIncludeResourceGauges, shouldProfile } from '../profiling/controller.js';
|
|
8
|
+
import { getResourceCollector } from '../resources/instance.js';
|
|
9
|
+
import { buildOperationEvent } from '../profiling/operation-metrics.js';
|
|
10
|
+
import { isTerminalChunk } from '../p2p/rpc-utils.js';
|
|
11
|
+
function getRequestProfilingMeta(request) {
|
|
12
|
+
if (!request || typeof request !== 'object') {
|
|
13
|
+
return undefined;
|
|
14
|
+
}
|
|
15
|
+
const meta = request[PROFILING_KEY];
|
|
16
|
+
if (!meta || typeof meta !== 'object') {
|
|
17
|
+
return undefined;
|
|
18
|
+
}
|
|
19
|
+
return meta;
|
|
20
|
+
}
|
|
21
|
+
function resolveOperationProfiling(options) {
|
|
22
|
+
if (options.perCall) {
|
|
23
|
+
return { perCall: options.perCall, resourceOrigin: 'local' };
|
|
24
|
+
}
|
|
25
|
+
const meta = getRequestProfilingMeta(options.request);
|
|
26
|
+
if (!meta) {
|
|
27
|
+
return { perCall: undefined, resourceOrigin: 'local' };
|
|
28
|
+
}
|
|
29
|
+
if (meta.enabled === false) {
|
|
30
|
+
return {
|
|
31
|
+
perCall: { enabled: false },
|
|
32
|
+
resourceOrigin: meta.resourceOrigin ?? 'local'
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
return {
|
|
36
|
+
perCall: {
|
|
37
|
+
enabled: true,
|
|
38
|
+
includeServerBreakdown: meta.includeServer,
|
|
39
|
+
includeResourceGauges: meta.includeResources,
|
|
40
|
+
mode: meta.mode
|
|
41
|
+
},
|
|
42
|
+
resourceOrigin: meta.resourceOrigin ?? 'local'
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
function toProfilerResourceGauge(sample, sampledAt, origin) {
|
|
46
|
+
const gpus = sample.gpus.status === 'supported'
|
|
47
|
+
? {
|
|
48
|
+
...sample.gpus,
|
|
49
|
+
value: sample.gpus.value.map((gpu) => ({
|
|
50
|
+
id: gpu.id,
|
|
51
|
+
compute: gpu.compute,
|
|
52
|
+
memoryUsedBytes: gpu.memoryUsedBytes
|
|
53
|
+
}))
|
|
54
|
+
}
|
|
55
|
+
: sample.gpus;
|
|
56
|
+
return {
|
|
57
|
+
origin,
|
|
58
|
+
sampledAt,
|
|
59
|
+
cpu: sample.cpu,
|
|
60
|
+
memory: sample.memory,
|
|
61
|
+
gpus
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
function buildAndRecordOperationEvent(params) {
|
|
65
|
+
const event = buildOperationEvent(params.options.op, params.profileId, params.startTs, params.executionMs, params.options.request, params.finalResponse, params.ttfb);
|
|
66
|
+
if (!event)
|
|
67
|
+
return undefined;
|
|
68
|
+
if (params.errored) {
|
|
69
|
+
event.tags = { ...event.tags, error: 'true' };
|
|
70
|
+
}
|
|
71
|
+
if (params.count !== undefined && params.count > 0) {
|
|
72
|
+
event.count = params.count;
|
|
73
|
+
}
|
|
74
|
+
if (shouldIncludeResourceGauges(params.profiling.perCall)) {
|
|
75
|
+
const resources = getResourceCollector()?.sample();
|
|
76
|
+
if (resources) {
|
|
77
|
+
event.resources = toProfilerResourceGauge(resources, nowMs(), params.profiling.resourceOrigin);
|
|
78
|
+
}
|
|
79
|
+
}
|
|
80
|
+
record(event);
|
|
81
|
+
return event;
|
|
82
|
+
}
|
|
83
|
+
export async function profileReplyHandler(options, handler) {
|
|
84
|
+
const profiling = resolveOperationProfiling(options);
|
|
85
|
+
if (!shouldProfile(options.op, profiling.perCall)) {
|
|
86
|
+
return handler();
|
|
87
|
+
}
|
|
88
|
+
const profileId = generateProfileId();
|
|
89
|
+
const startTs = nowMs();
|
|
90
|
+
try {
|
|
91
|
+
const result = await handler();
|
|
92
|
+
const executionMs = nowMs() - startTs;
|
|
93
|
+
const event = buildAndRecordOperationEvent({
|
|
94
|
+
options,
|
|
95
|
+
profiling,
|
|
96
|
+
profileId,
|
|
97
|
+
startTs,
|
|
98
|
+
executionMs,
|
|
99
|
+
finalResponse: result
|
|
100
|
+
});
|
|
101
|
+
if (event) {
|
|
102
|
+
;
|
|
103
|
+
result[OPERATION_EVENT_KEY] = event;
|
|
104
|
+
}
|
|
105
|
+
return result;
|
|
106
|
+
}
|
|
107
|
+
catch (error) {
|
|
108
|
+
const executionMs = nowMs() - startTs;
|
|
109
|
+
buildAndRecordOperationEvent({
|
|
110
|
+
options,
|
|
111
|
+
profiling,
|
|
112
|
+
profileId,
|
|
113
|
+
startTs,
|
|
114
|
+
executionMs,
|
|
115
|
+
errored: true
|
|
116
|
+
});
|
|
117
|
+
throw error;
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
export async function* profileStreamHandler(options, handler) {
|
|
121
|
+
const profiling = resolveOperationProfiling(options);
|
|
122
|
+
if (!shouldProfile(options.op, profiling.perCall)) {
|
|
123
|
+
return yield* handler();
|
|
124
|
+
}
|
|
125
|
+
const profileId = generateProfileId();
|
|
126
|
+
const startTs = nowMs();
|
|
127
|
+
let ttfb;
|
|
128
|
+
let lastChunk;
|
|
129
|
+
let chunkCount = 0;
|
|
130
|
+
let eventAttached = false;
|
|
131
|
+
const iterator = handler();
|
|
132
|
+
try {
|
|
133
|
+
while (true) {
|
|
134
|
+
const result = await iterator.next();
|
|
135
|
+
if (result.done) {
|
|
136
|
+
if (!eventAttached) {
|
|
137
|
+
const executionMs = nowMs() - startTs;
|
|
138
|
+
buildAndRecordOperationEvent({
|
|
139
|
+
options,
|
|
140
|
+
profiling,
|
|
141
|
+
profileId,
|
|
142
|
+
startTs,
|
|
143
|
+
executionMs,
|
|
144
|
+
finalResponse: lastChunk,
|
|
145
|
+
ttfb,
|
|
146
|
+
count: chunkCount
|
|
147
|
+
});
|
|
148
|
+
}
|
|
149
|
+
return result.value;
|
|
150
|
+
}
|
|
151
|
+
const chunk = result.value;
|
|
152
|
+
if (ttfb === undefined) {
|
|
153
|
+
ttfb = nowMs() - startTs;
|
|
154
|
+
}
|
|
155
|
+
chunkCount++;
|
|
156
|
+
lastChunk = chunk;
|
|
157
|
+
if (!eventAttached && isTerminalChunk(chunk)) {
|
|
158
|
+
const executionMs = nowMs() - startTs;
|
|
159
|
+
const event = buildAndRecordOperationEvent({
|
|
160
|
+
options,
|
|
161
|
+
profiling,
|
|
162
|
+
profileId,
|
|
163
|
+
startTs,
|
|
164
|
+
executionMs,
|
|
165
|
+
finalResponse: chunk,
|
|
166
|
+
ttfb,
|
|
167
|
+
count: chunkCount
|
|
168
|
+
});
|
|
169
|
+
if (event) {
|
|
170
|
+
;
|
|
171
|
+
chunk[OPERATION_EVENT_KEY] = event;
|
|
172
|
+
}
|
|
173
|
+
eventAttached = true;
|
|
174
|
+
}
|
|
175
|
+
yield chunk;
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
catch (error) {
|
|
179
|
+
const executionMs = nowMs() - startTs;
|
|
180
|
+
buildAndRecordOperationEvent({
|
|
181
|
+
options,
|
|
182
|
+
profiling,
|
|
183
|
+
profileId,
|
|
184
|
+
startTs,
|
|
185
|
+
executionMs,
|
|
186
|
+
finalResponse: lastChunk,
|
|
187
|
+
ttfb,
|
|
188
|
+
count: chunkCount,
|
|
189
|
+
errored: true
|
|
190
|
+
});
|
|
191
|
+
throw error;
|
|
192
|
+
}
|
|
193
|
+
finally {
|
|
194
|
+
await iterator.return?.(undefined);
|
|
195
|
+
}
|
|
196
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { type Response, type ProfilingRequestMeta, type DelegationBreakdown, type OperationEvent } from '../schemas/index.js';
|
|
2
|
+
export interface ServerProfilingContext {
|
|
3
|
+
meta: ProfilingRequestMeta;
|
|
4
|
+
requestStart: number;
|
|
5
|
+
jsonParseMs?: number;
|
|
6
|
+
zodValidationMs?: number;
|
|
7
|
+
handlerExecutionMs?: number;
|
|
8
|
+
responseZodValidationMs?: number;
|
|
9
|
+
responseStringifyMs?: number;
|
|
10
|
+
}
|
|
11
|
+
export declare function createProfilingContext(meta: ProfilingRequestMeta): ServerProfilingContext;
|
|
12
|
+
export interface ProfilingInjectionOptions {
|
|
13
|
+
ctx?: ServerProfilingContext;
|
|
14
|
+
delegation?: DelegationBreakdown;
|
|
15
|
+
operation?: OperationEvent;
|
|
16
|
+
}
|
|
17
|
+
export declare function injectProfilingIntoString(jsonString: string, options: ProfilingInjectionOptions): string;
|
|
18
|
+
export type ServerProfiler = {
|
|
19
|
+
markRequestParsed: (ms: number) => void;
|
|
20
|
+
markRequestValidated: (ms: number) => void;
|
|
21
|
+
startHandler: () => void;
|
|
22
|
+
endHandler: () => void;
|
|
23
|
+
serialize: (response?: Response, final?: boolean) => string;
|
|
24
|
+
serializeError: (json: string) => string;
|
|
25
|
+
getContext: () => ServerProfilingContext | undefined;
|
|
26
|
+
};
|
|
27
|
+
export declare function createServerProfiler(meta?: ProfilingRequestMeta): ServerProfiler;
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
import { responseSchema, PROFILING_KEY, DELEGATION_BREAKDOWN_KEY, OPERATION_EVENT_KEY, PROFILING_TRAILER_KEY } from '../schemas/index.js';
|
|
2
|
+
import { nowMs } from '../profiling/clock.js';
|
|
3
|
+
export function createProfilingContext(meta) {
|
|
4
|
+
return { meta, requestStart: nowMs() };
|
|
5
|
+
}
|
|
6
|
+
function buildServerBreakdown(ctx) {
|
|
7
|
+
return {
|
|
8
|
+
requestJsonParseMs: ctx.jsonParseMs,
|
|
9
|
+
requestZodValidationMs: ctx.zodValidationMs,
|
|
10
|
+
handlerExecutionMs: ctx.handlerExecutionMs,
|
|
11
|
+
responseZodValidationMs: ctx.responseZodValidationMs,
|
|
12
|
+
responseStringifyMs: ctx.responseStringifyMs,
|
|
13
|
+
totalServerMs: nowMs() - ctx.requestStart
|
|
14
|
+
};
|
|
15
|
+
}
|
|
16
|
+
export function injectProfilingIntoString(jsonString, options) {
|
|
17
|
+
const { ctx, delegation, operation } = options;
|
|
18
|
+
const includeServer = ctx?.meta.includeServer ?? false;
|
|
19
|
+
const hasContent = includeServer || !!delegation || !!operation;
|
|
20
|
+
if (!hasContent || !jsonString.endsWith('}')) {
|
|
21
|
+
return jsonString;
|
|
22
|
+
}
|
|
23
|
+
const id = ctx?.meta.id ?? delegation?.profileId ?? operation?.profileId ?? '';
|
|
24
|
+
const profilingMeta = { id };
|
|
25
|
+
if (includeServer && ctx) {
|
|
26
|
+
profilingMeta['server'] = buildServerBreakdown(ctx);
|
|
27
|
+
}
|
|
28
|
+
if (delegation) {
|
|
29
|
+
const { profileId: _unused, ...delegationWithoutId } = delegation;
|
|
30
|
+
void _unused;
|
|
31
|
+
profilingMeta['delegation'] = delegationWithoutId;
|
|
32
|
+
}
|
|
33
|
+
if (operation) {
|
|
34
|
+
profilingMeta['operation'] = operation;
|
|
35
|
+
}
|
|
36
|
+
return jsonString.slice(0, -1) + `,"${PROFILING_KEY}":${JSON.stringify(profilingMeta)}}`;
|
|
37
|
+
}
|
|
38
|
+
const noopProfiler = {
|
|
39
|
+
markRequestParsed: () => { },
|
|
40
|
+
markRequestValidated: () => { },
|
|
41
|
+
startHandler: () => { },
|
|
42
|
+
endHandler: () => { },
|
|
43
|
+
serialize: (response) => {
|
|
44
|
+
if (!response)
|
|
45
|
+
return '';
|
|
46
|
+
const extended = response;
|
|
47
|
+
const delegation = extended[DELEGATION_BREAKDOWN_KEY];
|
|
48
|
+
const operation = extended[OPERATION_EVENT_KEY];
|
|
49
|
+
const json = JSON.stringify(responseSchema.parse(response));
|
|
50
|
+
if (delegation || operation) {
|
|
51
|
+
const opts = {};
|
|
52
|
+
if (delegation)
|
|
53
|
+
opts.delegation = delegation;
|
|
54
|
+
if (operation)
|
|
55
|
+
opts.operation = operation;
|
|
56
|
+
return injectProfilingIntoString(json, opts);
|
|
57
|
+
}
|
|
58
|
+
return json;
|
|
59
|
+
},
|
|
60
|
+
serializeError: (json) => json,
|
|
61
|
+
getContext: () => undefined
|
|
62
|
+
};
|
|
63
|
+
function createActiveProfiler(meta) {
|
|
64
|
+
const ctx = createProfilingContext(meta);
|
|
65
|
+
let handlerStart = 0;
|
|
66
|
+
let handlerEnded = false;
|
|
67
|
+
let cachedDelegation;
|
|
68
|
+
let cachedOperation;
|
|
69
|
+
return {
|
|
70
|
+
markRequestParsed: (ms) => {
|
|
71
|
+
ctx.jsonParseMs = ms;
|
|
72
|
+
},
|
|
73
|
+
markRequestValidated: (ms) => {
|
|
74
|
+
ctx.zodValidationMs = ms;
|
|
75
|
+
},
|
|
76
|
+
startHandler: () => {
|
|
77
|
+
handlerStart = nowMs();
|
|
78
|
+
handlerEnded = false;
|
|
79
|
+
},
|
|
80
|
+
endHandler: () => {
|
|
81
|
+
if (handlerEnded)
|
|
82
|
+
return;
|
|
83
|
+
handlerEnded = true;
|
|
84
|
+
ctx.handlerExecutionMs = nowMs() - handlerStart;
|
|
85
|
+
},
|
|
86
|
+
serialize: (response, final = true) => {
|
|
87
|
+
if (!response) {
|
|
88
|
+
const opts = { ctx };
|
|
89
|
+
if (cachedDelegation)
|
|
90
|
+
opts.delegation = cachedDelegation;
|
|
91
|
+
if (cachedOperation)
|
|
92
|
+
opts.operation = cachedOperation;
|
|
93
|
+
return injectProfilingIntoString(`{"${PROFILING_TRAILER_KEY}":true}`, opts);
|
|
94
|
+
}
|
|
95
|
+
const extended = response;
|
|
96
|
+
const delegation = extended[DELEGATION_BREAKDOWN_KEY];
|
|
97
|
+
const operation = extended[OPERATION_EVENT_KEY];
|
|
98
|
+
if (delegation)
|
|
99
|
+
cachedDelegation = delegation;
|
|
100
|
+
if (operation)
|
|
101
|
+
cachedOperation = operation;
|
|
102
|
+
const zodStart = nowMs();
|
|
103
|
+
const validated = responseSchema.parse(response);
|
|
104
|
+
ctx.responseZodValidationMs = (ctx.responseZodValidationMs ?? 0) + (nowMs() - zodStart);
|
|
105
|
+
const stringifyStart = nowMs();
|
|
106
|
+
const json = JSON.stringify(validated);
|
|
107
|
+
ctx.responseStringifyMs = (ctx.responseStringifyMs ?? 0) + (nowMs() - stringifyStart);
|
|
108
|
+
if (final) {
|
|
109
|
+
const opts = { ctx };
|
|
110
|
+
if (delegation)
|
|
111
|
+
opts.delegation = delegation;
|
|
112
|
+
if (operation)
|
|
113
|
+
opts.operation = operation;
|
|
114
|
+
return injectProfilingIntoString(json, opts);
|
|
115
|
+
}
|
|
116
|
+
return json;
|
|
117
|
+
},
|
|
118
|
+
serializeError: (json) => injectProfilingIntoString(json, { ctx }),
|
|
119
|
+
getContext: () => ctx
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
export function createServerProfiler(meta) {
|
|
123
|
+
if (meta?.includeServer && typeof meta.id === 'string' && meta.id.length > 0) {
|
|
124
|
+
return createActiveProfiler(meta);
|
|
125
|
+
}
|
|
126
|
+
return noopProfiler;
|
|
127
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* O(1) bounded buffer for event storage.
|
|
3
|
+
* Oldest events are overwritten when full.
|
|
4
|
+
*/
|
|
5
|
+
export interface RingBufferState<T> {
|
|
6
|
+
buffer: (T | undefined)[];
|
|
7
|
+
capacity: number;
|
|
8
|
+
head: number;
|
|
9
|
+
size: number;
|
|
10
|
+
totalPushed: number;
|
|
11
|
+
}
|
|
12
|
+
export declare function createRingBuffer<T>(capacity: number): RingBufferState<T>;
|
|
13
|
+
export declare function ringBufferPush<T>(state: RingBufferState<T>, item: T): T | undefined;
|
|
14
|
+
export declare function ringBufferToArray<T>(state: RingBufferState<T>): T[];
|
|
15
|
+
export declare function ringBufferGetRecent<T>(state: RingBufferState<T>, count: number): T[];
|
|
16
|
+
export declare function ringBufferClear<T>(state: RingBufferState<T>): void;
|
|
17
|
+
export declare function ringBufferDroppedCount<T>(state: RingBufferState<T>): number;
|
|
18
|
+
export declare function ringBufferResize<T>(state: RingBufferState<T>, newCapacity: number): RingBufferState<T>;
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* O(1) bounded buffer for event storage.
|
|
3
|
+
* Oldest events are overwritten when full.
|
|
4
|
+
*/
|
|
5
|
+
import { ProfilerInvalidCapacityError } from '../errors/index.js';
|
|
6
|
+
export function createRingBuffer(capacity) {
|
|
7
|
+
if (capacity < 1) {
|
|
8
|
+
throw new ProfilerInvalidCapacityError(1);
|
|
9
|
+
}
|
|
10
|
+
return {
|
|
11
|
+
buffer: new Array(capacity),
|
|
12
|
+
capacity,
|
|
13
|
+
head: 0,
|
|
14
|
+
size: 0,
|
|
15
|
+
totalPushed: 0
|
|
16
|
+
};
|
|
17
|
+
}
|
|
18
|
+
// Returns the overwritten item if buffer was full, undefined otherwise.
|
|
19
|
+
export function ringBufferPush(state, item) {
|
|
20
|
+
const overwritten = state.size === state.capacity ? state.buffer[state.head] : undefined;
|
|
21
|
+
state.buffer[state.head] = item;
|
|
22
|
+
state.head = (state.head + 1) % state.capacity;
|
|
23
|
+
state.size = Math.min(state.size + 1, state.capacity);
|
|
24
|
+
state.totalPushed++;
|
|
25
|
+
return overwritten;
|
|
26
|
+
}
|
|
27
|
+
// Returns all items in chronological order (oldest first).
|
|
28
|
+
export function ringBufferToArray(state) {
|
|
29
|
+
if (state.size === 0) {
|
|
30
|
+
return [];
|
|
31
|
+
}
|
|
32
|
+
const result = [];
|
|
33
|
+
const start = state.size === state.capacity
|
|
34
|
+
? state.head // Full: head points to oldest
|
|
35
|
+
: 0;
|
|
36
|
+
for (let i = 0; i < state.size; i++) {
|
|
37
|
+
const index = (start + i) % state.capacity;
|
|
38
|
+
const item = state.buffer[index];
|
|
39
|
+
if (item !== undefined) {
|
|
40
|
+
result.push(item);
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
return result;
|
|
44
|
+
}
|
|
45
|
+
// Returns the most recent N items (newest first).
|
|
46
|
+
export function ringBufferGetRecent(state, count) {
|
|
47
|
+
if (state.size === 0 || count <= 0) {
|
|
48
|
+
return [];
|
|
49
|
+
}
|
|
50
|
+
const actualCount = Math.min(count, state.size);
|
|
51
|
+
const result = [];
|
|
52
|
+
for (let i = 0; i < actualCount; i++) {
|
|
53
|
+
const index = (state.head - 1 - i + state.capacity) % state.capacity;
|
|
54
|
+
const item = state.buffer[index];
|
|
55
|
+
if (item !== undefined) {
|
|
56
|
+
result.push(item);
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
return result;
|
|
60
|
+
}
|
|
61
|
+
export function ringBufferClear(state) {
|
|
62
|
+
state.buffer = new Array(state.capacity);
|
|
63
|
+
state.head = 0;
|
|
64
|
+
state.size = 0;
|
|
65
|
+
state.totalPushed = 0;
|
|
66
|
+
}
|
|
67
|
+
export function ringBufferDroppedCount(state) {
|
|
68
|
+
return Math.max(0, state.totalPushed - state.capacity);
|
|
69
|
+
}
|
|
70
|
+
// Resizes the buffer, keeping the most recent items.
|
|
71
|
+
export function ringBufferResize(state, newCapacity) {
|
|
72
|
+
if (newCapacity < 1) {
|
|
73
|
+
throw new ProfilerInvalidCapacityError(1);
|
|
74
|
+
}
|
|
75
|
+
const items = ringBufferToArray(state);
|
|
76
|
+
const itemsToKeep = items.slice(-newCapacity);
|
|
77
|
+
const newState = createRingBuffer(newCapacity);
|
|
78
|
+
for (const item of itemsToKeep) {
|
|
79
|
+
ringBufferPush(newState, item);
|
|
80
|
+
}
|
|
81
|
+
newState.totalPushed = state.totalPushed;
|
|
82
|
+
return newState;
|
|
83
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import type { ProfilerResourceGauge } from '../schemas/profiling.js';
|
|
2
|
+
import type { InferenceBackendDiagnostics } from '../schemas/system-resources.js';
|
|
3
|
+
export type ProfilingEventKind = 'rpc' | 'handler' | 'download' | 'load' | 'delegation';
|
|
4
|
+
export interface ProfilingEvent {
|
|
5
|
+
/** Timestamp when event was recorded (monotonic ms) */
|
|
6
|
+
ts: number;
|
|
7
|
+
op: string;
|
|
8
|
+
kind: ProfilingEventKind;
|
|
9
|
+
profileId?: string;
|
|
10
|
+
phase?: string;
|
|
11
|
+
ms?: number;
|
|
12
|
+
/** Count (e.g., chunks, tokens) */
|
|
13
|
+
count?: number;
|
|
14
|
+
bytes?: number;
|
|
15
|
+
/** Numeric gauges (e.g., throughput, token counters) */
|
|
16
|
+
gauges?: Record<string, number>;
|
|
17
|
+
resources?: ProfilerResourceGauge;
|
|
18
|
+
backend?: InferenceBackendDiagnostics;
|
|
19
|
+
/** String tags (e.g., handlerType, sourceType, modelId) */
|
|
20
|
+
tags?: Record<string, string>;
|
|
21
|
+
}
|
|
22
|
+
export interface ProfilerRuntimeOptions {
|
|
23
|
+
mode?: 'summary' | 'verbose';
|
|
24
|
+
includeServerBreakdown?: boolean;
|
|
25
|
+
includeResourceGauges?: boolean;
|
|
26
|
+
operationFilters?: string[];
|
|
27
|
+
}
|
|
28
|
+
export interface AggregatedStats {
|
|
29
|
+
count: number;
|
|
30
|
+
min: number;
|
|
31
|
+
max: number;
|
|
32
|
+
avg: number;
|
|
33
|
+
sum: number;
|
|
34
|
+
last: number;
|
|
35
|
+
}
|
|
36
|
+
export interface ProfilerExport {
|
|
37
|
+
config: {
|
|
38
|
+
enabled: boolean;
|
|
39
|
+
mode: 'summary' | 'verbose';
|
|
40
|
+
includeServerBreakdown: boolean;
|
|
41
|
+
includeResourceGauges: boolean;
|
|
42
|
+
operationFilters: string[];
|
|
43
|
+
maxRecentEvents: number;
|
|
44
|
+
};
|
|
45
|
+
aggregates: Record<string, AggregatedStats>;
|
|
46
|
+
recentEvents?: ProfilingEvent[];
|
|
47
|
+
exportedAt: number;
|
|
48
|
+
}
|
|
49
|
+
export interface LoadTimingStats {
|
|
50
|
+
modelInitializationTimeMs?: number;
|
|
51
|
+
totalLoadTimeMs?: number;
|
|
52
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|