@cogitator-ai/core 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (252) hide show
  1. package/README.md +920 -15
  2. package/dist/__tests__/agent.test.js +2 -2
  3. package/dist/__tests__/agent.test.js.map +1 -1
  4. package/dist/__tests__/base64.test.js +1 -1
  5. package/dist/__tests__/base64.test.js.map +1 -1
  6. package/dist/__tests__/calculator.test.js +1 -1
  7. package/dist/__tests__/calculator.test.js.map +1 -1
  8. package/dist/__tests__/cogitator-memory.test.js +2 -2
  9. package/dist/__tests__/cogitator-memory.test.js.map +1 -1
  10. package/dist/__tests__/datetime.test.js +1 -1
  11. package/dist/__tests__/datetime.test.js.map +1 -1
  12. package/dist/__tests__/exec.test.js +1 -1
  13. package/dist/__tests__/exec.test.js.map +1 -1
  14. package/dist/__tests__/filesystem.test.js +1 -1
  15. package/dist/__tests__/filesystem.test.js.map +1 -1
  16. package/dist/__tests__/google-backend.test.js +1 -1
  17. package/dist/__tests__/google-backend.test.js.map +1 -1
  18. package/dist/__tests__/hash.test.js +1 -1
  19. package/dist/__tests__/hash.test.js.map +1 -1
  20. package/dist/__tests__/http.test.js +1 -1
  21. package/dist/__tests__/http.test.js.map +1 -1
  22. package/dist/__tests__/json.test.js +1 -1
  23. package/dist/__tests__/json.test.js.map +1 -1
  24. package/dist/__tests__/logger.test.js +1 -1
  25. package/dist/__tests__/logger.test.js.map +1 -1
  26. package/dist/__tests__/random.test.js +1 -1
  27. package/dist/__tests__/random.test.js.map +1 -1
  28. package/dist/__tests__/regex.test.js +1 -1
  29. package/dist/__tests__/regex.test.js.map +1 -1
  30. package/dist/__tests__/registry.test.js +2 -2
  31. package/dist/__tests__/registry.test.js.map +1 -1
  32. package/dist/__tests__/sleep.test.js +1 -1
  33. package/dist/__tests__/sleep.test.js.map +1 -1
  34. package/dist/__tests__/tool.test.js +1 -1
  35. package/dist/__tests__/tool.test.js.map +1 -1
  36. package/dist/__tests__/uuid.test.js +1 -1
  37. package/dist/__tests__/uuid.test.js.map +1 -1
  38. package/dist/cogitator.d.ts +46 -1
  39. package/dist/cogitator.d.ts.map +1 -1
  40. package/dist/cogitator.js +274 -17
  41. package/dist/cogitator.js.map +1 -1
  42. package/dist/constitutional/constitution.d.ts +9 -0
  43. package/dist/constitutional/constitution.d.ts.map +1 -0
  44. package/dist/constitutional/constitution.js +215 -0
  45. package/dist/constitutional/constitution.js.map +1 -0
  46. package/dist/constitutional/constitutional-ai.d.ts +36 -0
  47. package/dist/constitutional/constitutional-ai.d.ts.map +1 -0
  48. package/dist/constitutional/constitutional-ai.js +163 -0
  49. package/dist/constitutional/constitutional-ai.js.map +1 -0
  50. package/dist/constitutional/critique-reviser.d.ts +20 -0
  51. package/dist/constitutional/critique-reviser.d.ts.map +1 -0
  52. package/dist/constitutional/critique-reviser.js +98 -0
  53. package/dist/constitutional/critique-reviser.js.map +1 -0
  54. package/dist/constitutional/index.d.ts +13 -0
  55. package/dist/constitutional/index.d.ts.map +1 -0
  56. package/dist/constitutional/index.js +8 -0
  57. package/dist/constitutional/index.js.map +1 -0
  58. package/dist/constitutional/input-filter.d.ts +19 -0
  59. package/dist/constitutional/input-filter.d.ts.map +1 -0
  60. package/dist/constitutional/input-filter.js +88 -0
  61. package/dist/constitutional/input-filter.js.map +1 -0
  62. package/dist/constitutional/output-filter.d.ts +19 -0
  63. package/dist/constitutional/output-filter.d.ts.map +1 -0
  64. package/dist/constitutional/output-filter.js +86 -0
  65. package/dist/constitutional/output-filter.js.map +1 -0
  66. package/dist/constitutional/prompts.d.ts +11 -0
  67. package/dist/constitutional/prompts.d.ts.map +1 -0
  68. package/dist/constitutional/prompts.js +202 -0
  69. package/dist/constitutional/prompts.js.map +1 -0
  70. package/dist/constitutional/tool-guard.d.ts +18 -0
  71. package/dist/constitutional/tool-guard.d.ts.map +1 -0
  72. package/dist/constitutional/tool-guard.js +125 -0
  73. package/dist/constitutional/tool-guard.js.map +1 -0
  74. package/dist/cost-routing/budget-enforcer.d.ts +26 -0
  75. package/dist/cost-routing/budget-enforcer.d.ts.map +1 -0
  76. package/dist/cost-routing/budget-enforcer.js +86 -0
  77. package/dist/cost-routing/budget-enforcer.js.map +1 -0
  78. package/dist/cost-routing/cost-router.d.ts +34 -0
  79. package/dist/cost-routing/cost-router.d.ts.map +1 -0
  80. package/dist/cost-routing/cost-router.js +80 -0
  81. package/dist/cost-routing/cost-router.js.map +1 -0
  82. package/dist/cost-routing/cost-tracker.d.ts +20 -0
  83. package/dist/cost-routing/cost-tracker.d.ts.map +1 -0
  84. package/dist/cost-routing/cost-tracker.js +85 -0
  85. package/dist/cost-routing/cost-tracker.js.map +1 -0
  86. package/dist/cost-routing/index.d.ts +6 -0
  87. package/dist/cost-routing/index.d.ts.map +1 -0
  88. package/dist/cost-routing/index.js +6 -0
  89. package/dist/cost-routing/index.js.map +1 -0
  90. package/dist/cost-routing/model-selector.d.ts +15 -0
  91. package/dist/cost-routing/model-selector.d.ts.map +1 -0
  92. package/dist/cost-routing/model-selector.js +216 -0
  93. package/dist/cost-routing/model-selector.js.map +1 -0
  94. package/dist/cost-routing/task-analyzer.d.ts +13 -0
  95. package/dist/cost-routing/task-analyzer.d.ts.map +1 -0
  96. package/dist/cost-routing/task-analyzer.js +185 -0
  97. package/dist/cost-routing/task-analyzer.js.map +1 -0
  98. package/dist/index.d.ts +19 -1
  99. package/dist/index.d.ts.map +1 -1
  100. package/dist/index.js +9 -0
  101. package/dist/index.js.map +1 -1
  102. package/dist/learning/ab-testing.d.ts +45 -0
  103. package/dist/learning/ab-testing.d.ts.map +1 -0
  104. package/dist/learning/ab-testing.js +267 -0
  105. package/dist/learning/ab-testing.js.map +1 -0
  106. package/dist/learning/agent-optimizer.d.ts +42 -0
  107. package/dist/learning/agent-optimizer.d.ts.map +1 -0
  108. package/dist/learning/agent-optimizer.js +273 -0
  109. package/dist/learning/agent-optimizer.js.map +1 -0
  110. package/dist/learning/auto-optimizer.d.ts +38 -0
  111. package/dist/learning/auto-optimizer.d.ts.map +1 -0
  112. package/dist/learning/auto-optimizer.js +229 -0
  113. package/dist/learning/auto-optimizer.js.map +1 -0
  114. package/dist/learning/demo-selector.d.ts +29 -0
  115. package/dist/learning/demo-selector.d.ts.map +1 -0
  116. package/dist/learning/demo-selector.js +235 -0
  117. package/dist/learning/demo-selector.js.map +1 -0
  118. package/dist/learning/index.d.ts +24 -0
  119. package/dist/learning/index.d.ts.map +1 -0
  120. package/dist/learning/index.js +13 -0
  121. package/dist/learning/index.js.map +1 -0
  122. package/dist/learning/instruction-optimizer.d.ts +29 -0
  123. package/dist/learning/instruction-optimizer.d.ts.map +1 -0
  124. package/dist/learning/instruction-optimizer.js +175 -0
  125. package/dist/learning/instruction-optimizer.js.map +1 -0
  126. package/dist/learning/metrics.d.ts +37 -0
  127. package/dist/learning/metrics.d.ts.map +1 -0
  128. package/dist/learning/metrics.js +310 -0
  129. package/dist/learning/metrics.js.map +1 -0
  130. package/dist/learning/postgres-trace-store.d.ts +53 -0
  131. package/dist/learning/postgres-trace-store.d.ts.map +1 -0
  132. package/dist/learning/postgres-trace-store.js +692 -0
  133. package/dist/learning/postgres-trace-store.js.map +1 -0
  134. package/dist/learning/prompt-logger.d.ts +29 -0
  135. package/dist/learning/prompt-logger.d.ts.map +1 -0
  136. package/dist/learning/prompt-logger.js +157 -0
  137. package/dist/learning/prompt-logger.js.map +1 -0
  138. package/dist/learning/prompt-monitor.d.ts +29 -0
  139. package/dist/learning/prompt-monitor.d.ts.map +1 -0
  140. package/dist/learning/prompt-monitor.js +243 -0
  141. package/dist/learning/prompt-monitor.js.map +1 -0
  142. package/dist/learning/prompts.d.ts +28 -0
  143. package/dist/learning/prompts.d.ts.map +1 -0
  144. package/dist/learning/prompts.js +195 -0
  145. package/dist/learning/prompts.js.map +1 -0
  146. package/dist/learning/rollback-manager.d.ts +36 -0
  147. package/dist/learning/rollback-manager.d.ts.map +1 -0
  148. package/dist/learning/rollback-manager.js +177 -0
  149. package/dist/learning/rollback-manager.js.map +1 -0
  150. package/dist/learning/trace-store.d.ts +26 -0
  151. package/dist/learning/trace-store.d.ts.map +1 -0
  152. package/dist/learning/trace-store.js +218 -0
  153. package/dist/learning/trace-store.js.map +1 -0
  154. package/dist/llm/google.d.ts.map +1 -1
  155. package/dist/llm/google.js +1 -2
  156. package/dist/llm/google.js.map +1 -1
  157. package/dist/reasoning/branch-evaluator.d.ts +28 -0
  158. package/dist/reasoning/branch-evaluator.d.ts.map +1 -0
  159. package/dist/reasoning/branch-evaluator.js +143 -0
  160. package/dist/reasoning/branch-evaluator.js.map +1 -0
  161. package/dist/reasoning/branch-generator.d.ts +9 -0
  162. package/dist/reasoning/branch-generator.d.ts.map +1 -0
  163. package/dist/reasoning/branch-generator.js +60 -0
  164. package/dist/reasoning/branch-generator.js.map +1 -0
  165. package/dist/reasoning/index.d.ts +5 -0
  166. package/dist/reasoning/index.d.ts.map +1 -0
  167. package/dist/reasoning/index.js +5 -0
  168. package/dist/reasoning/index.js.map +1 -0
  169. package/dist/reasoning/prompts.d.ts +19 -0
  170. package/dist/reasoning/prompts.d.ts.map +1 -0
  171. package/dist/reasoning/prompts.js +161 -0
  172. package/dist/reasoning/prompts.js.map +1 -0
  173. package/dist/reasoning/thought-tree.d.ts +32 -0
  174. package/dist/reasoning/thought-tree.d.ts.map +1 -0
  175. package/dist/reasoning/thought-tree.js +352 -0
  176. package/dist/reasoning/thought-tree.js.map +1 -0
  177. package/dist/reflection/index.d.ts +4 -0
  178. package/dist/reflection/index.d.ts.map +1 -0
  179. package/dist/reflection/index.js +4 -0
  180. package/dist/reflection/index.js.map +1 -0
  181. package/dist/reflection/insight-store.d.ts +19 -0
  182. package/dist/reflection/insight-store.d.ts.map +1 -0
  183. package/dist/reflection/insight-store.js +129 -0
  184. package/dist/reflection/insight-store.js.map +1 -0
  185. package/dist/reflection/prompts.d.ts +18 -0
  186. package/dist/reflection/prompts.d.ts.map +1 -0
  187. package/dist/reflection/prompts.js +157 -0
  188. package/dist/reflection/prompts.js.map +1 -0
  189. package/dist/reflection/reflection-engine.d.ts +25 -0
  190. package/dist/reflection/reflection-engine.d.ts.map +1 -0
  191. package/dist/reflection/reflection-engine.js +202 -0
  192. package/dist/reflection/reflection-engine.js.map +1 -0
  193. package/dist/registry.d.ts +1 -0
  194. package/dist/registry.d.ts.map +1 -1
  195. package/dist/registry.js +3 -0
  196. package/dist/registry.js.map +1 -1
  197. package/dist/time-travel/checkpoint-store.d.ts +34 -0
  198. package/dist/time-travel/checkpoint-store.d.ts.map +1 -0
  199. package/dist/time-travel/checkpoint-store.js +240 -0
  200. package/dist/time-travel/checkpoint-store.js.map +1 -0
  201. package/dist/time-travel/comparator.d.ts +26 -0
  202. package/dist/time-travel/comparator.d.ts.map +1 -0
  203. package/dist/time-travel/comparator.js +253 -0
  204. package/dist/time-travel/comparator.js.map +1 -0
  205. package/dist/time-travel/forker.d.ts +22 -0
  206. package/dist/time-travel/forker.d.ts.map +1 -0
  207. package/dist/time-travel/forker.js +118 -0
  208. package/dist/time-travel/forker.js.map +1 -0
  209. package/dist/time-travel/index.d.ts +6 -0
  210. package/dist/time-travel/index.d.ts.map +1 -0
  211. package/dist/time-travel/index.js +6 -0
  212. package/dist/time-travel/index.js.map +1 -0
  213. package/dist/time-travel/replayer.d.ts +20 -0
  214. package/dist/time-travel/replayer.d.ts.map +1 -0
  215. package/dist/time-travel/replayer.js +147 -0
  216. package/dist/time-travel/replayer.js.map +1 -0
  217. package/dist/time-travel/time-travel.d.ts +41 -0
  218. package/dist/time-travel/time-travel.d.ts.map +1 -0
  219. package/dist/time-travel/time-travel.js +127 -0
  220. package/dist/time-travel/time-travel.js.map +1 -0
  221. package/dist/tool.d.ts.map +1 -1
  222. package/dist/tool.js +2 -0
  223. package/dist/tool.js.map +1 -1
  224. package/dist/tools/base64.d.ts.map +1 -1
  225. package/dist/tools/base64.js +2 -8
  226. package/dist/tools/base64.js.map +1 -1
  227. package/dist/tools/datetime.d.ts.map +1 -1
  228. package/dist/tools/datetime.js.map +1 -1
  229. package/dist/tools/exec.d.ts.map +1 -1
  230. package/dist/tools/exec.js +1 -4
  231. package/dist/tools/exec.js.map +1 -1
  232. package/dist/tools/filesystem.d.ts.map +1 -1
  233. package/dist/tools/filesystem.js +4 -1
  234. package/dist/tools/filesystem.js.map +1 -1
  235. package/dist/tools/hash.d.ts.map +1 -1
  236. package/dist/tools/hash.js +1 -4
  237. package/dist/tools/hash.js.map +1 -1
  238. package/dist/tools/http.d.ts.map +1 -1
  239. package/dist/tools/http.js +1 -4
  240. package/dist/tools/http.js.map +1 -1
  241. package/dist/tools/regex.d.ts.map +1 -1
  242. package/dist/tools/regex.js +4 -1
  243. package/dist/tools/regex.js.map +1 -1
  244. package/dist/utils/circuit-breaker.d.ts.map +1 -1
  245. package/dist/utils/circuit-breaker.js.map +1 -1
  246. package/dist/utils/fallback.d.ts.map +1 -1
  247. package/dist/utils/fallback.js +1 -4
  248. package/dist/utils/fallback.js.map +1 -1
  249. package/dist/utils/retry.d.ts.map +1 -1
  250. package/dist/utils/retry.js +8 -13
  251. package/dist/utils/retry.js.map +1 -1
  252. package/package.json +17 -8
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auto-optimizer.d.ts","sourceRoot":"","sources":["../../src/learning/auto-optimizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,eAAe,EAKhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,aAAa,CAAC;IACvB,eAAe,EAAE,eAAe,CAAC;IACjC,mBAAmB,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;IACrD,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;IACxD,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACxD;AAyBD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,eAAe,CAAkB;IAEzC,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,kBAAkB,CAAsD;IAChF,OAAO,CAAC,UAAU,CAAsC;gBAE5C,MAAM,EAAE,mBAAmB;IAqBjC,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CrD,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA6E9D,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BtE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAIrD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAIpC,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IASlD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;YAIpB,yBAAyB;YAqBzB,YAAY;YAWZ,sBAAsB;IAsCpC,OAAO,CAAC,qBAAqB;IAS7B,OAAO,CAAC,mBAAmB;CAU5B"}
@@ -0,0 +1,229 @@
1
+ const DEFAULT_VALUES = {
2
+ enabled: false,
3
+ triggerAfterRuns: 100,
4
+ minRunsForOptimization: 20,
5
+ requireABTest: true,
6
+ maxOptimizationsPerDay: 3,
7
+ };
8
+ export class AutoOptimizer {
9
+ config;
10
+ agentOptimizer;
11
+ abTesting;
12
+ monitor;
13
+ rollbackManager;
14
+ runCounts = new Map();
15
+ dailyOptimizations = new Map();
16
+ activeRuns = new Map();
17
+ constructor(config) {
18
+ this.config = {
19
+ enabled: config.enabled ?? DEFAULT_VALUES.enabled,
20
+ triggerAfterRuns: config.triggerAfterRuns ?? DEFAULT_VALUES.triggerAfterRuns,
21
+ minRunsForOptimization: config.minRunsForOptimization ?? DEFAULT_VALUES.minRunsForOptimization,
22
+ requireABTest: config.requireABTest ?? DEFAULT_VALUES.requireABTest,
23
+ maxOptimizationsPerDay: config.maxOptimizationsPerDay ?? DEFAULT_VALUES.maxOptimizationsPerDay,
24
+ agentOptimizer: config.agentOptimizer,
25
+ abTesting: config.abTesting,
26
+ monitor: config.monitor,
27
+ rollbackManager: config.rollbackManager,
28
+ onOptimizationStart: config.onOptimizationStart,
29
+ onOptimizationComplete: config.onOptimizationComplete,
30
+ onRollback: config.onRollback,
31
+ };
32
+ this.agentOptimizer = config.agentOptimizer;
33
+ this.abTesting = config.abTesting;
34
+ this.monitor = config.monitor;
35
+ this.rollbackManager = config.rollbackManager;
36
+ }
37
+ async recordExecution(trace) {
38
+ if (!this.config.enabled)
39
+ return;
40
+ const agentId = trace.agentId;
41
+ const count = (this.runCounts.get(agentId) ?? 0) + 1;
42
+ this.runCounts.set(agentId, count);
43
+ const alerts = this.monitor.recordExecution(trace);
44
+ await this.handleAlerts(agentId, alerts);
45
+ const activeABTest = await this.abTesting.getActiveTest(agentId);
46
+ if (activeABTest && trace.score !== undefined) {
47
+ const currentVersion = await this.rollbackManager.getCurrentVersion(agentId);
48
+ const variant = currentVersion?.instructions === activeABTest.treatmentInstructions ? 'treatment' : 'control';
49
+ await this.abTesting.recordResult(activeABTest.id, variant, trace.score, trace.duration ?? 0, trace.usage?.cost ?? 0);
50
+ const outcome = await this.abTesting.checkAndCompleteIfReady(activeABTest.id);
51
+ if (outcome) {
52
+ await this.handleABTestCompletion(agentId, activeABTest.id, outcome);
53
+ }
54
+ }
55
+ if (trace.score !== undefined) {
56
+ await this.rollbackManager.recordMetrics(agentId, trace.score, trace.duration ?? 0, trace.usage?.cost ?? 0, trace.metrics?.success ?? true);
57
+ }
58
+ if (count >= this.config.triggerAfterRuns && await this.shouldTriggerOptimization(agentId)) {
59
+ await this.triggerOptimization(agentId);
60
+ this.runCounts.set(agentId, 0);
61
+ }
62
+ }
63
+ async triggerOptimization(agentId) {
64
+ const run = this.createOptimizationRun(agentId);
65
+ this.activeRuns.set(agentId, run);
66
+ if (this.config.onOptimizationStart) {
67
+ this.config.onOptimizationStart(run);
68
+ }
69
+ try {
70
+ run.status = 'optimizing';
71
+ const currentVersion = await this.rollbackManager.getCurrentVersion(agentId);
72
+ const currentInstructions = currentVersion?.instructions ?? '';
73
+ const agent = { id: agentId, instructions: currentInstructions };
74
+ const optimizationResult = await this.agentOptimizer.compile(agent, [], {
75
+ maxRounds: 2,
76
+ optimizeInstructions: true,
77
+ });
78
+ if (!optimizationResult.success || optimizationResult.improvement <= 0) {
79
+ run.status = 'completed';
80
+ run.completedAt = new Date();
81
+ run.error = optimizationResult.errors.join('; ') || 'No improvement found';
82
+ if (this.config.onOptimizationComplete) {
83
+ this.config.onOptimizationComplete(run);
84
+ }
85
+ return run;
86
+ }
87
+ const newInstructions = optimizationResult.instructionsAfter ?? currentInstructions;
88
+ if (this.config.requireABTest) {
89
+ run.status = 'testing';
90
+ const abTest = await this.abTesting.createTest({
91
+ agentId,
92
+ name: `Auto-optimization ${new Date().toISOString()}`,
93
+ controlInstructions: currentInstructions,
94
+ treatmentInstructions: newInstructions,
95
+ });
96
+ run.abTestId = abTest.id;
97
+ await this.abTesting.startTest(abTest.id);
98
+ }
99
+ else {
100
+ run.status = 'deploying';
101
+ const newVersion = await this.rollbackManager.deployVersion(agentId, newInstructions, 'optimization', run.id);
102
+ run.deployedVersionId = newVersion.id;
103
+ run.status = 'completed';
104
+ run.completedAt = new Date();
105
+ }
106
+ this.incrementDailyCount(agentId);
107
+ }
108
+ catch (error) {
109
+ run.status = 'failed';
110
+ run.completedAt = new Date();
111
+ run.error = error instanceof Error ? error.message : String(error);
112
+ }
113
+ if (run.status === 'completed' || run.status === 'failed') {
114
+ if (this.config.onOptimizationComplete) {
115
+ this.config.onOptimizationComplete(run);
116
+ }
117
+ }
118
+ return run;
119
+ }
120
+ async forceRollback(agentId, reason) {
121
+ if (!this.monitor.canRollback(agentId)) {
122
+ return false;
123
+ }
124
+ const result = await this.rollbackManager.rollbackToPrevious(agentId);
125
+ if (result.success) {
126
+ this.monitor.recordRollback(agentId);
127
+ this.monitor.clearWindow(agentId);
128
+ const activeRun = this.activeRuns.get(agentId);
129
+ if (activeRun && activeRun.status !== 'completed') {
130
+ activeRun.status = 'rolled_back';
131
+ activeRun.completedAt = new Date();
132
+ activeRun.error = reason;
133
+ if (this.config.onOptimizationComplete) {
134
+ this.config.onOptimizationComplete(activeRun);
135
+ }
136
+ }
137
+ if (this.config.onRollback) {
138
+ this.config.onRollback(agentId, reason);
139
+ }
140
+ }
141
+ return result.success;
142
+ }
143
+ getActiveRun(agentId) {
144
+ return this.activeRuns.get(agentId) ?? null;
145
+ }
146
+ getRunCount(agentId) {
147
+ return this.runCounts.get(agentId) ?? 0;
148
+ }
149
+ getDailyOptimizationCount(agentId) {
150
+ const today = new Date().toISOString().split('T')[0];
151
+ const daily = this.dailyOptimizations.get(agentId);
152
+ if (daily?.date !== today) {
153
+ return 0;
154
+ }
155
+ return daily.count;
156
+ }
157
+ setEnabled(enabled) {
158
+ this.config.enabled = enabled;
159
+ }
160
+ async shouldTriggerOptimization(agentId) {
161
+ if (!this.config.enabled)
162
+ return false;
163
+ const activeRun = this.activeRuns.get(agentId);
164
+ if (activeRun && !['completed', 'failed', 'rolled_back'].includes(activeRun.status)) {
165
+ return false;
166
+ }
167
+ const activeABTest = await this.abTesting.getActiveTest(agentId);
168
+ if (activeABTest) {
169
+ return false;
170
+ }
171
+ const dailyCount = this.getDailyOptimizationCount(agentId);
172
+ if (dailyCount >= this.config.maxOptimizationsPerDay) {
173
+ return false;
174
+ }
175
+ return true;
176
+ }
177
+ async handleAlerts(agentId, alerts) {
178
+ for (const alert of alerts) {
179
+ if (alert.severity === 'critical' && alert.autoAction === 'rollback') {
180
+ const rolled = await this.forceRollback(agentId, `Critical alert: ${alert.type}`);
181
+ if (rolled) {
182
+ alert.actionTaken = true;
183
+ }
184
+ }
185
+ }
186
+ }
187
+ async handleABTestCompletion(agentId, testId, outcome) {
188
+ const activeRun = this.activeRuns.get(agentId);
189
+ if (activeRun?.abTestId !== testId) {
190
+ return;
191
+ }
192
+ activeRun.abTestOutcome = outcome;
193
+ if (outcome.winner === 'treatment') {
194
+ activeRun.status = 'deploying';
195
+ const test = await this.abTesting.getActiveTest(agentId);
196
+ if (test) {
197
+ const newVersion = await this.rollbackManager.deployVersion(agentId, test.treatmentInstructions, 'ab_test', testId);
198
+ activeRun.deployedVersionId = newVersion.id;
199
+ }
200
+ activeRun.status = 'completed';
201
+ }
202
+ else {
203
+ activeRun.status = 'completed';
204
+ }
205
+ activeRun.completedAt = new Date();
206
+ if (this.config.onOptimizationComplete) {
207
+ this.config.onOptimizationComplete(activeRun);
208
+ }
209
+ }
210
+ createOptimizationRun(agentId) {
211
+ return {
212
+ id: `opt-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`,
213
+ agentId,
214
+ status: 'pending',
215
+ startedAt: new Date(),
216
+ };
217
+ }
218
+ incrementDailyCount(agentId) {
219
+ const today = new Date().toISOString().split('T')[0];
220
+ const current = this.dailyOptimizations.get(agentId);
221
+ if (current?.date !== today) {
222
+ this.dailyOptimizations.set(agentId, { date: today, count: 1 });
223
+ }
224
+ else {
225
+ current.count++;
226
+ }
227
+ }
228
+ }
229
+ //# sourceMappingURL=auto-optimizer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auto-optimizer.js","sourceRoot":"","sources":["../../src/learning/auto-optimizer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ import type { Demo, DemoStats, ExecutionTrace, TraceStore } from '@cogitator-ai/types';
2
+ export interface DemoSelectorOptions {
3
+ traceStore: TraceStore;
4
+ maxDemos?: number;
5
+ minScore?: number;
6
+ diversityWeight?: number;
7
+ }
8
+ export declare class DemoSelector {
9
+ private traceStore;
10
+ private demos;
11
+ private agentDemos;
12
+ private maxDemos;
13
+ private minScore;
14
+ constructor(options: DemoSelectorOptions);
15
+ selectDemos(agentId: string, input: string, limit: number): Promise<Demo[]>;
16
+ addDemo(trace: ExecutionTrace): Promise<Demo>;
17
+ removeDemo(id: string): Promise<void>;
18
+ getDemoStats(agentId: string): Promise<DemoStats>;
19
+ getDemo(id: string): Demo | null;
20
+ getAllDemos(agentId: string): Demo[];
21
+ private calculateRelevance;
22
+ private diversifySelection;
23
+ private calculateSimilarity;
24
+ private extractKeySteps;
25
+ private extractContext;
26
+ private pruneLowestScoring;
27
+ formatDemosForPrompt(demos: Demo[]): string;
28
+ }
29
+ //# sourceMappingURL=demo-selector.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"demo-selector.d.ts","sourceRoot":"","sources":["../../src/learning/demo-selector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAY,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjG,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,mBAAmB;IAMlC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAwC3E,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC7C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAuCvD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIhC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE;IAapC,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,cAAc;YAeR,kBAAkB;IAsBhC,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM;CAgB5C"}
@@ -0,0 +1,235 @@
1
+ import { nanoid } from 'nanoid';
2
+ export class DemoSelector {
3
+ traceStore;
4
+ demos = new Map();
5
+ agentDemos = new Map();
6
+ maxDemos;
7
+ minScore;
8
+ constructor(options) {
9
+ this.traceStore = options.traceStore;
10
+ this.maxDemos = options.maxDemos ?? 10;
11
+ this.minScore = options.minScore ?? 0.8;
12
+ }
13
+ async selectDemos(agentId, input, limit) {
14
+ const agentDemoIds = this.agentDemos.get(agentId);
15
+ if (!agentDemoIds || agentDemoIds.size === 0) {
16
+ return [];
17
+ }
18
+ const demos = [];
19
+ for (const id of agentDemoIds) {
20
+ const demo = this.demos.get(id);
21
+ if (demo)
22
+ demos.push(demo);
23
+ }
24
+ const inputLower = input.toLowerCase();
25
+ const inputWords = new Set(inputLower.split(/\s+/).filter((w) => w.length > 3));
26
+ const scored = demos.map((demo) => {
27
+ const relevance = this.calculateRelevance(inputWords, demo);
28
+ const quality = demo.score;
29
+ const usage = Math.min(demo.usageCount * 0.1, 0.5);
30
+ const score = relevance * 0.4 + quality * 0.4 + usage * 0.2;
31
+ return { demo, score };
32
+ });
33
+ scored.sort((a, b) => b.score - a.score);
34
+ const selected = this.diversifySelection(scored.map((s) => s.demo), limit);
35
+ for (const demo of selected) {
36
+ demo.usageCount++;
37
+ demo.lastUsedAt = new Date();
38
+ }
39
+ return selected;
40
+ }
41
+ async addDemo(trace) {
42
+ if (trace.score < this.minScore) {
43
+ throw new Error(`Trace score ${trace.score} below minimum ${this.minScore}`);
44
+ }
45
+ const demo = {
46
+ id: `demo_${nanoid(12)}`,
47
+ agentId: trace.agentId,
48
+ traceId: trace.id,
49
+ input: trace.input,
50
+ output: trace.output,
51
+ keySteps: this.extractKeySteps(trace),
52
+ score: trace.score,
53
+ metrics: trace.metrics,
54
+ usageCount: 0,
55
+ lastUsedAt: new Date(),
56
+ createdAt: new Date(),
57
+ labels: trace.labels,
58
+ context: this.extractContext(trace),
59
+ };
60
+ this.demos.set(demo.id, demo);
61
+ let agentDemoIds = this.agentDemos.get(trace.agentId);
62
+ if (!agentDemoIds) {
63
+ agentDemoIds = new Set();
64
+ this.agentDemos.set(trace.agentId, agentDemoIds);
65
+ }
66
+ agentDemoIds.add(demo.id);
67
+ await this.traceStore.markAsDemo(trace.id);
68
+ if (agentDemoIds.size > this.maxDemos) {
69
+ await this.pruneLowestScoring(trace.agentId);
70
+ }
71
+ return demo;
72
+ }
73
+ async removeDemo(id) {
74
+ const demo = this.demos.get(id);
75
+ if (!demo)
76
+ return;
77
+ this.demos.delete(id);
78
+ this.agentDemos.get(demo.agentId)?.delete(id);
79
+ await this.traceStore.unmarkAsDemo(demo.traceId);
80
+ }
81
+ async getDemoStats(agentId) {
82
+ const agentDemoIds = this.agentDemos.get(agentId);
83
+ if (!agentDemoIds || agentDemoIds.size === 0) {
84
+ return {
85
+ totalDemos: 0,
86
+ averageScore: 0,
87
+ usageDistribution: [],
88
+ coverageGaps: [],
89
+ };
90
+ }
91
+ const demos = [];
92
+ for (const id of agentDemoIds) {
93
+ const demo = this.demos.get(id);
94
+ if (demo)
95
+ demos.push(demo);
96
+ }
97
+ const totalScore = demos.reduce((sum, d) => sum + d.score, 0);
98
+ const averageScore = totalScore / demos.length;
99
+ const usageDistribution = demos
100
+ .map((d) => ({ demoId: d.id, count: d.usageCount }))
101
+ .sort((a, b) => b.count - a.count);
102
+ const unusedDemos = demos.filter((d) => d.usageCount === 0);
103
+ const coverageGaps = unusedDemos.length > 0
104
+ ? ['Some demos have never been used - may indicate coverage gaps']
105
+ : [];
106
+ return {
107
+ totalDemos: demos.length,
108
+ averageScore,
109
+ usageDistribution,
110
+ coverageGaps,
111
+ };
112
+ }
113
+ getDemo(id) {
114
+ return this.demos.get(id) ?? null;
115
+ }
116
+ getAllDemos(agentId) {
117
+ const agentDemoIds = this.agentDemos.get(agentId);
118
+ if (!agentDemoIds)
119
+ return [];
120
+ const demos = [];
121
+ for (const id of agentDemoIds) {
122
+ const demo = this.demos.get(id);
123
+ if (demo)
124
+ demos.push(demo);
125
+ }
126
+ return demos.sort((a, b) => b.score - a.score);
127
+ }
128
+ calculateRelevance(inputWords, demo) {
129
+ const demoText = `${demo.input} ${demo.output} ${demo.context ?? ''}`.toLowerCase();
130
+ let matches = 0;
131
+ for (const word of inputWords) {
132
+ if (demoText.includes(word)) {
133
+ matches++;
134
+ }
135
+ }
136
+ return inputWords.size > 0 ? matches / inputWords.size : 0;
137
+ }
138
+ diversifySelection(demos, limit) {
139
+ if (demos.length <= limit) {
140
+ return demos;
141
+ }
142
+ const selected = [];
143
+ const remaining = [...demos];
144
+ selected.push(remaining.shift());
145
+ while (selected.length < limit && remaining.length > 0) {
146
+ let bestIndex = 0;
147
+ let bestDiversity = -1;
148
+ for (let i = 0; i < remaining.length; i++) {
149
+ const candidate = remaining[i];
150
+ let minSimilarity = 1;
151
+ for (const existing of selected) {
152
+ const similarity = this.calculateSimilarity(candidate, existing);
153
+ minSimilarity = Math.min(minSimilarity, similarity);
154
+ }
155
+ const diversity = 1 - minSimilarity;
156
+ if (diversity > bestDiversity) {
157
+ bestDiversity = diversity;
158
+ bestIndex = i;
159
+ }
160
+ }
161
+ selected.push(remaining.splice(bestIndex, 1)[0]);
162
+ }
163
+ return selected;
164
+ }
165
+ calculateSimilarity(a, b) {
166
+ const aWords = new Set(a.input.toLowerCase().split(/\s+/));
167
+ const bWords = new Set(b.input.toLowerCase().split(/\s+/));
168
+ let intersection = 0;
169
+ for (const word of aWords) {
170
+ if (bWords.has(word))
171
+ intersection++;
172
+ }
173
+ const union = aWords.size + bWords.size - intersection;
174
+ return union > 0 ? intersection / union : 0;
175
+ }
176
+ extractKeySteps(trace) {
177
+ const keySteps = [];
178
+ for (const step of trace.steps) {
179
+ if (step.type === 'tool_call' && step.toolCall) {
180
+ keySteps.push({
181
+ description: `Used ${step.toolCall.name} tool`,
182
+ toolName: step.toolCall.name,
183
+ toolInput: step.toolCall.arguments,
184
+ toolOutput: step.toolResult?.result,
185
+ });
186
+ }
187
+ }
188
+ return keySteps.slice(0, 5);
189
+ }
190
+ extractContext(trace) {
191
+ const parts = [];
192
+ if (trace.toolCalls.length > 0) {
193
+ const tools = [...new Set(trace.toolCalls.map((t) => t.name))];
194
+ parts.push(`Tools: ${tools.join(', ')}`);
195
+ }
196
+ if (trace.labels && trace.labels.length > 0) {
197
+ parts.push(`Labels: ${trace.labels.join(', ')}`);
198
+ }
199
+ return parts.join('; ');
200
+ }
201
+ async pruneLowestScoring(agentId) {
202
+ const agentDemoIds = this.agentDemos.get(agentId);
203
+ if (!agentDemoIds || agentDemoIds.size <= this.maxDemos)
204
+ return;
205
+ const demos = [];
206
+ for (const id of agentDemoIds) {
207
+ const demo = this.demos.get(id);
208
+ if (demo)
209
+ demos.push(demo);
210
+ }
211
+ demos.sort((a, b) => {
212
+ const scoreA = a.score * 0.6 + Math.min(a.usageCount * 0.1, 0.4);
213
+ const scoreB = b.score * 0.6 + Math.min(b.usageCount * 0.1, 0.4);
214
+ return scoreB - scoreA;
215
+ });
216
+ const toRemove = demos.slice(this.maxDemos);
217
+ for (const demo of toRemove) {
218
+ await this.removeDemo(demo.id);
219
+ }
220
+ }
221
+ formatDemosForPrompt(demos) {
222
+ if (demos.length === 0)
223
+ return '';
224
+ const formatted = demos.map((demo, i) => {
225
+ const stepsStr = demo.keySteps.length > 0
226
+ ? `\nSteps: ${demo.keySteps.map((s) => s.description).join(' → ')}`
227
+ : '';
228
+ return `Example ${i + 1}:
229
+ Input: ${demo.input}
230
+ Output: ${demo.output}${stepsStr}`;
231
+ });
232
+ return `\n\nHere are some examples of successful executions:\n\n${formatted.join('\n\n')}`;
233
+ }
234
+ }
235
+ //# sourceMappingURL=demo-selector.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"demo-selector.js","sourceRoot":"","sources":["../../src/learning/demo-selector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAUhC,MAAM,OAAO,YAAY;IACf,UAAU,CAAa;IACvB,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAChC,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC5C,QAAQ,CAAS;IACjB,QAAQ,CAAS;IAEzB,YAAY,OAA4B;QACtC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,KAAa,EAAE,KAAa;QAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,KAAK,GAAW,EAAE,CAAC;QACzB,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;QAEhF,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAChC,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;YAEnD,MAAM,KAAK,GAAG,SAAS,GAAG,GAAG,GAAG,OAAO,GAAG,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;YAE5D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAEzC,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CACtC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EACzB,KAAK,CACN,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QAC/B,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAqB;QACjC,IAAI,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,CAAC,KAAK,kBAAkB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,IAAI,GAAS;YACjB,EAAE,EAAE,QAAQ,MAAM,CAAC,EAAE,CAAC,EAAE;YACxB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;YACrC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,CAAC;YACb,UAAU,EAAE,IAAI,IAAI,EAAE;YACtB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;SACpC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAE9B,IAAI,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;YACzB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACnD,CAAC;QACD,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE1B,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAE3C,IAAI,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAE9C,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAe;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAElD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO;gBACL,UAAU,EAAE,CAAC;gBACb,YAAY,EAAE,CAAC;gBACf,iBAAiB,EAAE,EAAE;gBACrB,YAAY,EAAE,EAAE;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAW,EAAE,CAAC;QACzB,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9D,MAAM,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAE/C,MAAM,iBAAiB,GAAG,KAAK;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;aACnD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAErC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC;QAC5D,MAAM,YAAY,GAChB,WAAW,CAAC,MAAM,GAAG,CAAC;YACpB,CAAC,CAAC,CAAC,8DAA8D,CAAC;YAClE,CAAC,CAAC,EAAE,CAAC;QAET,OAAO;YACL,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,YAAY;YACZ,iBAAiB;YACjB,YAAY;SACb,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IACpC,CAAC;IAED,WAAW,CAAC,OAAe;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY;YAAE,OAAO,EAAE,CAAC;QAE7B,MAAM,KAAK,GAAW,EAAE,CAAC;QACzB,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IAEO,kBAAkB,CAAC,UAAuB,EAAE,IAAU;QAC5D,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC;QAEpF,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAEO,kBAAkB,CAAC,KAAa,EAAE,KAAa;QACrD,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YAC1B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,QAAQ,GAAW,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QAE7B,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAG,CAAC,CAAC;QAElC,OAAO,QAAQ,CAAC,MAAM,GAAG,KAAK,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvD,IAAI,SAAS,GAAG,CAAC,CAAC;YAClB,IAAI,aAAa,GAAG,CAAC,CAAC,CAAC;YAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC/B,IAAI,aAAa,GAAG,CAAC,CAAC;gBAEtB,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;oBAChC,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;oBACjE,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;gBACtD,CAAC;gBAED,MAAM,SAAS,GAAG,CAAC,GAAG,aAAa,CAAC;gBACpC,IAAI,SAAS,GAAG,aAAa,EAAE,CAAC;oBAC9B,aAAa,GAAG,SAAS,CAAC;oBAC1B,SAAS,GAAG,CAAC,CAAC;gBAChB,CAAC;YACH,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,mBAAmB,CAAC,CAAO,EAAE,CAAO;QAC1C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAE3D,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC1B,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,YAAY,EAAE,CAAC;QACvC,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC;QACvD,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAEO,eAAe,CAAC,KAAqB;QAC3C,MAAM,QAAQ,GAAe,EAAE,CAAC;QAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/C,QAAQ,CAAC,IAAI,CAAC;oBACZ,WAAW,EAAE,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO;oBAC9C,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;oBAC5B,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS;oBAClC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM;iBACpC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IAEO,cAAc,CAAC,KAAqB;QAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/D,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,OAAe;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEhE,MAAM,KAAK,GAAW,EAAE,CAAC;QACzB,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAClB,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;YACjE,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,GAAG,EAAE,GAAG,CAAC,CAAC;YACjE,OAAO,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,oBAAoB,CAAC,KAAa;QAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAElC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACtC,MAAM,QAAQ,GACZ,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACtB,CAAC,CAAC,YAAY,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;gBACnE,CAAC,CAAC,EAAE,CAAC;YAET,OAAO,WAAW,CAAC,GAAG,CAAC;SACpB,IAAI,CAAC,KAAK;UACT,IAAI,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,OAAO,2DAA2D,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7F,CAAC;CACF"}
@@ -0,0 +1,24 @@
1
+ export { InMemoryTraceStore } from './trace-store';
2
+ export { MetricEvaluator, createSuccessMetric, createExactMatchMetric, createContainsMetric, } from './metrics';
3
+ export type { MetricEvaluatorOptions } from './metrics';
4
+ export { DemoSelector } from './demo-selector';
5
+ export type { DemoSelectorOptions } from './demo-selector';
6
+ export { InstructionOptimizer } from './instruction-optimizer';
7
+ export type { InstructionOptimizerOptions } from './instruction-optimizer';
8
+ export { AgentOptimizer } from './agent-optimizer';
9
+ export type { AgentOptimizerOptions } from './agent-optimizer';
10
+ export { buildFailureAnalysisPrompt, buildInstructionCandidatePrompt, buildInstructionEvaluationPrompt, buildInstructionRefinementPrompt, parseFailureAnalysisResponse, parseInstructionCandidatesResponse, parseInstructionEvaluationResponse, parseInstructionRefinementResponse, } from './prompts';
11
+ export type { FailureAnalysisResult, InstructionCandidate, InstructionEvaluation, InstructionRefinement, } from './prompts';
12
+ export { PostgresTraceStore } from './postgres-trace-store';
13
+ export type { PostgresTraceStoreConfig } from './postgres-trace-store';
14
+ export { PromptLogger, wrapWithPromptLogger } from './prompt-logger';
15
+ export type { PromptLoggerContext, PromptLoggerConfig } from './prompt-logger';
16
+ export { ABTestingFramework } from './ab-testing';
17
+ export type { ABTestingFrameworkConfig } from './ab-testing';
18
+ export { PromptMonitor } from './prompt-monitor';
19
+ export type { PromptMonitorConfig } from './prompt-monitor';
20
+ export { RollbackManager } from './rollback-manager';
21
+ export type { RollbackManagerConfig, RollbackResult } from './rollback-manager';
22
+ export { AutoOptimizer } from './auto-optimizer';
23
+ export type { AutoOptimizerConfig } from './auto-optimizer';
24
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,gCAAgC,EAChC,gCAAgC,EAChC,4BAA4B,EAC5B,kCAAkC,EAClC,kCAAkC,EAClC,kCAAkC,GACnC,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}
@@ -0,0 +1,13 @@
1
+ export { InMemoryTraceStore } from './trace-store';
2
+ export { MetricEvaluator, createSuccessMetric, createExactMatchMetric, createContainsMetric, } from './metrics';
3
+ export { DemoSelector } from './demo-selector';
4
+ export { InstructionOptimizer } from './instruction-optimizer';
5
+ export { AgentOptimizer } from './agent-optimizer';
6
+ export { buildFailureAnalysisPrompt, buildInstructionCandidatePrompt, buildInstructionEvaluationPrompt, buildInstructionRefinementPrompt, parseFailureAnalysisResponse, parseInstructionCandidatesResponse, parseInstructionEvaluationResponse, parseInstructionRefinementResponse, } from './prompts';
7
+ export { PostgresTraceStore } from './postgres-trace-store';
8
+ export { PromptLogger, wrapWithPromptLogger } from './prompt-logger';
9
+ export { ABTestingFramework } from './ab-testing';
10
+ export { PromptMonitor } from './prompt-monitor';
11
+ export { RollbackManager } from './rollback-manager';
12
+ export { AutoOptimizer } from './auto-optimizer';
13
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,gCAAgC,EAChC,gCAAgC,EAChC,4BAA4B,EAC5B,kCAAkC,EAClC,kCAAkC,EAClC,kCAAkC,GACnC,MAAM,WAAW,CAAC;AAQnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}
@@ -0,0 +1,29 @@
1
+ import type { ExecutionTrace, TraceStore, InsightStore, InstructionOptimizationResult, LLMBackend } from '@cogitator-ai/types';
2
+ export interface InstructionOptimizerOptions {
3
+ llm: LLMBackend;
4
+ model: string;
5
+ traceStore: TraceStore;
6
+ insightStore?: InsightStore;
7
+ candidateCount?: number;
8
+ refinementRounds?: number;
9
+ }
10
+ export declare class InstructionOptimizer {
11
+ private llm;
12
+ private model;
13
+ private traceStore;
14
+ private insightStore?;
15
+ private candidateCount;
16
+ private refinementRounds;
17
+ constructor(options: InstructionOptimizerOptions);
18
+ optimize(agentId: string, currentInstructions: string, options?: {
19
+ traces?: ExecutionTrace[];
20
+ maxTraces?: number;
21
+ minScoreToConsider?: number;
22
+ }): Promise<InstructionOptimizationResult>;
23
+ private analyzeFailures;
24
+ private generateCandidates;
25
+ private evaluateCandidates;
26
+ private refineInstructions;
27
+ private estimateInstructionScore;
28
+ }
29
+ //# sourceMappingURL=instruction-optimizer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"instruction-optimizer.d.ts","sourceRoot":"","sources":["../../src/learning/instruction-optimizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,YAAY,EAGZ,6BAA6B,EAC7B,UAAU,EACX,MAAM,qBAAqB,CAAC;AAY7B,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAS;gBAErB,OAAO,EAAE,2BAA2B;IAS1C,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,mBAAmB,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,GACA,OAAO,CAAC,6BAA6B,CAAC;YAoF3B,eAAe;YAqBf,kBAAkB;YAyBlB,kBAAkB;YAkClB,kBAAkB;YAqBlB,wBAAwB;CAgBvC"}