@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.
Files changed (610) hide show
  1. package/LICENSE +179 -0
  2. package/NOTICE +986 -0
  3. package/README.md +138 -0
  4. package/dist/api/audio-gen.d.ts +18 -0
  5. package/dist/api/audio-gen.js +148 -0
  6. package/dist/api/batch-completion.d.ts +14 -0
  7. package/dist/api/batch-completion.js +332 -0
  8. package/dist/api/bci-transcribe.d.ts +56 -0
  9. package/dist/api/bci-transcribe.js +172 -0
  10. package/dist/api/cancel.d.ts +34 -0
  11. package/dist/api/cancel.js +82 -0
  12. package/dist/api/classify.d.ts +22 -0
  13. package/dist/api/classify.js +46 -0
  14. package/dist/api/completion-stream.d.ts +106 -0
  15. package/dist/api/completion-stream.js +351 -0
  16. package/dist/api/delete-cache.d.ts +29 -0
  17. package/dist/api/delete-cache.js +49 -0
  18. package/dist/api/diffusion.d.ts +92 -0
  19. package/dist/api/diffusion.js +176 -0
  20. package/dist/api/download-asset.d.ts +49 -0
  21. package/dist/api/download-asset.js +87 -0
  22. package/dist/api/embed.d.ts +41 -0
  23. package/dist/api/embed.js +29 -0
  24. package/dist/api/finetune.d.ts +89 -0
  25. package/dist/api/finetune.js +138 -0
  26. package/dist/api/get-loaded-model-info.d.ts +24 -0
  27. package/dist/api/get-loaded-model-info.js +34 -0
  28. package/dist/api/get-model-info.d.ts +43 -0
  29. package/dist/api/get-model-info.js +21 -0
  30. package/dist/api/get-system-resources.d.ts +2 -0
  31. package/dist/api/get-system-resources.js +16 -0
  32. package/dist/api/heartbeat.d.ts +29 -0
  33. package/dist/api/heartbeat.js +37 -0
  34. package/dist/api/index.d.ts +35 -0
  35. package/dist/api/index.js +35 -0
  36. package/dist/api/invoke-plugin.d.ts +30 -0
  37. package/dist/api/invoke-plugin.js +54 -0
  38. package/dist/api/load-model.d.ts +169 -0
  39. package/dist/api/load-model.js +129 -0
  40. package/dist/api/logging-stream-registry.d.ts +4 -0
  41. package/dist/api/logging-stream-registry.js +61 -0
  42. package/dist/api/logging-stream.d.ts +23 -0
  43. package/dist/api/logging-stream.js +36 -0
  44. package/dist/api/ocr.d.ts +30 -0
  45. package/dist/api/ocr.js +88 -0
  46. package/dist/api/parse-input.d.ts +2 -0
  47. package/dist/api/parse-input.js +14 -0
  48. package/dist/api/provide.d.ts +23 -0
  49. package/dist/api/provide.js +32 -0
  50. package/dist/api/rag.d.ts +251 -0
  51. package/dist/api/rag.js +485 -0
  52. package/dist/api/registry.d.ts +39 -0
  53. package/dist/api/registry.js +63 -0
  54. package/dist/api/resume.d.ts +29 -0
  55. package/dist/api/resume.js +36 -0
  56. package/dist/api/state.d.ts +22 -0
  57. package/dist/api/state.js +29 -0
  58. package/dist/api/stop-provider.d.ts +20 -0
  59. package/dist/api/stop-provider.js +30 -0
  60. package/dist/api/subscribe-logs.d.ts +27 -0
  61. package/dist/api/subscribe-logs.js +43 -0
  62. package/dist/api/suspend.d.ts +30 -0
  63. package/dist/api/suspend.js +37 -0
  64. package/dist/api/text-to-speech.d.ts +64 -0
  65. package/dist/api/text-to-speech.js +434 -0
  66. package/dist/api/transcribe.d.ts +75 -0
  67. package/dist/api/transcribe.js +256 -0
  68. package/dist/api/translate.d.ts +47 -0
  69. package/dist/api/translate.js +115 -0
  70. package/dist/api/unload-model.d.ts +17 -0
  71. package/dist/api/unload-model.js +42 -0
  72. package/dist/api/upscale.d.ts +44 -0
  73. package/dist/api/upscale.js +99 -0
  74. package/dist/api/video.d.ts +86 -0
  75. package/dist/api/video.js +176 -0
  76. package/dist/api/vla-helpers.d.ts +43 -0
  77. package/dist/api/vla-helpers.js +124 -0
  78. package/dist/api/vla.d.ts +68 -0
  79. package/dist/api/vla.js +113 -0
  80. package/dist/config/config-utils.d.ts +4 -0
  81. package/dist/config/config-utils.js +18 -0
  82. package/dist/config/resolve-config.d.ts +8 -0
  83. package/dist/config/resolve-config.js +74 -0
  84. package/dist/constants/audio.d.ts +1 -0
  85. package/dist/constants/audio.js +1 -0
  86. package/dist/constants/index.d.ts +2 -0
  87. package/dist/constants/index.js +2 -0
  88. package/dist/constants/registry.d.ts +1 -0
  89. package/dist/constants/registry.js +1 -0
  90. package/dist/dispatch.d.ts +18 -0
  91. package/dist/dispatch.js +271 -0
  92. package/dist/engine.d.ts +5 -0
  93. package/dist/engine.js +27 -0
  94. package/dist/errors/index.d.ts +416 -0
  95. package/dist/errors/index.js +681 -0
  96. package/dist/errors/options.d.ts +2 -0
  97. package/dist/errors/options.js +13 -0
  98. package/dist/handlers/cancelHandler.d.ts +29 -0
  99. package/dist/handlers/cancelHandler.js +67 -0
  100. package/dist/handlers/completion-orchestrate.d.ts +41 -0
  101. package/dist/handlers/completion-orchestrate.js +190 -0
  102. package/dist/handlers/delete-cache.d.ts +11 -0
  103. package/dist/handlers/delete-cache.js +37 -0
  104. package/dist/handlers/download-asset.d.ts +2 -0
  105. package/dist/handlers/download-asset.js +146 -0
  106. package/dist/handlers/finetune.d.ts +2 -0
  107. package/dist/handlers/finetune.js +18 -0
  108. package/dist/handlers/get-loaded-model-info.d.ts +2 -0
  109. package/dist/handlers/get-loaded-model-info.js +45 -0
  110. package/dist/handlers/get-model-info.d.ts +2 -0
  111. package/dist/handlers/get-model-info.js +173 -0
  112. package/dist/handlers/get-system-resources.d.ts +2 -0
  113. package/dist/handlers/get-system-resources.js +53 -0
  114. package/dist/handlers/heartbeat.d.ts +2 -0
  115. package/dist/handlers/heartbeat.js +3 -0
  116. package/dist/handlers/load-model/download-manager.d.ts +95 -0
  117. package/dist/handlers/load-model/download-manager.js +306 -0
  118. package/dist/handlers/load-model/download-stats.d.ts +7 -0
  119. package/dist/handlers/load-model/download-stats.js +126 -0
  120. package/dist/handlers/load-model/handler.d.ts +2 -0
  121. package/dist/handlers/load-model/handler.js +287 -0
  122. package/dist/handlers/load-model/http.d.ts +3 -0
  123. package/dist/handlers/load-model/http.js +857 -0
  124. package/dist/handlers/load-model/hyperdrive.d.ts +4 -0
  125. package/dist/handlers/load-model/hyperdrive.js +560 -0
  126. package/dist/handlers/load-model/index.d.ts +2 -0
  127. package/dist/handlers/load-model/index.js +2 -0
  128. package/dist/handlers/load-model/registry-client-options.d.ts +27 -0
  129. package/dist/handlers/load-model/registry-client-options.js +18 -0
  130. package/dist/handlers/load-model/registry-companion-set.d.ts +22 -0
  131. package/dist/handlers/load-model/registry-companion-set.js +206 -0
  132. package/dist/handlers/load-model/registry-download-utils.d.ts +23 -0
  133. package/dist/handlers/load-model/registry-download-utils.js +112 -0
  134. package/dist/handlers/load-model/registry-metadata.d.ts +10 -0
  135. package/dist/handlers/load-model/registry-metadata.js +23 -0
  136. package/dist/handlers/load-model/registry.d.ts +4 -0
  137. package/dist/handlers/load-model/registry.js +298 -0
  138. package/dist/handlers/load-model/resolve-session.d.ts +33 -0
  139. package/dist/handlers/load-model/resolve-session.js +62 -0
  140. package/dist/handlers/load-model/resolve.d.ts +5 -0
  141. package/dist/handlers/load-model/resolve.js +158 -0
  142. package/dist/handlers/load-model/types.d.ts +59 -0
  143. package/dist/handlers/load-model/types.js +28 -0
  144. package/dist/handlers/logging-stream.d.ts +2 -0
  145. package/dist/handlers/logging-stream.js +39 -0
  146. package/dist/handlers/plugin-dispatch.d.ts +3 -0
  147. package/dist/handlers/plugin-dispatch.js +63 -0
  148. package/dist/handlers/plugin-invoke.d.ts +3 -0
  149. package/dist/handlers/plugin-invoke.js +81 -0
  150. package/dist/handlers/registry.d.ts +4 -0
  151. package/dist/handlers/registry.js +156 -0
  152. package/dist/handlers/resume.d.ts +2 -0
  153. package/dist/handlers/resume.js +11 -0
  154. package/dist/handlers/state.d.ts +2 -0
  155. package/dist/handlers/state.js +7 -0
  156. package/dist/handlers/suspend.d.ts +2 -0
  157. package/dist/handlers/suspend.js +11 -0
  158. package/dist/handlers/types.d.ts +13 -0
  159. package/dist/handlers/types.js +1 -0
  160. package/dist/handlers/unload-model.d.ts +2 -0
  161. package/dist/handlers/unload-model.js +29 -0
  162. package/dist/index.d.ts +4 -0
  163. package/dist/index.js +12 -0
  164. package/dist/logging/addon.d.ts +5 -0
  165. package/dist/logging/addon.js +75 -0
  166. package/dist/logging/index.d.ts +5 -0
  167. package/dist/logging/index.js +4 -0
  168. package/dist/logging/logger.d.ts +41 -0
  169. package/dist/logging/logger.js +209 -0
  170. package/dist/logging/namespaces.d.ts +6 -0
  171. package/dist/logging/namespaces.js +7 -0
  172. package/dist/logging/types.d.ts +37 -0
  173. package/dist/logging/types.js +1 -0
  174. package/dist/logging/utils.d.ts +5 -0
  175. package/dist/logging/utils.js +113 -0
  176. package/dist/models/registry/index.d.ts +18 -0
  177. package/dist/models/registry/index.js +21 -0
  178. package/dist/models/registry/models.d.ts +22680 -0
  179. package/dist/models/registry/models.js +23908 -0
  180. package/dist/p2p/cancel-delegated.d.ts +3 -0
  181. package/dist/p2p/cancel-delegated.js +64 -0
  182. package/dist/p2p/completion-stream-delegated.d.ts +4 -0
  183. package/dist/p2p/completion-stream-delegated.js +51 -0
  184. package/dist/p2p/delegate-client.d.ts +9 -0
  185. package/dist/p2p/delegate-client.js +219 -0
  186. package/dist/p2p/delegate-connect-diagnostics.d.ts +8 -0
  187. package/dist/p2p/delegate-connect-diagnostics.js +38 -0
  188. package/dist/p2p/delegate-transport.d.ts +18 -0
  189. package/dist/p2p/delegate-transport.js +237 -0
  190. package/dist/p2p/error-handlers.d.ts +4 -0
  191. package/dist/p2p/error-handlers.js +31 -0
  192. package/dist/p2p/handle-request.d.ts +2 -0
  193. package/dist/p2p/handle-request.js +171 -0
  194. package/dist/p2p/handler-utils.d.ts +19 -0
  195. package/dist/p2p/handler-utils.js +180 -0
  196. package/dist/p2p/heartbeat-delegated.d.ts +3 -0
  197. package/dist/p2p/heartbeat-delegated.js +32 -0
  198. package/dist/p2p/load-model-delegated.d.ts +6 -0
  199. package/dist/p2p/load-model-delegated.js +132 -0
  200. package/dist/p2p/progress-throttle.d.ts +7 -0
  201. package/dist/p2p/progress-throttle.js +47 -0
  202. package/dist/p2p/provideHandler/connection.d.ts +2 -0
  203. package/dist/p2p/provideHandler/connection.js +38 -0
  204. package/dist/p2p/provideHandler/handler.d.ts +2 -0
  205. package/dist/p2p/provideHandler/handler.js +66 -0
  206. package/dist/p2p/provideHandler/proxy.d.ts +2 -0
  207. package/dist/p2p/provideHandler/proxy.js +24 -0
  208. package/dist/p2p/provideHandler.d.ts +1 -0
  209. package/dist/p2p/provideHandler.js +2 -0
  210. package/dist/p2p/rpc-utils.d.ts +4 -0
  211. package/dist/p2p/rpc-utils.js +8 -0
  212. package/dist/p2p/stopProvideHandler.d.ts +2 -0
  213. package/dist/p2p/stopProvideHandler.js +29 -0
  214. package/dist/p2p/swarm.d.ts +9 -0
  215. package/dist/p2p/swarm.js +103 -0
  216. package/dist/p2p/transport-selector.d.ts +2 -0
  217. package/dist/p2p/transport-selector.js +18 -0
  218. package/dist/p2p/unload-model-delegated.d.ts +2 -0
  219. package/dist/p2p/unload-model-delegated.js +31 -0
  220. package/dist/plugins/builtin/asr-ggml/config.d.ts +31 -0
  221. package/dist/plugins/builtin/asr-ggml/config.js +46 -0
  222. package/dist/plugins/builtin/asr-ggml/logging.d.ts +10 -0
  223. package/dist/plugins/builtin/asr-ggml/logging.js +12 -0
  224. package/dist/plugins/builtin/audiogen-ggml/config.d.ts +17 -0
  225. package/dist/plugins/builtin/audiogen-ggml/config.js +23 -0
  226. package/dist/plugins/builtin/audiogen-ggml/ops/audio-gen-stream.d.ts +2 -0
  227. package/dist/plugins/builtin/audiogen-ggml/ops/audio-gen-stream.js +163 -0
  228. package/dist/plugins/builtin/audiogen-ggml/plugin.d.ts +212 -0
  229. package/dist/plugins/builtin/audiogen-ggml/plugin.js +58 -0
  230. package/dist/plugins/builtin/bci-whispercpp-transcription/args.d.ts +2 -0
  231. package/dist/plugins/builtin/bci-whispercpp-transcription/args.js +13 -0
  232. package/dist/plugins/builtin/bci-whispercpp-transcription/plugin.d.ts +173 -0
  233. package/dist/plugins/builtin/bci-whispercpp-transcription/plugin.js +111 -0
  234. package/dist/plugins/builtin/bci-whispercpp-transcription/resolve-config.d.ts +74 -0
  235. package/dist/plugins/builtin/bci-whispercpp-transcription/resolve-config.js +11 -0
  236. package/dist/plugins/builtin/ggml-classification/ops/classify.d.ts +5 -0
  237. package/dist/plugins/builtin/ggml-classification/ops/classify.js +31 -0
  238. package/dist/plugins/builtin/ggml-classification/plugin.d.ts +31 -0
  239. package/dist/plugins/builtin/ggml-classification/plugin.js +55 -0
  240. package/dist/plugins/builtin/ggml-ocr/ops/ocr-stream.d.ts +7 -0
  241. package/dist/plugins/builtin/ggml-ocr/ops/ocr-stream.js +119 -0
  242. package/dist/plugins/builtin/ggml-ocr/plugin.d.ts +102 -0
  243. package/dist/plugins/builtin/ggml-ocr/plugin.js +110 -0
  244. package/dist/plugins/builtin/ggml-ocr/resolve-config.d.ts +5 -0
  245. package/dist/plugins/builtin/ggml-ocr/resolve-config.js +72 -0
  246. package/dist/plugins/builtin/ggml-vla/ops/vla-hparams.d.ts +2 -0
  247. package/dist/plugins/builtin/ggml-vla/ops/vla-hparams.js +12 -0
  248. package/dist/plugins/builtin/ggml-vla/ops/vla-run.d.ts +2 -0
  249. package/dist/plugins/builtin/ggml-vla/ops/vla-run.js +78 -0
  250. package/dist/plugins/builtin/ggml-vla/plugin.d.ts +65 -0
  251. package/dist/plugins/builtin/ggml-vla/plugin.js +57 -0
  252. package/dist/plugins/builtin/index.d.ts +11 -0
  253. package/dist/plugins/builtin/index.js +11 -0
  254. package/dist/plugins/builtin/llamacpp-completion/ops/batch-cancelled.d.ts +22 -0
  255. package/dist/plugins/builtin/llamacpp-completion/ops/batch-cancelled.js +30 -0
  256. package/dist/plugins/builtin/llamacpp-completion/ops/batch-completion-stream.d.ts +31 -0
  257. package/dist/plugins/builtin/llamacpp-completion/ops/batch-completion-stream.js +99 -0
  258. package/dist/plugins/builtin/llamacpp-completion/ops/cache-logger.d.ts +6 -0
  259. package/dist/plugins/builtin/llamacpp-completion/ops/cache-logger.js +36 -0
  260. package/dist/plugins/builtin/llamacpp-completion/ops/completion-stats.d.ts +20 -0
  261. package/dist/plugins/builtin/llamacpp-completion/ops/completion-stats.js +48 -0
  262. package/dist/plugins/builtin/llamacpp-completion/ops/completion-stream.d.ts +45 -0
  263. package/dist/plugins/builtin/llamacpp-completion/ops/completion-stream.js +374 -0
  264. package/dist/plugins/builtin/llamacpp-completion/ops/context-overflow.d.ts +28 -0
  265. package/dist/plugins/builtin/llamacpp-completion/ops/context-overflow.js +65 -0
  266. package/dist/plugins/builtin/llamacpp-completion/ops/finetune.d.ts +10 -0
  267. package/dist/plugins/builtin/llamacpp-completion/ops/finetune.js +209 -0
  268. package/dist/plugins/builtin/llamacpp-completion/ops/kv-cache-session.d.ts +163 -0
  269. package/dist/plugins/builtin/llamacpp-completion/ops/kv-cache-session.js +581 -0
  270. package/dist/plugins/builtin/llamacpp-completion/ops/kv-cache-state.d.ts +56 -0
  271. package/dist/plugins/builtin/llamacpp-completion/ops/kv-cache-state.js +58 -0
  272. package/dist/plugins/builtin/llamacpp-completion/plugin.d.ts +671 -0
  273. package/dist/plugins/builtin/llamacpp-completion/plugin.js +481 -0
  274. package/dist/plugins/builtin/llamacpp-completion/transform.d.ts +9 -0
  275. package/dist/plugins/builtin/llamacpp-completion/transform.js +34 -0
  276. package/dist/plugins/builtin/llamacpp-embedding/plugin.d.ts +76 -0
  277. package/dist/plugins/builtin/llamacpp-embedding/plugin.js +101 -0
  278. package/dist/plugins/builtin/nmtcpp-translation/plugin.d.ts +457 -0
  279. package/dist/plugins/builtin/nmtcpp-translation/plugin.js +143 -0
  280. package/dist/plugins/builtin/nmtcpp-translation/resolve-vocab.d.ts +31 -0
  281. package/dist/plugins/builtin/nmtcpp-translation/resolve-vocab.js +114 -0
  282. package/dist/plugins/builtin/parakeet-transcription/plugin.d.ts +133 -0
  283. package/dist/plugins/builtin/parakeet-transcription/plugin.js +130 -0
  284. package/dist/plugins/builtin/sdcpp-generation/ops/diffusion.d.ts +2 -0
  285. package/dist/plugins/builtin/sdcpp-generation/ops/diffusion.js +64 -0
  286. package/dist/plugins/builtin/sdcpp-generation/ops/upscale.d.ts +2 -0
  287. package/dist/plugins/builtin/sdcpp-generation/ops/upscale.js +41 -0
  288. package/dist/plugins/builtin/sdcpp-generation/ops/video.d.ts +5 -0
  289. package/dist/plugins/builtin/sdcpp-generation/ops/video.js +239 -0
  290. package/dist/plugins/builtin/sdcpp-generation/plugin.d.ts +757 -0
  291. package/dist/plugins/builtin/sdcpp-generation/plugin.js +310 -0
  292. package/dist/plugins/builtin/tts-ggml/ops/parler-options.d.ts +6 -0
  293. package/dist/plugins/builtin/tts-ggml/ops/parler-options.js +30 -0
  294. package/dist/plugins/builtin/tts-ggml/ops/text-to-speech-stream.d.ts +7 -0
  295. package/dist/plugins/builtin/tts-ggml/ops/text-to-speech-stream.js +106 -0
  296. package/dist/plugins/builtin/tts-ggml/ops/text-to-speech.d.ts +6 -0
  297. package/dist/plugins/builtin/tts-ggml/ops/text-to-speech.js +91 -0
  298. package/dist/plugins/builtin/tts-ggml/plugin.d.ts +196 -0
  299. package/dist/plugins/builtin/tts-ggml/plugin.js +305 -0
  300. package/dist/plugins/builtin/whispercpp-transcription/plugin.d.ts +346 -0
  301. package/dist/plugins/builtin/whispercpp-transcription/plugin.js +169 -0
  302. package/dist/plugins/index.d.ts +9 -0
  303. package/dist/plugins/index.js +12 -0
  304. package/dist/plugins/ops/bci-transcribe.d.ts +13 -0
  305. package/dist/plugins/ops/bci-transcribe.js +248 -0
  306. package/dist/plugins/ops/cancel.d.ts +25 -0
  307. package/dist/plugins/ops/cancel.js +43 -0
  308. package/dist/plugins/ops/embed.d.ts +15 -0
  309. package/dist/plugins/ops/embed.js +193 -0
  310. package/dist/plugins/ops/kv-cache-retention.d.ts +11 -0
  311. package/dist/plugins/ops/kv-cache-retention.js +121 -0
  312. package/dist/plugins/ops/kv-cache-utils.d.ts +21 -0
  313. package/dist/plugins/ops/kv-cache-utils.js +120 -0
  314. package/dist/plugins/ops/load-model.d.ts +8 -0
  315. package/dist/plugins/ops/load-model.js +82 -0
  316. package/dist/plugins/ops/transcribe.d.ts +20 -0
  317. package/dist/plugins/ops/transcribe.js +343 -0
  318. package/dist/plugins/ops/translate.d.ts +7 -0
  319. package/dist/plugins/ops/translate.js +256 -0
  320. package/dist/plugins/ops/unload-model.d.ts +2 -0
  321. package/dist/plugins/ops/unload-model.js +45 -0
  322. package/dist/plugins/registry.d.ts +9 -0
  323. package/dist/plugins/registry.js +107 -0
  324. package/dist/profiling/aggregator.d.ts +14 -0
  325. package/dist/profiling/aggregator.js +100 -0
  326. package/dist/profiling/backend-diagnostics.d.ts +8 -0
  327. package/dist/profiling/backend-diagnostics.js +36 -0
  328. package/dist/profiling/clock.d.ts +8 -0
  329. package/dist/profiling/clock.js +23 -0
  330. package/dist/profiling/controller.d.ts +34 -0
  331. package/dist/profiling/controller.js +130 -0
  332. package/dist/profiling/delegation-profiler.d.ts +31 -0
  333. package/dist/profiling/delegation-profiler.js +155 -0
  334. package/dist/profiling/envelope.d.ts +10 -0
  335. package/dist/profiling/envelope.js +45 -0
  336. package/dist/profiling/events.d.ts +19 -0
  337. package/dist/profiling/events.js +35 -0
  338. package/dist/profiling/exporters.d.ts +9 -0
  339. package/dist/profiling/exporters.js +242 -0
  340. package/dist/profiling/index.d.ts +91 -0
  341. package/dist/profiling/index.js +87 -0
  342. package/dist/profiling/model-execution.d.ts +15 -0
  343. package/dist/profiling/model-execution.js +34 -0
  344. package/dist/profiling/operation-metrics.d.ts +24 -0
  345. package/dist/profiling/operation-metrics.js +370 -0
  346. package/dist/profiling/operation-wrappers.d.ts +17 -0
  347. package/dist/profiling/operation-wrappers.js +196 -0
  348. package/dist/profiling/profiler.d.ts +27 -0
  349. package/dist/profiling/profiler.js +127 -0
  350. package/dist/profiling/ring-buffer.d.ts +18 -0
  351. package/dist/profiling/ring-buffer.js +83 -0
  352. package/dist/profiling/types.d.ts +52 -0
  353. package/dist/profiling/types.js +1 -0
  354. package/dist/rag/handler.d.ts +2 -0
  355. package/dist/rag/handler.js +272 -0
  356. package/dist/rag/handlers/chunk.d.ts +2 -0
  357. package/dist/rag/handlers/chunk.js +7 -0
  358. package/dist/rag/handlers/close-workspace.d.ts +2 -0
  359. package/dist/rag/handlers/close-workspace.js +9 -0
  360. package/dist/rag/handlers/delete-embeddings.d.ts +2 -0
  361. package/dist/rag/handlers/delete-embeddings.js +11 -0
  362. package/dist/rag/handlers/delete-workspace.d.ts +2 -0
  363. package/dist/rag/handlers/delete-workspace.js +14 -0
  364. package/dist/rag/handlers/ingest.d.ts +9 -0
  365. package/dist/rag/handlers/ingest.js +19 -0
  366. package/dist/rag/handlers/list-workspaces.d.ts +2 -0
  367. package/dist/rag/handlers/list-workspaces.js +4 -0
  368. package/dist/rag/handlers/reindex.d.ts +9 -0
  369. package/dist/rag/handlers/reindex.js +16 -0
  370. package/dist/rag/handlers/save-embeddings.d.ts +9 -0
  371. package/dist/rag/handlers/save-embeddings.js +15 -0
  372. package/dist/rag/handlers/search.d.ts +2 -0
  373. package/dist/rag/handlers/search.js +16 -0
  374. package/dist/rag/index.d.ts +11 -0
  375. package/dist/rag/index.js +11 -0
  376. package/dist/rag/rag-operation-manager.d.ts +28 -0
  377. package/dist/rag/rag-operation-manager.js +76 -0
  378. package/dist/rag/rag-workspace-manager.d.ts +14 -0
  379. package/dist/rag/rag-workspace-manager.js +143 -0
  380. package/dist/registry.d.ts +2 -0
  381. package/dist/registry.js +166 -0
  382. package/dist/resources/collector.d.ts +643 -0
  383. package/dist/resources/collector.js +226 -0
  384. package/dist/resources/instance.d.ts +4 -0
  385. package/dist/resources/instance.js +15 -0
  386. package/dist/resources/native.d.ts +2 -0
  387. package/dist/resources/native.js +35 -0
  388. package/dist/resources/normalize.d.ts +12 -0
  389. package/dist/resources/normalize.js +73 -0
  390. package/dist/resources/types.d.ts +65 -0
  391. package/dist/resources/types.js +1 -0
  392. package/dist/runtime/cache-lock.d.ts +2 -0
  393. package/dist/runtime/cache-lock.js +67 -0
  394. package/dist/runtime/disposable-scope.d.ts +35 -0
  395. package/dist/runtime/disposable-scope.js +69 -0
  396. package/dist/runtime/env.d.ts +16 -0
  397. package/dist/runtime/env.js +53 -0
  398. package/dist/runtime/index.d.ts +5 -0
  399. package/dist/runtime/index.js +2 -0
  400. package/dist/runtime/lifecycle.d.ts +20 -0
  401. package/dist/runtime/lifecycle.js +102 -0
  402. package/dist/runtime/logging-stream-registry.d.ts +27 -0
  403. package/dist/runtime/logging-stream-registry.js +133 -0
  404. package/dist/runtime/model-config-utils.d.ts +14 -0
  405. package/dist/runtime/model-config-utils.js +128 -0
  406. package/dist/runtime/model-registry.d.ts +74 -0
  407. package/dist/runtime/model-registry.js +130 -0
  408. package/dist/runtime/registry-client.d.ts +4 -0
  409. package/dist/runtime/registry-client.js +118 -0
  410. package/dist/runtime/request-context.d.ts +72 -0
  411. package/dist/runtime/request-context.js +114 -0
  412. package/dist/runtime/request-id.d.ts +17 -0
  413. package/dist/runtime/request-id.js +29 -0
  414. package/dist/runtime/request-registry.d.ts +194 -0
  415. package/dist/runtime/request-registry.js +546 -0
  416. package/dist/runtime/runtime-lifecycle.d.ts +37 -0
  417. package/dist/runtime/runtime-lifecycle.js +163 -0
  418. package/dist/runtime/state.d.ts +26 -0
  419. package/dist/runtime/state.js +138 -0
  420. package/dist/schemas/audio-gen.d.ts +252 -0
  421. package/dist/schemas/audio-gen.js +69 -0
  422. package/dist/schemas/batch-completion-stream.d.ts +467 -0
  423. package/dist/schemas/batch-completion-stream.js +123 -0
  424. package/dist/schemas/bci-config.d.ts +74 -0
  425. package/dist/schemas/bci-config.js +58 -0
  426. package/dist/schemas/bci.d.ts +178 -0
  427. package/dist/schemas/bci.js +89 -0
  428. package/dist/schemas/cancel.d.ts +203 -0
  429. package/dist/schemas/cancel.js +135 -0
  430. package/dist/schemas/classification.d.ts +52 -0
  431. package/dist/schemas/classification.js +33 -0
  432. package/dist/schemas/common.d.ts +6420 -0
  433. package/dist/schemas/common.js +133 -0
  434. package/dist/schemas/completion-event.d.ts +248 -0
  435. package/dist/schemas/completion-event.js +94 -0
  436. package/dist/schemas/completion-stream.d.ts +475 -0
  437. package/dist/schemas/completion-stream.js +236 -0
  438. package/dist/schemas/config.d.ts +5022 -0
  439. package/dist/schemas/config.js +169 -0
  440. package/dist/schemas/delegate.d.ts +29 -0
  441. package/dist/schemas/delegate.js +40 -0
  442. package/dist/schemas/download-asset.d.ts +225 -0
  443. package/dist/schemas/download-asset.js +71 -0
  444. package/dist/schemas/embed.d.ts +41 -0
  445. package/dist/schemas/embed.js +35 -0
  446. package/dist/schemas/engine-addon-map.d.ts +20 -0
  447. package/dist/schemas/engine-addon-map.js +78 -0
  448. package/dist/schemas/error.d.ts +40 -0
  449. package/dist/schemas/error.js +65 -0
  450. package/dist/schemas/errors.d.ts +119 -0
  451. package/dist/schemas/errors.js +615 -0
  452. package/dist/schemas/finetune.d.ts +621 -0
  453. package/dist/schemas/finetune.js +163 -0
  454. package/dist/schemas/index.d.ts +45 -0
  455. package/dist/schemas/index.js +45 -0
  456. package/dist/schemas/json-schema.d.ts +15 -0
  457. package/dist/schemas/json-schema.js +2 -0
  458. package/dist/schemas/lifecycle.d.ts +38 -0
  459. package/dist/schemas/lifecycle.js +21 -0
  460. package/dist/schemas/llamacpp-config.d.ts +403 -0
  461. package/dist/schemas/llamacpp-config.js +133 -0
  462. package/dist/schemas/load-model.d.ts +25635 -0
  463. package/dist/schemas/load-model.js +629 -0
  464. package/dist/schemas/logging-stream.d.ts +33 -0
  465. package/dist/schemas/logging-stream.js +17 -0
  466. package/dist/schemas/mcp-adapter.d.ts +46 -0
  467. package/dist/schemas/mcp-adapter.js +1 -0
  468. package/dist/schemas/model-file.d.ts +27 -0
  469. package/dist/schemas/model-file.js +29 -0
  470. package/dist/schemas/model-info.d.ts +197 -0
  471. package/dist/schemas/model-info.js +144 -0
  472. package/dist/schemas/model-ops.d.ts +36 -0
  473. package/dist/schemas/model-ops.js +40 -0
  474. package/dist/schemas/model-src-utils.d.ts +192 -0
  475. package/dist/schemas/model-src-utils.js +61 -0
  476. package/dist/schemas/model-types.d.ts +275 -0
  477. package/dist/schemas/model-types.js +223 -0
  478. package/dist/schemas/ocr.d.ts +138 -0
  479. package/dist/schemas/ocr.js +59 -0
  480. package/dist/schemas/path-validation.d.ts +9 -0
  481. package/dist/schemas/path-validation.js +22 -0
  482. package/dist/schemas/plugin.d.ts +341 -0
  483. package/dist/schemas/plugin.js +241 -0
  484. package/dist/schemas/profiling.d.ts +695 -0
  485. package/dist/schemas/profiling.js +100 -0
  486. package/dist/schemas/provide.d.ts +50 -0
  487. package/dist/schemas/provide.js +32 -0
  488. package/dist/schemas/rag.d.ts +301 -0
  489. package/dist/schemas/rag.js +211 -0
  490. package/dist/schemas/registry.d.ts +453 -0
  491. package/dist/schemas/registry.js +104 -0
  492. package/dist/schemas/reload-config.d.ts +585 -0
  493. package/dist/schemas/reload-config.js +42 -0
  494. package/dist/schemas/runtime-context.d.ts +18 -0
  495. package/dist/schemas/runtime-context.js +7 -0
  496. package/dist/schemas/sdcpp-config.d.ts +1126 -0
  497. package/dist/schemas/sdcpp-config.js +748 -0
  498. package/dist/schemas/system-resources.d.ts +3966 -0
  499. package/dist/schemas/system-resources.js +149 -0
  500. package/dist/schemas/text-to-speech.d.ts +1352 -0
  501. package/dist/schemas/text-to-speech.js +364 -0
  502. package/dist/schemas/tools.d.ts +80 -0
  503. package/dist/schemas/tools.js +52 -0
  504. package/dist/schemas/transcription-config.d.ts +161 -0
  505. package/dist/schemas/transcription-config.js +156 -0
  506. package/dist/schemas/transcription.d.ts +261 -0
  507. package/dist/schemas/transcription.js +145 -0
  508. package/dist/schemas/translate.d.ts +138 -0
  509. package/dist/schemas/translate.js +103 -0
  510. package/dist/schemas/translation-config.d.ts +1031 -0
  511. package/dist/schemas/translation-config.js +170 -0
  512. package/dist/schemas/vla.d.ts +110 -0
  513. package/dist/schemas/vla.js +151 -0
  514. package/dist/selection.d.ts +8 -0
  515. package/dist/selection.js +14 -0
  516. package/dist/surface.d.ts +18 -0
  517. package/dist/surface.js +30 -0
  518. package/dist/utils/addon-responses.d.ts +58 -0
  519. package/dist/utils/addon-responses.js +1 -0
  520. package/dist/utils/aggregate-events.d.ts +25 -0
  521. package/dist/utils/aggregate-events.js +73 -0
  522. package/dist/utils/archive.d.ts +4 -0
  523. package/dist/utils/archive.js +180 -0
  524. package/dist/utils/asr-events.d.ts +14 -0
  525. package/dist/utils/asr-events.js +30 -0
  526. package/dist/utils/audio/decoder.d.ts +4 -0
  527. package/dist/utils/audio/decoder.js +80 -0
  528. package/dist/utils/audio-input.d.ts +9 -0
  529. package/dist/utils/audio-input.js +34 -0
  530. package/dist/utils/cache/auto-history.d.ts +3 -0
  531. package/dist/utils/cache/auto-history.js +26 -0
  532. package/dist/utils/cache/paths.d.ts +42 -0
  533. package/dist/utils/cache/paths.js +133 -0
  534. package/dist/utils/cache/types.d.ts +7 -0
  535. package/dist/utils/cache/types.js +1 -0
  536. package/dist/utils/cache-normalize.d.ts +9 -0
  537. package/dist/utils/cache-normalize.js +20 -0
  538. package/dist/utils/checksum.d.ts +3 -0
  539. package/dist/utils/checksum.js +29 -0
  540. package/dist/utils/clear-storage.d.ts +4 -0
  541. package/dist/utils/clear-storage.js +14 -0
  542. package/dist/utils/completion-normalizer.d.ts +17 -0
  543. package/dist/utils/completion-normalizer.js +453 -0
  544. package/dist/utils/config-transform.d.ts +2 -0
  545. package/dist/utils/config-transform.js +21 -0
  546. package/dist/utils/decorate-promise.d.ts +33 -0
  547. package/dist/utils/decorate-promise.js +35 -0
  548. package/dist/utils/encoding.d.ts +16 -0
  549. package/dist/utils/encoding.js +27 -0
  550. package/dist/utils/expand-gguf-shards.d.ts +2 -0
  551. package/dist/utils/expand-gguf-shards.js +22 -0
  552. package/dist/utils/formatting.d.ts +18 -0
  553. package/dist/utils/formatting.js +56 -0
  554. package/dist/utils/gguf-tensor-extractor.d.ts +14 -0
  555. package/dist/utils/gguf-tensor-extractor.js +311 -0
  556. package/dist/utils/global-singleton.d.ts +1 -0
  557. package/dist/utils/global-singleton.js +10 -0
  558. package/dist/utils/index.d.ts +11 -0
  559. package/dist/utils/index.js +11 -0
  560. package/dist/utils/load-model-validation.d.ts +6 -0
  561. package/dist/utils/load-model-validation.js +18 -0
  562. package/dist/utils/mcp-adapter.d.ts +11 -0
  563. package/dist/utils/mcp-adapter.js +96 -0
  564. package/dist/utils/multi-gpu-mobile.d.ts +4 -0
  565. package/dist/utils/multi-gpu-mobile.js +10 -0
  566. package/dist/utils/object.d.ts +1 -0
  567. package/dist/utils/object.js +3 -0
  568. package/dist/utils/path-security.d.ts +22 -0
  569. package/dist/utils/path-security.js +69 -0
  570. package/dist/utils/qvac-paths.d.ts +1 -0
  571. package/dist/utils/qvac-paths.js +5 -0
  572. package/dist/utils/response-format.d.ts +2 -0
  573. package/dist/utils/response-format.js +20 -0
  574. package/dist/utils/shard-utils.d.ts +47 -0
  575. package/dist/utils/shard-utils.js +123 -0
  576. package/dist/utils/tool-helpers.d.ts +24 -0
  577. package/dist/utils/tool-helpers.js +111 -0
  578. package/dist/utils/tool-integration.d.ts +23 -0
  579. package/dist/utils/tool-integration.js +29 -0
  580. package/dist/utils/tools/dialect.d.ts +7 -0
  581. package/dist/utils/tools/dialect.js +20 -0
  582. package/dist/utils/tools/index.d.ts +2 -0
  583. package/dist/utils/tools/index.js +2 -0
  584. package/dist/utils/tools/parser.d.ts +5 -0
  585. package/dist/utils/tools/parser.js +69 -0
  586. package/dist/utils/tools/parsers/dsml.d.ts +3 -0
  587. package/dist/utils/tools/parsers/dsml.js +177 -0
  588. package/dist/utils/tools/parsers/gemma4native.d.ts +3 -0
  589. package/dist/utils/tools/parsers/gemma4native.js +65 -0
  590. package/dist/utils/tools/parsers/harmony.d.ts +3 -0
  591. package/dist/utils/tools/parsers/harmony.js +57 -0
  592. package/dist/utils/tools/parsers/hermes.d.ts +3 -0
  593. package/dist/utils/tools/parsers/hermes.js +122 -0
  594. package/dist/utils/tools/parsers/json.d.ts +5 -0
  595. package/dist/utils/tools/parsers/json.js +115 -0
  596. package/dist/utils/tools/parsers/pythonic.d.ts +3 -0
  597. package/dist/utils/tools/parsers/pythonic.js +267 -0
  598. package/dist/utils/tools/parsers/qwen35.d.ts +3 -0
  599. package/dist/utils/tools/parsers/qwen35.js +125 -0
  600. package/dist/utils/tools/shared.d.ts +17 -0
  601. package/dist/utils/tools/shared.js +52 -0
  602. package/dist/utils/transcribe-metadata.d.ts +20 -0
  603. package/dist/utils/transcribe-metadata.js +28 -0
  604. package/dist/utils/tts-stats.d.ts +25 -0
  605. package/dist/utils/tts-stats.js +16 -0
  606. package/dist/utils/withTimeout.d.ts +17 -0
  607. package/dist/utils/withTimeout.js +47 -0
  608. package/dist/utils/zod-error.d.ts +2 -0
  609. package/dist/utils/zod-error.js +4 -0
  610. package/package.json +266 -1
@@ -0,0 +1,615 @@
1
+ import { addCodes } from '@qvac/error';
2
+ // Numeric error codes for the whole library. Consumers match on the number, so
3
+ // the values are a stable contract. Ranges group codes by domain.
4
+ export const ERROR_CODES = {
5
+ // Response / request validation (50,001-50,199)
6
+ INVALID_RESPONSE_TYPE: 50001,
7
+ INVALID_OPERATION_IN_RESPONSE: 50002,
8
+ STREAM_ENDED_WITHOUT_RESPONSE: 50003,
9
+ INVALID_TOOLS_ARRAY: 50005,
10
+ INVALID_TOOL_SCHEMA: 50006,
11
+ MODEL_TYPE_REQUIRED: 50008,
12
+ MODEL_SRC_TYPE_MISMATCH: 50009,
13
+ REQUEST_VALIDATION_FAILED: 50010,
14
+ // Dispatch (50,200-50,399)
15
+ RPC_NO_HANDLER: 50200,
16
+ // Provider / delegation, consumer side (50,400-50,599)
17
+ PROVIDER_START_FAILED: 50400,
18
+ PROVIDER_STOP_FAILED: 50401,
19
+ // Config file resolution (50,600-50,799)
20
+ CONFIG_FILE_INVALID: 50603,
21
+ CONFIG_FILE_PARSE_FAILED: 50604,
22
+ CONFIG_VALIDATION_FAILED: 50605,
23
+ PLUGINS_NOT_REGISTERED: 50608,
24
+ // Profiler (50,800-50,899)
25
+ PROFILER_INVALID_CAPACITY: 50800,
26
+ // Model registry (52,001-52,199)
27
+ MODEL_ALREADY_REGISTERED: 52001,
28
+ MODEL_NOT_FOUND: 52002,
29
+ MODEL_NOT_LOADED: 52003,
30
+ MODEL_IS_DELEGATED: 52004,
31
+ UNKNOWN_MODEL_TYPE: 52005,
32
+ // Model loading (52,200-52,399)
33
+ MODEL_LOAD_FAILED: 52200,
34
+ MODEL_FILE_NOT_FOUND: 52201,
35
+ MODEL_FILE_NOT_FOUND_IN_DIR: 52202,
36
+ MODEL_FILE_LOCATE_FAILED: 52203,
37
+ PROJECTION_MODEL_REQUIRED: 52204,
38
+ VAD_MODEL_REQUIRED: 52205,
39
+ TTS_ARTIFACTS_REQUIRED: 52208,
40
+ TTS_REFERENCE_AUDIO_REQUIRED: 52209,
41
+ LEGACY_PARAKEET_MODEL_DEPRECATED: 52210,
42
+ LEGACY_TTS_MODEL_DEPRECATED: 52211,
43
+ // Model operations (52,400-52,799)
44
+ MODEL_UNLOAD_FAILED: 52400,
45
+ EMBED_FAILED: 52401,
46
+ EMBED_NO_EMBEDDINGS: 52402,
47
+ TRANSCRIPTION_FAILED: 52403,
48
+ AUDIO_FILE_NOT_FOUND: 52404,
49
+ TRANSLATION_FAILED: 52405,
50
+ COMPLETION_FAILED: 52406,
51
+ ATTACHMENT_NOT_FOUND: 52407,
52
+ CANCEL_FAILED: 52408,
53
+ TEXT_TO_SPEECH_FAILED: 52409,
54
+ CONFIG_RELOAD_NOT_SUPPORTED: 52410,
55
+ MODEL_TYPE_MISMATCH: 52411,
56
+ IMAGE_FILE_NOT_FOUND: 52413,
57
+ INVALID_IMAGE_INPUT: 52414,
58
+ TEXT_TO_SPEECH_STREAM_FAILED: 52415,
59
+ MODEL_OPERATION_NOT_SUPPORTED: 52416,
60
+ REQUEST_ID_CONFLICT: 52417,
61
+ REQUEST_NOT_FOUND: 52418,
62
+ INFERENCE_CANCELLED: 52419,
63
+ REQUEST_REJECTED_BY_POLICY: 52420,
64
+ CONTEXT_OVERFLOW: 52421,
65
+ // RAG operations (52,800-52,999)
66
+ RAG_SAVE_FAILED: 52800,
67
+ RAG_SEARCH_FAILED: 52801,
68
+ RAG_DELETE_FAILED: 52802,
69
+ RAG_UNKNOWN_OPERATION: 52803,
70
+ RAG_HYPERDB_FAILED: 52804,
71
+ RAG_WORKSPACE_MODEL_MISMATCH: 52805,
72
+ RAG_WORKSPACE_NOT_FOUND: 52806,
73
+ RAG_WORKSPACE_IN_USE: 52807,
74
+ RAG_WORKSPACE_CLOSE_FAILED: 52808,
75
+ RAG_LIST_WORKSPACES_FAILED: 52809,
76
+ RAG_CHUNK_FAILED: 52810,
77
+ RAG_WORKSPACE_NOT_OPEN: 52811,
78
+ // Download / resource (53,000-53,199)
79
+ FILE_NOT_FOUND: 53000,
80
+ DOWNLOAD_CANCELLED: 53001,
81
+ CHECKSUM_VALIDATION_FAILED: 53002,
82
+ HTTP_ERROR: 53003,
83
+ NO_RESPONSE_BODY: 53004,
84
+ RESPONSE_BODY_NOT_READABLE: 53005,
85
+ NO_BLOB_FOUND: 53006,
86
+ DOWNLOAD_ASSET_FAILED: 53007,
87
+ SEEDING_NOT_SUPPORTED: 53008,
88
+ HYPERDRIVE_DOWNLOAD_FAILED: 53009,
89
+ INVALID_SHARD_URL_PATTERN: 53010,
90
+ ARCHIVE_EXTRACTION_FAILED: 53011,
91
+ ARCHIVE_UNSUPPORTED_TYPE: 53012,
92
+ ARCHIVE_MISSING_SHARDS: 53013,
93
+ PARTIAL_DOWNLOAD_OFFLINE: 53014,
94
+ REGISTRY_DOWNLOAD_FAILED: 53015,
95
+ // Cache operations (53,200-53,349)
96
+ DELETE_CACHE_FAILED: 53200,
97
+ INVALID_DELETE_CACHE_PARAMS: 53201,
98
+ CACHE_DIR_NOT_ABSOLUTE: 53202,
99
+ CACHE_DIR_NOT_WRITABLE: 53203,
100
+ // Config operations (53,350-53,499)
101
+ CONFIG_ALREADY_SET: 53351,
102
+ // Lifecycle (53,600-53,610)
103
+ LIFECYCLE_SUSPEND_FAILED: 53600,
104
+ LIFECYCLE_RESUME_FAILED: 53601,
105
+ LIFECYCLE_OPERATION_BLOCKED: 53602,
106
+ // System / runtime (53,500-53,699)
107
+ FFMPEG_NOT_AVAILABLE: 53500,
108
+ AUDIO_PLAYER_FAILED: 53501,
109
+ INVALID_AUDIO_CHUNK_TYPE: 53502,
110
+ ASYNC_DISPOSE_UNAVAILABLE: 53503,
111
+ // Delegation, provider side (53,700-53,849)
112
+ DELEGATE_NO_FINAL_RESPONSE: 53700,
113
+ DELEGATE_CONNECTION_FAILED: 53701,
114
+ DELEGATE_PROVIDER_ERROR: 53702,
115
+ RPC_NO_DATA_RECEIVED: 53703,
116
+ RPC_UNKNOWN_REQUEST_TYPE: 53704,
117
+ // Plugin errors (53,850-53,899)
118
+ PLUGIN_NOT_FOUND: 53850,
119
+ PLUGIN_HANDLER_NOT_FOUND: 53851,
120
+ PLUGIN_REQUEST_VALIDATION_FAILED: 53852,
121
+ PLUGIN_RESPONSE_VALIDATION_FAILED: 53853,
122
+ PLUGIN_ALREADY_REGISTERED: 53854,
123
+ PLUGIN_HANDLER_TYPE_MISMATCH: 53855,
124
+ PLUGIN_LOGGING_INVALID: 53856,
125
+ PLUGIN_DEFINITION_INVALID: 53857,
126
+ PLUGIN_MODEL_TYPE_RESERVED: 53858,
127
+ PLUGIN_LOAD_CONFIG_VALIDATION_FAILED: 53859,
128
+ // Security (53,900-53,949)
129
+ PATH_TRAVERSAL: 53900,
130
+ // Model registry query (53,950-54,000)
131
+ QVAC_MODEL_REGISTRY_QUERY_FAILED: 53950
132
+ };
133
+ const errorDefinitions = {
134
+ // Response / request validation
135
+ [ERROR_CODES.INVALID_RESPONSE_TYPE]: {
136
+ name: 'INVALID_RESPONSE_TYPE',
137
+ message: (expected) => `Invalid response type received, expected: ${expected}`
138
+ },
139
+ [ERROR_CODES.INVALID_OPERATION_IN_RESPONSE]: {
140
+ name: 'INVALID_OPERATION_IN_RESPONSE',
141
+ message: 'Invalid operation type in response'
142
+ },
143
+ [ERROR_CODES.STREAM_ENDED_WITHOUT_RESPONSE]: {
144
+ name: 'STREAM_ENDED_WITHOUT_RESPONSE',
145
+ message: 'Stream ended without receiving final response'
146
+ },
147
+ [ERROR_CODES.INVALID_TOOLS_ARRAY]: {
148
+ name: 'INVALID_TOOLS_ARRAY',
149
+ message: 'Invalid tools array provided'
150
+ },
151
+ [ERROR_CODES.INVALID_TOOL_SCHEMA]: {
152
+ name: 'INVALID_TOOL_SCHEMA',
153
+ message: (details) => `Invalid tool schema: ${details}`
154
+ },
155
+ [ERROR_CODES.MODEL_TYPE_REQUIRED]: {
156
+ name: 'MODEL_TYPE_REQUIRED',
157
+ message: 'modelType is required: modelSrc is a plain string or lacks an engine/addon descriptor that can be inferred. Pass an explicit canonical modelType (e.g. "llamacpp-completion", "whispercpp-transcription", "nmtcpp-translation", "llamacpp-embedding", "tts-ggml", "ggml-ocr", "parakeet-transcription", "sdcpp-generation") or use a model constant that carries engine metadata.'
158
+ },
159
+ [ERROR_CODES.MODEL_SRC_TYPE_MISMATCH]: {
160
+ name: 'MODEL_SRC_TYPE_MISMATCH',
161
+ message: (inferred, resolved) => `modelSrc describes "${inferred}", but modelType resolves to "${resolved}". Omit modelType to infer it automatically, or pass a matching modelType.`
162
+ },
163
+ [ERROR_CODES.REQUEST_VALIDATION_FAILED]: {
164
+ name: 'REQUEST_VALIDATION_FAILED',
165
+ message: (errors) => `Invalid request:\n${errors}`
166
+ },
167
+ // Dispatch
168
+ [ERROR_CODES.RPC_NO_HANDLER]: {
169
+ name: 'RPC_NO_HANDLER',
170
+ message: (requestType) => `No handler function registered for request type: ${requestType}`
171
+ },
172
+ // Provider / delegation, consumer side
173
+ [ERROR_CODES.PROVIDER_START_FAILED]: {
174
+ name: 'PROVIDER_START_FAILED',
175
+ message: (details) => `Failed to start provider${details ? `: ${details}` : ''}`
176
+ },
177
+ [ERROR_CODES.PROVIDER_STOP_FAILED]: {
178
+ name: 'PROVIDER_STOP_FAILED',
179
+ message: (details) => `Failed to stop provider${details ? `: ${details}` : ''}`
180
+ },
181
+ // Config file resolution
182
+ [ERROR_CODES.CONFIG_FILE_INVALID]: {
183
+ name: 'CONFIG_FILE_INVALID',
184
+ message: (filePath, reason) => `Config file at ${filePath} is invalid: ${reason}`
185
+ },
186
+ [ERROR_CODES.CONFIG_FILE_PARSE_FAILED]: {
187
+ name: 'CONFIG_FILE_PARSE_FAILED',
188
+ message: (filePath, error) => `Failed to parse config file at ${filePath}: ${error}`
189
+ },
190
+ [ERROR_CODES.CONFIG_VALIDATION_FAILED]: {
191
+ name: 'CONFIG_VALIDATION_FAILED',
192
+ message: (errors) => `Config validation failed: ${errors}`
193
+ },
194
+ [ERROR_CODES.PLUGINS_NOT_REGISTERED]: {
195
+ name: 'PLUGINS_NOT_REGISTERED',
196
+ message: () => 'No plugins registered. Assemble the engines you need with `plugins([...])` or `registerPlugin(...)` before your first call — import each from its subpath, e.g. `@qvac/inference/llamacpp-completion/plugin`.'
197
+ },
198
+ // Profiler
199
+ [ERROR_CODES.PROFILER_INVALID_CAPACITY]: {
200
+ name: 'PROFILER_INVALID_CAPACITY',
201
+ message: (minCapacity) => `Ring buffer capacity must be at least ${minCapacity}`
202
+ },
203
+ // Model registry
204
+ [ERROR_CODES.MODEL_ALREADY_REGISTERED]: {
205
+ name: 'MODEL_ALREADY_REGISTERED',
206
+ message: (modelId) => `Model with ID "${modelId}" is already registered`
207
+ },
208
+ [ERROR_CODES.MODEL_NOT_FOUND]: {
209
+ name: 'MODEL_NOT_FOUND',
210
+ message: (modelId) => `Model with ID "${modelId}" not found`
211
+ },
212
+ [ERROR_CODES.MODEL_NOT_LOADED]: {
213
+ name: 'MODEL_NOT_LOADED',
214
+ message: (modelId) => `Model with ID "${modelId}" is not loaded`
215
+ },
216
+ [ERROR_CODES.MODEL_IS_DELEGATED]: {
217
+ name: 'MODEL_IS_DELEGATED',
218
+ message: (modelId) => `Model "${modelId}" is a delegated model and cannot be accessed directly`
219
+ },
220
+ [ERROR_CODES.UNKNOWN_MODEL_TYPE]: {
221
+ name: 'UNKNOWN_MODEL_TYPE',
222
+ message: (modelType) => `Unknown model type: ${modelType}. Register the plugin for "${modelType}" in code with \`registerPlugin\` / \`plugins([...])\` before this call.`
223
+ },
224
+ // Model loading
225
+ [ERROR_CODES.MODEL_LOAD_FAILED]: {
226
+ name: 'MODEL_LOAD_FAILED',
227
+ message: (details) => `Failed to load model${details ? `: ${details}` : ''}`
228
+ },
229
+ [ERROR_CODES.MODEL_FILE_NOT_FOUND]: {
230
+ name: 'MODEL_FILE_NOT_FOUND',
231
+ message: (modelPath) => `Model file not found: ${modelPath}`
232
+ },
233
+ [ERROR_CODES.MODEL_FILE_NOT_FOUND_IN_DIR]: {
234
+ name: 'MODEL_FILE_NOT_FOUND_IN_DIR',
235
+ message: (modelFile, modelDir, modelType) => `${modelType} model file ${modelFile} not found in directory ${modelDir}`
236
+ },
237
+ [ERROR_CODES.MODEL_FILE_LOCATE_FAILED]: {
238
+ name: 'MODEL_FILE_LOCATE_FAILED',
239
+ message: (modelType, modelPath) => `Failed to locate ${modelType} model file: ${modelPath}`
240
+ },
241
+ [ERROR_CODES.PROJECTION_MODEL_REQUIRED]: {
242
+ name: 'PROJECTION_MODEL_REQUIRED',
243
+ message: 'Projection model source is required for multimodal LLM models'
244
+ },
245
+ [ERROR_CODES.VAD_MODEL_REQUIRED]: {
246
+ name: 'VAD_MODEL_REQUIRED',
247
+ message: 'VAD model source is required for this configuration'
248
+ },
249
+ [ERROR_CODES.TTS_ARTIFACTS_REQUIRED]: {
250
+ name: 'TTS_ARTIFACTS_REQUIRED',
251
+ message: 'TTS (Chatterbox) requires s3genModelSrc in modelConfig (companion S3Gen GGUF) and the primary T3 GGUF via modelSrc'
252
+ },
253
+ [ERROR_CODES.TTS_REFERENCE_AUDIO_REQUIRED]: {
254
+ name: 'TTS_REFERENCE_AUDIO_REQUIRED',
255
+ message: 'TTS (Chatterbox) requires referenceAudioSrc (path or URL to a WAV file for voice cloning)'
256
+ },
257
+ [ERROR_CODES.LEGACY_PARAKEET_MODEL_DEPRECATED]: {
258
+ name: 'LEGACY_PARAKEET_MODEL_DEPRECATED',
259
+ message: (legacyFields) => `Legacy parakeet ONNX modelConfig fields are no longer supported (${legacyFields ?? 'unknown fields'}). As of @qvac/transcription-parakeet 0.6.0 the addon ships as a single GGUF that auto-detects TDT / CTC / EOU / Sortformer from GGUF metadata. Supply the GGUF via the top-level modelSrc (e.g. loadModel({ modelSrc: PARAKEET_TDT_0_6B_V3_Q8_0, modelType: "parakeet" })).`
260
+ },
261
+ [ERROR_CODES.LEGACY_TTS_MODEL_DEPRECATED]: {
262
+ name: 'LEGACY_TTS_MODEL_DEPRECATED',
263
+ message: (legacyFields) => `Legacy ONNX TTS modelConfig fields are no longer supported (${legacyFields ?? 'unknown fields'}). As of @qvac/tts-ggml the addon uses GGUF bundles: supply the primary GGUF via modelSrc, set language in modelConfig, and for Chatterbox add s3genModelSrc (e.g. loadModel({ modelSrc: TTS_T3_TURBO_EN_CHATTERBOX_Q8_0, modelType: "tts", modelConfig: { ttsEngine: "chatterbox", language: "en", s3genModelSrc: TTS_S3GEN_EN_CHATTERBOX } })). Supertonic multilingual mode is selected by the GGUF (e.g. TTS_MULTILINGUAL_SUPERTONIC2_Q8_0) plus language — not ttsSupertonicMultilingual.`
264
+ },
265
+ // Model operations
266
+ [ERROR_CODES.MODEL_UNLOAD_FAILED]: {
267
+ name: 'MODEL_UNLOAD_FAILED',
268
+ message: (modelId) => `Failed to unload model${modelId ? ` "${modelId}"` : ''}`
269
+ },
270
+ [ERROR_CODES.EMBED_FAILED]: {
271
+ name: 'EMBED_FAILED',
272
+ message: (details) => `Failed to generate embeddings${details ? `: ${details}` : ''}`
273
+ },
274
+ [ERROR_CODES.EMBED_NO_EMBEDDINGS]: {
275
+ name: 'EMBED_NO_EMBEDDINGS',
276
+ message: 'No embeddings returned from model'
277
+ },
278
+ [ERROR_CODES.TRANSCRIPTION_FAILED]: {
279
+ name: 'TRANSCRIPTION_FAILED',
280
+ message: (details) => `Transcription failed${details ? `: ${details}` : ''}`
281
+ },
282
+ [ERROR_CODES.AUDIO_FILE_NOT_FOUND]: {
283
+ name: 'AUDIO_FILE_NOT_FOUND',
284
+ message: (filePath) => `Audio file not found or not accessible: ${filePath}`
285
+ },
286
+ [ERROR_CODES.TRANSLATION_FAILED]: {
287
+ name: 'TRANSLATION_FAILED',
288
+ message: (details) => `Translation failed${details ? `: ${details}` : ''}`
289
+ },
290
+ [ERROR_CODES.COMPLETION_FAILED]: {
291
+ name: 'COMPLETION_FAILED',
292
+ message: (details) => `Completion failed${details ? `: ${details}` : ''}`
293
+ },
294
+ [ERROR_CODES.ATTACHMENT_NOT_FOUND]: {
295
+ name: 'ATTACHMENT_NOT_FOUND',
296
+ message: (path) => `Attachment not found at path: ${path}`
297
+ },
298
+ [ERROR_CODES.CANCEL_FAILED]: {
299
+ name: 'CANCEL_FAILED',
300
+ message: (details) => `Failed to cancel operation${details ? `: ${details}` : ''}`
301
+ },
302
+ [ERROR_CODES.TEXT_TO_SPEECH_FAILED]: {
303
+ name: 'TEXT_TO_SPEECH_FAILED',
304
+ message: (details) => `Text-to-speech operation failed${details ? `: ${details}` : ''}`
305
+ },
306
+ [ERROR_CODES.CONFIG_RELOAD_NOT_SUPPORTED]: {
307
+ name: 'CONFIG_RELOAD_NOT_SUPPORTED',
308
+ message: (modelId) => `Model "${modelId}" does not support hot config reload`
309
+ },
310
+ [ERROR_CODES.MODEL_TYPE_MISMATCH]: {
311
+ name: 'MODEL_TYPE_MISMATCH',
312
+ message: (expectedType, providedType) => `Model type mismatch: expected "${expectedType}", got "${providedType}"`
313
+ },
314
+ [ERROR_CODES.IMAGE_FILE_NOT_FOUND]: {
315
+ name: 'IMAGE_FILE_NOT_FOUND',
316
+ message: (filePath) => `Image file not found or not accessible: ${filePath}`
317
+ },
318
+ [ERROR_CODES.INVALID_IMAGE_INPUT]: {
319
+ name: 'INVALID_IMAGE_INPUT',
320
+ message: 'Invalid image input type provided'
321
+ },
322
+ [ERROR_CODES.TEXT_TO_SPEECH_STREAM_FAILED]: {
323
+ name: 'TEXT_TO_SPEECH_STREAM_FAILED',
324
+ message: (details) => `Text-to-speech stream operation failed${details ? `: ${details}` : ''}`
325
+ },
326
+ [ERROR_CODES.MODEL_OPERATION_NOT_SUPPORTED]: {
327
+ name: 'MODEL_OPERATION_NOT_SUPPORTED',
328
+ message: (modelId, modelType, operation, supportedOperations, suggestedModelTypes) => {
329
+ const supportedClause = supportedOperations
330
+ ? ` Supported operations on this model: ${supportedOperations}.`
331
+ : ' This model does not expose any operations.';
332
+ const suggestionClause = suggestedModelTypes
333
+ ? ` To use ${operation}, load a model of type: ${suggestedModelTypes}.`
334
+ : ` No registered model exposes ${operation}.`;
335
+ return `Model "${modelId}" (type: ${modelType}) does not support ${operation}.${supportedClause}${suggestionClause}`;
336
+ }
337
+ },
338
+ [ERROR_CODES.REQUEST_ID_CONFLICT]: {
339
+ name: 'REQUEST_ID_CONFLICT',
340
+ message: (requestId) => `Request id "${requestId}" is already in flight; refusing to overwrite the existing context`
341
+ },
342
+ [ERROR_CODES.REQUEST_NOT_FOUND]: {
343
+ name: 'REQUEST_NOT_FOUND',
344
+ message: (requestId) => `No in-flight request with id "${requestId}"`
345
+ },
346
+ [ERROR_CODES.INFERENCE_CANCELLED]: {
347
+ name: 'INFERENCE_CANCELLED',
348
+ message: (requestId) => `Inference request "${requestId}" was cancelled before it could complete`
349
+ },
350
+ [ERROR_CODES.REQUEST_REJECTED_BY_POLICY]: {
351
+ name: 'REQUEST_REJECTED_BY_POLICY',
352
+ message: (requestId, kind, modelId, reason) => `Request "${requestId}" (kind: ${kind}, modelId: ${modelId}) was rejected by registry concurrency policy: ${reason}`
353
+ },
354
+ [ERROR_CODES.CONTEXT_OVERFLOW]: {
355
+ name: 'CONTEXT_OVERFLOW',
356
+ message: (promptTokens, ctxSize, modelId) => {
357
+ const prompt = promptTokens ? `${promptTokens} prompt tokens` : 'prompt';
358
+ const ctx = ctxSize
359
+ ? ` exceeds the ${ctxSize}-token context window`
360
+ : " exceeds the model's context window";
361
+ const model = modelId ? ` for model "${modelId}"` : '';
362
+ return `${prompt}${ctx}${model}. Reduce the prompt size or start a new conversation.`;
363
+ }
364
+ },
365
+ // RAG operations
366
+ [ERROR_CODES.RAG_SAVE_FAILED]: {
367
+ name: 'RAG_SAVE_FAILED',
368
+ message: (details) => `Failed to save embeddings${details ? `: ${details}` : ''}`
369
+ },
370
+ [ERROR_CODES.RAG_SEARCH_FAILED]: {
371
+ name: 'RAG_SEARCH_FAILED',
372
+ message: (details) => `Failed to search embeddings${details ? `: ${details}` : ''}`
373
+ },
374
+ [ERROR_CODES.RAG_DELETE_FAILED]: {
375
+ name: 'RAG_DELETE_FAILED',
376
+ message: (details) => `Failed to delete embeddings${details ? `: ${details}` : ''}`
377
+ },
378
+ [ERROR_CODES.RAG_UNKNOWN_OPERATION]: {
379
+ name: 'RAG_UNKNOWN_OPERATION',
380
+ message: (operation) => `Unknown RAG operation: ${operation}`
381
+ },
382
+ [ERROR_CODES.RAG_HYPERDB_FAILED]: {
383
+ name: 'RAG_HYPERDB_FAILED',
384
+ message: (details) => `HyperDB RAG operation failed: ${details}`
385
+ },
386
+ [ERROR_CODES.RAG_WORKSPACE_MODEL_MISMATCH]: {
387
+ name: 'RAG_WORKSPACE_MODEL_MISMATCH',
388
+ message: (workspace, existingModelId, newModelId) => `Workspace "${workspace}" is configured for model "${existingModelId}", but you're trying to use model "${newModelId}". Use a different workspace or the same model`
389
+ },
390
+ [ERROR_CODES.RAG_WORKSPACE_NOT_FOUND]: {
391
+ name: 'RAG_WORKSPACE_NOT_FOUND',
392
+ message: (workspace) => `RAG workspace not found: ${workspace}`
393
+ },
394
+ [ERROR_CODES.RAG_WORKSPACE_IN_USE]: {
395
+ name: 'RAG_WORKSPACE_IN_USE',
396
+ message: (workspace) => `RAG workspace '${workspace}' is currently in use. Close it first.`
397
+ },
398
+ [ERROR_CODES.RAG_WORKSPACE_CLOSE_FAILED]: {
399
+ name: 'RAG_WORKSPACE_CLOSE_FAILED',
400
+ message: (details) => `Failed to close RAG workspace${details ? `: ${details}` : ''}`
401
+ },
402
+ [ERROR_CODES.RAG_LIST_WORKSPACES_FAILED]: {
403
+ name: 'RAG_LIST_WORKSPACES_FAILED',
404
+ message: (details) => `Failed to list RAG workspaces${details ? `: ${details}` : ''}`
405
+ },
406
+ [ERROR_CODES.RAG_CHUNK_FAILED]: {
407
+ name: 'RAG_CHUNK_FAILED',
408
+ message: (details) => `Failed to chunk documents${details ? `: ${details}` : ''}`
409
+ },
410
+ [ERROR_CODES.RAG_WORKSPACE_NOT_OPEN]: {
411
+ name: 'RAG_WORKSPACE_NOT_OPEN',
412
+ message: (workspace) => `RAG workspace '${workspace}' is not open`
413
+ },
414
+ // Download / resource
415
+ [ERROR_CODES.FILE_NOT_FOUND]: {
416
+ name: 'FILE_NOT_FOUND',
417
+ message: (path) => `File not found: ${path}`
418
+ },
419
+ [ERROR_CODES.DOWNLOAD_CANCELLED]: {
420
+ name: 'DOWNLOAD_CANCELLED',
421
+ message: 'Download was cancelled'
422
+ },
423
+ [ERROR_CODES.CHECKSUM_VALIDATION_FAILED]: {
424
+ name: 'CHECKSUM_VALIDATION_FAILED',
425
+ message: (fileName) => `Checksum validation failed for ${fileName}`
426
+ },
427
+ [ERROR_CODES.HTTP_ERROR]: {
428
+ name: 'HTTP_ERROR',
429
+ message: (status, statusText) => `HTTP error: ${status} ${statusText}`
430
+ },
431
+ [ERROR_CODES.NO_RESPONSE_BODY]: {
432
+ name: 'NO_RESPONSE_BODY',
433
+ message: 'No response body received from HTTP request'
434
+ },
435
+ [ERROR_CODES.RESPONSE_BODY_NOT_READABLE]: {
436
+ name: 'RESPONSE_BODY_NOT_READABLE',
437
+ message: 'Response body is not readable'
438
+ },
439
+ [ERROR_CODES.NO_BLOB_FOUND]: {
440
+ name: 'NO_BLOB_FOUND',
441
+ message: (fileName) => `No blob found for ${fileName}`
442
+ },
443
+ [ERROR_CODES.DOWNLOAD_ASSET_FAILED]: {
444
+ name: 'DOWNLOAD_ASSET_FAILED',
445
+ message: (details) => `Failed to download asset${details ? `: ${details}` : ''}`
446
+ },
447
+ [ERROR_CODES.SEEDING_NOT_SUPPORTED]: {
448
+ name: 'SEEDING_NOT_SUPPORTED',
449
+ message: 'Seeding is only supported for hyperdrive models'
450
+ },
451
+ [ERROR_CODES.HYPERDRIVE_DOWNLOAD_FAILED]: {
452
+ name: 'HYPERDRIVE_DOWNLOAD_FAILED',
453
+ message: (details) => `Hyperdrive download failed: ${details}`
454
+ },
455
+ [ERROR_CODES.REGISTRY_DOWNLOAD_FAILED]: {
456
+ name: 'REGISTRY_DOWNLOAD_FAILED',
457
+ message: (details) => `Registry download failed: ${details}`
458
+ },
459
+ [ERROR_CODES.INVALID_SHARD_URL_PATTERN]: {
460
+ name: 'INVALID_SHARD_URL_PATTERN',
461
+ message: (url) => `URL does not contain a valid sharded model pattern: ${url}`
462
+ },
463
+ [ERROR_CODES.ARCHIVE_EXTRACTION_FAILED]: {
464
+ name: 'ARCHIVE_EXTRACTION_FAILED',
465
+ message: (archivePath) => `Failed to extract archive: ${archivePath}`
466
+ },
467
+ [ERROR_CODES.ARCHIVE_UNSUPPORTED_TYPE]: {
468
+ name: 'ARCHIVE_UNSUPPORTED_TYPE',
469
+ message: (archivePath) => `Unsupported archive type: ${archivePath}`
470
+ },
471
+ [ERROR_CODES.ARCHIVE_MISSING_SHARDS]: {
472
+ name: 'ARCHIVE_MISSING_SHARDS',
473
+ message: (missingFile) => `Archive is missing required shard file: ${missingFile}`
474
+ },
475
+ [ERROR_CODES.PARTIAL_DOWNLOAD_OFFLINE]: {
476
+ name: 'PARTIAL_DOWNLOAD_OFFLINE',
477
+ message: (url, downloadedBytes) => `Cannot resume partial download (${downloadedBytes} bytes downloaded) - unable to connect. URL: ${url}`
478
+ },
479
+ // Cache operations
480
+ [ERROR_CODES.DELETE_CACHE_FAILED]: {
481
+ name: 'DELETE_CACHE_FAILED',
482
+ message: (details) => `Failed to delete cache${details ? `: ${details}` : ''}`
483
+ },
484
+ [ERROR_CODES.INVALID_DELETE_CACHE_PARAMS]: {
485
+ name: 'INVALID_DELETE_CACHE_PARAMS',
486
+ message: 'Invalid deleteCache parameters - provide either modelId or cacheKey'
487
+ },
488
+ [ERROR_CODES.CACHE_DIR_NOT_ABSOLUTE]: {
489
+ name: 'CACHE_DIR_NOT_ABSOLUTE',
490
+ message: 'Cache directory must be an absolute path'
491
+ },
492
+ [ERROR_CODES.CACHE_DIR_NOT_WRITABLE]: {
493
+ name: 'CACHE_DIR_NOT_WRITABLE',
494
+ message: (cacheDir, details) => `Cache directory is not writable: ${cacheDir}${details ? `. ${details}` : ''}`
495
+ },
496
+ // Config operations
497
+ [ERROR_CODES.CONFIG_ALREADY_SET]: {
498
+ name: 'CONFIG_ALREADY_SET',
499
+ message: 'Config has already been set and is immutable. Config can only be set once during initialization.'
500
+ },
501
+ // Lifecycle
502
+ [ERROR_CODES.LIFECYCLE_SUSPEND_FAILED]: {
503
+ name: 'LIFECYCLE_SUSPEND_FAILED',
504
+ message: (details) => `Runtime suspend failed${details ? `: ${details}` : ''}`
505
+ },
506
+ [ERROR_CODES.LIFECYCLE_RESUME_FAILED]: {
507
+ name: 'LIFECYCLE_RESUME_FAILED',
508
+ message: (details) => `Runtime resume failed${details ? `: ${details}` : ''}`
509
+ },
510
+ [ERROR_CODES.LIFECYCLE_OPERATION_BLOCKED]: {
511
+ name: 'LIFECYCLE_OPERATION_BLOCKED',
512
+ message: (requestType, lifecycleState) => `Operation "${requestType}" is blocked while runtime state is "${lifecycleState}"`
513
+ },
514
+ // System / runtime
515
+ [ERROR_CODES.FFMPEG_NOT_AVAILABLE]: {
516
+ name: 'FFMPEG_NOT_AVAILABLE',
517
+ message: 'FFmpeg is not available on this system'
518
+ },
519
+ [ERROR_CODES.AUDIO_PLAYER_FAILED]: {
520
+ name: 'AUDIO_PLAYER_FAILED',
521
+ message: (details) => `Audio player failed: ${details}`
522
+ },
523
+ [ERROR_CODES.INVALID_AUDIO_CHUNK_TYPE]: {
524
+ name: 'INVALID_AUDIO_CHUNK_TYPE',
525
+ message: 'Invalid audio chunk type'
526
+ },
527
+ [ERROR_CODES.ASYNC_DISPOSE_UNAVAILABLE]: {
528
+ name: 'ASYNC_DISPOSE_UNAVAILABLE',
529
+ message: 'Host runtime does not expose Symbol.asyncDispose; request-lifecycle primitives require ES2024 `using`/`asyncDispose` support. Verify your runtime (Bare ≥ 1.24) and any polyfill registration.'
530
+ },
531
+ // Delegation, provider side
532
+ [ERROR_CODES.DELEGATE_NO_FINAL_RESPONSE]: {
533
+ name: 'DELEGATE_NO_FINAL_RESPONSE',
534
+ message: 'No final response received from delegated provider'
535
+ },
536
+ [ERROR_CODES.DELEGATE_CONNECTION_FAILED]: {
537
+ name: 'DELEGATE_CONNECTION_FAILED',
538
+ message: (details) => `Failed to connect to delegated provider: ${details}`
539
+ },
540
+ [ERROR_CODES.DELEGATE_PROVIDER_ERROR]: {
541
+ name: 'DELEGATE_PROVIDER_ERROR',
542
+ message: (details, providerCode) => `Delegated provider error: ${details}` + (providerCode ? ` (code: ${providerCode})` : '')
543
+ },
544
+ [ERROR_CODES.RPC_NO_DATA_RECEIVED]: {
545
+ name: 'RPC_NO_DATA_RECEIVED',
546
+ message: 'No data received from request'
547
+ },
548
+ [ERROR_CODES.RPC_UNKNOWN_REQUEST_TYPE]: {
549
+ name: 'RPC_UNKNOWN_REQUEST_TYPE',
550
+ message: (requestType) => `Unknown request type received: ${requestType}`
551
+ },
552
+ // Plugin errors
553
+ [ERROR_CODES.PLUGIN_NOT_FOUND]: {
554
+ name: 'PLUGIN_NOT_FOUND',
555
+ message: (modelType) => modelType === 'onnx-ocr'
556
+ ? 'Plugin not found for model type "onnx-ocr": the ONNX OCR engine has been removed. Use modelType "ggml-ocr" with GGUF registry models instead (EasyOCR: OCR_LATIN; DocTR: OCR_DOCTR).'
557
+ : `Plugin not found for model type "${modelType}". Register the plugin in code with \`registerPlugin\` / \`plugins([...])\` before this call.`
558
+ },
559
+ [ERROR_CODES.PLUGIN_HANDLER_NOT_FOUND]: {
560
+ name: 'PLUGIN_HANDLER_NOT_FOUND',
561
+ message: (modelType, handler, availableHandlers) => `Handler "${handler}" not found in plugin "${modelType}"` +
562
+ (availableHandlers ? `. Available handlers: ${availableHandlers}` : '')
563
+ },
564
+ [ERROR_CODES.PLUGIN_REQUEST_VALIDATION_FAILED]: {
565
+ name: 'PLUGIN_REQUEST_VALIDATION_FAILED',
566
+ message: (handler, details) => `Request validation failed for handler "${handler}"${details ? `: ${details}` : ''}`
567
+ },
568
+ [ERROR_CODES.PLUGIN_RESPONSE_VALIDATION_FAILED]: {
569
+ name: 'PLUGIN_RESPONSE_VALIDATION_FAILED',
570
+ message: (handler, details) => `Response validation failed for handler "${handler}"${details ? `: ${details}` : ''}`
571
+ },
572
+ [ERROR_CODES.PLUGIN_ALREADY_REGISTERED]: {
573
+ name: 'PLUGIN_ALREADY_REGISTERED',
574
+ message: (modelType) => `Plugin already registered for modelType: ${modelType}`
575
+ },
576
+ [ERROR_CODES.PLUGIN_HANDLER_TYPE_MISMATCH]: {
577
+ name: 'PLUGIN_HANDLER_TYPE_MISMATCH',
578
+ message: (handlerName, expected, actual) => `Handler "${handlerName}" is ${actual}, but was called as ${expected}. Use invokePlugin() for reply handlers and invokePluginStream() for streaming handlers.`
579
+ },
580
+ [ERROR_CODES.PLUGIN_LOGGING_INVALID]: {
581
+ name: 'PLUGIN_LOGGING_INVALID',
582
+ message: (modelType, reason) => `Plugin "${modelType}" has invalid logging configuration: ${reason}`
583
+ },
584
+ [ERROR_CODES.PLUGIN_DEFINITION_INVALID]: {
585
+ name: 'PLUGIN_DEFINITION_INVALID',
586
+ message: (modelType, details) => `Plugin definition invalid for "${modelType}": ${details}`
587
+ },
588
+ [ERROR_CODES.PLUGIN_MODEL_TYPE_RESERVED]: {
589
+ name: 'PLUGIN_MODEL_TYPE_RESERVED',
590
+ message: (modelType) => `modelType "${modelType}" is reserved for built-in plugins`
591
+ },
592
+ [ERROR_CODES.PLUGIN_LOAD_CONFIG_VALIDATION_FAILED]: {
593
+ name: 'PLUGIN_LOAD_CONFIG_VALIDATION_FAILED',
594
+ message: (modelType, details) => `modelConfig validation failed for "${modelType}": ${details}`
595
+ },
596
+ // Security
597
+ [ERROR_CODES.PATH_TRAVERSAL]: {
598
+ name: 'PATH_TRAVERSAL',
599
+ message: (component, basePath) => `Path traversal detected: "${component}" escapes base directory "${basePath}"`
600
+ },
601
+ // Model registry query
602
+ [ERROR_CODES.QVAC_MODEL_REGISTRY_QUERY_FAILED]: {
603
+ name: 'QVAC_MODEL_REGISTRY_QUERY_FAILED',
604
+ message: (details) => `QVAC model registry query failed${details ? `: ${details}` : ''}`
605
+ }
606
+ };
607
+ addCodes(errorDefinitions, { name: 'qvac-inference', version: '1.0.0' });
608
+ export { errorDefinitions as ERROR_DEFINITIONS };
609
+ // Registry client error codes (19,001-20,000 range). These match the codes
610
+ // from @qvac/registry-client; the actual definitions live in that package.
611
+ export const REGISTRY_ERROR_CODES = {
612
+ FAILED_TO_CONNECT: 19001,
613
+ FAILED_TO_CLOSE: 19002,
614
+ MODEL_NOT_FOUND: 19003
615
+ };