@salimassili/ai-costguard 1.1.3

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 (490) hide show
  1. package/README.md +112 -0
  2. package/dist/aecl/ExecutionInterceptor.d.ts +111 -0
  3. package/dist/aecl/ExecutionInterceptor.d.ts.map +1 -0
  4. package/dist/aecl/ExecutionInterceptor.js +280 -0
  5. package/dist/aecl/ExecutionInterceptor.js.map +1 -0
  6. package/dist/aecl/ExecutionMemory.d.ts +103 -0
  7. package/dist/aecl/ExecutionMemory.d.ts.map +1 -0
  8. package/dist/aecl/ExecutionMemory.js +164 -0
  9. package/dist/aecl/ExecutionMemory.js.map +1 -0
  10. package/dist/aecl/PolicyEngine.d.ts +77 -0
  11. package/dist/aecl/PolicyEngine.d.ts.map +1 -0
  12. package/dist/aecl/PolicyEngine.js +170 -0
  13. package/dist/aecl/PolicyEngine.js.map +1 -0
  14. package/dist/aecl/ROITelemetry.d.ts +110 -0
  15. package/dist/aecl/ROITelemetry.d.ts.map +1 -0
  16. package/dist/aecl/ROITelemetry.js +211 -0
  17. package/dist/aecl/ROITelemetry.js.map +1 -0
  18. package/dist/aecl/RiskEngine.d.ts +90 -0
  19. package/dist/aecl/RiskEngine.d.ts.map +1 -0
  20. package/dist/aecl/RiskEngine.js +207 -0
  21. package/dist/aecl/RiskEngine.js.map +1 -0
  22. package/dist/aecl/index.d.ts +76 -0
  23. package/dist/aecl/index.d.ts.map +1 -0
  24. package/dist/aecl/index.js +111 -0
  25. package/dist/aecl/index.js.map +1 -0
  26. package/dist/aerl/ExecutionGraph.d.ts +123 -0
  27. package/dist/aerl/ExecutionGraph.d.ts.map +1 -0
  28. package/dist/aerl/ExecutionGraph.js +289 -0
  29. package/dist/aerl/ExecutionGraph.js.map +1 -0
  30. package/dist/aerl/ExecutionInterceptor.d.ts +94 -0
  31. package/dist/aerl/ExecutionInterceptor.d.ts.map +1 -0
  32. package/dist/aerl/ExecutionInterceptor.js +246 -0
  33. package/dist/aerl/ExecutionInterceptor.js.map +1 -0
  34. package/dist/aerl/ExecutionMemory.d.ts +138 -0
  35. package/dist/aerl/ExecutionMemory.d.ts.map +1 -0
  36. package/dist/aerl/ExecutionMemory.js +284 -0
  37. package/dist/aerl/ExecutionMemory.js.map +1 -0
  38. package/dist/aerl/FailurePrediction.d.ts +71 -0
  39. package/dist/aerl/FailurePrediction.d.ts.map +1 -0
  40. package/dist/aerl/FailurePrediction.js +204 -0
  41. package/dist/aerl/FailurePrediction.js.map +1 -0
  42. package/dist/aerl/RecoveryEngine.d.ts +74 -0
  43. package/dist/aerl/RecoveryEngine.d.ts.map +1 -0
  44. package/dist/aerl/RecoveryEngine.js +194 -0
  45. package/dist/aerl/RecoveryEngine.js.map +1 -0
  46. package/dist/aerl/ReliabilityEngine.d.ts +74 -0
  47. package/dist/aerl/ReliabilityEngine.d.ts.map +1 -0
  48. package/dist/aerl/ReliabilityEngine.js +205 -0
  49. package/dist/aerl/ReliabilityEngine.js.map +1 -0
  50. package/dist/aerl/ReliabilityTelemetry.d.ts +118 -0
  51. package/dist/aerl/ReliabilityTelemetry.d.ts.map +1 -0
  52. package/dist/aerl/ReliabilityTelemetry.js +247 -0
  53. package/dist/aerl/ReliabilityTelemetry.js.map +1 -0
  54. package/dist/aerl/index.d.ts +170 -0
  55. package/dist/aerl/index.d.ts.map +1 -0
  56. package/dist/aerl/index.js +223 -0
  57. package/dist/aerl/index.js.map +1 -0
  58. package/dist/ambient/AmbientProtection.d.ts +79 -0
  59. package/dist/ambient/AmbientProtection.d.ts.map +1 -0
  60. package/dist/ambient/AmbientProtection.js +251 -0
  61. package/dist/ambient/AmbientProtection.js.map +1 -0
  62. package/dist/bin/start.d.ts +14 -0
  63. package/dist/bin/start.d.ts.map +1 -0
  64. package/dist/bin/start.js +54 -0
  65. package/dist/bin/start.js.map +1 -0
  66. package/dist/cli/index.d.ts +3 -0
  67. package/dist/cli/index.d.ts.map +1 -0
  68. package/dist/cli/index.js +64 -0
  69. package/dist/cli/index.js.map +1 -0
  70. package/dist/cli/outputContract.d.ts +19 -0
  71. package/dist/cli/outputContract.d.ts.map +1 -0
  72. package/dist/cli/outputContract.js +54 -0
  73. package/dist/cli/outputContract.js.map +1 -0
  74. package/dist/cli/storage.d.ts +61 -0
  75. package/dist/cli/storage.d.ts.map +1 -0
  76. package/dist/cli/storage.js +143 -0
  77. package/dist/cli/storage.js.map +1 -0
  78. package/dist/client.d.ts +29 -0
  79. package/dist/client.d.ts.map +1 -0
  80. package/dist/client.js +58 -0
  81. package/dist/client.js.map +1 -0
  82. package/dist/config/constants.d.ts +109 -0
  83. package/dist/config/constants.d.ts.map +1 -0
  84. package/dist/config/constants.js +151 -0
  85. package/dist/config/constants.js.map +1 -0
  86. package/dist/config/index.d.ts +5 -0
  87. package/dist/config/index.d.ts.map +1 -0
  88. package/dist/config/index.js +21 -0
  89. package/dist/config/index.js.map +1 -0
  90. package/dist/config/pricing.d.ts +12 -0
  91. package/dist/config/pricing.d.ts.map +1 -0
  92. package/dist/config/pricing.js +45 -0
  93. package/dist/config/pricing.js.map +1 -0
  94. package/dist/config/productionConfig.d.ts +8 -0
  95. package/dist/config/productionConfig.d.ts.map +1 -0
  96. package/dist/config/productionConfig.js +21 -0
  97. package/dist/config/productionConfig.js.map +1 -0
  98. package/dist/config/userConfig.d.ts +31 -0
  99. package/dist/config/userConfig.d.ts.map +1 -0
  100. package/dist/config/userConfig.js +116 -0
  101. package/dist/config/userConfig.js.map +1 -0
  102. package/dist/controlPlane/configServer.d.ts +7 -0
  103. package/dist/controlPlane/configServer.d.ts.map +1 -0
  104. package/dist/controlPlane/configServer.js +47 -0
  105. package/dist/controlPlane/configServer.js.map +1 -0
  106. package/dist/core/AgentBehaviorGraph.d.ts +163 -0
  107. package/dist/core/AgentBehaviorGraph.d.ts.map +1 -0
  108. package/dist/core/AgentBehaviorGraph.js +341 -0
  109. package/dist/core/AgentBehaviorGraph.js.map +1 -0
  110. package/dist/core/AlertManager.d.ts +19 -0
  111. package/dist/core/AlertManager.d.ts.map +1 -0
  112. package/dist/core/AlertManager.js +64 -0
  113. package/dist/core/AlertManager.js.map +1 -0
  114. package/dist/core/AuditTrail.d.ts +107 -0
  115. package/dist/core/AuditTrail.d.ts.map +1 -0
  116. package/dist/core/AuditTrail.js +256 -0
  117. package/dist/core/AuditTrail.js.map +1 -0
  118. package/dist/core/CostLedger.d.ts +135 -0
  119. package/dist/core/CostLedger.d.ts.map +1 -0
  120. package/dist/core/CostLedger.js +224 -0
  121. package/dist/core/CostLedger.js.map +1 -0
  122. package/dist/core/CostPredictionEngine.d.ts +110 -0
  123. package/dist/core/CostPredictionEngine.d.ts.map +1 -0
  124. package/dist/core/CostPredictionEngine.js +225 -0
  125. package/dist/core/CostPredictionEngine.js.map +1 -0
  126. package/dist/core/CostTruthEngine.d.ts +108 -0
  127. package/dist/core/CostTruthEngine.d.ts.map +1 -0
  128. package/dist/core/CostTruthEngine.js +170 -0
  129. package/dist/core/CostTruthEngine.js.map +1 -0
  130. package/dist/core/DetectionEngine.d.ts +147 -0
  131. package/dist/core/DetectionEngine.d.ts.map +1 -0
  132. package/dist/core/DetectionEngine.js +429 -0
  133. package/dist/core/DetectionEngine.js.map +1 -0
  134. package/dist/core/ExecutionInterceptor.d.ts +135 -0
  135. package/dist/core/ExecutionInterceptor.d.ts.map +1 -0
  136. package/dist/core/ExecutionInterceptor.js +285 -0
  137. package/dist/core/ExecutionInterceptor.js.map +1 -0
  138. package/dist/core/ExplainabilityLayer.d.ts +109 -0
  139. package/dist/core/ExplainabilityLayer.d.ts.map +1 -0
  140. package/dist/core/ExplainabilityLayer.js +277 -0
  141. package/dist/core/ExplainabilityLayer.js.map +1 -0
  142. package/dist/core/LearningSystem.d.ts +124 -0
  143. package/dist/core/LearningSystem.d.ts.map +1 -0
  144. package/dist/core/LearningSystem.js +294 -0
  145. package/dist/core/LearningSystem.js.map +1 -0
  146. package/dist/core/Logger.d.ts +122 -0
  147. package/dist/core/Logger.d.ts.map +1 -0
  148. package/dist/core/Logger.js +233 -0
  149. package/dist/core/Logger.js.map +1 -0
  150. package/dist/core/PolicyEngine.d.ts +148 -0
  151. package/dist/core/PolicyEngine.d.ts.map +1 -0
  152. package/dist/core/PolicyEngine.js +336 -0
  153. package/dist/core/PolicyEngine.js.map +1 -0
  154. package/dist/core/PricingConfig.d.ts +55 -0
  155. package/dist/core/PricingConfig.d.ts.map +1 -0
  156. package/dist/core/PricingConfig.js +132 -0
  157. package/dist/core/PricingConfig.js.map +1 -0
  158. package/dist/core/SessionStats.d.ts +101 -0
  159. package/dist/core/SessionStats.d.ts.map +1 -0
  160. package/dist/core/SessionStats.js +261 -0
  161. package/dist/core/SessionStats.js.map +1 -0
  162. package/dist/core/StateStore.d.ts +100 -0
  163. package/dist/core/StateStore.d.ts.map +1 -0
  164. package/dist/core/StateStore.js +336 -0
  165. package/dist/core/StateStore.js.map +1 -0
  166. package/dist/core/index.d.ts +3 -0
  167. package/dist/core/index.d.ts.map +1 -0
  168. package/dist/core/index.js +19 -0
  169. package/dist/core/index.js.map +1 -0
  170. package/dist/core/types.d.ts +26 -0
  171. package/dist/core/types.d.ts.map +1 -0
  172. package/dist/core/types.js +3 -0
  173. package/dist/core/types.js.map +1 -0
  174. package/dist/cost-guard.d.ts +41 -0
  175. package/dist/cost-guard.d.ts.map +1 -0
  176. package/dist/cost-guard.js +274 -0
  177. package/dist/cost-guard.js.map +1 -0
  178. package/dist/dashboard/roiDashboard.d.ts +12 -0
  179. package/dist/dashboard/roiDashboard.d.ts.map +1 -0
  180. package/dist/dashboard/roiDashboard.js +28 -0
  181. package/dist/dashboard/roiDashboard.js.map +1 -0
  182. package/dist/demo/compareExecution.d.ts +9 -0
  183. package/dist/demo/compareExecution.d.ts.map +1 -0
  184. package/dist/demo/compareExecution.js +43 -0
  185. package/dist/demo/compareExecution.js.map +1 -0
  186. package/dist/demo/demoRunner.d.ts +16 -0
  187. package/dist/demo/demoRunner.d.ts.map +1 -0
  188. package/dist/demo/demoRunner.js +73 -0
  189. package/dist/demo/demoRunner.js.map +1 -0
  190. package/dist/firewall/costEstimator.d.ts +3 -0
  191. package/dist/firewall/costEstimator.d.ts.map +1 -0
  192. package/dist/firewall/costEstimator.js +22 -0
  193. package/dist/firewall/costEstimator.js.map +1 -0
  194. package/dist/firewall/executionGuard.d.ts +18 -0
  195. package/dist/firewall/executionGuard.d.ts.map +1 -0
  196. package/dist/firewall/executionGuard.js +80 -0
  197. package/dist/firewall/executionGuard.js.map +1 -0
  198. package/dist/firewall/loopDetector.d.ts +13 -0
  199. package/dist/firewall/loopDetector.d.ts.map +1 -0
  200. package/dist/firewall/loopDetector.js +24 -0
  201. package/dist/firewall/loopDetector.js.map +1 -0
  202. package/dist/firewall/policy.d.ts +4 -0
  203. package/dist/firewall/policy.d.ts.map +1 -0
  204. package/dist/firewall/policy.js +16 -0
  205. package/dist/firewall/policy.js.map +1 -0
  206. package/dist/firewall/types.d.ts +38 -0
  207. package/dist/firewall/types.d.ts.map +1 -0
  208. package/dist/firewall/types.js +3 -0
  209. package/dist/firewall/types.js.map +1 -0
  210. package/dist/index.d.ts +40 -0
  211. package/dist/index.d.ts.map +1 -0
  212. package/dist/index.js +76 -0
  213. package/dist/index.js.map +1 -0
  214. package/dist/logger/console.d.ts +27 -0
  215. package/dist/logger/console.d.ts.map +1 -0
  216. package/dist/logger/console.js +68 -0
  217. package/dist/logger/console.js.map +1 -0
  218. package/dist/logger/database.d.ts +40 -0
  219. package/dist/logger/database.d.ts.map +1 -0
  220. package/dist/logger/database.js +127 -0
  221. package/dist/logger/database.js.map +1 -0
  222. package/dist/logger/index.d.ts +3 -0
  223. package/dist/logger/index.d.ts.map +1 -0
  224. package/dist/logger/index.js +11 -0
  225. package/dist/logger/index.js.map +1 -0
  226. package/dist/loop-shield.d.ts +48 -0
  227. package/dist/loop-shield.d.ts.map +1 -0
  228. package/dist/loop-shield.js +436 -0
  229. package/dist/loop-shield.js.map +1 -0
  230. package/dist/metrics/BusinessMetricsEngine.d.ts +109 -0
  231. package/dist/metrics/BusinessMetricsEngine.d.ts.map +1 -0
  232. package/dist/metrics/BusinessMetricsEngine.js +222 -0
  233. package/dist/metrics/BusinessMetricsEngine.js.map +1 -0
  234. package/dist/metrics/index.d.ts +11 -0
  235. package/dist/metrics/index.d.ts.map +1 -0
  236. package/dist/metrics/index.js +17 -0
  237. package/dist/metrics/index.js.map +1 -0
  238. package/dist/middleware/expressFirewall.d.ts +51 -0
  239. package/dist/middleware/expressFirewall.d.ts.map +1 -0
  240. package/dist/middleware/expressFirewall.js +140 -0
  241. package/dist/middleware/expressFirewall.js.map +1 -0
  242. package/dist/middleware/index.d.ts +8 -0
  243. package/dist/middleware/index.d.ts.map +1 -0
  244. package/dist/middleware/index.js +15 -0
  245. package/dist/middleware/index.js.map +1 -0
  246. package/dist/middleware/withFirewall.d.ts +50 -0
  247. package/dist/middleware/withFirewall.d.ts.map +1 -0
  248. package/dist/middleware/withFirewall.js +155 -0
  249. package/dist/middleware/withFirewall.js.map +1 -0
  250. package/dist/observability/logger.d.ts +14 -0
  251. package/dist/observability/logger.d.ts.map +1 -0
  252. package/dist/observability/logger.js +21 -0
  253. package/dist/observability/logger.js.map +1 -0
  254. package/dist/observability/metrics.d.ts +17 -0
  255. package/dist/observability/metrics.d.ts.map +1 -0
  256. package/dist/observability/metrics.js +36 -0
  257. package/dist/observability/metrics.js.map +1 -0
  258. package/dist/os/ExecutionOS.d.ts +220 -0
  259. package/dist/os/ExecutionOS.d.ts.map +1 -0
  260. package/dist/os/ExecutionOS.js +398 -0
  261. package/dist/os/ExecutionOS.js.map +1 -0
  262. package/dist/os/GlobalIntelligence.d.ts +154 -0
  263. package/dist/os/GlobalIntelligence.d.ts.map +1 -0
  264. package/dist/os/GlobalIntelligence.js +374 -0
  265. package/dist/os/GlobalIntelligence.js.map +1 -0
  266. package/dist/os/PolicyMarketplace.d.ts +192 -0
  267. package/dist/os/PolicyMarketplace.d.ts.map +1 -0
  268. package/dist/os/PolicyMarketplace.js +384 -0
  269. package/dist/os/PolicyMarketplace.js.map +1 -0
  270. package/dist/os/SDKInterception.d.ts +115 -0
  271. package/dist/os/SDKInterception.d.ts.map +1 -0
  272. package/dist/os/SDKInterception.js +317 -0
  273. package/dist/os/SDKInterception.js.map +1 -0
  274. package/dist/os/index.d.ts +60 -0
  275. package/dist/os/index.d.ts.map +1 -0
  276. package/dist/os/index.js +82 -0
  277. package/dist/os/index.js.map +1 -0
  278. package/dist/proxy/index.d.ts +2 -0
  279. package/dist/proxy/index.d.ts.map +1 -0
  280. package/dist/proxy/index.js +18 -0
  281. package/dist/proxy/index.js.map +1 -0
  282. package/dist/proxy/server.d.ts +24 -0
  283. package/dist/proxy/server.d.ts.map +1 -0
  284. package/dist/proxy/server.js +395 -0
  285. package/dist/proxy/server.js.map +1 -0
  286. package/dist/public/BenchmarksPage.d.ts +60 -0
  287. package/dist/public/BenchmarksPage.d.ts.map +1 -0
  288. package/dist/public/BenchmarksPage.js +397 -0
  289. package/dist/public/BenchmarksPage.js.map +1 -0
  290. package/dist/public/DocsPage.d.ts +11 -0
  291. package/dist/public/DocsPage.d.ts.map +1 -0
  292. package/dist/public/DocsPage.js +496 -0
  293. package/dist/public/DocsPage.js.map +1 -0
  294. package/dist/public/StatusPage.d.ts +55 -0
  295. package/dist/public/StatusPage.d.ts.map +1 -0
  296. package/dist/public/StatusPage.js +344 -0
  297. package/dist/public/StatusPage.js.map +1 -0
  298. package/dist/public/index.d.ts +12 -0
  299. package/dist/public/index.d.ts.map +1 -0
  300. package/dist/public/index.js +20 -0
  301. package/dist/public/index.js.map +1 -0
  302. package/dist/replacements/axios.d.ts +14 -0
  303. package/dist/replacements/axios.d.ts.map +1 -0
  304. package/dist/replacements/axios.js +35 -0
  305. package/dist/replacements/axios.js.map +1 -0
  306. package/dist/replacements/fetch.d.ts +13 -0
  307. package/dist/replacements/fetch.d.ts.map +1 -0
  308. package/dist/replacements/fetch.js +20 -0
  309. package/dist/replacements/fetch.js.map +1 -0
  310. package/dist/replacements/openai.d.ts +14 -0
  311. package/dist/replacements/openai.d.ts.map +1 -0
  312. package/dist/replacements/openai.js +22 -0
  313. package/dist/replacements/openai.js.map +1 -0
  314. package/dist/saas/CostExplosionDemo.d.ts +56 -0
  315. package/dist/saas/CostExplosionDemo.d.ts.map +1 -0
  316. package/dist/saas/CostExplosionDemo.js +190 -0
  317. package/dist/saas/CostExplosionDemo.js.map +1 -0
  318. package/dist/saas/LiveProtection.d.ts +61 -0
  319. package/dist/saas/LiveProtection.d.ts.map +1 -0
  320. package/dist/saas/LiveProtection.js +187 -0
  321. package/dist/saas/LiveProtection.js.map +1 -0
  322. package/dist/saas/ProductionSaaS.d.ts +56 -0
  323. package/dist/saas/ProductionSaaS.d.ts.map +1 -0
  324. package/dist/saas/ProductionSaaS.js +831 -0
  325. package/dist/saas/ProductionSaaS.js.map +1 -0
  326. package/dist/saas/SaaSServer.d.ts +50 -0
  327. package/dist/saas/SaaSServer.d.ts.map +1 -0
  328. package/dist/saas/SaaSServer.js +669 -0
  329. package/dist/saas/SaaSServer.js.map +1 -0
  330. package/dist/saas/UserStore.d.ts +49 -0
  331. package/dist/saas/UserStore.d.ts.map +1 -0
  332. package/dist/saas/UserStore.js +137 -0
  333. package/dist/saas/UserStore.js.map +1 -0
  334. package/dist/saas/billingMetrics.d.ts +14 -0
  335. package/dist/saas/billingMetrics.d.ts.map +1 -0
  336. package/dist/saas/billingMetrics.js +23 -0
  337. package/dist/saas/billingMetrics.js.map +1 -0
  338. package/dist/saas/index.d.ts +12 -0
  339. package/dist/saas/index.d.ts.map +1 -0
  340. package/dist/saas/index.js +23 -0
  341. package/dist/saas/index.js.map +1 -0
  342. package/dist/saas/telemetry.d.ts +24 -0
  343. package/dist/saas/telemetry.d.ts.map +1 -0
  344. package/dist/saas/telemetry.js +30 -0
  345. package/dist/saas/telemetry.js.map +1 -0
  346. package/dist/saas/usageMeter.d.ts +28 -0
  347. package/dist/saas/usageMeter.d.ts.map +1 -0
  348. package/dist/saas/usageMeter.js +41 -0
  349. package/dist/saas/usageMeter.js.map +1 -0
  350. package/dist/security/TrustBoundaryValidator.d.ts +105 -0
  351. package/dist/security/TrustBoundaryValidator.d.ts.map +1 -0
  352. package/dist/security/TrustBoundaryValidator.js +305 -0
  353. package/dist/security/TrustBoundaryValidator.js.map +1 -0
  354. package/dist/starters/express-protected.d.ts +18 -0
  355. package/dist/starters/express-protected.d.ts.map +1 -0
  356. package/dist/starters/express-protected.js +93 -0
  357. package/dist/starters/express-protected.js.map +1 -0
  358. package/dist/starters/langchain-protected.d.ts +18 -0
  359. package/dist/starters/langchain-protected.d.ts.map +1 -0
  360. package/dist/starters/langchain-protected.js +85 -0
  361. package/dist/starters/langchain-protected.js.map +1 -0
  362. package/dist/starters/openai-protected.d.ts +19 -0
  363. package/dist/starters/openai-protected.d.ts.map +1 -0
  364. package/dist/starters/openai-protected.js +84 -0
  365. package/dist/starters/openai-protected.js.map +1 -0
  366. package/dist/starters/serverless-protected.d.ts +19 -0
  367. package/dist/starters/serverless-protected.d.ts.map +1 -0
  368. package/dist/starters/serverless-protected.js +83 -0
  369. package/dist/starters/serverless-protected.js.map +1 -0
  370. package/dist/storage/adapters.d.ts +24 -0
  371. package/dist/storage/adapters.d.ts.map +1 -0
  372. package/dist/storage/adapters.js +123 -0
  373. package/dist/storage/adapters.js.map +1 -0
  374. package/dist/storage/index.d.ts +2 -0
  375. package/dist/storage/index.d.ts.map +1 -0
  376. package/dist/storage/index.js +8 -0
  377. package/dist/storage/index.js.map +1 -0
  378. package/dist/tests/b2b-hardening.test.d.ts +2 -0
  379. package/dist/tests/b2b-hardening.test.d.ts.map +1 -0
  380. package/dist/tests/b2b-hardening.test.js +164 -0
  381. package/dist/tests/b2b-hardening.test.js.map +1 -0
  382. package/dist/tests/cli.contract.test.d.ts +2 -0
  383. package/dist/tests/cli.contract.test.d.ts.map +1 -0
  384. package/dist/tests/cli.contract.test.js +28 -0
  385. package/dist/tests/cli.contract.test.js.map +1 -0
  386. package/dist/tests/cli.snapshot.test.d.ts +14 -0
  387. package/dist/tests/cli.snapshot.test.d.ts.map +1 -0
  388. package/dist/tests/cli.snapshot.test.js +132 -0
  389. package/dist/tests/cli.snapshot.test.js.map +1 -0
  390. package/dist/tests/cli.strict.test.d.ts +6 -0
  391. package/dist/tests/cli.strict.test.d.ts.map +1 -0
  392. package/dist/tests/cli.strict.test.js +173 -0
  393. package/dist/tests/cli.strict.test.js.map +1 -0
  394. package/dist/tests/cli.test.d.ts +5 -0
  395. package/dist/tests/cli.test.d.ts.map +1 -0
  396. package/dist/tests/cli.test.js +54 -0
  397. package/dist/tests/cli.test.js.map +1 -0
  398. package/dist/tests/concurrency.state.test.d.ts +6 -0
  399. package/dist/tests/concurrency.state.test.d.ts.map +1 -0
  400. package/dist/tests/concurrency.state.test.js +231 -0
  401. package/dist/tests/concurrency.state.test.js.map +1 -0
  402. package/dist/tests/detection-engine.strict.test.d.ts +6 -0
  403. package/dist/tests/detection-engine.strict.test.d.ts.map +1 -0
  404. package/dist/tests/detection-engine.strict.test.js +323 -0
  405. package/dist/tests/detection-engine.strict.test.js.map +1 -0
  406. package/dist/tests/e2e.system.test.d.ts +7 -0
  407. package/dist/tests/e2e.system.test.d.ts.map +1 -0
  408. package/dist/tests/e2e.system.test.js +189 -0
  409. package/dist/tests/e2e.system.test.js.map +1 -0
  410. package/dist/tests/edge-cases.test.d.ts +6 -0
  411. package/dist/tests/edge-cases.test.d.ts.map +1 -0
  412. package/dist/tests/edge-cases.test.js +357 -0
  413. package/dist/tests/edge-cases.test.js.map +1 -0
  414. package/dist/tests/performance.benchmark.test.d.ts +2 -0
  415. package/dist/tests/performance.benchmark.test.d.ts.map +1 -0
  416. package/dist/tests/performance.benchmark.test.js +24 -0
  417. package/dist/tests/performance.benchmark.test.js.map +1 -0
  418. package/dist/tests/proxy.production.test.d.ts +6 -0
  419. package/dist/tests/proxy.production.test.d.ts.map +1 -0
  420. package/dist/tests/proxy.production.test.js +274 -0
  421. package/dist/tests/proxy.production.test.js.map +1 -0
  422. package/dist/tests/proxy.strict.test.d.ts +6 -0
  423. package/dist/tests/proxy.strict.test.d.ts.map +1 -0
  424. package/dist/tests/proxy.strict.test.js +188 -0
  425. package/dist/tests/proxy.strict.test.js.map +1 -0
  426. package/dist/tests/proxy.test.d.ts +5 -0
  427. package/dist/tests/proxy.test.d.ts.map +1 -0
  428. package/dist/tests/proxy.test.js +61 -0
  429. package/dist/tests/proxy.test.js.map +1 -0
  430. package/dist/tests/roi.scenario.test.d.ts +2 -0
  431. package/dist/tests/roi.scenario.test.d.ts.map +1 -0
  432. package/dist/tests/roi.scenario.test.js +26 -0
  433. package/dist/tests/roi.scenario.test.js.map +1 -0
  434. package/dist/tests/server.contract.test.d.ts +6 -0
  435. package/dist/tests/server.contract.test.d.ts.map +1 -0
  436. package/dist/tests/server.contract.test.js +48 -0
  437. package/dist/tests/server.contract.test.js.map +1 -0
  438. package/dist/tests/tokenCounter.test.d.ts +5 -0
  439. package/dist/tests/tokenCounter.test.d.ts.map +1 -0
  440. package/dist/tests/tokenCounter.test.js +66 -0
  441. package/dist/tests/tokenCounter.test.js.map +1 -0
  442. package/dist/tests/v113/client.test.d.ts +2 -0
  443. package/dist/tests/v113/client.test.d.ts.map +1 -0
  444. package/dist/tests/v113/client.test.js +22 -0
  445. package/dist/tests/v113/client.test.js.map +1 -0
  446. package/dist/tests/v113/executionGuard.test.d.ts +2 -0
  447. package/dist/tests/v113/executionGuard.test.d.ts.map +1 -0
  448. package/dist/tests/v113/executionGuard.test.js +39 -0
  449. package/dist/tests/v113/executionGuard.test.js.map +1 -0
  450. package/dist/token-counter/index.d.ts +2 -0
  451. package/dist/token-counter/index.d.ts.map +1 -0
  452. package/dist/token-counter/index.js +18 -0
  453. package/dist/token-counter/index.js.map +1 -0
  454. package/dist/token-counter/tokenCounter.d.ts +18 -0
  455. package/dist/token-counter/tokenCounter.d.ts.map +1 -0
  456. package/dist/token-counter/tokenCounter.js +91 -0
  457. package/dist/token-counter/tokenCounter.js.map +1 -0
  458. package/dist/trust/ImmutableAudit.d.ts +159 -0
  459. package/dist/trust/ImmutableAudit.d.ts.map +1 -0
  460. package/dist/trust/ImmutableAudit.js +340 -0
  461. package/dist/trust/ImmutableAudit.js.map +1 -0
  462. package/dist/trust/PublicVerificationLedger.d.ts +91 -0
  463. package/dist/trust/PublicVerificationLedger.d.ts.map +1 -0
  464. package/dist/trust/PublicVerificationLedger.js +223 -0
  465. package/dist/trust/PublicVerificationLedger.js.map +1 -0
  466. package/dist/trust/index.d.ts +11 -0
  467. package/dist/trust/index.d.ts.map +1 -0
  468. package/dist/trust/index.js +20 -0
  469. package/dist/trust/index.js.map +1 -0
  470. package/dist/utils/alert.d.ts +13 -0
  471. package/dist/utils/alert.d.ts.map +1 -0
  472. package/dist/utils/alert.js +49 -0
  473. package/dist/utils/alert.js.map +1 -0
  474. package/dist/utils/index.d.ts +2 -0
  475. package/dist/utils/index.d.ts.map +1 -0
  476. package/dist/utils/index.js +18 -0
  477. package/dist/utils/index.js.map +1 -0
  478. package/dist/wrapper/aiFirewall.d.ts +61 -0
  479. package/dist/wrapper/aiFirewall.d.ts.map +1 -0
  480. package/dist/wrapper/aiFirewall.js +117 -0
  481. package/dist/wrapper/aiFirewall.js.map +1 -0
  482. package/dist/wrapper/index.d.ts +3 -0
  483. package/dist/wrapper/index.d.ts.map +1 -0
  484. package/dist/wrapper/index.js +21 -0
  485. package/dist/wrapper/index.js.map +1 -0
  486. package/dist/wrapper/sdk.d.ts +49 -0
  487. package/dist/wrapper/sdk.d.ts.map +1 -0
  488. package/dist/wrapper/sdk.js +140 -0
  489. package/dist/wrapper/sdk.js.map +1 -0
  490. package/package.json +84 -0
@@ -0,0 +1,110 @@
1
+ /**
2
+ * CostPredictionEngine.ts - Cost-to-Go Prediction Engine
3
+ *
4
+ * Predicts total cost BEFORE execution continues:
5
+ * - Tokens remaining estimation
6
+ * - Downstream tool call prediction
7
+ * - Worst-case cost scenario
8
+ * - Budget burn rate analysis
9
+ */
10
+ export interface CostPredictionRequest {
11
+ currentCost: number;
12
+ currentTokens: number;
13
+ model: string;
14
+ workflowStep: number;
15
+ maxExpectedSteps: number;
16
+ averageToolCallsPerStep: number;
17
+ averageToolCost: number;
18
+ remainingWorkEstimate?: string;
19
+ }
20
+ export interface CostPrediction {
21
+ currentCost: number;
22
+ predictedTotal: number;
23
+ predictedRange: {
24
+ min: number;
25
+ max: number;
26
+ };
27
+ worstCase: number;
28
+ confidence: number;
29
+ breakdown: {
30
+ llmCostRemaining: number;
31
+ toolCostRemaining: number;
32
+ buffer: number;
33
+ };
34
+ riskLevel: 'low' | 'medium' | 'high' | 'critical';
35
+ recommendations: string[];
36
+ }
37
+ export interface BudgetAnalysis {
38
+ budgetLimit: number;
39
+ currentSpend: number;
40
+ remainingBudget: number;
41
+ predictedTotal: number;
42
+ willExceed: boolean;
43
+ projectedExceedAmount: number;
44
+ burnRate: number;
45
+ estimatedTimeToExceed?: number;
46
+ }
47
+ export interface BurnRateMetrics {
48
+ startTime: number;
49
+ totalSpend: number;
50
+ requestCount: number;
51
+ averageCostPerRequest: number;
52
+ requestsPerMinute: number;
53
+ spendPerMinute: number;
54
+ trend: 'increasing' | 'stable' | 'decreasing';
55
+ }
56
+ /**
57
+ * Cost Prediction Engine
58
+ *
59
+ * Uses multiple prediction strategies:
60
+ * 1. Historical pattern matching
61
+ * 2. Linear projection based on current trajectory
62
+ * 3. Worst-case scenario modeling
63
+ */
64
+ export declare class CostPredictionEngine {
65
+ private historicalPatterns;
66
+ private burnRateHistory;
67
+ constructor();
68
+ /**
69
+ * Predict total cost for workflow completion
70
+ */
71
+ predict(request: CostPredictionRequest): CostPrediction;
72
+ /**
73
+ * Analyze budget status and projection
74
+ */
75
+ analyzeBudget(budgetLimit: number, currentSpend: number, prediction: CostPrediction, sessionId: string): BudgetAnalysis;
76
+ /**
77
+ * Record actual cost for pattern learning
78
+ */
79
+ recordActualCost(patternSignature: string, predictedCost: number, actualCost: number): void;
80
+ /**
81
+ * Get historical accuracy for a pattern
82
+ */
83
+ getHistoricalAccuracy(patternSignature: string): {
84
+ samples: number;
85
+ averageError: number;
86
+ accuracy: number;
87
+ };
88
+ /**
89
+ * Update burn rate metrics for a session
90
+ */
91
+ updateBurnRate(sessionId: string, currentSpend: number): BurnRateMetrics;
92
+ /**
93
+ * Get burn rate for a session
94
+ */
95
+ getBurnRate(sessionId: string): BurnRateMetrics | undefined;
96
+ /**
97
+ * Calculate risk level based on costs
98
+ */
99
+ private calculateRiskLevel;
100
+ /**
101
+ * Estimate LLM cost for tokens
102
+ */
103
+ private estimateLlmCost;
104
+ /**
105
+ * Calculate burn rate metrics
106
+ */
107
+ private calculateBurnRate;
108
+ }
109
+ export declare const costPredictionEngine: CostPredictionEngine;
110
+ //# sourceMappingURL=CostPredictionEngine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CostPredictionEngine.d.ts","sourceRoot":"","sources":["../../src/core/CostPredictionEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,MAAM,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QACT,gBAAgB,EAAE,MAAM,CAAC;QACzB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC;CAC/C;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,kBAAkB,CAAwB;IAClD,OAAO,CAAC,eAAe,CAA+B;;IAOtD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc;IA+DvD;;OAEG;IACH,aAAa,CACX,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,GAChB,cAAc;IA0BjB;;OAEG;IACH,gBAAgB,CACd,gBAAgB,EAAE,MAAM,EACxB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,GACjB,IAAI;IAYP;;OAEG;IACH,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,GAAG;QAC/C,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAqBD;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,eAAe;IAyCxE;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI3D;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAG1B;AAGD,eAAO,MAAM,oBAAoB,sBAA6B,CAAC"}
@@ -0,0 +1,225 @@
1
+ "use strict";
2
+ /**
3
+ * CostPredictionEngine.ts - Cost-to-Go Prediction Engine
4
+ *
5
+ * Predicts total cost BEFORE execution continues:
6
+ * - Tokens remaining estimation
7
+ * - Downstream tool call prediction
8
+ * - Worst-case cost scenario
9
+ * - Budget burn rate analysis
10
+ */
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.costPredictionEngine = exports.CostPredictionEngine = void 0;
13
+ const PricingConfig_1 = require("./PricingConfig");
14
+ /**
15
+ * Cost Prediction Engine
16
+ *
17
+ * Uses multiple prediction strategies:
18
+ * 1. Historical pattern matching
19
+ * 2. Linear projection based on current trajectory
20
+ * 3. Worst-case scenario modeling
21
+ */
22
+ class CostPredictionEngine {
23
+ constructor() {
24
+ this.historicalPatterns = new Map();
25
+ this.burnRateHistory = new Map();
26
+ }
27
+ /**
28
+ * Predict total cost for workflow completion
29
+ */
30
+ predict(request) {
31
+ const currentStep = request.workflowStep;
32
+ const maxSteps = request.maxExpectedSteps;
33
+ const remainingSteps = Math.max(0, maxSteps - currentStep);
34
+ // Strategy 1: Linear projection
35
+ const costPerStep = currentStep > 0 ? request.currentCost / currentStep : request.currentCost;
36
+ const linearPrediction = request.currentCost + (costPerStep * remainingSteps);
37
+ // Strategy 2: Tool call projection
38
+ const expectedToolCalls = remainingSteps * request.averageToolCallsPerStep;
39
+ const toolCostRemaining = expectedToolCalls * request.averageToolCost;
40
+ // Strategy 3: LLM cost (tokens for remaining steps)
41
+ const avgTokensPerStep = currentStep > 0 ? request.currentTokens / currentStep : 1000;
42
+ const remainingTokens = avgTokensPerStep * remainingSteps;
43
+ const llmCostRemaining = this.estimateLlmCost(remainingTokens, request.model);
44
+ // Combine predictions with buffer
45
+ const basePrediction = linearPrediction + toolCostRemaining;
46
+ const predictedTotal = request.currentCost + llmCostRemaining + toolCostRemaining;
47
+ // Worst case: 3x base prediction (unexpected loops, retries, large outputs)
48
+ const worstCase = predictedTotal * 3;
49
+ // Confidence based on data availability
50
+ let confidence = 0.6;
51
+ if (currentStep > 3)
52
+ confidence = 0.75;
53
+ if (currentStep > 5)
54
+ confidence = 0.85;
55
+ // Risk level
56
+ const riskLevel = this.calculateRiskLevel(request.currentCost, predictedTotal, worstCase);
57
+ // Recommendations
58
+ const recommendations = [];
59
+ if (riskLevel === 'critical') {
60
+ recommendations.push('High probability of budget overrun - consider terminating workflow');
61
+ }
62
+ else if (riskLevel === 'high') {
63
+ recommendations.push('Monitor closely - implement circuit breaker at 80% of budget');
64
+ }
65
+ if (worstCase > predictedTotal * 2) {
66
+ recommendations.push('High variance in prediction - consider throttling to reduce risk');
67
+ }
68
+ return {
69
+ currentCost: request.currentCost,
70
+ predictedTotal: Math.round(predictedTotal * 10000) / 10000,
71
+ predictedRange: {
72
+ min: Math.round(predictedTotal * 0.8 * 10000) / 10000,
73
+ max: Math.round(predictedTotal * 1.5 * 10000) / 10000,
74
+ },
75
+ worstCase: Math.round(worstCase * 10000) / 10000,
76
+ confidence: Math.round(confidence * 100) / 100,
77
+ breakdown: {
78
+ llmCostRemaining: Math.round(llmCostRemaining * 10000) / 10000,
79
+ toolCostRemaining: Math.round(toolCostRemaining * 10000) / 10000,
80
+ buffer: Math.round((predictedTotal - request.currentCost - llmCostRemaining - toolCostRemaining) * 10000) / 10000,
81
+ },
82
+ riskLevel,
83
+ recommendations,
84
+ };
85
+ }
86
+ /**
87
+ * Analyze budget status and projection
88
+ */
89
+ analyzeBudget(budgetLimit, currentSpend, prediction, sessionId) {
90
+ const remainingBudget = budgetLimit - currentSpend;
91
+ const willExceed = prediction.predictedTotal > budgetLimit;
92
+ const projectedExceedAmount = willExceed ? prediction.predictedTotal - budgetLimit : 0;
93
+ // Calculate burn rate
94
+ const burnRate = this.calculateBurnRate(sessionId, currentSpend);
95
+ // Estimate time to exceed
96
+ let estimatedTimeToExceed;
97
+ if (willExceed && burnRate.spendPerMinute > 0) {
98
+ estimatedTimeToExceed = remainingBudget / burnRate.spendPerMinute;
99
+ }
100
+ return {
101
+ budgetLimit,
102
+ currentSpend,
103
+ remainingBudget: Math.round(remainingBudget * 10000) / 10000,
104
+ predictedTotal: prediction.predictedTotal,
105
+ willExceed,
106
+ projectedExceedAmount: Math.round(projectedExceedAmount * 10000) / 10000,
107
+ burnRate: Math.round(burnRate.spendPerMinute * 10000) / 10000,
108
+ estimatedTimeToExceed: estimatedTimeToExceed ? Math.round(estimatedTimeToExceed * 100) / 100 : undefined,
109
+ };
110
+ }
111
+ /**
112
+ * Record actual cost for pattern learning
113
+ */
114
+ recordActualCost(patternSignature, predictedCost, actualCost) {
115
+ const outcomes = this.historicalPatterns.get(patternSignature) || [];
116
+ outcomes.push(actualCost);
117
+ // Keep only last 100 outcomes
118
+ if (outcomes.length > 100) {
119
+ outcomes.shift();
120
+ }
121
+ this.historicalPatterns.set(patternSignature, outcomes);
122
+ }
123
+ /**
124
+ * Get historical accuracy for a pattern
125
+ */
126
+ getHistoricalAccuracy(patternSignature) {
127
+ const outcomes = this.historicalPatterns.get(patternSignature) || [];
128
+ if (outcomes.length === 0) {
129
+ return { samples: 0, averageError: 0, accuracy: 0 };
130
+ }
131
+ const averageActual = outcomes.reduce((a, b) => a + b, 0) / outcomes.length;
132
+ const variance = outcomes.reduce((sum, val) => sum + Math.pow(val - averageActual, 2), 0) / outcomes.length;
133
+ const standardDeviation = Math.sqrt(variance);
134
+ // Accuracy: inverse of coefficient of variation
135
+ const accuracy = averageActual > 0 ? Math.max(0, 1 - (standardDeviation / averageActual)) : 0;
136
+ return {
137
+ samples: outcomes.length,
138
+ averageError: Math.round(standardDeviation * 10000) / 10000,
139
+ accuracy: Math.round(accuracy * 100) / 100,
140
+ };
141
+ }
142
+ /**
143
+ * Update burn rate metrics for a session
144
+ */
145
+ updateBurnRate(sessionId, currentSpend) {
146
+ let metrics = this.burnRateHistory.get(sessionId);
147
+ const now = Date.now();
148
+ if (!metrics) {
149
+ metrics = {
150
+ startTime: now,
151
+ totalSpend: currentSpend,
152
+ requestCount: 1,
153
+ averageCostPerRequest: currentSpend,
154
+ requestsPerMinute: 0,
155
+ spendPerMinute: 0,
156
+ trend: 'stable',
157
+ };
158
+ }
159
+ else {
160
+ const elapsedMinutes = (now - metrics.startTime) / 60000;
161
+ metrics.requestCount++;
162
+ metrics.totalSpend = currentSpend;
163
+ metrics.averageCostPerRequest = currentSpend / metrics.requestCount;
164
+ if (elapsedMinutes > 0) {
165
+ metrics.requestsPerMinute = metrics.requestCount / elapsedMinutes;
166
+ metrics.spendPerMinute = currentSpend / elapsedMinutes;
167
+ }
168
+ // Determine trend
169
+ const previousSpendPerMinute = metrics.spendPerMinute;
170
+ if (metrics.spendPerMinute > previousSpendPerMinute * 1.2) {
171
+ metrics.trend = 'increasing';
172
+ }
173
+ else if (metrics.spendPerMinute < previousSpendPerMinute * 0.8) {
174
+ metrics.trend = 'decreasing';
175
+ }
176
+ else {
177
+ metrics.trend = 'stable';
178
+ }
179
+ }
180
+ this.burnRateHistory.set(sessionId, metrics);
181
+ return metrics;
182
+ }
183
+ /**
184
+ * Get burn rate for a session
185
+ */
186
+ getBurnRate(sessionId) {
187
+ return this.burnRateHistory.get(sessionId);
188
+ }
189
+ /**
190
+ * Calculate risk level based on costs
191
+ */
192
+ calculateRiskLevel(currentCost, predictedTotal, worstCase) {
193
+ const ratio = predictedTotal / Math.max(currentCost, 0.01);
194
+ const variance = (worstCase - predictedTotal) / Math.max(predictedTotal, 0.01);
195
+ if (predictedTotal > 50 || variance > 5)
196
+ return 'critical';
197
+ if (predictedTotal > 20 || variance > 3)
198
+ return 'high';
199
+ if (predictedTotal > 5 || ratio > 5)
200
+ return 'medium';
201
+ return 'low';
202
+ }
203
+ /**
204
+ * Estimate LLM cost for tokens
205
+ */
206
+ estimateLlmCost(tokens, model) {
207
+ const pricing = PricingConfig_1.pricingConfig.getPricing(model);
208
+ // Assume 70% input, 30% output split
209
+ const inputTokens = Math.floor(tokens * 0.7);
210
+ const outputTokens = Math.floor(tokens * 0.3);
211
+ const inputCost = (inputTokens / 1000) * pricing.inputPer1K;
212
+ const outputCost = (outputTokens / 1000) * pricing.outputPer1K;
213
+ return inputCost + outputCost;
214
+ }
215
+ /**
216
+ * Calculate burn rate metrics
217
+ */
218
+ calculateBurnRate(sessionId, currentSpend) {
219
+ return this.updateBurnRate(sessionId, currentSpend);
220
+ }
221
+ }
222
+ exports.CostPredictionEngine = CostPredictionEngine;
223
+ // Export singleton
224
+ exports.costPredictionEngine = new CostPredictionEngine();
225
+ //# sourceMappingURL=CostPredictionEngine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CostPredictionEngine.js","sourceRoot":"","sources":["../../src/core/CostPredictionEngine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,108 @@
1
+ /**
2
+ * CostTruthEngine.ts - Financial Truth System
3
+ *
4
+ * Measures, prevents, and proves financial loss in real-time.
5
+ * Tracks every request to calculate "saved" vs "would have lost" metrics.
6
+ *
7
+ * Core Principle: Every request answers:
8
+ * {
9
+ * "cost": 0.12,
10
+ * "risk": "HIGH",
11
+ * "decision": "BLOCK",
12
+ * "saved": 38.21,
13
+ * "wouldHaveLost": 120.50
14
+ * }
15
+ */
16
+ export interface CostEstimate {
17
+ cost: number;
18
+ tokens: number;
19
+ model: string;
20
+ }
21
+ export interface CostComparison {
22
+ saved: number;
23
+ wouldHaveLost: number;
24
+ actualSpend: number;
25
+ blockedCount: number;
26
+ allowedCount: number;
27
+ }
28
+ export interface TrackedEvent {
29
+ type: 'BLOCK' | 'ALLOW' | 'WARN';
30
+ cost: number;
31
+ risk: string;
32
+ timestamp: number;
33
+ prompt?: string;
34
+ model?: string;
35
+ }
36
+ export interface CostTruthResult {
37
+ cost: number;
38
+ risk: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
39
+ decision: 'ALLOW' | 'WARN' | 'BLOCK';
40
+ saved: number;
41
+ wouldHaveLost: number;
42
+ }
43
+ /**
44
+ * Cost Truth Engine - Singleton
45
+ * Tracks all financial impact of AI Execution Firewall
46
+ */
47
+ export declare class CostTruthEngine {
48
+ private static instance;
49
+ private events;
50
+ private constructor();
51
+ static getInstance(): CostTruthEngine;
52
+ /**
53
+ * Estimate cost for a request using heuristics
54
+ * Rules:
55
+ * - tokens × model pricing
56
+ * - repeated calls multiplier (1.5x for duplicates)
57
+ * - spike multiplier (2x for burst traffic)
58
+ */
59
+ estimateCost(params: {
60
+ model: string;
61
+ inputTokens: number;
62
+ outputTokens: number;
63
+ isDuplicate?: boolean;
64
+ isBurst?: boolean;
65
+ }): CostEstimate;
66
+ /**
67
+ * Compare actual vs prevented costs
68
+ * Logic:
69
+ * - saved = sum(blocked requests cost)
70
+ * - wouldHaveLost = saved + actual cost
71
+ */
72
+ compareCost(hours?: number): CostComparison;
73
+ /**
74
+ * Track an event for cost truth calculations
75
+ */
76
+ trackEvent(event: Omit<TrackedEvent, 'timestamp'>): void;
77
+ /**
78
+ * Get events for a time window
79
+ */
80
+ getEvents(minutes?: number): TrackedEvent[];
81
+ /**
82
+ * Get total savings summary
83
+ */
84
+ getSavingsSummary(): {
85
+ totalSaved: number;
86
+ totalWouldHaveLost: number;
87
+ protectionRate: number;
88
+ };
89
+ /**
90
+ * Create universal output format for any request
91
+ */
92
+ createTruthResult(params: {
93
+ cost: number;
94
+ risk: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
95
+ decision: 'ALLOW' | 'WARN' | 'BLOCK';
96
+ wouldHaveLost?: number;
97
+ }): CostTruthResult;
98
+ /**
99
+ * Get model pricing per 1K tokens
100
+ */
101
+ private getModelPricing;
102
+ /**
103
+ * Clear all tracked events
104
+ */
105
+ clear(): void;
106
+ }
107
+ export declare const costTruthEngine: CostTruthEngine;
108
+ //# sourceMappingURL=CostTruthEngine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CostTruthEngine.d.ts","sourceRoot":"","sources":["../../src/core/CostTruthEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAC7C,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkB;IACzC,OAAO,CAAC,MAAM,CAAsB;IAEpC,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,eAAe;IAOrC;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,YAAY;IAyBhB;;;;;OAKG;IACH,WAAW,CAAC,KAAK,GAAE,MAAW,GAAG,cAAc;IAsB/C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,IAAI;IAaxD;;OAEG;IACH,SAAS,CAAC,OAAO,GAAE,MAAW,GAAG,YAAY,EAAE;IAK/C;;OAEG;IACH,iBAAiB,IAAI;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,cAAc,EAAE,MAAM,CAAC;KACxB;IAcD;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE;QACxB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QAC7C,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;QACrC,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,eAAe;IAqBnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAGD,eAAO,MAAM,eAAe,iBAAgC,CAAC"}
@@ -0,0 +1,170 @@
1
+ "use strict";
2
+ /**
3
+ * CostTruthEngine.ts - Financial Truth System
4
+ *
5
+ * Measures, prevents, and proves financial loss in real-time.
6
+ * Tracks every request to calculate "saved" vs "would have lost" metrics.
7
+ *
8
+ * Core Principle: Every request answers:
9
+ * {
10
+ * "cost": 0.12,
11
+ * "risk": "HIGH",
12
+ * "decision": "BLOCK",
13
+ * "saved": 38.21,
14
+ * "wouldHaveLost": 120.50
15
+ * }
16
+ */
17
+ Object.defineProperty(exports, "__esModule", { value: true });
18
+ exports.costTruthEngine = exports.CostTruthEngine = void 0;
19
+ const StateStore_1 = require("./StateStore");
20
+ /**
21
+ * Cost Truth Engine - Singleton
22
+ * Tracks all financial impact of AI Execution Firewall
23
+ */
24
+ class CostTruthEngine {
25
+ constructor() {
26
+ this.events = [];
27
+ }
28
+ static getInstance() {
29
+ if (!CostTruthEngine.instance) {
30
+ CostTruthEngine.instance = new CostTruthEngine();
31
+ }
32
+ return CostTruthEngine.instance;
33
+ }
34
+ /**
35
+ * Estimate cost for a request using heuristics
36
+ * Rules:
37
+ * - tokens × model pricing
38
+ * - repeated calls multiplier (1.5x for duplicates)
39
+ * - spike multiplier (2x for burst traffic)
40
+ */
41
+ estimateCost(params) {
42
+ const pricing = this.getModelPricing(params.model);
43
+ const inputCost = (params.inputTokens / 1000) * pricing.inputPer1K;
44
+ const outputCost = (params.outputTokens / 1000) * pricing.outputPer1K;
45
+ let cost = inputCost + outputCost;
46
+ // Repeated calls multiplier
47
+ if (params.isDuplicate) {
48
+ cost *= 1.5;
49
+ }
50
+ // Spike multiplier for burst traffic
51
+ if (params.isBurst) {
52
+ cost *= 2.0;
53
+ }
54
+ const totalTokens = params.inputTokens + params.outputTokens;
55
+ return {
56
+ cost: Math.round(cost * 10000) / 10000, // Round to 4 decimals
57
+ tokens: totalTokens,
58
+ model: params.model
59
+ };
60
+ }
61
+ /**
62
+ * Compare actual vs prevented costs
63
+ * Logic:
64
+ * - saved = sum(blocked requests cost)
65
+ * - wouldHaveLost = saved + actual cost
66
+ */
67
+ compareCost(hours = 24) {
68
+ const stats = StateStore_1.stateStore.getStats(hours);
69
+ // Calculate saved: sum of costs for all blocked requests
70
+ const blockedRequests = StateStore_1.stateStore.getBlocked(1000);
71
+ const saved = blockedRequests.reduce((sum, req) => sum + req.estimatedCost, 0);
72
+ // Calculate actual spend: sum of costs for allowed requests
73
+ const actualSpend = stats.totalCost;
74
+ // Would have lost = saved + actual (what we would have spent without firewall)
75
+ const wouldHaveLost = saved + actualSpend;
76
+ return {
77
+ saved: Math.round(saved * 100) / 100,
78
+ wouldHaveLost: Math.round(wouldHaveLost * 100) / 100,
79
+ actualSpend: Math.round(actualSpend * 100) / 100,
80
+ blockedCount: stats.blockedRequests,
81
+ allowedCount: stats.totalRequests - stats.blockedRequests
82
+ };
83
+ }
84
+ /**
85
+ * Track an event for cost truth calculations
86
+ */
87
+ trackEvent(event) {
88
+ const fullEvent = {
89
+ ...event,
90
+ timestamp: Date.now()
91
+ };
92
+ this.events.push(fullEvent);
93
+ // Keep only last 10000 events to prevent memory bloat
94
+ if (this.events.length > 10000) {
95
+ this.events = this.events.slice(-10000);
96
+ }
97
+ }
98
+ /**
99
+ * Get events for a time window
100
+ */
101
+ getEvents(minutes = 60) {
102
+ const cutoff = Date.now() - (minutes * 60 * 1000);
103
+ return this.events.filter(e => e.timestamp >= cutoff);
104
+ }
105
+ /**
106
+ * Get total savings summary
107
+ */
108
+ getSavingsSummary() {
109
+ const comparison = this.compareCost(24 * 30); // 30 days
110
+ const totalRequests = comparison.blockedCount + comparison.allowedCount;
111
+ const protectionRate = totalRequests > 0
112
+ ? (comparison.blockedCount / totalRequests) * 100
113
+ : 0;
114
+ return {
115
+ totalSaved: comparison.saved,
116
+ totalWouldHaveLost: comparison.wouldHaveLost,
117
+ protectionRate: Math.round(protectionRate * 100) / 100
118
+ };
119
+ }
120
+ /**
121
+ * Create universal output format for any request
122
+ */
123
+ createTruthResult(params) {
124
+ const comparison = this.compareCost();
125
+ // If blocked, add this cost to saved
126
+ const saved = params.decision === 'BLOCK'
127
+ ? params.cost
128
+ : 0;
129
+ // Would have lost includes this request if it were allowed
130
+ const wouldHaveLost = params.wouldHaveLost ??
131
+ (comparison.wouldHaveLost + (params.decision === 'BLOCK' ? params.cost : 0));
132
+ return {
133
+ cost: params.cost,
134
+ risk: params.risk,
135
+ decision: params.decision,
136
+ saved: Math.round(saved * 100) / 100,
137
+ wouldHaveLost: Math.round(wouldHaveLost * 100) / 100
138
+ };
139
+ }
140
+ /**
141
+ * Get model pricing per 1K tokens
142
+ */
143
+ getModelPricing(model) {
144
+ const pricing = {
145
+ 'gpt-4': { inputPer1K: 0.03, outputPer1K: 0.06 },
146
+ 'gpt-4-32k': { inputPer1K: 0.06, outputPer1K: 0.12 },
147
+ 'gpt-4-turbo': { inputPer1K: 0.01, outputPer1K: 0.03 },
148
+ 'gpt-4o': { inputPer1K: 0.005, outputPer1K: 0.015 },
149
+ 'gpt-4o-mini': { inputPer1K: 0.00015, outputPer1K: 0.0006 },
150
+ 'gpt-3.5-turbo': { inputPer1K: 0.0005, outputPer1K: 0.0015 },
151
+ 'claude-3-opus': { inputPer1K: 0.015, outputPer1K: 0.075 },
152
+ 'claude-3-sonnet': { inputPer1K: 0.003, outputPer1K: 0.015 },
153
+ 'claude-3-haiku': { inputPer1K: 0.00025, outputPer1K: 0.00125 },
154
+ 'default': { inputPer1K: 0.01, outputPer1K: 0.03 }
155
+ };
156
+ // Find matching model or use default
157
+ const key = Object.keys(pricing).find(k => model.toLowerCase().includes(k.toLowerCase()));
158
+ return key ? pricing[key] : pricing['default'];
159
+ }
160
+ /**
161
+ * Clear all tracked events
162
+ */
163
+ clear() {
164
+ this.events = [];
165
+ }
166
+ }
167
+ exports.CostTruthEngine = CostTruthEngine;
168
+ // Export singleton instance
169
+ exports.costTruthEngine = CostTruthEngine.getInstance();
170
+ //# sourceMappingURL=CostTruthEngine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CostTruthEngine.js","sourceRoot":"","sources":["../../src/core/CostTruthEngine.ts"],"names":[],"mappings":"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"}