agentfootprint 1.0.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 (960) hide show
  1. package/AGENTS.md +297 -0
  2. package/CLAUDE.md +297 -0
  3. package/LICENSE +21 -0
  4. package/README.md +339 -0
  5. package/ai-instructions/claude-code/SKILL.md +597 -0
  6. package/ai-instructions/clinerules +85 -0
  7. package/ai-instructions/copilot-instructions.md +109 -0
  8. package/ai-instructions/cursor/agentfootprint.md +101 -0
  9. package/ai-instructions/kiro/agentfootprint.md +101 -0
  10. package/ai-instructions/setup.sh +140 -0
  11. package/ai-instructions/windsurfrules +85 -0
  12. package/dist/adapters/a2a/a2aRunner.js +36 -0
  13. package/dist/adapters/a2a/a2aRunner.js.map +1 -0
  14. package/dist/adapters/anthropic/AnthropicAdapter.js +293 -0
  15. package/dist/adapters/anthropic/AnthropicAdapter.js.map +1 -0
  16. package/dist/adapters/bedrock/BedrockAdapter.js +313 -0
  17. package/dist/adapters/bedrock/BedrockAdapter.js.map +1 -0
  18. package/dist/adapters/browser/BrowserAnthropicAdapter.js +349 -0
  19. package/dist/adapters/browser/BrowserAnthropicAdapter.js.map +1 -0
  20. package/dist/adapters/browser/BrowserOpenAIAdapter.js +303 -0
  21. package/dist/adapters/browser/BrowserOpenAIAdapter.js.map +1 -0
  22. package/dist/adapters/browser/index.js +8 -0
  23. package/dist/adapters/browser/index.js.map +1 -0
  24. package/dist/adapters/createAdapterSubflow.js +46 -0
  25. package/dist/adapters/createAdapterSubflow.js.map +1 -0
  26. package/dist/adapters/createProvider.js +107 -0
  27. package/dist/adapters/createProvider.js.map +1 -0
  28. package/dist/adapters/fallbackProvider.js +94 -0
  29. package/dist/adapters/fallbackProvider.js.map +1 -0
  30. package/dist/adapters/index.js +47 -0
  31. package/dist/adapters/index.js.map +1 -0
  32. package/dist/adapters/mcp/mcpToolProvider.js +44 -0
  33. package/dist/adapters/mcp/mcpToolProvider.js.map +1 -0
  34. package/dist/adapters/memory/inMemory.js +38 -0
  35. package/dist/adapters/memory/inMemory.js.map +1 -0
  36. package/dist/adapters/memory/index.js +6 -0
  37. package/dist/adapters/memory/index.js.map +1 -0
  38. package/dist/adapters/memory/stores.js +137 -0
  39. package/dist/adapters/memory/stores.js.map +1 -0
  40. package/dist/adapters/memory/types.js +14 -0
  41. package/dist/adapters/memory/types.js.map +1 -0
  42. package/dist/adapters/mock/MockAdapter.js +66 -0
  43. package/dist/adapters/mock/MockAdapter.js.map +1 -0
  44. package/dist/adapters/mock/MockRetriever.js +61 -0
  45. package/dist/adapters/mock/MockRetriever.js.map +1 -0
  46. package/dist/adapters/openai/OpenAIAdapter.js +276 -0
  47. package/dist/adapters/openai/OpenAIAdapter.js.map +1 -0
  48. package/dist/adapters/resilientProvider.js +93 -0
  49. package/dist/adapters/resilientProvider.js.map +1 -0
  50. package/dist/compositions/index.js +17 -0
  51. package/dist/compositions/index.js.map +1 -0
  52. package/dist/compositions/withCircuitBreaker.js +84 -0
  53. package/dist/compositions/withCircuitBreaker.js.map +1 -0
  54. package/dist/compositions/withFallback.js +33 -0
  55. package/dist/compositions/withFallback.js.map +1 -0
  56. package/dist/compositions/withRetry.js +59 -0
  57. package/dist/compositions/withRetry.js.map +1 -0
  58. package/dist/concepts/FlowChart.js +205 -0
  59. package/dist/concepts/FlowChart.js.map +1 -0
  60. package/dist/concepts/LLMCall.js +160 -0
  61. package/dist/concepts/LLMCall.js.map +1 -0
  62. package/dist/concepts/Parallel.js +254 -0
  63. package/dist/concepts/Parallel.js.map +1 -0
  64. package/dist/concepts/RAG.js +198 -0
  65. package/dist/concepts/RAG.js.map +1 -0
  66. package/dist/concepts/Swarm.js +270 -0
  67. package/dist/concepts/Swarm.js.map +1 -0
  68. package/dist/concepts/index.js +23 -0
  69. package/dist/concepts/index.js.map +1 -0
  70. package/dist/concepts/specIcons.js +48 -0
  71. package/dist/concepts/specIcons.js.map +1 -0
  72. package/dist/core/config.js +7 -0
  73. package/dist/core/config.js.map +1 -0
  74. package/dist/core/index.js +14 -0
  75. package/dist/core/index.js.map +1 -0
  76. package/dist/core/providers.js +19 -0
  77. package/dist/core/providers.js.map +1 -0
  78. package/dist/core/recorders.js +7 -0
  79. package/dist/core/recorders.js.map +1 -0
  80. package/dist/esm/adapters/a2a/a2aRunner.js +32 -0
  81. package/dist/esm/adapters/a2a/a2aRunner.js.map +1 -0
  82. package/dist/esm/adapters/anthropic/AnthropicAdapter.js +289 -0
  83. package/dist/esm/adapters/anthropic/AnthropicAdapter.js.map +1 -0
  84. package/dist/esm/adapters/bedrock/BedrockAdapter.js +309 -0
  85. package/dist/esm/adapters/bedrock/BedrockAdapter.js.map +1 -0
  86. package/dist/esm/adapters/browser/BrowserAnthropicAdapter.js +345 -0
  87. package/dist/esm/adapters/browser/BrowserAnthropicAdapter.js.map +1 -0
  88. package/dist/esm/adapters/browser/BrowserOpenAIAdapter.js +299 -0
  89. package/dist/esm/adapters/browser/BrowserOpenAIAdapter.js.map +1 -0
  90. package/dist/esm/adapters/browser/index.js +3 -0
  91. package/dist/esm/adapters/browser/index.js.map +1 -0
  92. package/dist/esm/adapters/createAdapterSubflow.js +42 -0
  93. package/dist/esm/adapters/createAdapterSubflow.js.map +1 -0
  94. package/dist/esm/adapters/createProvider.js +101 -0
  95. package/dist/esm/adapters/createProvider.js.map +1 -0
  96. package/dist/esm/adapters/fallbackProvider.js +90 -0
  97. package/dist/esm/adapters/fallbackProvider.js.map +1 -0
  98. package/dist/esm/adapters/index.js +23 -0
  99. package/dist/esm/adapters/index.js.map +1 -0
  100. package/dist/esm/adapters/mcp/mcpToolProvider.js +40 -0
  101. package/dist/esm/adapters/mcp/mcpToolProvider.js.map +1 -0
  102. package/dist/esm/adapters/memory/inMemory.js +34 -0
  103. package/dist/esm/adapters/memory/inMemory.js.map +1 -0
  104. package/dist/esm/adapters/memory/index.js +2 -0
  105. package/dist/esm/adapters/memory/index.js.map +1 -0
  106. package/dist/esm/adapters/memory/stores.js +131 -0
  107. package/dist/esm/adapters/memory/stores.js.map +1 -0
  108. package/dist/esm/adapters/memory/types.js +13 -0
  109. package/dist/esm/adapters/memory/types.js.map +1 -0
  110. package/dist/esm/adapters/mock/MockAdapter.js +61 -0
  111. package/dist/esm/adapters/mock/MockAdapter.js.map +1 -0
  112. package/dist/esm/adapters/mock/MockRetriever.js +56 -0
  113. package/dist/esm/adapters/mock/MockRetriever.js.map +1 -0
  114. package/dist/esm/adapters/openai/OpenAIAdapter.js +272 -0
  115. package/dist/esm/adapters/openai/OpenAIAdapter.js.map +1 -0
  116. package/dist/esm/adapters/resilientProvider.js +89 -0
  117. package/dist/esm/adapters/resilientProvider.js.map +1 -0
  118. package/dist/esm/compositions/index.js +10 -0
  119. package/dist/esm/compositions/index.js.map +1 -0
  120. package/dist/esm/compositions/withCircuitBreaker.js +79 -0
  121. package/dist/esm/compositions/withCircuitBreaker.js.map +1 -0
  122. package/dist/esm/compositions/withFallback.js +29 -0
  123. package/dist/esm/compositions/withFallback.js.map +1 -0
  124. package/dist/esm/compositions/withRetry.js +55 -0
  125. package/dist/esm/compositions/withRetry.js.map +1 -0
  126. package/dist/esm/concepts/FlowChart.js +200 -0
  127. package/dist/esm/concepts/FlowChart.js.map +1 -0
  128. package/dist/esm/concepts/LLMCall.js +155 -0
  129. package/dist/esm/concepts/LLMCall.js.map +1 -0
  130. package/dist/esm/concepts/Parallel.js +249 -0
  131. package/dist/esm/concepts/Parallel.js.map +1 -0
  132. package/dist/esm/concepts/RAG.js +193 -0
  133. package/dist/esm/concepts/RAG.js.map +1 -0
  134. package/dist/esm/concepts/Swarm.js +265 -0
  135. package/dist/esm/concepts/Swarm.js.map +1 -0
  136. package/dist/esm/concepts/index.js +8 -0
  137. package/dist/esm/concepts/index.js.map +1 -0
  138. package/dist/esm/concepts/specIcons.js +44 -0
  139. package/dist/esm/concepts/specIcons.js.map +1 -0
  140. package/dist/esm/core/config.js +6 -0
  141. package/dist/esm/core/config.js.map +1 -0
  142. package/dist/esm/core/index.js +13 -0
  143. package/dist/esm/core/index.js.map +1 -0
  144. package/dist/esm/core/providers.js +18 -0
  145. package/dist/esm/core/providers.js.map +1 -0
  146. package/dist/esm/core/recorders.js +6 -0
  147. package/dist/esm/core/recorders.js.map +1 -0
  148. package/dist/esm/executor/agentLoop.js +150 -0
  149. package/dist/esm/executor/agentLoop.js.map +1 -0
  150. package/dist/esm/executor/index.js +5 -0
  151. package/dist/esm/executor/index.js.map +1 -0
  152. package/dist/esm/explain.barrel.js +19 -0
  153. package/dist/esm/explain.barrel.js.map +1 -0
  154. package/dist/esm/index.js +29 -0
  155. package/dist/esm/index.js.map +1 -0
  156. package/dist/esm/instructions.barrel.js +22 -0
  157. package/dist/esm/instructions.barrel.js.map +1 -0
  158. package/dist/esm/lib/call/callLLMStage.js +64 -0
  159. package/dist/esm/lib/call/callLLMStage.js.map +1 -0
  160. package/dist/esm/lib/call/handleResponseStage.js +49 -0
  161. package/dist/esm/lib/call/handleResponseStage.js.map +1 -0
  162. package/dist/esm/lib/call/helpers.js +164 -0
  163. package/dist/esm/lib/call/helpers.js.map +1 -0
  164. package/dist/esm/lib/call/index.js +7 -0
  165. package/dist/esm/lib/call/index.js.map +1 -0
  166. package/dist/esm/lib/call/parseResponseStage.js +48 -0
  167. package/dist/esm/lib/call/parseResponseStage.js.map +1 -0
  168. package/dist/esm/lib/call/streamingCallLLMStage.js +103 -0
  169. package/dist/esm/lib/call/streamingCallLLMStage.js.map +1 -0
  170. package/dist/esm/lib/call/toolExecutionSubflow.js +87 -0
  171. package/dist/esm/lib/call/toolExecutionSubflow.js.map +1 -0
  172. package/dist/esm/lib/call/types.js +10 -0
  173. package/dist/esm/lib/call/types.js.map +1 -0
  174. package/dist/esm/lib/concepts/Agent.js +7 -0
  175. package/dist/esm/lib/concepts/Agent.js.map +1 -0
  176. package/dist/esm/lib/concepts/AgentBuilder.js +224 -0
  177. package/dist/esm/lib/concepts/AgentBuilder.js.map +1 -0
  178. package/dist/esm/lib/concepts/AgentRunner.js +337 -0
  179. package/dist/esm/lib/concepts/AgentRunner.js.map +1 -0
  180. package/dist/esm/lib/concepts/index.js +2 -0
  181. package/dist/esm/lib/concepts/index.js.map +1 -0
  182. package/dist/esm/lib/instructions/InstructionRecorder.js +121 -0
  183. package/dist/esm/lib/instructions/InstructionRecorder.js.map +1 -0
  184. package/dist/esm/lib/instructions/agentInstruction.js +139 -0
  185. package/dist/esm/lib/instructions/agentInstruction.js.map +1 -0
  186. package/dist/esm/lib/instructions/buildInstructionsToLLMSubflow.js +83 -0
  187. package/dist/esm/lib/instructions/buildInstructionsToLLMSubflow.js.map +1 -0
  188. package/dist/esm/lib/instructions/evaluator.js +196 -0
  189. package/dist/esm/lib/instructions/evaluator.js.map +1 -0
  190. package/dist/esm/lib/instructions/index.js +10 -0
  191. package/dist/esm/lib/instructions/index.js.map +1 -0
  192. package/dist/esm/lib/instructions/inject.js +55 -0
  193. package/dist/esm/lib/instructions/inject.js.map +1 -0
  194. package/dist/esm/lib/instructions/preview.js +88 -0
  195. package/dist/esm/lib/instructions/preview.js.map +1 -0
  196. package/dist/esm/lib/instructions/strictFollowUp.js +125 -0
  197. package/dist/esm/lib/instructions/strictFollowUp.js.map +1 -0
  198. package/dist/esm/lib/instructions/template.js +82 -0
  199. package/dist/esm/lib/instructions/template.js.map +1 -0
  200. package/dist/esm/lib/instructions/types.js +83 -0
  201. package/dist/esm/lib/instructions/types.js.map +1 -0
  202. package/dist/esm/lib/loop/buildAgentLoop.js +401 -0
  203. package/dist/esm/lib/loop/buildAgentLoop.js.map +1 -0
  204. package/dist/esm/lib/loop/index.js +3 -0
  205. package/dist/esm/lib/loop/index.js.map +1 -0
  206. package/dist/esm/lib/loop/types.js +71 -0
  207. package/dist/esm/lib/loop/types.js.map +1 -0
  208. package/dist/esm/lib/narrative/agentRenderer.js +293 -0
  209. package/dist/esm/lib/narrative/agentRenderer.js.map +1 -0
  210. package/dist/esm/lib/narrative/groundingHelpers.js +136 -0
  211. package/dist/esm/lib/narrative/groundingHelpers.js.map +1 -0
  212. package/dist/esm/lib/narrative/index.js +3 -0
  213. package/dist/esm/lib/narrative/index.js.map +1 -0
  214. package/dist/esm/lib/slots/helpers.js +23 -0
  215. package/dist/esm/lib/slots/helpers.js.map +1 -0
  216. package/dist/esm/lib/slots/index.js +4 -0
  217. package/dist/esm/lib/slots/index.js.map +1 -0
  218. package/dist/esm/lib/slots/messages/buildMessagesSubflow.js +108 -0
  219. package/dist/esm/lib/slots/messages/buildMessagesSubflow.js.map +1 -0
  220. package/dist/esm/lib/slots/messages/index.js +2 -0
  221. package/dist/esm/lib/slots/messages/index.js.map +1 -0
  222. package/dist/esm/lib/slots/messages/types.js +10 -0
  223. package/dist/esm/lib/slots/messages/types.js.map +1 -0
  224. package/dist/esm/lib/slots/system-prompt/buildSystemPromptSubflow.js +64 -0
  225. package/dist/esm/lib/slots/system-prompt/buildSystemPromptSubflow.js.map +1 -0
  226. package/dist/esm/lib/slots/system-prompt/index.js +2 -0
  227. package/dist/esm/lib/slots/system-prompt/index.js.map +1 -0
  228. package/dist/esm/lib/slots/system-prompt/types.js +9 -0
  229. package/dist/esm/lib/slots/system-prompt/types.js.map +1 -0
  230. package/dist/esm/lib/slots/tools/buildToolsSubflow.js +67 -0
  231. package/dist/esm/lib/slots/tools/buildToolsSubflow.js.map +1 -0
  232. package/dist/esm/lib/slots/tools/index.js +2 -0
  233. package/dist/esm/lib/slots/tools/index.js.map +1 -0
  234. package/dist/esm/lib/slots/tools/types.js +11 -0
  235. package/dist/esm/lib/slots/tools/types.js.map +1 -0
  236. package/dist/esm/lib/swarm/buildSwarmRouting.js +207 -0
  237. package/dist/esm/lib/swarm/buildSwarmRouting.js.map +1 -0
  238. package/dist/esm/lib/swarm/index.js +2 -0
  239. package/dist/esm/lib/swarm/index.js.map +1 -0
  240. package/dist/esm/memory/conversationHelpers.js +56 -0
  241. package/dist/esm/memory/conversationHelpers.js.map +1 -0
  242. package/dist/esm/memory/index.js +2 -0
  243. package/dist/esm/memory/index.js.map +1 -0
  244. package/dist/esm/models/index.js +3 -0
  245. package/dist/esm/models/index.js.map +1 -0
  246. package/dist/esm/models/pricing.js +23 -0
  247. package/dist/esm/models/pricing.js.map +1 -0
  248. package/dist/esm/models/providers.js +42 -0
  249. package/dist/esm/models/providers.js.map +1 -0
  250. package/dist/esm/models/types.js +6 -0
  251. package/dist/esm/models/types.js.map +1 -0
  252. package/dist/esm/observe.barrel.js +18 -0
  253. package/dist/esm/observe.barrel.js.map +1 -0
  254. package/dist/esm/providers/index.js +12 -0
  255. package/dist/esm/providers/index.js.map +1 -0
  256. package/dist/esm/providers/messages/charBudget.js +39 -0
  257. package/dist/esm/providers/messages/charBudget.js.map +1 -0
  258. package/dist/esm/providers/messages/compositeMessages.js +33 -0
  259. package/dist/esm/providers/messages/compositeMessages.js.map +1 -0
  260. package/dist/esm/providers/messages/fullHistory.js +15 -0
  261. package/dist/esm/providers/messages/fullHistory.js.map +1 -0
  262. package/dist/esm/providers/messages/index.js +11 -0
  263. package/dist/esm/providers/messages/index.js.map +1 -0
  264. package/dist/esm/providers/messages/persistentHistory.js +40 -0
  265. package/dist/esm/providers/messages/persistentHistory.js.map +1 -0
  266. package/dist/esm/providers/messages/slidingWindow.js +24 -0
  267. package/dist/esm/providers/messages/slidingWindow.js.map +1 -0
  268. package/dist/esm/providers/messages/summaryStrategy.js +41 -0
  269. package/dist/esm/providers/messages/summaryStrategy.js.map +1 -0
  270. package/dist/esm/providers/messages/withToolPairSafety.js +76 -0
  271. package/dist/esm/providers/messages/withToolPairSafety.js.map +1 -0
  272. package/dist/esm/providers/prompt/compositePrompt.js +28 -0
  273. package/dist/esm/providers/prompt/compositePrompt.js.map +1 -0
  274. package/dist/esm/providers/prompt/index.js +8 -0
  275. package/dist/esm/providers/prompt/index.js.map +1 -0
  276. package/dist/esm/providers/prompt/skillBasedPrompt.js +37 -0
  277. package/dist/esm/providers/prompt/skillBasedPrompt.js.map +1 -0
  278. package/dist/esm/providers/prompt/static.js +9 -0
  279. package/dist/esm/providers/prompt/static.js.map +1 -0
  280. package/dist/esm/providers/prompt/template.js +20 -0
  281. package/dist/esm/providers/prompt/template.js.map +1 -0
  282. package/dist/esm/providers/tools/PermissionPolicy.js +100 -0
  283. package/dist/esm/providers/tools/PermissionPolicy.js.map +1 -0
  284. package/dist/esm/providers/tools/agentAsTool.js +47 -0
  285. package/dist/esm/providers/tools/agentAsTool.js.map +1 -0
  286. package/dist/esm/providers/tools/compositeTools.js +49 -0
  287. package/dist/esm/providers/tools/compositeTools.js.map +1 -0
  288. package/dist/esm/providers/tools/dynamicTools.js +41 -0
  289. package/dist/esm/providers/tools/dynamicTools.js.map +1 -0
  290. package/dist/esm/providers/tools/gatedTools.js +90 -0
  291. package/dist/esm/providers/tools/gatedTools.js.map +1 -0
  292. package/dist/esm/providers/tools/index.js +11 -0
  293. package/dist/esm/providers/tools/index.js.map +1 -0
  294. package/dist/esm/providers/tools/noTools.js +9 -0
  295. package/dist/esm/providers/tools/noTools.js.map +1 -0
  296. package/dist/esm/providers/tools/staticTools.js +25 -0
  297. package/dist/esm/providers/tools/staticTools.js.map +1 -0
  298. package/dist/esm/providers.barrel.js +32 -0
  299. package/dist/esm/providers.barrel.js.map +1 -0
  300. package/dist/esm/recorders/index.js +5 -0
  301. package/dist/esm/recorders/index.js.map +1 -0
  302. package/dist/esm/recorders/v2/CompositeRecorder.js +65 -0
  303. package/dist/esm/recorders/v2/CompositeRecorder.js.map +1 -0
  304. package/dist/esm/recorders/v2/CostRecorder.js +47 -0
  305. package/dist/esm/recorders/v2/CostRecorder.js.map +1 -0
  306. package/dist/esm/recorders/v2/ExplainRecorder.js +93 -0
  307. package/dist/esm/recorders/v2/ExplainRecorder.js.map +1 -0
  308. package/dist/esm/recorders/v2/GuardrailRecorder.js +58 -0
  309. package/dist/esm/recorders/v2/GuardrailRecorder.js.map +1 -0
  310. package/dist/esm/recorders/v2/OTelRecorder.js +79 -0
  311. package/dist/esm/recorders/v2/OTelRecorder.js.map +1 -0
  312. package/dist/esm/recorders/v2/PermissionRecorder.js +86 -0
  313. package/dist/esm/recorders/v2/PermissionRecorder.js.map +1 -0
  314. package/dist/esm/recorders/v2/QualityRecorder.js +48 -0
  315. package/dist/esm/recorders/v2/QualityRecorder.js.map +1 -0
  316. package/dist/esm/recorders/v2/RecorderBridge.js +85 -0
  317. package/dist/esm/recorders/v2/RecorderBridge.js.map +1 -0
  318. package/dist/esm/recorders/v2/TokenRecorder.js +72 -0
  319. package/dist/esm/recorders/v2/TokenRecorder.js.map +1 -0
  320. package/dist/esm/recorders/v2/ToolUsageRecorder.js +54 -0
  321. package/dist/esm/recorders/v2/ToolUsageRecorder.js.map +1 -0
  322. package/dist/esm/recorders/v2/TurnRecorder.js +83 -0
  323. package/dist/esm/recorders/v2/TurnRecorder.js.map +1 -0
  324. package/dist/esm/recorders/v2/agentObservability.js +62 -0
  325. package/dist/esm/recorders/v2/agentObservability.js.map +1 -0
  326. package/dist/esm/recorders/v2/index.js +13 -0
  327. package/dist/esm/recorders/v2/index.js.map +1 -0
  328. package/dist/esm/resilience.barrel.js +16 -0
  329. package/dist/esm/resilience.barrel.js.map +1 -0
  330. package/dist/esm/scope/AgentScope.js +153 -0
  331. package/dist/esm/scope/AgentScope.js.map +1 -0
  332. package/dist/esm/scope/index.js +2 -0
  333. package/dist/esm/scope/index.js.map +1 -0
  334. package/dist/esm/scope/types.js +37 -0
  335. package/dist/esm/scope/types.js.map +1 -0
  336. package/dist/esm/security.barrel.js +17 -0
  337. package/dist/esm/security.barrel.js.map +1 -0
  338. package/dist/esm/stages/augmentPrompt.js +28 -0
  339. package/dist/esm/stages/augmentPrompt.js.map +1 -0
  340. package/dist/esm/stages/callLLM.js +15 -0
  341. package/dist/esm/stages/callLLM.js.map +1 -0
  342. package/dist/esm/stages/commitMemory.js +94 -0
  343. package/dist/esm/stages/commitMemory.js.map +1 -0
  344. package/dist/esm/stages/finalize.js +12 -0
  345. package/dist/esm/stages/finalize.js.map +1 -0
  346. package/dist/esm/stages/helpers.js +58 -0
  347. package/dist/esm/stages/helpers.js.map +1 -0
  348. package/dist/esm/stages/index.js +9 -0
  349. package/dist/esm/stages/index.js.map +1 -0
  350. package/dist/esm/stages/parseResponse.js +25 -0
  351. package/dist/esm/stages/parseResponse.js.map +1 -0
  352. package/dist/esm/stages/retrieve.js +18 -0
  353. package/dist/esm/stages/retrieve.js.map +1 -0
  354. package/dist/esm/stages/runnerAsStage.js +66 -0
  355. package/dist/esm/stages/runnerAsStage.js.map +1 -0
  356. package/dist/esm/stream.barrel.js +18 -0
  357. package/dist/esm/stream.barrel.js.map +1 -0
  358. package/dist/esm/streaming/StreamEmitter.js +43 -0
  359. package/dist/esm/streaming/StreamEmitter.js.map +1 -0
  360. package/dist/esm/streaming/index.js +2 -0
  361. package/dist/esm/streaming/index.js.map +1 -0
  362. package/dist/esm/subflows/index.js +2 -0
  363. package/dist/esm/subflows/index.js.map +1 -0
  364. package/dist/esm/subflows/prepareMemory.js +83 -0
  365. package/dist/esm/subflows/prepareMemory.js.map +1 -0
  366. package/dist/esm/tools/ToolRegistry.js +84 -0
  367. package/dist/esm/tools/ToolRegistry.js.map +1 -0
  368. package/dist/esm/tools/askHuman.js +63 -0
  369. package/dist/esm/tools/askHuman.js.map +1 -0
  370. package/dist/esm/tools/index.js +3 -0
  371. package/dist/esm/tools/index.js.map +1 -0
  372. package/dist/esm/tools/validateInput.js +56 -0
  373. package/dist/esm/tools/validateInput.js.map +1 -0
  374. package/dist/esm/tools/zodToJsonSchema.js +65 -0
  375. package/dist/esm/tools/zodToJsonSchema.js.map +1 -0
  376. package/dist/esm/types/adapter.js +11 -0
  377. package/dist/esm/types/adapter.js.map +1 -0
  378. package/dist/esm/types/agent.js +5 -0
  379. package/dist/esm/types/agent.js.map +1 -0
  380. package/dist/esm/types/content.js +82 -0
  381. package/dist/esm/types/content.js.map +1 -0
  382. package/dist/esm/types/errors.js +74 -0
  383. package/dist/esm/types/errors.js.map +1 -0
  384. package/dist/esm/types/index.js +5 -0
  385. package/dist/esm/types/index.js.map +1 -0
  386. package/dist/esm/types/llm.js +6 -0
  387. package/dist/esm/types/llm.js.map +1 -0
  388. package/dist/esm/types/messages.js +24 -0
  389. package/dist/esm/types/messages.js.map +1 -0
  390. package/dist/esm/types/multiAgent.js +5 -0
  391. package/dist/esm/types/multiAgent.js.map +1 -0
  392. package/dist/esm/types/retriever.js +6 -0
  393. package/dist/esm/types/retriever.js.map +1 -0
  394. package/dist/esm/types/tools.js +5 -0
  395. package/dist/esm/types/tools.js.map +1 -0
  396. package/dist/executor/agentLoop.js +154 -0
  397. package/dist/executor/agentLoop.js.map +1 -0
  398. package/dist/executor/index.js +9 -0
  399. package/dist/executor/index.js.map +1 -0
  400. package/dist/explain.barrel.js +27 -0
  401. package/dist/explain.barrel.js.map +1 -0
  402. package/dist/index.js +74 -0
  403. package/dist/index.js.map +1 -0
  404. package/dist/instructions.barrel.js +30 -0
  405. package/dist/instructions.barrel.js.map +1 -0
  406. package/dist/lib/call/callLLMStage.js +68 -0
  407. package/dist/lib/call/callLLMStage.js.map +1 -0
  408. package/dist/lib/call/handleResponseStage.js +53 -0
  409. package/dist/lib/call/handleResponseStage.js.map +1 -0
  410. package/dist/lib/call/helpers.js +169 -0
  411. package/dist/lib/call/helpers.js.map +1 -0
  412. package/dist/lib/call/index.js +17 -0
  413. package/dist/lib/call/index.js.map +1 -0
  414. package/dist/lib/call/parseResponseStage.js +52 -0
  415. package/dist/lib/call/parseResponseStage.js.map +1 -0
  416. package/dist/lib/call/streamingCallLLMStage.js +107 -0
  417. package/dist/lib/call/streamingCallLLMStage.js.map +1 -0
  418. package/dist/lib/call/toolExecutionSubflow.js +91 -0
  419. package/dist/lib/call/toolExecutionSubflow.js.map +1 -0
  420. package/dist/lib/call/types.js +11 -0
  421. package/dist/lib/call/types.js.map +1 -0
  422. package/dist/lib/concepts/Agent.js +12 -0
  423. package/dist/lib/concepts/Agent.js.map +1 -0
  424. package/dist/lib/concepts/AgentBuilder.js +228 -0
  425. package/dist/lib/concepts/AgentBuilder.js.map +1 -0
  426. package/dist/lib/concepts/AgentRunner.js +341 -0
  427. package/dist/lib/concepts/AgentRunner.js.map +1 -0
  428. package/dist/lib/concepts/index.js +7 -0
  429. package/dist/lib/concepts/index.js.map +1 -0
  430. package/dist/lib/instructions/InstructionRecorder.js +125 -0
  431. package/dist/lib/instructions/InstructionRecorder.js.map +1 -0
  432. package/dist/lib/instructions/agentInstruction.js +144 -0
  433. package/dist/lib/instructions/agentInstruction.js.map +1 -0
  434. package/dist/lib/instructions/buildInstructionsToLLMSubflow.js +87 -0
  435. package/dist/lib/instructions/buildInstructionsToLLMSubflow.js.map +1 -0
  436. package/dist/lib/instructions/evaluator.js +202 -0
  437. package/dist/lib/instructions/evaluator.js.map +1 -0
  438. package/dist/lib/instructions/index.js +27 -0
  439. package/dist/lib/instructions/index.js.map +1 -0
  440. package/dist/lib/instructions/inject.js +59 -0
  441. package/dist/lib/instructions/inject.js.map +1 -0
  442. package/dist/lib/instructions/preview.js +92 -0
  443. package/dist/lib/instructions/preview.js.map +1 -0
  444. package/dist/lib/instructions/strictFollowUp.js +130 -0
  445. package/dist/lib/instructions/strictFollowUp.js.map +1 -0
  446. package/dist/lib/instructions/template.js +86 -0
  447. package/dist/lib/instructions/template.js.map +1 -0
  448. package/dist/lib/instructions/types.js +88 -0
  449. package/dist/lib/instructions/types.js.map +1 -0
  450. package/dist/lib/loop/buildAgentLoop.js +405 -0
  451. package/dist/lib/loop/buildAgentLoop.js.map +1 -0
  452. package/dist/lib/loop/index.js +9 -0
  453. package/dist/lib/loop/index.js.map +1 -0
  454. package/dist/lib/loop/types.js +74 -0
  455. package/dist/lib/loop/types.js.map +1 -0
  456. package/dist/lib/narrative/agentRenderer.js +297 -0
  457. package/dist/lib/narrative/agentRenderer.js.map +1 -0
  458. package/dist/lib/narrative/groundingHelpers.js +142 -0
  459. package/dist/lib/narrative/groundingHelpers.js.map +1 -0
  460. package/dist/lib/narrative/index.js +10 -0
  461. package/dist/lib/narrative/index.js.map +1 -0
  462. package/dist/lib/slots/helpers.js +28 -0
  463. package/dist/lib/slots/helpers.js.map +1 -0
  464. package/dist/lib/slots/index.js +10 -0
  465. package/dist/lib/slots/index.js.map +1 -0
  466. package/dist/lib/slots/messages/buildMessagesSubflow.js +112 -0
  467. package/dist/lib/slots/messages/buildMessagesSubflow.js.map +1 -0
  468. package/dist/lib/slots/messages/index.js +6 -0
  469. package/dist/lib/slots/messages/index.js.map +1 -0
  470. package/dist/lib/slots/messages/types.js +11 -0
  471. package/dist/lib/slots/messages/types.js.map +1 -0
  472. package/dist/lib/slots/system-prompt/buildSystemPromptSubflow.js +68 -0
  473. package/dist/lib/slots/system-prompt/buildSystemPromptSubflow.js.map +1 -0
  474. package/dist/lib/slots/system-prompt/index.js +6 -0
  475. package/dist/lib/slots/system-prompt/index.js.map +1 -0
  476. package/dist/lib/slots/system-prompt/types.js +10 -0
  477. package/dist/lib/slots/system-prompt/types.js.map +1 -0
  478. package/dist/lib/slots/tools/buildToolsSubflow.js +71 -0
  479. package/dist/lib/slots/tools/buildToolsSubflow.js.map +1 -0
  480. package/dist/lib/slots/tools/index.js +6 -0
  481. package/dist/lib/slots/tools/index.js.map +1 -0
  482. package/dist/lib/slots/tools/types.js +12 -0
  483. package/dist/lib/slots/tools/types.js.map +1 -0
  484. package/dist/lib/swarm/buildSwarmRouting.js +211 -0
  485. package/dist/lib/swarm/buildSwarmRouting.js.map +1 -0
  486. package/dist/lib/swarm/index.js +6 -0
  487. package/dist/lib/swarm/index.js.map +1 -0
  488. package/dist/memory/conversationHelpers.js +66 -0
  489. package/dist/memory/conversationHelpers.js.map +1 -0
  490. package/dist/memory/index.js +12 -0
  491. package/dist/memory/index.js.map +1 -0
  492. package/dist/models/index.js +12 -0
  493. package/dist/models/index.js.map +1 -0
  494. package/dist/models/pricing.js +27 -0
  495. package/dist/models/pricing.js.map +1 -0
  496. package/dist/models/providers.js +49 -0
  497. package/dist/models/providers.js.map +1 -0
  498. package/dist/models/types.js +7 -0
  499. package/dist/models/types.js.map +1 -0
  500. package/dist/observe.barrel.js +31 -0
  501. package/dist/observe.barrel.js.map +1 -0
  502. package/dist/providers/index.js +34 -0
  503. package/dist/providers/index.js.map +1 -0
  504. package/dist/providers/messages/charBudget.js +43 -0
  505. package/dist/providers/messages/charBudget.js.map +1 -0
  506. package/dist/providers/messages/compositeMessages.js +37 -0
  507. package/dist/providers/messages/compositeMessages.js.map +1 -0
  508. package/dist/providers/messages/fullHistory.js +19 -0
  509. package/dist/providers/messages/fullHistory.js.map +1 -0
  510. package/dist/providers/messages/index.js +22 -0
  511. package/dist/providers/messages/index.js.map +1 -0
  512. package/dist/providers/messages/persistentHistory.js +45 -0
  513. package/dist/providers/messages/persistentHistory.js.map +1 -0
  514. package/dist/providers/messages/slidingWindow.js +28 -0
  515. package/dist/providers/messages/slidingWindow.js.map +1 -0
  516. package/dist/providers/messages/summaryStrategy.js +45 -0
  517. package/dist/providers/messages/summaryStrategy.js.map +1 -0
  518. package/dist/providers/messages/withToolPairSafety.js +80 -0
  519. package/dist/providers/messages/withToolPairSafety.js.map +1 -0
  520. package/dist/providers/prompt/compositePrompt.js +32 -0
  521. package/dist/providers/prompt/compositePrompt.js.map +1 -0
  522. package/dist/providers/prompt/index.js +15 -0
  523. package/dist/providers/prompt/index.js.map +1 -0
  524. package/dist/providers/prompt/skillBasedPrompt.js +41 -0
  525. package/dist/providers/prompt/skillBasedPrompt.js.map +1 -0
  526. package/dist/providers/prompt/static.js +13 -0
  527. package/dist/providers/prompt/static.js.map +1 -0
  528. package/dist/providers/prompt/template.js +24 -0
  529. package/dist/providers/prompt/template.js.map +1 -0
  530. package/dist/providers/tools/PermissionPolicy.js +104 -0
  531. package/dist/providers/tools/PermissionPolicy.js.map +1 -0
  532. package/dist/providers/tools/agentAsTool.js +51 -0
  533. package/dist/providers/tools/agentAsTool.js.map +1 -0
  534. package/dist/providers/tools/compositeTools.js +53 -0
  535. package/dist/providers/tools/compositeTools.js.map +1 -0
  536. package/dist/providers/tools/dynamicTools.js +45 -0
  537. package/dist/providers/tools/dynamicTools.js.map +1 -0
  538. package/dist/providers/tools/gatedTools.js +94 -0
  539. package/dist/providers/tools/gatedTools.js.map +1 -0
  540. package/dist/providers/tools/index.js +21 -0
  541. package/dist/providers/tools/index.js.map +1 -0
  542. package/dist/providers/tools/noTools.js +13 -0
  543. package/dist/providers/tools/noTools.js.map +1 -0
  544. package/dist/providers/tools/staticTools.js +29 -0
  545. package/dist/providers/tools/staticTools.js.map +1 -0
  546. package/dist/providers.barrel.js +61 -0
  547. package/dist/providers.barrel.js.map +1 -0
  548. package/dist/recorders/index.js +17 -0
  549. package/dist/recorders/index.js.map +1 -0
  550. package/dist/recorders/v2/CompositeRecorder.js +69 -0
  551. package/dist/recorders/v2/CompositeRecorder.js.map +1 -0
  552. package/dist/recorders/v2/CostRecorder.js +51 -0
  553. package/dist/recorders/v2/CostRecorder.js.map +1 -0
  554. package/dist/recorders/v2/ExplainRecorder.js +97 -0
  555. package/dist/recorders/v2/ExplainRecorder.js.map +1 -0
  556. package/dist/recorders/v2/GuardrailRecorder.js +62 -0
  557. package/dist/recorders/v2/GuardrailRecorder.js.map +1 -0
  558. package/dist/recorders/v2/OTelRecorder.js +83 -0
  559. package/dist/recorders/v2/OTelRecorder.js.map +1 -0
  560. package/dist/recorders/v2/PermissionRecorder.js +90 -0
  561. package/dist/recorders/v2/PermissionRecorder.js.map +1 -0
  562. package/dist/recorders/v2/QualityRecorder.js +52 -0
  563. package/dist/recorders/v2/QualityRecorder.js.map +1 -0
  564. package/dist/recorders/v2/RecorderBridge.js +89 -0
  565. package/dist/recorders/v2/RecorderBridge.js.map +1 -0
  566. package/dist/recorders/v2/TokenRecorder.js +76 -0
  567. package/dist/recorders/v2/TokenRecorder.js.map +1 -0
  568. package/dist/recorders/v2/ToolUsageRecorder.js +58 -0
  569. package/dist/recorders/v2/ToolUsageRecorder.js.map +1 -0
  570. package/dist/recorders/v2/TurnRecorder.js +87 -0
  571. package/dist/recorders/v2/TurnRecorder.js.map +1 -0
  572. package/dist/recorders/v2/agentObservability.js +66 -0
  573. package/dist/recorders/v2/agentObservability.js.map +1 -0
  574. package/dist/recorders/v2/index.js +25 -0
  575. package/dist/recorders/v2/index.js.map +1 -0
  576. package/dist/resilience.barrel.js +25 -0
  577. package/dist/resilience.barrel.js.map +1 -0
  578. package/dist/scope/AgentScope.js +156 -0
  579. package/dist/scope/AgentScope.js.map +1 -0
  580. package/dist/scope/index.js +10 -0
  581. package/dist/scope/index.js.map +1 -0
  582. package/dist/scope/types.js +40 -0
  583. package/dist/scope/types.js.map +1 -0
  584. package/dist/security.barrel.js +22 -0
  585. package/dist/security.barrel.js.map +1 -0
  586. package/dist/stages/augmentPrompt.js +32 -0
  587. package/dist/stages/augmentPrompt.js.map +1 -0
  588. package/dist/stages/callLLM.js +19 -0
  589. package/dist/stages/callLLM.js.map +1 -0
  590. package/dist/stages/commitMemory.js +98 -0
  591. package/dist/stages/commitMemory.js.map +1 -0
  592. package/dist/stages/finalize.js +16 -0
  593. package/dist/stages/finalize.js.map +1 -0
  594. package/dist/stages/helpers.js +63 -0
  595. package/dist/stages/helpers.js.map +1 -0
  596. package/dist/stages/index.js +21 -0
  597. package/dist/stages/index.js.map +1 -0
  598. package/dist/stages/parseResponse.js +29 -0
  599. package/dist/stages/parseResponse.js.map +1 -0
  600. package/dist/stages/retrieve.js +22 -0
  601. package/dist/stages/retrieve.js.map +1 -0
  602. package/dist/stages/runnerAsStage.js +70 -0
  603. package/dist/stages/runnerAsStage.js.map +1 -0
  604. package/dist/stream.barrel.js +23 -0
  605. package/dist/stream.barrel.js.map +1 -0
  606. package/dist/streaming/StreamEmitter.js +48 -0
  607. package/dist/streaming/StreamEmitter.js.map +1 -0
  608. package/dist/streaming/index.js +7 -0
  609. package/dist/streaming/index.js.map +1 -0
  610. package/dist/subflows/index.js +6 -0
  611. package/dist/subflows/index.js.map +1 -0
  612. package/dist/subflows/prepareMemory.js +87 -0
  613. package/dist/subflows/prepareMemory.js.map +1 -0
  614. package/dist/tools/ToolRegistry.js +89 -0
  615. package/dist/tools/ToolRegistry.js.map +1 -0
  616. package/dist/tools/askHuman.js +68 -0
  617. package/dist/tools/askHuman.js.map +1 -0
  618. package/dist/tools/index.js +9 -0
  619. package/dist/tools/index.js.map +1 -0
  620. package/dist/tools/validateInput.js +61 -0
  621. package/dist/tools/validateInput.js.map +1 -0
  622. package/dist/tools/zodToJsonSchema.js +70 -0
  623. package/dist/tools/zodToJsonSchema.js.map +1 -0
  624. package/dist/types/adapter.js +14 -0
  625. package/dist/types/adapter.js.map +1 -0
  626. package/dist/types/adapters/a2a/a2aRunner.d.ts +40 -0
  627. package/dist/types/adapters/a2a/a2aRunner.d.ts.map +1 -0
  628. package/dist/types/adapters/anthropic/AnthropicAdapter.d.ts +37 -0
  629. package/dist/types/adapters/anthropic/AnthropicAdapter.d.ts.map +1 -0
  630. package/dist/types/adapters/bedrock/BedrockAdapter.d.ts +44 -0
  631. package/dist/types/adapters/bedrock/BedrockAdapter.d.ts.map +1 -0
  632. package/dist/types/adapters/browser/BrowserAnthropicAdapter.d.ts +40 -0
  633. package/dist/types/adapters/browser/BrowserAnthropicAdapter.d.ts.map +1 -0
  634. package/dist/types/adapters/browser/BrowserOpenAIAdapter.d.ts +46 -0
  635. package/dist/types/adapters/browser/BrowserOpenAIAdapter.d.ts.map +1 -0
  636. package/dist/types/adapters/browser/index.d.ts +5 -0
  637. package/dist/types/adapters/browser/index.d.ts.map +1 -0
  638. package/dist/types/adapters/createAdapterSubflow.d.ts +36 -0
  639. package/dist/types/adapters/createAdapterSubflow.d.ts.map +1 -0
  640. package/dist/types/adapters/createProvider.d.ts +47 -0
  641. package/dist/types/adapters/createProvider.d.ts.map +1 -0
  642. package/dist/types/adapters/fallbackProvider.d.ts +45 -0
  643. package/dist/types/adapters/fallbackProvider.d.ts.map +1 -0
  644. package/dist/types/adapters/index.d.ts +30 -0
  645. package/dist/types/adapters/index.d.ts.map +1 -0
  646. package/dist/types/adapters/mcp/mcpToolProvider.d.ts +41 -0
  647. package/dist/types/adapters/mcp/mcpToolProvider.d.ts.map +1 -0
  648. package/dist/types/adapters/memory/inMemory.d.ts +22 -0
  649. package/dist/types/adapters/memory/inMemory.d.ts.map +1 -0
  650. package/dist/types/adapters/memory/index.d.ts +3 -0
  651. package/dist/types/adapters/memory/index.d.ts.map +1 -0
  652. package/dist/types/adapters/memory/stores.d.ts +92 -0
  653. package/dist/types/adapters/memory/stores.d.ts.map +1 -0
  654. package/dist/types/adapters/memory/types.d.ts +74 -0
  655. package/dist/types/adapters/memory/types.d.ts.map +1 -0
  656. package/dist/types/adapters/mock/MockAdapter.d.ts +51 -0
  657. package/dist/types/adapters/mock/MockAdapter.d.ts.map +1 -0
  658. package/dist/types/adapters/mock/MockRetriever.d.ts +43 -0
  659. package/dist/types/adapters/mock/MockRetriever.d.ts.map +1 -0
  660. package/dist/types/adapters/openai/OpenAIAdapter.d.ts +47 -0
  661. package/dist/types/adapters/openai/OpenAIAdapter.d.ts.map +1 -0
  662. package/dist/types/adapters/resilientProvider.d.ts +33 -0
  663. package/dist/types/adapters/resilientProvider.d.ts.map +1 -0
  664. package/dist/types/agent.js +6 -0
  665. package/dist/types/agent.js.map +1 -0
  666. package/dist/types/compositions/index.d.ts +13 -0
  667. package/dist/types/compositions/index.d.ts.map +1 -0
  668. package/dist/types/compositions/withCircuitBreaker.d.ts +43 -0
  669. package/dist/types/compositions/withCircuitBreaker.d.ts.map +1 -0
  670. package/dist/types/compositions/withFallback.d.ts +17 -0
  671. package/dist/types/compositions/withFallback.d.ts.map +1 -0
  672. package/dist/types/compositions/withRetry.d.ts +27 -0
  673. package/dist/types/compositions/withRetry.d.ts.map +1 -0
  674. package/dist/types/concepts/FlowChart.d.ts +52 -0
  675. package/dist/types/concepts/FlowChart.d.ts.map +1 -0
  676. package/dist/types/concepts/LLMCall.d.ts +56 -0
  677. package/dist/types/concepts/LLMCall.d.ts.map +1 -0
  678. package/dist/types/concepts/Parallel.d.ts +110 -0
  679. package/dist/types/concepts/Parallel.d.ts.map +1 -0
  680. package/dist/types/concepts/RAG.d.ts +71 -0
  681. package/dist/types/concepts/RAG.d.ts.map +1 -0
  682. package/dist/types/concepts/Swarm.d.ts +98 -0
  683. package/dist/types/concepts/Swarm.d.ts.map +1 -0
  684. package/dist/types/concepts/index.d.ts +12 -0
  685. package/dist/types/concepts/index.d.ts.map +1 -0
  686. package/dist/types/concepts/specIcons.d.ts +14 -0
  687. package/dist/types/concepts/specIcons.d.ts.map +1 -0
  688. package/dist/types/content.js +97 -0
  689. package/dist/types/content.js.map +1 -0
  690. package/dist/types/core/config.d.ts +24 -0
  691. package/dist/types/core/config.d.ts.map +1 -0
  692. package/dist/types/core/index.d.ts +15 -0
  693. package/dist/types/core/index.d.ts.map +1 -0
  694. package/dist/types/core/providers.d.ts +160 -0
  695. package/dist/types/core/providers.d.ts.map +1 -0
  696. package/dist/types/core/recorders.d.ts +54 -0
  697. package/dist/types/core/recorders.d.ts.map +1 -0
  698. package/dist/types/errors.js +80 -0
  699. package/dist/types/errors.js.map +1 -0
  700. package/dist/types/executor/agentLoop.d.ts +37 -0
  701. package/dist/types/executor/agentLoop.d.ts.map +1 -0
  702. package/dist/types/executor/index.d.ts +6 -0
  703. package/dist/types/executor/index.d.ts.map +1 -0
  704. package/dist/types/explain.barrel.d.ts +20 -0
  705. package/dist/types/explain.barrel.d.ts.map +1 -0
  706. package/dist/types/index.d.ts +31 -0
  707. package/dist/types/index.d.ts.map +1 -0
  708. package/dist/types/index.js +29 -0
  709. package/dist/types/index.js.map +1 -0
  710. package/dist/types/instructions.barrel.d.ts +24 -0
  711. package/dist/types/instructions.barrel.d.ts.map +1 -0
  712. package/dist/types/lib/call/callLLMStage.d.ts +29 -0
  713. package/dist/types/lib/call/callLLMStage.d.ts.map +1 -0
  714. package/dist/types/lib/call/handleResponseStage.d.ts +35 -0
  715. package/dist/types/lib/call/handleResponseStage.d.ts.map +1 -0
  716. package/dist/types/lib/call/helpers.d.ts +64 -0
  717. package/dist/types/lib/call/helpers.d.ts.map +1 -0
  718. package/dist/types/lib/call/index.d.ts +10 -0
  719. package/dist/types/lib/call/index.d.ts.map +1 -0
  720. package/dist/types/lib/call/parseResponseStage.d.ts +21 -0
  721. package/dist/types/lib/call/parseResponseStage.d.ts.map +1 -0
  722. package/dist/types/lib/call/streamingCallLLMStage.d.ts +23 -0
  723. package/dist/types/lib/call/streamingCallLLMStage.d.ts.map +1 -0
  724. package/dist/types/lib/call/toolExecutionSubflow.d.ts +70 -0
  725. package/dist/types/lib/call/toolExecutionSubflow.d.ts.map +1 -0
  726. package/dist/types/lib/call/types.d.ts +17 -0
  727. package/dist/types/lib/call/types.d.ts.map +1 -0
  728. package/dist/types/lib/concepts/Agent.d.ts +9 -0
  729. package/dist/types/lib/concepts/Agent.d.ts.map +1 -0
  730. package/dist/types/lib/concepts/AgentBuilder.d.ts +152 -0
  731. package/dist/types/lib/concepts/AgentBuilder.d.ts.map +1 -0
  732. package/dist/types/lib/concepts/AgentRunner.d.ts +100 -0
  733. package/dist/types/lib/concepts/AgentRunner.d.ts.map +1 -0
  734. package/dist/types/lib/concepts/index.d.ts +3 -0
  735. package/dist/types/lib/concepts/index.d.ts.map +1 -0
  736. package/dist/types/lib/instructions/InstructionRecorder.d.ts +85 -0
  737. package/dist/types/lib/instructions/InstructionRecorder.d.ts.map +1 -0
  738. package/dist/types/lib/instructions/agentInstruction.d.ts +150 -0
  739. package/dist/types/lib/instructions/agentInstruction.d.ts.map +1 -0
  740. package/dist/types/lib/instructions/buildInstructionsToLLMSubflow.d.ts +56 -0
  741. package/dist/types/lib/instructions/buildInstructionsToLLMSubflow.d.ts.map +1 -0
  742. package/dist/types/lib/instructions/evaluator.d.ts +99 -0
  743. package/dist/types/lib/instructions/evaluator.d.ts.map +1 -0
  744. package/dist/types/lib/instructions/index.d.ts +18 -0
  745. package/dist/types/lib/instructions/index.d.ts.map +1 -0
  746. package/dist/types/lib/instructions/inject.d.ts +54 -0
  747. package/dist/types/lib/instructions/inject.d.ts.map +1 -0
  748. package/dist/types/lib/instructions/preview.d.ts +85 -0
  749. package/dist/types/lib/instructions/preview.d.ts.map +1 -0
  750. package/dist/types/lib/instructions/strictFollowUp.d.ts +88 -0
  751. package/dist/types/lib/instructions/strictFollowUp.d.ts.map +1 -0
  752. package/dist/types/lib/instructions/template.d.ts +52 -0
  753. package/dist/types/lib/instructions/template.d.ts.map +1 -0
  754. package/dist/types/lib/instructions/types.d.ts +394 -0
  755. package/dist/types/lib/instructions/types.d.ts.map +1 -0
  756. package/dist/types/lib/loop/buildAgentLoop.d.ts +67 -0
  757. package/dist/types/lib/loop/buildAgentLoop.d.ts.map +1 -0
  758. package/dist/types/lib/loop/index.d.ts +5 -0
  759. package/dist/types/lib/loop/index.d.ts.map +1 -0
  760. package/dist/types/lib/loop/types.d.ts +248 -0
  761. package/dist/types/lib/loop/types.d.ts.map +1 -0
  762. package/dist/types/lib/narrative/agentRenderer.d.ts +51 -0
  763. package/dist/types/lib/narrative/agentRenderer.d.ts.map +1 -0
  764. package/dist/types/lib/narrative/groundingHelpers.d.ts +94 -0
  765. package/dist/types/lib/narrative/groundingHelpers.d.ts.map +1 -0
  766. package/dist/types/lib/narrative/index.d.ts +5 -0
  767. package/dist/types/lib/narrative/index.d.ts.map +1 -0
  768. package/dist/types/lib/slots/helpers.d.ts +16 -0
  769. package/dist/types/lib/slots/helpers.d.ts.map +1 -0
  770. package/dist/types/lib/slots/index.d.ts +7 -0
  771. package/dist/types/lib/slots/index.d.ts.map +1 -0
  772. package/dist/types/lib/slots/messages/buildMessagesSubflow.d.ts +40 -0
  773. package/dist/types/lib/slots/messages/buildMessagesSubflow.d.ts.map +1 -0
  774. package/dist/types/lib/slots/messages/index.d.ts +3 -0
  775. package/dist/types/lib/slots/messages/index.d.ts.map +1 -0
  776. package/dist/types/lib/slots/messages/types.d.ts +26 -0
  777. package/dist/types/lib/slots/messages/types.d.ts.map +1 -0
  778. package/dist/types/lib/slots/system-prompt/buildSystemPromptSubflow.d.ts +27 -0
  779. package/dist/types/lib/slots/system-prompt/buildSystemPromptSubflow.d.ts.map +1 -0
  780. package/dist/types/lib/slots/system-prompt/index.d.ts +3 -0
  781. package/dist/types/lib/slots/system-prompt/index.d.ts.map +1 -0
  782. package/dist/types/lib/slots/system-prompt/types.d.ts +17 -0
  783. package/dist/types/lib/slots/system-prompt/types.d.ts.map +1 -0
  784. package/dist/types/lib/slots/tools/buildToolsSubflow.d.ts +23 -0
  785. package/dist/types/lib/slots/tools/buildToolsSubflow.d.ts.map +1 -0
  786. package/dist/types/lib/slots/tools/index.d.ts +3 -0
  787. package/dist/types/lib/slots/tools/index.d.ts.map +1 -0
  788. package/dist/types/lib/slots/tools/types.d.ts +18 -0
  789. package/dist/types/lib/slots/tools/types.d.ts.map +1 -0
  790. package/dist/types/lib/swarm/buildSwarmRouting.d.ts +36 -0
  791. package/dist/types/lib/swarm/buildSwarmRouting.d.ts.map +1 -0
  792. package/dist/types/lib/swarm/index.d.ts +3 -0
  793. package/dist/types/lib/swarm/index.d.ts.map +1 -0
  794. package/dist/types/llm.js +7 -0
  795. package/dist/types/llm.js.map +1 -0
  796. package/dist/types/memory/conversationHelpers.d.ts +23 -0
  797. package/dist/types/memory/conversationHelpers.d.ts.map +1 -0
  798. package/dist/types/memory/index.d.ts +2 -0
  799. package/dist/types/memory/index.d.ts.map +1 -0
  800. package/dist/types/messages.js +32 -0
  801. package/dist/types/messages.js.map +1 -0
  802. package/dist/types/models/index.d.ts +4 -0
  803. package/dist/types/models/index.d.ts.map +1 -0
  804. package/dist/types/models/pricing.d.ts +8 -0
  805. package/dist/types/models/pricing.d.ts.map +1 -0
  806. package/dist/types/models/providers.d.ts +23 -0
  807. package/dist/types/models/providers.d.ts.map +1 -0
  808. package/dist/types/models/types.d.ts +25 -0
  809. package/dist/types/models/types.d.ts.map +1 -0
  810. package/dist/types/multiAgent.js +6 -0
  811. package/dist/types/multiAgent.js.map +1 -0
  812. package/dist/types/observe.barrel.d.ts +21 -0
  813. package/dist/types/observe.barrel.d.ts.map +1 -0
  814. package/dist/types/providers/index.d.ts +15 -0
  815. package/dist/types/providers/index.d.ts.map +1 -0
  816. package/dist/types/providers/messages/charBudget.d.ts +19 -0
  817. package/dist/types/providers/messages/charBudget.d.ts.map +1 -0
  818. package/dist/types/providers/messages/compositeMessages.d.ts +16 -0
  819. package/dist/types/providers/messages/compositeMessages.d.ts.map +1 -0
  820. package/dist/types/providers/messages/fullHistory.d.ts +12 -0
  821. package/dist/types/providers/messages/fullHistory.d.ts.map +1 -0
  822. package/dist/types/providers/messages/index.d.ts +15 -0
  823. package/dist/types/providers/messages/index.d.ts.map +1 -0
  824. package/dist/types/providers/messages/persistentHistory.d.ts +32 -0
  825. package/dist/types/providers/messages/persistentHistory.d.ts.map +1 -0
  826. package/dist/types/providers/messages/slidingWindow.d.ts +16 -0
  827. package/dist/types/providers/messages/slidingWindow.d.ts.map +1 -0
  828. package/dist/types/providers/messages/summaryStrategy.d.ts +29 -0
  829. package/dist/types/providers/messages/summaryStrategy.d.ts.map +1 -0
  830. package/dist/types/providers/messages/withToolPairSafety.d.ts +19 -0
  831. package/dist/types/providers/messages/withToolPairSafety.d.ts.map +1 -0
  832. package/dist/types/providers/prompt/compositePrompt.d.ts +20 -0
  833. package/dist/types/providers/prompt/compositePrompt.d.ts.map +1 -0
  834. package/dist/types/providers/prompt/index.d.ts +10 -0
  835. package/dist/types/providers/prompt/index.d.ts.map +1 -0
  836. package/dist/types/providers/prompt/skillBasedPrompt.d.ts +33 -0
  837. package/dist/types/providers/prompt/skillBasedPrompt.d.ts.map +1 -0
  838. package/dist/types/providers/prompt/static.d.ts +6 -0
  839. package/dist/types/providers/prompt/static.d.ts.map +1 -0
  840. package/dist/types/providers/prompt/template.d.ts +6 -0
  841. package/dist/types/providers/prompt/template.d.ts.map +1 -0
  842. package/dist/types/providers/tools/PermissionPolicy.d.ts +76 -0
  843. package/dist/types/providers/tools/PermissionPolicy.d.ts.map +1 -0
  844. package/dist/types/providers/tools/agentAsTool.d.ts +40 -0
  845. package/dist/types/providers/tools/agentAsTool.d.ts.map +1 -0
  846. package/dist/types/providers/tools/compositeTools.d.ts +18 -0
  847. package/dist/types/providers/tools/compositeTools.d.ts.map +1 -0
  848. package/dist/types/providers/tools/dynamicTools.d.ts +27 -0
  849. package/dist/types/providers/tools/dynamicTools.d.ts.map +1 -0
  850. package/dist/types/providers/tools/gatedTools.d.ts +52 -0
  851. package/dist/types/providers/tools/gatedTools.d.ts.map +1 -0
  852. package/dist/types/providers/tools/index.d.ts +15 -0
  853. package/dist/types/providers/tools/index.d.ts.map +1 -0
  854. package/dist/types/providers/tools/noTools.d.ts +6 -0
  855. package/dist/types/providers/tools/noTools.d.ts.map +1 -0
  856. package/dist/types/providers/tools/staticTools.d.ts +7 -0
  857. package/dist/types/providers/tools/staticTools.d.ts.map +1 -0
  858. package/dist/types/providers.barrel.d.ts +34 -0
  859. package/dist/types/providers.barrel.d.ts.map +1 -0
  860. package/dist/types/recorders/index.d.ts +6 -0
  861. package/dist/types/recorders/index.d.ts.map +1 -0
  862. package/dist/types/recorders/v2/CompositeRecorder.d.ts +30 -0
  863. package/dist/types/recorders/v2/CompositeRecorder.d.ts.map +1 -0
  864. package/dist/types/recorders/v2/CostRecorder.d.ts +43 -0
  865. package/dist/types/recorders/v2/CostRecorder.d.ts.map +1 -0
  866. package/dist/types/recorders/v2/ExplainRecorder.d.ts +67 -0
  867. package/dist/types/recorders/v2/ExplainRecorder.d.ts.map +1 -0
  868. package/dist/types/recorders/v2/GuardrailRecorder.d.ts +45 -0
  869. package/dist/types/recorders/v2/GuardrailRecorder.d.ts.map +1 -0
  870. package/dist/types/recorders/v2/OTelRecorder.d.ts +50 -0
  871. package/dist/types/recorders/v2/OTelRecorder.d.ts.map +1 -0
  872. package/dist/types/recorders/v2/PermissionRecorder.d.ts +66 -0
  873. package/dist/types/recorders/v2/PermissionRecorder.d.ts.map +1 -0
  874. package/dist/types/recorders/v2/QualityRecorder.d.ts +37 -0
  875. package/dist/types/recorders/v2/QualityRecorder.d.ts.map +1 -0
  876. package/dist/types/recorders/v2/RecorderBridge.d.ts +38 -0
  877. package/dist/types/recorders/v2/RecorderBridge.d.ts.map +1 -0
  878. package/dist/types/recorders/v2/TokenRecorder.d.ts +54 -0
  879. package/dist/types/recorders/v2/TokenRecorder.d.ts.map +1 -0
  880. package/dist/types/recorders/v2/ToolUsageRecorder.d.ts +34 -0
  881. package/dist/types/recorders/v2/ToolUsageRecorder.d.ts.map +1 -0
  882. package/dist/types/recorders/v2/TurnRecorder.d.ts +36 -0
  883. package/dist/types/recorders/v2/TurnRecorder.d.ts.map +1 -0
  884. package/dist/types/recorders/v2/agentObservability.d.ts +68 -0
  885. package/dist/types/recorders/v2/agentObservability.d.ts.map +1 -0
  886. package/dist/types/recorders/v2/index.d.ts +21 -0
  887. package/dist/types/recorders/v2/index.d.ts.map +1 -0
  888. package/dist/types/resilience.barrel.d.ts +18 -0
  889. package/dist/types/resilience.barrel.d.ts.map +1 -0
  890. package/dist/types/retriever.js +7 -0
  891. package/dist/types/retriever.js.map +1 -0
  892. package/dist/types/scope/AgentScope.d.ts +87 -0
  893. package/dist/types/scope/AgentScope.d.ts.map +1 -0
  894. package/dist/types/scope/index.d.ts +3 -0
  895. package/dist/types/scope/index.d.ts.map +1 -0
  896. package/dist/types/scope/types.d.ts +151 -0
  897. package/dist/types/scope/types.d.ts.map +1 -0
  898. package/dist/types/security.barrel.d.ts +17 -0
  899. package/dist/types/security.barrel.d.ts.map +1 -0
  900. package/dist/types/stages/augmentPrompt.d.ts +7 -0
  901. package/dist/types/stages/augmentPrompt.d.ts.map +1 -0
  902. package/dist/types/stages/callLLM.d.ts +8 -0
  903. package/dist/types/stages/callLLM.d.ts.map +1 -0
  904. package/dist/types/stages/commitMemory.d.ts +51 -0
  905. package/dist/types/stages/commitMemory.d.ts.map +1 -0
  906. package/dist/types/stages/finalize.d.ts +7 -0
  907. package/dist/types/stages/finalize.d.ts.map +1 -0
  908. package/dist/types/stages/helpers.d.ts +17 -0
  909. package/dist/types/stages/helpers.d.ts.map +1 -0
  910. package/dist/types/stages/index.d.ts +10 -0
  911. package/dist/types/stages/index.d.ts.map +1 -0
  912. package/dist/types/stages/parseResponse.d.ts +8 -0
  913. package/dist/types/stages/parseResponse.d.ts.map +1 -0
  914. package/dist/types/stages/retrieve.d.ts +8 -0
  915. package/dist/types/stages/retrieve.d.ts.map +1 -0
  916. package/dist/types/stages/runnerAsStage.d.ts +18 -0
  917. package/dist/types/stages/runnerAsStage.d.ts.map +1 -0
  918. package/dist/types/stream.barrel.d.ts +19 -0
  919. package/dist/types/stream.barrel.d.ts.map +1 -0
  920. package/dist/types/streaming/StreamEmitter.d.ts +93 -0
  921. package/dist/types/streaming/StreamEmitter.d.ts.map +1 -0
  922. package/dist/types/streaming/index.d.ts +3 -0
  923. package/dist/types/streaming/index.d.ts.map +1 -0
  924. package/dist/types/subflows/index.d.ts +3 -0
  925. package/dist/types/subflows/index.d.ts.map +1 -0
  926. package/dist/types/subflows/prepareMemory.d.ts +60 -0
  927. package/dist/types/subflows/prepareMemory.d.ts.map +1 -0
  928. package/dist/types/tools/ToolRegistry.d.ts +47 -0
  929. package/dist/types/tools/ToolRegistry.d.ts.map +1 -0
  930. package/dist/types/tools/askHuman.d.ts +39 -0
  931. package/dist/types/tools/askHuman.d.ts.map +1 -0
  932. package/dist/types/tools/index.d.ts +3 -0
  933. package/dist/types/tools/index.d.ts.map +1 -0
  934. package/dist/types/tools/validateInput.d.ts +29 -0
  935. package/dist/types/tools/validateInput.d.ts.map +1 -0
  936. package/dist/types/tools/zodToJsonSchema.d.ts +9 -0
  937. package/dist/types/tools/zodToJsonSchema.d.ts.map +1 -0
  938. package/dist/types/tools.js +6 -0
  939. package/dist/types/tools.js.map +1 -0
  940. package/dist/types/types/adapter.d.ts +36 -0
  941. package/dist/types/types/adapter.d.ts.map +1 -0
  942. package/dist/types/types/agent.d.ts +37 -0
  943. package/dist/types/types/agent.d.ts.map +1 -0
  944. package/dist/types/types/content.d.ts +104 -0
  945. package/dist/types/types/content.d.ts.map +1 -0
  946. package/dist/types/types/errors.d.ts +27 -0
  947. package/dist/types/types/errors.d.ts.map +1 -0
  948. package/dist/types/types/index.d.ts +14 -0
  949. package/dist/types/types/index.d.ts.map +1 -0
  950. package/dist/types/types/llm.d.ts +78 -0
  951. package/dist/types/types/llm.d.ts.map +1 -0
  952. package/dist/types/types/messages.d.ts +40 -0
  953. package/dist/types/types/messages.d.ts.map +1 -0
  954. package/dist/types/types/multiAgent.d.ts +57 -0
  955. package/dist/types/types/multiAgent.d.ts.map +1 -0
  956. package/dist/types/types/retriever.d.ts +41 -0
  957. package/dist/types/types/retriever.d.ts.map +1 -0
  958. package/dist/types/types/tools.d.ts +19 -0
  959. package/dist/types/types/tools.d.ts.map +1 -0
  960. package/package.json +178 -0
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Shared helpers for agent stages.
3
+ */
4
+ import { toolResultMessage } from '../types';
5
+ import { appendMessage } from '../memory';
6
+ /**
7
+ * Normalize an LLMResponse into an AdapterResult discriminated union.
8
+ * Shared by callLLM stage and createAdapterSubflow.
9
+ */
10
+ export function normalizeAdapterResponse(response) {
11
+ if (response.toolCalls && response.toolCalls.length > 0) {
12
+ return {
13
+ type: 'tools',
14
+ content: response.content ?? '',
15
+ toolCalls: response.toolCalls,
16
+ usage: response.usage,
17
+ model: response.model,
18
+ };
19
+ }
20
+ return {
21
+ type: 'final',
22
+ content: response.content,
23
+ usage: response.usage,
24
+ model: response.model,
25
+ };
26
+ }
27
+ /**
28
+ * Execute tool calls and append results to conversation messages.
29
+ * Returns the updated messages array.
30
+ */
31
+ export async function executeToolCalls(toolCalls, registry, messages) {
32
+ let msgs = messages;
33
+ for (const toolCall of toolCalls) {
34
+ const tool = registry.get(toolCall.name);
35
+ let resultContent;
36
+ if (!tool) {
37
+ resultContent = JSON.stringify({
38
+ error: true,
39
+ message: `Tool '${toolCall.name}' not found`,
40
+ });
41
+ }
42
+ else {
43
+ try {
44
+ const result = await tool.handler(toolCall.arguments);
45
+ resultContent = result.content;
46
+ }
47
+ catch (err) {
48
+ resultContent = JSON.stringify({
49
+ error: true,
50
+ message: err instanceof Error ? err.message : String(err),
51
+ });
52
+ }
53
+ }
54
+ msgs = appendMessage(msgs, toolResultMessage(resultContent, toolCall.id));
55
+ }
56
+ return msgs;
57
+ }
58
+ //# sourceMappingURL=helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/stages/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAqB;IAC5D,IAAI,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE;YAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAqB,EACrB,QAAsB,EACtB,QAAmB;IAEnB,IAAI,IAAI,GAAG,QAAQ,CAAC;IAEpB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,aAAqB,CAAC;QAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC7B,KAAK,EAAE,IAAI;gBACX,OAAO,EAAE,SAAS,QAAQ,CAAC,IAAI,aAAa;aAC7C,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACtD,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC;YACjC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;oBAC7B,KAAK,EAAE,IAAI;oBACX,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC1D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,iBAAiB,CAAC,aAAa,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -0,0 +1,9 @@
1
+ export { createCommitMemoryStage } from './commitMemory';
2
+ export { createCallLLMStage } from './callLLM';
3
+ export { parseResponseStage } from './parseResponse';
4
+ export { finalizeStage } from './finalize';
5
+ export { normalizeAdapterResponse, executeToolCalls } from './helpers';
6
+ export { createRetrieveStage } from './retrieve';
7
+ export { augmentPromptStage } from './augmentPrompt';
8
+ export { runnerAsStage } from './runnerAsStage';
9
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/stages/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,25 @@
1
+ /**
2
+ * ParseResponse stage — extract ParsedResponse from AdapterResult.
3
+ * Also appends assistant message to conversation history.
4
+ */
5
+ import { assistantMessage } from '../types';
6
+ import { appendMessage } from '../memory';
7
+ export function parseResponseStage(scope) {
8
+ const result = scope.adapterResult;
9
+ if (!result) {
10
+ throw new Error('ParseResponse: no adapter result in scope');
11
+ }
12
+ if (result.type === 'error') {
13
+ throw new Error(`LLM call failed: [${result.code}] ${result.message}`);
14
+ }
15
+ const parsed = {
16
+ hasToolCalls: result.type === 'tools',
17
+ toolCalls: result.type === 'tools' ? result.toolCalls : [],
18
+ content: result.content,
19
+ };
20
+ scope.parsedResponse = parsed;
21
+ const messages = scope.messages ?? [];
22
+ const asstMsg = assistantMessage(result.content, result.type === 'tools' ? result.toolCalls : undefined);
23
+ scope.messages = appendMessage(messages, asstMsg);
24
+ }
25
+ //# sourceMappingURL=parseResponse.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parseResponse.js","sourceRoot":"","sources":["../../../src/stages/parseResponse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,UAAU,kBAAkB,CAAC,KAA+B;IAChE,MAAM,MAAM,GAAG,KAAK,CAAC,aAA0C,CAAC;IAEhE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,MAAM,GAAG;QACb,YAAY,EAAE,MAAM,CAAC,IAAI,KAAK,OAAO;QACrC,SAAS,EAAE,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;QAC1D,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;IAEF,KAAK,CAAC,cAAc,GAAG,MAAM,CAAC;IAE9B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,gBAAgB,CAC9B,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CACvD,CAAC;IACF,KAAK,CAAC,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * Retrieve stage — calls retriever provider, writes RetrievalResult to scope.
3
+ */
4
+ import { getTextContent } from '../types/content';
5
+ export function createRetrieveStage(retriever, options) {
6
+ return async (scope) => {
7
+ // Use explicit retrieval query if set, otherwise last user message
8
+ const lastUserContent = (scope.messages ?? [])
9
+ .filter((m) => m.role === 'user')
10
+ .pop()?.content;
11
+ const query = scope.retrievalQuery ??
12
+ (lastUserContent ? getTextContent(lastUserContent) : '');
13
+ const result = await retriever.retrieve(query, options);
14
+ // Write to scope — recorders observe this
15
+ scope.retrievalResult = result;
16
+ };
17
+ }
18
+ //# sourceMappingURL=retrieve.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"retrieve.js","sourceRoot":"","sources":["../../../src/stages/retrieve.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,UAAU,mBAAmB,CAAC,SAA4B,EAAE,OAAyB;IACzF,OAAO,KAAK,EAAE,KAA2B,EAAE,EAAE;QAC3C,mEAAmE;QACnE,MAAM,eAAe,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;aAC3C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAChC,GAAG,EAAE,EAAE,OAAO,CAAC;QAClB,MAAM,KAAK,GACT,KAAK,CAAC,cAAc;YACpB,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAE3D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAExD,0CAA0C;QAC1C,KAAK,CAAC,eAAe,GAAG,MAAM,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,66 @@
1
+ /**
2
+ * runnerAsStage — wraps any RunnerLike as a flowchart stage function.
3
+ *
4
+ * This is the core primitive for multi-agent composition. Any runner
5
+ * (Agent, RAG, LLMCall, or user-built) can become a stage in a pipeline.
6
+ */
7
+ /**
8
+ * Creates a stage function that executes a runner and writes its result to scope.
9
+ *
10
+ * Default behavior:
11
+ * - Input: reads previous agent's output (or pipelineInput for first agent)
12
+ * - Output: writes to 'result' and records agent entry in agentResults
13
+ */
14
+ export function runnerAsStage(config) {
15
+ return async (scope) => {
16
+ const state = buildStateSnapshot(scope);
17
+ // Default: prefer previous agent's result, fall back to pipeline input
18
+ const input = config.inputMapper
19
+ ? config.inputMapper(state)
20
+ : state.result ?? state.pipelineInput ?? '';
21
+ const startTime = Date.now();
22
+ const env = scope.$getEnv();
23
+ const signal = env?.signal;
24
+ const timeoutMs = env?.timeoutMs;
25
+ const output = await config.runner.run(input, { signal, timeoutMs });
26
+ const latencyMs = Date.now() - startTime;
27
+ // Apply output mapper or default write
28
+ if (config.outputMapper) {
29
+ const mapped = config.outputMapper(output, state);
30
+ for (const [key, value] of Object.entries(mapped)) {
31
+ scope.$setValue(key, value);
32
+ }
33
+ }
34
+ else {
35
+ scope.result = output.content;
36
+ }
37
+ // Record agent result entry
38
+ const entry = {
39
+ id: config.id,
40
+ name: config.name,
41
+ content: output.content,
42
+ latencyMs,
43
+ narrative: config.runner.getNarrative?.() ?? undefined,
44
+ };
45
+ const existing = scope.agentResults ?? [];
46
+ scope.agentResults = [...existing, entry];
47
+ };
48
+ }
49
+ /** Build a plain object snapshot of scope state for mappers. */
50
+ function buildStateSnapshot(scope) {
51
+ const result = {};
52
+ // Read well-known keys that mappers might need
53
+ for (const key of [
54
+ 'pipelineInput',
55
+ 'result',
56
+ 'agentResults',
57
+ 'messages',
58
+ 'systemPrompt',
59
+ ]) {
60
+ const val = scope.$getValue(key);
61
+ if (val !== undefined)
62
+ result[key] = val;
63
+ }
64
+ return result;
65
+ }
66
+ //# sourceMappingURL=runnerAsStage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runnerAsStage.js","sourceRoot":"","sources":["../../../src/stages/runnerAsStage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAwB;IACpD,OAAO,KAAK,EAAE,KAAkC,EAAiB,EAAE;QACjE,MAAM,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACxC,uEAAuE;QACvE,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW;YAC9B,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC;YAC3B,CAAC,CAAE,KAAK,CAAC,MAAiB,IAAK,KAAK,CAAC,aAAwB,IAAI,EAAE,CAAC;QAEtE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,CAAC;QAC3B,MAAM,SAAS,GAAG,GAAG,EAAE,SAAS,CAAC;QAEjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACrE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEzC,uCAAuC;QACvC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAClD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;QAChC,CAAC;QAED,4BAA4B;QAC5B,MAAM,KAAK,GAAqB;YAC9B,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS;YACT,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,IAAI,SAAS;SACvD,CAAC;QAEF,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;QAC1C,KAAK,CAAC,YAAY,GAAG,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,SAAS,kBAAkB,CAAC,KAAkC;IAC5D,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,+CAA+C;IAC/C,KAAK,MAAM,GAAG,IAAI;QAChB,eAAe;QACf,QAAQ;QACR,cAAc;QACd,UAAU;QACV,cAAc;KACN,EAAE,CAAC;QACX,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAC3C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * agentfootprint/stream — See agents work in real-time.
3
+ *
4
+ * 9-event discriminated union for CLI/web/mobile consumers.
5
+ * SSEFormatter for Server-Sent Events.
6
+ *
7
+ * @example
8
+ * ```typescript
9
+ * import { SSEFormatter } from 'agentfootprint/stream';
10
+ * import type { AgentStreamEvent } from 'agentfootprint/stream';
11
+ *
12
+ * await agent.run('hello', {
13
+ * onEvent: (e: AgentStreamEvent) => res.write(SSEFormatter.format(e)),
14
+ * });
15
+ * ```
16
+ */
17
+ export { StreamEmitter, SSEFormatter } from './streaming';
18
+ //# sourceMappingURL=stream.barrel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"stream.barrel.js","sourceRoot":"","sources":["../../src/stream.barrel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,43 @@
1
+ /**
2
+ * StreamEmitter — dispatches AgentStreamEvents to consumers.
3
+ *
4
+ * Error isolation: handler errors are swallowed — never break the agent pipeline.
5
+ * This is the correct behavior for a push-to-consumer system (same as RecorderBridge).
6
+ */
7
+ export class StreamEmitter {
8
+ handlers = [];
9
+ on(handler) {
10
+ this.handlers.push(handler);
11
+ return () => {
12
+ this.handlers = this.handlers.filter((h) => h !== handler);
13
+ };
14
+ }
15
+ emit(event) {
16
+ for (const handler of this.handlers) {
17
+ try {
18
+ handler(event);
19
+ }
20
+ catch {
21
+ // Swallow handler errors — never break the pipeline
22
+ }
23
+ }
24
+ }
25
+ }
26
+ /**
27
+ * SSEFormatter — converts AgentStreamEvent to Server-Sent Events text.
28
+ *
29
+ * @example
30
+ * ```typescript
31
+ * res.write(SSEFormatter.format({ type: 'token', content: 'Hello' }));
32
+ * // event: token\ndata: {"type":"token","content":"Hello"}\n\n
33
+ * ```
34
+ */
35
+ export class SSEFormatter {
36
+ static format(event) {
37
+ return `event: ${event.type}\ndata: ${JSON.stringify(event)}\n\n`;
38
+ }
39
+ static formatAll(events) {
40
+ return events.map(SSEFormatter.format).join('');
41
+ }
42
+ }
43
+ //# sourceMappingURL=StreamEmitter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"StreamEmitter.js","sourceRoot":"","sources":["../../../src/streaming/StreamEmitter.ts"],"names":[],"mappings":"AAqCA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IAChB,QAAQ,GAA8B,EAAE,CAAC;IAEjD,EAAE,CAAC,OAAgC;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QAC7D,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAuB;QAC1B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;YACtD,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IACvB,MAAM,CAAC,MAAM,CAAC,KAAuB;QACnC,OAAO,UAAU,KAAK,CAAC,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,MAA0B;QACzC,OAAO,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;CACF"}
@@ -0,0 +1,2 @@
1
+ export { StreamEmitter, SSEFormatter } from './StreamEmitter';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/streaming/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { createPrepareMemorySubflow } from './prepareMemory';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/subflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * PrepareMemory subflow — load history from store + apply MessageStrategy.
3
+ *
4
+ * Flowchart (2 stages):
5
+ * LoadHistory → ApplyStrategy
6
+ *
7
+ * LoadHistory: calls store.load(conversationId), merges stored history with
8
+ * the current turn's message (added by SeedScope), writes merged history
9
+ * to scope as `memory_storedHistory`.
10
+ *
11
+ * ApplyStrategy: applies the configured MessageStrategy to the merged history
12
+ * (trim, window, summarize). Writes prepared messages to scope as
13
+ * `memory_preparedMessages`. If no strategy, passes merged history through.
14
+ *
15
+ * The subflow is mounted via addSubFlowChartNext in Agent.ts:
16
+ * inputMapper — copies current messages from parent scope into subflow
17
+ * outputMapper — copies prepared messages back to parent scope's `messages`
18
+ *
19
+ * No-op behavior:
20
+ * - No store: LoadHistory writes current messages as-is (no DB hit)
21
+ * - No strategy: ApplyStrategy writes merged history as-is (no trimming)
22
+ * Both stages are always present in the flowchart for narrative visibility.
23
+ */
24
+ import { flowChart } from 'footprintjs';
25
+ // ── Subflow factory ───────────────────────────────────────────
26
+ /**
27
+ * Build the PrepareMemory subflow.
28
+ *
29
+ * Mount this with addSubFlowChartNext after SeedScope:
30
+ * ```typescript
31
+ * .addSubFlowChartNext('sf-prepare-memory', createPrepareMemorySubflow(config), 'PrepareMemory', {
32
+ * inputMapper: (parent) => ({
33
+ * currentMessages: parent.messages ?? [],
34
+ * loopCount: parent.loopCount ?? 0,
35
+ * }),
36
+ * outputMapper: (sfOutput) => ({
37
+ * memory_preparedMessages: sfOutput.memory_preparedMessages,
38
+ * memory_storedHistory: sfOutput.memory_storedHistory,
39
+ * }),
40
+ * })
41
+ * ```
42
+ */
43
+ export function createPrepareMemorySubflow(config) {
44
+ // ── Stage 1: LoadHistory ─────────────────────────────────
45
+ const loadHistory = async (scope) => {
46
+ const current = scope.currentMessages ?? [];
47
+ if (!config.store || !config.conversationId) {
48
+ // No store configured — pass current messages through unchanged
49
+ scope.memory_storedHistory = current;
50
+ return;
51
+ }
52
+ // Null-safe: store.load() may return null for backends that don't have a record.
53
+ const stored = (await config.store.load(config.conversationId)) ?? [];
54
+ // Merge strategy: stored history first, then new messages from this turn.
55
+ // currentMessages contains only the new messages for this turn (e.g. [user('question')]).
56
+ // Append unconditionally — the store holds all prior turns.
57
+ const merged = stored.length > 0 ? [...stored, ...current] : current;
58
+ scope.memory_storedHistory = merged;
59
+ };
60
+ // ── Stage 2: ApplyStrategy ───────────────────────────────
61
+ const applyStrategy = async (scope) => {
62
+ const merged = scope.memory_storedHistory ?? [];
63
+ if (!config.strategy) {
64
+ // No strategy — pass through as-is
65
+ scope.memory_preparedMessages = merged;
66
+ return;
67
+ }
68
+ // Build a minimal MessageContext. Turn number and loop iteration are
69
+ // not available here; strategies that need them (rare) can derive from
70
+ // the message array length.
71
+ const ctx = {
72
+ message: '',
73
+ turnNumber: 0,
74
+ loopIteration: 0,
75
+ };
76
+ const decision = await config.strategy.prepare(merged, ctx);
77
+ scope.memory_preparedMessages = decision.value;
78
+ };
79
+ return flowChart('LoadHistory', loadHistory, 'load-history')
80
+ .addFunction('ApplyStrategy', applyStrategy, 'apply-strategy')
81
+ .build();
82
+ }
83
+ //# sourceMappingURL=prepareMemory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"prepareMemory.js","sourceRoot":"","sources":["../../../src/subflows/prepareMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAuBxC,iEAAiE;AAEjE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAA2B;IACpE,4DAA4D;IAE5D,MAAM,WAAW,GAAG,KAAK,EAAE,KAAuC,EAAE,EAAE;QACpE,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC;QAE5C,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC5C,gEAAgE;YAChE,KAAK,CAAC,oBAAoB,GAAG,OAAO,CAAC;YACrC,OAAO;QACT,CAAC;QAED,iFAAiF;QACjF,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;QAEtE,0EAA0E;QAC1E,0FAA0F;QAC1F,4DAA4D;QAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAErE,KAAK,CAAC,oBAAoB,GAAG,MAAM,CAAC;IACtC,CAAC,CAAC;IAEF,4DAA4D;IAE5D,MAAM,aAAa,GAAG,KAAK,EAAE,KAAuC,EAAE,EAAE;QACtE,MAAM,MAAM,GAAG,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC;QAEhD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,mCAAmC;YACnC,KAAK,CAAC,uBAAuB,GAAG,MAAM,CAAC;YACvC,OAAO;QACT,CAAC;QAED,qEAAqE;QACrE,uEAAuE;QACvE,4BAA4B;QAC5B,MAAM,GAAG,GAAmB;YAC1B,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,CAAC;YACb,aAAa,EAAE,CAAC;SACjB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC5D,KAAK,CAAC,uBAAuB,GAAG,QAAQ,CAAC,KAAK,CAAC;IACjD,CAAC,CAAC;IAEF,OAAO,SAAS,CAAuB,aAAa,EAAE,WAAW,EAAE,cAAc,CAAC;SAC/E,WAAW,CAAC,eAAe,EAAE,aAAa,EAAE,gBAAgB,CAAC;SAC7D,KAAK,EAAE,CAAC;AACb,CAAC"}
@@ -0,0 +1,84 @@
1
+ /**
2
+ * ToolRegistry — register, lookup, and format tools for LLM function calling.
3
+ */
4
+ import { zodToJsonSchema, isZodSchema } from './zodToJsonSchema';
5
+ export class ToolRegistry {
6
+ tools = new Map();
7
+ /** Register a tool. Throws if ID already registered. */
8
+ register(tool) {
9
+ if (this.tools.has(tool.id)) {
10
+ throw new Error(`ToolRegistry: tool '${tool.id}' already registered`);
11
+ }
12
+ this.tools.set(tool.id, tool);
13
+ return this;
14
+ }
15
+ /** Get a tool by ID. */
16
+ get(id) {
17
+ return this.tools.get(id);
18
+ }
19
+ /** Check if a tool is registered. */
20
+ has(id) {
21
+ return this.tools.has(id);
22
+ }
23
+ /** Get all registered tool IDs. */
24
+ ids() {
25
+ return Array.from(this.tools.keys());
26
+ }
27
+ /** Get all registered tools. */
28
+ all() {
29
+ return Array.from(this.tools.values());
30
+ }
31
+ /** Format tools for LLM function calling (OpenAI-compatible schema). */
32
+ formatForLLM(toolIds) {
33
+ const tools = toolIds
34
+ ? toolIds.map((id) => {
35
+ const tool = this.tools.get(id);
36
+ if (!tool)
37
+ throw new Error(`ToolRegistry: tool '${id}' not found`);
38
+ return tool;
39
+ })
40
+ : this.all();
41
+ return tools.map((tool) => ({
42
+ name: tool.id,
43
+ description: tool.description,
44
+ inputSchema: tool.inputSchema,
45
+ }));
46
+ }
47
+ /** Number of registered tools. */
48
+ get size() {
49
+ return this.tools.size;
50
+ }
51
+ }
52
+ /**
53
+ * Define a tool inline. Accepts JSON Schema or Zod schema for `inputSchema`.
54
+ *
55
+ * @example JSON Schema
56
+ * ```typescript
57
+ * defineTool({
58
+ * id: 'search',
59
+ * description: 'Search the web',
60
+ * inputSchema: { type: 'object', properties: { query: { type: 'string' } }, required: ['query'] },
61
+ * handler: async ({ query }) => ({ content: `Results for: ${query}` }),
62
+ * });
63
+ * ```
64
+ *
65
+ * @example Zod schema (auto-converted, no zod dependency in core)
66
+ * ```typescript
67
+ * import { z } from 'zod';
68
+ * defineTool({
69
+ * id: 'search',
70
+ * description: 'Search the web',
71
+ * inputSchema: z.object({ query: z.string().describe('Search query') }),
72
+ * handler: async ({ query }) => ({ content: `Results for: ${query}` }),
73
+ * });
74
+ * ```
75
+ */
76
+ export function defineTool(tool) {
77
+ const schema = tool.inputSchema;
78
+ // Duck-type Zod detection: Zod schemas have ._def and .safeParse
79
+ if (isZodSchema(schema)) {
80
+ return { ...tool, inputSchema: zodToJsonSchema(schema) };
81
+ }
82
+ return tool;
83
+ }
84
+ //# sourceMappingURL=ToolRegistry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ToolRegistry.js","sourceRoot":"","sources":["../../../src/tools/ToolRegistry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE3D,wDAAwD;IACxD,QAAQ,CAAC,IAAoB;QAC3B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,EAAE,sBAAsB,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wBAAwB;IACxB,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,qCAAqC;IACrC,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,mCAAmC;IACnC,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,gCAAgC;IAChC,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,wEAAwE;IACxE,YAAY,CAAC,OAAkB;QAC7B,MAAM,KAAK,GAAG,OAAO;YACnB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;gBACjB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAChC,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,EAAE,aAAa,CAAC,CAAC;gBACnE,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;YACJ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAEf,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC1B,IAAI,EAAE,IAAI,CAAC,EAAE;YACb,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,kCAAkC;IAClC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,UAAU,CAAC,IAAoB;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;IAEhC,iEAAiE;IACjE,IAAI,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,eAAe,CAAC,MAAa,CAAC,EAAE,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -0,0 +1,63 @@
1
+ /**
2
+ * askHuman — Built-in tool that pauses the agent loop for human input.
3
+ *
4
+ * When the LLM calls this tool, the agent loop pauses and creates a checkpoint.
5
+ * The human's response is provided via agent.resume(), which continues the loop
6
+ * with the answer as the tool result.
7
+ *
8
+ * @example
9
+ * ```typescript
10
+ * const agent = Agent.create({ provider })
11
+ * .system('You are helpful. Use ask_human when you need clarification.')
12
+ * .tool(askHuman())
13
+ * .build();
14
+ *
15
+ * const result = await agent.run('Process my refund');
16
+ * if (result.paused) {
17
+ * console.log(result.pauseData.question); // "What is your order ID?"
18
+ * const final = await agent.resume('ORD-123');
19
+ * }
20
+ * ```
21
+ */
22
+ /** Marker on ToolResult indicating this is an ask_human pause. Not globally reachable — only importable from this module. */
23
+ export const ASK_HUMAN_MARKER = Symbol('askHuman');
24
+ /** Check if a tool result is an ask_human pause. */
25
+ export function isAskHumanResult(result) {
26
+ return (typeof result === 'object' &&
27
+ result !== null &&
28
+ Object.getOwnPropertySymbols(result).includes(ASK_HUMAN_MARKER) &&
29
+ result[ASK_HUMAN_MARKER] === true);
30
+ }
31
+ /**
32
+ * Create the ask_human tool definition.
33
+ *
34
+ * @param description - Custom description for the LLM (optional).
35
+ */
36
+ export function askHuman(description) {
37
+ return {
38
+ id: 'ask_human',
39
+ description: description ??
40
+ 'Ask the human user a question. Use this when you need clarification, approval, or any input from the user before proceeding.',
41
+ inputSchema: {
42
+ type: 'object',
43
+ properties: {
44
+ question: {
45
+ type: 'string',
46
+ description: 'The question to ask the human.',
47
+ },
48
+ },
49
+ required: ['question'],
50
+ },
51
+ handler: async (input) => {
52
+ const question = String(input.question ?? '');
53
+ // Return a marked result — the tool execution stage detects this and pauses.
54
+ // The content is a placeholder; it gets replaced with the human's actual response on resume.
55
+ return {
56
+ content: `[Waiting for human response to: "${question}"]`,
57
+ question,
58
+ [ASK_HUMAN_MARKER]: true,
59
+ };
60
+ },
61
+ };
62
+ }
63
+ //# sourceMappingURL=askHuman.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"askHuman.js","sourceRoot":"","sources":["../../../src/tools/askHuman.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,6HAA6H;AAC7H,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AASnD,oDAAoD;AACpD,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC9D,MAA6C,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAC1E,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAoB;IAC3C,OAAO;QACL,EAAE,EAAE,WAAW;QACf,WAAW,EACT,WAAW;YACX,8HAA8H;QAChI,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gCAAgC;iBAC9C;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACvB;QACD,OAAO,EAAE,KAAK,EAAE,KAA8B,EAA2B,EAAE;YACzE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAC9C,6EAA6E;YAC7E,6FAA6F;YAC7F,OAAO;gBACL,OAAO,EAAE,oCAAoC,QAAQ,IAAI;gBACzD,QAAQ;gBACR,CAAC,gBAAgB,CAAC,EAAE,IAAI;aACzB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { ToolRegistry, defineTool } from './ToolRegistry';
2
+ export { askHuman } from './askHuman';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,56 @@
1
+ /**
2
+ * validateToolInput — lightweight JSON Schema validation for tool arguments.
3
+ *
4
+ * Validates LLM-provided tool arguments against the tool's inputSchema
5
+ * before calling the handler. Catches malformed arguments early with
6
+ * a clear error message fed back to the LLM.
7
+ *
8
+ * Supports: required fields, type checking (string, number, boolean, object, array).
9
+ * Does NOT support: $ref, oneOf, allOf, pattern, min/max, nested validation.
10
+ * For complex schemas, use a full validator (Ajv) in the handler.
11
+ */
12
+ /**
13
+ * Validate tool arguments against a JSON Schema.
14
+ * Returns { valid: true } or { valid: false, errors: [...] }.
15
+ */
16
+ export function validateToolInput(args, schema) {
17
+ const errors = [];
18
+ // Check required fields
19
+ const required = schema.required;
20
+ if (Array.isArray(required)) {
21
+ for (const field of required) {
22
+ if (args[field] === undefined || args[field] === null) {
23
+ errors.push({ path: field, message: `Required field '${field}' is missing.` });
24
+ }
25
+ }
26
+ }
27
+ // Check property types
28
+ const properties = schema.properties;
29
+ if (properties) {
30
+ for (const [key, prop] of Object.entries(properties)) {
31
+ const value = args[key];
32
+ if (value === undefined || value === null)
33
+ continue; // Skip optional missing fields
34
+ if (prop.type) {
35
+ const expectedType = prop.type;
36
+ const actualType = Array.isArray(value) ? 'array' : typeof value;
37
+ if (expectedType === 'integer') {
38
+ if (typeof value !== 'number' || !Number.isInteger(value)) {
39
+ errors.push({ path: key, message: `Expected integer for '${key}', got ${actualType}.` });
40
+ }
41
+ }
42
+ else if (expectedType !== actualType) {
43
+ errors.push({ path: key, message: `Expected ${expectedType} for '${key}', got ${actualType}.` });
44
+ }
45
+ }
46
+ }
47
+ }
48
+ return { valid: errors.length === 0, errors };
49
+ }
50
+ /**
51
+ * Format validation errors as a string for the LLM tool result.
52
+ */
53
+ export function formatValidationErrors(errors) {
54
+ return errors.map((e) => `${e.path}: ${e.message}`).join('; ');
55
+ }
56
+ //# sourceMappingURL=validateInput.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validateInput.js","sourceRoot":"","sources":["../../../src/tools/validateInput.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAA6B,EAC7B,MAA+B;IAE/B,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,wBAAwB;IACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAgC,CAAC;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBACtD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,KAAK,eAAe,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,MAAM,UAAU,GAAG,MAAM,CAAC,UAA2D,CAAC;IACtF,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS,CAAC,+BAA+B;YAEpF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC;gBAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC;gBAEjE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC1D,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,yBAAyB,GAAG,UAAU,UAAU,GAAG,EAAE,CAAC,CAAC;oBAC3F,CAAC;gBACH,CAAC;qBAAM,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;oBACvC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,YAAY,SAAS,GAAG,UAAU,UAAU,GAAG,EAAE,CAAC,CAAC;gBACnG,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAkC;IACvE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC"}