@codebolt/agent 1.2.1 → 2.2.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 (285) hide show
  1. package/README.md +157 -66
  2. package/dist/{agent.js → builderpattern/agent.js} +2 -2
  3. package/dist/{followupquestionbuilder.d.ts → builderpattern/followupquestionbuilder.d.ts} +1 -1
  4. package/dist/{followupquestionbuilder.js → builderpattern/followupquestionbuilder.js} +1 -1
  5. package/dist/{index.d.ts → builderpattern/index.d.ts} +3 -3
  6. package/dist/{llmoutputhandler.d.ts → builderpattern/llmoutputhandler.d.ts} +1 -1
  7. package/dist/{llmoutputhandler.js → builderpattern/llmoutputhandler.js} +7 -7
  8. package/dist/{promptbuilder.d.ts → builderpattern/promptbuilder.d.ts} +3 -3
  9. package/dist/{taskInstruction.d.ts → builderpattern/taskInstruction.d.ts} +2 -2
  10. package/dist/{usermessage.d.ts → builderpattern/usermessage.d.ts} +9 -4
  11. package/dist/composablepattern/agent.d.ts +169 -0
  12. package/dist/composablepattern/agent.js +598 -0
  13. package/dist/composablepattern/codebolt-storage.d.ts +67 -0
  14. package/dist/composablepattern/codebolt-storage.js +320 -0
  15. package/dist/composablepattern/document.d.ts +149 -0
  16. package/dist/composablepattern/document.js +372 -0
  17. package/dist/composablepattern/examples/codebolt-integration-example.d.ts +12 -0
  18. package/dist/composablepattern/examples/codebolt-integration-example.js +218 -0
  19. package/dist/composablepattern/examples/codebolt-storage-example.d.ts +40 -0
  20. package/dist/composablepattern/examples/codebolt-storage-example.js +223 -0
  21. package/dist/composablepattern/examples/custom-steps-example.d.ts +20 -0
  22. package/dist/composablepattern/examples/custom-steps-example.js +455 -0
  23. package/dist/composablepattern/examples/document-agent.d.ts +17 -0
  24. package/dist/composablepattern/examples/document-agent.js +107 -0
  25. package/dist/composablepattern/examples/simple-codebolt-integration.d.ts +8 -0
  26. package/dist/composablepattern/examples/simple-codebolt-integration.js +164 -0
  27. package/dist/composablepattern/examples/weather-agent.d.ts +18 -0
  28. package/dist/composablepattern/examples/weather-agent.js +86 -0
  29. package/dist/composablepattern/examples/workflow-example.d.ts +12 -0
  30. package/dist/composablepattern/examples/workflow-example.js +463 -0
  31. package/dist/composablepattern/index.d.ts +63 -0
  32. package/dist/composablepattern/index.js +115 -0
  33. package/dist/composablepattern/memory.d.ts +89 -0
  34. package/dist/composablepattern/memory.js +141 -0
  35. package/dist/composablepattern/tool.d.ts +84 -0
  36. package/dist/composablepattern/tool.js +260 -0
  37. package/dist/composablepattern/types.d.ts +194 -0
  38. package/dist/composablepattern/types.js +6 -0
  39. package/dist/composablepattern/user-context.d.ts +214 -0
  40. package/dist/composablepattern/user-context.js +275 -0
  41. package/dist/composablepattern/workflow.d.ts +388 -0
  42. package/dist/composablepattern/workflow.js +562 -0
  43. package/dist/local-tools/fileTools.d.ts +26 -0
  44. package/dist/local-tools/fileTools.js +162 -0
  45. package/dist/processor/agent/agentStep.d.ts +49 -0
  46. package/dist/processor/agent/agentStep.js +241 -0
  47. package/dist/processor/agent/toolExecutor.d.ts +19 -0
  48. package/dist/processor/agent/toolExecutor.js +90 -0
  49. package/dist/processor/index.d.ts +7 -0
  50. package/dist/processor/index.js +36 -0
  51. package/dist/processor/messageModifiers/baseMessageModifier.d.ts +20 -0
  52. package/dist/processor/messageModifiers/baseMessageModifier.js +55 -0
  53. package/dist/processor/processors/baseProcessor.d.ts +14 -0
  54. package/dist/processor/processors/baseProcessor.js +29 -0
  55. package/dist/processor/tools/baseTool.d.ts +10 -0
  56. package/dist/processor/tools/baseTool.js +20 -0
  57. package/dist/processor/tools/toolList.d.ts +9 -0
  58. package/dist/processor/tools/toolList.js +22 -0
  59. package/dist/processor/types/interfaces.d.ts +117 -0
  60. package/dist/processor/types/interfaces.js +2 -0
  61. package/dist/processor-pieces/additionalModifiers/argumentProcessorModifier.d.ts +13 -0
  62. package/dist/processor-pieces/additionalModifiers/argumentProcessorModifier.js +68 -0
  63. package/dist/processor-pieces/additionalModifiers/atFileProcessorModifier.d.ts +15 -0
  64. package/dist/processor-pieces/additionalModifiers/atFileProcessorModifier.js +212 -0
  65. package/dist/processor-pieces/additionalModifiers/chatCompressionModifier.d.ts +19 -0
  66. package/dist/processor-pieces/additionalModifiers/chatCompressionModifier.js +110 -0
  67. package/dist/processor-pieces/additionalModifiers/chatRecordingModifier.d.ts +23 -0
  68. package/dist/processor-pieces/additionalModifiers/chatRecordingModifier.js +173 -0
  69. package/dist/processor-pieces/additionalModifiers/coreSystemPromptModifier.d.ts +14 -0
  70. package/dist/processor-pieces/additionalModifiers/coreSystemPromptModifier.js +93 -0
  71. package/dist/processor-pieces/additionalModifiers/directoryContextModifier.d.ts +30 -0
  72. package/dist/processor-pieces/additionalModifiers/directoryContextModifier.js +330 -0
  73. package/dist/processor-pieces/additionalModifiers/environmentContextModifier.d.ts +26 -0
  74. package/dist/processor-pieces/additionalModifiers/environmentContextModifier.js +269 -0
  75. package/dist/processor-pieces/additionalModifiers/fallbackHandlerModifier.d.ts +38 -0
  76. package/dist/processor-pieces/additionalModifiers/fallbackHandlerModifier.js +217 -0
  77. package/dist/processor-pieces/additionalModifiers/ideContextModifier.d.ts +34 -0
  78. package/dist/processor-pieces/additionalModifiers/ideContextModifier.js +147 -0
  79. package/dist/processor-pieces/additionalModifiers/index.d.ts +12 -0
  80. package/dist/processor-pieces/additionalModifiers/index.js +28 -0
  81. package/dist/processor-pieces/additionalModifiers/loopDetectionModifier.d.ts +29 -0
  82. package/dist/processor-pieces/additionalModifiers/loopDetectionModifier.js +155 -0
  83. package/dist/processor-pieces/additionalModifiers/memoryImportModifier.d.ts +15 -0
  84. package/dist/processor-pieces/additionalModifiers/memoryImportModifier.js +129 -0
  85. package/dist/processor-pieces/additionalModifiers/shellProcessorModifier.d.ts +25 -0
  86. package/dist/processor-pieces/additionalModifiers/shellProcessorModifier.js +169 -0
  87. package/dist/processor-pieces/additionalModifiers/toolInjectionModifier.d.ts +20 -0
  88. package/dist/processor-pieces/additionalModifiers/toolInjectionModifier.js +152 -0
  89. package/dist/processor-pieces/base/baseMessageModifier.d.ts +12 -0
  90. package/dist/processor-pieces/base/baseMessageModifier.js +15 -0
  91. package/dist/processor-pieces/base/basePostInferenceProcessor.d.ts +13 -0
  92. package/dist/processor-pieces/base/basePostInferenceProcessor.js +18 -0
  93. package/dist/processor-pieces/base/basePostToolCallProcessor.d.ts +15 -0
  94. package/dist/processor-pieces/base/basePostToolCallProcessor.js +25 -0
  95. package/dist/processor-pieces/base/basePreInferenceProcessor.d.ts +12 -0
  96. package/dist/processor-pieces/base/basePreInferenceProcessor.js +17 -0
  97. package/dist/processor-pieces/base/basePreToolCallProcessor.d.ts +18 -0
  98. package/dist/processor-pieces/base/basePreToolCallProcessor.js +66 -0
  99. package/dist/processor-pieces/base/index.d.ts +9 -0
  100. package/dist/processor-pieces/base/index.js +18 -0
  101. package/dist/processor-pieces/index.d.ts +1 -0
  102. package/dist/processor-pieces/index.js +59 -0
  103. package/dist/processor-pieces/messageModifiers/addCurrentDirectoryRootFilesModifier.d.ts +7 -0
  104. package/dist/processor-pieces/messageModifiers/addCurrentDirectoryRootFilesModifier.js +93 -0
  105. package/dist/processor-pieces/messageModifiers/addToolsListMessageModifier.d.ts +31 -0
  106. package/dist/processor-pieces/messageModifiers/addToolsListMessageModifier.js +145 -0
  107. package/dist/processor-pieces/messageModifiers/advancedSystemInstructionMessageModifier.d.ts +9 -0
  108. package/dist/processor-pieces/messageModifiers/advancedSystemInstructionMessageModifier.js +77 -0
  109. package/dist/processor-pieces/messageModifiers/argumentProcessorModifier.d.ts +13 -0
  110. package/dist/processor-pieces/messageModifiers/argumentProcessorModifier.js +68 -0
  111. package/dist/processor-pieces/messageModifiers/atFileProcessorModifier.d.ts +25 -0
  112. package/dist/processor-pieces/messageModifiers/atFileProcessorModifier.js +453 -0
  113. package/dist/processor-pieces/messageModifiers/baseContextMessageModifier.d.ts +7 -0
  114. package/dist/processor-pieces/messageModifiers/baseContextMessageModifier.js +67 -0
  115. package/dist/processor-pieces/messageModifiers/baseSystemInstructionMessageModifier.d.ts +9 -0
  116. package/dist/processor-pieces/messageModifiers/baseSystemInstructionMessageModifier.js +90 -0
  117. package/dist/processor-pieces/messageModifiers/chatCompressionModifier.d.ts +19 -0
  118. package/dist/processor-pieces/messageModifiers/chatCompressionModifier.js +110 -0
  119. package/dist/processor-pieces/messageModifiers/chatHistoryMessageModifier.d.ts +18 -0
  120. package/dist/processor-pieces/messageModifiers/chatHistoryMessageModifier.example.d.ts +20 -0
  121. package/dist/processor-pieces/messageModifiers/chatHistoryMessageModifier.example.js +124 -0
  122. package/dist/processor-pieces/messageModifiers/chatHistoryMessageModifier.js +104 -0
  123. package/dist/processor-pieces/messageModifiers/chatRecordingModifier.d.ts +23 -0
  124. package/dist/processor-pieces/messageModifiers/chatRecordingModifier.js +173 -0
  125. package/dist/processor-pieces/messageModifiers/coreSystemPromptModifier.d.ts +14 -0
  126. package/dist/processor-pieces/messageModifiers/coreSystemPromptModifier.js +130 -0
  127. package/dist/processor-pieces/messageModifiers/directoryContextModifier.d.ts +36 -0
  128. package/dist/processor-pieces/messageModifiers/directoryContextModifier.js +418 -0
  129. package/dist/processor-pieces/messageModifiers/environmentContext.d.ts +41 -0
  130. package/dist/processor-pieces/messageModifiers/environmentContext.js +355 -0
  131. package/dist/processor-pieces/messageModifiers/environmentContextModifier.d.ts +26 -0
  132. package/dist/processor-pieces/messageModifiers/environmentContextModifier.js +260 -0
  133. package/dist/processor-pieces/messageModifiers/handleUrlMessageModifier.d.ts +13 -0
  134. package/dist/processor-pieces/messageModifiers/handleUrlMessageModifier.js +59 -0
  135. package/dist/processor-pieces/messageModifiers/ideContextModifier.d.ts +34 -0
  136. package/dist/processor-pieces/messageModifiers/ideContextModifier.js +157 -0
  137. package/dist/processor-pieces/messageModifiers/imageAttachmentMessageModifier.d.ts +19 -0
  138. package/dist/processor-pieces/messageModifiers/imageAttachmentMessageModifier.js +221 -0
  139. package/dist/processor-pieces/messageModifiers/index.d.ts +11 -0
  140. package/dist/processor-pieces/messageModifiers/index.js +26 -0
  141. package/dist/processor-pieces/messageModifiers/memoryImportModifier.d.ts +15 -0
  142. package/dist/processor-pieces/messageModifiers/memoryImportModifier.js +129 -0
  143. package/dist/processor-pieces/messageModifiers/mentionedFilesModifier.d.ts +23 -0
  144. package/dist/processor-pieces/messageModifiers/mentionedFilesModifier.js +207 -0
  145. package/dist/processor-pieces/messageModifiers/simpleMessageModifier.d.ts +7 -0
  146. package/dist/processor-pieces/messageModifiers/simpleMessageModifier.js +26 -0
  147. package/dist/processor-pieces/messageModifiers/toolInjectionModifier.d.ts +20 -0
  148. package/dist/processor-pieces/messageModifiers/toolInjectionModifier.js +152 -0
  149. package/dist/processor-pieces/messageModifiers/workingDirectoryMessageModifier.d.ts +38 -0
  150. package/dist/processor-pieces/messageModifiers/workingDirectoryMessageModifier.js +392 -0
  151. package/dist/processor-pieces/postInference/llmOutputValidityProcessor.d.ts +1 -0
  152. package/dist/processor-pieces/postInference/llmOutputValidityProcessor.js +2 -0
  153. package/dist/processor-pieces/postInferenceProcessors/checkForNoToolCall.d.ts +7 -0
  154. package/dist/processor-pieces/postInferenceProcessors/checkForNoToolCall.js +24 -0
  155. package/dist/processor-pieces/postInferenceProcessors/loopDetectionModifier.d.ts +29 -0
  156. package/dist/processor-pieces/postInferenceProcessors/loopDetectionModifier.js +174 -0
  157. package/dist/processor-pieces/postToolCall/advancedLoopDetectionProcessor.d.ts +41 -0
  158. package/dist/processor-pieces/postToolCall/advancedLoopDetectionProcessor.js +197 -0
  159. package/dist/processor-pieces/postToolCall/chatCompressionProcessor.d.ts +26 -0
  160. package/dist/processor-pieces/postToolCall/chatCompressionProcessor.js +90 -0
  161. package/dist/processor-pieces/postToolCall/chatRecordingProcessor.d.ts +81 -0
  162. package/dist/processor-pieces/postToolCall/chatRecordingProcessor.js +329 -0
  163. package/dist/processor-pieces/postToolCall/contextManagementProcessor.d.ts +40 -0
  164. package/dist/processor-pieces/postToolCall/contextManagementProcessor.js +272 -0
  165. package/dist/processor-pieces/postToolCall/conversationCompactorProcessor.d.ts +49 -0
  166. package/dist/processor-pieces/postToolCall/conversationCompactorProcessor.js +291 -0
  167. package/dist/processor-pieces/postToolCall/conversationContinuityProcessor.d.ts +49 -0
  168. package/dist/processor-pieces/postToolCall/conversationContinuityProcessor.js +293 -0
  169. package/dist/processor-pieces/postToolCall/followUpConversationProcessor.d.ts +47 -0
  170. package/dist/processor-pieces/postToolCall/followUpConversationProcessor.js +249 -0
  171. package/dist/processor-pieces/postToolCall/loopDetectionProcessor.d.ts +30 -0
  172. package/dist/processor-pieces/postToolCall/loopDetectionProcessor.js +137 -0
  173. package/dist/processor-pieces/postToolCall/responseValidationProcessor.d.ts +30 -0
  174. package/dist/processor-pieces/postToolCall/responseValidationProcessor.js +228 -0
  175. package/dist/processor-pieces/postToolCall/telemetryProcessor.d.ts +99 -0
  176. package/dist/processor-pieces/postToolCall/telemetryProcessor.js +278 -0
  177. package/dist/processor-pieces/postToolCall/tokenManagementProcessor.d.ts +37 -0
  178. package/dist/processor-pieces/postToolCall/tokenManagementProcessor.js +178 -0
  179. package/dist/processor-pieces/postToolCall/toolExecutionProcessor.d.ts +43 -0
  180. package/dist/processor-pieces/postToolCall/toolExecutionProcessor.js +207 -0
  181. package/dist/processor-pieces/postToolCallProcessors/index.d.ts +1 -0
  182. package/dist/processor-pieces/postToolCallProcessors/index.js +2 -0
  183. package/dist/processor-pieces/postToolCallProcessors/shellProcessorModifier.d.ts +25 -0
  184. package/dist/processor-pieces/postToolCallProcessors/shellProcessorModifier.js +225 -0
  185. package/dist/processor-pieces/preInference/conversationCompactorProcessor.d.ts +52 -0
  186. package/dist/processor-pieces/preInference/conversationCompactorProcessor.js +264 -0
  187. package/dist/processor-pieces/preInference/conversationContinuityProcessor.d.ts +49 -0
  188. package/dist/processor-pieces/preInference/conversationContinuityProcessor.js +293 -0
  189. package/dist/processor-pieces/preInferenceProcessors/chatCompressionModifier.d.ts +35 -0
  190. package/dist/processor-pieces/preInferenceProcessors/chatCompressionModifier.js +255 -0
  191. package/dist/processor-pieces/preInferenceProcessors/conversationCompaction.d.ts +7 -0
  192. package/dist/processor-pieces/preInferenceProcessors/conversationCompaction.js +31 -0
  193. package/dist/processor-pieces/preInferenceProcessors/index.d.ts +1 -0
  194. package/dist/processor-pieces/preInferenceProcessors/index.js +2 -0
  195. package/dist/processor-pieces/preToolCall/index.d.ts +9 -0
  196. package/dist/processor-pieces/preToolCall/index.js +18 -0
  197. package/dist/processor-pieces/preToolCall/localToolInterceptorProcessor.d.ts +58 -0
  198. package/dist/processor-pieces/preToolCall/localToolInterceptorProcessor.js +444 -0
  199. package/dist/processor-pieces/preToolCall/toolParameterModifierProcessor.d.ts +44 -0
  200. package/dist/processor-pieces/preToolCall/toolParameterModifierProcessor.js +367 -0
  201. package/dist/processor-pieces/preToolCall/toolValidationProcessor.d.ts +58 -0
  202. package/dist/processor-pieces/preToolCall/toolValidationProcessor.js +391 -0
  203. package/dist/processor-pieces/pretoolCallProcessors/index.d.ts +1 -0
  204. package/dist/processor-pieces/pretoolCallProcessors/index.js +2 -0
  205. package/dist/processor-pieces/processors/advancedLoopDetectionProcessor.d.ts +41 -0
  206. package/dist/processor-pieces/processors/advancedLoopDetectionProcessor.js +197 -0
  207. package/dist/processor-pieces/processors/chatCompressionProcessor.d.ts +26 -0
  208. package/dist/processor-pieces/processors/chatCompressionProcessor.js +90 -0
  209. package/dist/processor-pieces/processors/chatRecordingProcessor.d.ts +81 -0
  210. package/dist/processor-pieces/processors/chatRecordingProcessor.js +329 -0
  211. package/dist/processor-pieces/processors/contextManagementProcessor.d.ts +40 -0
  212. package/dist/processor-pieces/processors/contextManagementProcessor.js +305 -0
  213. package/dist/processor-pieces/processors/loopDetectionProcessor.d.ts +30 -0
  214. package/dist/processor-pieces/processors/loopDetectionProcessor.js +137 -0
  215. package/dist/processor-pieces/processors/responseValidationProcessor.d.ts +30 -0
  216. package/dist/processor-pieces/processors/responseValidationProcessor.js +228 -0
  217. package/dist/processor-pieces/processors/telemetryProcessor.d.ts +99 -0
  218. package/dist/processor-pieces/processors/telemetryProcessor.js +311 -0
  219. package/dist/processor-pieces/processors/tokenManagementProcessor.d.ts +37 -0
  220. package/dist/processor-pieces/processors/tokenManagementProcessor.js +178 -0
  221. package/dist/processor-pieces/processors/toolExecutionProcessor.d.ts +43 -0
  222. package/dist/processor-pieces/processors/toolExecutionProcessor.js +207 -0
  223. package/dist/processor-pieces/tools/fileTools.d.ts +26 -0
  224. package/dist/processor-pieces/tools/fileTools.js +162 -0
  225. package/dist/processor-pieces/utils/messageModifierHelper.d.ts +4 -0
  226. package/dist/processor-pieces/utils/messageModifierHelper.js +58 -0
  227. package/dist/types/commonTypes.d.ts +4 -0
  228. package/dist/types/processorTypes.d.ts +67 -0
  229. package/dist/types/processorTypes.js +58 -0
  230. package/dist/unified/agent/agent.d.ts +17 -0
  231. package/dist/unified/agent/agent.js +79 -0
  232. package/dist/unified/agent/team.d.ts +2 -0
  233. package/dist/unified/agent/team.js +6 -0
  234. package/dist/unified/agent/tool.d.ts +99 -0
  235. package/dist/unified/agent/tool.js +440 -0
  236. package/dist/unified/agent/tools.d.ts +44 -0
  237. package/dist/unified/agent/tools.js +487 -0
  238. package/dist/unified/agent/workflow.d.ts +24 -0
  239. package/dist/unified/agent/workflow.js +275 -0
  240. package/dist/unified/agent/workflowControls.d.ts +11 -0
  241. package/dist/unified/agent/workflowControls.js +20 -0
  242. package/dist/unified/agent/workflowSteps.d.ts +63 -0
  243. package/dist/unified/agent/workflowSteps.js +284 -0
  244. package/dist/unified/base/agentStep.d.ts +32 -0
  245. package/dist/unified/base/agentStep.js +96 -0
  246. package/dist/unified/base/create/createInitialPromptGenerators.d.ts +5 -0
  247. package/dist/unified/base/create/createInitialPromptGenerators.js +17 -0
  248. package/dist/unified/base/index.d.ts +5 -0
  249. package/dist/unified/base/index.js +13 -0
  250. package/dist/unified/base/initialPromptGenerator.d.ts +48 -0
  251. package/dist/unified/base/initialPromptGenerator.js +118 -0
  252. package/dist/unified/base/responseExecutor.d.ts +36 -0
  253. package/dist/unified/base/responseExecutor.js +283 -0
  254. package/dist/unified/examples/agentExample.d.ts +46 -0
  255. package/dist/unified/examples/agentExample.js +464 -0
  256. package/dist/unified/examples/documentationPatternExample.d.ts +10 -0
  257. package/dist/unified/examples/documentationPatternExample.js +385 -0
  258. package/dist/unified/examples/followUpProcessorsExample.d.ts +45 -0
  259. package/dist/unified/examples/followUpProcessorsExample.js +311 -0
  260. package/dist/unified/examples/orchestratorExample.d.ts +16 -0
  261. package/dist/unified/examples/orchestratorExample.js +415 -0
  262. package/dist/unified/examples/preToolCallProcessorsExample.d.ts +36 -0
  263. package/dist/unified/examples/preToolCallProcessorsExample.js +458 -0
  264. package/dist/unified/examples/workflowExample.d.ts +12 -0
  265. package/dist/unified/examples/workflowExample.js +497 -0
  266. package/dist/unified/index.d.ts +18 -0
  267. package/dist/unified/index.js +42 -0
  268. package/dist/unified/orchestrator/orchestrator.d.ts +260 -0
  269. package/dist/unified/orchestrator/orchestrator.js +519 -0
  270. package/dist/unified/team/team.d.ts +1 -0
  271. package/dist/unified/team/team.js +2 -0
  272. package/dist/unified/types/libTypes.d.ts +378 -0
  273. package/dist/unified/types/libTypes.js +6 -0
  274. package/dist/unified/types/types.d.ts +212 -0
  275. package/dist/unified/types/types.js +43 -0
  276. package/dist/unified/utils/utils.d.ts +40 -0
  277. package/dist/unified/utils/utils.js +219 -0
  278. package/package.json +35 -13
  279. /package/dist/{agent.d.ts → builderpattern/agent.d.ts} +0 -0
  280. /package/dist/{index.js → builderpattern/index.js} +0 -0
  281. /package/dist/{promptbuilder.js → builderpattern/promptbuilder.js} +0 -0
  282. /package/dist/{systemprompt.d.ts → builderpattern/systemprompt.d.ts} +0 -0
  283. /package/dist/{systemprompt.js → builderpattern/systemprompt.js} +0 -0
  284. /package/dist/{taskInstruction.js → builderpattern/taskInstruction.js} +0 -0
  285. /package/dist/{usermessage.js → builderpattern/usermessage.js} +0 -0
@@ -0,0 +1,219 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.validateAgentConfig = validateAgentConfig;
4
+ exports.benchmarkAgent = benchmarkAgent;
5
+ // /**
6
+ // * Quick agent creation for simple use cases
7
+ // */
8
+ // export function createQuickAgent(options: {
9
+ // userMessage: string;
10
+ // tools?: OpenAITool[];
11
+ // codebolt?: CodeboltAPI;
12
+ // }): Promise<string> {
13
+ // const agent = createUnifiedAgent({
14
+ // codebolt: options.codebolt,
15
+ // enableLogging: false,
16
+ // maxIterations: 5
17
+ // });
18
+ // return agent.execute({
19
+ // userMessage: options.userMessage,
20
+ // tools: options.tools
21
+ // }).then((result: any) => result.response);
22
+ // }
23
+ /**
24
+ * Advanced agent creation with full configuration
25
+ */
26
+ // export function createAdvancedAgent(config: {
27
+ // llmConfig: LLMConfig;
28
+ // codebolt: CodeboltAPI;
29
+ // processors?: MessageModifier[];
30
+ // maxIterations?: number;
31
+ // maxConversationLength?: number;
32
+ // enableLogging?: boolean;
33
+ // }): UnifiedAgent {
34
+ // const agentConfig: UnifiedAgentConfig = {
35
+ // llmConfig: config.llmConfig,
36
+ // codebolt: config.codebolt,
37
+ // maxIterations: config.maxIterations || 15,
38
+ // maxConversationLength: config.maxConversationLength || 100,
39
+ // enableLogging: config.enableLogging !== false
40
+ // };
41
+ // const agent = createUnifiedAgent(agentConfig);
42
+ // // Add custom processors if provided
43
+ // if (config.processors && config.processors.length > 0) {
44
+ // const messageModifier = createUnifiedMessageModifier({
45
+ // processors: config.processors,
46
+ // enableLogging: config.enableLogging
47
+ // });
48
+ // agent.addMessageModifier(messageModifier);
49
+ // }
50
+ // return agent;
51
+ // }
52
+ // /**
53
+ // * Create agent with custom components
54
+ // */
55
+ // export function createCustomAgent(config: {
56
+ // messageModifier?: any;
57
+ // agentStep?: any;
58
+ // responseExecutor?: any;
59
+ // agentConfig?: UnifiedAgentConfig;
60
+ // }): UnifiedAgent {
61
+ // const agent = createUnifiedAgent(config.agentConfig);
62
+ // if (config.messageModifier) {
63
+ // agent.addMessageModifier(config.messageModifier);
64
+ // }
65
+ // if (config.agentStep) {
66
+ // agent.setAgentStep(config.agentStep);
67
+ // }
68
+ // if (config.responseExecutor) {
69
+ // agent.setResponseExecutor(config.responseExecutor);
70
+ // }
71
+ // return agent;
72
+ // }
73
+ // /**
74
+ // * Utility to create a development agent with verbose logging
75
+ // */
76
+ // export function createDevelopmentAgent(codebolt?: CodeboltAPI): UnifiedAgent {
77
+ // const agent = createUnifiedAgent({
78
+ // codebolt,
79
+ // enableLogging: true,
80
+ // maxIterations: 10,
81
+ // maxConversationLength: 30,
82
+ // llmConfig: {
83
+ // llmname: 'DevelopmentLLM',
84
+ // temperature: 0.8
85
+ // }
86
+ // });
87
+ // // Add development event listeners
88
+ // agent.addEventListener('step_started', (event: any) => {
89
+ // console.log('🚀 [Dev] Step started:', event.data);
90
+ // });
91
+ // agent.addEventListener('tool_execution_started', (event: any) => {
92
+ // console.log('🔧 [Dev] Tool execution started:', event.data);
93
+ // });
94
+ // agent.addEventListener('agent_error', (event: any) => {
95
+ // console.error('❌ [Dev] Agent error:', event.data);
96
+ // });
97
+ // agent.addEventListener('agent_completed', (event: any) => {
98
+ // console.log('✅ [Dev] Agent completed:', event.data);
99
+ // });
100
+ // return agent;
101
+ // }
102
+ /**
103
+ * Utility to create a testing agent with minimal configuration
104
+ */
105
+ // export function createTestingAgent(): UnifiedAgent {
106
+ // return createUnifiedAgent({
107
+ // enableLogging: false,
108
+ // maxIterations: 3,
109
+ // maxConversationLength: 10,
110
+ // llmConfig: {
111
+ // llmname: 'TestLLM',
112
+ // temperature: 0.1
113
+ // }
114
+ // });
115
+ // }
116
+ /**
117
+ * Utility to validate agent configuration
118
+ */
119
+ function validateAgentConfig(config) {
120
+ const errors = [];
121
+ const warnings = [];
122
+ // Check required fields
123
+ if (config.maxIterations !== undefined && config.maxIterations < 1) {
124
+ errors.push('maxIterations must be at least 1');
125
+ }
126
+ if (config.maxConversationLength !== undefined && config.maxConversationLength < 5) {
127
+ errors.push('maxConversationLength must be at least 5');
128
+ }
129
+ // Check LLM config
130
+ if (config.llmConfig) {
131
+ if (!config.llmConfig.llmname) {
132
+ warnings.push('llmname not specified, using default');
133
+ }
134
+ if (config.llmConfig.temperature !== undefined &&
135
+ (config.llmConfig.temperature < 0 || config.llmConfig.temperature > 2)) {
136
+ warnings.push('temperature should be between 0 and 2');
137
+ }
138
+ if (config.llmConfig.maxTokens !== undefined && config.llmConfig.maxTokens < 1) {
139
+ errors.push('maxTokens must be at least 1');
140
+ }
141
+ }
142
+ // Check retry config
143
+ if (config.retryConfig) {
144
+ if (config.retryConfig.maxRetries !== undefined && config.retryConfig.maxRetries < 0) {
145
+ errors.push('maxRetries must be non-negative');
146
+ }
147
+ if (config.retryConfig.retryDelay !== undefined && config.retryConfig.retryDelay < 0) {
148
+ errors.push('retryDelay must be non-negative');
149
+ }
150
+ }
151
+ return {
152
+ valid: errors.length === 0,
153
+ errors,
154
+ warnings
155
+ };
156
+ }
157
+ /**
158
+ * Utility to create agent from environment variables
159
+ */
160
+ // export function createAgentFromEnv(codebolt?: CodeboltAPI): UnifiedAgent {
161
+ // const config: UnifiedAgentConfig = {
162
+ // codebolt,
163
+ // maxIterations: parseInt(process.env.AGENT_MAX_ITERATIONS || '10'),
164
+ // maxConversationLength: parseInt(process.env.AGENT_MAX_CONVERSATION_LENGTH || '50'),
165
+ // enableLogging: process.env.AGENT_ENABLE_LOGGING !== 'false',
166
+ // llmConfig: {
167
+ // llmname: process.env.AGENT_LLM_NAME || 'DefaultLLM',
168
+ // model: process.env.AGENT_LLM_MODEL,
169
+ // temperature: parseFloat(process.env.AGENT_LLM_TEMPERATURE || '0.7'),
170
+ // maxTokens: process.env.AGENT_LLM_MAX_TOKENS ? parseInt(process.env.AGENT_LLM_MAX_TOKENS) : undefined,
171
+ // apiKey: process.env.AGENT_LLM_API_KEY,
172
+ // baseUrl: process.env.AGENT_LLM_BASE_URL
173
+ // },
174
+ // retryConfig: {
175
+ // maxRetries: parseInt(process.env.AGENT_MAX_RETRIES || '3'),
176
+ // retryDelay: parseInt(process.env.AGENT_RETRY_DELAY || '1000')
177
+ // }
178
+ // };
179
+ // return createUnifiedAgent(config);
180
+ // }
181
+ /**
182
+ * Utility to benchmark agent performance
183
+ */
184
+ async function benchmarkAgent(agent, testCases) {
185
+ const results = [];
186
+ let totalDuration = 0;
187
+ for (const testCase of testCases) {
188
+ const startTime = Date.now();
189
+ let success = false;
190
+ let output;
191
+ let error;
192
+ try {
193
+ output = await agent.execute({
194
+ userMessage: testCase.input
195
+ });
196
+ success = true;
197
+ }
198
+ catch (err) {
199
+ error = err instanceof Error ? err.message : String(err);
200
+ success = false;
201
+ }
202
+ const duration = Date.now() - startTime;
203
+ totalDuration += duration;
204
+ results.push({
205
+ name: testCase.name,
206
+ success,
207
+ duration,
208
+ output,
209
+ error
210
+ });
211
+ }
212
+ const summary = {
213
+ totalTests: testCases.length,
214
+ passed: results.filter(r => r.success).length,
215
+ failed: results.filter(r => !r.success).length,
216
+ averageDuration: totalDuration / testCases.length
217
+ };
218
+ return { results, summary };
219
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@codebolt/agent",
3
- "version": "1.2.1",
3
+ "version": "2.2.3",
4
4
  "description": "CodeBolt Agent utilities for building and managing AI agents",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -9,6 +9,13 @@
9
9
  "README.md",
10
10
  "LICENSE"
11
11
  ],
12
+ "scripts": {
13
+ "build": "tsc",
14
+ "clean": "rm -rf dist",
15
+ "dev": "tsc --watch",
16
+ "test": "echo \"No tests yet, but build passes\" && exit 0",
17
+ "lint:test": "eslint src/**/*.ts && tsc --noEmit"
18
+ },
12
19
  "keywords": [
13
20
  "ai",
14
21
  "agent",
@@ -28,10 +35,16 @@
28
35
  "directory": "packages/agent"
29
36
  },
30
37
  "dependencies": {
38
+ "@codebolt/types": "workspace:*",
31
39
  "js-yaml": "^4.1.0",
32
- "@codebolt/codeboltjs": "2.2.1"
40
+ "zod": "^3.22.4"
41
+ },
42
+ "peerDependencies": {
43
+ "@codebolt/codeboltjs": "workspace:*"
33
44
  },
34
45
  "devDependencies": {
46
+ "@codebolt/codeboltjs": "workspace:*",
47
+ "@codebolt/types": "workspace:*",
35
48
  "@types/js-yaml": "^4.0.9",
36
49
  "@types/node": "^20.14.2",
37
50
  "@types/uri-templates": "^0.1.34",
@@ -39,16 +52,25 @@
39
52
  "typescript": "^5.4.5"
40
53
  },
41
54
  "exports": {
42
- ".": {
43
- "types": "./dist/index.d.ts",
44
- "default": "./dist/index.js"
55
+ "./builder": {
56
+ "types": "./dist/builderpattern/index.d.ts",
57
+ "default": "./dist/builderpattern/index.js"
58
+ },
59
+ "./composable": {
60
+ "types": "./dist/composablepattern/index.d.ts",
61
+ "default": "./dist/composablepattern/index.js"
62
+ },
63
+ "./processor": {
64
+ "types": "./dist/processor/index.d.ts",
65
+ "default": "./dist/processor/index.js"
66
+ },
67
+ "./processor-pieces": {
68
+ "types": "./dist/processor-pieces/index.d.ts",
69
+ "default": "./dist/processor-pieces/index.js"
70
+ },
71
+ "./unified": {
72
+ "types": "./dist/unified/index.d.ts",
73
+ "default": "./dist/unified/index.js"
45
74
  }
46
- },
47
- "scripts": {
48
- "build": "tsc",
49
- "clean": "rm -rf dist",
50
- "dev": "tsc --watch",
51
- "test": "echo \"No tests yet, but build passes\" && exit 0",
52
- "lint": "tsc --noEmit"
53
75
  }
54
- }
76
+ }
File without changes
File without changes