@weavelogic/knowledge-graph-agent 0.6.0 → 0.7.1

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 (219) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +70 -3
  3. package/dist/_virtual/__vite-browser-external.js +2 -2
  4. package/dist/_virtual/__vite-browser-external.js.map +1 -1
  5. package/dist/_virtual/index12.js +7 -0
  6. package/dist/_virtual/index12.js.map +1 -0
  7. package/dist/_virtual/ort-web.min.js +8 -0
  8. package/dist/_virtual/ort-web.min.js.map +1 -0
  9. package/dist/_virtual/ort-web.min2.js +5 -0
  10. package/dist/_virtual/ort-web.min2.js.map +1 -0
  11. package/dist/agents/base-agent.d.ts +63 -0
  12. package/dist/agents/base-agent.d.ts.map +1 -1
  13. package/dist/agents/base-agent.js +139 -0
  14. package/dist/agents/base-agent.js.map +1 -1
  15. package/dist/agents/coordinator-agent.d.ts +422 -0
  16. package/dist/agents/coordinator-agent.d.ts.map +1 -0
  17. package/dist/agents/documenter-agent.d.ts +298 -0
  18. package/dist/agents/documenter-agent.d.ts.map +1 -0
  19. package/dist/agents/index.d.ts +11 -1
  20. package/dist/agents/index.d.ts.map +1 -1
  21. package/dist/agents/index.js +4 -0
  22. package/dist/agents/index.js.map +1 -1
  23. package/dist/agents/mixins/index.d.ts +9 -0
  24. package/dist/agents/mixins/index.d.ts.map +1 -0
  25. package/dist/agents/mixins/trajectory-mixin.d.ts +112 -0
  26. package/dist/agents/mixins/trajectory-mixin.d.ts.map +1 -0
  27. package/dist/agents/optimizer-agent.d.ts +388 -0
  28. package/dist/agents/optimizer-agent.d.ts.map +1 -0
  29. package/dist/agents/planner-agent.d.ts +395 -0
  30. package/dist/agents/planner-agent.d.ts.map +1 -0
  31. package/dist/agents/registry.d.ts.map +1 -1
  32. package/dist/agents/registry.js +5 -0
  33. package/dist/agents/registry.js.map +1 -1
  34. package/dist/agents/reviewer-agent.d.ts +330 -0
  35. package/dist/agents/reviewer-agent.d.ts.map +1 -0
  36. package/dist/agents/types.d.ts +12 -1
  37. package/dist/agents/types.d.ts.map +1 -1
  38. package/dist/agents/types.js +1 -0
  39. package/dist/agents/types.js.map +1 -1
  40. package/dist/cli/commands/hive-mind/add-frontmatter.d.ts +102 -0
  41. package/dist/cli/commands/hive-mind/add-frontmatter.d.ts.map +1 -0
  42. package/dist/cli/commands/hive-mind/add-frontmatter.js +439 -0
  43. package/dist/cli/commands/hive-mind/add-frontmatter.js.map +1 -0
  44. package/dist/cli/commands/hive-mind/analyze-links.d.ts +80 -0
  45. package/dist/cli/commands/hive-mind/analyze-links.d.ts.map +1 -0
  46. package/dist/cli/commands/hive-mind/analyze-links.js +367 -0
  47. package/dist/cli/commands/hive-mind/analyze-links.js.map +1 -0
  48. package/dist/cli/commands/hive-mind/find-connections.d.ts +75 -0
  49. package/dist/cli/commands/hive-mind/find-connections.d.ts.map +1 -0
  50. package/dist/cli/commands/hive-mind/find-connections.js +347 -0
  51. package/dist/cli/commands/hive-mind/find-connections.js.map +1 -0
  52. package/dist/cli/commands/hive-mind/index.d.ts +37 -0
  53. package/dist/cli/commands/hive-mind/index.d.ts.map +1 -0
  54. package/dist/cli/commands/hive-mind/index.js +33 -0
  55. package/dist/cli/commands/hive-mind/index.js.map +1 -0
  56. package/dist/cli/commands/hive-mind/validate-names.d.ts +79 -0
  57. package/dist/cli/commands/hive-mind/validate-names.d.ts.map +1 -0
  58. package/dist/cli/commands/hive-mind/validate-names.js +353 -0
  59. package/dist/cli/commands/hive-mind/validate-names.js.map +1 -0
  60. package/dist/cli/commands/vector.js +2 -0
  61. package/dist/cli/commands/vector.js.map +1 -1
  62. package/dist/cli/index.d.ts.map +1 -1
  63. package/dist/cli/index.js +7 -0
  64. package/dist/cli/index.js.map +1 -1
  65. package/dist/equilibrium/agent-equilibrium.d.ts +194 -0
  66. package/dist/equilibrium/agent-equilibrium.d.ts.map +1 -0
  67. package/dist/equilibrium/agent-equilibrium.js +304 -0
  68. package/dist/equilibrium/agent-equilibrium.js.map +1 -0
  69. package/dist/equilibrium/graph-equilibrium.d.ts +177 -0
  70. package/dist/equilibrium/graph-equilibrium.d.ts.map +1 -0
  71. package/dist/equilibrium/index.d.ts +11 -0
  72. package/dist/equilibrium/index.d.ts.map +1 -0
  73. package/dist/equilibrium/memory-equilibrium.d.ts +153 -0
  74. package/dist/equilibrium/memory-equilibrium.d.ts.map +1 -0
  75. package/dist/graphql/resolvers/index.d.ts.map +1 -1
  76. package/dist/graphql/resolvers/queries.d.ts +11 -0
  77. package/dist/graphql/resolvers/queries.d.ts.map +1 -1
  78. package/dist/index.d.ts +2 -0
  79. package/dist/index.d.ts.map +1 -1
  80. package/dist/index.js +10 -4
  81. package/dist/index.js.map +1 -1
  82. package/dist/inference/index.d.ts +9 -0
  83. package/dist/inference/index.d.ts.map +1 -0
  84. package/dist/inference/model-selection.d.ts +131 -0
  85. package/dist/inference/model-selection.d.ts.map +1 -0
  86. package/dist/integrations/agentic-flow/adapters/agent-booster-adapter.d.ts +265 -0
  87. package/dist/integrations/agentic-flow/adapters/agent-booster-adapter.d.ts.map +1 -0
  88. package/dist/integrations/agentic-flow/adapters/agentdb-adapter.d.ts +197 -0
  89. package/dist/integrations/agentic-flow/adapters/agentdb-adapter.d.ts.map +1 -0
  90. package/dist/integrations/agentic-flow/adapters/agentdb-vector-store.d.ts +249 -0
  91. package/dist/integrations/agentic-flow/adapters/agentdb-vector-store.d.ts.map +1 -0
  92. package/dist/integrations/agentic-flow/adapters/base-adapter.d.ts +120 -0
  93. package/dist/integrations/agentic-flow/adapters/base-adapter.d.ts.map +1 -0
  94. package/dist/integrations/agentic-flow/adapters/federation-hub-adapter.d.ts +444 -0
  95. package/dist/integrations/agentic-flow/adapters/federation-hub-adapter.d.ts.map +1 -0
  96. package/dist/integrations/agentic-flow/adapters/index.d.ts +17 -0
  97. package/dist/integrations/agentic-flow/adapters/index.d.ts.map +1 -0
  98. package/dist/integrations/agentic-flow/adapters/model-router-adapter.d.ts +242 -0
  99. package/dist/integrations/agentic-flow/adapters/model-router-adapter.d.ts.map +1 -0
  100. package/dist/integrations/agentic-flow/adapters/quic-transport-adapter.d.ts +364 -0
  101. package/dist/integrations/agentic-flow/adapters/quic-transport-adapter.d.ts.map +1 -0
  102. package/dist/integrations/agentic-flow/adapters/reasoning-bank-adapter.d.ts +209 -0
  103. package/dist/integrations/agentic-flow/adapters/reasoning-bank-adapter.d.ts.map +1 -0
  104. package/dist/integrations/agentic-flow/benchmark/index.d.ts +9 -0
  105. package/dist/integrations/agentic-flow/benchmark/index.d.ts.map +1 -0
  106. package/dist/integrations/agentic-flow/benchmark/vector-benchmark.d.ts +253 -0
  107. package/dist/integrations/agentic-flow/benchmark/vector-benchmark.d.ts.map +1 -0
  108. package/dist/integrations/agentic-flow/config.d.ts +109 -0
  109. package/dist/integrations/agentic-flow/config.d.ts.map +1 -0
  110. package/dist/integrations/agentic-flow/feature-flags.d.ts +140 -0
  111. package/dist/integrations/agentic-flow/feature-flags.d.ts.map +1 -0
  112. package/dist/integrations/agentic-flow/index.d.ts +22 -0
  113. package/dist/integrations/agentic-flow/index.d.ts.map +1 -0
  114. package/dist/integrations/agentic-flow/migration/index.d.ts +9 -0
  115. package/dist/integrations/agentic-flow/migration/index.d.ts.map +1 -0
  116. package/dist/integrations/agentic-flow/migration/migrate-to-agentdb.d.ts +242 -0
  117. package/dist/integrations/agentic-flow/migration/migrate-to-agentdb.d.ts.map +1 -0
  118. package/dist/learning/index.d.ts +91 -0
  119. package/dist/learning/index.d.ts.map +1 -0
  120. package/dist/learning/learning-loop.d.ts +176 -0
  121. package/dist/learning/learning-loop.d.ts.map +1 -0
  122. package/dist/learning/services/ab-testing-framework.d.ts +135 -0
  123. package/dist/learning/services/ab-testing-framework.d.ts.map +1 -0
  124. package/dist/learning/services/agent-priming-service.d.ts +207 -0
  125. package/dist/learning/services/agent-priming-service.d.ts.map +1 -0
  126. package/dist/learning/services/daily-log-generator.d.ts +113 -0
  127. package/dist/learning/services/daily-log-generator.d.ts.map +1 -0
  128. package/dist/learning/services/index.d.ts +14 -0
  129. package/dist/learning/services/index.d.ts.map +1 -0
  130. package/dist/learning/services/memory-extraction-service.d.ts +87 -0
  131. package/dist/learning/services/memory-extraction-service.d.ts.map +1 -0
  132. package/dist/learning/services/task-completion-consumer.d.ts +162 -0
  133. package/dist/learning/services/task-completion-consumer.d.ts.map +1 -0
  134. package/dist/learning/services/trajectory-tracker.d.ts +174 -0
  135. package/dist/learning/services/trajectory-tracker.d.ts.map +1 -0
  136. package/dist/learning/types.d.ts +516 -0
  137. package/dist/learning/types.d.ts.map +1 -0
  138. package/dist/mcp/clients/claude-flow-memory-client.d.ts +259 -0
  139. package/dist/mcp/clients/claude-flow-memory-client.d.ts.map +1 -0
  140. package/dist/mcp/clients/claude-flow-memory-client.js +305 -0
  141. package/dist/mcp/clients/claude-flow-memory-client.js.map +1 -0
  142. package/dist/mcp/clients/index.d.ts +11 -0
  143. package/dist/mcp/clients/index.d.ts.map +1 -0
  144. package/dist/mcp/clients/mcp-client-adapter.d.ts +146 -0
  145. package/dist/mcp/clients/mcp-client-adapter.d.ts.map +1 -0
  146. package/dist/mcp/clients/mcp-client-adapter.js +372 -0
  147. package/dist/mcp/clients/mcp-client-adapter.js.map +1 -0
  148. package/dist/mcp/index.d.ts +10 -0
  149. package/dist/mcp/index.d.ts.map +1 -0
  150. package/dist/memory/vault-sync.d.ts +12 -0
  151. package/dist/memory/vault-sync.d.ts.map +1 -1
  152. package/dist/memory/vault-sync.js +94 -11
  153. package/dist/memory/vault-sync.js.map +1 -1
  154. package/dist/node_modules/@huggingface/jinja/dist/index.js +118 -0
  155. package/dist/node_modules/@huggingface/jinja/dist/index.js.map +1 -0
  156. package/dist/node_modules/@typescript-eslint/project-service/dist/index.js +1 -1
  157. package/dist/node_modules/@xenova/transformers/src/backends/onnx.js +24 -0
  158. package/dist/node_modules/@xenova/transformers/src/backends/onnx.js.map +1 -0
  159. package/dist/node_modules/@xenova/transformers/src/configs.js +52 -0
  160. package/dist/node_modules/@xenova/transformers/src/configs.js.map +1 -0
  161. package/dist/node_modules/@xenova/transformers/src/env.js +35 -0
  162. package/dist/node_modules/@xenova/transformers/src/env.js.map +1 -0
  163. package/dist/node_modules/@xenova/transformers/src/models.js +3852 -0
  164. package/dist/node_modules/@xenova/transformers/src/models.js.map +1 -0
  165. package/dist/node_modules/@xenova/transformers/src/tokenizers.js +144 -0
  166. package/dist/node_modules/@xenova/transformers/src/tokenizers.js.map +1 -0
  167. package/dist/node_modules/@xenova/transformers/src/utils/core.js +52 -0
  168. package/dist/node_modules/@xenova/transformers/src/utils/core.js.map +1 -0
  169. package/dist/node_modules/@xenova/transformers/src/utils/generation.js +623 -0
  170. package/dist/node_modules/@xenova/transformers/src/utils/generation.js.map +1 -0
  171. package/dist/node_modules/@xenova/transformers/src/utils/hub.js +395 -0
  172. package/dist/node_modules/@xenova/transformers/src/utils/hub.js.map +1 -0
  173. package/dist/node_modules/@xenova/transformers/src/utils/image.js +12 -0
  174. package/dist/node_modules/@xenova/transformers/src/utils/image.js.map +1 -0
  175. package/dist/node_modules/@xenova/transformers/src/utils/maths.js +89 -0
  176. package/dist/node_modules/@xenova/transformers/src/utils/maths.js.map +1 -0
  177. package/dist/node_modules/@xenova/transformers/src/utils/tensor.js +750 -0
  178. package/dist/node_modules/@xenova/transformers/src/utils/tensor.js.map +1 -0
  179. package/dist/node_modules/fdir/dist/index.js +13 -13
  180. package/dist/node_modules/fdir/dist/index.js.map +1 -1
  181. package/dist/node_modules/onnxruntime-common/dist/lib/backend-impl.js +67 -0
  182. package/dist/node_modules/onnxruntime-common/dist/lib/backend-impl.js.map +1 -0
  183. package/dist/node_modules/onnxruntime-common/dist/lib/env-impl.js +24 -0
  184. package/dist/node_modules/onnxruntime-common/dist/lib/env-impl.js.map +1 -0
  185. package/dist/node_modules/onnxruntime-common/dist/lib/env.js +6 -0
  186. package/dist/node_modules/onnxruntime-common/dist/lib/env.js.map +1 -0
  187. package/dist/node_modules/onnxruntime-common/dist/lib/index.js +11 -0
  188. package/dist/node_modules/onnxruntime-common/dist/lib/index.js.map +1 -0
  189. package/dist/node_modules/onnxruntime-common/dist/lib/inference-session-impl.js +162 -0
  190. package/dist/node_modules/onnxruntime-common/dist/lib/inference-session-impl.js.map +1 -0
  191. package/dist/node_modules/onnxruntime-common/dist/lib/inference-session.js +6 -0
  192. package/dist/node_modules/onnxruntime-common/dist/lib/inference-session.js.map +1 -0
  193. package/dist/node_modules/onnxruntime-common/dist/lib/tensor-impl.js +393 -0
  194. package/dist/node_modules/onnxruntime-common/dist/lib/tensor-impl.js.map +1 -0
  195. package/dist/node_modules/onnxruntime-common/dist/lib/tensor.js +6 -0
  196. package/dist/node_modules/onnxruntime-common/dist/lib/tensor.js.map +1 -0
  197. package/dist/node_modules/onnxruntime-web/dist/ort-web.min.js +12919 -0
  198. package/dist/node_modules/onnxruntime-web/dist/ort-web.min.js.map +1 -0
  199. package/dist/node_modules/tinyglobby/dist/index.js +14 -14
  200. package/dist/node_modules/tinyglobby/dist/index.js.map +1 -1
  201. package/dist/node_modules/typescript/lib/typescript.js +24 -24
  202. package/dist/node_modules/typescript/lib/typescript.js.map +1 -1
  203. package/dist/transport/agent-transport.d.ts +269 -0
  204. package/dist/transport/agent-transport.d.ts.map +1 -0
  205. package/dist/transport/index.d.ts +10 -0
  206. package/dist/transport/index.d.ts.map +1 -0
  207. package/dist/vector/index.d.ts +1 -1
  208. package/dist/vector/index.d.ts.map +1 -1
  209. package/dist/vector/services/embedding-service.d.ts +244 -0
  210. package/dist/vector/services/embedding-service.d.ts.map +1 -0
  211. package/dist/vector/services/embedding-service.js +10 -0
  212. package/dist/vector/services/embedding-service.js.map +1 -0
  213. package/dist/vector/services/hybrid-search.d.ts +320 -0
  214. package/dist/vector/services/hybrid-search.d.ts.map +1 -0
  215. package/dist/vector/services/hybrid-search.js +3 -0
  216. package/dist/vector/services/hybrid-search.js.map +1 -0
  217. package/dist/vector/services/index.d.ts +4 -0
  218. package/dist/vector/services/index.d.ts.map +1 -1
  219. package/package.json +10 -1
@@ -0,0 +1,87 @@
1
+ /**
2
+ * Memory Extraction Service
3
+ *
4
+ * Extracts different types of memories from completed task results
5
+ * including episodic, procedural, semantic, technical, and context memories.
6
+ *
7
+ * @module learning/services/memory-extraction-service
8
+ */
9
+ import { type ExtractedMemory, type TaskResult } from '../types.js';
10
+ /**
11
+ * Configuration for memory extraction
12
+ */
13
+ export interface MemoryExtractionConfig {
14
+ /** Extract episodic memories */
15
+ extractEpisodic: boolean;
16
+ /** Extract procedural memories */
17
+ extractProcedural: boolean;
18
+ /** Extract semantic memories */
19
+ extractSemantic: boolean;
20
+ /** Extract technical memories */
21
+ extractTechnical: boolean;
22
+ /** Minimum confidence threshold */
23
+ minConfidence: number;
24
+ /** Maximum content length */
25
+ maxContentLength: number;
26
+ /** Include embeddings */
27
+ generateEmbeddings: boolean;
28
+ }
29
+ /**
30
+ * Memory Extraction Service
31
+ *
32
+ * Extracts structured memories from task execution results for
33
+ * later retrieval and agent priming.
34
+ *
35
+ * @example
36
+ * ```typescript
37
+ * const extractor = new MemoryExtractionService();
38
+ * const memories = await extractor.extractFromTask(taskResult);
39
+ * console.log(`Extracted ${memories.length} memories`);
40
+ * ```
41
+ */
42
+ export declare class MemoryExtractionService {
43
+ private config;
44
+ constructor(config?: Partial<MemoryExtractionConfig>);
45
+ /**
46
+ * Extract all memory types from a task result
47
+ */
48
+ extractFromTask(taskResult: TaskResult): Promise<ExtractedMemory[]>;
49
+ /**
50
+ * Extract episodic memory - what happened during task execution
51
+ */
52
+ private extractEpisodic;
53
+ /**
54
+ * Extract procedural memory - how the task was executed
55
+ */
56
+ private extractProcedural;
57
+ /**
58
+ * Extract semantic memories - concepts and facts learned
59
+ */
60
+ private extractSemantic;
61
+ /**
62
+ * Extract technical memories - code patterns and solutions
63
+ */
64
+ private extractTechnical;
65
+ /**
66
+ * Extract context memory - environmental information
67
+ */
68
+ private extractContext;
69
+ private createTaskSummary;
70
+ private buildProcedure;
71
+ private buildContextSummary;
72
+ private extractConcepts;
73
+ private extractFacts;
74
+ private identifyPatterns;
75
+ private extractTaskTags;
76
+ private extractActionTags;
77
+ private calculateEpisodicConfidence;
78
+ private calculateProceduralConfidence;
79
+ private formatDuration;
80
+ private truncateContent;
81
+ private groupByType;
82
+ }
83
+ /**
84
+ * Create a memory extraction service instance
85
+ */
86
+ export declare function createMemoryExtractionService(config?: Partial<MemoryExtractionConfig>): MemoryExtractionService;
87
+ //# sourceMappingURL=memory-extraction-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-extraction-service.d.ts","sourceRoot":"","sources":["../../../src/learning/services/memory-extraction-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,UAAU,EAKhB,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gCAAgC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gCAAgC;IAChC,eAAe,EAAE,OAAO,CAAC;IACzB,iCAAiC;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAYD;;;;;;;;;;;;GAYG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,GAAE,OAAO,CAAC,sBAAsB,CAAM;IAIxD;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAiEzE;;OAEG;YACW,eAAe;IAwB7B;;OAEG;YACW,iBAAiB;IAuB/B;;OAEG;YACW,eAAe;IAkC7B;;OAEG;YACW,gBAAgB;IAqD9B;;OAEG;YACW,cAAc;IA2B5B,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,eAAe;IA8CvB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,gBAAgB;IAqExB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,2BAA2B;IAkBnC,OAAO,CAAC,6BAA6B;IAWrC,OAAO,CAAC,cAAc;IAUtB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,WAAW;CASpB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACvC,uBAAuB,CAEzB"}
@@ -0,0 +1,162 @@
1
+ /**
2
+ * Task Completion Consumer
3
+ *
4
+ * Processes task completion events, extracts memories, updates statistics,
5
+ * and triggers learning cycles when thresholds are met.
6
+ *
7
+ * @module learning/services/task-completion-consumer
8
+ */
9
+ import { EventEmitter } from 'events';
10
+ import { type TaskCompletionEvent, type ExtractedMemory, type MemoryStore, type ActivityStore } from '../types.js';
11
+ import { MemoryExtractionService } from './memory-extraction-service.js';
12
+ /**
13
+ * Task statistics tracking
14
+ */
15
+ export interface TaskStatistics {
16
+ totalTasks: number;
17
+ successfulTasks: number;
18
+ failedTasks: number;
19
+ totalDurationMs: number;
20
+ totalTokensUsed: number;
21
+ avgQualityScore: number;
22
+ qualityScoreCount: number;
23
+ byAgentType: Record<string, {
24
+ total: number;
25
+ successful: number;
26
+ avgDurationMs: number;
27
+ }>;
28
+ memoriesExtracted: number;
29
+ lastTaskTime: Date | null;
30
+ }
31
+ /**
32
+ * Configuration for task completion consumer
33
+ */
34
+ export interface TaskConsumerConfig {
35
+ /** Number of tasks before triggering learning cycle */
36
+ learningThreshold: number;
37
+ /** Enable automatic learning triggers */
38
+ autoTriggerLearning: boolean;
39
+ /** Store all activities for daily logs */
40
+ storeActivities: boolean;
41
+ /** Maximum activities to keep in memory */
42
+ maxActivitiesInMemory: number;
43
+ }
44
+ /**
45
+ * Events emitted by the consumer
46
+ */
47
+ export interface TaskConsumerEvents {
48
+ 'memory-extracted': (memories: ExtractedMemory[]) => void;
49
+ 'learning-trigger': (data: {
50
+ reason: string;
51
+ taskCount: number;
52
+ }) => void;
53
+ 'task-processed': (event: TaskCompletionEvent) => void;
54
+ 'statistics-updated': (stats: TaskStatistics) => void;
55
+ 'error': (error: Error) => void;
56
+ }
57
+ /**
58
+ * Task Completion Consumer
59
+ *
60
+ * Listens for task completion events and processes them to extract
61
+ * memories and update statistics.
62
+ *
63
+ * @example
64
+ * ```typescript
65
+ * const consumer = new TaskCompletionConsumer(memoryExtraction, memoryStore);
66
+ *
67
+ * consumer.on('learning-trigger', (data) => {
68
+ * console.log('Learning cycle triggered:', data.reason);
69
+ * });
70
+ *
71
+ * await consumer.processCompletion(event);
72
+ * ```
73
+ */
74
+ export declare class TaskCompletionConsumer extends EventEmitter {
75
+ private memoryExtraction;
76
+ private memoryStore;
77
+ private activityStore;
78
+ private config;
79
+ private statistics;
80
+ private recentActivities;
81
+ private tasksSinceLastLearning;
82
+ private isProcessing;
83
+ private processingQueue;
84
+ constructor(memoryExtraction: MemoryExtractionService, memoryStore?: MemoryStore, activityStore?: ActivityStore, config?: Partial<TaskConsumerConfig>);
85
+ /**
86
+ * Process a task completion event
87
+ */
88
+ processCompletion(event: TaskCompletionEvent): Promise<void>;
89
+ /**
90
+ * Process a single event
91
+ */
92
+ private processEvent;
93
+ /**
94
+ * Update statistics with a new task result
95
+ */
96
+ private updateStatistics;
97
+ /**
98
+ * Store activity for daily logs
99
+ */
100
+ private storeActivity;
101
+ /**
102
+ * Check if learning cycle should be triggered
103
+ */
104
+ private shouldTriggerLearning;
105
+ /**
106
+ * Get current statistics
107
+ */
108
+ getStatistics(): TaskStatistics;
109
+ /**
110
+ * Get success rate
111
+ */
112
+ getSuccessRate(): number;
113
+ /**
114
+ * Get average task duration
115
+ */
116
+ getAverageDuration(): number;
117
+ /**
118
+ * Get recent activities for a date range
119
+ */
120
+ getActivities(startDate?: Date, endDate?: Date): TaskCompletionEvent[];
121
+ /**
122
+ * Get activities for today
123
+ */
124
+ getTodayActivities(): TaskCompletionEvent[];
125
+ /**
126
+ * Get activities by agent type
127
+ */
128
+ getActivitiesByAgent(agentType: string): TaskCompletionEvent[];
129
+ /**
130
+ * Get failed activities
131
+ */
132
+ getFailedActivities(): TaskCompletionEvent[];
133
+ /**
134
+ * Reset statistics
135
+ */
136
+ resetStatistics(): void;
137
+ /**
138
+ * Clear all data
139
+ */
140
+ clear(): void;
141
+ /**
142
+ * Create empty statistics object
143
+ */
144
+ private createEmptyStatistics;
145
+ /**
146
+ * Force trigger learning cycle
147
+ */
148
+ forceLearningTrigger(): void;
149
+ /**
150
+ * Get pending queue size
151
+ */
152
+ getPendingQueueSize(): number;
153
+ /**
154
+ * Check if consumer is currently processing
155
+ */
156
+ isCurrentlyProcessing(): boolean;
157
+ }
158
+ /**
159
+ * Create a task completion consumer instance
160
+ */
161
+ export declare function createTaskCompletionConsumer(memoryExtraction: MemoryExtractionService, memoryStore?: MemoryStore, activityStore?: ActivityStore, config?: Partial<TaskConsumerConfig>): TaskCompletionConsumer;
162
+ //# sourceMappingURL=task-completion-consumer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-completion-consumer.d.ts","sourceRoot":"","sources":["../../../src/learning/services/task-completion-consumer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,174 @@
1
+ /**
2
+ * Trajectory Tracker Service
3
+ *
4
+ * Tracks task execution trajectories for agents, storing them in the
5
+ * ReasoningBank for future learning and verdict judgment.
6
+ *
7
+ * Each trajectory represents a complete task execution with all steps,
8
+ * observations, and the final outcome.
9
+ *
10
+ * @module learning/services/trajectory-tracker
11
+ */
12
+ import { EventEmitter } from 'events';
13
+ import { ReasoningBankAdapter, type TrajectoryStep } from '../../integrations/agentic-flow/adapters/reasoning-bank-adapter.js';
14
+ /**
15
+ * Configuration for the trajectory tracker
16
+ */
17
+ export interface TrajectoryTrackerConfig {
18
+ /** Enable trajectory tracking */
19
+ enabled: boolean;
20
+ /** Automatically store trajectories on completion */
21
+ autoStore: boolean;
22
+ /** Minimum steps required to store a trajectory */
23
+ minStepsToStore: number;
24
+ /** Include detailed observations in steps */
25
+ detailedObservations: boolean;
26
+ /** Maximum observation length */
27
+ maxObservationLength: number;
28
+ }
29
+ /**
30
+ * Events emitted by the trajectory tracker
31
+ */
32
+ export interface TrajectoryTrackerEvents {
33
+ 'trajectory:started': {
34
+ trajectoryId: string;
35
+ taskId: string;
36
+ };
37
+ 'trajectory:step': {
38
+ trajectoryId: string;
39
+ step: TrajectoryStep;
40
+ stepIndex: number;
41
+ };
42
+ 'trajectory:completed': {
43
+ trajectoryId: string;
44
+ storedId: string | null;
45
+ outcome: 'success' | 'failure' | 'partial';
46
+ stepCount: number;
47
+ };
48
+ 'trajectory:aborted': {
49
+ trajectoryId: string;
50
+ reason: string;
51
+ };
52
+ 'trajectory:skipped': {
53
+ trajectoryId: string;
54
+ reason: string;
55
+ };
56
+ 'trajectory:error': {
57
+ trajectoryId: string;
58
+ error: unknown;
59
+ };
60
+ }
61
+ /**
62
+ * Tracks task execution trajectories for learning
63
+ *
64
+ * @example
65
+ * ```typescript
66
+ * const tracker = new TrajectoryTracker(reasoningBank, { enabled: true });
67
+ *
68
+ * // Start tracking a task
69
+ * const trajectoryId = tracker.startTrajectory('task-123', { agentType: 'coder' });
70
+ *
71
+ * // Record steps as the task executes
72
+ * tracker.recordStep(trajectoryId, {
73
+ * action: 'analyze',
74
+ * observation: 'Found 5 code issues',
75
+ * });
76
+ *
77
+ * tracker.recordStep(trajectoryId, {
78
+ * action: 'fix',
79
+ * observation: 'Applied 5 fixes',
80
+ * });
81
+ *
82
+ * // Complete the trajectory
83
+ * await tracker.completeTrajectory(trajectoryId, 'success', { quality: 0.95 });
84
+ * ```
85
+ */
86
+ export declare class TrajectoryTracker extends EventEmitter {
87
+ private config;
88
+ private reasoningBank;
89
+ private activeTrajectories;
90
+ constructor(reasoningBank: ReasoningBankAdapter | null, config?: Partial<TrajectoryTrackerConfig>);
91
+ /**
92
+ * Check if tracking is enabled
93
+ */
94
+ isEnabled(): boolean;
95
+ /**
96
+ * Start tracking a new trajectory for a task
97
+ *
98
+ * @param taskId - Unique identifier for the task
99
+ * @param metadata - Additional metadata to store with the trajectory
100
+ * @returns Trajectory ID for subsequent operations
101
+ */
102
+ startTrajectory(taskId: string, metadata?: Record<string, unknown>): string;
103
+ /**
104
+ * Record a step in the trajectory
105
+ *
106
+ * @param trajectoryId - ID of the trajectory to record to
107
+ * @param step - Step data (action, observation, and optional fields)
108
+ */
109
+ recordStep(trajectoryId: string, step: Omit<TrajectoryStep, 'timestamp'>): void;
110
+ /**
111
+ * Complete and store the trajectory
112
+ *
113
+ * @param trajectoryId - ID of the trajectory to complete
114
+ * @param outcome - Final outcome of the task
115
+ * @param finalMetadata - Additional metadata to include
116
+ * @returns ID of the stored trajectory, or null if not stored
117
+ */
118
+ completeTrajectory(trajectoryId: string, outcome: 'success' | 'failure' | 'partial', finalMetadata?: Record<string, unknown>): Promise<string | null>;
119
+ /**
120
+ * Abort a trajectory without storing
121
+ *
122
+ * @param trajectoryId - ID of the trajectory to abort
123
+ * @param reason - Reason for aborting
124
+ */
125
+ abortTrajectory(trajectoryId: string, reason: string): void;
126
+ /**
127
+ * Get count of active trajectories
128
+ */
129
+ getActiveCount(): number;
130
+ /**
131
+ * Get all active trajectory IDs
132
+ */
133
+ getActiveIds(): string[];
134
+ /**
135
+ * Get progress of a trajectory
136
+ *
137
+ * @param trajectoryId - ID of the trajectory
138
+ * @returns Progress info or null if not found
139
+ */
140
+ getProgress(trajectoryId: string): {
141
+ stepCount: number;
142
+ duration: number;
143
+ lastStep?: TrajectoryStep;
144
+ } | null;
145
+ /**
146
+ * Get a snapshot of an active trajectory
147
+ *
148
+ * @param trajectoryId - ID of the trajectory
149
+ * @returns Active trajectory data or null
150
+ */
151
+ getActiveTrajectory(trajectoryId: string): {
152
+ taskId: string;
153
+ stepCount: number;
154
+ startTime: Date;
155
+ metadata: Record<string, unknown>;
156
+ } | null;
157
+ /**
158
+ * Clear all active trajectories (for cleanup)
159
+ */
160
+ clearActive(): void;
161
+ /**
162
+ * Update configuration
163
+ */
164
+ updateConfig(config: Partial<TrajectoryTrackerConfig>): void;
165
+ /**
166
+ * Get current configuration
167
+ */
168
+ getConfig(): TrajectoryTrackerConfig;
169
+ }
170
+ /**
171
+ * Create a trajectory tracker instance
172
+ */
173
+ export declare function createTrajectoryTracker(reasoningBank: ReasoningBankAdapter | null, config?: Partial<TrajectoryTrackerConfig>): TrajectoryTracker;
174
+ //# sourceMappingURL=trajectory-tracker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"trajectory-tracker.d.ts","sourceRoot":"","sources":["../../../src/learning/services/trajectory-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EACL,oBAAoB,EAEpB,KAAK,cAAc,EACpB,MAAM,oEAAoE,CAAC;AAM5E;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IAEjB,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IAEnB,mDAAmD;IACnD,eAAe,EAAE,MAAM,CAAC;IAExB,6CAA6C;IAC7C,oBAAoB,EAAE,OAAO,CAAC;IAE9B,iCAAiC;IACjC,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAiCD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,oBAAoB,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,iBAAiB,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,cAAc,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACrF,sBAAsB,EAAE;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QAC3C,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,oBAAoB,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,oBAAoB,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,kBAAkB,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CAC9D;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,kBAAkB,CAAgC;gBAGxD,aAAa,EAAE,oBAAoB,GAAG,IAAI,EAC1C,MAAM,GAAE,OAAO,CAAC,uBAAuB,CAAM;IAQ/C;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;;OAMG;IACH,eAAe,CACb,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,MAAM;IAsBT;;;;;OAKG;IACH,UAAU,CACR,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,GACtC,IAAI;IAuCP;;;;;;;OAOG;IACG,kBAAkB,CACtB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,EAC1C,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAC1C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA2DzB;;;;;OAKG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAU3D;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;;;;OAKG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG;QACjC,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;KAC3B,GAAG,IAAI;IAWR;;;;;OAKG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG;QACzC,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,IAAI,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,IAAI;IAYR;;OAEG;IACH,WAAW,IAAI,IAAI;IAMnB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,SAAS,IAAI,uBAAuB;CAGrC;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,oBAAoB,GAAG,IAAI,EAC1C,MAAM,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GACxC,iBAAiB,CAEnB"}