node-llama-cpp 3.0.0-beta.8 → 3.0.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 (685) hide show
  1. package/README.md +42 -27
  2. package/bins/_linux-arm64.moved.txt +1 -0
  3. package/bins/_linux-armv7l.moved.txt +1 -0
  4. package/bins/_linux-x64-cuda.moved.txt +1 -0
  5. package/bins/_linux-x64-vulkan.moved.txt +1 -0
  6. package/bins/_linux-x64.moved.txt +1 -0
  7. package/bins/_mac-arm64-metal.moved.txt +1 -0
  8. package/bins/_mac-x64.moved.txt +1 -0
  9. package/bins/_win-arm64.moved.txt +1 -0
  10. package/bins/_win-x64-cuda.moved.txt +1 -0
  11. package/bins/_win-x64-vulkan.moved.txt +1 -0
  12. package/bins/_win-x64.moved.txt +1 -0
  13. package/dist/ChatWrapper.d.ts +19 -39
  14. package/dist/ChatWrapper.js +129 -72
  15. package/dist/ChatWrapper.js.map +1 -1
  16. package/dist/apiDocsIndex.d.ts +1 -0
  17. package/dist/apiDocsIndex.js +7 -0
  18. package/dist/apiDocsIndex.js.map +1 -0
  19. package/dist/bindings/AddonTypes.d.ts +88 -20
  20. package/dist/bindings/Llama.d.ts +43 -6
  21. package/dist/bindings/Llama.js +214 -40
  22. package/dist/bindings/Llama.js.map +1 -1
  23. package/dist/bindings/consts.d.ts +2 -0
  24. package/dist/bindings/consts.js +13 -0
  25. package/dist/bindings/consts.js.map +1 -0
  26. package/dist/bindings/getLlama.d.ts +123 -18
  27. package/dist/bindings/getLlama.js +288 -90
  28. package/dist/bindings/getLlama.js.map +1 -1
  29. package/dist/bindings/types.d.ts +29 -5
  30. package/dist/bindings/types.js +51 -2
  31. package/dist/bindings/types.js.map +1 -1
  32. package/dist/bindings/utils/MemoryOrchestrator.d.ts +21 -0
  33. package/dist/bindings/utils/MemoryOrchestrator.js +49 -0
  34. package/dist/bindings/utils/MemoryOrchestrator.js.map +1 -0
  35. package/dist/bindings/utils/asyncEvery.d.ts +5 -0
  36. package/dist/bindings/utils/asyncEvery.js +15 -0
  37. package/dist/bindings/utils/asyncEvery.js.map +1 -0
  38. package/dist/bindings/utils/asyncSome.d.ts +5 -0
  39. package/dist/bindings/utils/asyncSome.js +27 -0
  40. package/dist/bindings/utils/asyncSome.js.map +1 -0
  41. package/dist/bindings/utils/clearAllLocalBuilds.js.map +1 -1
  42. package/dist/bindings/utils/cloneLlamaCppRepo.d.ts +1 -1
  43. package/dist/bindings/utils/cloneLlamaCppRepo.js +39 -28
  44. package/dist/bindings/utils/cloneLlamaCppRepo.js.map +1 -1
  45. package/dist/bindings/utils/compileLLamaCpp.d.ts +11 -3
  46. package/dist/bindings/utils/compileLLamaCpp.js +250 -81
  47. package/dist/bindings/utils/compileLLamaCpp.js.map +1 -1
  48. package/dist/bindings/utils/detectAvailableComputeLayers.d.ts +14 -0
  49. package/dist/bindings/utils/detectAvailableComputeLayers.js +305 -0
  50. package/dist/bindings/utils/detectAvailableComputeLayers.js.map +1 -0
  51. package/dist/bindings/utils/detectGlibc.d.ts +4 -0
  52. package/dist/bindings/utils/detectGlibc.js +46 -0
  53. package/dist/bindings/utils/detectGlibc.js.map +1 -0
  54. package/dist/bindings/utils/getBestComputeLayersAvailable.d.ts +9 -0
  55. package/dist/bindings/utils/getBestComputeLayersAvailable.js +29 -0
  56. package/dist/bindings/utils/getBestComputeLayersAvailable.js.map +1 -0
  57. package/dist/bindings/utils/getBuildFolderNameForBuildOptions.js +14 -6
  58. package/dist/bindings/utils/getBuildFolderNameForBuildOptions.js.map +1 -1
  59. package/dist/bindings/utils/getExampleUsageCodeOfGetLlama.js.map +1 -1
  60. package/dist/bindings/utils/getGpuTypesToUseForOption.d.ts +12 -0
  61. package/dist/bindings/utils/getGpuTypesToUseForOption.js +39 -0
  62. package/dist/bindings/utils/getGpuTypesToUseForOption.js.map +1 -0
  63. package/dist/bindings/utils/getLinuxDistroInfo.d.ts +9 -0
  64. package/dist/bindings/utils/getLinuxDistroInfo.js +46 -0
  65. package/dist/bindings/utils/getLinuxDistroInfo.js.map +1 -0
  66. package/dist/bindings/utils/getLlamaWithoutBackend.d.ts +5 -0
  67. package/dist/bindings/utils/getLlamaWithoutBackend.js +27 -0
  68. package/dist/bindings/utils/getLlamaWithoutBackend.js.map +1 -0
  69. package/dist/bindings/utils/getPlatform.js.map +1 -1
  70. package/dist/bindings/utils/getPlatformInfo.d.ts +5 -0
  71. package/dist/bindings/utils/getPlatformInfo.js +28 -0
  72. package/dist/bindings/utils/getPlatformInfo.js.map +1 -0
  73. package/dist/bindings/utils/hasBuildingFromSourceDependenciesInstalled.d.ts +3 -0
  74. package/dist/bindings/utils/hasBuildingFromSourceDependenciesInstalled.js +27 -0
  75. package/dist/bindings/utils/hasBuildingFromSourceDependenciesInstalled.js.map +1 -0
  76. package/dist/bindings/utils/hasFileInPath.d.ts +2 -0
  77. package/dist/bindings/utils/hasFileInPath.js +34 -0
  78. package/dist/bindings/utils/hasFileInPath.js.map +1 -0
  79. package/dist/bindings/utils/lastBuildInfo.js.map +1 -1
  80. package/dist/bindings/utils/logBinaryUsageExampleToConsole.d.ts +1 -1
  81. package/dist/bindings/utils/logBinaryUsageExampleToConsole.js +3 -9
  82. package/dist/bindings/utils/logBinaryUsageExampleToConsole.js.map +1 -1
  83. package/dist/bindings/utils/logDistroInstallInstruction.d.ts +14 -0
  84. package/dist/bindings/utils/logDistroInstallInstruction.js +48 -0
  85. package/dist/bindings/utils/logDistroInstallInstruction.js.map +1 -0
  86. package/dist/bindings/utils/resolveCustomCmakeOptions.js +26 -26
  87. package/dist/bindings/utils/resolveCustomCmakeOptions.js.map +1 -1
  88. package/dist/bindings/utils/testBindingBinary.d.ts +1 -0
  89. package/dist/bindings/utils/testBindingBinary.js +100 -0
  90. package/dist/bindings/utils/testBindingBinary.js.map +1 -0
  91. package/dist/bindings/utils/testCmakeBinary.d.ts +5 -0
  92. package/dist/bindings/utils/testCmakeBinary.js +32 -0
  93. package/dist/bindings/utils/testCmakeBinary.js.map +1 -0
  94. package/dist/chatWrappers/AlpacaChatWrapper.d.ts +2 -1
  95. package/dist/chatWrappers/AlpacaChatWrapper.js +10 -2
  96. package/dist/chatWrappers/AlpacaChatWrapper.js.map +1 -1
  97. package/dist/chatWrappers/ChatMLChatWrapper.d.ts +2 -14
  98. package/dist/chatWrappers/ChatMLChatWrapper.js +23 -21
  99. package/dist/chatWrappers/ChatMLChatWrapper.js.map +1 -1
  100. package/dist/chatWrappers/FalconChatWrapper.d.ts +4 -10
  101. package/dist/chatWrappers/FalconChatWrapper.js +39 -21
  102. package/dist/chatWrappers/FalconChatWrapper.js.map +1 -1
  103. package/dist/chatWrappers/FunctionaryChatWrapper.d.ts +8 -32
  104. package/dist/chatWrappers/FunctionaryChatWrapper.js +514 -118
  105. package/dist/chatWrappers/FunctionaryChatWrapper.js.map +1 -1
  106. package/dist/chatWrappers/GemmaChatWrapper.d.ts +7 -0
  107. package/dist/chatWrappers/GemmaChatWrapper.js +96 -0
  108. package/dist/chatWrappers/GemmaChatWrapper.js.map +1 -0
  109. package/dist/chatWrappers/GeneralChatWrapper.d.ts +4 -10
  110. package/dist/chatWrappers/GeneralChatWrapper.js +46 -22
  111. package/dist/chatWrappers/GeneralChatWrapper.js.map +1 -1
  112. package/dist/chatWrappers/Llama2ChatWrapper.d.ts +12 -0
  113. package/dist/chatWrappers/{LlamaChatWrapper.js → Llama2ChatWrapper.js} +37 -20
  114. package/dist/chatWrappers/Llama2ChatWrapper.js.map +1 -0
  115. package/dist/chatWrappers/Llama3ChatWrapper.d.ts +16 -0
  116. package/dist/chatWrappers/Llama3ChatWrapper.js +173 -0
  117. package/dist/chatWrappers/Llama3ChatWrapper.js.map +1 -0
  118. package/dist/chatWrappers/Llama3_1ChatWrapper.d.ts +35 -0
  119. package/dist/chatWrappers/Llama3_1ChatWrapper.js +277 -0
  120. package/dist/chatWrappers/Llama3_1ChatWrapper.js.map +1 -0
  121. package/dist/chatWrappers/MistralChatWrapper.d.ts +15 -0
  122. package/dist/chatWrappers/MistralChatWrapper.js +169 -0
  123. package/dist/chatWrappers/MistralChatWrapper.js.map +1 -0
  124. package/dist/chatWrappers/generic/JinjaTemplateChatWrapper.d.ts +100 -0
  125. package/dist/chatWrappers/generic/JinjaTemplateChatWrapper.js +409 -0
  126. package/dist/chatWrappers/generic/JinjaTemplateChatWrapper.js.map +1 -0
  127. package/dist/chatWrappers/generic/TemplateChatWrapper.d.ts +60 -0
  128. package/dist/chatWrappers/generic/TemplateChatWrapper.js +204 -0
  129. package/dist/chatWrappers/generic/TemplateChatWrapper.js.map +1 -0
  130. package/dist/chatWrappers/generic/utils/chatHistoryFunctionCallMessageTemplate.d.ts +23 -0
  131. package/dist/chatWrappers/generic/utils/chatHistoryFunctionCallMessageTemplate.js +45 -0
  132. package/dist/chatWrappers/generic/utils/chatHistoryFunctionCallMessageTemplate.js.map +1 -0
  133. package/dist/chatWrappers/utils/ChatModelFunctionsDocumentationGenerator.d.ts +57 -0
  134. package/dist/chatWrappers/utils/ChatModelFunctionsDocumentationGenerator.js +119 -0
  135. package/dist/chatWrappers/utils/ChatModelFunctionsDocumentationGenerator.js.map +1 -0
  136. package/dist/chatWrappers/utils/chunkChatItems.d.ts +10 -0
  137. package/dist/chatWrappers/utils/chunkChatItems.js +44 -0
  138. package/dist/chatWrappers/utils/chunkChatItems.js.map +1 -0
  139. package/dist/chatWrappers/utils/isJinjaTemplateEquivalentToSpecializedChatWrapper.d.ts +4 -0
  140. package/dist/chatWrappers/utils/isJinjaTemplateEquivalentToSpecializedChatWrapper.js +221 -0
  141. package/dist/chatWrappers/utils/isJinjaTemplateEquivalentToSpecializedChatWrapper.js.map +1 -0
  142. package/dist/chatWrappers/utils/jsonDumps.d.ts +7 -0
  143. package/dist/chatWrappers/utils/jsonDumps.js +18 -0
  144. package/dist/chatWrappers/utils/jsonDumps.js.map +1 -0
  145. package/dist/chatWrappers/utils/resolveChatWrapper.d.ts +95 -0
  146. package/dist/chatWrappers/utils/resolveChatWrapper.js +335 -0
  147. package/dist/chatWrappers/utils/resolveChatWrapper.js.map +1 -0
  148. package/dist/cli/cli.js +19 -11
  149. package/dist/cli/cli.js.map +1 -1
  150. package/dist/cli/commands/ChatCommand.d.ts +16 -7
  151. package/dist/cli/commands/ChatCommand.js +323 -191
  152. package/dist/cli/commands/ChatCommand.js.map +1 -1
  153. package/dist/cli/commands/CompleteCommand.d.ts +31 -0
  154. package/dist/cli/commands/CompleteCommand.js +402 -0
  155. package/dist/cli/commands/CompleteCommand.js.map +1 -0
  156. package/dist/cli/commands/DebugCommand.d.ts +7 -0
  157. package/dist/cli/commands/DebugCommand.js +54 -0
  158. package/dist/cli/commands/DebugCommand.js.map +1 -0
  159. package/dist/cli/commands/InfillCommand.d.ts +33 -0
  160. package/dist/cli/commands/InfillCommand.js +438 -0
  161. package/dist/cli/commands/InfillCommand.js.map +1 -0
  162. package/dist/cli/commands/InitCommand.d.ts +11 -0
  163. package/dist/cli/commands/InitCommand.js +195 -0
  164. package/dist/cli/commands/InitCommand.js.map +1 -0
  165. package/dist/cli/commands/OnPostInstallCommand.js +6 -2
  166. package/dist/cli/commands/OnPostInstallCommand.js.map +1 -1
  167. package/dist/cli/commands/PullCommand.d.ts +13 -0
  168. package/dist/cli/commands/PullCommand.js +158 -0
  169. package/dist/cli/commands/PullCommand.js.map +1 -0
  170. package/dist/cli/commands/inspect/InspectCommand.d.ts +4 -0
  171. package/dist/cli/commands/inspect/InspectCommand.js +21 -0
  172. package/dist/cli/commands/inspect/InspectCommand.js.map +1 -0
  173. package/dist/cli/commands/inspect/commands/InspectEstimateCommand.d.ts +12 -0
  174. package/dist/cli/commands/inspect/commands/InspectEstimateCommand.js +225 -0
  175. package/dist/cli/commands/inspect/commands/InspectEstimateCommand.js.map +1 -0
  176. package/dist/cli/commands/inspect/commands/InspectGgufCommand.d.ts +12 -0
  177. package/dist/cli/commands/inspect/commands/InspectGgufCommand.js +149 -0
  178. package/dist/cli/commands/inspect/commands/InspectGgufCommand.js.map +1 -0
  179. package/dist/cli/commands/inspect/commands/InspectGpuCommand.d.ts +4 -0
  180. package/dist/cli/commands/inspect/commands/InspectGpuCommand.js +202 -0
  181. package/dist/cli/commands/inspect/commands/InspectGpuCommand.js.map +1 -0
  182. package/dist/cli/commands/inspect/commands/InspectMeasureCommand.d.ts +18 -0
  183. package/dist/cli/commands/inspect/commands/InspectMeasureCommand.js +629 -0
  184. package/dist/cli/commands/inspect/commands/InspectMeasureCommand.js.map +1 -0
  185. package/dist/cli/commands/source/SourceCommand.d.ts +4 -0
  186. package/dist/cli/commands/source/SourceCommand.js +19 -0
  187. package/dist/cli/commands/source/SourceCommand.js.map +1 -0
  188. package/dist/cli/commands/source/commands/BuildCommand.d.ts +16 -0
  189. package/dist/cli/commands/source/commands/BuildCommand.js +148 -0
  190. package/dist/cli/commands/source/commands/BuildCommand.js.map +1 -0
  191. package/dist/cli/commands/{ClearCommand.d.ts → source/commands/ClearCommand.d.ts} +1 -1
  192. package/dist/cli/commands/{ClearCommand.js → source/commands/ClearCommand.js} +11 -10
  193. package/dist/cli/commands/source/commands/ClearCommand.js.map +1 -0
  194. package/dist/cli/commands/{DownloadCommand.d.ts → source/commands/DownloadCommand.d.ts} +5 -4
  195. package/dist/cli/commands/source/commands/DownloadCommand.js +217 -0
  196. package/dist/cli/commands/source/commands/DownloadCommand.js.map +1 -0
  197. package/dist/cli/projectTemplates.d.ts +7 -0
  198. package/dist/cli/projectTemplates.js +10 -0
  199. package/dist/cli/projectTemplates.js.map +1 -0
  200. package/dist/cli/recommendedModels.d.ts +2 -0
  201. package/dist/cli/recommendedModels.js +585 -0
  202. package/dist/cli/recommendedModels.js.map +1 -0
  203. package/dist/cli/startCreateCli.d.ts +2 -0
  204. package/dist/cli/startCreateCli.js +26 -0
  205. package/dist/cli/startCreateCli.js.map +1 -0
  206. package/dist/cli/utils/ConsoleInteraction.d.ts +22 -0
  207. package/dist/cli/utils/ConsoleInteraction.js +122 -0
  208. package/dist/cli/utils/ConsoleInteraction.js.map +1 -0
  209. package/dist/cli/utils/ConsoleTable.d.ts +23 -0
  210. package/dist/cli/utils/ConsoleTable.js +86 -0
  211. package/dist/cli/utils/ConsoleTable.js.map +1 -0
  212. package/dist/cli/utils/basicChooseFromListConsoleInteraction.d.ts +13 -0
  213. package/dist/cli/utils/basicChooseFromListConsoleInteraction.js +111 -0
  214. package/dist/cli/utils/basicChooseFromListConsoleInteraction.js.map +1 -0
  215. package/dist/cli/utils/consolePromptQuestion.d.ts +6 -0
  216. package/dist/cli/utils/consolePromptQuestion.js +82 -0
  217. package/dist/cli/utils/consolePromptQuestion.js.map +1 -0
  218. package/dist/cli/utils/getReadablePath.d.ts +1 -0
  219. package/dist/cli/utils/getReadablePath.js +14 -0
  220. package/dist/cli/utils/getReadablePath.js.map +1 -0
  221. package/dist/cli/utils/interactivelyAskForModel.d.ts +8 -0
  222. package/dist/cli/utils/interactivelyAskForModel.js +450 -0
  223. package/dist/cli/utils/interactivelyAskForModel.js.map +1 -0
  224. package/dist/cli/utils/logUsedGpuTypeOption.d.ts +2 -0
  225. package/dist/cli/utils/logUsedGpuTypeOption.js +9 -0
  226. package/dist/cli/utils/logUsedGpuTypeOption.js.map +1 -0
  227. package/dist/cli/utils/printCommonInfoLines.d.ts +9 -0
  228. package/dist/cli/utils/printCommonInfoLines.js +82 -0
  229. package/dist/cli/utils/printCommonInfoLines.js.map +1 -0
  230. package/dist/cli/utils/printInfoLine.d.ts +12 -0
  231. package/dist/cli/utils/printInfoLine.js +54 -0
  232. package/dist/cli/utils/printInfoLine.js.map +1 -0
  233. package/dist/cli/utils/projectTemplates.d.ts +19 -0
  234. package/dist/cli/utils/projectTemplates.js +47 -0
  235. package/dist/cli/utils/projectTemplates.js.map +1 -0
  236. package/dist/cli/utils/renderModelCompatibilityPercentageWithColors.d.ts +6 -0
  237. package/dist/cli/utils/renderModelCompatibilityPercentageWithColors.js +14 -0
  238. package/dist/cli/utils/renderModelCompatibilityPercentageWithColors.js.map +1 -0
  239. package/dist/cli/utils/resolveCommandGgufPath.d.ts +5 -0
  240. package/dist/cli/utils/resolveCommandGgufPath.js +72 -0
  241. package/dist/cli/utils/resolveCommandGgufPath.js.map +1 -0
  242. package/dist/cli/utils/resolveHeaderFlag.d.ts +1 -0
  243. package/dist/cli/utils/resolveHeaderFlag.js +21 -0
  244. package/dist/cli/utils/resolveHeaderFlag.js.map +1 -0
  245. package/dist/cli/utils/resolveModelRecommendationFileOptions.d.ts +19 -0
  246. package/dist/cli/utils/resolveModelRecommendationFileOptions.js +7 -0
  247. package/dist/cli/utils/resolveModelRecommendationFileOptions.js.map +1 -0
  248. package/dist/cli/utils/splitAnsiToLines.d.ts +1 -0
  249. package/dist/cli/utils/splitAnsiToLines.js +32 -0
  250. package/dist/cli/utils/splitAnsiToLines.js.map +1 -0
  251. package/dist/cli/utils/withCliCommandDescriptionDocsUrl.d.ts +2 -0
  252. package/dist/cli/utils/withCliCommandDescriptionDocsUrl.js +23 -0
  253. package/dist/cli/utils/withCliCommandDescriptionDocsUrl.js.map +1 -0
  254. package/dist/commands.d.ts +4 -3
  255. package/dist/commands.js +6 -3
  256. package/dist/commands.js.map +1 -1
  257. package/dist/config.d.ts +35 -4
  258. package/dist/config.js +58 -17
  259. package/dist/config.js.map +1 -1
  260. package/dist/consts.d.ts +4 -0
  261. package/dist/consts.js +11 -0
  262. package/dist/consts.js.map +1 -0
  263. package/dist/evaluator/LlamaChat/LlamaChat.d.ts +151 -41
  264. package/dist/evaluator/LlamaChat/LlamaChat.js +1289 -437
  265. package/dist/evaluator/LlamaChat/LlamaChat.js.map +1 -1
  266. package/dist/evaluator/LlamaChat/utils/FunctionCallNameGrammar.d.ts +11 -0
  267. package/dist/evaluator/LlamaChat/utils/FunctionCallNameGrammar.js +55 -0
  268. package/dist/evaluator/LlamaChat/utils/FunctionCallNameGrammar.js.map +1 -0
  269. package/dist/evaluator/LlamaChat/utils/FunctionCallParamsGrammar.d.ts +16 -0
  270. package/dist/evaluator/LlamaChat/utils/FunctionCallParamsGrammar.js +45 -0
  271. package/dist/evaluator/LlamaChat/utils/FunctionCallParamsGrammar.js.map +1 -0
  272. package/dist/evaluator/LlamaChat/utils/LlamaFunctionCallValidationError.d.ts +8 -0
  273. package/dist/evaluator/LlamaChat/utils/LlamaFunctionCallValidationError.js +12 -0
  274. package/dist/evaluator/LlamaChat/utils/LlamaFunctionCallValidationError.js.map +1 -0
  275. package/dist/evaluator/LlamaChat/utils/contextShiftStrategies/eraseFirstResponseAndKeepFirstSystemChatContextShiftStrategy.js +27 -17
  276. package/dist/evaluator/LlamaChat/utils/contextShiftStrategies/eraseFirstResponseAndKeepFirstSystemChatContextShiftStrategy.js.map +1 -1
  277. package/dist/evaluator/LlamaChatSession/LlamaChatSession.d.ts +187 -13
  278. package/dist/evaluator/LlamaChatSession/LlamaChatSession.js +280 -53
  279. package/dist/evaluator/LlamaChatSession/LlamaChatSession.js.map +1 -1
  280. package/dist/evaluator/LlamaChatSession/utils/LlamaChatSessionPromptCompletionEngine.d.ts +40 -0
  281. package/dist/evaluator/LlamaChatSession/utils/LlamaChatSessionPromptCompletionEngine.js +186 -0
  282. package/dist/evaluator/LlamaChatSession/utils/LlamaChatSessionPromptCompletionEngine.js.map +1 -0
  283. package/dist/evaluator/LlamaChatSession/utils/defineChatSessionFunction.d.ts +10 -2
  284. package/dist/evaluator/LlamaChatSession/utils/defineChatSessionFunction.js +8 -0
  285. package/dist/evaluator/LlamaChatSession/utils/defineChatSessionFunction.js.map +1 -1
  286. package/dist/evaluator/LlamaCompletion.d.ts +168 -0
  287. package/dist/evaluator/LlamaCompletion.js +470 -0
  288. package/dist/evaluator/LlamaCompletion.js.map +1 -0
  289. package/dist/evaluator/LlamaContext/LlamaContext.d.ts +63 -22
  290. package/dist/evaluator/LlamaContext/LlamaContext.js +503 -121
  291. package/dist/evaluator/LlamaContext/LlamaContext.js.map +1 -1
  292. package/dist/evaluator/LlamaContext/LlamaSampler.d.ts +1 -0
  293. package/dist/evaluator/LlamaContext/LlamaSampler.js +31 -0
  294. package/dist/evaluator/LlamaContext/LlamaSampler.js.map +1 -0
  295. package/dist/evaluator/LlamaContext/types.d.ts +177 -16
  296. package/dist/evaluator/LlamaContext/utils/batchItemsPrioritizationStrategies/firstInFirstOutStrategy.js.map +1 -0
  297. package/dist/evaluator/LlamaContext/utils/batchItemsPrioritizationStrategies/maximumParallelismStrategy.js.map +1 -0
  298. package/dist/evaluator/LlamaContext/utils/resolveBatchItemsPrioritizationStrategy.d.ts +2 -0
  299. package/dist/evaluator/LlamaContext/utils/{resolveBatchItemsPrioritizingStrategy.js → resolveBatchItemsPrioritizationStrategy.js} +5 -5
  300. package/dist/evaluator/LlamaContext/utils/resolveBatchItemsPrioritizationStrategy.js.map +1 -0
  301. package/dist/evaluator/LlamaEmbedding.d.ts +21 -0
  302. package/dist/evaluator/LlamaEmbedding.js +53 -0
  303. package/dist/evaluator/LlamaEmbedding.js.map +1 -0
  304. package/dist/evaluator/LlamaEmbeddingContext.d.ts +29 -19
  305. package/dist/evaluator/LlamaEmbeddingContext.js +36 -43
  306. package/dist/evaluator/LlamaEmbeddingContext.js.map +1 -1
  307. package/dist/evaluator/LlamaGrammar.d.ts +16 -13
  308. package/dist/evaluator/LlamaGrammar.js +17 -10
  309. package/dist/evaluator/LlamaGrammar.js.map +1 -1
  310. package/dist/evaluator/LlamaGrammarEvaluationState.d.ts +7 -3
  311. package/dist/evaluator/LlamaGrammarEvaluationState.js +8 -4
  312. package/dist/evaluator/LlamaGrammarEvaluationState.js.map +1 -1
  313. package/dist/evaluator/LlamaJsonSchemaGrammar.d.ts +3 -0
  314. package/dist/evaluator/LlamaJsonSchemaGrammar.js +5 -3
  315. package/dist/evaluator/LlamaJsonSchemaGrammar.js.map +1 -1
  316. package/dist/evaluator/LlamaModel/LlamaModel.d.ts +255 -0
  317. package/dist/evaluator/LlamaModel/LlamaModel.js +780 -0
  318. package/dist/evaluator/LlamaModel/LlamaModel.js.map +1 -0
  319. package/dist/evaluator/LlamaModel/utils/TokenAttributes.d.ts +29 -0
  320. package/dist/evaluator/LlamaModel/utils/TokenAttributes.js +65 -0
  321. package/dist/evaluator/LlamaModel/utils/TokenAttributes.js.map +1 -0
  322. package/dist/evaluator/TokenBias.d.ts +34 -0
  323. package/dist/evaluator/TokenBias.js +65 -0
  324. package/dist/evaluator/TokenBias.js.map +1 -0
  325. package/dist/evaluator/TokenMeter.d.ts +45 -0
  326. package/dist/evaluator/TokenMeter.js +74 -0
  327. package/dist/evaluator/TokenMeter.js.map +1 -0
  328. package/dist/gguf/consts.d.ts +4 -0
  329. package/dist/gguf/consts.js +12 -0
  330. package/dist/gguf/consts.js.map +1 -0
  331. package/dist/gguf/errors/InvalidGgufMagicError.d.ts +3 -0
  332. package/dist/gguf/errors/InvalidGgufMagicError.js +6 -0
  333. package/dist/gguf/errors/InvalidGgufMagicError.js.map +1 -0
  334. package/dist/gguf/errors/UnsupportedGgufValueTypeError.d.ts +4 -0
  335. package/dist/gguf/errors/UnsupportedGgufValueTypeError.js +9 -0
  336. package/dist/gguf/errors/UnsupportedGgufValueTypeError.js.map +1 -0
  337. package/dist/gguf/fileReaders/GgufFileReader.d.ts +36 -0
  338. package/dist/gguf/fileReaders/GgufFileReader.js +109 -0
  339. package/dist/gguf/fileReaders/GgufFileReader.js.map +1 -0
  340. package/dist/gguf/fileReaders/GgufFsFileReader.d.ts +16 -0
  341. package/dist/gguf/fileReaders/GgufFsFileReader.js +62 -0
  342. package/dist/gguf/fileReaders/GgufFsFileReader.js.map +1 -0
  343. package/dist/gguf/fileReaders/GgufNetworkFetchFileReader.d.ts +25 -0
  344. package/dist/gguf/fileReaders/GgufNetworkFetchFileReader.js +92 -0
  345. package/dist/gguf/fileReaders/GgufNetworkFetchFileReader.js.map +1 -0
  346. package/dist/gguf/insights/GgufInsights.d.ts +50 -0
  347. package/dist/gguf/insights/GgufInsights.js +401 -0
  348. package/dist/gguf/insights/GgufInsights.js.map +1 -0
  349. package/dist/gguf/insights/GgufInsightsConfigurationResolver.d.ts +146 -0
  350. package/dist/gguf/insights/GgufInsightsConfigurationResolver.js +226 -0
  351. package/dist/gguf/insights/GgufInsightsConfigurationResolver.js.map +1 -0
  352. package/dist/gguf/insights/utils/resolveContextContextSizeOption.d.ts +19 -0
  353. package/dist/gguf/insights/utils/resolveContextContextSizeOption.js +78 -0
  354. package/dist/gguf/insights/utils/resolveContextContextSizeOption.js.map +1 -0
  355. package/dist/gguf/insights/utils/resolveModelGpuLayersOption.d.ts +15 -0
  356. package/dist/gguf/insights/utils/resolveModelGpuLayersOption.js +183 -0
  357. package/dist/gguf/insights/utils/resolveModelGpuLayersOption.js.map +1 -0
  358. package/dist/gguf/insights/utils/scoreLevels.d.ts +5 -0
  359. package/dist/gguf/insights/utils/scoreLevels.js +16 -0
  360. package/dist/gguf/insights/utils/scoreLevels.js.map +1 -0
  361. package/dist/gguf/parser/GgufV2Parser.d.ts +20 -0
  362. package/dist/gguf/parser/GgufV2Parser.js +156 -0
  363. package/dist/gguf/parser/GgufV2Parser.js.map +1 -0
  364. package/dist/gguf/parser/GgufV3Parser.d.ts +3 -0
  365. package/dist/gguf/parser/GgufV3Parser.js +4 -0
  366. package/dist/gguf/parser/GgufV3Parser.js.map +1 -0
  367. package/dist/gguf/parser/parseGguf.d.ts +8 -0
  368. package/dist/gguf/parser/parseGguf.js +61 -0
  369. package/dist/gguf/parser/parseGguf.js.map +1 -0
  370. package/dist/gguf/readGgufFileInfo.d.ts +45 -0
  371. package/dist/gguf/readGgufFileInfo.js +71 -0
  372. package/dist/gguf/readGgufFileInfo.js.map +1 -0
  373. package/dist/gguf/types/GgufFileInfoTypes.d.ts +84 -0
  374. package/dist/gguf/types/GgufFileInfoTypes.js +18 -0
  375. package/dist/gguf/types/GgufFileInfoTypes.js.map +1 -0
  376. package/dist/gguf/types/GgufMetadataTypes.d.ts +372 -0
  377. package/dist/gguf/types/GgufMetadataTypes.js +114 -0
  378. package/dist/gguf/types/GgufMetadataTypes.js.map +1 -0
  379. package/dist/gguf/types/GgufTensorInfoTypes.d.ts +37 -0
  380. package/dist/gguf/types/GgufTensorInfoTypes.js +33 -0
  381. package/dist/gguf/types/GgufTensorInfoTypes.js.map +1 -0
  382. package/dist/gguf/utils/GgufReadOffset.d.ts +6 -0
  383. package/dist/gguf/utils/GgufReadOffset.js +18 -0
  384. package/dist/gguf/utils/GgufReadOffset.js.map +1 -0
  385. package/dist/gguf/utils/convertMetadataKeyValueRecordToNestedObject.d.ts +6 -0
  386. package/dist/gguf/utils/convertMetadataKeyValueRecordToNestedObject.js +76 -0
  387. package/dist/gguf/utils/convertMetadataKeyValueRecordToNestedObject.js.map +1 -0
  388. package/dist/gguf/utils/getGgufFileTypeName.d.ts +4 -0
  389. package/dist/gguf/utils/getGgufFileTypeName.js +13 -0
  390. package/dist/gguf/utils/getGgufFileTypeName.js.map +1 -0
  391. package/dist/gguf/utils/getGgufMetadataArchitectureData.d.ts +3 -0
  392. package/dist/gguf/utils/getGgufMetadataArchitectureData.js +4 -0
  393. package/dist/gguf/utils/getGgufMetadataArchitectureData.js.map +1 -0
  394. package/dist/gguf/utils/normalizeGgufDownloadUrl.d.ts +1 -0
  395. package/dist/gguf/utils/normalizeGgufDownloadUrl.js +16 -0
  396. package/dist/gguf/utils/normalizeGgufDownloadUrl.js.map +1 -0
  397. package/dist/gguf/utils/resolveBinarySplitGgufPartUrls.d.ts +2 -0
  398. package/dist/gguf/utils/resolveBinarySplitGgufPartUrls.js +39 -0
  399. package/dist/gguf/utils/resolveBinarySplitGgufPartUrls.js.map +1 -0
  400. package/dist/gguf/utils/resolveSplitGgufParts.d.ts +7 -0
  401. package/dist/gguf/utils/resolveSplitGgufParts.js +55 -0
  402. package/dist/gguf/utils/resolveSplitGgufParts.js.map +1 -0
  403. package/dist/index.d.ts +39 -14
  404. package/dist/index.js +29 -8
  405. package/dist/index.js.map +1 -1
  406. package/dist/state.d.ts +2 -0
  407. package/dist/state.js +7 -0
  408. package/dist/state.js.map +1 -1
  409. package/dist/tsconfig.tsbuildinfo +1 -0
  410. package/dist/types.d.ts +131 -5
  411. package/dist/types.js.map +1 -1
  412. package/dist/utils/DisposeGuard.d.ts +13 -0
  413. package/dist/utils/DisposeGuard.js +120 -0
  414. package/dist/utils/DisposeGuard.js.map +1 -0
  415. package/dist/utils/InsufficientMemoryError.d.ts +3 -0
  416. package/dist/utils/InsufficientMemoryError.js +6 -0
  417. package/dist/utils/InsufficientMemoryError.js.map +1 -0
  418. package/dist/utils/LlamaText.d.ts +73 -26
  419. package/dist/utils/LlamaText.js +475 -157
  420. package/dist/utils/LlamaText.js.map +1 -1
  421. package/dist/utils/LruCache.d.ts +12 -0
  422. package/dist/utils/LruCache.js +44 -0
  423. package/dist/utils/LruCache.js.map +1 -0
  424. package/dist/utils/OverridesObject.d.ts +7 -0
  425. package/dist/utils/OverridesObject.js +2 -0
  426. package/dist/utils/OverridesObject.js.map +1 -0
  427. package/dist/utils/ReplHistory.js +5 -1
  428. package/dist/utils/ReplHistory.js.map +1 -1
  429. package/dist/utils/StopGenerationDetector.d.ts +27 -8
  430. package/dist/utils/StopGenerationDetector.js +108 -22
  431. package/dist/utils/StopGenerationDetector.js.map +1 -1
  432. package/dist/utils/ThreadsSplitter.d.ts +32 -0
  433. package/dist/utils/ThreadsSplitter.js +177 -0
  434. package/dist/utils/ThreadsSplitter.js.map +1 -0
  435. package/dist/utils/TokenStreamRegulator.d.ts +10 -4
  436. package/dist/utils/TokenStreamRegulator.js +102 -10
  437. package/dist/utils/TokenStreamRegulator.js.map +1 -1
  438. package/dist/utils/UnsupportedError.d.ts +2 -0
  439. package/dist/utils/UnsupportedError.js +7 -0
  440. package/dist/utils/UnsupportedError.js.map +1 -0
  441. package/dist/utils/appendUserMessageToChatHistory.d.ts +4 -0
  442. package/dist/utils/appendUserMessageToChatHistory.js +4 -0
  443. package/dist/utils/appendUserMessageToChatHistory.js.map +1 -1
  444. package/dist/utils/clearTempFolder.js.map +1 -1
  445. package/dist/utils/cmake.js +23 -10
  446. package/dist/utils/cmake.js.map +1 -1
  447. package/dist/utils/compareTokens.d.ts +1 -1
  448. package/dist/utils/compareTokens.js.map +1 -1
  449. package/dist/utils/createModelDownloader.d.ts +199 -0
  450. package/dist/utils/createModelDownloader.js +405 -0
  451. package/dist/utils/createModelDownloader.js.map +1 -0
  452. package/dist/utils/findBestOption.d.ts +4 -0
  453. package/dist/utils/findBestOption.js +15 -0
  454. package/dist/utils/findBestOption.js.map +1 -0
  455. package/dist/utils/findCharacterRemovalCountToFitChatHistoryInContext.d.ts +1 -0
  456. package/dist/utils/findCharacterRemovalCountToFitChatHistoryInContext.js +23 -12
  457. package/dist/utils/findCharacterRemovalCountToFitChatHistoryInContext.js.map +1 -1
  458. package/dist/utils/gbnfJson/GbnfGrammarGenerator.js.map +1 -1
  459. package/dist/utils/gbnfJson/getGbnfGrammarForGbnfJsonSchema.d.ts +5 -0
  460. package/dist/utils/gbnfJson/getGbnfGrammarForGbnfJsonSchema.js +11 -0
  461. package/dist/utils/gbnfJson/getGbnfGrammarForGbnfJsonSchema.js.map +1 -0
  462. package/dist/utils/gbnfJson/terminals/GbnfArray.d.ts +3 -1
  463. package/dist/utils/gbnfJson/terminals/GbnfArray.js +10 -5
  464. package/dist/utils/gbnfJson/terminals/GbnfArray.js.map +1 -1
  465. package/dist/utils/gbnfJson/terminals/GbnfBoolean.d.ts +1 -1
  466. package/dist/utils/gbnfJson/terminals/GbnfBoolean.js.map +1 -1
  467. package/dist/utils/gbnfJson/terminals/GbnfBooleanValue.js.map +1 -1
  468. package/dist/utils/gbnfJson/terminals/GbnfGrammar.js.map +1 -1
  469. package/dist/utils/gbnfJson/terminals/GbnfNull.d.ts +1 -1
  470. package/dist/utils/gbnfJson/terminals/GbnfNull.js.map +1 -1
  471. package/dist/utils/gbnfJson/terminals/GbnfNumber.d.ts +1 -1
  472. package/dist/utils/gbnfJson/terminals/GbnfNumber.js.map +1 -1
  473. package/dist/utils/gbnfJson/terminals/GbnfNumberValue.js.map +1 -1
  474. package/dist/utils/gbnfJson/terminals/GbnfObjectMap.d.ts +3 -1
  475. package/dist/utils/gbnfJson/terminals/GbnfObjectMap.js +9 -4
  476. package/dist/utils/gbnfJson/terminals/GbnfObjectMap.js.map +1 -1
  477. package/dist/utils/gbnfJson/terminals/GbnfOr.js.map +1 -1
  478. package/dist/utils/gbnfJson/terminals/GbnfRepetition.d.ts +9 -0
  479. package/dist/utils/gbnfJson/terminals/GbnfRepetition.js +37 -0
  480. package/dist/utils/gbnfJson/terminals/GbnfRepetition.js.map +1 -0
  481. package/dist/utils/gbnfJson/terminals/GbnfString.d.ts +1 -1
  482. package/dist/utils/gbnfJson/terminals/GbnfString.js +23 -5
  483. package/dist/utils/gbnfJson/terminals/GbnfString.js.map +1 -1
  484. package/dist/utils/gbnfJson/terminals/GbnfStringValue.js.map +1 -1
  485. package/dist/utils/gbnfJson/terminals/GbnfVerbatimText.js.map +1 -1
  486. package/dist/utils/gbnfJson/terminals/GbnfWhitespace.d.ts +7 -4
  487. package/dist/utils/gbnfJson/terminals/GbnfWhitespace.js +37 -9
  488. package/dist/utils/gbnfJson/terminals/GbnfWhitespace.js.map +1 -1
  489. package/dist/utils/gbnfJson/terminals/gbnfConsts.d.ts +5 -4
  490. package/dist/utils/gbnfJson/terminals/gbnfConsts.js +14 -3
  491. package/dist/utils/gbnfJson/terminals/gbnfConsts.js.map +1 -1
  492. package/dist/utils/gbnfJson/types.d.ts +3 -0
  493. package/dist/utils/gbnfJson/types.js.map +1 -1
  494. package/dist/utils/gbnfJson/utils/GbnfJsonScopeState.d.ts +10 -0
  495. package/dist/utils/gbnfJson/utils/GbnfJsonScopeState.js +15 -0
  496. package/dist/utils/gbnfJson/utils/GbnfJsonScopeState.js.map +1 -0
  497. package/dist/utils/gbnfJson/utils/getGbnfJsonTerminalForGbnfJsonSchema.d.ts +2 -1
  498. package/dist/utils/gbnfJson/utils/getGbnfJsonTerminalForGbnfJsonSchema.js +6 -5
  499. package/dist/utils/gbnfJson/utils/getGbnfJsonTerminalForGbnfJsonSchema.js.map +1 -1
  500. package/dist/utils/gbnfJson/utils/validateObjectAgainstGbnfSchema.js +3 -3
  501. package/dist/utils/gbnfJson/utils/validateObjectAgainstGbnfSchema.js.map +1 -1
  502. package/dist/utils/getBuildDefaults.d.ts +1 -2
  503. package/dist/utils/getBuildDefaults.js +2 -3
  504. package/dist/utils/getBuildDefaults.js.map +1 -1
  505. package/dist/utils/getConsoleLogPrefix.d.ts +1 -1
  506. package/dist/utils/getConsoleLogPrefix.js +5 -4
  507. package/dist/utils/getConsoleLogPrefix.js.map +1 -1
  508. package/dist/utils/getGrammarsFolder.js +1 -1
  509. package/dist/utils/getGrammarsFolder.js.map +1 -1
  510. package/dist/utils/getQueuedTokensBeforeStopTrigger.d.ts +6 -0
  511. package/dist/utils/getQueuedTokensBeforeStopTrigger.js +22 -0
  512. package/dist/utils/getQueuedTokensBeforeStopTrigger.js.map +1 -0
  513. package/dist/utils/getReadableContextSize.d.ts +1 -0
  514. package/dist/utils/getReadableContextSize.js +7 -0
  515. package/dist/utils/getReadableContextSize.js.map +1 -0
  516. package/dist/utils/getTypeScriptTypeStringForGbnfJsonSchema.js +15 -11
  517. package/dist/utils/getTypeScriptTypeStringForGbnfJsonSchema.js.map +1 -1
  518. package/dist/utils/gitReleaseBundles.js +68 -1
  519. package/dist/utils/gitReleaseBundles.js.map +1 -1
  520. package/dist/utils/isToken.d.ts +2 -0
  521. package/dist/utils/isToken.js +4 -0
  522. package/dist/utils/isToken.js.map +1 -0
  523. package/dist/utils/isUrl.d.ts +1 -0
  524. package/dist/utils/isUrl.js +15 -0
  525. package/dist/utils/isUrl.js.map +1 -0
  526. package/dist/utils/mergeUnionTypes.d.ts +10 -0
  527. package/dist/utils/mergeUnionTypes.js +2 -0
  528. package/dist/utils/mergeUnionTypes.js.map +1 -0
  529. package/dist/utils/modelFileAccesTokens.d.ts +4 -0
  530. package/dist/utils/modelFileAccesTokens.js +40 -0
  531. package/dist/utils/modelFileAccesTokens.js.map +1 -0
  532. package/dist/utils/parseModelFileName.d.ts +1 -0
  533. package/dist/utils/parseModelFileName.js +6 -1
  534. package/dist/utils/parseModelFileName.js.map +1 -1
  535. package/dist/utils/parseTextTemplate.d.ts +66 -0
  536. package/dist/utils/parseTextTemplate.js +116 -0
  537. package/dist/utils/parseTextTemplate.js.map +1 -0
  538. package/dist/utils/prettyPrintObject.d.ts +10 -1
  539. package/dist/utils/prettyPrintObject.js +61 -15
  540. package/dist/utils/prettyPrintObject.js.map +1 -1
  541. package/dist/utils/pushAll.d.ts +6 -0
  542. package/dist/utils/pushAll.js +11 -0
  543. package/dist/utils/pushAll.js.map +1 -0
  544. package/dist/utils/removeNullFields.d.ts +2 -2
  545. package/dist/utils/removeNullFields.js.map +1 -1
  546. package/dist/utils/resolveGithubRelease.d.ts +2 -2
  547. package/dist/utils/resolveGithubRelease.js.map +1 -1
  548. package/dist/utils/resolveLastTokens.d.ts +2 -0
  549. package/dist/utils/resolveLastTokens.js +12 -0
  550. package/dist/utils/resolveLastTokens.js.map +1 -0
  551. package/dist/utils/runtime.d.ts +4 -0
  552. package/dist/utils/runtime.js +8 -0
  553. package/dist/utils/runtime.js.map +1 -0
  554. package/dist/utils/safeEventCallback.d.ts +6 -0
  555. package/dist/utils/safeEventCallback.js +29 -0
  556. package/dist/utils/safeEventCallback.js.map +1 -0
  557. package/dist/utils/spawnCommand.d.ts +11 -2
  558. package/dist/utils/spawnCommand.js +55 -7
  559. package/dist/utils/spawnCommand.js.map +1 -1
  560. package/dist/utils/tokenizeInput.d.ts +1 -1
  561. package/dist/utils/tokenizeInput.js +6 -3
  562. package/dist/utils/tokenizeInput.js.map +1 -1
  563. package/dist/utils/transformPromisable.d.ts +40 -0
  564. package/dist/utils/transformPromisable.js +64 -0
  565. package/dist/utils/transformPromisable.js.map +1 -0
  566. package/dist/utils/truncateTextAndRoundToWords.d.ts +2 -0
  567. package/dist/utils/truncateTextAndRoundToWords.js +32 -0
  568. package/dist/utils/truncateTextAndRoundToWords.js.map +1 -1
  569. package/dist/utils/utilTypes.d.ts +3 -0
  570. package/dist/utils/utilTypes.js +2 -0
  571. package/dist/utils/utilTypes.js.map +1 -0
  572. package/dist/utils/waitForLockfileRelease.js.map +1 -1
  573. package/dist/utils/withLockfile.js.map +1 -1
  574. package/dist/utils/withOra.d.ts +2 -0
  575. package/dist/utils/withOra.js +22 -6
  576. package/dist/utils/withOra.js.map +1 -1
  577. package/dist/utils/withProgressLog.d.ts +22 -0
  578. package/dist/utils/withProgressLog.js +211 -0
  579. package/dist/utils/withProgressLog.js.map +1 -0
  580. package/dist/utils/withStatusLogs.js +1 -1
  581. package/dist/utils/withStatusLogs.js.map +1 -1
  582. package/dist/utils/wrapAbortSignal.d.ts +1 -0
  583. package/dist/utils/wrapAbortSignal.js +9 -0
  584. package/dist/utils/wrapAbortSignal.js.map +1 -0
  585. package/llama/.clang-format +1 -2
  586. package/llama/CMakeLists.txt +134 -5
  587. package/llama/addon/AddonContext.cpp +629 -0
  588. package/llama/addon/AddonContext.h +52 -0
  589. package/llama/addon/AddonGrammar.cpp +39 -0
  590. package/llama/addon/AddonGrammar.h +19 -0
  591. package/llama/addon/AddonGrammarEvaluationState.cpp +25 -0
  592. package/llama/addon/AddonGrammarEvaluationState.h +17 -0
  593. package/llama/addon/AddonModel.cpp +672 -0
  594. package/llama/addon/AddonModel.h +61 -0
  595. package/llama/addon/AddonModelData.cpp +25 -0
  596. package/llama/addon/AddonModelData.h +15 -0
  597. package/llama/addon/AddonModelLora.cpp +105 -0
  598. package/llama/addon/AddonModelLora.h +28 -0
  599. package/llama/addon/AddonSampler.cpp +513 -0
  600. package/llama/addon/AddonSampler.h +65 -0
  601. package/llama/addon/RingBuffer.h +109 -0
  602. package/llama/addon/addon.cpp +223 -0
  603. package/llama/addon/addonGlobals.cpp +22 -0
  604. package/llama/addon/addonGlobals.h +12 -0
  605. package/llama/addon/globals/addonLog.cpp +136 -0
  606. package/llama/addon/globals/addonLog.h +21 -0
  607. package/llama/addon/globals/addonProgress.cpp +15 -0
  608. package/llama/addon/globals/addonProgress.h +15 -0
  609. package/llama/addon/globals/getGpuInfo.cpp +108 -0
  610. package/llama/addon/globals/getGpuInfo.h +6 -0
  611. package/llama/binariesGithubRelease.json +1 -1
  612. package/llama/gitRelease.bundle +0 -0
  613. package/llama/gpuInfo/cuda-gpu-info.cu +120 -0
  614. package/llama/gpuInfo/cuda-gpu-info.h +10 -0
  615. package/llama/gpuInfo/metal-gpu-info.h +8 -0
  616. package/llama/gpuInfo/metal-gpu-info.mm +30 -0
  617. package/llama/gpuInfo/vulkan-gpu-info.cpp +83 -0
  618. package/llama/gpuInfo/vulkan-gpu-info.h +9 -0
  619. package/llama/grammars/README.md +297 -6
  620. package/llama/grammars/json.gbnf +4 -4
  621. package/llama/grammars/json_arr.gbnf +4 -4
  622. package/llama/llama.cpp.info.json +1 -1
  623. package/llama/toolchains/win32.host-x64.target-arm64.cmake +41 -0
  624. package/package.json +109 -59
  625. package/templates/packed/electron-typescript-react.json +1 -0
  626. package/templates/packed/node-typescript.json +1 -0
  627. package/dist/AbortError.d.ts +0 -2
  628. package/dist/AbortError.js +0 -7
  629. package/dist/AbortError.js.map +0 -1
  630. package/dist/chatWrappers/LlamaChatWrapper.d.ts +0 -13
  631. package/dist/chatWrappers/LlamaChatWrapper.js.map +0 -1
  632. package/dist/chatWrappers/resolveChatWrapperBasedOnModel.d.ts +0 -13
  633. package/dist/chatWrappers/resolveChatWrapperBasedOnModel.js +0 -57
  634. package/dist/chatWrappers/resolveChatWrapperBasedOnModel.js.map +0 -1
  635. package/dist/cli/commands/BuildCommand.d.ts +0 -11
  636. package/dist/cli/commands/BuildCommand.js +0 -106
  637. package/dist/cli/commands/BuildCommand.js.map +0 -1
  638. package/dist/cli/commands/ClearCommand.js.map +0 -1
  639. package/dist/cli/commands/DownloadCommand.js +0 -169
  640. package/dist/cli/commands/DownloadCommand.js.map +0 -1
  641. package/dist/evaluator/LlamaChat/utils/FunctionCallGrammar.d.ts +0 -22
  642. package/dist/evaluator/LlamaChat/utils/FunctionCallGrammar.js +0 -121
  643. package/dist/evaluator/LlamaChat/utils/FunctionCallGrammar.js.map +0 -1
  644. package/dist/evaluator/LlamaContext/utils/batchItemsPrioritizingStrategies/firstInFirstOutStrategy.js.map +0 -1
  645. package/dist/evaluator/LlamaContext/utils/batchItemsPrioritizingStrategies/maximumParallelismStrategy.js.map +0 -1
  646. package/dist/evaluator/LlamaContext/utils/resolveBatchItemsPrioritizingStrategy.d.ts +0 -2
  647. package/dist/evaluator/LlamaContext/utils/resolveBatchItemsPrioritizingStrategy.js.map +0 -1
  648. package/dist/evaluator/LlamaModel.d.ts +0 -120
  649. package/dist/evaluator/LlamaModel.js +0 -320
  650. package/dist/evaluator/LlamaModel.js.map +0 -1
  651. package/dist/utils/getGbnfGrammarForGbnfJsonSchema.d.ts +0 -2
  652. package/dist/utils/getGbnfGrammarForGbnfJsonSchema.js +0 -9
  653. package/dist/utils/getGbnfGrammarForGbnfJsonSchema.js.map +0 -1
  654. package/dist/utils/parseModelTypeDescription.d.ts +0 -6
  655. package/dist/utils/parseModelTypeDescription.js +0 -9
  656. package/dist/utils/parseModelTypeDescription.js.map +0 -1
  657. package/dist/utils/resolveChatWrapper.d.ts +0 -4
  658. package/dist/utils/resolveChatWrapper.js +0 -16
  659. package/dist/utils/resolveChatWrapper.js.map +0 -1
  660. package/llama/addon.cpp +0 -916
  661. package/llamaBins/linux-arm64/.buildMetadata.json +0 -1
  662. package/llamaBins/linux-arm64/llama-addon.node +0 -0
  663. package/llamaBins/linux-armv7l/.buildMetadata.json +0 -1
  664. package/llamaBins/linux-armv7l/llama-addon.node +0 -0
  665. package/llamaBins/linux-x64/.buildMetadata.json +0 -1
  666. package/llamaBins/linux-x64/llama-addon.node +0 -0
  667. package/llamaBins/linux-x64-cuda/.buildMetadata.json +0 -1
  668. package/llamaBins/linux-x64-cuda/llama-addon.node +0 -0
  669. package/llamaBins/mac-arm64-metal/.buildMetadata.json +0 -1
  670. package/llamaBins/mac-arm64-metal/ggml-metal.metal +0 -6119
  671. package/llamaBins/mac-arm64-metal/llama-addon.node +0 -0
  672. package/llamaBins/mac-x64/.buildMetadata.json +0 -1
  673. package/llamaBins/mac-x64/llama-addon.node +0 -0
  674. package/llamaBins/win-x64/.buildMetadata.json +0 -1
  675. package/llamaBins/win-x64/llama-addon.exp +0 -0
  676. package/llamaBins/win-x64/llama-addon.lib +0 -0
  677. package/llamaBins/win-x64/llama-addon.node +0 -0
  678. package/llamaBins/win-x64-cuda/.buildMetadata.json +0 -1
  679. package/llamaBins/win-x64-cuda/llama-addon.exp +0 -0
  680. package/llamaBins/win-x64-cuda/llama-addon.lib +0 -0
  681. package/llamaBins/win-x64-cuda/llama-addon.node +0 -0
  682. /package/dist/evaluator/LlamaContext/utils/{batchItemsPrioritizingStrategies → batchItemsPrioritizationStrategies}/firstInFirstOutStrategy.d.ts +0 -0
  683. /package/dist/evaluator/LlamaContext/utils/{batchItemsPrioritizingStrategies → batchItemsPrioritizationStrategies}/firstInFirstOutStrategy.js +0 -0
  684. /package/dist/evaluator/LlamaContext/utils/{batchItemsPrioritizingStrategies → batchItemsPrioritizationStrategies}/maximumParallelismStrategy.d.ts +0 -0
  685. /package/dist/evaluator/LlamaContext/utils/{batchItemsPrioritizingStrategies → batchItemsPrioritizationStrategies}/maximumParallelismStrategy.js +0 -0
package/llama/addon.cpp DELETED
@@ -1,916 +0,0 @@
1
- #include <stddef.h>
2
-
3
- #include <algorithm>
4
- #include <sstream>
5
- #include <vector>
6
-
7
- #include "common.h"
8
- #include "common/grammar-parser.h"
9
- #include "llama.h"
10
- #include "napi.h"
11
-
12
- Napi::FunctionReference loggerCallbackFunctionReference;
13
- Napi::ThreadSafeFunction threadSafeLoggerCallback;
14
- bool loggerCallbackSet = false;
15
- int addonLoggerLogLevel = 5;
16
-
17
- struct addon_logger_log {
18
- const int logLevelNumber;
19
- const std::stringstream* stringStream;
20
- };
21
-
22
- std::string addon_model_token_to_piece(const struct llama_model * model, llama_token token) {
23
- std::vector<char> result(8, 0);
24
- const int n_tokens = llama_token_to_piece(model, token, result.data(), result.size());
25
- if (n_tokens < 0) {
26
- result.resize(-n_tokens);
27
- int check = llama_token_to_piece(model, token, result.data(), result.size());
28
- GGML_ASSERT(check == -n_tokens);
29
- }
30
- else {
31
- result.resize(n_tokens);
32
- }
33
-
34
- return std::string(result.data(), result.size());
35
- }
36
-
37
- class AddonModel : public Napi::ObjectWrap<AddonModel> {
38
- public:
39
- llama_model_params model_params;
40
- llama_model* model;
41
- bool disposed = false;
42
-
43
- AddonModel(const Napi::CallbackInfo& info) : Napi::ObjectWrap<AddonModel>(info) {
44
- model_params = llama_model_default_params();
45
-
46
- // Get the model path
47
- std::string modelPath = info[0].As<Napi::String>().Utf8Value();
48
-
49
- if (info.Length() > 1 && info[1].IsObject()) {
50
- Napi::Object options = info[1].As<Napi::Object>();
51
-
52
- if (options.Has("gpuLayers")) {
53
- model_params.n_gpu_layers = options.Get("gpuLayers").As<Napi::Number>().Int32Value();
54
- }
55
-
56
- if (options.Has("vocabOnly")) {
57
- model_params.vocab_only = options.Get("vocabOnly").As<Napi::Boolean>().Value();
58
- }
59
-
60
- if (options.Has("useMmap")) {
61
- model_params.use_mmap = options.Get("useMmap").As<Napi::Boolean>().Value();
62
- }
63
-
64
- if (options.Has("useMlock")) {
65
- model_params.use_mlock = options.Get("useMlock").As<Napi::Boolean>().Value();
66
- }
67
- }
68
-
69
- llama_backend_init(false);
70
- model = llama_load_model_from_file(modelPath.c_str(), model_params);
71
-
72
- if (model == NULL) {
73
- Napi::Error::New(info.Env(), "Failed to load model").ThrowAsJavaScriptException();
74
- return;
75
- }
76
- }
77
-
78
- ~AddonModel() {
79
- dispose();
80
- }
81
-
82
- void dispose() {
83
- if (disposed) {
84
- return;
85
- }
86
-
87
- llama_free_model(model);
88
- disposed = true;
89
- }
90
-
91
- Napi::Value Dispose(const Napi::CallbackInfo& info) {
92
- if (disposed) {
93
- return info.Env().Undefined();
94
- }
95
-
96
- dispose();
97
-
98
- return info.Env().Undefined();
99
- }
100
-
101
- Napi::Value Tokenize(const Napi::CallbackInfo& info) {
102
- if (disposed) {
103
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
104
- return info.Env().Undefined();
105
- }
106
-
107
- std::string text = info[0].As<Napi::String>().Utf8Value();
108
- bool specialTokens = info[1].As<Napi::Boolean>().Value();
109
-
110
- std::vector<llama_token> tokens = llama_tokenize(model, text, false, specialTokens);
111
-
112
- Napi::Uint32Array result = Napi::Uint32Array::New(info.Env(), tokens.size());
113
- for (size_t i = 0; i < tokens.size(); ++i) {
114
- result[i] = static_cast<uint32_t>(tokens[i]);
115
- }
116
-
117
- return result;
118
- }
119
- Napi::Value Detokenize(const Napi::CallbackInfo& info) {
120
- if (disposed) {
121
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
122
- return info.Env().Undefined();
123
- }
124
-
125
- Napi::Uint32Array tokens = info[0].As<Napi::Uint32Array>();
126
-
127
- // Create a stringstream for accumulating the decoded string.
128
- std::stringstream ss;
129
-
130
- // Decode each token and accumulate the result.
131
- for (size_t i = 0; i < tokens.ElementLength(); i++) {
132
- const std::string piece = addon_model_token_to_piece(model, (llama_token)tokens[i]);
133
-
134
- if (piece.empty()) {
135
- continue;
136
- }
137
-
138
- ss << piece;
139
- }
140
-
141
- return Napi::String::New(info.Env(), ss.str());
142
- }
143
-
144
- Napi::Value GetTrainContextSize(const Napi::CallbackInfo& info) {
145
- if (disposed) {
146
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
147
- return info.Env().Undefined();
148
- }
149
-
150
- return Napi::Number::From(info.Env(), llama_n_ctx_train(model));
151
- }
152
-
153
- Napi::Value GetTotalSize(const Napi::CallbackInfo& info) {
154
- if (disposed) {
155
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
156
- return info.Env().Undefined();
157
- }
158
-
159
- return Napi::Number::From(info.Env(), llama_model_size(model));
160
- }
161
-
162
- Napi::Value GetTotalParameters(const Napi::CallbackInfo& info) {
163
- if (disposed) {
164
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
165
- return info.Env().Undefined();
166
- }
167
-
168
- return Napi::Number::From(info.Env(), llama_model_n_params(model));
169
- }
170
-
171
- Napi::Value GetModelDescription(const Napi::CallbackInfo& info) {
172
- if (disposed) {
173
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
174
- return info.Env().Undefined();
175
- }
176
-
177
- char model_desc[128];
178
- int actual_length = llama_model_desc(model, model_desc, sizeof(model_desc));
179
-
180
- return Napi::String::New(info.Env(), model_desc, actual_length);
181
- }
182
-
183
- Napi::Value TokenBos(const Napi::CallbackInfo& info) {
184
- if (disposed) {
185
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
186
- return info.Env().Undefined();
187
- }
188
-
189
- return Napi::Number::From(info.Env(), llama_token_bos(model));
190
- }
191
- Napi::Value TokenEos(const Napi::CallbackInfo& info) {
192
- if (disposed) {
193
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
194
- return info.Env().Undefined();
195
- }
196
-
197
- return Napi::Number::From(info.Env(), llama_token_eos(model));
198
- }
199
- Napi::Value TokenNl(const Napi::CallbackInfo& info) {
200
- if (disposed) {
201
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
202
- return info.Env().Undefined();
203
- }
204
-
205
- return Napi::Number::From(info.Env(), llama_token_nl(model));
206
- }
207
- Napi::Value PrefixToken(const Napi::CallbackInfo& info) {
208
- if (disposed) {
209
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
210
- return info.Env().Undefined();
211
- }
212
-
213
- return Napi::Number::From(info.Env(), llama_token_prefix(model));
214
- }
215
- Napi::Value MiddleToken(const Napi::CallbackInfo& info) {
216
- if (disposed) {
217
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
218
- return info.Env().Undefined();
219
- }
220
-
221
- return Napi::Number::From(info.Env(), llama_token_middle(model));
222
- }
223
- Napi::Value SuffixToken(const Napi::CallbackInfo& info) {
224
- if (disposed) {
225
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
226
- return info.Env().Undefined();
227
- }
228
-
229
- return Napi::Number::From(info.Env(), llama_token_suffix(model));
230
- }
231
- Napi::Value EotToken(const Napi::CallbackInfo& info) {
232
- if (disposed) {
233
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
234
- return info.Env().Undefined();
235
- }
236
-
237
- return Napi::Number::From(info.Env(), llama_token_eot(model));
238
- }
239
- Napi::Value GetTokenString(const Napi::CallbackInfo& info) {
240
- if (disposed) {
241
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
242
- return info.Env().Undefined();
243
- }
244
-
245
- int token = info[0].As<Napi::Number>().Int32Value();
246
- std::stringstream ss;
247
-
248
- const char* str = llama_token_get_text(model, token);
249
- if (str == nullptr) {
250
- return info.Env().Undefined();
251
- }
252
-
253
- ss << str;
254
-
255
- return Napi::String::New(info.Env(), ss.str());
256
- }
257
-
258
- static void init(Napi::Object exports) {
259
- exports.Set(
260
- "AddonModel",
261
- DefineClass(
262
- exports.Env(),
263
- "AddonModel",
264
- {
265
- InstanceMethod("tokenize", &AddonModel::Tokenize),
266
- InstanceMethod("detokenize", &AddonModel::Detokenize),
267
- InstanceMethod("getTrainContextSize", &AddonModel::GetTrainContextSize),
268
- InstanceMethod("getTotalSize", &AddonModel::GetTotalSize),
269
- InstanceMethod("getTotalParameters", &AddonModel::GetTotalParameters),
270
- InstanceMethod("getModelDescription", &AddonModel::GetModelDescription),
271
- InstanceMethod("tokenBos", &AddonModel::TokenBos),
272
- InstanceMethod("tokenEos", &AddonModel::TokenEos),
273
- InstanceMethod("tokenNl", &AddonModel::TokenNl),
274
- InstanceMethod("prefixToken", &AddonModel::PrefixToken),
275
- InstanceMethod("middleToken", &AddonModel::MiddleToken),
276
- InstanceMethod("suffixToken", &AddonModel::SuffixToken),
277
- InstanceMethod("eotToken", &AddonModel::EotToken),
278
- InstanceMethod("getTokenString", &AddonModel::GetTokenString),
279
- InstanceMethod("dispose", &AddonModel::Dispose)
280
- }
281
- )
282
- );
283
- }
284
- };
285
-
286
- class AddonGrammar : public Napi::ObjectWrap<AddonGrammar> {
287
- public:
288
- grammar_parser::parse_state parsed_grammar;
289
-
290
- AddonGrammar(const Napi::CallbackInfo& info) : Napi::ObjectWrap<AddonGrammar>(info) {
291
- // Get the model path
292
- std::string grammarCode = info[0].As<Napi::String>().Utf8Value();
293
- bool should_print_grammar = false;
294
-
295
- if (info.Length() > 1 && info[1].IsObject()) {
296
- Napi::Object options = info[1].As<Napi::Object>();
297
-
298
- if (options.Has("printGrammar")) {
299
- should_print_grammar = options.Get("printGrammar").As<Napi::Boolean>().Value();
300
- }
301
- }
302
-
303
- parsed_grammar = grammar_parser::parse(grammarCode.c_str());
304
- // will be empty (default) if there are parse errors
305
- if (parsed_grammar.rules.empty()) {
306
- Napi::Error::New(info.Env(), "Failed to parse grammar").ThrowAsJavaScriptException();
307
- return;
308
- }
309
-
310
- if (should_print_grammar) {
311
- grammar_parser::print_grammar(stderr, parsed_grammar);
312
- }
313
- }
314
-
315
- static void init(Napi::Object exports) {
316
- exports.Set("AddonGrammar", DefineClass(exports.Env(), "AddonGrammar", {}));
317
- }
318
- };
319
-
320
- class AddonGrammarEvaluationState : public Napi::ObjectWrap<AddonGrammarEvaluationState> {
321
- public:
322
- AddonGrammar* grammarDef;
323
- llama_grammar* grammar = nullptr;
324
-
325
- AddonGrammarEvaluationState(const Napi::CallbackInfo& info) : Napi::ObjectWrap<AddonGrammarEvaluationState>(info) {
326
- grammarDef = Napi::ObjectWrap<AddonGrammar>::Unwrap(info[0].As<Napi::Object>());
327
- grammarDef->Ref();
328
-
329
- std::vector<const llama_grammar_element*> grammar_rules(grammarDef->parsed_grammar.c_rules());
330
- grammar = llama_grammar_init(grammar_rules.data(), grammar_rules.size(), grammarDef->parsed_grammar.symbol_ids.at("root"));
331
- }
332
-
333
- ~AddonGrammarEvaluationState() {
334
- grammarDef->Unref();
335
-
336
- if (grammar != nullptr) {
337
- llama_grammar_free(grammar);
338
- grammar = nullptr;
339
- }
340
- }
341
-
342
- static void init(Napi::Object exports) {
343
- exports.Set("AddonGrammarEvaluationState", DefineClass(exports.Env(), "AddonGrammarEvaluationState", {}));
344
- }
345
- };
346
-
347
- class AddonContext : public Napi::ObjectWrap<AddonContext> {
348
- public:
349
- AddonModel* model;
350
- llama_context_params context_params;
351
- llama_context* ctx;
352
- llama_batch batch;
353
- bool has_batch = false;
354
- int32_t batch_n_tokens = 0;
355
- int n_cur = 0;
356
- bool disposed = false;
357
-
358
- AddonContext(const Napi::CallbackInfo& info) : Napi::ObjectWrap<AddonContext>(info) {
359
- model = Napi::ObjectWrap<AddonModel>::Unwrap(info[0].As<Napi::Object>());
360
- model->Ref();
361
-
362
- context_params = llama_context_default_params();
363
- context_params.seed = -1;
364
- context_params.n_ctx = 4096;
365
- context_params.n_threads = 6;
366
- context_params.n_threads_batch = context_params.n_threads;
367
-
368
- if (info.Length() > 1 && info[1].IsObject()) {
369
- Napi::Object options = info[1].As<Napi::Object>();
370
-
371
- if (options.Has("noSeed")) {
372
- context_params.seed = time(NULL);
373
- } else if (options.Has("seed")) {
374
- context_params.seed = options.Get("seed").As<Napi::Number>().Uint32Value();
375
- }
376
-
377
- if (options.Has("contextSize")) {
378
- context_params.n_ctx = options.Get("contextSize").As<Napi::Number>().Uint32Value();
379
- }
380
-
381
- if (options.Has("batchSize")) {
382
- context_params.n_batch = options.Get("batchSize").As<Napi::Number>().Uint32Value();
383
- }
384
-
385
- if (options.Has("embedding")) {
386
- context_params.embedding = options.Get("embedding").As<Napi::Boolean>().Value();
387
- }
388
-
389
- if (options.Has("threads")) {
390
- const auto n_threads = options.Get("threads").As<Napi::Number>().Uint32Value();
391
- const auto resolved_n_threads = n_threads == 0 ? std::thread::hardware_concurrency() : n_threads;
392
-
393
- context_params.n_threads = resolved_n_threads;
394
- context_params.n_threads_batch = resolved_n_threads;
395
- }
396
- }
397
-
398
- ctx = llama_new_context_with_model(model->model, context_params);
399
- Napi::MemoryManagement::AdjustExternalMemory(Env(), llama_get_state_size(ctx));
400
- }
401
- ~AddonContext() {
402
- dispose();
403
- }
404
-
405
- void dispose() {
406
- if (disposed) {
407
- return;
408
- }
409
-
410
- Napi::MemoryManagement::AdjustExternalMemory(Env(), -(int64_t)llama_get_state_size(ctx));
411
- llama_free(ctx);
412
- model->Unref();
413
-
414
- disposeBatch();
415
-
416
- disposed = true;
417
- }
418
- void disposeBatch() {
419
- if (!has_batch) {
420
- return;
421
- }
422
-
423
- llama_batch_free(batch);
424
- has_batch = false;
425
- batch_n_tokens = 0;
426
- }
427
- Napi::Value Dispose(const Napi::CallbackInfo& info) {
428
- if (disposed) {
429
- return info.Env().Undefined();
430
- }
431
-
432
- dispose();
433
-
434
- return info.Env().Undefined();
435
- }
436
- Napi::Value GetContextSize(const Napi::CallbackInfo& info) {
437
- if (disposed) {
438
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
439
- return info.Env().Undefined();
440
- }
441
-
442
- return Napi::Number::From(info.Env(), llama_n_ctx(ctx));
443
- }
444
- Napi::Value InitBatch(const Napi::CallbackInfo& info) {
445
- if (disposed) {
446
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
447
- return info.Env().Undefined();
448
- }
449
-
450
- if (has_batch) {
451
- llama_batch_free(batch);
452
- }
453
-
454
- int32_t n_tokens = info[0].As<Napi::Number>().Int32Value();
455
-
456
- batch = llama_batch_init(n_tokens, 0, 1);
457
- has_batch = true;
458
- batch_n_tokens = n_tokens;
459
-
460
- return info.Env().Undefined();
461
- }
462
- Napi::Value DisposeBatch(const Napi::CallbackInfo& info) {
463
- if (disposed) {
464
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
465
- return info.Env().Undefined();
466
- }
467
-
468
- disposeBatch();
469
-
470
- return info.Env().Undefined();
471
- }
472
- Napi::Value AddToBatch(const Napi::CallbackInfo& info) {
473
- if (!has_batch) {
474
- Napi::Error::New(info.Env(), "No batch is initialized").ThrowAsJavaScriptException();
475
- return info.Env().Undefined();
476
- }
477
-
478
- int32_t sequenceId = info[0].As<Napi::Number>().Int32Value();
479
- int32_t firstTokenContextIndex = info[1].As<Napi::Number>().Int32Value();
480
- Napi::Uint32Array tokens = info[2].As<Napi::Uint32Array>();
481
- bool generateLogitAtTheEnd = info[3].As<Napi::Boolean>().Value();
482
-
483
- auto tokensLength = tokens.ElementLength();
484
- GGML_ASSERT(batch.n_tokens + tokensLength <= batch_n_tokens);
485
-
486
- for (size_t i = 0; i < tokensLength; i++) {
487
- llama_batch_add(batch, static_cast<llama_token>(tokens[i]), firstTokenContextIndex + i, { sequenceId }, false);
488
- }
489
-
490
- if (generateLogitAtTheEnd) {
491
- batch.logits[batch.n_tokens - 1] = true;
492
-
493
- auto logit_index = batch.n_tokens - 1;
494
-
495
- return Napi::Number::From(info.Env(), logit_index);
496
- }
497
-
498
- return info.Env().Undefined();
499
- }
500
- Napi::Value DisposeSequence(const Napi::CallbackInfo& info) {
501
- if (disposed) {
502
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
503
- return info.Env().Undefined();
504
- }
505
-
506
- int32_t sequenceId = info[0].As<Napi::Number>().Int32Value();
507
-
508
- llama_kv_cache_seq_rm(ctx, sequenceId, -1, -1);
509
-
510
- return info.Env().Undefined();
511
- }
512
- Napi::Value RemoveTokenCellsFromSequence(const Napi::CallbackInfo& info) {
513
- if (disposed) {
514
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
515
- return info.Env().Undefined();
516
- }
517
-
518
- int32_t sequenceId = info[0].As<Napi::Number>().Int32Value();
519
- int32_t startPos = info[1].As<Napi::Number>().Int32Value();
520
- int32_t endPos = info[2].As<Napi::Number>().Int32Value();
521
-
522
- llama_kv_cache_seq_rm(ctx, sequenceId, startPos, endPos);
523
-
524
- return info.Env().Undefined();
525
- }
526
- Napi::Value ShiftSequenceTokenCells(const Napi::CallbackInfo& info) {
527
- if (disposed) {
528
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
529
- return info.Env().Undefined();
530
- }
531
-
532
- int32_t sequenceId = info[0].As<Napi::Number>().Int32Value();
533
- int32_t startPos = info[1].As<Napi::Number>().Int32Value();
534
- int32_t endPos = info[2].As<Napi::Number>().Int32Value();
535
- int32_t shiftDelta = info[3].As<Napi::Number>().Int32Value();
536
-
537
- llama_kv_cache_seq_shift(ctx, sequenceId, startPos, endPos, shiftDelta);
538
-
539
- return info.Env().Undefined();
540
- }
541
- Napi::Value DecodeBatch(const Napi::CallbackInfo& info);
542
- Napi::Value SampleToken(const Napi::CallbackInfo& info);
543
-
544
- Napi::Value AcceptGrammarEvaluationStateToken(const Napi::CallbackInfo& info) {
545
- AddonGrammarEvaluationState* grammar_evaluation_state = Napi::ObjectWrap<AddonGrammarEvaluationState>::Unwrap(info[0].As<Napi::Object>());
546
- llama_token tokenId = info[1].As<Napi::Number>().Int32Value();
547
-
548
- if ((grammar_evaluation_state)->grammar != nullptr) {
549
- llama_grammar_accept_token(ctx, (grammar_evaluation_state)->grammar, tokenId);
550
- }
551
-
552
- return info.Env().Undefined();
553
- }
554
-
555
- Napi::Value GetEmbedding(const Napi::CallbackInfo& info) {
556
- if (disposed) {
557
- Napi::Error::New(info.Env(), "Context is disposed").ThrowAsJavaScriptException();
558
- return info.Env().Undefined();
559
- }
560
-
561
- const int n_embd = llama_n_embd(model->model);
562
- const auto * embeddings = llama_get_embeddings(ctx);
563
-
564
- Napi::Float64Array result = Napi::Float64Array::New(info.Env(), n_embd);
565
- for (size_t i = 0; i < n_embd; ++i) {
566
- result[i] = embeddings[i];
567
- }
568
-
569
- return result;
570
- }
571
-
572
- Napi::Value PrintTimings(const Napi::CallbackInfo& info) {
573
- llama_print_timings(ctx);
574
- llama_reset_timings(ctx);
575
- return info.Env().Undefined();
576
- }
577
-
578
- static void init(Napi::Object exports) {
579
- exports.Set(
580
- "AddonContext",
581
- DefineClass(
582
- exports.Env(),
583
- "AddonContext",
584
- {
585
- InstanceMethod("getContextSize", &AddonContext::GetContextSize),
586
- InstanceMethod("initBatch", &AddonContext::InitBatch),
587
- InstanceMethod("addToBatch", &AddonContext::AddToBatch),
588
- InstanceMethod("disposeSequence", &AddonContext::DisposeSequence),
589
- InstanceMethod("removeTokenCellsFromSequence", &AddonContext::RemoveTokenCellsFromSequence),
590
- InstanceMethod("shiftSequenceTokenCells", &AddonContext::ShiftSequenceTokenCells),
591
- InstanceMethod("decodeBatch", &AddonContext::DecodeBatch),
592
- InstanceMethod("sampleToken", &AddonContext::SampleToken),
593
- InstanceMethod("acceptGrammarEvaluationStateToken", &AddonContext::AcceptGrammarEvaluationStateToken),
594
- InstanceMethod("getEmbedding", &AddonContext::GetEmbedding),
595
- InstanceMethod("printTimings", &AddonContext::PrintTimings),
596
- InstanceMethod("dispose", &AddonContext::Dispose)
597
- }
598
- )
599
- );
600
- }
601
- };
602
-
603
-
604
- class AddonContextDecodeBatchWorker : Napi::AsyncWorker, Napi::Promise::Deferred {
605
- public:
606
- AddonContext* ctx;
607
-
608
- AddonContextDecodeBatchWorker(const Napi::CallbackInfo& info, AddonContext* ctx)
609
- : Napi::AsyncWorker(info.Env(), "AddonContextDecodeBatchWorker"),
610
- ctx(ctx),
611
- Napi::Promise::Deferred(info.Env()) {
612
- ctx->Ref();
613
- }
614
- ~AddonContextDecodeBatchWorker() {
615
- ctx->Unref();
616
- }
617
- using Napi::AsyncWorker::Queue;
618
- using Napi::Promise::Deferred::Promise;
619
-
620
- protected:
621
- void Execute() {
622
- // Perform the evaluation using llama_decode.
623
- int r = llama_decode(ctx->ctx, ctx->batch);
624
-
625
- if (r != 0) {
626
- if (r == 1) {
627
- SetError("could not find a KV slot for the batch (try reducing the size of the batch or increase the context)");
628
- } else {
629
- SetError("Eval has failed");
630
- }
631
-
632
- return;
633
- }
634
- }
635
- void OnOK() {
636
- Napi::Env env = Napi::AsyncWorker::Env();
637
- Napi::Promise::Deferred::Resolve(env.Undefined());
638
- }
639
- void OnError(const Napi::Error& err) {
640
- Napi::Promise::Deferred::Reject(err.Value());
641
- }
642
- };
643
-
644
- Napi::Value AddonContext::DecodeBatch(const Napi::CallbackInfo& info) {
645
- AddonContextDecodeBatchWorker* worker = new AddonContextDecodeBatchWorker(info, this);
646
- worker->Queue();
647
- return worker->Promise();
648
- }
649
-
650
- class AddonContextSampleTokenWorker : Napi::AsyncWorker, Napi::Promise::Deferred {
651
- public:
652
- AddonContext* ctx;
653
- AddonGrammarEvaluationState* grammar_evaluation_state;
654
- int32_t batchLogitIndex;
655
- bool use_grammar = false;
656
- llama_token result;
657
- float temperature = 0.0f;
658
- int32_t top_k = 40;
659
- float top_p = 0.95f;
660
- float repeat_penalty = 1.10f; // 1.0 = disabled
661
- float repeat_penalty_presence_penalty = 0.00f; // 0.0 = disabled
662
- float repeat_penalty_frequency_penalty = 0.00f; // 0.0 = disabled
663
- std::vector<llama_token> repeat_penalty_tokens;
664
- bool use_repeat_penalty = false;
665
-
666
- AddonContextSampleTokenWorker(const Napi::CallbackInfo& info, AddonContext* ctx)
667
- : Napi::AsyncWorker(info.Env(), "AddonContextSampleTokenWorker"),
668
- ctx(ctx),
669
- Napi::Promise::Deferred(info.Env()) {
670
- ctx->Ref();
671
-
672
- batchLogitIndex = info[0].As<Napi::Number>().Int32Value();
673
-
674
- if (info.Length() > 1 && info[1].IsObject()) {
675
- Napi::Object options = info[1].As<Napi::Object>();
676
-
677
- if (options.Has("temperature")) {
678
- temperature = options.Get("temperature").As<Napi::Number>().FloatValue();
679
- }
680
-
681
- if (options.Has("topK")) {
682
- top_k = options.Get("topK").As<Napi::Number>().Int32Value();
683
- }
684
-
685
- if (options.Has("topP")) {
686
- top_p = options.Get("topP").As<Napi::Number>().FloatValue();
687
- }
688
-
689
- if (options.Has("repeatPenalty")) {
690
- repeat_penalty = options.Get("repeatPenalty").As<Napi::Number>().FloatValue();
691
- }
692
-
693
- if (options.Has("repeatPenaltyTokens")) {
694
- Napi::Uint32Array repeat_penalty_tokens_uint32_array = options.Get("repeatPenaltyTokens").As<Napi::Uint32Array>();
695
-
696
- repeat_penalty_tokens.reserve(repeat_penalty_tokens_uint32_array.ElementLength());
697
- for (size_t i = 0; i < repeat_penalty_tokens_uint32_array.ElementLength(); i++) {
698
- repeat_penalty_tokens.push_back(static_cast<llama_token>(repeat_penalty_tokens_uint32_array[i]));
699
- }
700
-
701
- use_repeat_penalty = true;
702
- }
703
-
704
- if (options.Has("repeatPenaltyPresencePenalty")) {
705
- repeat_penalty_presence_penalty = options.Get("repeatPenaltyPresencePenalty").As<Napi::Number>().FloatValue();
706
- }
707
-
708
- if (options.Has("repeatPenaltyFrequencyPenalty")) {
709
- repeat_penalty_frequency_penalty = options.Get("repeatPenaltyFrequencyPenalty").As<Napi::Number>().FloatValue();
710
- }
711
-
712
- if (options.Has("grammarEvaluationState")) {
713
- grammar_evaluation_state =
714
- Napi::ObjectWrap<AddonGrammarEvaluationState>::Unwrap(options.Get("grammarEvaluationState").As<Napi::Object>());
715
- grammar_evaluation_state->Ref();
716
- use_grammar = true;
717
- }
718
- }
719
- }
720
- ~AddonContextSampleTokenWorker() {
721
- ctx->Unref();
722
-
723
- if (use_grammar) {
724
- grammar_evaluation_state->Unref();
725
- use_grammar = false;
726
- }
727
- }
728
- using Napi::AsyncWorker::Queue;
729
- using Napi::Promise::Deferred::Promise;
730
-
731
- protected:
732
- void Execute() {
733
- llama_token new_token_id = 0;
734
-
735
- // Select the best prediction.
736
- auto logits = llama_get_logits_ith(ctx->ctx, batchLogitIndex);
737
- auto n_vocab = llama_n_vocab(ctx->model->model);
738
-
739
- std::vector<llama_token_data> candidates;
740
- candidates.reserve(n_vocab);
741
-
742
- for (llama_token token_id = 0; token_id < n_vocab; token_id++) {
743
- candidates.emplace_back(llama_token_data { token_id, logits[token_id], 0.0f });
744
- }
745
-
746
- llama_token_data_array candidates_p = { candidates.data(), candidates.size(), false };
747
-
748
- auto eos_token = llama_token_eos(ctx->model->model);
749
-
750
- if (use_repeat_penalty && !repeat_penalty_tokens.empty()) {
751
- llama_sample_repetition_penalties(
752
- ctx->ctx,
753
- &candidates_p,
754
- repeat_penalty_tokens.data(),
755
- repeat_penalty_tokens.size(),
756
- repeat_penalty,
757
- repeat_penalty_frequency_penalty,
758
- repeat_penalty_presence_penalty
759
- );
760
- }
761
-
762
- if (use_grammar && (grammar_evaluation_state)->grammar != nullptr) {
763
- llama_sample_grammar(ctx->ctx, &candidates_p, (grammar_evaluation_state)->grammar);
764
- }
765
-
766
- if (temperature <= 0) {
767
- new_token_id = llama_sample_token_greedy(ctx->ctx, &candidates_p);
768
- } else {
769
- const int32_t resolved_top_k =
770
- top_k <= 0 ? llama_n_vocab(ctx->model->model) : std::min(top_k, llama_n_vocab(ctx->model->model));
771
- const int32_t n_probs = 0; // Number of probabilities to keep - 0 = disabled
772
- const float tfs_z = 1.00f; // Tail free sampling - 1.0 = disabled
773
- const float typical_p = 1.00f; // Typical probability - 1.0 = disabled
774
- const float resolved_top_p = top_p; // Top p sampling - 1.0 = disabled
775
-
776
- // Temperature sampling
777
- size_t min_keep = std::max(1, n_probs);
778
- llama_sample_top_k(ctx->ctx, &candidates_p, resolved_top_k, min_keep);
779
- llama_sample_tail_free(ctx->ctx, &candidates_p, tfs_z, min_keep);
780
- llama_sample_typical(ctx->ctx, &candidates_p, typical_p, min_keep);
781
- llama_sample_top_p(ctx->ctx, &candidates_p, resolved_top_p, min_keep);
782
- llama_sample_temp(ctx->ctx, &candidates_p, temperature);
783
- new_token_id = llama_sample_token(ctx->ctx, &candidates_p);
784
- }
785
-
786
- if (new_token_id != eos_token && use_grammar && (grammar_evaluation_state)->grammar != nullptr) {
787
- llama_grammar_accept_token(ctx->ctx, (grammar_evaluation_state)->grammar, new_token_id);
788
- }
789
-
790
- result = new_token_id;
791
- }
792
- void OnOK() {
793
- Napi::Env env = Napi::AsyncWorker::Env();
794
- Napi::Number resultValue = Napi::Number::New(env, static_cast<uint32_t>(result));
795
- Napi::Promise::Deferred::Resolve(resultValue);
796
- }
797
- void OnError(const Napi::Error& err) {
798
- Napi::Promise::Deferred::Reject(err.Value());
799
- }
800
- };
801
-
802
- Napi::Value AddonContext::SampleToken(const Napi::CallbackInfo& info) {
803
- AddonContextSampleTokenWorker* worker = new AddonContextSampleTokenWorker(info, this);
804
- worker->Queue();
805
- return worker->Promise();
806
- }
807
-
808
- Napi::Value systemInfo(const Napi::CallbackInfo& info) {
809
- return Napi::String::From(info.Env(), llama_print_system_info());
810
- }
811
-
812
- int addonGetGgmlLogLevelNumber(ggml_log_level level) {
813
- switch (level) {
814
- case GGML_LOG_LEVEL_ERROR: return 2;
815
- case GGML_LOG_LEVEL_WARN: return 3;
816
- case GGML_LOG_LEVEL_INFO: return 4;
817
- case GGML_LOG_LEVEL_DEBUG: return 5;
818
- }
819
-
820
- return 1;
821
- }
822
-
823
- static void addonWrapperJSLogCallback(Napi::Env env, Napi::Function jsCallback, addon_logger_log* data) {
824
- auto status = jsCallback.Call({
825
- Napi::Number::New(env, data->logLevelNumber),
826
- Napi::String::New(env, data->stringStream->str())
827
- });
828
-
829
- delete data->stringStream;
830
- delete data;
831
- }
832
-
833
- static void addonLlamaCppLogCallback(ggml_log_level level, const char * text, void * user_data) {
834
- int logLevelNumber = addonGetGgmlLogLevelNumber(level);
835
-
836
- if (logLevelNumber > addonLoggerLogLevel) {
837
- return;
838
- }
839
-
840
- if (loggerCallbackSet) {
841
- std::stringstream* stringStream = new std::stringstream();
842
- if (text != nullptr) {
843
- *stringStream << text;
844
- }
845
-
846
- addon_logger_log* data = new addon_logger_log {
847
- logLevelNumber,
848
- stringStream
849
- };
850
-
851
- auto status = threadSafeLoggerCallback.NonBlockingCall(data, addonWrapperJSLogCallback);
852
-
853
- if (status == napi_ok) {
854
- return;
855
- }
856
- }
857
-
858
- if (level == GGML_LOG_LEVEL_ERROR) {
859
- fputs(text, stderr);
860
- fflush(stderr);
861
- } else {
862
- fputs(text, stdout);
863
- fflush(stdout);
864
- }
865
- }
866
-
867
- Napi::Value setLogger(const Napi::CallbackInfo& info) {
868
- if (info.Length() < 1 || !info[0].IsFunction()) {
869
- if (loggerCallbackSet) {
870
- threadSafeLoggerCallback.Release();
871
- threadSafeLoggerCallback = nullptr;
872
- loggerCallbackFunctionReference.Unref();
873
- loggerCallbackSet = false;
874
- }
875
-
876
- return info.Env().Undefined();
877
- }
878
-
879
- loggerCallbackFunctionReference = Napi::Persistent(info[0].As<Napi::Function>());
880
- loggerCallbackFunctionReference.Ref();
881
- threadSafeLoggerCallback = Napi::ThreadSafeFunction::New(info.Env(), loggerCallbackFunctionReference.Value(), "loggerCallback", 0, 1);
882
- loggerCallbackSet = true;
883
-
884
- return info.Env().Undefined();
885
- }
886
-
887
- Napi::Value setLoggerLogLevel(const Napi::CallbackInfo& info) {
888
- if (info.Length() < 1 || !info[0].IsNumber()) {
889
- addonLoggerLogLevel = 5;
890
-
891
- return info.Env().Undefined();
892
- }
893
-
894
- addonLoggerLogLevel = info[0].As<Napi::Number>().Int32Value();
895
-
896
- return info.Env().Undefined();
897
- }
898
-
899
- Napi::Object registerCallback(Napi::Env env, Napi::Object exports) {
900
- llama_backend_init(false);
901
- exports.DefineProperties({
902
- Napi::PropertyDescriptor::Function("systemInfo", systemInfo),
903
- Napi::PropertyDescriptor::Function("setLogger", setLogger),
904
- Napi::PropertyDescriptor::Function("setLoggerLogLevel", setLoggerLogLevel)
905
- });
906
- AddonModel::init(exports);
907
- AddonGrammar::init(exports);
908
- AddonGrammarEvaluationState::init(exports);
909
- AddonContext::init(exports);
910
-
911
- llama_log_set(addonLlamaCppLogCallback, nullptr);
912
-
913
- return exports;
914
- }
915
-
916
- NODE_API_MODULE(NODE_GYP_MODULE_NAME, registerCallback)