@elizaos/plugin-local-inference 2.0.0-beta.1 → 2.0.3-beta.2

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 (701) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +83 -0
  3. package/package.json +82 -15
  4. package/src/actions/generate-media.d.ts +59 -0
  5. package/src/actions/generate-media.d.ts.map +1 -0
  6. package/src/actions/generate-media.ts +647 -0
  7. package/src/actions/identify-speaker.d.ts +23 -0
  8. package/src/actions/identify-speaker.d.ts.map +1 -0
  9. package/src/actions/identify-speaker.ts +171 -0
  10. package/src/actions/transcription-control.d.ts +29 -0
  11. package/src/actions/transcription-control.d.ts.map +1 -0
  12. package/src/actions/transcription-control.test.ts +100 -0
  13. package/src/actions/transcription-control.ts +127 -0
  14. package/src/adapters/capacitor-llama/__tests__/compat-behavior.test.ts +218 -0
  15. package/src/adapters/capacitor-llama/__tests__/index.test.ts +68 -0
  16. package/src/adapters/capacitor-llama/__tests__/structured-output.test.ts +215 -0
  17. package/src/adapters/capacitor-llama/__tests__/text-streaming.test.ts +174 -0
  18. package/src/adapters/capacitor-llama/environment.ts +71 -0
  19. package/src/adapters/capacitor-llama/index.browser.ts +83 -0
  20. package/src/adapters/capacitor-llama/index.ts +807 -0
  21. package/src/adapters/capacitor-llama/loader.ts +109 -0
  22. package/src/adapters/capacitor-llama/structured-output.ts +165 -0
  23. package/src/adapters/capacitor-llama/text-streaming.ts +227 -0
  24. package/src/adapters/capacitor-llama/types.ts +374 -0
  25. package/src/backends/apple-foundation.ts +127 -0
  26. package/src/index.d.ts +8 -0
  27. package/src/index.d.ts.map +1 -0
  28. package/src/index.ts +62 -0
  29. package/src/local-inference-routes.d.ts +38 -0
  30. package/src/local-inference-routes.d.ts.map +1 -0
  31. package/src/local-inference-routes.test.ts +344 -0
  32. package/src/local-inference-routes.ts +1543 -0
  33. package/src/provider.d.ts +21 -0
  34. package/src/provider.d.ts.map +1 -0
  35. package/src/provider.ts +1082 -0
  36. package/src/routes/compat-helpers.d.ts +18 -0
  37. package/src/routes/compat-helpers.d.ts.map +1 -0
  38. package/src/routes/compat-helpers.ts +274 -0
  39. package/src/routes/family-member-route.d.ts +62 -0
  40. package/src/routes/family-member-route.d.ts.map +1 -0
  41. package/src/routes/family-member-route.ts +353 -0
  42. package/src/routes/index.d.ts +19 -0
  43. package/src/routes/index.d.ts.map +1 -0
  44. package/src/routes/index.ts +60 -0
  45. package/src/routes/live-diarization-route.d.ts +26 -0
  46. package/src/routes/live-diarization-route.d.ts.map +1 -0
  47. package/src/routes/live-diarization-route.test.ts +213 -0
  48. package/src/routes/live-diarization-route.ts +122 -0
  49. package/src/routes/local-inference-asr-route.d.ts +4 -0
  50. package/src/routes/local-inference-asr-route.d.ts.map +1 -0
  51. package/src/routes/local-inference-asr-route.test.ts +205 -0
  52. package/src/routes/local-inference-asr-route.ts +163 -0
  53. package/src/routes/local-inference-asr-transcribe.d.ts +20 -0
  54. package/src/routes/local-inference-asr-transcribe.d.ts.map +1 -0
  55. package/src/routes/local-inference-asr-transcribe.test.ts +118 -0
  56. package/src/routes/local-inference-asr-transcribe.ts +97 -0
  57. package/src/routes/local-inference-compat-routes.d.ts +16 -0
  58. package/src/routes/local-inference-compat-routes.d.ts.map +1 -0
  59. package/src/routes/local-inference-compat-routes.test.ts +485 -0
  60. package/src/routes/local-inference-compat-routes.ts +808 -0
  61. package/src/routes/local-inference-tts-route.d.ts +7 -0
  62. package/src/routes/local-inference-tts-route.d.ts.map +1 -0
  63. package/src/routes/local-inference-tts-route.test.ts +179 -0
  64. package/src/routes/local-inference-tts-route.ts +230 -0
  65. package/src/routes/transcript-audio-store.d.ts +15 -0
  66. package/src/routes/transcript-audio-store.d.ts.map +1 -0
  67. package/src/routes/transcript-audio-store.ts +27 -0
  68. package/src/routes/transcripts-routes.d.ts +36 -0
  69. package/src/routes/transcripts-routes.d.ts.map +1 -0
  70. package/src/routes/transcripts-routes.test.ts +144 -0
  71. package/src/routes/transcripts-routes.ts +159 -0
  72. package/src/routes/voice-first-run-routes.d.ts +62 -0
  73. package/src/routes/voice-first-run-routes.d.ts.map +1 -0
  74. package/src/routes/voice-first-run-routes.ts +524 -0
  75. package/src/routes/voice-models-routes.d.ts +62 -0
  76. package/src/routes/voice-models-routes.d.ts.map +1 -0
  77. package/src/routes/voice-models-routes.ts +554 -0
  78. package/src/routes/voice-profile-plugin-routes.d.ts +19 -0
  79. package/src/routes/voice-profile-plugin-routes.d.ts.map +1 -0
  80. package/src/routes/voice-profile-plugin-routes.ts +138 -0
  81. package/src/routes/voice-profiles-management-routes.d.ts +52 -0
  82. package/src/routes/voice-profiles-management-routes.d.ts.map +1 -0
  83. package/src/routes/voice-profiles-management-routes.ts +476 -0
  84. package/src/routes/voice-speaker-profile-routes.d.ts +57 -0
  85. package/src/routes/voice-speaker-profile-routes.d.ts.map +1 -0
  86. package/src/routes/voice-speaker-profile-routes.ts +199 -0
  87. package/src/runtime/aosp-llama-loader-selection.test.ts +80 -0
  88. package/src/runtime/capacitor-llama.d.ts +25 -0
  89. package/src/runtime/embedding-manager-support.d.ts +77 -0
  90. package/src/runtime/embedding-manager-support.d.ts.map +1 -0
  91. package/src/runtime/embedding-manager-support.ts +497 -0
  92. package/src/runtime/embedding-presets.d.ts +16 -0
  93. package/src/runtime/embedding-presets.d.ts.map +1 -0
  94. package/src/runtime/embedding-presets.ts +81 -0
  95. package/src/runtime/embedding-warmup-policy.d.ts +14 -0
  96. package/src/runtime/embedding-warmup-policy.d.ts.map +1 -0
  97. package/src/runtime/embedding-warmup-policy.test.ts +53 -0
  98. package/src/runtime/embedding-warmup-policy.ts +48 -0
  99. package/src/runtime/ensure-local-inference-handler.d.ts +62 -0
  100. package/src/runtime/ensure-local-inference-handler.d.ts.map +1 -0
  101. package/src/runtime/ensure-local-inference-handler.test.ts +528 -0
  102. package/src/runtime/ensure-local-inference-handler.ts +1448 -0
  103. package/src/runtime/index.d.ts +15 -0
  104. package/src/runtime/index.d.ts.map +1 -0
  105. package/src/runtime/index.ts +33 -0
  106. package/src/runtime/mobile-local-inference-gate.d.ts +31 -0
  107. package/src/runtime/mobile-local-inference-gate.d.ts.map +1 -0
  108. package/src/runtime/mobile-local-inference-gate.test.ts +69 -0
  109. package/src/runtime/mobile-local-inference-gate.ts +44 -0
  110. package/src/runtime/voice-entity-binding.d.ts +103 -0
  111. package/src/runtime/voice-entity-binding.d.ts.map +1 -0
  112. package/src/runtime/voice-entity-binding.transcript.test.ts +69 -0
  113. package/src/runtime/voice-entity-binding.ts +328 -0
  114. package/src/services/README.md +71 -0
  115. package/src/services/__tests__/backend-selector.test.ts +101 -0
  116. package/src/services/__tests__/checkpoint-manager.test.ts +376 -0
  117. package/src/services/__tests__/gpu-autotune.test.ts +400 -0
  118. package/src/services/__tests__/llm-streaming-binding.test.ts +85 -0
  119. package/src/services/__tests__/planner-grammar.test.ts +372 -0
  120. package/src/services/__tests__/runtime-target.test.ts +176 -0
  121. package/src/services/active-model-switch-rollback.test.ts +183 -0
  122. package/src/services/active-model.d.ts +282 -0
  123. package/src/services/active-model.d.ts.map +1 -0
  124. package/src/services/active-model.ts +1213 -0
  125. package/src/services/assignments.d.ts +71 -0
  126. package/src/services/assignments.d.ts.map +1 -0
  127. package/src/services/assignments.test.ts +80 -0
  128. package/src/services/assignments.ts +230 -0
  129. package/src/services/backend-selector.ts +95 -0
  130. package/src/services/backend.d.ts +346 -0
  131. package/src/services/backend.d.ts.map +1 -0
  132. package/src/services/backend.ts +612 -0
  133. package/src/services/bionic-host-loader.d.ts +46 -0
  134. package/src/services/bionic-host-loader.d.ts.map +1 -0
  135. package/src/services/bionic-host-loader.test.ts +133 -0
  136. package/src/services/bionic-host-loader.ts +180 -0
  137. package/src/services/bundled-models.d.ts +34 -0
  138. package/src/services/bundled-models.d.ts.map +1 -0
  139. package/src/services/bundled-models.ts +129 -0
  140. package/src/services/cache-bridge.d.ts +206 -0
  141. package/src/services/cache-bridge.d.ts.map +1 -0
  142. package/src/services/cache-bridge.test.ts +516 -0
  143. package/src/services/cache-bridge.ts +423 -0
  144. package/src/services/catalog.d.ts +10 -0
  145. package/src/services/catalog.d.ts.map +1 -0
  146. package/src/services/catalog.test.ts +238 -0
  147. package/src/services/catalog.ts +27 -0
  148. package/src/services/checkpoint-client.d.ts +109 -0
  149. package/src/services/checkpoint-client.d.ts.map +1 -0
  150. package/src/services/checkpoint-client.ts +258 -0
  151. package/src/services/checkpoint-manager.ts +474 -0
  152. package/src/services/cloud-fallback.d.ts +102 -0
  153. package/src/services/cloud-fallback.d.ts.map +1 -0
  154. package/src/services/cloud-fallback.ts +230 -0
  155. package/src/services/conversation-registry.d.ts +142 -0
  156. package/src/services/conversation-registry.d.ts.map +1 -0
  157. package/src/services/conversation-registry.test.ts +235 -0
  158. package/src/services/conversation-registry.ts +264 -0
  159. package/src/services/desktop-fused-ffi-backend-runtime.d.ts +95 -0
  160. package/src/services/desktop-fused-ffi-backend-runtime.d.ts.map +1 -0
  161. package/src/services/desktop-fused-ffi-backend-runtime.ts +339 -0
  162. package/src/services/device-bridge.d.ts +188 -0
  163. package/src/services/device-bridge.d.ts.map +1 -0
  164. package/src/services/device-bridge.ts +1237 -0
  165. package/src/services/device-resource-metrics.d.ts +149 -0
  166. package/src/services/device-resource-metrics.d.ts.map +1 -0
  167. package/src/services/device-resource-metrics.test.ts +98 -0
  168. package/src/services/device-resource-metrics.ts +346 -0
  169. package/src/services/device-tier.d.ts +115 -0
  170. package/src/services/device-tier.d.ts.map +1 -0
  171. package/src/services/device-tier.test.ts +371 -0
  172. package/src/services/device-tier.ts +410 -0
  173. package/src/services/downloader.d.ts +82 -0
  174. package/src/services/downloader.d.ts.map +1 -0
  175. package/src/services/downloader.test.ts +747 -0
  176. package/src/services/downloader.ts +925 -0
  177. package/src/services/engine-direct-bundle.test.ts +58 -0
  178. package/src/services/engine-streaming.test.ts +80 -0
  179. package/src/services/engine.d.ts +540 -0
  180. package/src/services/engine.d.ts.map +1 -0
  181. package/src/services/engine.ts +1909 -0
  182. package/src/services/ensure-local-artifacts.integration.test.ts +273 -0
  183. package/src/services/ensure-local-artifacts.test.ts +368 -0
  184. package/src/services/ensure-local-artifacts.ts +351 -0
  185. package/src/services/external-scanner.d.ts +17 -0
  186. package/src/services/external-scanner.d.ts.map +1 -0
  187. package/src/services/external-scanner.ts +312 -0
  188. package/src/services/ffi-llm-mock.ts +354 -0
  189. package/src/services/ffi-llm-streaming-abi.ts +442 -0
  190. package/src/services/ffi-streaming-backend.d.ts +180 -0
  191. package/src/services/ffi-streaming-backend.d.ts.map +1 -0
  192. package/src/services/ffi-streaming-backend.ts +382 -0
  193. package/src/services/ffi-streaming-runner.d.ts +122 -0
  194. package/src/services/ffi-streaming-runner.d.ts.map +1 -0
  195. package/src/services/ffi-streaming-runner.test.ts +60 -0
  196. package/src/services/ffi-streaming-runner.ts +354 -0
  197. package/src/services/ffi-unload-ordering.test.ts +162 -0
  198. package/src/services/gpu-autotune.ts +534 -0
  199. package/src/services/gpu-detect.d.ts +56 -0
  200. package/src/services/gpu-detect.d.ts.map +1 -0
  201. package/src/services/gpu-detect.ts +139 -0
  202. package/src/services/handler-registry.d.ts +72 -0
  203. package/src/services/handler-registry.d.ts.map +1 -0
  204. package/src/services/handler-registry.ts +240 -0
  205. package/src/services/hardware.d.ts +63 -0
  206. package/src/services/hardware.d.ts.map +1 -0
  207. package/src/services/hardware.test.ts +231 -0
  208. package/src/services/hardware.ts +410 -0
  209. package/src/services/hf-search.d.ts +26 -0
  210. package/src/services/hf-search.d.ts.map +1 -0
  211. package/src/services/hf-search.test.ts +69 -0
  212. package/src/services/hf-search.ts +420 -0
  213. package/src/services/image-description-runtime.d.ts +14 -0
  214. package/src/services/image-description-runtime.d.ts.map +1 -0
  215. package/src/services/image-description-runtime.test.ts +61 -0
  216. package/src/services/image-description-runtime.ts +118 -0
  217. package/src/services/imagegen/aosp-unavailable.d.ts +134 -0
  218. package/src/services/imagegen/aosp-unavailable.d.ts.map +1 -0
  219. package/src/services/imagegen/aosp-unavailable.ts +229 -0
  220. package/src/services/imagegen/backend-selector.d.ts +118 -0
  221. package/src/services/imagegen/backend-selector.d.ts.map +1 -0
  222. package/src/services/imagegen/backend-selector.ts +277 -0
  223. package/src/services/imagegen/coreml-unavailable.d.ts +105 -0
  224. package/src/services/imagegen/coreml-unavailable.d.ts.map +1 -0
  225. package/src/services/imagegen/coreml-unavailable.ts +237 -0
  226. package/src/services/imagegen/errors.d.ts +16 -0
  227. package/src/services/imagegen/errors.d.ts.map +1 -0
  228. package/src/services/imagegen/errors.ts +40 -0
  229. package/src/services/imagegen/index.d.ts +58 -0
  230. package/src/services/imagegen/index.d.ts.map +1 -0
  231. package/src/services/imagegen/index.ts +144 -0
  232. package/src/services/imagegen/mflux.d.ts +74 -0
  233. package/src/services/imagegen/mflux.d.ts.map +1 -0
  234. package/src/services/imagegen/mflux.ts +313 -0
  235. package/src/services/imagegen/sd-cpp.d.ts +180 -0
  236. package/src/services/imagegen/sd-cpp.d.ts.map +1 -0
  237. package/src/services/imagegen/sd-cpp.ts +718 -0
  238. package/src/services/imagegen/tensorrt-unavailable.d.ts +83 -0
  239. package/src/services/imagegen/tensorrt-unavailable.d.ts.map +1 -0
  240. package/src/services/imagegen/tensorrt-unavailable.ts +295 -0
  241. package/src/services/imagegen/types.d.ts +181 -0
  242. package/src/services/imagegen/types.d.ts.map +1 -0
  243. package/src/services/imagegen/types.ts +193 -0
  244. package/src/services/index.d.ts +29 -0
  245. package/src/services/index.d.ts.map +1 -0
  246. package/src/services/index.ts +211 -0
  247. package/src/services/inference-capabilities.d.ts +132 -0
  248. package/src/services/inference-capabilities.d.ts.map +1 -0
  249. package/src/services/inference-capabilities.test.ts +75 -0
  250. package/src/services/inference-capabilities.ts +204 -0
  251. package/src/services/inference-telemetry.d.ts +59 -0
  252. package/src/services/inference-telemetry.d.ts.map +1 -0
  253. package/src/services/inference-telemetry.ts +143 -0
  254. package/src/services/ios-llama-streaming.ts +248 -0
  255. package/src/services/kv-spill.d.ts +189 -0
  256. package/src/services/kv-spill.d.ts.map +1 -0
  257. package/src/services/kv-spill.test.ts +222 -0
  258. package/src/services/kv-spill.ts +356 -0
  259. package/src/services/latency-trace.d.ts +346 -0
  260. package/src/services/latency-trace.d.ts.map +1 -0
  261. package/src/services/latency-trace.test.ts +266 -0
  262. package/src/services/latency-trace.ts +844 -0
  263. package/src/services/llama-server-metrics.ts +304 -0
  264. package/src/services/llm-streaming-binding.d.ts +96 -0
  265. package/src/services/llm-streaming-binding.d.ts.map +1 -0
  266. package/src/services/llm-streaming-binding.ts +136 -0
  267. package/src/services/load-args.d.ts +82 -0
  268. package/src/services/load-args.d.ts.map +1 -0
  269. package/src/services/load-args.ts +81 -0
  270. package/src/services/manifest/eliza-1.manifest.v1.json +708 -0
  271. package/src/services/manifest/index.d.ts +4 -0
  272. package/src/services/manifest/index.d.ts.map +1 -0
  273. package/src/services/manifest/index.ts +66 -0
  274. package/src/services/manifest/manifest.test.ts +689 -0
  275. package/src/services/manifest/schema.d.ts +713 -0
  276. package/src/services/manifest/schema.d.ts.map +1 -0
  277. package/src/services/manifest/schema.ts +653 -0
  278. package/src/services/manifest/types.d.ts +30 -0
  279. package/src/services/manifest/types.d.ts.map +1 -0
  280. package/src/services/manifest/types.ts +55 -0
  281. package/src/services/manifest/validator.d.ts +66 -0
  282. package/src/services/manifest/validator.d.ts.map +1 -0
  283. package/src/services/manifest/validator.ts +567 -0
  284. package/src/services/memory-arbiter.d.ts +318 -0
  285. package/src/services/memory-arbiter.d.ts.map +1 -0
  286. package/src/services/memory-arbiter.test.ts +419 -0
  287. package/src/services/memory-arbiter.ts +925 -0
  288. package/src/services/memory-monitor.d.ts +122 -0
  289. package/src/services/memory-monitor.d.ts.map +1 -0
  290. package/src/services/memory-monitor.test.ts +208 -0
  291. package/src/services/memory-monitor.ts +297 -0
  292. package/src/services/memory-pressure.d.ts +130 -0
  293. package/src/services/memory-pressure.d.ts.map +1 -0
  294. package/src/services/memory-pressure.ts +414 -0
  295. package/src/services/mtp-doctor.d.ts +13 -0
  296. package/src/services/mtp-doctor.d.ts.map +1 -0
  297. package/src/services/mtp-doctor.ts +78 -0
  298. package/src/services/network-policy.d.ts +127 -0
  299. package/src/services/network-policy.d.ts.map +1 -0
  300. package/src/services/network-policy.ts +346 -0
  301. package/src/services/paths.d.ts +6 -0
  302. package/src/services/paths.d.ts.map +1 -0
  303. package/src/services/paths.ts +25 -0
  304. package/src/services/planner-skeleton.d.ts +124 -0
  305. package/src/services/planner-skeleton.d.ts.map +1 -0
  306. package/src/services/planner-skeleton.ts +175 -0
  307. package/src/services/providers.d.ts +38 -0
  308. package/src/services/providers.d.ts.map +1 -0
  309. package/src/services/providers.ts +507 -0
  310. package/src/services/ram-budget-cache.test.ts +163 -0
  311. package/src/services/ram-budget.d.ts +110 -0
  312. package/src/services/ram-budget.d.ts.map +1 -0
  313. package/src/services/ram-budget.ts +0 -0
  314. package/src/services/readiness.d.ts +9 -0
  315. package/src/services/readiness.d.ts.map +1 -0
  316. package/src/services/readiness.test.ts +87 -0
  317. package/src/services/readiness.ts +238 -0
  318. package/src/services/recommendation.d.ts +111 -0
  319. package/src/services/recommendation.d.ts.map +1 -0
  320. package/src/services/recommendation.ts +671 -0
  321. package/src/services/registry.d.ts +35 -0
  322. package/src/services/registry.d.ts.map +1 -0
  323. package/src/services/registry.ts +151 -0
  324. package/src/services/router-handler.d.ts +92 -0
  325. package/src/services/router-handler.d.ts.map +1 -0
  326. package/src/services/router-handler.test.ts +45 -0
  327. package/src/services/router-handler.ts +407 -0
  328. package/src/services/routing-policy.d.ts +69 -0
  329. package/src/services/routing-policy.d.ts.map +1 -0
  330. package/src/services/routing-policy.test.ts +164 -0
  331. package/src/services/routing-policy.ts +297 -0
  332. package/src/services/routing-preferences.d.ts +8 -0
  333. package/src/services/routing-preferences.d.ts.map +1 -0
  334. package/src/services/routing-preferences.ts +17 -0
  335. package/src/services/runtime-target.d.ts +98 -0
  336. package/src/services/runtime-target.d.ts.map +1 -0
  337. package/src/services/runtime-target.ts +154 -0
  338. package/src/services/service.d.ts +128 -0
  339. package/src/services/service.d.ts.map +1 -0
  340. package/src/services/service.test.ts +223 -0
  341. package/src/services/service.ts +735 -0
  342. package/src/services/session-pool.d.ts +72 -0
  343. package/src/services/session-pool.d.ts.map +1 -0
  344. package/src/services/session-pool.ts +153 -0
  345. package/src/services/structured-output/deterministic-repair.d.ts +23 -0
  346. package/src/services/structured-output/deterministic-repair.d.ts.map +1 -0
  347. package/src/services/structured-output/deterministic-repair.test.ts +169 -0
  348. package/src/services/structured-output/deterministic-repair.ts +443 -0
  349. package/src/services/structured-output/index.ts +4 -0
  350. package/src/services/structured-output.d.ts +311 -0
  351. package/src/services/structured-output.d.ts.map +1 -0
  352. package/src/services/structured-output.test.ts +483 -0
  353. package/src/services/structured-output.ts +712 -0
  354. package/src/services/system-memory.d.ts +33 -0
  355. package/src/services/system-memory.d.ts.map +1 -0
  356. package/src/services/system-memory.test.ts +47 -0
  357. package/src/services/system-memory.ts +67 -0
  358. package/src/services/transcription-priority.test.ts +211 -0
  359. package/src/services/types.d.ts +19 -0
  360. package/src/services/types.d.ts.map +1 -0
  361. package/src/services/types.ts +55 -0
  362. package/src/services/verify-on-device.d.ts +34 -0
  363. package/src/services/verify-on-device.d.ts.map +1 -0
  364. package/src/services/verify-on-device.test.ts +87 -0
  365. package/src/services/verify-on-device.ts +127 -0
  366. package/src/services/verify.d.ts +8 -0
  367. package/src/services/verify.d.ts.map +1 -0
  368. package/src/services/verify.ts +13 -0
  369. package/src/services/vision/aosp-unavailable.d.ts +115 -0
  370. package/src/services/vision/aosp-unavailable.d.ts.map +1 -0
  371. package/src/services/vision/aosp-unavailable.ts +163 -0
  372. package/src/services/vision/capacitor-llama.d.ts +99 -0
  373. package/src/services/vision/capacitor-llama.d.ts.map +1 -0
  374. package/src/services/vision/capacitor-llama.ts +255 -0
  375. package/src/services/vision/cloud-fallback.d.ts +47 -0
  376. package/src/services/vision/cloud-fallback.d.ts.map +1 -0
  377. package/src/services/vision/cloud-fallback.test.ts +243 -0
  378. package/src/services/vision/cloud-fallback.ts +268 -0
  379. package/src/services/vision/fallback-chain.test.ts +86 -0
  380. package/src/services/vision/hash.d.ts +71 -0
  381. package/src/services/vision/hash.d.ts.map +1 -0
  382. package/src/services/vision/hash.ts +157 -0
  383. package/src/services/vision/index.d.ts +95 -0
  384. package/src/services/vision/index.d.ts.map +1 -0
  385. package/src/services/vision/index.ts +251 -0
  386. package/src/services/vision/llama-server.d.ts +73 -0
  387. package/src/services/vision/llama-server.d.ts.map +1 -0
  388. package/src/services/vision/llama-server.ts +177 -0
  389. package/src/services/vision/types.d.ts +153 -0
  390. package/src/services/vision/types.d.ts.map +1 -0
  391. package/src/services/vision/types.ts +154 -0
  392. package/src/services/vision/vast-fallback.d.ts +18 -0
  393. package/src/services/vision/vast-fallback.d.ts.map +1 -0
  394. package/src/services/vision/vast-fallback.ts +127 -0
  395. package/src/services/vision-embedding-cache.d.ts +98 -0
  396. package/src/services/vision-embedding-cache.d.ts.map +1 -0
  397. package/src/services/vision-embedding-cache.ts +189 -0
  398. package/src/services/voice/VOICE_WORKBENCH.md +88 -0
  399. package/src/services/voice/__test-helpers__/fake-ffi.ts +94 -0
  400. package/src/services/voice/__test-helpers__/synthetic-speech.ts +124 -0
  401. package/src/services/voice/__tests__/checkpoint-manager.test.ts +241 -0
  402. package/src/services/voice/__tests__/checkpoint-policy.test.ts +270 -0
  403. package/src/services/voice/__tests__/eager-context-builder.test.ts +257 -0
  404. package/src/services/voice/__tests__/eliza1-eot-scorer.test.ts +288 -0
  405. package/src/services/voice/__tests__/eot-classifier.test.ts +431 -0
  406. package/src/services/voice/__tests__/optimistic-rollback.test.ts +312 -0
  407. package/src/services/voice/__tests__/prefill-client.test.ts +266 -0
  408. package/src/services/voice/__tests__/prefix-preserving-queue.test.ts +208 -0
  409. package/src/services/voice/__tests__/streaming-asr.test.ts +450 -0
  410. package/src/services/voice/__tests__/streaming-transcriber.test.ts +339 -0
  411. package/src/services/voice/__tests__/turn-detector-resolver.test.ts +195 -0
  412. package/src/services/voice/__tests__/voice-state-machine-prefill.test.ts +275 -0
  413. package/src/services/voice/__tests__/voice-state-machine.test.ts +354 -0
  414. package/src/services/voice/asr-timed.real.test.ts +141 -0
  415. package/src/services/voice/audio-frame-consumer.d.ts +212 -0
  416. package/src/services/voice/audio-frame-consumer.d.ts.map +1 -0
  417. package/src/services/voice/audio-frame-consumer.test.ts +343 -0
  418. package/src/services/voice/audio-frame-consumer.ts +491 -0
  419. package/src/services/voice/barge-in.d.ts +112 -0
  420. package/src/services/voice/barge-in.d.ts.map +1 -0
  421. package/src/services/voice/barge-in.test.ts +244 -0
  422. package/src/services/voice/barge-in.ts +336 -0
  423. package/src/services/voice/cancellation-coordinator.d.ts +127 -0
  424. package/src/services/voice/cancellation-coordinator.d.ts.map +1 -0
  425. package/src/services/voice/cancellation-coordinator.test.ts +196 -0
  426. package/src/services/voice/cancellation-coordinator.ts +269 -0
  427. package/src/services/voice/checkpoint-manager.d.ts +199 -0
  428. package/src/services/voice/checkpoint-manager.d.ts.map +1 -0
  429. package/src/services/voice/checkpoint-manager.ts +401 -0
  430. package/src/services/voice/checkpoint-policy.ts +336 -0
  431. package/src/services/voice/composite-eot-classifier.test.ts +59 -0
  432. package/src/services/voice/e2e-harness.test.ts +182 -0
  433. package/src/services/voice/e2e-harness.ts +743 -0
  434. package/src/services/voice/eager-context-builder.d.ts +170 -0
  435. package/src/services/voice/eager-context-builder.d.ts.map +1 -0
  436. package/src/services/voice/eager-context-builder.ts +262 -0
  437. package/src/services/voice/eliza1-eot-scorer.d.ts +124 -0
  438. package/src/services/voice/eliza1-eot-scorer.d.ts.map +1 -0
  439. package/src/services/voice/eliza1-eot-scorer.ts +242 -0
  440. package/src/services/voice/embedding-server.ts +200 -0
  441. package/src/services/voice/embedding.d.ts +133 -0
  442. package/src/services/voice/embedding.d.ts.map +1 -0
  443. package/src/services/voice/embedding.test.ts +131 -0
  444. package/src/services/voice/embedding.ts +243 -0
  445. package/src/services/voice/emotion-attribution.d.ts +68 -0
  446. package/src/services/voice/emotion-attribution.d.ts.map +1 -0
  447. package/src/services/voice/emotion-attribution.test.ts +129 -0
  448. package/src/services/voice/emotion-attribution.ts +361 -0
  449. package/src/services/voice/engine-bridge-cancellation.test.ts +422 -0
  450. package/src/services/voice/engine-bridge.d.ts +759 -0
  451. package/src/services/voice/engine-bridge.d.ts.map +1 -0
  452. package/src/services/voice/engine-bridge.test.ts +384 -0
  453. package/src/services/voice/engine-bridge.ts +2302 -0
  454. package/src/services/voice/eot-classifier-ggml.d.ts +179 -0
  455. package/src/services/voice/eot-classifier-ggml.d.ts.map +1 -0
  456. package/src/services/voice/eot-classifier-ggml.ts +566 -0
  457. package/src/services/voice/eot-classifier.d.ts +214 -0
  458. package/src/services/voice/eot-classifier.d.ts.map +1 -0
  459. package/src/services/voice/eot-classifier.ts +533 -0
  460. package/src/services/voice/errors.d.ts +20 -0
  461. package/src/services/voice/errors.d.ts.map +1 -0
  462. package/src/services/voice/errors.ts +32 -0
  463. package/src/services/voice/expressive-tags.d.ts +158 -0
  464. package/src/services/voice/expressive-tags.d.ts.map +1 -0
  465. package/src/services/voice/expressive-tags.ts +405 -0
  466. package/src/services/voice/ffi-bindings.d.ts +674 -0
  467. package/src/services/voice/ffi-bindings.d.ts.map +1 -0
  468. package/src/services/voice/ffi-bindings.test.ts +728 -0
  469. package/src/services/voice/ffi-bindings.ts +3225 -0
  470. package/src/services/voice/first-line-cache.d.ts +181 -0
  471. package/src/services/voice/first-line-cache.d.ts.map +1 -0
  472. package/src/services/voice/first-line-cache.ts +725 -0
  473. package/src/services/voice/fused-eot-scorer.d.ts +51 -0
  474. package/src/services/voice/fused-eot-scorer.d.ts.map +1 -0
  475. package/src/services/voice/fused-eot-scorer.ts +135 -0
  476. package/src/services/voice/index.d.ts +91 -0
  477. package/src/services/voice/index.d.ts.map +1 -0
  478. package/src/services/voice/index.ts +481 -0
  479. package/src/services/voice/kokoro/__tests__/kokoro-backend.test.ts +151 -0
  480. package/src/services/voice/kokoro/__tests__/kokoro-engine-bridge.real.test.ts +151 -0
  481. package/src/services/voice/kokoro/__tests__/kokoro-engine-bridge.test.ts +60 -0
  482. package/src/services/voice/kokoro/__tests__/kokoro-engine-discovery.test.ts +277 -0
  483. package/src/services/voice/kokoro/__tests__/kokoro-ffi-runtime.test.ts +235 -0
  484. package/src/services/voice/kokoro/__tests__/kokoro-runtime.test.ts +95 -0
  485. package/src/services/voice/kokoro/__tests__/phonemizer.test.ts +53 -0
  486. package/src/services/voice/kokoro/__tests__/runtime-selection.test.ts +231 -0
  487. package/src/services/voice/kokoro/__tests__/voices.test.ts +57 -0
  488. package/src/services/voice/kokoro/index.ts +79 -0
  489. package/src/services/voice/kokoro/kokoro-backend.d.ts +72 -0
  490. package/src/services/voice/kokoro/kokoro-backend.d.ts.map +1 -0
  491. package/src/services/voice/kokoro/kokoro-backend.ts +207 -0
  492. package/src/services/voice/kokoro/kokoro-engine-discovery.d.ts +58 -0
  493. package/src/services/voice/kokoro/kokoro-engine-discovery.d.ts.map +1 -0
  494. package/src/services/voice/kokoro/kokoro-engine-discovery.ts +177 -0
  495. package/src/services/voice/kokoro/kokoro-ffi-runtime.d.ts +75 -0
  496. package/src/services/voice/kokoro/kokoro-ffi-runtime.d.ts.map +1 -0
  497. package/src/services/voice/kokoro/kokoro-ffi-runtime.ts +233 -0
  498. package/src/services/voice/kokoro/kokoro-runtime.d.ts +100 -0
  499. package/src/services/voice/kokoro/kokoro-runtime.d.ts.map +1 -0
  500. package/src/services/voice/kokoro/kokoro-runtime.ts +170 -0
  501. package/src/services/voice/kokoro/phoneme-stream.ts +123 -0
  502. package/src/services/voice/kokoro/phonemizer.d.ts +50 -0
  503. package/src/services/voice/kokoro/phonemizer.d.ts.map +1 -0
  504. package/src/services/voice/kokoro/phonemizer.ts +344 -0
  505. package/src/services/voice/kokoro/pick-runtime.d.ts +61 -0
  506. package/src/services/voice/kokoro/pick-runtime.d.ts.map +1 -0
  507. package/src/services/voice/kokoro/pick-runtime.test.ts +91 -0
  508. package/src/services/voice/kokoro/pick-runtime.ts +130 -0
  509. package/src/services/voice/kokoro/runtime-selection.d.ts +92 -0
  510. package/src/services/voice/kokoro/runtime-selection.d.ts.map +1 -0
  511. package/src/services/voice/kokoro/runtime-selection.ts +237 -0
  512. package/src/services/voice/kokoro/types.d.ts +82 -0
  513. package/src/services/voice/kokoro/types.d.ts.map +1 -0
  514. package/src/services/voice/kokoro/types.ts +95 -0
  515. package/src/services/voice/kokoro/voice-presets.d.ts +23 -0
  516. package/src/services/voice/kokoro/voice-presets.d.ts.map +1 -0
  517. package/src/services/voice/kokoro/voice-presets.ts +129 -0
  518. package/src/services/voice/kokoro/voices.d.ts +30 -0
  519. package/src/services/voice/kokoro/voices.d.ts.map +1 -0
  520. package/src/services/voice/kokoro/voices.ts +64 -0
  521. package/src/services/voice/lifecycle.d.ts +135 -0
  522. package/src/services/voice/lifecycle.d.ts.map +1 -0
  523. package/src/services/voice/lifecycle.test.ts +315 -0
  524. package/src/services/voice/lifecycle.ts +301 -0
  525. package/src/services/voice/live-diarization-session.d.ts +96 -0
  526. package/src/services/voice/live-diarization-session.d.ts.map +1 -0
  527. package/src/services/voice/live-diarization-session.ts +289 -0
  528. package/src/services/voice/mic-source.d.ts +136 -0
  529. package/src/services/voice/mic-source.d.ts.map +1 -0
  530. package/src/services/voice/mic-source.test.ts +210 -0
  531. package/src/services/voice/mic-source.ts +503 -0
  532. package/src/services/voice/optimistic-policy.d.ts +109 -0
  533. package/src/services/voice/optimistic-policy.d.ts.map +1 -0
  534. package/src/services/voice/optimistic-policy.test.ts +101 -0
  535. package/src/services/voice/optimistic-policy.ts +192 -0
  536. package/src/services/voice/optimistic-rollback.ts +343 -0
  537. package/src/services/voice/partial-stabilizer.d.ts +73 -0
  538. package/src/services/voice/partial-stabilizer.d.ts.map +1 -0
  539. package/src/services/voice/partial-stabilizer.test.ts +68 -0
  540. package/src/services/voice/partial-stabilizer.ts +140 -0
  541. package/src/services/voice/phoneme-tokenizer.d.ts +49 -0
  542. package/src/services/voice/phoneme-tokenizer.d.ts.map +1 -0
  543. package/src/services/voice/phoneme-tokenizer.ts +158 -0
  544. package/src/services/voice/phrase-cache.d.ts +76 -0
  545. package/src/services/voice/phrase-cache.d.ts.map +1 -0
  546. package/src/services/voice/phrase-cache.test.ts +242 -0
  547. package/src/services/voice/phrase-cache.ts +186 -0
  548. package/src/services/voice/phrase-chunker.d.ts +62 -0
  549. package/src/services/voice/phrase-chunker.d.ts.map +1 -0
  550. package/src/services/voice/phrase-chunker.test.ts +239 -0
  551. package/src/services/voice/phrase-chunker.ts +281 -0
  552. package/src/services/voice/pipeline-impls.d.ts +151 -0
  553. package/src/services/voice/pipeline-impls.d.ts.map +1 -0
  554. package/src/services/voice/pipeline-impls.l6.test.ts +110 -0
  555. package/src/services/voice/pipeline-impls.test.ts +292 -0
  556. package/src/services/voice/pipeline-impls.ts +315 -0
  557. package/src/services/voice/pipeline.d.ts +216 -0
  558. package/src/services/voice/pipeline.d.ts.map +1 -0
  559. package/src/services/voice/pipeline.ts +505 -0
  560. package/src/services/voice/prefill-client.d.ts +123 -0
  561. package/src/services/voice/prefill-client.d.ts.map +1 -0
  562. package/src/services/voice/prefill-client.ts +316 -0
  563. package/src/services/voice/prefix-preserving-queue.d.ts +113 -0
  564. package/src/services/voice/prefix-preserving-queue.d.ts.map +1 -0
  565. package/src/services/voice/prefix-preserving-queue.ts +162 -0
  566. package/src/services/voice/profile-store.d.ts +248 -0
  567. package/src/services/voice/profile-store.d.ts.map +1 -0
  568. package/src/services/voice/profile-store.ts +887 -0
  569. package/src/services/voice/real-audio-decode.test.ts +148 -0
  570. package/src/services/voice/ring-buffer.d.ts +40 -0
  571. package/src/services/voice/ring-buffer.d.ts.map +1 -0
  572. package/src/services/voice/ring-buffer.test.ts +129 -0
  573. package/src/services/voice/ring-buffer.ts +123 -0
  574. package/src/services/voice/rollback-queue.d.ts +24 -0
  575. package/src/services/voice/rollback-queue.d.ts.map +1 -0
  576. package/src/services/voice/rollback-queue.ts +74 -0
  577. package/src/services/voice/samantha-preset-placeholder.d.ts +67 -0
  578. package/src/services/voice/samantha-preset-placeholder.d.ts.map +1 -0
  579. package/src/services/voice/samantha-preset-placeholder.test.ts +97 -0
  580. package/src/services/voice/samantha-preset-placeholder.ts +148 -0
  581. package/src/services/voice/samantha-preset-regenerator.d.ts +87 -0
  582. package/src/services/voice/samantha-preset-regenerator.d.ts.map +1 -0
  583. package/src/services/voice/samantha-preset-regenerator.ts +393 -0
  584. package/src/services/voice/scheduler.d.ts +146 -0
  585. package/src/services/voice/scheduler.d.ts.map +1 -0
  586. package/src/services/voice/scheduler.t2.test.ts +141 -0
  587. package/src/services/voice/scheduler.ts +927 -0
  588. package/src/services/voice/shared-resources.d.ts +190 -0
  589. package/src/services/voice/shared-resources.d.ts.map +1 -0
  590. package/src/services/voice/shared-resources.ts +320 -0
  591. package/src/services/voice/speaker/attribution-pipeline.d.ts +74 -0
  592. package/src/services/voice/speaker/attribution-pipeline.d.ts.map +1 -0
  593. package/src/services/voice/speaker/attribution-pipeline.ts +386 -0
  594. package/src/services/voice/speaker/diarizer-fused.d.ts +59 -0
  595. package/src/services/voice/speaker/diarizer-fused.d.ts.map +1 -0
  596. package/src/services/voice/speaker/diarizer-fused.real.test.ts +100 -0
  597. package/src/services/voice/speaker/diarizer-fused.ts +154 -0
  598. package/src/services/voice/speaker/diarizer.d.ts +75 -0
  599. package/src/services/voice/speaker/diarizer.d.ts.map +1 -0
  600. package/src/services/voice/speaker/diarizer.ts +218 -0
  601. package/src/services/voice/speaker/encoder-fused.d.ts +60 -0
  602. package/src/services/voice/speaker/encoder-fused.d.ts.map +1 -0
  603. package/src/services/voice/speaker/encoder-fused.real.test.ts +113 -0
  604. package/src/services/voice/speaker/encoder-fused.ts +138 -0
  605. package/src/services/voice/speaker/encoder-ggml.d.ts +33 -0
  606. package/src/services/voice/speaker/encoder-ggml.d.ts.map +1 -0
  607. package/src/services/voice/speaker/encoder-ggml.ts +79 -0
  608. package/src/services/voice/speaker/encoder.d.ts +37 -0
  609. package/src/services/voice/speaker/encoder.d.ts.map +1 -0
  610. package/src/services/voice/speaker/encoder.ts +105 -0
  611. package/src/services/voice/speaker-imprint.d.ts +83 -0
  612. package/src/services/voice/speaker-imprint.d.ts.map +1 -0
  613. package/src/services/voice/speaker-imprint.test.ts +185 -0
  614. package/src/services/voice/speaker-imprint.ts +312 -0
  615. package/src/services/voice/speaker-preset-cache.d.ts +77 -0
  616. package/src/services/voice/speaker-preset-cache.d.ts.map +1 -0
  617. package/src/services/voice/speaker-preset-cache.test.ts +154 -0
  618. package/src/services/voice/speaker-preset-cache.ts +195 -0
  619. package/src/services/voice/streaming-asr/streaming-pipeline-adapter.ts +292 -0
  620. package/src/services/voice/system-audio-sink.d.ts +73 -0
  621. package/src/services/voice/system-audio-sink.d.ts.map +1 -0
  622. package/src/services/voice/system-audio-sink.test.ts +29 -0
  623. package/src/services/voice/system-audio-sink.ts +366 -0
  624. package/src/services/voice/transcriber.d.ts +244 -0
  625. package/src/services/voice/transcriber.d.ts.map +1 -0
  626. package/src/services/voice/transcriber.test.ts +392 -0
  627. package/src/services/voice/transcriber.ts +704 -0
  628. package/src/services/voice/transcript-knowledge.d.ts +37 -0
  629. package/src/services/voice/transcript-knowledge.d.ts.map +1 -0
  630. package/src/services/voice/transcript-knowledge.test.ts +68 -0
  631. package/src/services/voice/transcript-knowledge.ts +75 -0
  632. package/src/services/voice/transcript-service.d.ts +41 -0
  633. package/src/services/voice/transcript-service.d.ts.map +1 -0
  634. package/src/services/voice/transcript-service.test.ts +137 -0
  635. package/src/services/voice/transcript-service.ts +141 -0
  636. package/src/services/voice/transcript-store.d.ts +53 -0
  637. package/src/services/voice/transcript-store.d.ts.map +1 -0
  638. package/src/services/voice/transcript-store.test.ts +153 -0
  639. package/src/services/voice/transcript-store.ts +132 -0
  640. package/src/services/voice/turn-controller.d.ts +183 -0
  641. package/src/services/voice/turn-controller.d.ts.map +1 -0
  642. package/src/services/voice/turn-controller.test.ts +575 -0
  643. package/src/services/voice/turn-controller.ts +596 -0
  644. package/src/services/voice/types.d.ts +643 -0
  645. package/src/services/voice/types.d.ts.map +1 -0
  646. package/src/services/voice/types.ts +699 -0
  647. package/src/services/voice/vad.d.ts +282 -0
  648. package/src/services/voice/vad.d.ts.map +1 -0
  649. package/src/services/voice/vad.test.ts +480 -0
  650. package/src/services/voice/vad.ts +827 -0
  651. package/src/services/voice/vad.v1-v4.test.ts +222 -0
  652. package/src/services/voice/voice-budget.d.ts +241 -0
  653. package/src/services/voice/voice-budget.d.ts.map +1 -0
  654. package/src/services/voice/voice-budget.test.ts +418 -0
  655. package/src/services/voice/voice-budget.ts +635 -0
  656. package/src/services/voice/voice-duet.test.ts +375 -0
  657. package/src/services/voice/voice-emotion-classifier.d.ts +95 -0
  658. package/src/services/voice/voice-emotion-classifier.d.ts.map +1 -0
  659. package/src/services/voice/voice-emotion-classifier.test.ts +210 -0
  660. package/src/services/voice/voice-emotion-classifier.ts +273 -0
  661. package/src/services/voice/voice-preset-format.d.ts +158 -0
  662. package/src/services/voice/voice-preset-format.d.ts.map +1 -0
  663. package/src/services/voice/voice-preset-format.ts +700 -0
  664. package/src/services/voice/voice-preset-generator.test.ts +89 -0
  665. package/src/services/voice/voice-profile-artifact.d.ts +116 -0
  666. package/src/services/voice/voice-profile-artifact.d.ts.map +1 -0
  667. package/src/services/voice/voice-profile-artifact.test.ts +138 -0
  668. package/src/services/voice/voice-profile-artifact.ts +518 -0
  669. package/src/services/voice/voice-profile-routes.d.ts +83 -0
  670. package/src/services/voice/voice-profile-routes.d.ts.map +1 -0
  671. package/src/services/voice/voice-profile-routes.test.ts +429 -0
  672. package/src/services/voice/voice-profile-routes.ts +425 -0
  673. package/src/services/voice/voice-scenario.ts +154 -0
  674. package/src/services/voice/voice-settings.d.ts +82 -0
  675. package/src/services/voice/voice-settings.d.ts.map +1 -0
  676. package/src/services/voice/voice-settings.ts +172 -0
  677. package/src/services/voice/voice-state-machine.d.ts +364 -0
  678. package/src/services/voice/voice-state-machine.d.ts.map +1 -0
  679. package/src/services/voice/voice-state-machine.ts +727 -0
  680. package/src/services/voice/voice-workbench-report.test.ts +168 -0
  681. package/src/services/voice/voice-workbench-report.ts +326 -0
  682. package/src/services/voice/voice-workbench.test.ts +158 -0
  683. package/src/services/voice/voice.test.ts +1070 -0
  684. package/src/services/voice/wake-word-ggml.d.ts +101 -0
  685. package/src/services/voice/wake-word-ggml.d.ts.map +1 -0
  686. package/src/services/voice/wake-word-ggml.ts +320 -0
  687. package/src/services/voice/wake-word.d.ts +255 -0
  688. package/src/services/voice/wake-word.d.ts.map +1 -0
  689. package/src/services/voice/wake-word.test.ts +298 -0
  690. package/src/services/voice/wake-word.ts +554 -0
  691. package/src/services/voice/wrap-with-first-line-cache.d.ts +70 -0
  692. package/src/services/voice/wrap-with-first-line-cache.d.ts.map +1 -0
  693. package/src/services/voice/wrap-with-first-line-cache.ts +267 -0
  694. package/src/services/voice-model-updater.d.ts +240 -0
  695. package/src/services/voice-model-updater.d.ts.map +1 -0
  696. package/src/services/voice-model-updater.ts +724 -0
  697. package/src/services/voice-prewarm.d.ts +3 -0
  698. package/src/services/voice-prewarm.d.ts.map +1 -0
  699. package/src/services/voice-prewarm.ts +51 -0
  700. package/dist/index.d.ts +0 -37
  701. package/dist/index.js +0 -1098
@@ -0,0 +1,231 @@
1
+ import { afterEach, describe, expect, it } from "vitest";
2
+ import { classifyDeviceTier } from "./device-tier";
3
+ import {
4
+ __resetGpuDetectionCacheForTests,
5
+ __setGpuDetectionSpawnSyncForTests,
6
+ } from "./gpu-detect";
7
+ import {
8
+ detectCpuFeatures,
9
+ detectOpenVinoDevices,
10
+ deviceCapsFromProbe,
11
+ probeHardware,
12
+ } from "./hardware";
13
+
14
+ function detector(files: Record<string, string[] | true>) {
15
+ const existsSync = (path: string): boolean => path in files;
16
+ const readdirSync = (path: string): string[] => {
17
+ const value = files[path];
18
+ return Array.isArray(value) ? value : [];
19
+ };
20
+ return { existsSync, readdirSync };
21
+ }
22
+
23
+ describe("detectOpenVinoDevices", () => {
24
+ it("prefers NPU for ASR when OpenVINO runtime and accel node are present", () => {
25
+ const probe = detectOpenVinoDevices({
26
+ platform: "linux",
27
+ env: { OpenVINO_DIR: "/opt/intel/openvino_2026/runtime/cmake" },
28
+ ...detector({
29
+ "/dev/accel": ["accel0"],
30
+ }),
31
+ });
32
+
33
+ expect(probe.runtimeAvailable).toBe(true);
34
+ expect(probe.devices).toEqual(["CPU", "NPU"]);
35
+ expect(probe.npu.accelNodes).toEqual(["/dev/accel/accel0"]);
36
+ expect(probe.recommendedAsrDevice).toBe("NPU");
37
+ });
38
+
39
+ it("warns when Intel render nodes exist without the Compute Runtime stack", () => {
40
+ const probe = detectOpenVinoDevices({
41
+ platform: "linux",
42
+ env: { OpenVINO_DIR: "/opt/intel/openvino_2026/runtime/cmake" },
43
+ ...detector({
44
+ "/dev/dri": ["card0", "renderD128"],
45
+ }),
46
+ });
47
+
48
+ expect(probe.devices).toEqual(["CPU"]);
49
+ expect(probe.gpu.renderNodes).toEqual(["/dev/dri/renderD128"]);
50
+ expect(probe.gpu.computeRuntimeReady).toBe(false);
51
+ expect(probe.gpu.missingLinuxPackages).toEqual([
52
+ "intel-opencl-icd",
53
+ "libigc2",
54
+ "libigdfcl2",
55
+ ]);
56
+ expect(probe.warnings[0]).toContain("Intel Compute Runtime packages");
57
+ });
58
+
59
+ it("does not report OpenVINO devices when the runtime is not installed", () => {
60
+ const probe = detectOpenVinoDevices({
61
+ platform: "linux",
62
+ env: {},
63
+ ...detector({
64
+ "/dev/accel": ["accel0"],
65
+ "/dev/dri": ["renderD128"],
66
+ "/usr/lib/x86_64-linux-gnu/intel-opencl/libigdrcl.so": true,
67
+ }),
68
+ });
69
+
70
+ expect(probe.runtimeAvailable).toBe(false);
71
+ expect(probe.devices).toEqual([]);
72
+ expect(probe.recommendedAsrDevice).toBeNull();
73
+ expect(probe.warnings).toContain(
74
+ "Intel accelerator nodes are present, but OpenVINO Runtime was not found; source setupvars.sh or set OpenVINO_DIR.",
75
+ );
76
+ });
77
+
78
+ it("treats sandbox-denied optional system paths as unavailable", () => {
79
+ const existsSync = (path: string): boolean => {
80
+ throw Object.assign(
81
+ new Error(`mobile-fs-shim: path escapes workspace root: ${path}`),
82
+ { code: "EACCES" },
83
+ );
84
+ };
85
+ const readdirSync = (path: string): string[] => {
86
+ throw new Error(`unexpected readdir for ${path}`);
87
+ };
88
+
89
+ const probe = detectOpenVinoDevices({
90
+ platform: "linux",
91
+ env: {},
92
+ existsSync,
93
+ readdirSync,
94
+ });
95
+
96
+ expect(probe.runtimeAvailable).toBe(false);
97
+ expect(probe.devices).toEqual([]);
98
+ expect(probe.gpu.renderNodes).toEqual([]);
99
+ expect(probe.npu.accelNodes).toEqual([]);
100
+ expect(probe.recommendedAsrDevice).toBeNull();
101
+ });
102
+ });
103
+
104
+ describe("detectCpuFeatures", () => {
105
+ it("maps Linux ARM cpuinfo feature tokens to the shared probe shape", () => {
106
+ const cpuinfo = [
107
+ "processor\t: 0",
108
+ "Features\t: fp asimd evtstrm aes asimddp i8mm sve sve2",
109
+ "",
110
+ ].join("\n");
111
+
112
+ expect(
113
+ detectCpuFeatures({
114
+ platform: "linux",
115
+ arch: "arm64",
116
+ readFileSync: () => cpuinfo,
117
+ }),
118
+ ).toEqual({
119
+ neon: true,
120
+ dotprod: true,
121
+ i8mm: true,
122
+ sve: true,
123
+ sve2: true,
124
+ });
125
+ });
126
+
127
+ it("maps Android ARM cpuinfo aliases without assuming missing features", () => {
128
+ const cpuinfo = "Features\t: fp neon dotprod\n";
129
+
130
+ expect(
131
+ detectCpuFeatures({
132
+ platform: "android",
133
+ arch: "arm64",
134
+ readFileSync: () => cpuinfo,
135
+ }),
136
+ ).toEqual({
137
+ neon: true,
138
+ dotprod: true,
139
+ i8mm: false,
140
+ sve: false,
141
+ sve2: false,
142
+ });
143
+ });
144
+
145
+ it("uses Darwin sysctl keys where available and treats missing keys as false", () => {
146
+ const values: Record<string, string> = {
147
+ "hw.optional.arm.FEAT_DotProd": "1\n",
148
+ "hw.optional.arm.FEAT_I8MM": "0\n",
149
+ };
150
+
151
+ expect(
152
+ detectCpuFeatures({
153
+ platform: "darwin",
154
+ arch: "arm64",
155
+ execFileSync: (_file, args) => {
156
+ const key = args[1];
157
+ if (key in values) return values[key];
158
+ throw new Error(`unknown sysctl ${key}`);
159
+ },
160
+ }),
161
+ ).toEqual({
162
+ neon: true,
163
+ dotprod: true,
164
+ i8mm: false,
165
+ sve: false,
166
+ sve2: false,
167
+ });
168
+ });
169
+
170
+ it("does not claim CPU backend support for ARM when NEON evidence is absent", () => {
171
+ expect(
172
+ deviceCapsFromProbe({
173
+ totalRamGb: 16,
174
+ freeRamGb: 12,
175
+ gpu: null,
176
+ cpuCores: 8,
177
+ platform: "linux",
178
+ arch: "arm64",
179
+ appleSilicon: false,
180
+ recommendedBucket: "mid",
181
+ source: "os-fallback",
182
+ }),
183
+ ).toEqual({
184
+ availableBackends: [],
185
+ ramMb: 16 * 1024,
186
+ cpuFeatures: undefined,
187
+ });
188
+ });
189
+ });
190
+
191
+ describe("probeHardware GPU detection", () => {
192
+ afterEach(() => {
193
+ __setGpuDetectionSpawnSyncForTests(null);
194
+ __resetGpuDetectionCacheForTests();
195
+ });
196
+
197
+ const fakeSpawn =
198
+ (stdout: string, status: number) =>
199
+ (): { stdout: string; stderr: string; status: number; signal: null } => ({
200
+ stdout,
201
+ stderr: "",
202
+ status,
203
+ signal: null,
204
+ });
205
+
206
+ it("populates a CUDA GPU + VRAM from nvidia-smi and lifts the tier off CPU", async () => {
207
+ // reset clears BOTH the cache and any prior override, so reset first.
208
+ __resetGpuDetectionCacheForTests();
209
+ __setGpuDetectionSpawnSyncForTests(
210
+ fakeSpawn("NVIDIA GeForce RTX 4090, 24564\n", 0) as never,
211
+ );
212
+ const probe = await probeHardware();
213
+ expect(probe.gpu).not.toBeNull();
214
+ expect(probe.gpu?.backend).toBe("cuda");
215
+ expect(probe.gpu?.totalVramGb).toBeGreaterThanOrEqual(23);
216
+ // A 24 GB discrete GPU must not be mis-tiered as a CPU box.
217
+ expect(["MAX", "GOOD"]).toContain(classifyDeviceTier(probe).tier);
218
+ });
219
+
220
+ it("reports gpu:null when nvidia-smi is absent on a non-Apple host", async () => {
221
+ __resetGpuDetectionCacheForTests();
222
+ __setGpuDetectionSpawnSyncForTests(fakeSpawn("", 1) as never);
223
+ const probe = await probeHardware();
224
+ if (probe.appleSilicon) {
225
+ // Unified memory: the Apple GPU is always present.
226
+ expect(probe.gpu?.backend).toBe("metal");
227
+ } else {
228
+ expect(probe.gpu).toBeNull();
229
+ }
230
+ });
231
+ });
@@ -0,0 +1,410 @@
1
+ /**
2
+ * Hardware probe for local inference sizing.
3
+ *
4
+ * Uses `capacitor-llama` when available to read GPU backend + VRAM. Falls back
5
+ * to Node's `os` module when the binding isn't installed — we don't require
6
+ * the plugin to be loaded for the probe endpoint to return useful data.
7
+ *
8
+ * Dynamic import is intentional: the binding pulls a native prebuilt that we
9
+ * don't want eagerly required at module-load time (breaks CI environments
10
+ * without the trusted-dependency flag).
11
+ */
12
+
13
+ import { execFileSync } from "node:child_process";
14
+ import fs from "node:fs";
15
+ import os from "node:os";
16
+ import { detectGpu } from "./gpu-detect";
17
+ import type { Eliza1Backend, Eliza1DeviceCaps } from "./manifest";
18
+ import type {
19
+ CpuFeatureProbe,
20
+ HardwareProbe,
21
+ ModelBucket,
22
+ OpenVinoDeviceKind,
23
+ OpenVinoHardwareProbe,
24
+ } from "./types";
25
+
26
+ const BYTES_PER_GB = 1024 ** 3;
27
+
28
+ function bytesToGb(bytes: number): number {
29
+ return Math.round((bytes / BYTES_PER_GB) * 10) / 10;
30
+ }
31
+
32
+ /**
33
+ * Pick a default bucket based on total available memory and architecture.
34
+ *
35
+ * On Apple Silicon the GPU shares system RAM, so shared memory acts as VRAM.
36
+ * On discrete-GPU x86 boxes we weight VRAM higher than system RAM.
37
+ */
38
+ function recommendBucket(
39
+ totalRamGb: number,
40
+ vramGb: number,
41
+ appleSilicon: boolean,
42
+ ): ModelBucket {
43
+ const effective = appleSilicon
44
+ ? totalRamGb
45
+ : vramGb > 0
46
+ ? Math.max(vramGb * 1.25, totalRamGb * 0.5)
47
+ : totalRamGb * 0.5;
48
+
49
+ if (effective >= 36) return "xl";
50
+ if (effective >= 18) return "large";
51
+ if (effective >= 9) return "mid";
52
+ return "small";
53
+ }
54
+
55
+ interface CpuFeatureDetectionHost {
56
+ platform?: NodeJS.Platform;
57
+ arch?: NodeJS.Architecture;
58
+ readFileSync?: (path: string, encoding: BufferEncoding) => string;
59
+ execFileSync?: (
60
+ file: string,
61
+ args: readonly string[],
62
+ options: { encoding: BufferEncoding; stdio: "pipe" },
63
+ ) => string;
64
+ }
65
+
66
+ const DARWIN_ARM_FEATURE_SYSCTLS: Readonly<
67
+ Array<[keyof CpuFeatureProbe, string]>
68
+ > = [
69
+ ["dotprod", "hw.optional.arm.FEAT_DotProd"],
70
+ ["i8mm", "hw.optional.arm.FEAT_I8MM"],
71
+ ["sve", "hw.optional.arm.FEAT_SVE"],
72
+ ["sve2", "hw.optional.arm.FEAT_SVE2"],
73
+ ];
74
+
75
+ function emptyCpuFeatures(): CpuFeatureProbe {
76
+ return {
77
+ neon: false,
78
+ dotprod: false,
79
+ i8mm: false,
80
+ sve: false,
81
+ sve2: false,
82
+ };
83
+ }
84
+
85
+ function linuxArmFeatureTokens(cpuinfo: string): Set<string> {
86
+ const tokens = new Set<string>();
87
+ for (const line of cpuinfo.split(/\r?\n/)) {
88
+ const [rawKey, rawValue] = line.split(":", 2);
89
+ if (!rawKey || !rawValue) continue;
90
+ const key = rawKey.trim().toLowerCase();
91
+ if (key !== "features" && key !== "flags") continue;
92
+ for (const token of rawValue.trim().toLowerCase().split(/\s+/)) {
93
+ if (token) tokens.add(token);
94
+ }
95
+ }
96
+ return tokens;
97
+ }
98
+
99
+ export function detectCpuFeatures(
100
+ host: CpuFeatureDetectionHost = {},
101
+ ): CpuFeatureProbe | undefined {
102
+ const platform = host.platform ?? process.platform;
103
+ const arch = host.arch ?? process.arch;
104
+ if (arch !== "arm64" && arch !== "arm") return undefined;
105
+
106
+ if (platform === "linux" || platform === "android") {
107
+ const readFileSync = host.readFileSync ?? fs.readFileSync;
108
+ try {
109
+ const tokens = linuxArmFeatureTokens(
110
+ readFileSync("/proc/cpuinfo", "utf8"),
111
+ );
112
+ const features = emptyCpuFeatures();
113
+ features.neon = tokens.has("asimd") || tokens.has("neon");
114
+ features.dotprod = tokens.has("asimddp") || tokens.has("dotprod");
115
+ features.i8mm = tokens.has("i8mm") || tokens.has("asimdi8mm");
116
+ features.sve = tokens.has("sve");
117
+ features.sve2 = tokens.has("sve2");
118
+ return features;
119
+ } catch {
120
+ return undefined;
121
+ }
122
+ }
123
+
124
+ if (platform === "darwin") {
125
+ const run = host.execFileSync ?? execFileSync;
126
+ const features = emptyCpuFeatures();
127
+ // Arm64 Darwin requires Advanced SIMD/NEON. Some macOS releases do not
128
+ // expose a stable sysctl for it, so use the ABI guarantee for baseline.
129
+ features.neon = true;
130
+ for (const [feature, key] of DARWIN_ARM_FEATURE_SYSCTLS) {
131
+ try {
132
+ const value = run("sysctl", ["-n", key], {
133
+ encoding: "utf8",
134
+ stdio: "pipe",
135
+ });
136
+ const normalizedValue =
137
+ typeof value === "string" ? value.trim() : value.toString().trim();
138
+ features[feature] =
139
+ normalizedValue === "1" || normalizedValue.toLowerCase() === "true";
140
+ } catch {
141
+ features[feature] = false;
142
+ }
143
+ }
144
+ return features;
145
+ }
146
+
147
+ return undefined;
148
+ }
149
+
150
+ export function hasUsableArmCpuBackend(probe: HardwareProbe): boolean {
151
+ if (probe.arch !== "arm64" && probe.arch !== "arm") return true;
152
+ return probe.cpuFeatures?.neon === true;
153
+ }
154
+
155
+ /**
156
+ * Detect the host GPU + its VRAM for device-tier classification, VRAM
157
+ * admission, and `n_gpu_layers` sizing. Without this every box — including a
158
+ * 24 GB discrete workstation — probes as `gpu: null` and is mis-tiered as CPU.
159
+ *
160
+ * - NVIDIA: `nvidia-smi` (the cheapest real pre-load VRAM number).
161
+ * - Apple Silicon: unified memory, so system RAM IS the GPU working set.
162
+ * - AMD/Intel (Vulkan): no cheap pre-load VRAM query exists; left `null` here
163
+ * rather than guessed — the fused ABI surfaces real VRAM after model load.
164
+ */
165
+ function detectProbeGpu(
166
+ appleSilicon: boolean,
167
+ totalRamBytes: number,
168
+ freeRamBytes: number,
169
+ ): HardwareProbe["gpu"] {
170
+ const nvidia = detectGpu();
171
+ if (nvidia.nvidiaPresent && nvidia.gpu) {
172
+ const totalVramGb = bytesToGb(nvidia.gpu.totalMemoryMiB * 1024 * 1024);
173
+ // nvidia-smi `memory.total` is capacity; an idle probe treats it as free.
174
+ // Real free-VRAM admission happens against the live backend post-load.
175
+ return { backend: "cuda", totalVramGb, freeVramGb: totalVramGb };
176
+ }
177
+ if (appleSilicon) {
178
+ return {
179
+ backend: "metal",
180
+ totalVramGb: bytesToGb(totalRamBytes),
181
+ freeVramGb: bytesToGb(freeRamBytes),
182
+ };
183
+ }
184
+ return null;
185
+ }
186
+
187
+ const OPENVINO_LINUX_GPU_PACKAGES = [
188
+ "intel-opencl-icd",
189
+ "libigc2",
190
+ "libigdfcl2",
191
+ ] as const;
192
+
193
+ interface OpenVinoDetectionHost {
194
+ platform?: NodeJS.Platform;
195
+ env?: NodeJS.ProcessEnv;
196
+ existsSync?: (path: string) => boolean;
197
+ readdirSync?: (path: string) => string[];
198
+ }
199
+
200
+ function readableEntries(
201
+ dir: string,
202
+ host: Required<Pick<OpenVinoDetectionHost, "existsSync" | "readdirSync">>,
203
+ prefix: string,
204
+ ): string[] {
205
+ if (!pathExists(dir, host.existsSync)) return [];
206
+ try {
207
+ return host
208
+ .readdirSync(dir)
209
+ .filter((entry) => entry.startsWith(prefix))
210
+ .map((entry) => `${dir}/${entry}`);
211
+ } catch {
212
+ return [];
213
+ }
214
+ }
215
+
216
+ function pathExists(
217
+ path: string,
218
+ existsSync: Required<OpenVinoDetectionHost>["existsSync"],
219
+ ): boolean {
220
+ try {
221
+ return existsSync(path);
222
+ } catch {
223
+ return false;
224
+ }
225
+ }
226
+
227
+ function hasAny(
228
+ paths: string[],
229
+ existsSync: Required<OpenVinoDetectionHost>["existsSync"],
230
+ ): boolean {
231
+ return paths.some((candidate) => pathExists(candidate, existsSync));
232
+ }
233
+
234
+ export function detectOpenVinoDevices(
235
+ host: OpenVinoDetectionHost = {},
236
+ ): OpenVinoHardwareProbe {
237
+ const platform = host.platform ?? process.platform;
238
+ const env = host.env ?? process.env;
239
+ const existsSync = host.existsSync ?? fs.existsSync;
240
+ const readdirSync =
241
+ host.readdirSync ??
242
+ ((dir: string) => fs.readdirSync(dir, { encoding: "utf8" }) as string[]);
243
+ const io = { existsSync, readdirSync };
244
+
245
+ const runtimeAvailable =
246
+ Boolean(env.OpenVINO_DIR || env.INTEL_OPENVINO_DIR) ||
247
+ hasAny(
248
+ [
249
+ "/opt/intel/openvino/setupvars.sh",
250
+ "/opt/intel/openvino_2026/setupvars.sh",
251
+ "/usr/lib/x86_64-linux-gnu/libopenvino.so",
252
+ "/usr/lib/x86_64-linux-gnu/libopenvino.so.0",
253
+ "/usr/lib/aarch64-linux-gnu/libopenvino.so",
254
+ "/usr/lib/aarch64-linux-gnu/libopenvino.so.0",
255
+ ],
256
+ existsSync,
257
+ );
258
+
259
+ const renderNodes =
260
+ platform === "linux" ? readableEntries("/dev/dri", io, "renderD") : [];
261
+ const accelNodes =
262
+ platform === "linux" ? readableEntries("/dev/accel", io, "accel") : [];
263
+ const intelComputeRuntimeReady =
264
+ platform === "linux" &&
265
+ hasAny(
266
+ [
267
+ "/usr/lib/x86_64-linux-gnu/intel-opencl/libigdrcl.so",
268
+ "/usr/lib/x86_64-linux-gnu/libigc.so.1",
269
+ "/usr/lib/x86_64-linux-gnu/libigdfcl.so.1",
270
+ "/usr/lib/aarch64-linux-gnu/intel-opencl/libigdrcl.so",
271
+ "/usr/lib/aarch64-linux-gnu/libigc.so.1",
272
+ "/usr/lib/aarch64-linux-gnu/libigdfcl.so.1",
273
+ ],
274
+ existsSync,
275
+ );
276
+ const devices: OpenVinoDeviceKind[] = [];
277
+ if (runtimeAvailable) devices.push("CPU");
278
+ if (runtimeAvailable && renderNodes.length > 0 && intelComputeRuntimeReady) {
279
+ devices.push("GPU");
280
+ }
281
+ if (runtimeAvailable && accelNodes.length > 0) devices.push("NPU");
282
+
283
+ const warnings: string[] = [];
284
+ if (renderNodes.length > 0 && !intelComputeRuntimeReady) {
285
+ warnings.push(
286
+ `OpenVINO GPU needs Intel Compute Runtime packages: ${OPENVINO_LINUX_GPU_PACKAGES.join(", ")}`,
287
+ );
288
+ }
289
+ if ((renderNodes.length > 0 || accelNodes.length > 0) && !runtimeAvailable) {
290
+ warnings.push(
291
+ "Intel accelerator nodes are present, but OpenVINO Runtime was not found; source setupvars.sh or set OpenVINO_DIR.",
292
+ );
293
+ }
294
+
295
+ return {
296
+ runtimeAvailable,
297
+ devices,
298
+ gpu: {
299
+ renderNodes,
300
+ computeRuntimeReady: intelComputeRuntimeReady,
301
+ missingLinuxPackages:
302
+ renderNodes.length > 0 && !intelComputeRuntimeReady
303
+ ? [...OPENVINO_LINUX_GPU_PACKAGES]
304
+ : [],
305
+ },
306
+ npu: { accelNodes },
307
+ recommendedAsrDevice: devices.includes("NPU")
308
+ ? "NPU"
309
+ : devices.includes("GPU")
310
+ ? "GPU"
311
+ : devices.includes("CPU")
312
+ ? "CPU"
313
+ : null,
314
+ warnings,
315
+ };
316
+ }
317
+
318
+ /**
319
+ * Read current system + GPU state. Cheap enough to call per-request; no
320
+ * internal caching so the UI always reflects live VRAM usage.
321
+ */
322
+ export async function probeHardware(): Promise<HardwareProbe> {
323
+ const totalRamBytes = os.totalmem();
324
+ const freeRamBytes = os.freemem();
325
+ const cpuCores = os.cpus().length;
326
+ const platform = process.platform;
327
+ const arch = process.arch;
328
+ const appleSilicon = platform === "darwin" && arch === "arm64";
329
+ const openvino = detectOpenVinoDevices();
330
+ const cpuFeatures = detectCpuFeatures({ platform, arch });
331
+
332
+ const gpu = detectProbeGpu(appleSilicon, totalRamBytes, freeRamBytes);
333
+ const totalRamGb = bytesToGb(totalRamBytes);
334
+ return {
335
+ totalRamGb,
336
+ freeRamGb: bytesToGb(freeRamBytes),
337
+ gpu,
338
+ cpuCores,
339
+ cpuFeatures,
340
+ platform,
341
+ arch,
342
+ appleSilicon,
343
+ recommendedBucket: recommendBucket(
344
+ totalRamGb,
345
+ gpu?.totalVramGb ?? 0,
346
+ appleSilicon,
347
+ ),
348
+ source: "os-fallback",
349
+ openvino,
350
+ };
351
+ }
352
+
353
+ /**
354
+ * Map a hardware probe onto the Eliza-1 device-capability snapshot used by
355
+ * the manifest validator and the bundle downloader.
356
+ *
357
+ * Backends: `cpu` is always present (the floor). A detected GPU backend is
358
+ * added when `capacitor-llama` reports one (`metal` on Apple Silicon, `cuda`
359
+ * on NVIDIA, `vulkan` on cross-vendor Linux/Android). We do not synthesize
360
+ * `rocm` from the probe — `capacitor-llama` reports AMD as `vulkan` on the
361
+ * builds we ship, and a bundle that only verified ROCm but not Vulkan is
362
+ * legitimately not installable here.
363
+ *
364
+ * `ramMb` is total system RAM. On Apple Silicon that is also the GPU's
365
+ * working memory; on discrete-GPU boxes the recommendation engine layers
366
+ * its own VRAM-vs-RAM heuristics on top, but the bundle's `ramBudgetMb.min`
367
+ * is a system-RAM floor in every manifest.
368
+ */
369
+ export function deviceCapsFromProbe(probe: HardwareProbe): Eliza1DeviceCaps {
370
+ const backends: Eliza1Backend[] = hasUsableArmCpuBackend(probe)
371
+ ? ["cpu"]
372
+ : [];
373
+ const gpuBackend = probe.gpu?.backend;
374
+ if (
375
+ gpuBackend === "metal" ||
376
+ gpuBackend === "cuda" ||
377
+ gpuBackend === "vulkan"
378
+ ) {
379
+ backends.unshift(gpuBackend);
380
+ }
381
+ return {
382
+ availableBackends: backends,
383
+ ramMb: Math.round(probe.totalRamGb * 1024),
384
+ cpuFeatures: probe.cpuFeatures,
385
+ };
386
+ }
387
+
388
+ /**
389
+ * Compatibility assessment for a specific model given current hardware.
390
+ *
391
+ * Green/fits: comfortable headroom (model < 70% of effective memory).
392
+ * Yellow/tight: will run but may swap or stutter under load.
393
+ * Red/wontfit: exceeds available memory.
394
+ */
395
+ export function assessFit(
396
+ probe: HardwareProbe,
397
+ modelSizeGb: number,
398
+ minRamGb: number,
399
+ ): "fits" | "tight" | "wontfit" {
400
+ const effectiveGb = probe.appleSilicon
401
+ ? probe.totalRamGb
402
+ : probe.gpu
403
+ ? Math.max(probe.gpu.totalVramGb, probe.totalRamGb * 0.5)
404
+ : probe.totalRamGb * 0.5;
405
+
406
+ if (effectiveGb < minRamGb) return "wontfit";
407
+ if (modelSizeGb > effectiveGb * 0.9) return "wontfit";
408
+ if (modelSizeGb > effectiveGb * 0.7) return "tight";
409
+ return "fits";
410
+ }
@@ -0,0 +1,26 @@
1
+ /**
2
+ * HuggingFace Hub search for GGUF models.
3
+ *
4
+ * Calls `https://huggingface.co/api/models` with `filter=gguf` to narrow
5
+ * results to repos that actually ship GGUF quantisations. Each matching
6
+ * repo is expanded with `/api/models/<repo>` to pick a representative
7
+ * quant file (preferring Q4_K_M when present). Results are shaped like
8
+ * `CatalogModel` so the existing ModelCard renders them directly.
9
+ *
10
+ * We deliberately do not persist these — they're dynamic, and a curated
11
+ * entry with the same hfRepo always takes precedence in the UI.
12
+ */
13
+ import type { CatalogModel } from "./types";
14
+ /**
15
+ * Search HuggingFace for GGUF repos matching `query`, returning
16
+ * catalog-shaped entries ready for the Model Hub UI.
17
+ */
18
+ export declare function searchHuggingFaceGguf(query: string, limit?: number): Promise<CatalogModel[]>;
19
+ /**
20
+ * Search ModelScope for GGUF repos. ModelScope exposes reliable owner-list
21
+ * and repo-file APIs, so this accepts either `owner/model` or an owner name
22
+ * and filters the returned repos for GGUF files.
23
+ */
24
+ export declare function searchModelScopeGguf(query: string, limit?: number): Promise<CatalogModel[]>;
25
+ export declare function searchModelHubGguf(query: string, hub?: "huggingface" | "modelscope", limit?: number): Promise<CatalogModel[]>;
26
+ //# sourceMappingURL=hf-search.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hf-search.d.ts","sourceRoot":"","sources":["hf-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,SAAS,CAAC;AAgLzD;;;GAGG;AACH,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACR,OAAO,CAAC,YAAY,EAAE,CAAC,CAmFzB;AAiGD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACzC,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACR,OAAO,CAAC,YAAY,EAAE,CAAC,CAyBzB;AAED,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,aAAa,GAAG,YAA4B,EACjD,KAAK,SAAK,GACR,OAAO,CAAC,YAAY,EAAE,CAAC,CAIzB"}