atabey 0.0.12 → 0.0.14

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 (432) hide show
  1. package/ATABEY.md +45 -499
  2. package/PRIVACY.md +161 -0
  3. package/README.md +553 -88
  4. package/bin/validate-al-registry.js +4 -4
  5. package/dist/framework-mcp/src/index.js +914 -62
  6. package/dist/framework-mcp/src/index.js.map +1 -1
  7. package/dist/framework-mcp/src/tools/compliance/mask_pii.d.ts +17 -0
  8. package/dist/framework-mcp/src/tools/compliance/mask_pii.js +56 -0
  9. package/dist/framework-mcp/src/tools/compliance/mask_pii.js.map +1 -0
  10. package/dist/framework-mcp/src/tools/definitions.js +24 -1
  11. package/dist/framework-mcp/src/tools/definitions.js.map +1 -1
  12. package/dist/framework-mcp/src/tools/framework/run_tests.js +25 -0
  13. package/dist/framework-mcp/src/tools/framework/run_tests.js.map +1 -1
  14. package/dist/framework-mcp/src/tools/gateway/llm_gateway_query.d.ts +19 -0
  15. package/dist/framework-mcp/src/tools/gateway/llm_gateway_query.js +138 -0
  16. package/dist/framework-mcp/src/tools/gateway/llm_gateway_query.js.map +1 -0
  17. package/dist/framework-mcp/src/tools/gateway/llm_gateway_status.d.ts +8 -0
  18. package/dist/framework-mcp/src/tools/gateway/llm_gateway_status.js +91 -0
  19. package/dist/framework-mcp/src/tools/gateway/llm_gateway_status.js.map +1 -0
  20. package/dist/framework-mcp/src/tools/index.d.ts +1 -1
  21. package/dist/framework-mcp/src/tools/index.js +34 -20
  22. package/dist/framework-mcp/src/tools/index.js.map +1 -1
  23. package/dist/framework-mcp/src/tools/messaging/approve_operation.d.ts +22 -0
  24. package/dist/framework-mcp/src/tools/messaging/approve_operation.js +81 -0
  25. package/dist/framework-mcp/src/tools/messaging/approve_operation.js.map +1 -0
  26. package/dist/framework-mcp/src/tools/messaging/ask_human.d.ts +15 -0
  27. package/dist/framework-mcp/src/tools/messaging/ask_human.js +89 -20
  28. package/dist/framework-mcp/src/tools/messaging/ask_human.js.map +1 -1
  29. package/dist/framework-mcp/src/tools/observability/check_ports.js +3 -1
  30. package/dist/framework-mcp/src/tools/observability/check_ports.js.map +1 -1
  31. package/dist/framework-mcp/src/tools/quality/analyze_code_quality.d.ts +11 -0
  32. package/dist/framework-mcp/src/tools/quality/analyze_code_quality.js +115 -0
  33. package/dist/framework-mcp/src/tools/quality/analyze_code_quality.js.map +1 -0
  34. package/dist/framework-mcp/src/tools/quality/check_architecture_compliance.d.ts +11 -0
  35. package/dist/framework-mcp/src/tools/quality/check_architecture_compliance.js +135 -0
  36. package/dist/framework-mcp/src/tools/quality/check_architecture_compliance.js.map +1 -0
  37. package/dist/framework-mcp/src/tools/schemas.d.ts +90 -15
  38. package/dist/framework-mcp/src/tools/schemas.js +32 -7
  39. package/dist/framework-mcp/src/tools/schemas.js.map +1 -1
  40. package/dist/framework-mcp/src/tools/shell/run_command.js +12 -2
  41. package/dist/framework-mcp/src/tools/shell/run_command.js.map +1 -1
  42. package/dist/framework-mcp/src/tools/types.d.ts +11 -105
  43. package/dist/framework-mcp/src/tools/types.js +1 -0
  44. package/dist/framework-mcp/src/tools/types.js.map +1 -1
  45. package/dist/framework-mcp/src/utils/auth.d.ts +36 -0
  46. package/dist/framework-mcp/src/utils/auth.js +79 -0
  47. package/dist/framework-mcp/src/utils/auth.js.map +1 -0
  48. package/dist/framework-mcp/src/utils/auto-rollback.d.ts +71 -0
  49. package/dist/framework-mcp/src/utils/auto-rollback.js +266 -0
  50. package/dist/framework-mcp/src/utils/auto-rollback.js.map +1 -0
  51. package/dist/framework-mcp/src/utils/compliance.js +12 -4
  52. package/dist/framework-mcp/src/utils/compliance.js.map +1 -1
  53. package/dist/framework-mcp/src/utils/context-optimizer.d.ts +69 -0
  54. package/dist/framework-mcp/src/utils/context-optimizer.js +157 -0
  55. package/dist/framework-mcp/src/utils/context-optimizer.js.map +1 -0
  56. package/dist/framework-mcp/src/utils/discipline.d.ts +68 -0
  57. package/dist/framework-mcp/src/utils/discipline.js +218 -0
  58. package/dist/framework-mcp/src/utils/discipline.js.map +1 -0
  59. package/dist/framework-mcp/src/utils/finops.d.ts +143 -0
  60. package/dist/framework-mcp/src/utils/finops.js +326 -0
  61. package/dist/framework-mcp/src/utils/finops.js.map +1 -0
  62. package/dist/framework-mcp/src/utils/human-in-loop.d.ts +95 -0
  63. package/dist/framework-mcp/src/utils/human-in-loop.js +216 -0
  64. package/dist/framework-mcp/src/utils/human-in-loop.js.map +1 -0
  65. package/dist/framework-mcp/src/utils/license-scanner.d.ts +71 -0
  66. package/dist/framework-mcp/src/utils/license-scanner.js +284 -0
  67. package/dist/framework-mcp/src/utils/license-scanner.js.map +1 -0
  68. package/dist/framework-mcp/src/utils/loop-detector.d.ts +105 -0
  69. package/dist/framework-mcp/src/utils/loop-detector.js +362 -0
  70. package/dist/framework-mcp/src/utils/loop-detector.js.map +1 -0
  71. package/dist/framework-mcp/src/utils/quality.d.ts +19 -0
  72. package/dist/framework-mcp/src/utils/quality.js +124 -0
  73. package/dist/framework-mcp/src/utils/quality.js.map +1 -0
  74. package/dist/framework-mcp/src/utils/rules-engine.d.ts +78 -0
  75. package/dist/framework-mcp/src/utils/rules-engine.js +232 -0
  76. package/dist/framework-mcp/src/utils/rules-engine.js.map +1 -0
  77. package/dist/framework-mcp/src/utils/silent-router.d.ts +47 -0
  78. package/dist/framework-mcp/src/utils/silent-router.js +129 -0
  79. package/dist/framework-mcp/src/utils/silent-router.js.map +1 -0
  80. package/dist/framework-mcp/src/utils/storage.d.ts +1 -0
  81. package/dist/framework-mcp/src/utils/storage.js +2 -2
  82. package/dist/framework-mcp/src/utils/storage.js.map +1 -1
  83. package/dist/framework-mcp/src/utils/telemetry-streamer.d.ts +133 -0
  84. package/dist/framework-mcp/src/utils/telemetry-streamer.js +397 -0
  85. package/dist/framework-mcp/src/utils/telemetry-streamer.js.map +1 -0
  86. package/dist/framework-mcp/tests/tools/file_system/file_system_tools.test.js +2 -2
  87. package/dist/framework-mcp/tests/tools/file_system/file_system_tools.test.js.map +1 -1
  88. package/dist/framework-mcp/tests/tools/framework/run_tests.test.d.ts +1 -0
  89. package/dist/framework-mcp/tests/tools/framework/run_tests.test.js +49 -0
  90. package/dist/framework-mcp/tests/tools/framework/run_tests.test.js.map +1 -0
  91. package/dist/framework-mcp/tests/tools/messaging/send_message.test.js +14 -5
  92. package/dist/framework-mcp/tests/tools/messaging/send_message.test.js.map +1 -1
  93. package/dist/framework-mcp/tests/tools/observability/check_ports.test.d.ts +1 -0
  94. package/dist/framework-mcp/tests/tools/observability/check_ports.test.js +30 -0
  95. package/dist/framework-mcp/tests/tools/observability/check_ports.test.js.map +1 -0
  96. package/dist/framework-mcp/tests/tools/shell/run_command.test.js +7 -0
  97. package/dist/framework-mcp/tests/tools/shell/run_command.test.js.map +1 -1
  98. package/dist/framework-mcp/tests/utils/auto-rollback.test.d.ts +7 -0
  99. package/dist/framework-mcp/tests/utils/auto-rollback.test.js +178 -0
  100. package/dist/framework-mcp/tests/utils/auto-rollback.test.js.map +1 -0
  101. package/dist/framework-mcp/tests/utils/context-optimizer.test.d.ts +1 -0
  102. package/dist/framework-mcp/tests/utils/context-optimizer.test.js +62 -0
  103. package/dist/framework-mcp/tests/utils/context-optimizer.test.js.map +1 -0
  104. package/dist/framework-mcp/tests/utils/finops.test.d.ts +7 -0
  105. package/dist/framework-mcp/tests/utils/finops.test.js +157 -0
  106. package/dist/framework-mcp/tests/utils/finops.test.js.map +1 -0
  107. package/dist/framework-mcp/tests/utils/human-in-loop.test.d.ts +1 -0
  108. package/dist/framework-mcp/tests/utils/human-in-loop.test.js +59 -0
  109. package/dist/framework-mcp/tests/utils/human-in-loop.test.js.map +1 -0
  110. package/dist/framework-mcp/tests/utils/license-scanner.test.d.ts +7 -0
  111. package/dist/framework-mcp/tests/utils/license-scanner.test.js +131 -0
  112. package/dist/framework-mcp/tests/utils/license-scanner.test.js.map +1 -0
  113. package/dist/framework-mcp/tests/utils/loop-detector.test.d.ts +7 -0
  114. package/dist/framework-mcp/tests/utils/loop-detector.test.js +204 -0
  115. package/dist/framework-mcp/tests/utils/loop-detector.test.js.map +1 -0
  116. package/dist/framework-mcp/tests/utils/rules-engine.test.d.ts +1 -0
  117. package/dist/framework-mcp/tests/utils/rules-engine.test.js +106 -0
  118. package/dist/framework-mcp/tests/utils/rules-engine.test.js.map +1 -0
  119. package/dist/framework-mcp/tests/utils/telemetry-streamer.test.d.ts +7 -0
  120. package/dist/framework-mcp/tests/utils/telemetry-streamer.test.js +201 -0
  121. package/dist/framework-mcp/tests/utils/telemetry-streamer.test.js.map +1 -0
  122. package/dist/src/cli/commands/check.js +18 -3
  123. package/dist/src/cli/commands/check.js.map +1 -1
  124. package/dist/src/cli/commands/dashboard.d.ts +1 -1
  125. package/dist/src/cli/commands/dashboard.js +343 -96
  126. package/dist/src/cli/commands/dashboard.js.map +1 -1
  127. package/dist/src/cli/commands/gateway.d.ts +1 -0
  128. package/dist/src/cli/commands/gateway.js +172 -0
  129. package/dist/src/cli/commands/gateway.js.map +1 -0
  130. package/dist/src/cli/commands/init/create-agent.js +3 -3
  131. package/dist/src/cli/commands/init/create-agent.js.map +1 -1
  132. package/dist/src/cli/commands/init/scaffold-core.d.ts +3 -1
  133. package/dist/src/cli/commands/init/scaffold-core.js +17 -2
  134. package/dist/src/cli/commands/init/scaffold-core.js.map +1 -1
  135. package/dist/src/cli/commands/init/scaffold-ops.js +2 -2
  136. package/dist/src/cli/commands/init/scaffold-ops.js.map +1 -1
  137. package/dist/src/cli/commands/init/scaffold-standards.js +13 -1
  138. package/dist/src/cli/commands/init/scaffold-standards.js.map +1 -1
  139. package/dist/src/cli/commands/init.d.ts +6 -0
  140. package/dist/src/cli/commands/init.js +163 -25
  141. package/dist/src/cli/commands/init.js.map +1 -1
  142. package/dist/src/cli/commands/mcp.d.ts +7 -0
  143. package/dist/src/cli/commands/mcp.js +45 -22
  144. package/dist/src/cli/commands/mcp.js.map +1 -1
  145. package/dist/src/cli/commands/orchestrate.d.ts +8 -7
  146. package/dist/src/cli/commands/orchestrate.js +2 -1
  147. package/dist/src/cli/commands/orchestrate.js.map +1 -1
  148. package/dist/src/cli/commands/quickstart.d.ts +5 -5
  149. package/dist/src/cli/commands/quickstart.js +30 -42
  150. package/dist/src/cli/commands/quickstart.js.map +1 -1
  151. package/dist/src/cli/index.js +228 -317
  152. package/dist/src/cli/index.js.map +1 -1
  153. package/dist/src/cli/platforms/core.d.ts +12 -0
  154. package/dist/src/cli/platforms/core.js +73 -0
  155. package/dist/src/cli/platforms/core.js.map +1 -0
  156. package/dist/src/cli/platforms/index.d.ts +5 -0
  157. package/dist/src/cli/platforms/index.js +6 -0
  158. package/dist/src/cli/platforms/index.js.map +1 -0
  159. package/dist/src/cli/platforms/paths.d.ts +15 -0
  160. package/dist/src/cli/platforms/paths.js +102 -0
  161. package/dist/src/cli/platforms/paths.js.map +1 -0
  162. package/dist/src/cli/platforms/scaffold.d.ts +2 -0
  163. package/dist/src/cli/platforms/scaffold.js +73 -0
  164. package/dist/src/cli/platforms/scaffold.js.map +1 -0
  165. package/dist/src/cli/platforms/utils.d.ts +4 -0
  166. package/dist/src/cli/platforms/utils.js +76 -0
  167. package/dist/src/cli/platforms/utils.js.map +1 -0
  168. package/dist/src/cli/shims.js +11 -11
  169. package/dist/src/cli/utils/fs.d.ts +1 -1
  170. package/dist/src/cli/utils/fs.js +1 -1
  171. package/dist/src/cli/utils/fs.js.map +1 -1
  172. package/dist/src/cli/utils/pkg.js +2 -3
  173. package/dist/src/cli/utils/pkg.js.map +1 -1
  174. package/dist/src/cli/utils/quality.d.ts +10 -0
  175. package/dist/src/cli/utils/quality.js +10 -0
  176. package/dist/src/cli/utils/quality.js.map +1 -0
  177. package/dist/src/modules/agents/definitions.d.ts +2 -2
  178. package/dist/src/modules/agents/definitions.js +104 -63
  179. package/dist/src/modules/agents/definitions.js.map +1 -1
  180. package/dist/src/modules/agents/registry/manager.js +6 -1
  181. package/dist/src/modules/agents/registry/manager.js.map +1 -1
  182. package/dist/src/modules/contracts/api.d.ts +178 -0
  183. package/dist/src/modules/contracts/api.js +56 -0
  184. package/dist/src/modules/contracts/api.js.map +1 -0
  185. package/dist/src/modules/contracts/index.d.ts +5 -0
  186. package/dist/src/modules/contracts/index.js +6 -0
  187. package/dist/src/modules/contracts/index.js.map +1 -0
  188. package/dist/src/modules/engines/agent-executor.d.ts +25 -30
  189. package/dist/src/modules/engines/agent-executor.js +133 -73
  190. package/dist/src/modules/engines/agent-executor.js.map +1 -1
  191. package/dist/src/modules/engines/agent-loop.d.ts +34 -0
  192. package/dist/src/modules/engines/agent-loop.js +102 -0
  193. package/dist/src/modules/engines/agent-loop.js.map +1 -0
  194. package/dist/src/modules/engines/evaluation-engine.js +2 -2
  195. package/dist/src/modules/engines/evaluation-engine.js.map +1 -1
  196. package/dist/src/modules/engines/quality-gate.d.ts +16 -8
  197. package/dist/src/modules/engines/quality-gate.js +42 -34
  198. package/dist/src/modules/engines/quality-gate.js.map +1 -1
  199. package/dist/src/modules/engines/routing-engine.d.ts +21 -28
  200. package/dist/src/modules/engines/routing-engine.js +83 -50
  201. package/dist/src/modules/engines/routing-engine.js.map +1 -1
  202. package/dist/src/modules/gateway/circuit-breaker.d.ts +40 -0
  203. package/dist/src/modules/gateway/circuit-breaker.js +163 -0
  204. package/dist/src/modules/gateway/circuit-breaker.js.map +1 -0
  205. package/dist/src/modules/gateway/cost-tracker.d.ts +60 -0
  206. package/dist/src/modules/gateway/cost-tracker.js +198 -0
  207. package/dist/src/modules/gateway/cost-tracker.js.map +1 -0
  208. package/dist/src/modules/gateway/gateway.d.ts +72 -0
  209. package/dist/src/modules/gateway/gateway.js +243 -0
  210. package/dist/src/modules/gateway/gateway.js.map +1 -0
  211. package/dist/src/modules/gateway/index.d.ts +19 -0
  212. package/dist/src/modules/gateway/index.js +19 -0
  213. package/dist/src/modules/gateway/index.js.map +1 -0
  214. package/dist/src/modules/gateway/load-balancer.d.ts +86 -0
  215. package/dist/src/modules/gateway/load-balancer.js +230 -0
  216. package/dist/src/modules/gateway/load-balancer.js.map +1 -0
  217. package/dist/src/modules/gateway/providers/anthropic.d.ts +14 -0
  218. package/dist/src/modules/gateway/providers/anthropic.js +169 -0
  219. package/dist/src/modules/gateway/providers/anthropic.js.map +1 -0
  220. package/dist/src/modules/gateway/providers/base.d.ts +38 -0
  221. package/dist/src/modules/gateway/providers/base.js +42 -0
  222. package/dist/src/modules/gateway/providers/base.js.map +1 -0
  223. package/dist/src/modules/gateway/providers/google.d.ts +18 -0
  224. package/dist/src/modules/gateway/providers/google.js +176 -0
  225. package/dist/src/modules/gateway/providers/google.js.map +1 -0
  226. package/dist/src/modules/gateway/providers/grok.d.ts +14 -0
  227. package/dist/src/modules/gateway/providers/grok.js +166 -0
  228. package/dist/src/modules/gateway/providers/grok.js.map +1 -0
  229. package/dist/src/modules/gateway/providers/index.d.ts +21 -0
  230. package/dist/src/modules/gateway/providers/index.js +38 -0
  231. package/dist/src/modules/gateway/providers/index.js.map +1 -0
  232. package/dist/src/modules/gateway/providers/ollama.d.ts +23 -0
  233. package/dist/src/modules/gateway/providers/ollama.js +187 -0
  234. package/dist/src/modules/gateway/providers/ollama.js.map +1 -0
  235. package/dist/src/modules/gateway/providers/openai.d.ts +14 -0
  236. package/dist/src/modules/gateway/providers/openai.js +170 -0
  237. package/dist/src/modules/gateway/providers/openai.js.map +1 -0
  238. package/dist/src/modules/gateway/rate-limiter.d.ts +41 -0
  239. package/dist/src/modules/gateway/rate-limiter.js +119 -0
  240. package/dist/src/modules/gateway/rate-limiter.js.map +1 -0
  241. package/dist/src/modules/gateway/types.d.ts +114 -0
  242. package/dist/src/modules/gateway/types.js +8 -0
  243. package/dist/src/modules/gateway/types.js.map +1 -0
  244. package/dist/src/modules/memory/core.d.ts +4 -12
  245. package/dist/src/modules/memory/core.js +10 -17
  246. package/dist/src/modules/memory/core.js.map +1 -1
  247. package/dist/src/modules/memory/embedding.d.ts +28 -0
  248. package/dist/src/modules/memory/embedding.js +131 -0
  249. package/dist/src/modules/memory/embedding.js.map +1 -0
  250. package/dist/src/modules/providers/definitions.d.ts +9 -0
  251. package/dist/src/modules/providers/definitions.js +141 -0
  252. package/dist/src/modules/providers/definitions.js.map +1 -0
  253. package/dist/src/modules/providers/registry.d.ts +12 -0
  254. package/dist/src/modules/providers/registry.js +19 -0
  255. package/dist/src/modules/providers/registry.js.map +1 -0
  256. package/dist/src/modules/providers/shared.d.ts +1 -0
  257. package/dist/src/modules/providers/shared.js +105 -0
  258. package/dist/src/modules/providers/shared.js.map +1 -0
  259. package/dist/src/modules/providers/types.d.ts +14 -0
  260. package/dist/src/modules/providers/types.js +2 -0
  261. package/dist/src/modules/providers/types.js.map +1 -0
  262. package/dist/src/modules/skills/adapter-skills.d.ts +68 -0
  263. package/dist/src/modules/skills/adapter-skills.js +450 -0
  264. package/dist/src/modules/skills/adapter-skills.js.map +1 -0
  265. package/dist/src/shared/audit.d.ts +105 -0
  266. package/dist/src/shared/audit.js +221 -0
  267. package/dist/src/shared/audit.js.map +1 -0
  268. package/dist/src/shared/fs.js +4 -2
  269. package/dist/src/shared/fs.js.map +1 -1
  270. package/dist/src/shared/lock.d.ts +82 -0
  271. package/dist/src/shared/lock.js +160 -0
  272. package/dist/src/shared/lock.js.map +1 -0
  273. package/dist/src/shared/logger.d.ts +2 -0
  274. package/dist/src/shared/logger.js +15 -5
  275. package/dist/src/shared/logger.js.map +1 -1
  276. package/dist/src/shared/pii.d.ts +69 -0
  277. package/dist/src/shared/pii.js +213 -0
  278. package/dist/src/shared/pii.js.map +1 -0
  279. package/dist/src/shared/retention.d.ts +63 -0
  280. package/dist/src/shared/retention.js +171 -0
  281. package/dist/src/shared/retention.js.map +1 -0
  282. package/dist/src/shared/storage.d.ts +22 -1
  283. package/dist/src/shared/storage.js +49 -7
  284. package/dist/src/shared/storage.js.map +1 -1
  285. package/dist/tests/adapter.test.js +1 -1
  286. package/dist/tests/adapter.test.js.map +1 -1
  287. package/dist/tests/adapters/paths.test.js +4 -4
  288. package/dist/tests/adapters/paths.test.js.map +1 -1
  289. package/dist/tests/cli/commands/dashboard-coverage.test.d.ts +1 -0
  290. package/dist/tests/cli/commands/dashboard-coverage.test.js +88 -0
  291. package/dist/tests/cli/commands/dashboard-coverage.test.js.map +1 -0
  292. package/dist/tests/cli/init/adapter_init.test.js +4 -5
  293. package/dist/tests/cli/init/adapter_init.test.js.map +1 -1
  294. package/dist/tests/cli/init/unified_init.test.js +5 -7
  295. package/dist/tests/cli/init/unified_init.test.js.map +1 -1
  296. package/dist/tests/embedding.test.d.ts +1 -0
  297. package/dist/tests/embedding.test.js +82 -0
  298. package/dist/tests/embedding.test.js.map +1 -0
  299. package/dist/tests/engines/evaluation-engine.test.d.ts +1 -0
  300. package/dist/tests/engines/evaluation-engine.test.js +71 -0
  301. package/dist/tests/engines/evaluation-engine.test.js.map +1 -0
  302. package/dist/tests/engines/planning-engine.test.d.ts +1 -0
  303. package/dist/tests/engines/planning-engine.test.js +100 -0
  304. package/dist/tests/engines/planning-engine.test.js.map +1 -0
  305. package/dist/tests/engines/quality-gate.test.d.ts +1 -0
  306. package/dist/tests/engines/quality-gate.test.js +59 -0
  307. package/dist/tests/engines/quality-gate.test.js.map +1 -0
  308. package/dist/tests/engines/risk-engine.test.d.ts +1 -0
  309. package/dist/tests/engines/risk-engine.test.js +80 -0
  310. package/dist/tests/engines/risk-engine.test.js.map +1 -0
  311. package/dist/tests/engines/routing-engine.test.d.ts +1 -0
  312. package/dist/tests/engines/routing-engine.test.js +78 -0
  313. package/dist/tests/engines/routing-engine.test.js.map +1 -0
  314. package/dist/tests/integration/agent_flow.test.js +14 -8
  315. package/dist/tests/integration/agent_flow.test.js.map +1 -1
  316. package/dist/tests/integration/hermes_locking.test.js +1 -0
  317. package/dist/tests/integration/hermes_locking.test.js.map +1 -1
  318. package/dist/tests/modules/adapters/adapters.test.js +2 -2
  319. package/dist/tests/modules/adapters/adapters.test.js.map +1 -1
  320. package/dist/tests/modules/contracts/contracts.test.d.ts +1 -0
  321. package/dist/tests/modules/contracts/contracts.test.js +73 -0
  322. package/dist/tests/modules/contracts/contracts.test.js.map +1 -0
  323. package/dist/tests/modules/engines/agent-executor.test.js +30 -23
  324. package/dist/tests/modules/engines/agent-executor.test.js.map +1 -1
  325. package/dist/tests/modules/gateway/circuit-breaker.test.d.ts +1 -0
  326. package/dist/tests/modules/gateway/circuit-breaker.test.js +124 -0
  327. package/dist/tests/modules/gateway/circuit-breaker.test.js.map +1 -0
  328. package/dist/tests/modules/gateway/cost-tracker.test.d.ts +1 -0
  329. package/dist/tests/modules/gateway/cost-tracker.test.js +93 -0
  330. package/dist/tests/modules/gateway/cost-tracker.test.js.map +1 -0
  331. package/dist/tests/modules/gateway/load-balancer.test.d.ts +1 -0
  332. package/dist/tests/modules/gateway/load-balancer.test.js +70 -0
  333. package/dist/tests/modules/gateway/load-balancer.test.js.map +1 -0
  334. package/dist/tests/modules/gateway/rate-limiter.test.d.ts +1 -0
  335. package/dist/tests/modules/gateway/rate-limiter.test.js +62 -0
  336. package/dist/tests/modules/gateway/rate-limiter.test.js.map +1 -0
  337. package/dist/tests/orchestrator-dependencies.test.js +23 -6
  338. package/dist/tests/orchestrator-dependencies.test.js.map +1 -1
  339. package/dist/tests/shared/audit.test.d.ts +1 -0
  340. package/dist/tests/shared/audit.test.js +53 -0
  341. package/dist/tests/shared/audit.test.js.map +1 -0
  342. package/dist/tests/shared/lock.test.d.ts +1 -0
  343. package/dist/tests/shared/lock.test.js +95 -0
  344. package/dist/tests/shared/lock.test.js.map +1 -0
  345. package/dist/tests/shared/pii.test.d.ts +1 -0
  346. package/dist/tests/shared/pii.test.js +183 -0
  347. package/dist/tests/shared/pii.test.js.map +1 -0
  348. package/dist/tests/storage-operations.test.d.ts +1 -0
  349. package/dist/tests/storage-operations.test.js +116 -0
  350. package/dist/tests/storage-operations.test.js.map +1 -0
  351. package/framework-mcp/README.md +596 -77
  352. package/framework-mcp/dist/dashboard/assets/index-B2mYld0c.js +1221 -0
  353. package/framework-mcp/dist/dashboard/index.html +15 -0
  354. package/framework-mcp/dist/framework-mcp/src/index.js +914 -62
  355. package/framework-mcp/dist/framework-mcp/src/tools/compliance/mask_pii.js +55 -0
  356. package/framework-mcp/dist/framework-mcp/src/tools/definitions.js +24 -1
  357. package/framework-mcp/dist/framework-mcp/src/tools/framework/run_tests.js +25 -0
  358. package/framework-mcp/dist/framework-mcp/src/tools/gateway/llm_gateway_query.js +137 -0
  359. package/framework-mcp/dist/framework-mcp/src/tools/gateway/llm_gateway_status.js +90 -0
  360. package/framework-mcp/dist/framework-mcp/src/tools/index.js +34 -20
  361. package/framework-mcp/dist/framework-mcp/src/tools/messaging/approve_operation.js +80 -0
  362. package/framework-mcp/dist/framework-mcp/src/tools/messaging/ask_human.js +89 -20
  363. package/framework-mcp/dist/framework-mcp/src/tools/observability/check_ports.js +3 -1
  364. package/framework-mcp/dist/framework-mcp/src/tools/quality/analyze_code_quality.js +114 -0
  365. package/framework-mcp/dist/framework-mcp/src/tools/quality/check_architecture_compliance.js +134 -0
  366. package/framework-mcp/dist/framework-mcp/src/tools/schemas.js +32 -7
  367. package/framework-mcp/dist/framework-mcp/src/tools/shell/run_command.js +12 -2
  368. package/framework-mcp/dist/framework-mcp/src/tools/types.js +1 -0
  369. package/framework-mcp/dist/framework-mcp/src/utils/auth.js +78 -0
  370. package/framework-mcp/dist/framework-mcp/src/utils/auto-rollback.js +265 -0
  371. package/framework-mcp/dist/framework-mcp/src/utils/compliance.js +12 -4
  372. package/framework-mcp/dist/framework-mcp/src/utils/context-optimizer.js +156 -0
  373. package/framework-mcp/dist/framework-mcp/src/utils/discipline.js +217 -0
  374. package/framework-mcp/dist/framework-mcp/src/utils/finops.js +325 -0
  375. package/framework-mcp/dist/framework-mcp/src/utils/human-in-loop.js +215 -0
  376. package/framework-mcp/dist/framework-mcp/src/utils/license-scanner.js +283 -0
  377. package/framework-mcp/dist/framework-mcp/src/utils/loop-detector.js +361 -0
  378. package/framework-mcp/dist/framework-mcp/src/utils/quality.js +123 -0
  379. package/framework-mcp/dist/framework-mcp/src/utils/rules-engine.js +231 -0
  380. package/framework-mcp/dist/framework-mcp/src/utils/silent-router.js +128 -0
  381. package/framework-mcp/dist/framework-mcp/src/utils/storage.js +2 -2
  382. package/framework-mcp/dist/framework-mcp/src/utils/telemetry-streamer.js +396 -0
  383. package/framework-mcp/dist/src/cli/platforms/core.js +72 -0
  384. package/framework-mcp/dist/src/cli/platforms/index.js +5 -0
  385. package/framework-mcp/dist/src/cli/platforms/paths.js +101 -0
  386. package/framework-mcp/dist/src/cli/platforms/scaffold.js +72 -0
  387. package/framework-mcp/dist/src/cli/platforms/utils.js +75 -0
  388. package/framework-mcp/dist/src/cli/utils/claude.js +57 -0
  389. package/framework-mcp/dist/src/cli/utils/compliance.js +12 -0
  390. package/framework-mcp/dist/src/cli/utils/fs.js +138 -0
  391. package/framework-mcp/dist/src/cli/utils/pkg.js +282 -0
  392. package/framework-mcp/dist/src/cli/utils/quality.js +9 -0
  393. package/framework-mcp/dist/src/modules/agents/definitions.js +563 -0
  394. package/framework-mcp/dist/src/modules/agents/registry/analyst.js +39 -0
  395. package/framework-mcp/dist/src/modules/agents/registry/architect.js +42 -0
  396. package/framework-mcp/dist/src/modules/agents/registry/backend.js +50 -0
  397. package/framework-mcp/dist/src/modules/agents/registry/database.js +45 -0
  398. package/framework-mcp/dist/src/modules/agents/registry/devops.js +45 -0
  399. package/framework-mcp/dist/src/modules/agents/registry/explorer.js +37 -0
  400. package/framework-mcp/dist/src/modules/agents/registry/frontend.js +52 -0
  401. package/framework-mcp/dist/src/modules/agents/registry/git.js +36 -0
  402. package/framework-mcp/dist/src/modules/agents/registry/manager.js +64 -0
  403. package/framework-mcp/dist/src/modules/agents/registry/mobile.js +41 -0
  404. package/framework-mcp/dist/src/modules/agents/registry/native.js +41 -0
  405. package/framework-mcp/dist/src/modules/agents/registry/quality.js +43 -0
  406. package/framework-mcp/dist/src/modules/agents/registry/security.js +42 -0
  407. package/framework-mcp/dist/src/modules/agents/types.js +1 -0
  408. package/framework-mcp/dist/src/modules/engines/quality-gate.js +92 -0
  409. package/framework-mcp/dist/src/modules/engines/risk-engine.js +105 -0
  410. package/framework-mcp/dist/src/modules/engines/routing-engine.js +408 -0
  411. package/framework-mcp/dist/src/modules/engines/types.js +1 -0
  412. package/framework-mcp/dist/src/modules/memory/core.js +10 -17
  413. package/framework-mcp/dist/src/modules/memory/embedding.js +130 -0
  414. package/framework-mcp/dist/src/modules/providers/definitions.js +140 -0
  415. package/framework-mcp/dist/src/modules/providers/registry.js +18 -0
  416. package/framework-mcp/dist/src/modules/providers/shared.js +104 -0
  417. package/framework-mcp/dist/src/modules/providers/types.js +1 -0
  418. package/framework-mcp/dist/src/modules/skills/adapter-skills.js +449 -0
  419. package/framework-mcp/dist/src/modules/skills/definitions.js +70 -0
  420. package/framework-mcp/dist/src/shared/audit.js +220 -0
  421. package/framework-mcp/dist/src/shared/errors.js +68 -0
  422. package/framework-mcp/dist/src/shared/fs.js +4 -2
  423. package/framework-mcp/dist/src/shared/lock.js +159 -0
  424. package/framework-mcp/dist/src/shared/logger.js +15 -5
  425. package/framework-mcp/dist/src/shared/pii.js +212 -0
  426. package/framework-mcp/dist/src/shared/retention.js +170 -0
  427. package/framework-mcp/dist/src/shared/storage.js +49 -7
  428. package/framework-mcp/dist/src/shared/string.js +29 -0
  429. package/framework-mcp/package.json +8 -2
  430. package/mcp.json +11 -6
  431. package/package.json +22 -9
  432. package/templates/full/ATABEY_FULL.md +515 -0
@@ -0,0 +1,243 @@
1
+ /**
2
+ * ATABEY LLM Gateway — Main Gateway Class
3
+ *
4
+ * Central entry point for all LLM requests. Integrates:
5
+ * - Provider Pool (OpenAI, Anthropic, Google, Grok, Ollama)
6
+ * - Load Balancer (round-robin, least-latency, cost-optimized, failover)
7
+ * - Circuit Breaker (failure detection & recovery)
8
+ * - Rate Limiter (RPM/TPM enforcement)
9
+ * - Cost Tracker (usage & budget management)
10
+ */
11
+ import { logger } from "../../shared/logger.js";
12
+ import { classifyData, containsPII } from "../../shared/pii.js";
13
+ import { CircuitBreaker } from "./circuit-breaker.js";
14
+ import { CostTracker } from "./cost-tracker.js";
15
+ import { LoadBalancer } from "./load-balancer.js";
16
+ import { createProvider, getAvailableProviderIds, } from "./providers/index.js";
17
+ import { RateLimiter } from "./rate-limiter.js";
18
+ export class LLMGateway {
19
+ loadBalancer;
20
+ circuitBreaker;
21
+ rateLimiter;
22
+ costTracker;
23
+ initialized = false;
24
+ constructor() {
25
+ this.circuitBreaker = new CircuitBreaker();
26
+ this.rateLimiter = new RateLimiter();
27
+ this.loadBalancer = new LoadBalancer(this.circuitBreaker, this.rateLimiter);
28
+ this.costTracker = new CostTracker();
29
+ }
30
+ /**
31
+ * Initialize the gateway with all providers.
32
+ * Call once at startup. Can be reconfigured later.
33
+ */
34
+ initialize(config) {
35
+ const enabledProviders = config?.enabledProviders || getAvailableProviderIds();
36
+ for (const id of enabledProviders) {
37
+ try {
38
+ const provider = createProvider(id);
39
+ this.loadBalancer.registerProvider(provider);
40
+ logger.info(`[GATEWAY] Provider initialized: ${id}`);
41
+ }
42
+ catch (error) {
43
+ logger.warn(`[GATEWAY] Failed to initialize provider ${id}: ${error.message}`);
44
+ }
45
+ }
46
+ if (config?.strategy) {
47
+ this.loadBalancer.setStrategy(config.strategy);
48
+ }
49
+ if (config?.monthlyBudget) {
50
+ this.costTracker.setBudget(config.monthlyBudget);
51
+ }
52
+ this.initialized = true;
53
+ logger.info(`[GATEWAY] Initialized with ${enabledProviders.length} providers`);
54
+ }
55
+ /**
56
+ * Ensure the gateway is initialized.
57
+ */
58
+ ensureInitialized() {
59
+ if (!this.initialized) {
60
+ this.initialize();
61
+ }
62
+ }
63
+ /**
64
+ * Send a chat completion request through the gateway.
65
+ * Automatically selects the best provider and handles retries.
66
+ */
67
+ async chat(request) {
68
+ if (!this.initialized) {
69
+ this.initialize();
70
+ }
71
+ const traceId = request.traceId || `G-${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
72
+ const estimatedTokens = this.estimateRequestTokens(request);
73
+ const maxRetries = 2;
74
+ // [KVKK/GDPR] PII check for external API calls
75
+ const requestText = [
76
+ request.system || "",
77
+ ...request.messages.map(m => m.content)
78
+ ].join(" ");
79
+ const classification = classifyData(requestText);
80
+ if (classification === "restricted" || containsPII(requestText)) {
81
+ logger.warn("[KVKK] Potential PII detected in request to external provider. " +
82
+ `Classification: ${classification}. Trace: ${traceId}. ` +
83
+ "Consider using a local provider (Ollama) for sensitive data.");
84
+ }
85
+ for (let attempt = 0; attempt <= maxRetries; attempt++) {
86
+ try {
87
+ // Select the best provider
88
+ const provider = await this.loadBalancer.selectProvider(request.provider, request.model, estimatedTokens);
89
+ // Check rate limits
90
+ if (!this.rateLimiter.check(provider.config.id, estimatedTokens)) {
91
+ logger.warn(`[GATEWAY] Rate limited on ${provider.config.id}, trying next provider`);
92
+ continue;
93
+ }
94
+ // Circuit breaker check
95
+ if (!this.circuitBreaker.isAllowed(provider.config.id)) {
96
+ logger.warn(`[GATEWAY] Circuit open for ${provider.config.id}, trying next provider`);
97
+ continue;
98
+ }
99
+ logger.info(`[GATEWAY] Sending to ${provider.config.id}/${request.model || provider.config.defaultModel} ` +
100
+ `(attempt ${attempt + 1}, strategy: ${this.loadBalancer.getStrategy()})`);
101
+ // Execute the request
102
+ const startTime = Date.now();
103
+ const response = await provider.chat({
104
+ ...request,
105
+ traceId,
106
+ });
107
+ const latencyMs = Date.now() - startTime;
108
+ // Record results
109
+ this.rateLimiter.record(provider.config.id, response.usage.totalTokens);
110
+ this.loadBalancer.recordLatency(provider.config.id, latencyMs);
111
+ if (response.success) {
112
+ this.circuitBreaker.recordSuccess(provider.config.id);
113
+ this.costTracker.record({
114
+ provider: provider.config.id,
115
+ model: response.model,
116
+ inputTokens: response.usage.inputTokens,
117
+ outputTokens: response.usage.outputTokens,
118
+ cost: response.cost,
119
+ timestamp: new Date().toISOString(),
120
+ traceId,
121
+ });
122
+ logger.info(`[GATEWAY] Success from ${provider.config.id} ` +
123
+ `(${response.usage.totalTokens} tokens, $${response.cost.toFixed(6)}, ${latencyMs}ms)`);
124
+ return { ...response, traceId };
125
+ }
126
+ // Failed — record failure and retry
127
+ this.circuitBreaker.recordFailure(provider.config.id);
128
+ logger.warn(`[GATEWAY] ${provider.config.id} failed: ${response.content.substring(0, 100)}. ` +
129
+ `Retries left: ${maxRetries - attempt}`);
130
+ }
131
+ catch (error) {
132
+ logger.warn(`[GATEWAY] Attempt ${attempt + 1} failed: ${error.message}. ` +
133
+ `Retries left: ${maxRetries - attempt}`);
134
+ // Circuit breaker will be updated by the provider on next attempt
135
+ }
136
+ }
137
+ // All attempts exhausted
138
+ logger.error(`[GATEWAY] All ${maxRetries + 1} attempts exhausted for trace ${traceId}`);
139
+ return {
140
+ success: false,
141
+ content: `All providers failed after ${maxRetries + 1} attempts. Check provider health with 'atabey gateway status'.`,
142
+ model: request.model || "unknown",
143
+ provider: "openai",
144
+ usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
145
+ latencyMs: 0,
146
+ cost: 0,
147
+ cached: false,
148
+ traceId,
149
+ };
150
+ }
151
+ /**
152
+ * Stream a chat completion response through the gateway.
153
+ */
154
+ async *chatStream(request) {
155
+ if (!this.initialized) {
156
+ this.initialize();
157
+ }
158
+ const estimatedTokens = this.estimateRequestTokens(request);
159
+ try {
160
+ const provider = await this.loadBalancer.selectProvider(request.provider, request.model, estimatedTokens);
161
+ if (!this.circuitBreaker.isAllowed(provider.config.id)) {
162
+ yield {
163
+ content: `Circuit breaker open for ${provider.config.id}`,
164
+ done: true,
165
+ provider: provider.config.id,
166
+ model: request.model || provider.config.defaultModel,
167
+ };
168
+ return;
169
+ }
170
+ const stream = provider.chatStream(request);
171
+ for await (const chunk of stream) {
172
+ yield chunk;
173
+ if (chunk.done) {
174
+ this.circuitBreaker.recordSuccess(provider.config.id);
175
+ this.rateLimiter.record(provider.config.id, chunk.usage?.outputTokens || 100);
176
+ }
177
+ }
178
+ }
179
+ catch (error) {
180
+ yield {
181
+ content: `Stream failed: ${error.message}`,
182
+ done: true,
183
+ provider: "openai",
184
+ model: request.model || "unknown",
185
+ };
186
+ }
187
+ }
188
+ /**
189
+ * Get gateway statistics.
190
+ */
191
+ getStats() {
192
+ return this.costTracker.getStats();
193
+ }
194
+ /**
195
+ * Get provider health status.
196
+ */
197
+ getProviderHealth() {
198
+ return this.loadBalancer.getProviderHealthList();
199
+ }
200
+ /**
201
+ * Reset all circuit breakers.
202
+ */
203
+ resetCircuitBreakers() {
204
+ for (const id of getAvailableProviderIds()) {
205
+ this.circuitBreaker.reset(id);
206
+ }
207
+ logger.info("[GATEWAY] All circuit breakers reset");
208
+ }
209
+ /**
210
+ * Enable or disable a provider.
211
+ */
212
+ setProviderEnabled(id, enabled) {
213
+ const provider = this.loadBalancer.getProvider(id);
214
+ if (provider) {
215
+ provider.config.enabled = enabled;
216
+ logger.info(`[GATEWAY] Provider ${id} ${enabled ? "enabled" : "disabled"}`);
217
+ }
218
+ }
219
+ /**
220
+ * Add a custom provider programmatically.
221
+ */
222
+ addCustomProvider(id, provider) {
223
+ this.loadBalancer.registerProvider(provider);
224
+ logger.info(`[GATEWAY] Custom provider added: ${id}`);
225
+ }
226
+ /**
227
+ * Estimate token count from request messages.
228
+ */
229
+ estimateRequestTokens(request) {
230
+ let total = 0;
231
+ if (request.system)
232
+ total += request.system.length / 4;
233
+ for (const msg of request.messages) {
234
+ total += msg.content.length / 4;
235
+ }
236
+ return Math.ceil(total);
237
+ }
238
+ }
239
+ /**
240
+ * Singleton gateway instance for global use.
241
+ */
242
+ export const gateway = new LLMGateway();
243
+ //# sourceMappingURL=gateway.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../../../src/modules/gateway/gateway.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * ATABEY LLM Gateway — Public API
3
+ *
4
+ * Single entry point for all gateway functionality.
5
+ */
6
+ export { CircuitBreaker } from "./circuit-breaker.js";
7
+ export { CostTracker } from "./cost-tracker.js";
8
+ export { gateway, LLMGateway } from "./gateway.js";
9
+ export { LoadBalancer } from "./load-balancer.js";
10
+ export { AnthropicProvider } from "./providers/anthropic.js";
11
+ export { BaseProvider } from "./providers/base.js";
12
+ export { GoogleProvider } from "./providers/google.js";
13
+ export { GrokProvider } from "./providers/grok.js";
14
+ export { createProvider, getAvailableProviderIds } from "./providers/index.js";
15
+ export { OllamaProvider } from "./providers/ollama.js";
16
+ export { OpenAIProvider } from "./providers/openai.js";
17
+ export { RateLimiter } from "./rate-limiter.js";
18
+ export type { CircuitBreakerState, CostEntry, GatewayMessage, GatewayRequest, GatewayResponse, GatewayStats, LoadBalanceStrategy, ProviderConfig, ProviderHealth, ProviderId, RateLimitState, StreamChunk } from "./types.js";
19
+ export { PROVIDER_IDS } from "./types.js";
@@ -0,0 +1,19 @@
1
+ /**
2
+ * ATABEY LLM Gateway — Public API
3
+ *
4
+ * Single entry point for all gateway functionality.
5
+ */
6
+ export { CircuitBreaker } from "./circuit-breaker.js";
7
+ export { CostTracker } from "./cost-tracker.js";
8
+ export { gateway, LLMGateway } from "./gateway.js";
9
+ export { LoadBalancer } from "./load-balancer.js";
10
+ export { AnthropicProvider } from "./providers/anthropic.js";
11
+ export { BaseProvider } from "./providers/base.js";
12
+ export { GoogleProvider } from "./providers/google.js";
13
+ export { GrokProvider } from "./providers/grok.js";
14
+ export { createProvider, getAvailableProviderIds } from "./providers/index.js";
15
+ export { OllamaProvider } from "./providers/ollama.js";
16
+ export { OpenAIProvider } from "./providers/openai.js";
17
+ export { RateLimiter } from "./rate-limiter.js";
18
+ export { PROVIDER_IDS } from "./types.js";
19
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/gateway/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQhD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,86 @@
1
+ import { CircuitBreaker } from "./circuit-breaker.js";
2
+ import { BaseProvider } from "./providers/base.js";
3
+ import { RateLimiter } from "./rate-limiter.js";
4
+ import { LoadBalanceStrategy, ProviderId } from "./types.js";
5
+ export declare class LoadBalancer {
6
+ private providers;
7
+ private circuitBreaker;
8
+ private rateLimiter;
9
+ private currentIndex;
10
+ private latencies;
11
+ private strategy;
12
+ constructor(circuitBreaker: CircuitBreaker, rateLimiter: RateLimiter);
13
+ /**
14
+ * Set the load balancing strategy.
15
+ */
16
+ setStrategy(strategy: LoadBalanceStrategy): void;
17
+ /**
18
+ * Get current strategy.
19
+ */
20
+ getStrategy(): LoadBalanceStrategy;
21
+ /**
22
+ * Register a provider with the load balancer.
23
+ */
24
+ registerProvider(provider: BaseProvider): void;
25
+ /**
26
+ * Select the best provider based on current strategy.
27
+ * Returns the selected provider or throws if none available.
28
+ */
29
+ selectProvider(preferredProvider?: ProviderId, model?: string, estimatedTokens?: number): Promise<BaseProvider>;
30
+ /**
31
+ * Record latency for a provider (for least-latency strategy).
32
+ */
33
+ recordLatency(provider: ProviderId, latencyMs: number): void;
34
+ /**
35
+ * Get all registered providers.
36
+ */
37
+ getAllProviders(): BaseProvider[];
38
+ /**
39
+ * Get a provider by ID.
40
+ */
41
+ getProvider(id: ProviderId): BaseProvider | undefined;
42
+ /**
43
+ * Get available (healthy and not rate-limited) providers.
44
+ */
45
+ getAvailableProviders(estimatedTokens: number): BaseProvider[];
46
+ /**
47
+ * Check if a provider is available (healthy + not rate-limited).
48
+ */
49
+ private isAvailable;
50
+ /**
51
+ * Round-robin selection.
52
+ */
53
+ private selectRoundRobin;
54
+ /**
55
+ * Least-latency selection.
56
+ */
57
+ private selectLeastLatency;
58
+ /**
59
+ * Cost-optimized selection.
60
+ */
61
+ private selectCostOptimized;
62
+ /**
63
+ * Priority-based selection (strict priority order).
64
+ */
65
+ private selectPriorityBased;
66
+ /**
67
+ * Failover selection — try in priority order.
68
+ */
69
+ private selectFailover;
70
+ /**
71
+ * Model-based selection.
72
+ */
73
+ private selectByModel;
74
+ /**
75
+ * Get sorted provider list with health status.
76
+ */
77
+ getProviderHealthList(): Array<{
78
+ id: ProviderId;
79
+ name: string;
80
+ healthy: boolean;
81
+ latencyMs: number;
82
+ priority: number;
83
+ enabled: boolean;
84
+ models: string[];
85
+ }>;
86
+ }
@@ -0,0 +1,230 @@
1
+ /**
2
+ * ATABEY LLM Gateway — Load Balancer
3
+ *
4
+ * Distributes LLM requests across multiple providers using configurable strategies:
5
+ * - round-robin: Cycle through providers in order
6
+ * - least-latency: Pick the provider with lowest average latency
7
+ * - cost-optimized: Pick the cheapest provider for the task
8
+ * - failover: Try providers in priority order
9
+ * - priority-based: Strictly follow priority order
10
+ * - model-based: Pick provider based on best model match
11
+ */
12
+ import { logger } from "../../shared/logger.js";
13
+ export class LoadBalancer {
14
+ providers = new Map();
15
+ circuitBreaker;
16
+ rateLimiter;
17
+ currentIndex = 0;
18
+ latencies = new Map();
19
+ strategy = "failover";
20
+ constructor(circuitBreaker, rateLimiter) {
21
+ this.circuitBreaker = circuitBreaker;
22
+ this.rateLimiter = rateLimiter;
23
+ }
24
+ /**
25
+ * Set the load balancing strategy.
26
+ */
27
+ setStrategy(strategy) {
28
+ this.strategy = strategy;
29
+ logger.info(`[LOAD] Strategy set to: ${strategy}`);
30
+ }
31
+ /**
32
+ * Get current strategy.
33
+ */
34
+ getStrategy() {
35
+ return this.strategy;
36
+ }
37
+ /**
38
+ * Register a provider with the load balancer.
39
+ */
40
+ registerProvider(provider) {
41
+ this.providers.set(provider.config.id, provider);
42
+ this.latencies.set(provider.config.id, {
43
+ provider: provider.config.id,
44
+ avgLatencyMs: 0,
45
+ sampleCount: 0,
46
+ });
47
+ this.rateLimiter.initialize(provider.config.id, provider.config.rpmLimit, provider.config.tpmLimit);
48
+ logger.info(`[LOAD] Provider registered: ${provider.config.id} (${provider.config.name})`);
49
+ }
50
+ /**
51
+ * Select the best provider based on current strategy.
52
+ * Returns the selected provider or throws if none available.
53
+ */
54
+ async selectProvider(preferredProvider, model, estimatedTokens) {
55
+ // If a specific provider is requested, try it first
56
+ if (preferredProvider) {
57
+ const provider = this.providers.get(preferredProvider);
58
+ if (provider && this.isAvailable(preferredProvider, estimatedTokens || 0)) {
59
+ return provider;
60
+ }
61
+ }
62
+ // Model-based: find provider that supports the model
63
+ if (this.strategy === "model-based" && model) {
64
+ const modelProvider = this.selectByModel(model);
65
+ if (modelProvider)
66
+ return modelProvider;
67
+ }
68
+ switch (this.strategy) {
69
+ case "round-robin":
70
+ return this.selectRoundRobin(estimatedTokens || 0);
71
+ case "least-latency":
72
+ return this.selectLeastLatency(estimatedTokens || 0);
73
+ case "cost-optimized":
74
+ return this.selectCostOptimized(estimatedTokens || 0);
75
+ case "priority-based":
76
+ return this.selectPriorityBased(estimatedTokens || 0);
77
+ case "failover":
78
+ default:
79
+ return this.selectFailover(estimatedTokens || 0);
80
+ }
81
+ }
82
+ /**
83
+ * Record latency for a provider (for least-latency strategy).
84
+ */
85
+ recordLatency(provider, latencyMs) {
86
+ const record = this.latencies.get(provider);
87
+ if (record) {
88
+ const total = record.avgLatencyMs * record.sampleCount + latencyMs;
89
+ record.sampleCount++;
90
+ record.avgLatencyMs = total / record.sampleCount;
91
+ }
92
+ }
93
+ /**
94
+ * Get all registered providers.
95
+ */
96
+ getAllProviders() {
97
+ return Array.from(this.providers.values());
98
+ }
99
+ /**
100
+ * Get a provider by ID.
101
+ */
102
+ getProvider(id) {
103
+ return this.providers.get(id);
104
+ }
105
+ /**
106
+ * Get available (healthy and not rate-limited) providers.
107
+ */
108
+ getAvailableProviders(estimatedTokens) {
109
+ return this.getAllProviders().filter(p => this.isAvailable(p.config.id, estimatedTokens));
110
+ }
111
+ /**
112
+ * Check if a provider is available (healthy + not rate-limited).
113
+ */
114
+ isAvailable(providerId, estimatedTokens) {
115
+ const provider = this.providers.get(providerId);
116
+ if (!provider || !provider.config.enabled)
117
+ return false;
118
+ if (!this.circuitBreaker.isAllowed(providerId))
119
+ return false;
120
+ if (!this.rateLimiter.check(providerId, estimatedTokens))
121
+ return false;
122
+ return true;
123
+ }
124
+ /**
125
+ * Round-robin selection.
126
+ */
127
+ selectRoundRobin(estimatedTokens) {
128
+ const available = this.getAvailableProviders(estimatedTokens);
129
+ if (available.length === 0) {
130
+ throw new Error("No available providers (all circuits open or rate limited)");
131
+ }
132
+ // Cycle through available providers
133
+ this.currentIndex = (this.currentIndex + 1) % available.length;
134
+ return available[this.currentIndex];
135
+ }
136
+ /**
137
+ * Least-latency selection.
138
+ */
139
+ selectLeastLatency(estimatedTokens) {
140
+ const available = this.getAvailableProviders(estimatedTokens);
141
+ if (available.length === 0) {
142
+ throw new Error("No available providers");
143
+ }
144
+ // Sort by average latency (ascending)
145
+ available.sort((a, b) => {
146
+ const la = this.latencies.get(a.config.id)?.avgLatencyMs || Infinity;
147
+ const lb = this.latencies.get(b.config.id)?.avgLatencyMs || Infinity;
148
+ return la - lb;
149
+ });
150
+ return available[0];
151
+ }
152
+ /**
153
+ * Cost-optimized selection.
154
+ */
155
+ selectCostOptimized(estimatedTokens) {
156
+ const available = this.getAvailableProviders(estimatedTokens);
157
+ if (available.length === 0) {
158
+ throw new Error("No available providers");
159
+ }
160
+ // Sort by combined input+output cost (ascending)
161
+ available.sort((a, b) => {
162
+ const costA = a.config.costPer1kInputTokens + a.config.costPer1kOutputTokens;
163
+ const costB = b.config.costPer1kInputTokens + b.config.costPer1kOutputTokens;
164
+ return costA - costB;
165
+ });
166
+ return available[0];
167
+ }
168
+ /**
169
+ * Priority-based selection (strict priority order).
170
+ */
171
+ selectPriorityBased(estimatedTokens) {
172
+ const available = this.getAvailableProviders(estimatedTokens);
173
+ // Sort by priority (ascending = higher priority first)
174
+ available.sort((a, b) => a.config.priority - b.config.priority);
175
+ // Weighted random selection
176
+ const totalWeight = available.reduce((sum, p) => sum + p.config.weight, 0);
177
+ let random = Math.random() * totalWeight;
178
+ for (const provider of available) {
179
+ random -= provider.config.weight;
180
+ if (random <= 0)
181
+ return provider;
182
+ }
183
+ return available[0];
184
+ }
185
+ /**
186
+ * Failover selection — try in priority order.
187
+ */
188
+ selectFailover(estimatedTokens) {
189
+ // Sort all providers by priority (ascending = higher priority first)
190
+ const sorted = Array.from(this.providers.values()).sort((a, b) => a.config.priority - b.config.priority);
191
+ for (const provider of sorted) {
192
+ if (this.isAvailable(provider.config.id, estimatedTokens)) {
193
+ return provider;
194
+ }
195
+ }
196
+ throw new Error("No available providers (all circuits open or rate limited)");
197
+ }
198
+ /**
199
+ * Model-based selection.
200
+ */
201
+ selectByModel(model) {
202
+ for (const provider of this.providers.values()) {
203
+ if (provider.supportsModel(model)) {
204
+ return provider;
205
+ }
206
+ }
207
+ return null;
208
+ }
209
+ /**
210
+ * Get sorted provider list with health status.
211
+ */
212
+ getProviderHealthList() {
213
+ const result = [];
214
+ for (const [id, provider] of this.providers) {
215
+ const health = this.circuitBreaker.getState(id);
216
+ const latency = this.latencies.get(id);
217
+ result.push({
218
+ id,
219
+ name: provider.config.name,
220
+ healthy: health?.state === "CLOSED" && provider.config.enabled,
221
+ latencyMs: latency?.avgLatencyMs || 0,
222
+ priority: provider.config.priority,
223
+ enabled: provider.config.enabled,
224
+ models: provider.config.models,
225
+ });
226
+ }
227
+ return result.sort((a, b) => a.priority - b.priority);
228
+ }
229
+ }
230
+ //# sourceMappingURL=load-balancer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"load-balancer.js","sourceRoot":"","sources":["../../../../src/modules/gateway/load-balancer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAYhD,MAAM,OAAO,YAAY;IACb,SAAS,GAAkC,IAAI,GAAG,EAAE,CAAC;IACrD,cAAc,CAAiB;IAC/B,WAAW,CAAc;IACzB,YAAY,GAAG,CAAC,CAAC;IACjB,SAAS,GAAmC,IAAI,GAAG,EAAE,CAAC;IACtD,QAAQ,GAAwB,UAAU,CAAC;IAEnD,YAAY,cAA8B,EAAE,WAAwB;QAChE,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,CAAC;IAED;;KAEC;IACD,WAAW,CAAC,QAA6B;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;KAEC;IACD,WAAW;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;KAEC;IACD,gBAAgB,CAAC,QAAsB;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE;YACnC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE;YAC5B,YAAY,EAAE,CAAC;YACf,WAAW,EAAE,CAAC;SACjB,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,UAAU,CACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,EAClB,QAAQ,CAAC,MAAM,CAAC,QAAQ,EACxB,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAC3B,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,+BAA+B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;IAC/F,CAAC;IAED;;;KAGC;IACD,KAAK,CAAC,cAAc,CAChB,iBAA8B,EAC9B,KAAc,EACd,eAAwB;QAE5B,oDAAoD;QAChD,IAAI,iBAAiB,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;YACvD,IAAI,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,iBAAiB,EAAE,eAAe,IAAI,CAAC,CAAC,EAAE,CAAC;gBACxE,OAAO,QAAQ,CAAC;YACpB,CAAC;QACL,CAAC;QAED,qDAAqD;QACrD,IAAI,IAAI,CAAC,QAAQ,KAAK,aAAa,IAAI,KAAK,EAAE,CAAC;YAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,aAAa;gBAAE,OAAO,aAAa,CAAC;QAC5C,CAAC;QAED,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpB,KAAK,aAAa;gBACd,OAAO,IAAI,CAAC,gBAAgB,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;YACvD,KAAK,eAAe;gBAChB,OAAO,IAAI,CAAC,kBAAkB,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;YACzD,KAAK,gBAAgB;gBACjB,OAAO,IAAI,CAAC,mBAAmB,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;YAC1D,KAAK,gBAAgB;gBACjB,OAAO,IAAI,CAAC,mBAAmB,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;YAC1D,KAAK,UAAU,CAAC;YAChB;gBACI,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;IAED;;KAEC;IACD,aAAa,CAAC,QAAoB,EAAE,SAAiB;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC;YACnE,MAAM,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,CAAC,YAAY,GAAG,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC;QACrD,CAAC;IACL,CAAC;IAED;;KAEC;IACD,eAAe;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;KAEC;IACD,WAAW,CAAC,EAAc;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED;;KAEC;IACD,qBAAqB,CAAC,eAAuB;QACzC,OAAO,IAAI,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACrC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,eAAe,CAAC,CACjD,CAAC;IACN,CAAC;IAED;;KAEC;IACO,WAAW,CAAC,UAAsB,EAAE,eAAuB;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,UAAU,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7D,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,eAAe,CAAC;YAAE,OAAO,KAAK,CAAC;QACvE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;KAEC;IACO,gBAAgB,CAAC,eAAuB;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QAC9D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAClF,CAAC;QAED,oCAAoC;QACpC,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;QAC/D,OAAO,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACxC,CAAC;IAED;;KAEC;IACO,kBAAkB,CAAC,eAAuB;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QAC9D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC9C,CAAC;QAED,sCAAsC;QACtC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACpB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,YAAY,IAAI,QAAQ,CAAC;YACrE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,YAAY,IAAI,QAAQ,CAAC;YACrE,OAAO,EAAE,GAAG,EAAE,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED;;KAEC;IACO,mBAAmB,CAAC,eAAuB;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QAC9D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC9C,CAAC;QAED,iDAAiD;QACjD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACpB,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC;YAC7E,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC;YAC7E,OAAO,KAAK,GAAG,KAAK,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED;;KAEC;IACO,mBAAmB,CAAC,eAAuB;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC;QAE9D,uDAAuD;QACvD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEhE,4BAA4B;QAC5B,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAC3E,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC;QAEzC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;YACjC,IAAI,MAAM,IAAI,CAAC;gBAAE,OAAO,QAAQ,CAAC;QACrC,CAAC;QAED,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IAED;;KAEC;IACO,cAAc,CAAC,eAAuB;QAC9C,qEAAqE;QACjE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACnD,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAClD,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,eAAe,CAAC,EAAE,CAAC;gBACxD,OAAO,QAAQ,CAAC;YACpB,CAAC;QACL,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAClF,CAAC;IAED;;KAEC;IACO,aAAa,CAAC,KAAa;QAC/B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,IAAI,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChC,OAAO,QAAQ,CAAC;YACpB,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;KAEC;IACD,qBAAqB;QASjB,MAAM,MAAM,GAQX,EAAE,CAAC;QAEJ,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvC,MAAM,CAAC,IAAI,CAAC;gBACR,EAAE;gBACF,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI;gBAC1B,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO;gBAC9D,SAAS,EAAE,OAAO,EAAE,YAAY,IAAI,CAAC;gBACrC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;gBAClC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO;gBAChC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM;aACjC,CAAC,CAAC;QACP,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC;CACJ"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * ATABEY LLM Gateway — Anthropic (Claude) Provider
3
+ *
4
+ * Supports Claude 3.5 Sonnet, Claude 3 Opus, Claude 3 Haiku models via Anthropic API.
5
+ */
6
+ import { GatewayRequest, GatewayResponse, ProviderConfig, StreamChunk } from "../types.js";
7
+ import { BaseProvider } from "./base.js";
8
+ export declare class AnthropicProvider extends BaseProvider {
9
+ constructor(config?: Partial<ProviderConfig>);
10
+ get id(): string;
11
+ get name(): string;
12
+ chat(request: GatewayRequest): Promise<GatewayResponse>;
13
+ chatStream(request: GatewayRequest): AsyncGenerator<StreamChunk>;
14
+ }