agentfootprint 1.23.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1565) hide show
  1. package/AGENTS.md +316 -198
  2. package/CLAUDE.md +313 -253
  3. package/README.md +208 -241
  4. package/ai-instructions/claude-code/SKILL.md +255 -510
  5. package/ai-instructions/clinerules +127 -52
  6. package/ai-instructions/copilot-instructions.md +124 -73
  7. package/ai-instructions/cursor/agentfootprint.md +124 -65
  8. package/ai-instructions/kiro/agentfootprint.md +124 -65
  9. package/ai-instructions/windsurfrules +127 -52
  10. package/dist/adapters/llm/AnthropicProvider.js +282 -0
  11. package/dist/adapters/llm/AnthropicProvider.js.map +1 -0
  12. package/dist/adapters/llm/BedrockProvider.js +294 -0
  13. package/dist/adapters/llm/BedrockProvider.js.map +1 -0
  14. package/dist/adapters/llm/BrowserAnthropicProvider.js +334 -0
  15. package/dist/adapters/llm/BrowserAnthropicProvider.js.map +1 -0
  16. package/dist/adapters/llm/BrowserOpenAIProvider.js +332 -0
  17. package/dist/adapters/llm/BrowserOpenAIProvider.js.map +1 -0
  18. package/dist/adapters/llm/MockProvider.js +187 -0
  19. package/dist/adapters/llm/MockProvider.js.map +1 -0
  20. package/dist/adapters/llm/OpenAIProvider.js +353 -0
  21. package/dist/adapters/llm/OpenAIProvider.js.map +1 -0
  22. package/dist/adapters/llm/createProvider.js +57 -0
  23. package/dist/adapters/llm/createProvider.js.map +1 -0
  24. package/dist/adapters/types.js +17 -0
  25. package/dist/adapters/types.js.map +1 -0
  26. package/dist/bridge/eventMeta.js +62 -0
  27. package/dist/bridge/eventMeta.js.map +1 -0
  28. package/dist/conventions.js +110 -0
  29. package/dist/conventions.js.map +1 -0
  30. package/dist/core/Agent.js +1015 -0
  31. package/dist/core/Agent.js.map +1 -0
  32. package/dist/core/LLMCall.js +258 -0
  33. package/dist/core/LLMCall.js.map +1 -0
  34. package/dist/core/RunnerBase.js +184 -0
  35. package/dist/core/RunnerBase.js.map +1 -0
  36. package/dist/core/cost.js +63 -0
  37. package/dist/core/cost.js.map +1 -0
  38. package/dist/core/pause.js +83 -0
  39. package/dist/core/pause.js.map +1 -0
  40. package/dist/core/runner.js +17 -0
  41. package/dist/core/runner.js.map +1 -0
  42. package/dist/core/slots/buildMessagesSlot.js +105 -0
  43. package/dist/core/slots/buildMessagesSlot.js.map +1 -0
  44. package/dist/core/slots/buildSystemPromptSlot.js +81 -0
  45. package/dist/core/slots/buildSystemPromptSlot.js.map +1 -0
  46. package/dist/core/slots/buildToolsSlot.js +85 -0
  47. package/dist/core/slots/buildToolsSlot.js.map +1 -0
  48. package/dist/core/slots/helpers.js +65 -0
  49. package/dist/core/slots/helpers.js.map +1 -0
  50. package/dist/core/tools.js +42 -0
  51. package/dist/core/tools.js.map +1 -0
  52. package/dist/core-flow/Conditional.js +237 -0
  53. package/dist/core-flow/Conditional.js.map +1 -0
  54. package/dist/core-flow/Loop.js +264 -0
  55. package/dist/core-flow/Loop.js.map +1 -0
  56. package/dist/core-flow/Parallel.js +344 -0
  57. package/dist/core-flow/Parallel.js.map +1 -0
  58. package/dist/core-flow/Sequence.js +194 -0
  59. package/dist/core-flow/Sequence.js.map +1 -0
  60. package/dist/esm/adapters/llm/AnthropicProvider.js +277 -0
  61. package/dist/esm/adapters/llm/AnthropicProvider.js.map +1 -0
  62. package/dist/esm/adapters/llm/BedrockProvider.js +289 -0
  63. package/dist/esm/adapters/llm/BedrockProvider.js.map +1 -0
  64. package/dist/esm/adapters/llm/BrowserAnthropicProvider.js +329 -0
  65. package/dist/esm/adapters/llm/BrowserAnthropicProvider.js.map +1 -0
  66. package/dist/esm/adapters/llm/BrowserOpenAIProvider.js +327 -0
  67. package/dist/esm/adapters/llm/BrowserOpenAIProvider.js.map +1 -0
  68. package/dist/esm/adapters/llm/MockProvider.js +182 -0
  69. package/dist/esm/adapters/llm/MockProvider.js.map +1 -0
  70. package/dist/esm/adapters/llm/OpenAIProvider.js +347 -0
  71. package/dist/esm/adapters/llm/OpenAIProvider.js.map +1 -0
  72. package/dist/esm/adapters/llm/createProvider.js +53 -0
  73. package/dist/esm/adapters/llm/createProvider.js.map +1 -0
  74. package/dist/esm/adapters/types.js +16 -0
  75. package/dist/esm/adapters/types.js.map +1 -0
  76. package/dist/esm/bridge/eventMeta.js +57 -0
  77. package/dist/esm/bridge/eventMeta.js.map +1 -0
  78. package/dist/esm/conventions.js +101 -0
  79. package/dist/esm/conventions.js.map +1 -0
  80. package/dist/esm/core/Agent.js +1010 -0
  81. package/dist/esm/core/Agent.js.map +1 -0
  82. package/dist/esm/core/LLMCall.js +253 -0
  83. package/dist/esm/core/LLMCall.js.map +1 -0
  84. package/dist/esm/core/RunnerBase.js +179 -0
  85. package/dist/esm/core/RunnerBase.js.map +1 -0
  86. package/dist/esm/core/cost.js +59 -0
  87. package/dist/esm/core/cost.js.map +1 -0
  88. package/dist/esm/core/pause.js +76 -0
  89. package/dist/esm/core/pause.js.map +1 -0
  90. package/dist/esm/core/runner.js +16 -0
  91. package/dist/esm/core/runner.js.map +1 -0
  92. package/dist/esm/core/slots/buildMessagesSlot.js +101 -0
  93. package/dist/esm/core/slots/buildMessagesSlot.js.map +1 -0
  94. package/dist/esm/core/slots/buildSystemPromptSlot.js +77 -0
  95. package/dist/esm/core/slots/buildSystemPromptSlot.js.map +1 -0
  96. package/dist/esm/core/slots/buildToolsSlot.js +81 -0
  97. package/dist/esm/core/slots/buildToolsSlot.js.map +1 -0
  98. package/dist/esm/core/slots/helpers.js +58 -0
  99. package/dist/esm/core/slots/helpers.js.map +1 -0
  100. package/dist/esm/core/tools.js +38 -0
  101. package/dist/esm/core/tools.js.map +1 -0
  102. package/dist/esm/core-flow/Conditional.js +232 -0
  103. package/dist/esm/core-flow/Conditional.js.map +1 -0
  104. package/dist/esm/core-flow/Loop.js +259 -0
  105. package/dist/esm/core-flow/Loop.js.map +1 -0
  106. package/dist/esm/core-flow/Parallel.js +339 -0
  107. package/dist/esm/core-flow/Parallel.js.map +1 -0
  108. package/dist/esm/core-flow/Sequence.js +189 -0
  109. package/dist/esm/core-flow/Sequence.js.map +1 -0
  110. package/dist/esm/events/dispatcher.js +193 -0
  111. package/dist/esm/events/dispatcher.js.map +1 -0
  112. package/dist/esm/events/payloads.js +9 -0
  113. package/dist/esm/events/payloads.js.map +1 -0
  114. package/dist/esm/events/registry.js +151 -0
  115. package/dist/esm/events/registry.js.map +1 -0
  116. package/dist/esm/events/types.js +9 -0
  117. package/dist/esm/events/types.js.map +1 -0
  118. package/dist/esm/index.js +118 -33
  119. package/dist/esm/index.js.map +1 -1
  120. package/dist/esm/injection-engine.js +5 -0
  121. package/dist/esm/injection-engine.js.map +1 -0
  122. package/dist/esm/lib/injection-engine/buildInjectionEngineSubflow.js +77 -0
  123. package/dist/esm/lib/injection-engine/buildInjectionEngineSubflow.js.map +1 -0
  124. package/dist/esm/lib/injection-engine/evaluator.js +75 -0
  125. package/dist/esm/lib/injection-engine/evaluator.js.map +1 -0
  126. package/dist/esm/lib/injection-engine/factories/defineFact.js +54 -0
  127. package/dist/esm/lib/injection-engine/factories/defineFact.js.map +1 -0
  128. package/dist/esm/lib/injection-engine/factories/defineInstruction.js +52 -0
  129. package/dist/esm/lib/injection-engine/factories/defineInstruction.js.map +1 -0
  130. package/dist/esm/lib/injection-engine/factories/defineSkill.js +53 -0
  131. package/dist/esm/lib/injection-engine/factories/defineSkill.js.map +1 -0
  132. package/dist/esm/lib/injection-engine/factories/defineSteering.js +35 -0
  133. package/dist/esm/lib/injection-engine/factories/defineSteering.js.map +1 -0
  134. package/dist/esm/lib/injection-engine/index.js +70 -0
  135. package/dist/esm/lib/injection-engine/index.js.map +1 -0
  136. package/dist/esm/lib/injection-engine/types.js +38 -0
  137. package/dist/esm/lib/injection-engine/types.js.map +1 -0
  138. package/dist/esm/memory/beats/llmExtractor.js +7 -20
  139. package/dist/esm/memory/beats/llmExtractor.js.map +1 -1
  140. package/dist/esm/memory/causal/index.js +5 -0
  141. package/dist/esm/memory/causal/index.js.map +1 -0
  142. package/dist/esm/memory/causal/loadSnapshot.js +112 -0
  143. package/dist/esm/memory/causal/loadSnapshot.js.map +1 -0
  144. package/dist/esm/memory/causal/snapshotPipeline.js +36 -0
  145. package/dist/esm/memory/causal/snapshotPipeline.js.map +1 -0
  146. package/dist/esm/memory/causal/types.js +25 -0
  147. package/dist/esm/memory/causal/types.js.map +1 -0
  148. package/dist/esm/memory/causal/writeSnapshot.js +75 -0
  149. package/dist/esm/memory/causal/writeSnapshot.js.map +1 -0
  150. package/dist/esm/memory/define.js +330 -0
  151. package/dist/esm/memory/define.js.map +1 -0
  152. package/dist/esm/memory/define.types.js +134 -0
  153. package/dist/esm/memory/define.types.js.map +1 -0
  154. package/dist/esm/memory/embedding/embedMessages.js +1 -15
  155. package/dist/esm/memory/embedding/embedMessages.js.map +1 -1
  156. package/dist/esm/memory/embedding/loadRelevant.js +1 -13
  157. package/dist/esm/memory/embedding/loadRelevant.js.map +1 -1
  158. package/dist/esm/memory/facts/llmFactExtractor.js +7 -20
  159. package/dist/esm/memory/facts/llmFactExtractor.js.map +1 -1
  160. package/dist/esm/memory/facts/patternFactExtractor.js +1 -15
  161. package/dist/esm/memory/facts/patternFactExtractor.js.map +1 -1
  162. package/dist/esm/memory/index.js +20 -1
  163. package/dist/esm/memory/index.js.map +1 -1
  164. package/dist/esm/memory/pipeline/auto.js +9 -10
  165. package/dist/esm/memory/pipeline/auto.js.map +1 -1
  166. package/dist/esm/memory/pipeline/default.js +14 -8
  167. package/dist/esm/memory/pipeline/default.js.map +1 -1
  168. package/dist/esm/memory/pipeline/fact.js +8 -10
  169. package/dist/esm/memory/pipeline/fact.js.map +1 -1
  170. package/dist/esm/memory/pipeline/narrative.js +9 -10
  171. package/dist/esm/memory/pipeline/narrative.js.map +1 -1
  172. package/dist/esm/memory/pipeline/semantic.js +8 -13
  173. package/dist/esm/memory/pipeline/semantic.js.map +1 -1
  174. package/dist/esm/memory/stages/formatDefault.js +1 -19
  175. package/dist/esm/memory/stages/formatDefault.js.map +1 -1
  176. package/dist/esm/memory/stages/tokenize.js +1 -21
  177. package/dist/esm/memory/stages/tokenize.js.map +1 -1
  178. package/dist/esm/observe.js +51 -0
  179. package/dist/esm/observe.js.map +1 -0
  180. package/dist/esm/patterns/Debate.js +61 -0
  181. package/dist/esm/patterns/Debate.js.map +1 -0
  182. package/dist/esm/patterns/MapReduce.js +162 -0
  183. package/dist/esm/patterns/MapReduce.js.map +1 -0
  184. package/dist/esm/patterns/Reflection.js +64 -0
  185. package/dist/esm/patterns/Reflection.js.map +1 -0
  186. package/dist/esm/patterns/SelfConsistency.js +71 -0
  187. package/dist/esm/patterns/SelfConsistency.js.map +1 -0
  188. package/dist/esm/patterns/Swarm.js +88 -0
  189. package/dist/esm/patterns/Swarm.js.map +1 -0
  190. package/dist/esm/patterns/ToT.js +98 -0
  191. package/dist/esm/patterns/ToT.js.map +1 -0
  192. package/dist/esm/patterns/index.js +18 -13
  193. package/dist/esm/patterns/index.js.map +1 -1
  194. package/dist/esm/providers.js +27 -0
  195. package/dist/esm/providers.js.map +1 -0
  196. package/dist/esm/recorders/core/AgentRecorder.js +20 -0
  197. package/dist/esm/recorders/core/AgentRecorder.js.map +1 -0
  198. package/dist/esm/recorders/core/CompositionRecorder.js +22 -0
  199. package/dist/esm/recorders/core/CompositionRecorder.js.map +1 -0
  200. package/dist/esm/recorders/core/ContextRecorder.js +218 -0
  201. package/dist/esm/recorders/core/ContextRecorder.js.map +1 -0
  202. package/dist/esm/recorders/core/CostRecorder.js +19 -0
  203. package/dist/esm/recorders/core/CostRecorder.js.map +1 -0
  204. package/dist/esm/recorders/core/EmitBridge.js +41 -0
  205. package/dist/esm/recorders/core/EmitBridge.js.map +1 -0
  206. package/dist/esm/recorders/core/EvalRecorder.js +21 -0
  207. package/dist/esm/recorders/core/EvalRecorder.js.map +1 -0
  208. package/dist/esm/recorders/core/MemoryRecorder.js +22 -0
  209. package/dist/esm/recorders/core/MemoryRecorder.js.map +1 -0
  210. package/dist/esm/recorders/core/PermissionRecorder.js +21 -0
  211. package/dist/esm/recorders/core/PermissionRecorder.js.map +1 -0
  212. package/dist/esm/recorders/core/SkillRecorder.js +19 -0
  213. package/dist/esm/recorders/core/SkillRecorder.js.map +1 -0
  214. package/dist/esm/recorders/core/StreamRecorder.js +20 -0
  215. package/dist/esm/recorders/core/StreamRecorder.js.map +1 -0
  216. package/dist/esm/recorders/core/typedEmit.js +27 -0
  217. package/dist/esm/recorders/core/typedEmit.js.map +1 -0
  218. package/dist/esm/recorders/core/types.js +16 -0
  219. package/dist/esm/recorders/core/types.js.map +1 -0
  220. package/dist/esm/recorders/observability/BoundaryRecorder.js +466 -0
  221. package/dist/esm/recorders/observability/BoundaryRecorder.js.map +1 -0
  222. package/dist/esm/recorders/observability/FlowchartRecorder.js +495 -0
  223. package/dist/esm/recorders/observability/FlowchartRecorder.js.map +1 -0
  224. package/dist/esm/recorders/observability/LoggingRecorder.js +98 -0
  225. package/dist/esm/recorders/observability/LoggingRecorder.js.map +1 -0
  226. package/dist/esm/recorders/observability/ThinkingRecorder.js +59 -0
  227. package/dist/esm/recorders/observability/ThinkingRecorder.js.map +1 -0
  228. package/dist/esm/recorders/observability/commentary/commentaryTemplates.js +202 -0
  229. package/dist/esm/recorders/observability/commentary/commentaryTemplates.js.map +1 -0
  230. package/dist/esm/recorders/observability/thinking/thinkingTemplates.js +185 -0
  231. package/dist/esm/recorders/observability/thinking/thinkingTemplates.js.map +1 -0
  232. package/dist/esm/resilience/fallbackProvider.js +53 -0
  233. package/dist/esm/resilience/fallbackProvider.js.map +1 -0
  234. package/dist/esm/resilience/index.js +65 -0
  235. package/dist/esm/resilience/index.js.map +1 -0
  236. package/dist/esm/resilience/withFallback.js +106 -0
  237. package/dist/esm/resilience/withFallback.js.map +1 -0
  238. package/dist/esm/resilience/withRetry.js +110 -0
  239. package/dist/esm/resilience/withRetry.js.map +1 -0
  240. package/dist/esm/stream.js +146 -0
  241. package/dist/esm/stream.js.map +1 -0
  242. package/dist/events/dispatcher.js +197 -0
  243. package/dist/events/dispatcher.js.map +1 -0
  244. package/dist/events/payloads.js +10 -0
  245. package/dist/events/payloads.js.map +1 -0
  246. package/dist/events/registry.js +154 -0
  247. package/dist/events/registry.js.map +1 -0
  248. package/dist/events/types.js +10 -0
  249. package/dist/events/types.js.map +1 -0
  250. package/dist/index.js +220 -89
  251. package/dist/index.js.map +1 -1
  252. package/dist/injection-engine.js +21 -0
  253. package/dist/injection-engine.js.map +1 -0
  254. package/dist/lib/injection-engine/buildInjectionEngineSubflow.js +81 -0
  255. package/dist/lib/injection-engine/buildInjectionEngineSubflow.js.map +1 -0
  256. package/dist/lib/injection-engine/evaluator.js +79 -0
  257. package/dist/lib/injection-engine/evaluator.js.map +1 -0
  258. package/dist/lib/injection-engine/factories/defineFact.js +58 -0
  259. package/dist/lib/injection-engine/factories/defineFact.js.map +1 -0
  260. package/dist/lib/injection-engine/factories/defineInstruction.js +56 -0
  261. package/dist/lib/injection-engine/factories/defineInstruction.js.map +1 -0
  262. package/dist/lib/injection-engine/factories/defineSkill.js +57 -0
  263. package/dist/lib/injection-engine/factories/defineSkill.js.map +1 -0
  264. package/dist/lib/injection-engine/factories/defineSteering.js +39 -0
  265. package/dist/lib/injection-engine/factories/defineSteering.js.map +1 -0
  266. package/dist/lib/injection-engine/index.js +79 -0
  267. package/dist/lib/injection-engine/index.js.map +1 -0
  268. package/dist/lib/injection-engine/types.js +42 -0
  269. package/dist/lib/injection-engine/types.js.map +1 -0
  270. package/dist/memory/beats/llmExtractor.js +7 -20
  271. package/dist/memory/beats/llmExtractor.js.map +1 -1
  272. package/dist/memory/causal/index.js +12 -0
  273. package/dist/memory/causal/index.js.map +1 -0
  274. package/dist/memory/causal/loadSnapshot.js +116 -0
  275. package/dist/memory/causal/loadSnapshot.js.map +1 -0
  276. package/dist/memory/causal/snapshotPipeline.js +40 -0
  277. package/dist/memory/causal/snapshotPipeline.js.map +1 -0
  278. package/dist/memory/causal/types.js +28 -0
  279. package/dist/memory/causal/types.js.map +1 -0
  280. package/dist/memory/causal/writeSnapshot.js +79 -0
  281. package/dist/memory/causal/writeSnapshot.js.map +1 -0
  282. package/dist/memory/define.js +335 -0
  283. package/dist/memory/define.js.map +1 -0
  284. package/dist/memory/define.types.js +143 -0
  285. package/dist/memory/define.types.js.map +1 -0
  286. package/dist/memory/embedding/embedMessages.js +1 -15
  287. package/dist/memory/embedding/embedMessages.js.map +1 -1
  288. package/dist/memory/embedding/loadRelevant.js +1 -13
  289. package/dist/memory/embedding/loadRelevant.js.map +1 -1
  290. package/dist/memory/facts/llmFactExtractor.js +7 -20
  291. package/dist/memory/facts/llmFactExtractor.js.map +1 -1
  292. package/dist/memory/facts/patternFactExtractor.js +1 -15
  293. package/dist/memory/facts/patternFactExtractor.js.map +1 -1
  294. package/dist/memory/index.js +47 -7
  295. package/dist/memory/index.js.map +1 -1
  296. package/dist/memory/pipeline/auto.js +9 -10
  297. package/dist/memory/pipeline/auto.js.map +1 -1
  298. package/dist/memory/pipeline/default.js +14 -8
  299. package/dist/memory/pipeline/default.js.map +1 -1
  300. package/dist/memory/pipeline/fact.js +8 -10
  301. package/dist/memory/pipeline/fact.js.map +1 -1
  302. package/dist/memory/pipeline/narrative.js +9 -10
  303. package/dist/memory/pipeline/narrative.js.map +1 -1
  304. package/dist/memory/pipeline/semantic.js +8 -13
  305. package/dist/memory/pipeline/semantic.js.map +1 -1
  306. package/dist/memory/stages/formatDefault.js +1 -19
  307. package/dist/memory/stages/formatDefault.js.map +1 -1
  308. package/dist/memory/stages/tokenize.js +1 -21
  309. package/dist/memory/stages/tokenize.js.map +1 -1
  310. package/dist/observe.js +71 -0
  311. package/dist/observe.js.map +1 -0
  312. package/dist/patterns/Debate.js +65 -0
  313. package/dist/patterns/Debate.js.map +1 -0
  314. package/dist/patterns/MapReduce.js +166 -0
  315. package/dist/patterns/MapReduce.js.map +1 -0
  316. package/dist/patterns/Reflection.js +68 -0
  317. package/dist/patterns/Reflection.js.map +1 -0
  318. package/dist/patterns/SelfConsistency.js +75 -0
  319. package/dist/patterns/SelfConsistency.js.map +1 -0
  320. package/dist/patterns/Swarm.js +92 -0
  321. package/dist/patterns/Swarm.js.map +1 -0
  322. package/dist/patterns/ToT.js +102 -0
  323. package/dist/patterns/ToT.js.map +1 -0
  324. package/dist/patterns/index.js +25 -18
  325. package/dist/patterns/index.js.map +1 -1
  326. package/dist/providers.js +44 -0
  327. package/dist/providers.js.map +1 -0
  328. package/dist/recorders/core/AgentRecorder.js +24 -0
  329. package/dist/recorders/core/AgentRecorder.js.map +1 -0
  330. package/dist/recorders/core/CompositionRecorder.js +26 -0
  331. package/dist/recorders/core/CompositionRecorder.js.map +1 -0
  332. package/dist/recorders/core/ContextRecorder.js +222 -0
  333. package/dist/recorders/core/ContextRecorder.js.map +1 -0
  334. package/dist/recorders/core/CostRecorder.js +23 -0
  335. package/dist/recorders/core/CostRecorder.js.map +1 -0
  336. package/dist/recorders/core/EmitBridge.js +45 -0
  337. package/dist/recorders/core/EmitBridge.js.map +1 -0
  338. package/dist/recorders/core/EvalRecorder.js +25 -0
  339. package/dist/recorders/core/EvalRecorder.js.map +1 -0
  340. package/dist/recorders/core/MemoryRecorder.js +26 -0
  341. package/dist/recorders/core/MemoryRecorder.js.map +1 -0
  342. package/dist/recorders/core/PermissionRecorder.js +25 -0
  343. package/dist/recorders/core/PermissionRecorder.js.map +1 -0
  344. package/dist/recorders/core/SkillRecorder.js +23 -0
  345. package/dist/recorders/core/SkillRecorder.js.map +1 -0
  346. package/dist/recorders/core/StreamRecorder.js +24 -0
  347. package/dist/recorders/core/StreamRecorder.js.map +1 -0
  348. package/dist/recorders/core/typedEmit.js +31 -0
  349. package/dist/recorders/core/typedEmit.js.map +1 -0
  350. package/dist/recorders/core/types.js +19 -0
  351. package/dist/recorders/core/types.js.map +1 -0
  352. package/dist/recorders/observability/BoundaryRecorder.js +471 -0
  353. package/dist/recorders/observability/BoundaryRecorder.js.map +1 -0
  354. package/dist/recorders/observability/FlowchartRecorder.js +500 -0
  355. package/dist/recorders/observability/FlowchartRecorder.js.map +1 -0
  356. package/dist/recorders/observability/LoggingRecorder.js +102 -0
  357. package/dist/recorders/observability/LoggingRecorder.js.map +1 -0
  358. package/dist/recorders/observability/ThinkingRecorder.js +63 -0
  359. package/dist/recorders/observability/ThinkingRecorder.js.map +1 -0
  360. package/dist/recorders/observability/commentary/commentaryTemplates.js +208 -0
  361. package/dist/recorders/observability/commentary/commentaryTemplates.js.map +1 -0
  362. package/dist/recorders/observability/thinking/thinkingTemplates.js +190 -0
  363. package/dist/recorders/observability/thinking/thinkingTemplates.js.map +1 -0
  364. package/dist/resilience/fallbackProvider.js +57 -0
  365. package/dist/resilience/fallbackProvider.js.map +1 -0
  366. package/dist/resilience/index.js +71 -0
  367. package/dist/resilience/index.js.map +1 -0
  368. package/dist/resilience/withFallback.js +110 -0
  369. package/dist/resilience/withFallback.js.map +1 -0
  370. package/dist/resilience/withRetry.js +114 -0
  371. package/dist/resilience/withRetry.js.map +1 -0
  372. package/dist/stream.js +152 -0
  373. package/dist/stream.js.map +1 -0
  374. package/dist/types/adapters/llm/AnthropicProvider.d.ts +151 -0
  375. package/dist/types/adapters/llm/AnthropicProvider.d.ts.map +1 -0
  376. package/dist/types/adapters/llm/BedrockProvider.d.ts +127 -0
  377. package/dist/types/adapters/llm/BedrockProvider.d.ts.map +1 -0
  378. package/dist/types/adapters/llm/BrowserAnthropicProvider.d.ts +72 -0
  379. package/dist/types/adapters/llm/BrowserAnthropicProvider.d.ts.map +1 -0
  380. package/dist/types/adapters/llm/BrowserOpenAIProvider.d.ts +52 -0
  381. package/dist/types/adapters/llm/BrowserOpenAIProvider.d.ts.map +1 -0
  382. package/dist/types/adapters/llm/MockProvider.d.ts +109 -0
  383. package/dist/types/adapters/llm/MockProvider.d.ts.map +1 -0
  384. package/dist/types/adapters/llm/OpenAIProvider.d.ts +181 -0
  385. package/dist/types/adapters/llm/OpenAIProvider.d.ts.map +1 -0
  386. package/dist/types/adapters/llm/createProvider.d.ts +57 -0
  387. package/dist/types/adapters/llm/createProvider.d.ts.map +1 -0
  388. package/dist/types/adapters/types.d.ts +159 -0
  389. package/dist/types/adapters/types.d.ts.map +1 -0
  390. package/dist/types/bridge/eventMeta.d.ts +60 -0
  391. package/dist/types/bridge/eventMeta.d.ts.map +1 -0
  392. package/dist/types/conventions.d.ts +71 -0
  393. package/dist/types/conventions.d.ts.map +1 -0
  394. package/dist/types/core/Agent.d.ts +219 -0
  395. package/dist/types/core/Agent.d.ts.map +1 -0
  396. package/dist/types/core/LLMCall.d.ts +78 -0
  397. package/dist/types/core/LLMCall.d.ts.map +1 -0
  398. package/dist/types/core/RunnerBase.d.ts +95 -0
  399. package/dist/types/core/RunnerBase.d.ts.map +1 -0
  400. package/dist/types/core/cost.d.ts +39 -0
  401. package/dist/types/core/cost.d.ts.map +1 -0
  402. package/dist/types/core/pause.d.ts +75 -0
  403. package/dist/types/core/pause.d.ts.map +1 -0
  404. package/dist/types/core/runner.d.ts +105 -0
  405. package/dist/types/core/runner.d.ts.map +1 -0
  406. package/dist/types/core/slots/buildMessagesSlot.d.ts +41 -0
  407. package/dist/types/core/slots/buildMessagesSlot.d.ts.map +1 -0
  408. package/dist/types/core/slots/buildSystemPromptSlot.d.ts +42 -0
  409. package/dist/types/core/slots/buildSystemPromptSlot.d.ts.map +1 -0
  410. package/dist/types/core/slots/buildToolsSlot.d.ts +31 -0
  411. package/dist/types/core/slots/buildToolsSlot.d.ts.map +1 -0
  412. package/dist/types/core/slots/helpers.d.ts +28 -0
  413. package/dist/types/core/slots/helpers.d.ts.map +1 -0
  414. package/dist/types/core/tools.d.ts +73 -0
  415. package/dist/types/core/tools.d.ts.map +1 -0
  416. package/dist/types/core-flow/Conditional.d.ts +76 -0
  417. package/dist/types/core-flow/Conditional.d.ts.map +1 -0
  418. package/dist/types/core-flow/Loop.d.ts +99 -0
  419. package/dist/types/core-flow/Loop.d.ts.map +1 -0
  420. package/dist/types/core-flow/Parallel.d.ts +115 -0
  421. package/dist/types/core-flow/Parallel.d.ts.map +1 -0
  422. package/dist/types/core-flow/Sequence.d.ts +88 -0
  423. package/dist/types/core-flow/Sequence.d.ts.map +1 -0
  424. package/dist/types/events/dispatcher.d.ts +82 -0
  425. package/dist/types/events/dispatcher.d.ts.map +1 -0
  426. package/dist/types/events/payloads.d.ts +332 -0
  427. package/dist/types/events/payloads.d.ts.map +1 -0
  428. package/dist/types/events/registry.d.ts +155 -0
  429. package/dist/types/events/registry.d.ts.map +1 -0
  430. package/dist/types/events/types.d.ts +71 -0
  431. package/dist/types/events/types.d.ts.map +1 -0
  432. package/dist/types/index.d.ts +54 -34
  433. package/dist/types/index.d.ts.map +1 -1
  434. package/dist/types/injection-engine.d.ts +5 -0
  435. package/dist/types/injection-engine.d.ts.map +1 -0
  436. package/dist/types/lib/injection-engine/buildInjectionEngineSubflow.d.ts +46 -0
  437. package/dist/types/lib/injection-engine/buildInjectionEngineSubflow.d.ts.map +1 -0
  438. package/dist/types/lib/injection-engine/evaluator.d.ts +25 -0
  439. package/dist/types/lib/injection-engine/evaluator.d.ts.map +1 -0
  440. package/dist/types/lib/injection-engine/factories/defineFact.d.ts +52 -0
  441. package/dist/types/lib/injection-engine/factories/defineFact.d.ts.map +1 -0
  442. package/dist/types/lib/injection-engine/factories/defineInstruction.d.ts +68 -0
  443. package/dist/types/lib/injection-engine/factories/defineInstruction.d.ts.map +1 -0
  444. package/dist/types/lib/injection-engine/factories/defineSkill.d.ts +47 -0
  445. package/dist/types/lib/injection-engine/factories/defineSkill.d.ts.map +1 -0
  446. package/dist/types/lib/injection-engine/factories/defineSteering.d.ts +28 -0
  447. package/dist/types/lib/injection-engine/factories/defineSteering.d.ts.map +1 -0
  448. package/dist/types/lib/injection-engine/index.d.ts +69 -0
  449. package/dist/types/lib/injection-engine/index.d.ts.map +1 -0
  450. package/dist/types/lib/injection-engine/types.d.ts +175 -0
  451. package/dist/types/lib/injection-engine/types.d.ts.map +1 -0
  452. package/dist/types/memory/beats/extractor.d.ts +1 -1
  453. package/dist/types/memory/beats/extractor.d.ts.map +1 -1
  454. package/dist/types/memory/beats/llmExtractor.d.ts +2 -2
  455. package/dist/types/memory/beats/llmExtractor.d.ts.map +1 -1
  456. package/dist/types/memory/causal/index.d.ts +6 -0
  457. package/dist/types/memory/causal/index.d.ts.map +1 -0
  458. package/dist/types/memory/causal/loadSnapshot.d.ts +52 -0
  459. package/dist/types/memory/causal/loadSnapshot.d.ts.map +1 -0
  460. package/dist/types/memory/causal/snapshotPipeline.d.ts +36 -0
  461. package/dist/types/memory/causal/snapshotPipeline.d.ts.map +1 -0
  462. package/dist/types/memory/causal/types.d.ts +131 -0
  463. package/dist/types/memory/causal/types.d.ts.map +1 -0
  464. package/dist/types/memory/causal/writeSnapshot.d.ts +57 -0
  465. package/dist/types/memory/causal/writeSnapshot.d.ts.map +1 -0
  466. package/dist/types/memory/define.d.ts +78 -0
  467. package/dist/types/memory/define.d.ts.map +1 -0
  468. package/dist/types/memory/define.types.d.ts +284 -0
  469. package/dist/types/memory/define.types.d.ts.map +1 -0
  470. package/dist/types/memory/embedding/embedMessages.d.ts +1 -1
  471. package/dist/types/memory/embedding/embedMessages.d.ts.map +1 -1
  472. package/dist/types/memory/embedding/loadRelevant.d.ts.map +1 -1
  473. package/dist/types/memory/facts/extractor.d.ts +1 -1
  474. package/dist/types/memory/facts/extractor.d.ts.map +1 -1
  475. package/dist/types/memory/facts/llmFactExtractor.d.ts +2 -2
  476. package/dist/types/memory/facts/llmFactExtractor.d.ts.map +1 -1
  477. package/dist/types/memory/facts/patternFactExtractor.d.ts.map +1 -1
  478. package/dist/types/memory/index.d.ts +19 -1
  479. package/dist/types/memory/index.d.ts.map +1 -1
  480. package/dist/types/memory/pipeline/auto.d.ts +1 -1
  481. package/dist/types/memory/pipeline/auto.d.ts.map +1 -1
  482. package/dist/types/memory/pipeline/default.d.ts.map +1 -1
  483. package/dist/types/memory/pipeline/fact.d.ts.map +1 -1
  484. package/dist/types/memory/pipeline/narrative.d.ts +1 -1
  485. package/dist/types/memory/pipeline/narrative.d.ts.map +1 -1
  486. package/dist/types/memory/pipeline/semantic.d.ts +1 -1
  487. package/dist/types/memory/pipeline/semantic.d.ts.map +1 -1
  488. package/dist/types/memory/pipeline/types.d.ts +1 -1
  489. package/dist/types/memory/stages/formatDefault.d.ts +1 -1
  490. package/dist/types/memory/stages/formatDefault.d.ts.map +1 -1
  491. package/dist/types/memory/stages/summarize.d.ts +1 -1
  492. package/dist/types/memory/stages/summarize.d.ts.map +1 -1
  493. package/dist/types/memory/stages/tokenize.d.ts +1 -1
  494. package/dist/types/memory/stages/tokenize.d.ts.map +1 -1
  495. package/dist/types/memory/stages/types.d.ts +1 -1
  496. package/dist/types/memory/stages/types.d.ts.map +1 -1
  497. package/dist/types/memory/stages/writeMessages.d.ts +1 -1
  498. package/dist/types/memory/stages/writeMessages.d.ts.map +1 -1
  499. package/dist/types/observe.d.ts +47 -0
  500. package/dist/types/observe.d.ts.map +1 -0
  501. package/dist/types/patterns/Debate.d.ts +40 -0
  502. package/dist/types/patterns/Debate.d.ts.map +1 -0
  503. package/dist/types/patterns/MapReduce.d.ts +67 -0
  504. package/dist/types/patterns/MapReduce.d.ts.map +1 -0
  505. package/dist/types/patterns/Reflection.d.ts +52 -0
  506. package/dist/types/patterns/Reflection.d.ts.map +1 -0
  507. package/dist/types/patterns/SelfConsistency.d.ts +44 -0
  508. package/dist/types/patterns/SelfConsistency.d.ts.map +1 -0
  509. package/dist/types/patterns/Swarm.d.ts +61 -0
  510. package/dist/types/patterns/Swarm.d.ts.map +1 -0
  511. package/dist/types/patterns/ToT.d.ts +54 -0
  512. package/dist/types/patterns/ToT.d.ts.map +1 -0
  513. package/dist/types/patterns/index.d.ts +18 -17
  514. package/dist/types/patterns/index.d.ts.map +1 -1
  515. package/dist/types/providers.d.ts +28 -0
  516. package/dist/types/providers.d.ts.map +1 -0
  517. package/dist/types/recorders/core/AgentRecorder.d.ts +16 -0
  518. package/dist/types/recorders/core/AgentRecorder.d.ts.map +1 -0
  519. package/dist/types/recorders/core/CompositionRecorder.d.ts +18 -0
  520. package/dist/types/recorders/core/CompositionRecorder.d.ts.map +1 -0
  521. package/dist/types/recorders/core/ContextRecorder.d.ts +50 -0
  522. package/dist/types/recorders/core/ContextRecorder.d.ts.map +1 -0
  523. package/dist/types/recorders/core/CostRecorder.d.ts +15 -0
  524. package/dist/types/recorders/core/CostRecorder.d.ts.map +1 -0
  525. package/dist/types/recorders/core/EmitBridge.d.ts +31 -0
  526. package/dist/types/recorders/core/EmitBridge.d.ts.map +1 -0
  527. package/dist/types/recorders/core/EvalRecorder.d.ts +17 -0
  528. package/dist/types/recorders/core/EvalRecorder.d.ts.map +1 -0
  529. package/dist/types/recorders/core/MemoryRecorder.d.ts +18 -0
  530. package/dist/types/recorders/core/MemoryRecorder.d.ts.map +1 -0
  531. package/dist/types/recorders/core/PermissionRecorder.d.ts +17 -0
  532. package/dist/types/recorders/core/PermissionRecorder.d.ts.map +1 -0
  533. package/dist/types/recorders/core/SkillRecorder.d.ts +15 -0
  534. package/dist/types/recorders/core/SkillRecorder.d.ts.map +1 -0
  535. package/dist/types/recorders/core/StreamRecorder.d.ts +16 -0
  536. package/dist/types/recorders/core/StreamRecorder.d.ts.map +1 -0
  537. package/dist/types/recorders/core/typedEmit.d.ts +35 -0
  538. package/dist/types/recorders/core/typedEmit.d.ts.map +1 -0
  539. package/dist/types/recorders/core/types.d.ts +98 -0
  540. package/dist/types/recorders/core/types.d.ts.map +1 -0
  541. package/dist/types/recorders/observability/BoundaryRecorder.d.ts +301 -0
  542. package/dist/types/recorders/observability/BoundaryRecorder.d.ts.map +1 -0
  543. package/dist/types/recorders/observability/FlowchartRecorder.d.ts +205 -0
  544. package/dist/types/recorders/observability/FlowchartRecorder.d.ts.map +1 -0
  545. package/dist/types/recorders/observability/LoggingRecorder.d.ts +89 -0
  546. package/dist/types/recorders/observability/LoggingRecorder.d.ts.map +1 -0
  547. package/dist/types/recorders/observability/ThinkingRecorder.d.ts +35 -0
  548. package/dist/types/recorders/observability/ThinkingRecorder.d.ts.map +1 -0
  549. package/dist/types/recorders/observability/commentary/commentaryTemplates.d.ts +96 -0
  550. package/dist/types/recorders/observability/commentary/commentaryTemplates.d.ts.map +1 -0
  551. package/dist/types/recorders/observability/thinking/thinkingTemplates.d.ts +107 -0
  552. package/dist/types/recorders/observability/thinking/thinkingTemplates.d.ts.map +1 -0
  553. package/dist/types/resilience/fallbackProvider.d.ts +34 -0
  554. package/dist/types/resilience/fallbackProvider.d.ts.map +1 -0
  555. package/dist/types/resilience/index.d.ts +65 -0
  556. package/dist/types/resilience/index.d.ts.map +1 -0
  557. package/dist/types/resilience/withFallback.d.ts +46 -0
  558. package/dist/types/resilience/withFallback.d.ts.map +1 -0
  559. package/dist/types/resilience/withRetry.d.ts +54 -0
  560. package/dist/types/resilience/withRetry.d.ts.map +1 -0
  561. package/dist/types/stream.d.ts +112 -0
  562. package/dist/types/stream.d.ts.map +1 -0
  563. package/package.json +26 -89
  564. package/dist/adapters/a2a/a2aRunner.js +0 -36
  565. package/dist/adapters/a2a/a2aRunner.js.map +0 -1
  566. package/dist/adapters/anthropic/AnthropicAdapter.js +0 -292
  567. package/dist/adapters/anthropic/AnthropicAdapter.js.map +0 -1
  568. package/dist/adapters/bedrock/BedrockAdapter.js +0 -313
  569. package/dist/adapters/bedrock/BedrockAdapter.js.map +0 -1
  570. package/dist/adapters/browser/BrowserAnthropicAdapter.js +0 -381
  571. package/dist/adapters/browser/BrowserAnthropicAdapter.js.map +0 -1
  572. package/dist/adapters/browser/BrowserOpenAIAdapter.js +0 -317
  573. package/dist/adapters/browser/BrowserOpenAIAdapter.js.map +0 -1
  574. package/dist/adapters/browser/index.js +0 -8
  575. package/dist/adapters/browser/index.js.map +0 -1
  576. package/dist/adapters/createAdapterSubflow.js +0 -46
  577. package/dist/adapters/createAdapterSubflow.js.map +0 -1
  578. package/dist/adapters/createProvider.js +0 -107
  579. package/dist/adapters/createProvider.js.map +0 -1
  580. package/dist/adapters/fallbackProvider.js +0 -94
  581. package/dist/adapters/fallbackProvider.js.map +0 -1
  582. package/dist/adapters/index.js +0 -41
  583. package/dist/adapters/index.js.map +0 -1
  584. package/dist/adapters/mcp/mcpToolProvider.js +0 -44
  585. package/dist/adapters/mcp/mcpToolProvider.js.map +0 -1
  586. package/dist/adapters/mock/MockAdapter.js +0 -66
  587. package/dist/adapters/mock/MockAdapter.js.map +0 -1
  588. package/dist/adapters/mock/MockRetriever.js +0 -61
  589. package/dist/adapters/mock/MockRetriever.js.map +0 -1
  590. package/dist/adapters/openai/OpenAIAdapter.js +0 -278
  591. package/dist/adapters/openai/OpenAIAdapter.js.map +0 -1
  592. package/dist/adapters/resilientProvider.js +0 -93
  593. package/dist/adapters/resilientProvider.js.map +0 -1
  594. package/dist/compositions/index.js +0 -17
  595. package/dist/compositions/index.js.map +0 -1
  596. package/dist/compositions/withCircuitBreaker.js +0 -84
  597. package/dist/compositions/withCircuitBreaker.js.map +0 -1
  598. package/dist/compositions/withFallback.js +0 -33
  599. package/dist/compositions/withFallback.js.map +0 -1
  600. package/dist/compositions/withRetry.js +0 -59
  601. package/dist/compositions/withRetry.js.map +0 -1
  602. package/dist/concepts/Conditional.js +0 -306
  603. package/dist/concepts/Conditional.js.map +0 -1
  604. package/dist/concepts/FlowChart.js +0 -240
  605. package/dist/concepts/FlowChart.js.map +0 -1
  606. package/dist/concepts/LLMCall.js +0 -214
  607. package/dist/concepts/LLMCall.js.map +0 -1
  608. package/dist/concepts/Parallel.js +0 -291
  609. package/dist/concepts/Parallel.js.map +0 -1
  610. package/dist/concepts/RAG.js +0 -244
  611. package/dist/concepts/RAG.js.map +0 -1
  612. package/dist/concepts/Swarm.js +0 -313
  613. package/dist/concepts/Swarm.js.map +0 -1
  614. package/dist/concepts/index.js +0 -26
  615. package/dist/concepts/index.js.map +0 -1
  616. package/dist/concepts/specIcons.js +0 -50
  617. package/dist/concepts/specIcons.js.map +0 -1
  618. package/dist/core/config.js +0 -7
  619. package/dist/core/config.js.map +0 -1
  620. package/dist/core/index.js +0 -14
  621. package/dist/core/index.js.map +0 -1
  622. package/dist/core/providers.js +0 -19
  623. package/dist/core/providers.js.map +0 -1
  624. package/dist/core/recorders.js +0 -7
  625. package/dist/core/recorders.js.map +0 -1
  626. package/dist/esm/adapters/a2a/a2aRunner.js +0 -32
  627. package/dist/esm/adapters/a2a/a2aRunner.js.map +0 -1
  628. package/dist/esm/adapters/anthropic/AnthropicAdapter.js +0 -288
  629. package/dist/esm/adapters/anthropic/AnthropicAdapter.js.map +0 -1
  630. package/dist/esm/adapters/bedrock/BedrockAdapter.js +0 -309
  631. package/dist/esm/adapters/bedrock/BedrockAdapter.js.map +0 -1
  632. package/dist/esm/adapters/browser/BrowserAnthropicAdapter.js +0 -377
  633. package/dist/esm/adapters/browser/BrowserAnthropicAdapter.js.map +0 -1
  634. package/dist/esm/adapters/browser/BrowserOpenAIAdapter.js +0 -313
  635. package/dist/esm/adapters/browser/BrowserOpenAIAdapter.js.map +0 -1
  636. package/dist/esm/adapters/browser/index.js +0 -3
  637. package/dist/esm/adapters/browser/index.js.map +0 -1
  638. package/dist/esm/adapters/createAdapterSubflow.js +0 -42
  639. package/dist/esm/adapters/createAdapterSubflow.js.map +0 -1
  640. package/dist/esm/adapters/createProvider.js +0 -101
  641. package/dist/esm/adapters/createProvider.js.map +0 -1
  642. package/dist/esm/adapters/fallbackProvider.js +0 -90
  643. package/dist/esm/adapters/fallbackProvider.js.map +0 -1
  644. package/dist/esm/adapters/index.js +0 -21
  645. package/dist/esm/adapters/index.js.map +0 -1
  646. package/dist/esm/adapters/mcp/mcpToolProvider.js +0 -40
  647. package/dist/esm/adapters/mcp/mcpToolProvider.js.map +0 -1
  648. package/dist/esm/adapters/mock/MockAdapter.js +0 -61
  649. package/dist/esm/adapters/mock/MockAdapter.js.map +0 -1
  650. package/dist/esm/adapters/mock/MockRetriever.js +0 -56
  651. package/dist/esm/adapters/mock/MockRetriever.js.map +0 -1
  652. package/dist/esm/adapters/openai/OpenAIAdapter.js +0 -274
  653. package/dist/esm/adapters/openai/OpenAIAdapter.js.map +0 -1
  654. package/dist/esm/adapters/resilientProvider.js +0 -89
  655. package/dist/esm/adapters/resilientProvider.js.map +0 -1
  656. package/dist/esm/compositions/index.js +0 -10
  657. package/dist/esm/compositions/index.js.map +0 -1
  658. package/dist/esm/compositions/withCircuitBreaker.js +0 -79
  659. package/dist/esm/compositions/withCircuitBreaker.js.map +0 -1
  660. package/dist/esm/compositions/withFallback.js +0 -29
  661. package/dist/esm/compositions/withFallback.js.map +0 -1
  662. package/dist/esm/compositions/withRetry.js +0 -55
  663. package/dist/esm/compositions/withRetry.js.map +0 -1
  664. package/dist/esm/concepts/Conditional.js +0 -301
  665. package/dist/esm/concepts/Conditional.js.map +0 -1
  666. package/dist/esm/concepts/FlowChart.js +0 -235
  667. package/dist/esm/concepts/FlowChart.js.map +0 -1
  668. package/dist/esm/concepts/LLMCall.js +0 -209
  669. package/dist/esm/concepts/LLMCall.js.map +0 -1
  670. package/dist/esm/concepts/Parallel.js +0 -286
  671. package/dist/esm/concepts/Parallel.js.map +0 -1
  672. package/dist/esm/concepts/RAG.js +0 -239
  673. package/dist/esm/concepts/RAG.js.map +0 -1
  674. package/dist/esm/concepts/Swarm.js +0 -308
  675. package/dist/esm/concepts/Swarm.js.map +0 -1
  676. package/dist/esm/concepts/index.js +0 -9
  677. package/dist/esm/concepts/index.js.map +0 -1
  678. package/dist/esm/concepts/specIcons.js +0 -46
  679. package/dist/esm/concepts/specIcons.js.map +0 -1
  680. package/dist/esm/core/config.js +0 -6
  681. package/dist/esm/core/config.js.map +0 -1
  682. package/dist/esm/core/index.js +0 -13
  683. package/dist/esm/core/index.js.map +0 -1
  684. package/dist/esm/core/providers.js +0 -18
  685. package/dist/esm/core/providers.js.map +0 -1
  686. package/dist/esm/core/recorders.js +0 -6
  687. package/dist/esm/core/recorders.js.map +0 -1
  688. package/dist/esm/executor/agentLoop.js +0 -154
  689. package/dist/esm/executor/agentLoop.js.map +0 -1
  690. package/dist/esm/executor/index.js +0 -5
  691. package/dist/esm/executor/index.js.map +0 -1
  692. package/dist/esm/explain.barrel.js +0 -24
  693. package/dist/esm/explain.barrel.js.map +0 -1
  694. package/dist/esm/exportTrace.js +0 -71
  695. package/dist/esm/exportTrace.js.map +0 -1
  696. package/dist/esm/instructions.barrel.js +0 -22
  697. package/dist/esm/instructions.barrel.js.map +0 -1
  698. package/dist/esm/lib/call/callLLMStage.js +0 -100
  699. package/dist/esm/lib/call/callLLMStage.js.map +0 -1
  700. package/dist/esm/lib/call/helpers.js +0 -574
  701. package/dist/esm/lib/call/helpers.js.map +0 -1
  702. package/dist/esm/lib/call/index.js +0 -6
  703. package/dist/esm/lib/call/index.js.map +0 -1
  704. package/dist/esm/lib/call/parseResponseStage.js +0 -63
  705. package/dist/esm/lib/call/parseResponseStage.js.map +0 -1
  706. package/dist/esm/lib/call/streamingCallLLMStage.js +0 -152
  707. package/dist/esm/lib/call/streamingCallLLMStage.js.map +0 -1
  708. package/dist/esm/lib/call/toolExecutionSubflow.js +0 -198
  709. package/dist/esm/lib/call/toolExecutionSubflow.js.map +0 -1
  710. package/dist/esm/lib/call/types.js +0 -10
  711. package/dist/esm/lib/call/types.js.map +0 -1
  712. package/dist/esm/lib/concepts/Agent.js +0 -7
  713. package/dist/esm/lib/concepts/Agent.js.map +0 -1
  714. package/dist/esm/lib/concepts/AgentBuilder.js +0 -430
  715. package/dist/esm/lib/concepts/AgentBuilder.js.map +0 -1
  716. package/dist/esm/lib/concepts/AgentRunner.js +0 -640
  717. package/dist/esm/lib/concepts/AgentRunner.js.map +0 -1
  718. package/dist/esm/lib/concepts/index.js +0 -2
  719. package/dist/esm/lib/concepts/index.js.map +0 -1
  720. package/dist/esm/lib/instructions/InstructionRecorder.js +0 -125
  721. package/dist/esm/lib/instructions/InstructionRecorder.js.map +0 -1
  722. package/dist/esm/lib/instructions/agentInstruction.js +0 -141
  723. package/dist/esm/lib/instructions/agentInstruction.js.map +0 -1
  724. package/dist/esm/lib/instructions/buildInstructionsToLLMSubflow.js +0 -83
  725. package/dist/esm/lib/instructions/buildInstructionsToLLMSubflow.js.map +0 -1
  726. package/dist/esm/lib/instructions/evaluator.js +0 -196
  727. package/dist/esm/lib/instructions/evaluator.js.map +0 -1
  728. package/dist/esm/lib/instructions/index.js +0 -10
  729. package/dist/esm/lib/instructions/index.js.map +0 -1
  730. package/dist/esm/lib/instructions/inject.js +0 -55
  731. package/dist/esm/lib/instructions/inject.js.map +0 -1
  732. package/dist/esm/lib/instructions/preview.js +0 -86
  733. package/dist/esm/lib/instructions/preview.js.map +0 -1
  734. package/dist/esm/lib/instructions/strictFollowUp.js +0 -157
  735. package/dist/esm/lib/instructions/strictFollowUp.js.map +0 -1
  736. package/dist/esm/lib/instructions/template.js +0 -82
  737. package/dist/esm/lib/instructions/template.js.map +0 -1
  738. package/dist/esm/lib/instructions/types.js +0 -83
  739. package/dist/esm/lib/instructions/types.js.map +0 -1
  740. package/dist/esm/lib/loop/buildAgentLoop.js +0 -628
  741. package/dist/esm/lib/loop/buildAgentLoop.js.map +0 -1
  742. package/dist/esm/lib/loop/index.js +0 -3
  743. package/dist/esm/lib/loop/index.js.map +0 -1
  744. package/dist/esm/lib/loop/types.js +0 -71
  745. package/dist/esm/lib/loop/types.js.map +0 -1
  746. package/dist/esm/lib/narrative/agentRenderer.js +0 -364
  747. package/dist/esm/lib/narrative/agentRenderer.js.map +0 -1
  748. package/dist/esm/lib/narrative/index.js +0 -2
  749. package/dist/esm/lib/narrative/index.js.map +0 -1
  750. package/dist/esm/lib/skills/defineSkill.js +0 -13
  751. package/dist/esm/lib/skills/defineSkill.js.map +0 -1
  752. package/dist/esm/lib/skills/index.js +0 -5
  753. package/dist/esm/lib/skills/index.js.map +0 -1
  754. package/dist/esm/lib/skills/registry.js +0 -258
  755. package/dist/esm/lib/skills/registry.js.map +0 -1
  756. package/dist/esm/lib/skills/renderBody.js +0 -34
  757. package/dist/esm/lib/skills/renderBody.js.map +0 -1
  758. package/dist/esm/lib/skills/surfaceMode.js +0 -52
  759. package/dist/esm/lib/skills/surfaceMode.js.map +0 -1
  760. package/dist/esm/lib/skills/types.js +0 -2
  761. package/dist/esm/lib/skills/types.js.map +0 -1
  762. package/dist/esm/lib/slots/helpers.js +0 -23
  763. package/dist/esm/lib/slots/helpers.js.map +0 -1
  764. package/dist/esm/lib/slots/index.js +0 -4
  765. package/dist/esm/lib/slots/index.js.map +0 -1
  766. package/dist/esm/lib/slots/messages/buildMessagesSubflow.js +0 -66
  767. package/dist/esm/lib/slots/messages/buildMessagesSubflow.js.map +0 -1
  768. package/dist/esm/lib/slots/messages/index.js +0 -2
  769. package/dist/esm/lib/slots/messages/index.js.map +0 -1
  770. package/dist/esm/lib/slots/messages/types.js +0 -11
  771. package/dist/esm/lib/slots/messages/types.js.map +0 -1
  772. package/dist/esm/lib/slots/system-prompt/buildSystemPromptSubflow.js +0 -65
  773. package/dist/esm/lib/slots/system-prompt/buildSystemPromptSubflow.js.map +0 -1
  774. package/dist/esm/lib/slots/system-prompt/index.js +0 -2
  775. package/dist/esm/lib/slots/system-prompt/index.js.map +0 -1
  776. package/dist/esm/lib/slots/system-prompt/types.js +0 -9
  777. package/dist/esm/lib/slots/system-prompt/types.js.map +0 -1
  778. package/dist/esm/lib/slots/tools/buildToolsSubflow.js +0 -85
  779. package/dist/esm/lib/slots/tools/buildToolsSubflow.js.map +0 -1
  780. package/dist/esm/lib/slots/tools/index.js +0 -2
  781. package/dist/esm/lib/slots/tools/index.js.map +0 -1
  782. package/dist/esm/lib/slots/tools/types.js +0 -11
  783. package/dist/esm/lib/slots/tools/types.js.map +0 -1
  784. package/dist/esm/lib/swarm/buildSwarmRouting.js +0 -228
  785. package/dist/esm/lib/swarm/buildSwarmRouting.js.map +0 -1
  786. package/dist/esm/lib/swarm/index.js +0 -2
  787. package/dist/esm/lib/swarm/index.js.map +0 -1
  788. package/dist/esm/memory/conversationHelpers.js +0 -31
  789. package/dist/esm/memory/conversationHelpers.js.map +0 -1
  790. package/dist/esm/memory.barrel.js +0 -48
  791. package/dist/esm/memory.barrel.js.map +0 -1
  792. package/dist/esm/models/index.js +0 -3
  793. package/dist/esm/models/index.js.map +0 -1
  794. package/dist/esm/models/pricing.js +0 -23
  795. package/dist/esm/models/pricing.js.map +0 -1
  796. package/dist/esm/models/providers.js +0 -42
  797. package/dist/esm/models/providers.js.map +0 -1
  798. package/dist/esm/models/types.js +0 -6
  799. package/dist/esm/models/types.js.map +0 -1
  800. package/dist/esm/observe.barrel.js +0 -20
  801. package/dist/esm/observe.barrel.js.map +0 -1
  802. package/dist/esm/patterns/mapReduce.js +0 -60
  803. package/dist/esm/patterns/mapReduce.js.map +0 -1
  804. package/dist/esm/patterns/planExecute.js +0 -43
  805. package/dist/esm/patterns/planExecute.js.map +0 -1
  806. package/dist/esm/patterns/reflexion.js +0 -58
  807. package/dist/esm/patterns/reflexion.js.map +0 -1
  808. package/dist/esm/patterns/treeOfThoughts.js +0 -71
  809. package/dist/esm/patterns/treeOfThoughts.js.map +0 -1
  810. package/dist/esm/patterns.barrel.js +0 -8
  811. package/dist/esm/patterns.barrel.js.map +0 -1
  812. package/dist/esm/providers/index.js +0 -12
  813. package/dist/esm/providers/index.js.map +0 -1
  814. package/dist/esm/providers/messages/charBudget.js +0 -39
  815. package/dist/esm/providers/messages/charBudget.js.map +0 -1
  816. package/dist/esm/providers/messages/compositeMessages.js +0 -33
  817. package/dist/esm/providers/messages/compositeMessages.js.map +0 -1
  818. package/dist/esm/providers/messages/fullHistory.js +0 -19
  819. package/dist/esm/providers/messages/fullHistory.js.map +0 -1
  820. package/dist/esm/providers/messages/index.js +0 -10
  821. package/dist/esm/providers/messages/index.js.map +0 -1
  822. package/dist/esm/providers/messages/slidingWindow.js +0 -32
  823. package/dist/esm/providers/messages/slidingWindow.js.map +0 -1
  824. package/dist/esm/providers/messages/summaryStrategy.js +0 -53
  825. package/dist/esm/providers/messages/summaryStrategy.js.map +0 -1
  826. package/dist/esm/providers/messages/withToolPairSafety.js +0 -76
  827. package/dist/esm/providers/messages/withToolPairSafety.js.map +0 -1
  828. package/dist/esm/providers/prompt/compositePrompt.js +0 -28
  829. package/dist/esm/providers/prompt/compositePrompt.js.map +0 -1
  830. package/dist/esm/providers/prompt/index.js +0 -8
  831. package/dist/esm/providers/prompt/index.js.map +0 -1
  832. package/dist/esm/providers/prompt/skillBasedPrompt.js +0 -37
  833. package/dist/esm/providers/prompt/skillBasedPrompt.js.map +0 -1
  834. package/dist/esm/providers/prompt/static.js +0 -9
  835. package/dist/esm/providers/prompt/static.js.map +0 -1
  836. package/dist/esm/providers/prompt/template.js +0 -20
  837. package/dist/esm/providers/prompt/template.js.map +0 -1
  838. package/dist/esm/providers/tools/PermissionPolicy.js +0 -100
  839. package/dist/esm/providers/tools/PermissionPolicy.js.map +0 -1
  840. package/dist/esm/providers/tools/agentAsTool.js +0 -47
  841. package/dist/esm/providers/tools/agentAsTool.js.map +0 -1
  842. package/dist/esm/providers/tools/compositeTools.js +0 -49
  843. package/dist/esm/providers/tools/compositeTools.js.map +0 -1
  844. package/dist/esm/providers/tools/dynamicTools.js +0 -41
  845. package/dist/esm/providers/tools/dynamicTools.js.map +0 -1
  846. package/dist/esm/providers/tools/gatedTools.js +0 -91
  847. package/dist/esm/providers/tools/gatedTools.js.map +0 -1
  848. package/dist/esm/providers/tools/index.js +0 -11
  849. package/dist/esm/providers/tools/index.js.map +0 -1
  850. package/dist/esm/providers/tools/noTools.js +0 -9
  851. package/dist/esm/providers/tools/noTools.js.map +0 -1
  852. package/dist/esm/providers/tools/staticTools.js +0 -25
  853. package/dist/esm/providers/tools/staticTools.js.map +0 -1
  854. package/dist/esm/providers.barrel.js +0 -32
  855. package/dist/esm/providers.barrel.js.map +0 -1
  856. package/dist/esm/recorders/AgentTimelineRecorder.js +0 -1107
  857. package/dist/esm/recorders/AgentTimelineRecorder.js.map +0 -1
  858. package/dist/esm/recorders/CompositeRecorder.js +0 -65
  859. package/dist/esm/recorders/CompositeRecorder.js.map +0 -1
  860. package/dist/esm/recorders/ContextEngineeringRecorder.js +0 -155
  861. package/dist/esm/recorders/ContextEngineeringRecorder.js.map +0 -1
  862. package/dist/esm/recorders/CostRecorder.js +0 -51
  863. package/dist/esm/recorders/CostRecorder.js.map +0 -1
  864. package/dist/esm/recorders/ExplainRecorder.js +0 -148
  865. package/dist/esm/recorders/ExplainRecorder.js.map +0 -1
  866. package/dist/esm/recorders/GuardrailRecorder.js +0 -58
  867. package/dist/esm/recorders/GuardrailRecorder.js.map +0 -1
  868. package/dist/esm/recorders/OTelRecorder.js +0 -82
  869. package/dist/esm/recorders/OTelRecorder.js.map +0 -1
  870. package/dist/esm/recorders/PermissionRecorder.js +0 -86
  871. package/dist/esm/recorders/PermissionRecorder.js.map +0 -1
  872. package/dist/esm/recorders/QualityRecorder.js +0 -48
  873. package/dist/esm/recorders/QualityRecorder.js.map +0 -1
  874. package/dist/esm/recorders/RecorderBridge.js +0 -99
  875. package/dist/esm/recorders/RecorderBridge.js.map +0 -1
  876. package/dist/esm/recorders/TokenRecorder.js +0 -74
  877. package/dist/esm/recorders/TokenRecorder.js.map +0 -1
  878. package/dist/esm/recorders/ToolUsageRecorder.js +0 -58
  879. package/dist/esm/recorders/ToolUsageRecorder.js.map +0 -1
  880. package/dist/esm/recorders/TurnRecorder.js +0 -83
  881. package/dist/esm/recorders/TurnRecorder.js.map +0 -1
  882. package/dist/esm/recorders/agentObservability.js +0 -53
  883. package/dist/esm/recorders/agentObservability.js.map +0 -1
  884. package/dist/esm/recorders/attachRecorderHelper.js +0 -30
  885. package/dist/esm/recorders/attachRecorderHelper.js.map +0 -1
  886. package/dist/esm/recorders/forwardEmitRecorders.js +0 -29
  887. package/dist/esm/recorders/forwardEmitRecorders.js.map +0 -1
  888. package/dist/esm/recorders/index.js +0 -15
  889. package/dist/esm/recorders/index.js.map +0 -1
  890. package/dist/esm/resilience.barrel.js +0 -17
  891. package/dist/esm/resilience.barrel.js.map +0 -1
  892. package/dist/esm/scope/AgentScope.js +0 -135
  893. package/dist/esm/scope/AgentScope.js.map +0 -1
  894. package/dist/esm/scope/index.js +0 -2
  895. package/dist/esm/scope/index.js.map +0 -1
  896. package/dist/esm/scope/types.js +0 -37
  897. package/dist/esm/scope/types.js.map +0 -1
  898. package/dist/esm/security.barrel.js +0 -17
  899. package/dist/esm/security.barrel.js.map +0 -1
  900. package/dist/esm/skills.barrel.js +0 -42
  901. package/dist/esm/skills.barrel.js.map +0 -1
  902. package/dist/esm/stages/augmentPrompt.js +0 -61
  903. package/dist/esm/stages/augmentPrompt.js.map +0 -1
  904. package/dist/esm/stages/callLLM.js +0 -15
  905. package/dist/esm/stages/callLLM.js.map +0 -1
  906. package/dist/esm/stages/finalize.js +0 -12
  907. package/dist/esm/stages/finalize.js.map +0 -1
  908. package/dist/esm/stages/helpers.js +0 -58
  909. package/dist/esm/stages/helpers.js.map +0 -1
  910. package/dist/esm/stages/index.js +0 -8
  911. package/dist/esm/stages/index.js.map +0 -1
  912. package/dist/esm/stages/parseResponse.js +0 -25
  913. package/dist/esm/stages/parseResponse.js.map +0 -1
  914. package/dist/esm/stages/retrieve.js +0 -28
  915. package/dist/esm/stages/retrieve.js.map +0 -1
  916. package/dist/esm/stages/runnerAsStage.js +0 -66
  917. package/dist/esm/stages/runnerAsStage.js.map +0 -1
  918. package/dist/esm/stream.barrel.js +0 -18
  919. package/dist/esm/stream.barrel.js.map +0 -1
  920. package/dist/esm/streaming/EventDispatcher.js +0 -44
  921. package/dist/esm/streaming/EventDispatcher.js.map +0 -1
  922. package/dist/esm/streaming/StreamEmitter.js +0 -43
  923. package/dist/esm/streaming/StreamEmitter.js.map +0 -1
  924. package/dist/esm/streaming/StreamEventRecorder.js +0 -55
  925. package/dist/esm/streaming/StreamEventRecorder.js.map +0 -1
  926. package/dist/esm/streaming/index.js +0 -4
  927. package/dist/esm/streaming/index.js.map +0 -1
  928. package/dist/esm/subflows/index.js +0 -2
  929. package/dist/esm/subflows/index.js.map +0 -1
  930. package/dist/esm/tools/ToolRegistry.js +0 -102
  931. package/dist/esm/tools/ToolRegistry.js.map +0 -1
  932. package/dist/esm/tools/askHuman.js +0 -63
  933. package/dist/esm/tools/askHuman.js.map +0 -1
  934. package/dist/esm/tools/index.js +0 -3
  935. package/dist/esm/tools/index.js.map +0 -1
  936. package/dist/esm/tools/validateInput.js +0 -62
  937. package/dist/esm/tools/validateInput.js.map +0 -1
  938. package/dist/esm/tools/zodToJsonSchema.js +0 -66
  939. package/dist/esm/tools/zodToJsonSchema.js.map +0 -1
  940. package/dist/esm/types/adapter.js +0 -11
  941. package/dist/esm/types/adapter.js.map +0 -1
  942. package/dist/esm/types/agent.js +0 -5
  943. package/dist/esm/types/agent.js.map +0 -1
  944. package/dist/esm/types/content.js +0 -82
  945. package/dist/esm/types/content.js.map +0 -1
  946. package/dist/esm/types/errors.js +0 -74
  947. package/dist/esm/types/errors.js.map +0 -1
  948. package/dist/esm/types/index.js +0 -5
  949. package/dist/esm/types/index.js.map +0 -1
  950. package/dist/esm/types/llm.js +0 -6
  951. package/dist/esm/types/llm.js.map +0 -1
  952. package/dist/esm/types/messages.js +0 -24
  953. package/dist/esm/types/messages.js.map +0 -1
  954. package/dist/esm/types/multiAgent.js +0 -5
  955. package/dist/esm/types/multiAgent.js.map +0 -1
  956. package/dist/esm/types/retriever.js +0 -6
  957. package/dist/esm/types/retriever.js.map +0 -1
  958. package/dist/esm/types/tools.js +0 -5
  959. package/dist/esm/types/tools.js.map +0 -1
  960. package/dist/executor/agentLoop.js +0 -158
  961. package/dist/executor/agentLoop.js.map +0 -1
  962. package/dist/executor/index.js +0 -9
  963. package/dist/executor/index.js.map +0 -1
  964. package/dist/explain.barrel.js +0 -29
  965. package/dist/explain.barrel.js.map +0 -1
  966. package/dist/exportTrace.js +0 -75
  967. package/dist/exportTrace.js.map +0 -1
  968. package/dist/instructions.barrel.js +0 -30
  969. package/dist/instructions.barrel.js.map +0 -1
  970. package/dist/lib/call/callLLMStage.js +0 -104
  971. package/dist/lib/call/callLLMStage.js.map +0 -1
  972. package/dist/lib/call/helpers.js +0 -581
  973. package/dist/lib/call/helpers.js.map +0 -1
  974. package/dist/lib/call/index.js +0 -15
  975. package/dist/lib/call/index.js.map +0 -1
  976. package/dist/lib/call/parseResponseStage.js +0 -67
  977. package/dist/lib/call/parseResponseStage.js.map +0 -1
  978. package/dist/lib/call/streamingCallLLMStage.js +0 -156
  979. package/dist/lib/call/streamingCallLLMStage.js.map +0 -1
  980. package/dist/lib/call/toolExecutionSubflow.js +0 -202
  981. package/dist/lib/call/toolExecutionSubflow.js.map +0 -1
  982. package/dist/lib/call/types.js +0 -11
  983. package/dist/lib/call/types.js.map +0 -1
  984. package/dist/lib/concepts/Agent.js +0 -12
  985. package/dist/lib/concepts/Agent.js.map +0 -1
  986. package/dist/lib/concepts/AgentBuilder.js +0 -434
  987. package/dist/lib/concepts/AgentBuilder.js.map +0 -1
  988. package/dist/lib/concepts/AgentRunner.js +0 -644
  989. package/dist/lib/concepts/AgentRunner.js.map +0 -1
  990. package/dist/lib/concepts/index.js +0 -7
  991. package/dist/lib/concepts/index.js.map +0 -1
  992. package/dist/lib/instructions/InstructionRecorder.js +0 -129
  993. package/dist/lib/instructions/InstructionRecorder.js.map +0 -1
  994. package/dist/lib/instructions/agentInstruction.js +0 -146
  995. package/dist/lib/instructions/agentInstruction.js.map +0 -1
  996. package/dist/lib/instructions/buildInstructionsToLLMSubflow.js +0 -87
  997. package/dist/lib/instructions/buildInstructionsToLLMSubflow.js.map +0 -1
  998. package/dist/lib/instructions/evaluator.js +0 -202
  999. package/dist/lib/instructions/evaluator.js.map +0 -1
  1000. package/dist/lib/instructions/index.js +0 -27
  1001. package/dist/lib/instructions/index.js.map +0 -1
  1002. package/dist/lib/instructions/inject.js +0 -59
  1003. package/dist/lib/instructions/inject.js.map +0 -1
  1004. package/dist/lib/instructions/preview.js +0 -90
  1005. package/dist/lib/instructions/preview.js.map +0 -1
  1006. package/dist/lib/instructions/strictFollowUp.js +0 -162
  1007. package/dist/lib/instructions/strictFollowUp.js.map +0 -1
  1008. package/dist/lib/instructions/template.js +0 -86
  1009. package/dist/lib/instructions/template.js.map +0 -1
  1010. package/dist/lib/instructions/types.js +0 -88
  1011. package/dist/lib/instructions/types.js.map +0 -1
  1012. package/dist/lib/loop/buildAgentLoop.js +0 -632
  1013. package/dist/lib/loop/buildAgentLoop.js.map +0 -1
  1014. package/dist/lib/loop/index.js +0 -9
  1015. package/dist/lib/loop/index.js.map +0 -1
  1016. package/dist/lib/loop/types.js +0 -74
  1017. package/dist/lib/loop/types.js.map +0 -1
  1018. package/dist/lib/narrative/agentRenderer.js +0 -368
  1019. package/dist/lib/narrative/agentRenderer.js.map +0 -1
  1020. package/dist/lib/narrative/index.js +0 -6
  1021. package/dist/lib/narrative/index.js.map +0 -1
  1022. package/dist/lib/skills/defineSkill.js +0 -17
  1023. package/dist/lib/skills/defineSkill.js.map +0 -1
  1024. package/dist/lib/skills/index.js +0 -15
  1025. package/dist/lib/skills/index.js.map +0 -1
  1026. package/dist/lib/skills/registry.js +0 -262
  1027. package/dist/lib/skills/registry.js.map +0 -1
  1028. package/dist/lib/skills/renderBody.js +0 -39
  1029. package/dist/lib/skills/renderBody.js.map +0 -1
  1030. package/dist/lib/skills/surfaceMode.js +0 -58
  1031. package/dist/lib/skills/surfaceMode.js.map +0 -1
  1032. package/dist/lib/skills/types.js +0 -3
  1033. package/dist/lib/skills/types.js.map +0 -1
  1034. package/dist/lib/slots/helpers.js +0 -28
  1035. package/dist/lib/slots/helpers.js.map +0 -1
  1036. package/dist/lib/slots/index.js +0 -10
  1037. package/dist/lib/slots/index.js.map +0 -1
  1038. package/dist/lib/slots/messages/buildMessagesSubflow.js +0 -70
  1039. package/dist/lib/slots/messages/buildMessagesSubflow.js.map +0 -1
  1040. package/dist/lib/slots/messages/index.js +0 -6
  1041. package/dist/lib/slots/messages/index.js.map +0 -1
  1042. package/dist/lib/slots/messages/types.js +0 -12
  1043. package/dist/lib/slots/messages/types.js.map +0 -1
  1044. package/dist/lib/slots/system-prompt/buildSystemPromptSubflow.js +0 -69
  1045. package/dist/lib/slots/system-prompt/buildSystemPromptSubflow.js.map +0 -1
  1046. package/dist/lib/slots/system-prompt/index.js +0 -6
  1047. package/dist/lib/slots/system-prompt/index.js.map +0 -1
  1048. package/dist/lib/slots/system-prompt/types.js +0 -10
  1049. package/dist/lib/slots/system-prompt/types.js.map +0 -1
  1050. package/dist/lib/slots/tools/buildToolsSubflow.js +0 -89
  1051. package/dist/lib/slots/tools/buildToolsSubflow.js.map +0 -1
  1052. package/dist/lib/slots/tools/index.js +0 -6
  1053. package/dist/lib/slots/tools/index.js.map +0 -1
  1054. package/dist/lib/slots/tools/types.js +0 -12
  1055. package/dist/lib/slots/tools/types.js.map +0 -1
  1056. package/dist/lib/swarm/buildSwarmRouting.js +0 -232
  1057. package/dist/lib/swarm/buildSwarmRouting.js.map +0 -1
  1058. package/dist/lib/swarm/index.js +0 -6
  1059. package/dist/lib/swarm/index.js.map +0 -1
  1060. package/dist/memory/conversationHelpers.js +0 -39
  1061. package/dist/memory/conversationHelpers.js.map +0 -1
  1062. package/dist/memory.barrel.js +0 -92
  1063. package/dist/memory.barrel.js.map +0 -1
  1064. package/dist/models/index.js +0 -12
  1065. package/dist/models/index.js.map +0 -1
  1066. package/dist/models/pricing.js +0 -27
  1067. package/dist/models/pricing.js.map +0 -1
  1068. package/dist/models/providers.js +0 -49
  1069. package/dist/models/providers.js.map +0 -1
  1070. package/dist/models/types.js +0 -7
  1071. package/dist/models/types.js.map +0 -1
  1072. package/dist/observe.barrel.js +0 -37
  1073. package/dist/observe.barrel.js.map +0 -1
  1074. package/dist/patterns/mapReduce.js +0 -64
  1075. package/dist/patterns/mapReduce.js.map +0 -1
  1076. package/dist/patterns/planExecute.js +0 -47
  1077. package/dist/patterns/planExecute.js.map +0 -1
  1078. package/dist/patterns/reflexion.js +0 -62
  1079. package/dist/patterns/reflexion.js.map +0 -1
  1080. package/dist/patterns/treeOfThoughts.js +0 -75
  1081. package/dist/patterns/treeOfThoughts.js.map +0 -1
  1082. package/dist/patterns.barrel.js +0 -24
  1083. package/dist/patterns.barrel.js.map +0 -1
  1084. package/dist/providers/index.js +0 -32
  1085. package/dist/providers/index.js.map +0 -1
  1086. package/dist/providers/messages/charBudget.js +0 -43
  1087. package/dist/providers/messages/charBudget.js.map +0 -1
  1088. package/dist/providers/messages/compositeMessages.js +0 -37
  1089. package/dist/providers/messages/compositeMessages.js.map +0 -1
  1090. package/dist/providers/messages/fullHistory.js +0 -23
  1091. package/dist/providers/messages/fullHistory.js.map +0 -1
  1092. package/dist/providers/messages/index.js +0 -19
  1093. package/dist/providers/messages/index.js.map +0 -1
  1094. package/dist/providers/messages/slidingWindow.js +0 -36
  1095. package/dist/providers/messages/slidingWindow.js.map +0 -1
  1096. package/dist/providers/messages/summaryStrategy.js +0 -57
  1097. package/dist/providers/messages/summaryStrategy.js.map +0 -1
  1098. package/dist/providers/messages/withToolPairSafety.js +0 -80
  1099. package/dist/providers/messages/withToolPairSafety.js.map +0 -1
  1100. package/dist/providers/prompt/compositePrompt.js +0 -32
  1101. package/dist/providers/prompt/compositePrompt.js.map +0 -1
  1102. package/dist/providers/prompt/index.js +0 -15
  1103. package/dist/providers/prompt/index.js.map +0 -1
  1104. package/dist/providers/prompt/skillBasedPrompt.js +0 -41
  1105. package/dist/providers/prompt/skillBasedPrompt.js.map +0 -1
  1106. package/dist/providers/prompt/static.js +0 -13
  1107. package/dist/providers/prompt/static.js.map +0 -1
  1108. package/dist/providers/prompt/template.js +0 -24
  1109. package/dist/providers/prompt/template.js.map +0 -1
  1110. package/dist/providers/tools/PermissionPolicy.js +0 -104
  1111. package/dist/providers/tools/PermissionPolicy.js.map +0 -1
  1112. package/dist/providers/tools/agentAsTool.js +0 -51
  1113. package/dist/providers/tools/agentAsTool.js.map +0 -1
  1114. package/dist/providers/tools/compositeTools.js +0 -53
  1115. package/dist/providers/tools/compositeTools.js.map +0 -1
  1116. package/dist/providers/tools/dynamicTools.js +0 -45
  1117. package/dist/providers/tools/dynamicTools.js.map +0 -1
  1118. package/dist/providers/tools/gatedTools.js +0 -95
  1119. package/dist/providers/tools/gatedTools.js.map +0 -1
  1120. package/dist/providers/tools/index.js +0 -21
  1121. package/dist/providers/tools/index.js.map +0 -1
  1122. package/dist/providers/tools/noTools.js +0 -13
  1123. package/dist/providers/tools/noTools.js.map +0 -1
  1124. package/dist/providers/tools/staticTools.js +0 -29
  1125. package/dist/providers/tools/staticTools.js.map +0 -1
  1126. package/dist/providers.barrel.js +0 -68
  1127. package/dist/providers.barrel.js.map +0 -1
  1128. package/dist/recorders/AgentTimelineRecorder.js +0 -1112
  1129. package/dist/recorders/AgentTimelineRecorder.js.map +0 -1
  1130. package/dist/recorders/CompositeRecorder.js +0 -69
  1131. package/dist/recorders/CompositeRecorder.js.map +0 -1
  1132. package/dist/recorders/ContextEngineeringRecorder.js +0 -159
  1133. package/dist/recorders/ContextEngineeringRecorder.js.map +0 -1
  1134. package/dist/recorders/CostRecorder.js +0 -55
  1135. package/dist/recorders/CostRecorder.js.map +0 -1
  1136. package/dist/recorders/ExplainRecorder.js +0 -152
  1137. package/dist/recorders/ExplainRecorder.js.map +0 -1
  1138. package/dist/recorders/GuardrailRecorder.js +0 -62
  1139. package/dist/recorders/GuardrailRecorder.js.map +0 -1
  1140. package/dist/recorders/OTelRecorder.js +0 -86
  1141. package/dist/recorders/OTelRecorder.js.map +0 -1
  1142. package/dist/recorders/PermissionRecorder.js +0 -90
  1143. package/dist/recorders/PermissionRecorder.js.map +0 -1
  1144. package/dist/recorders/QualityRecorder.js +0 -52
  1145. package/dist/recorders/QualityRecorder.js.map +0 -1
  1146. package/dist/recorders/RecorderBridge.js +0 -103
  1147. package/dist/recorders/RecorderBridge.js.map +0 -1
  1148. package/dist/recorders/TokenRecorder.js +0 -78
  1149. package/dist/recorders/TokenRecorder.js.map +0 -1
  1150. package/dist/recorders/ToolUsageRecorder.js +0 -62
  1151. package/dist/recorders/ToolUsageRecorder.js.map +0 -1
  1152. package/dist/recorders/TurnRecorder.js +0 -87
  1153. package/dist/recorders/TurnRecorder.js.map +0 -1
  1154. package/dist/recorders/agentObservability.js +0 -57
  1155. package/dist/recorders/agentObservability.js.map +0 -1
  1156. package/dist/recorders/attachRecorderHelper.js +0 -34
  1157. package/dist/recorders/attachRecorderHelper.js.map +0 -1
  1158. package/dist/recorders/forwardEmitRecorders.js +0 -33
  1159. package/dist/recorders/forwardEmitRecorders.js.map +0 -1
  1160. package/dist/recorders/index.js +0 -30
  1161. package/dist/recorders/index.js.map +0 -1
  1162. package/dist/resilience.barrel.js +0 -28
  1163. package/dist/resilience.barrel.js.map +0 -1
  1164. package/dist/scope/AgentScope.js +0 -138
  1165. package/dist/scope/AgentScope.js.map +0 -1
  1166. package/dist/scope/index.js +0 -10
  1167. package/dist/scope/index.js.map +0 -1
  1168. package/dist/scope/types.js +0 -40
  1169. package/dist/scope/types.js.map +0 -1
  1170. package/dist/security.barrel.js +0 -22
  1171. package/dist/security.barrel.js.map +0 -1
  1172. package/dist/skills.barrel.js +0 -48
  1173. package/dist/skills.barrel.js.map +0 -1
  1174. package/dist/stages/augmentPrompt.js +0 -65
  1175. package/dist/stages/augmentPrompt.js.map +0 -1
  1176. package/dist/stages/callLLM.js +0 -19
  1177. package/dist/stages/callLLM.js.map +0 -1
  1178. package/dist/stages/finalize.js +0 -16
  1179. package/dist/stages/finalize.js.map +0 -1
  1180. package/dist/stages/helpers.js +0 -63
  1181. package/dist/stages/helpers.js.map +0 -1
  1182. package/dist/stages/index.js +0 -19
  1183. package/dist/stages/index.js.map +0 -1
  1184. package/dist/stages/parseResponse.js +0 -29
  1185. package/dist/stages/parseResponse.js.map +0 -1
  1186. package/dist/stages/retrieve.js +0 -32
  1187. package/dist/stages/retrieve.js.map +0 -1
  1188. package/dist/stages/runnerAsStage.js +0 -70
  1189. package/dist/stages/runnerAsStage.js.map +0 -1
  1190. package/dist/stream.barrel.js +0 -23
  1191. package/dist/stream.barrel.js.map +0 -1
  1192. package/dist/streaming/EventDispatcher.js +0 -48
  1193. package/dist/streaming/EventDispatcher.js.map +0 -1
  1194. package/dist/streaming/StreamEmitter.js +0 -48
  1195. package/dist/streaming/StreamEmitter.js.map +0 -1
  1196. package/dist/streaming/StreamEventRecorder.js +0 -59
  1197. package/dist/streaming/StreamEventRecorder.js.map +0 -1
  1198. package/dist/streaming/index.js +0 -12
  1199. package/dist/streaming/index.js.map +0 -1
  1200. package/dist/subflows/index.js +0 -3
  1201. package/dist/subflows/index.js.map +0 -1
  1202. package/dist/tools/ToolRegistry.js +0 -107
  1203. package/dist/tools/ToolRegistry.js.map +0 -1
  1204. package/dist/tools/askHuman.js +0 -68
  1205. package/dist/tools/askHuman.js.map +0 -1
  1206. package/dist/tools/index.js +0 -9
  1207. package/dist/tools/index.js.map +0 -1
  1208. package/dist/tools/validateInput.js +0 -67
  1209. package/dist/tools/validateInput.js.map +0 -1
  1210. package/dist/tools/zodToJsonSchema.js +0 -71
  1211. package/dist/tools/zodToJsonSchema.js.map +0 -1
  1212. package/dist/types/adapter.js +0 -14
  1213. package/dist/types/adapter.js.map +0 -1
  1214. package/dist/types/adapters/a2a/a2aRunner.d.ts +0 -40
  1215. package/dist/types/adapters/a2a/a2aRunner.d.ts.map +0 -1
  1216. package/dist/types/adapters/anthropic/AnthropicAdapter.d.ts +0 -37
  1217. package/dist/types/adapters/anthropic/AnthropicAdapter.d.ts.map +0 -1
  1218. package/dist/types/adapters/bedrock/BedrockAdapter.d.ts +0 -44
  1219. package/dist/types/adapters/bedrock/BedrockAdapter.d.ts.map +0 -1
  1220. package/dist/types/adapters/browser/BrowserAnthropicAdapter.d.ts +0 -40
  1221. package/dist/types/adapters/browser/BrowserAnthropicAdapter.d.ts.map +0 -1
  1222. package/dist/types/adapters/browser/BrowserOpenAIAdapter.d.ts +0 -46
  1223. package/dist/types/adapters/browser/BrowserOpenAIAdapter.d.ts.map +0 -1
  1224. package/dist/types/adapters/browser/index.d.ts +0 -5
  1225. package/dist/types/adapters/browser/index.d.ts.map +0 -1
  1226. package/dist/types/adapters/createAdapterSubflow.d.ts +0 -36
  1227. package/dist/types/adapters/createAdapterSubflow.d.ts.map +0 -1
  1228. package/dist/types/adapters/createProvider.d.ts +0 -47
  1229. package/dist/types/adapters/createProvider.d.ts.map +0 -1
  1230. package/dist/types/adapters/fallbackProvider.d.ts +0 -45
  1231. package/dist/types/adapters/fallbackProvider.d.ts.map +0 -1
  1232. package/dist/types/adapters/index.d.ts +0 -26
  1233. package/dist/types/adapters/index.d.ts.map +0 -1
  1234. package/dist/types/adapters/mcp/mcpToolProvider.d.ts +0 -41
  1235. package/dist/types/adapters/mcp/mcpToolProvider.d.ts.map +0 -1
  1236. package/dist/types/adapters/mock/MockAdapter.d.ts +0 -51
  1237. package/dist/types/adapters/mock/MockAdapter.d.ts.map +0 -1
  1238. package/dist/types/adapters/mock/MockRetriever.d.ts +0 -43
  1239. package/dist/types/adapters/mock/MockRetriever.d.ts.map +0 -1
  1240. package/dist/types/adapters/openai/OpenAIAdapter.d.ts +0 -47
  1241. package/dist/types/adapters/openai/OpenAIAdapter.d.ts.map +0 -1
  1242. package/dist/types/adapters/resilientProvider.d.ts +0 -33
  1243. package/dist/types/adapters/resilientProvider.d.ts.map +0 -1
  1244. package/dist/types/agent.js +0 -6
  1245. package/dist/types/agent.js.map +0 -1
  1246. package/dist/types/compositions/index.d.ts +0 -13
  1247. package/dist/types/compositions/index.d.ts.map +0 -1
  1248. package/dist/types/compositions/withCircuitBreaker.d.ts +0 -43
  1249. package/dist/types/compositions/withCircuitBreaker.d.ts.map +0 -1
  1250. package/dist/types/compositions/withFallback.d.ts +0 -17
  1251. package/dist/types/compositions/withFallback.d.ts.map +0 -1
  1252. package/dist/types/compositions/withRetry.d.ts +0 -27
  1253. package/dist/types/compositions/withRetry.d.ts.map +0 -1
  1254. package/dist/types/concepts/Conditional.d.ts +0 -133
  1255. package/dist/types/concepts/Conditional.d.ts.map +0 -1
  1256. package/dist/types/concepts/FlowChart.d.ts +0 -68
  1257. package/dist/types/concepts/FlowChart.d.ts.map +0 -1
  1258. package/dist/types/concepts/LLMCall.d.ts +0 -73
  1259. package/dist/types/concepts/LLMCall.d.ts.map +0 -1
  1260. package/dist/types/concepts/Parallel.d.ts +0 -122
  1261. package/dist/types/concepts/Parallel.d.ts.map +0 -1
  1262. package/dist/types/concepts/RAG.d.ts +0 -89
  1263. package/dist/types/concepts/RAG.d.ts.map +0 -1
  1264. package/dist/types/concepts/Swarm.d.ts +0 -111
  1265. package/dist/types/concepts/Swarm.d.ts.map +0 -1
  1266. package/dist/types/concepts/index.d.ts +0 -14
  1267. package/dist/types/concepts/index.d.ts.map +0 -1
  1268. package/dist/types/concepts/specIcons.d.ts +0 -14
  1269. package/dist/types/concepts/specIcons.d.ts.map +0 -1
  1270. package/dist/types/content.js +0 -97
  1271. package/dist/types/content.js.map +0 -1
  1272. package/dist/types/core/config.d.ts +0 -24
  1273. package/dist/types/core/config.d.ts.map +0 -1
  1274. package/dist/types/core/index.d.ts +0 -15
  1275. package/dist/types/core/index.d.ts.map +0 -1
  1276. package/dist/types/core/providers.d.ts +0 -168
  1277. package/dist/types/core/providers.d.ts.map +0 -1
  1278. package/dist/types/core/recorders.d.ts +0 -70
  1279. package/dist/types/core/recorders.d.ts.map +0 -1
  1280. package/dist/types/errors.js +0 -80
  1281. package/dist/types/errors.js.map +0 -1
  1282. package/dist/types/executor/agentLoop.d.ts +0 -37
  1283. package/dist/types/executor/agentLoop.d.ts.map +0 -1
  1284. package/dist/types/executor/index.d.ts +0 -6
  1285. package/dist/types/executor/index.d.ts.map +0 -1
  1286. package/dist/types/explain.barrel.d.ts +0 -25
  1287. package/dist/types/explain.barrel.d.ts.map +0 -1
  1288. package/dist/types/exportTrace.d.ts +0 -84
  1289. package/dist/types/exportTrace.d.ts.map +0 -1
  1290. package/dist/types/index.js +0 -29
  1291. package/dist/types/index.js.map +0 -1
  1292. package/dist/types/instructions.barrel.d.ts +0 -24
  1293. package/dist/types/instructions.barrel.d.ts.map +0 -1
  1294. package/dist/types/lib/call/callLLMStage.d.ts +0 -33
  1295. package/dist/types/lib/call/callLLMStage.d.ts.map +0 -1
  1296. package/dist/types/lib/call/helpers.d.ts +0 -108
  1297. package/dist/types/lib/call/helpers.d.ts.map +0 -1
  1298. package/dist/types/lib/call/index.d.ts +0 -8
  1299. package/dist/types/lib/call/index.d.ts.map +0 -1
  1300. package/dist/types/lib/call/parseResponseStage.d.ts +0 -22
  1301. package/dist/types/lib/call/parseResponseStage.d.ts.map +0 -1
  1302. package/dist/types/lib/call/streamingCallLLMStage.d.ts +0 -23
  1303. package/dist/types/lib/call/streamingCallLLMStage.d.ts.map +0 -1
  1304. package/dist/types/lib/call/toolExecutionSubflow.d.ts +0 -82
  1305. package/dist/types/lib/call/toolExecutionSubflow.d.ts.map +0 -1
  1306. package/dist/types/lib/call/types.d.ts +0 -17
  1307. package/dist/types/lib/call/types.d.ts.map +0 -1
  1308. package/dist/types/lib/concepts/Agent.d.ts +0 -9
  1309. package/dist/types/lib/concepts/Agent.d.ts.map +0 -1
  1310. package/dist/types/lib/concepts/AgentBuilder.d.ts +0 -297
  1311. package/dist/types/lib/concepts/AgentBuilder.d.ts.map +0 -1
  1312. package/dist/types/lib/concepts/AgentRunner.d.ts +0 -241
  1313. package/dist/types/lib/concepts/AgentRunner.d.ts.map +0 -1
  1314. package/dist/types/lib/concepts/index.d.ts +0 -3
  1315. package/dist/types/lib/concepts/index.d.ts.map +0 -1
  1316. package/dist/types/lib/instructions/InstructionRecorder.d.ts +0 -86
  1317. package/dist/types/lib/instructions/InstructionRecorder.d.ts.map +0 -1
  1318. package/dist/types/lib/instructions/agentInstruction.d.ts +0 -150
  1319. package/dist/types/lib/instructions/agentInstruction.d.ts.map +0 -1
  1320. package/dist/types/lib/instructions/buildInstructionsToLLMSubflow.d.ts +0 -56
  1321. package/dist/types/lib/instructions/buildInstructionsToLLMSubflow.d.ts.map +0 -1
  1322. package/dist/types/lib/instructions/evaluator.d.ts +0 -99
  1323. package/dist/types/lib/instructions/evaluator.d.ts.map +0 -1
  1324. package/dist/types/lib/instructions/index.d.ts +0 -18
  1325. package/dist/types/lib/instructions/index.d.ts.map +0 -1
  1326. package/dist/types/lib/instructions/inject.d.ts +0 -54
  1327. package/dist/types/lib/instructions/inject.d.ts.map +0 -1
  1328. package/dist/types/lib/instructions/preview.d.ts +0 -85
  1329. package/dist/types/lib/instructions/preview.d.ts.map +0 -1
  1330. package/dist/types/lib/instructions/strictFollowUp.d.ts +0 -88
  1331. package/dist/types/lib/instructions/strictFollowUp.d.ts.map +0 -1
  1332. package/dist/types/lib/instructions/template.d.ts +0 -52
  1333. package/dist/types/lib/instructions/template.d.ts.map +0 -1
  1334. package/dist/types/lib/instructions/types.d.ts +0 -394
  1335. package/dist/types/lib/instructions/types.d.ts.map +0 -1
  1336. package/dist/types/lib/loop/buildAgentLoop.d.ts +0 -60
  1337. package/dist/types/lib/loop/buildAgentLoop.d.ts.map +0 -1
  1338. package/dist/types/lib/loop/index.d.ts +0 -5
  1339. package/dist/types/lib/loop/index.d.ts.map +0 -1
  1340. package/dist/types/lib/loop/types.d.ts +0 -281
  1341. package/dist/types/lib/loop/types.d.ts.map +0 -1
  1342. package/dist/types/lib/narrative/agentRenderer.d.ts +0 -56
  1343. package/dist/types/lib/narrative/agentRenderer.d.ts.map +0 -1
  1344. package/dist/types/lib/narrative/index.d.ts +0 -3
  1345. package/dist/types/lib/narrative/index.d.ts.map +0 -1
  1346. package/dist/types/lib/skills/defineSkill.d.ts +0 -10
  1347. package/dist/types/lib/skills/defineSkill.d.ts.map +0 -1
  1348. package/dist/types/lib/skills/index.d.ts +0 -6
  1349. package/dist/types/lib/skills/index.d.ts.map +0 -1
  1350. package/dist/types/lib/skills/registry.d.ts +0 -98
  1351. package/dist/types/lib/skills/registry.d.ts.map +0 -1
  1352. package/dist/types/lib/skills/renderBody.d.ts +0 -22
  1353. package/dist/types/lib/skills/renderBody.d.ts.map +0 -1
  1354. package/dist/types/lib/skills/surfaceMode.d.ts +0 -34
  1355. package/dist/types/lib/skills/surfaceMode.d.ts.map +0 -1
  1356. package/dist/types/lib/skills/types.d.ts +0 -164
  1357. package/dist/types/lib/skills/types.d.ts.map +0 -1
  1358. package/dist/types/lib/slots/helpers.d.ts +0 -16
  1359. package/dist/types/lib/slots/helpers.d.ts.map +0 -1
  1360. package/dist/types/lib/slots/index.d.ts +0 -7
  1361. package/dist/types/lib/slots/index.d.ts.map +0 -1
  1362. package/dist/types/lib/slots/messages/buildMessagesSubflow.d.ts +0 -37
  1363. package/dist/types/lib/slots/messages/buildMessagesSubflow.d.ts.map +0 -1
  1364. package/dist/types/lib/slots/messages/index.d.ts +0 -3
  1365. package/dist/types/lib/slots/messages/index.d.ts.map +0 -1
  1366. package/dist/types/lib/slots/messages/types.d.ts +0 -16
  1367. package/dist/types/lib/slots/messages/types.d.ts.map +0 -1
  1368. package/dist/types/lib/slots/system-prompt/buildSystemPromptSubflow.d.ts +0 -27
  1369. package/dist/types/lib/slots/system-prompt/buildSystemPromptSubflow.d.ts.map +0 -1
  1370. package/dist/types/lib/slots/system-prompt/index.d.ts +0 -3
  1371. package/dist/types/lib/slots/system-prompt/index.d.ts.map +0 -1
  1372. package/dist/types/lib/slots/system-prompt/types.d.ts +0 -17
  1373. package/dist/types/lib/slots/system-prompt/types.d.ts.map +0 -1
  1374. package/dist/types/lib/slots/tools/buildToolsSubflow.d.ts +0 -23
  1375. package/dist/types/lib/slots/tools/buildToolsSubflow.d.ts.map +0 -1
  1376. package/dist/types/lib/slots/tools/index.d.ts +0 -3
  1377. package/dist/types/lib/slots/tools/index.d.ts.map +0 -1
  1378. package/dist/types/lib/slots/tools/types.d.ts +0 -18
  1379. package/dist/types/lib/slots/tools/types.d.ts.map +0 -1
  1380. package/dist/types/lib/swarm/buildSwarmRouting.d.ts +0 -36
  1381. package/dist/types/lib/swarm/buildSwarmRouting.d.ts.map +0 -1
  1382. package/dist/types/lib/swarm/index.d.ts +0 -3
  1383. package/dist/types/lib/swarm/index.d.ts.map +0 -1
  1384. package/dist/types/llm.js +0 -7
  1385. package/dist/types/llm.js.map +0 -1
  1386. package/dist/types/memory/conversationHelpers.d.ts +0 -19
  1387. package/dist/types/memory/conversationHelpers.d.ts.map +0 -1
  1388. package/dist/types/memory.barrel.d.ts +0 -73
  1389. package/dist/types/memory.barrel.d.ts.map +0 -1
  1390. package/dist/types/messages.js +0 -32
  1391. package/dist/types/messages.js.map +0 -1
  1392. package/dist/types/models/index.d.ts +0 -4
  1393. package/dist/types/models/index.d.ts.map +0 -1
  1394. package/dist/types/models/pricing.d.ts +0 -8
  1395. package/dist/types/models/pricing.d.ts.map +0 -1
  1396. package/dist/types/models/providers.d.ts +0 -23
  1397. package/dist/types/models/providers.d.ts.map +0 -1
  1398. package/dist/types/models/types.d.ts +0 -25
  1399. package/dist/types/models/types.d.ts.map +0 -1
  1400. package/dist/types/multiAgent.js +0 -6
  1401. package/dist/types/multiAgent.js.map +0 -1
  1402. package/dist/types/observe.barrel.d.ts +0 -22
  1403. package/dist/types/observe.barrel.d.ts.map +0 -1
  1404. package/dist/types/patterns/mapReduce.d.ts +0 -65
  1405. package/dist/types/patterns/mapReduce.d.ts.map +0 -1
  1406. package/dist/types/patterns/planExecute.d.ts +0 -49
  1407. package/dist/types/patterns/planExecute.d.ts.map +0 -1
  1408. package/dist/types/patterns/reflexion.d.ts +0 -65
  1409. package/dist/types/patterns/reflexion.d.ts.map +0 -1
  1410. package/dist/types/patterns/treeOfThoughts.d.ts +0 -65
  1411. package/dist/types/patterns/treeOfThoughts.d.ts.map +0 -1
  1412. package/dist/types/patterns.barrel.d.ts +0 -8
  1413. package/dist/types/patterns.barrel.d.ts.map +0 -1
  1414. package/dist/types/providers/index.d.ts +0 -15
  1415. package/dist/types/providers/index.d.ts.map +0 -1
  1416. package/dist/types/providers/messages/charBudget.d.ts +0 -19
  1417. package/dist/types/providers/messages/charBudget.d.ts.map +0 -1
  1418. package/dist/types/providers/messages/compositeMessages.d.ts +0 -16
  1419. package/dist/types/providers/messages/compositeMessages.d.ts.map +0 -1
  1420. package/dist/types/providers/messages/fullHistory.d.ts +0 -12
  1421. package/dist/types/providers/messages/fullHistory.d.ts.map +0 -1
  1422. package/dist/types/providers/messages/index.d.ts +0 -13
  1423. package/dist/types/providers/messages/index.d.ts.map +0 -1
  1424. package/dist/types/providers/messages/slidingWindow.d.ts +0 -16
  1425. package/dist/types/providers/messages/slidingWindow.d.ts.map +0 -1
  1426. package/dist/types/providers/messages/summaryStrategy.d.ts +0 -29
  1427. package/dist/types/providers/messages/summaryStrategy.d.ts.map +0 -1
  1428. package/dist/types/providers/messages/withToolPairSafety.d.ts +0 -19
  1429. package/dist/types/providers/messages/withToolPairSafety.d.ts.map +0 -1
  1430. package/dist/types/providers/prompt/compositePrompt.d.ts +0 -20
  1431. package/dist/types/providers/prompt/compositePrompt.d.ts.map +0 -1
  1432. package/dist/types/providers/prompt/index.d.ts +0 -10
  1433. package/dist/types/providers/prompt/index.d.ts.map +0 -1
  1434. package/dist/types/providers/prompt/skillBasedPrompt.d.ts +0 -33
  1435. package/dist/types/providers/prompt/skillBasedPrompt.d.ts.map +0 -1
  1436. package/dist/types/providers/prompt/static.d.ts +0 -6
  1437. package/dist/types/providers/prompt/static.d.ts.map +0 -1
  1438. package/dist/types/providers/prompt/template.d.ts +0 -6
  1439. package/dist/types/providers/prompt/template.d.ts.map +0 -1
  1440. package/dist/types/providers/tools/PermissionPolicy.d.ts +0 -76
  1441. package/dist/types/providers/tools/PermissionPolicy.d.ts.map +0 -1
  1442. package/dist/types/providers/tools/agentAsTool.d.ts +0 -40
  1443. package/dist/types/providers/tools/agentAsTool.d.ts.map +0 -1
  1444. package/dist/types/providers/tools/compositeTools.d.ts +0 -18
  1445. package/dist/types/providers/tools/compositeTools.d.ts.map +0 -1
  1446. package/dist/types/providers/tools/dynamicTools.d.ts +0 -27
  1447. package/dist/types/providers/tools/dynamicTools.d.ts.map +0 -1
  1448. package/dist/types/providers/tools/gatedTools.d.ts +0 -52
  1449. package/dist/types/providers/tools/gatedTools.d.ts.map +0 -1
  1450. package/dist/types/providers/tools/index.d.ts +0 -15
  1451. package/dist/types/providers/tools/index.d.ts.map +0 -1
  1452. package/dist/types/providers/tools/noTools.d.ts +0 -6
  1453. package/dist/types/providers/tools/noTools.d.ts.map +0 -1
  1454. package/dist/types/providers/tools/staticTools.d.ts +0 -7
  1455. package/dist/types/providers/tools/staticTools.d.ts.map +0 -1
  1456. package/dist/types/providers.barrel.d.ts +0 -34
  1457. package/dist/types/providers.barrel.d.ts.map +0 -1
  1458. package/dist/types/recorders/AgentTimelineRecorder.d.ts +0 -538
  1459. package/dist/types/recorders/AgentTimelineRecorder.d.ts.map +0 -1
  1460. package/dist/types/recorders/CompositeRecorder.d.ts +0 -30
  1461. package/dist/types/recorders/CompositeRecorder.d.ts.map +0 -1
  1462. package/dist/types/recorders/ContextEngineeringRecorder.d.ts +0 -105
  1463. package/dist/types/recorders/ContextEngineeringRecorder.d.ts.map +0 -1
  1464. package/dist/types/recorders/CostRecorder.d.ts +0 -43
  1465. package/dist/types/recorders/CostRecorder.d.ts.map +0 -1
  1466. package/dist/types/recorders/ExplainRecorder.d.ts +0 -117
  1467. package/dist/types/recorders/ExplainRecorder.d.ts.map +0 -1
  1468. package/dist/types/recorders/GuardrailRecorder.d.ts +0 -45
  1469. package/dist/types/recorders/GuardrailRecorder.d.ts.map +0 -1
  1470. package/dist/types/recorders/OTelRecorder.d.ts +0 -50
  1471. package/dist/types/recorders/OTelRecorder.d.ts.map +0 -1
  1472. package/dist/types/recorders/PermissionRecorder.d.ts +0 -66
  1473. package/dist/types/recorders/PermissionRecorder.d.ts.map +0 -1
  1474. package/dist/types/recorders/QualityRecorder.d.ts +0 -37
  1475. package/dist/types/recorders/QualityRecorder.d.ts.map +0 -1
  1476. package/dist/types/recorders/RecorderBridge.d.ts +0 -52
  1477. package/dist/types/recorders/RecorderBridge.d.ts.map +0 -1
  1478. package/dist/types/recorders/TokenRecorder.d.ts +0 -53
  1479. package/dist/types/recorders/TokenRecorder.d.ts.map +0 -1
  1480. package/dist/types/recorders/ToolUsageRecorder.d.ts +0 -38
  1481. package/dist/types/recorders/ToolUsageRecorder.d.ts.map +0 -1
  1482. package/dist/types/recorders/TurnRecorder.d.ts +0 -36
  1483. package/dist/types/recorders/TurnRecorder.d.ts.map +0 -1
  1484. package/dist/types/recorders/agentObservability.d.ts +0 -59
  1485. package/dist/types/recorders/agentObservability.d.ts.map +0 -1
  1486. package/dist/types/recorders/attachRecorderHelper.d.ts +0 -10
  1487. package/dist/types/recorders/attachRecorderHelper.d.ts.map +0 -1
  1488. package/dist/types/recorders/forwardEmitRecorders.d.ts +0 -22
  1489. package/dist/types/recorders/forwardEmitRecorders.d.ts.map +0 -1
  1490. package/dist/types/recorders/index.d.ts +0 -25
  1491. package/dist/types/recorders/index.d.ts.map +0 -1
  1492. package/dist/types/resilience.barrel.d.ts +0 -19
  1493. package/dist/types/resilience.barrel.d.ts.map +0 -1
  1494. package/dist/types/retriever.js +0 -7
  1495. package/dist/types/retriever.js.map +0 -1
  1496. package/dist/types/scope/AgentScope.d.ts +0 -76
  1497. package/dist/types/scope/AgentScope.d.ts.map +0 -1
  1498. package/dist/types/scope/index.d.ts +0 -3
  1499. package/dist/types/scope/index.d.ts.map +0 -1
  1500. package/dist/types/scope/types.d.ts +0 -182
  1501. package/dist/types/scope/types.d.ts.map +0 -1
  1502. package/dist/types/security.barrel.d.ts +0 -17
  1503. package/dist/types/security.barrel.d.ts.map +0 -1
  1504. package/dist/types/skills.barrel.d.ts +0 -43
  1505. package/dist/types/skills.barrel.d.ts.map +0 -1
  1506. package/dist/types/stages/augmentPrompt.d.ts +0 -16
  1507. package/dist/types/stages/augmentPrompt.d.ts.map +0 -1
  1508. package/dist/types/stages/callLLM.d.ts +0 -8
  1509. package/dist/types/stages/callLLM.d.ts.map +0 -1
  1510. package/dist/types/stages/finalize.d.ts +0 -7
  1511. package/dist/types/stages/finalize.d.ts.map +0 -1
  1512. package/dist/types/stages/helpers.d.ts +0 -17
  1513. package/dist/types/stages/helpers.d.ts.map +0 -1
  1514. package/dist/types/stages/index.d.ts +0 -8
  1515. package/dist/types/stages/index.d.ts.map +0 -1
  1516. package/dist/types/stages/parseResponse.d.ts +0 -8
  1517. package/dist/types/stages/parseResponse.d.ts.map +0 -1
  1518. package/dist/types/stages/retrieve.d.ts +0 -14
  1519. package/dist/types/stages/retrieve.d.ts.map +0 -1
  1520. package/dist/types/stages/runnerAsStage.d.ts +0 -18
  1521. package/dist/types/stages/runnerAsStage.d.ts.map +0 -1
  1522. package/dist/types/stream.barrel.d.ts +0 -19
  1523. package/dist/types/stream.barrel.d.ts.map +0 -1
  1524. package/dist/types/streaming/EventDispatcher.d.ts +0 -42
  1525. package/dist/types/streaming/EventDispatcher.d.ts.map +0 -1
  1526. package/dist/types/streaming/StreamEmitter.d.ts +0 -113
  1527. package/dist/types/streaming/StreamEmitter.d.ts.map +0 -1
  1528. package/dist/types/streaming/StreamEventRecorder.d.ts +0 -52
  1529. package/dist/types/streaming/StreamEventRecorder.d.ts.map +0 -1
  1530. package/dist/types/streaming/index.d.ts +0 -5
  1531. package/dist/types/streaming/index.d.ts.map +0 -1
  1532. package/dist/types/subflows/index.d.ts +0 -2
  1533. package/dist/types/subflows/index.d.ts.map +0 -1
  1534. package/dist/types/tools/ToolRegistry.d.ts +0 -57
  1535. package/dist/types/tools/ToolRegistry.d.ts.map +0 -1
  1536. package/dist/types/tools/askHuman.d.ts +0 -39
  1537. package/dist/types/tools/askHuman.d.ts.map +0 -1
  1538. package/dist/types/tools/index.d.ts +0 -3
  1539. package/dist/types/tools/index.d.ts.map +0 -1
  1540. package/dist/types/tools/validateInput.d.ts +0 -29
  1541. package/dist/types/tools/validateInput.d.ts.map +0 -1
  1542. package/dist/types/tools/zodToJsonSchema.d.ts +0 -9
  1543. package/dist/types/tools/zodToJsonSchema.d.ts.map +0 -1
  1544. package/dist/types/tools.js +0 -6
  1545. package/dist/types/tools.js.map +0 -1
  1546. package/dist/types/types/adapter.d.ts +0 -36
  1547. package/dist/types/types/adapter.d.ts.map +0 -1
  1548. package/dist/types/types/agent.d.ts +0 -44
  1549. package/dist/types/types/agent.d.ts.map +0 -1
  1550. package/dist/types/types/content.d.ts +0 -104
  1551. package/dist/types/types/content.d.ts.map +0 -1
  1552. package/dist/types/types/errors.d.ts +0 -27
  1553. package/dist/types/types/errors.d.ts.map +0 -1
  1554. package/dist/types/types/index.d.ts +0 -14
  1555. package/dist/types/types/index.d.ts.map +0 -1
  1556. package/dist/types/types/llm.d.ts +0 -78
  1557. package/dist/types/types/llm.d.ts.map +0 -1
  1558. package/dist/types/types/messages.d.ts +0 -40
  1559. package/dist/types/types/messages.d.ts.map +0 -1
  1560. package/dist/types/types/multiAgent.d.ts +0 -66
  1561. package/dist/types/types/multiAgent.d.ts.map +0 -1
  1562. package/dist/types/types/retriever.d.ts +0 -41
  1563. package/dist/types/types/retriever.d.ts.map +0 -1
  1564. package/dist/types/types/tools.d.ts +0 -78
  1565. package/dist/types/types/tools.d.ts.map +0 -1
@@ -1,7 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.AgentRunner = exports.Agent = void 0;
4
- var Agent_1 = require("./Agent");
5
- Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return Agent_1.Agent; } });
6
- Object.defineProperty(exports, "AgentRunner", { enumerable: true, get: function () { return Agent_1.AgentRunner; } });
7
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/concepts/index.ts"],"names":[],"mappings":";;;AAAA,iCAA6C;AAApC,8FAAA,KAAK,OAAA;AAAE,oGAAA,WAAW,OAAA"}
@@ -1,129 +0,0 @@
1
- "use strict";
2
- /**
3
- * InstructionRecorder — tracks which LLM instructions fired and follow-up usage.
4
- *
5
- * Implements AgentRecorder so it plugs into the standard `.recorder()` API.
6
- * Records per-tool instruction firings and follow-up accuracy for evaluation.
7
- *
8
- * @example
9
- * ```typescript
10
- * import { Agent, InstructionRecorder } from 'agentfootprint';
11
- *
12
- * const recorder = new InstructionRecorder();
13
- * const agent = Agent.create({ provider })
14
- * .recorder(recorder)
15
- * .build();
16
- *
17
- * await agent.run('Check my order');
18
- *
19
- * console.log(recorder.getSummary());
20
- * // {
21
- * // totalFired: 2,
22
- * // totalFollowUpsOffered: 1,
23
- * // byTool: {
24
- * // check_order: {
25
- * // instructions: { 'cancelled': { fired: 1, safety: false } },
26
- * // followUps: { 'get_trace': { offered: 1 } },
27
- * // }
28
- * // }
29
- * // }
30
- * ```
31
- */
32
- Object.defineProperty(exports, "__esModule", { value: true });
33
- exports.InstructionRecorder = void 0;
34
- // ── Recorder ────────────────────────────────────────────────────────────
35
- class InstructionRecorder {
36
- id;
37
- firings = new Map();
38
- followUps = new Map();
39
- constructor(id = 'instruction-recorder') {
40
- this.id = id;
41
- }
42
- /**
43
- * Record instructions that fired for a tool invocation.
44
- *
45
- * Called by the agent loop after processInstructions() completes.
46
- * Not an AgentRecorder hook — this is a dedicated method because
47
- * instruction events don't map to the standard onLLMCall/onToolCall events.
48
- */
49
- recordFirings(toolId, fired) {
50
- for (const instr of fired) {
51
- // Track instruction firing
52
- if (!this.firings.has(toolId))
53
- this.firings.set(toolId, new Map());
54
- const toolFirings = this.firings.get(toolId);
55
- const existing = toolFirings.get(instr.id);
56
- if (existing) {
57
- existing.count++;
58
- }
59
- else {
60
- toolFirings.set(instr.id, { count: 1, safety: instr.safety });
61
- }
62
- // Track follow-up offering
63
- if (instr.resolvedFollowUp) {
64
- if (!this.followUps.has(toolId))
65
- this.followUps.set(toolId, new Map());
66
- const toolFollowUps = this.followUps.get(toolId);
67
- const fuKey = instr.resolvedFollowUp.toolId;
68
- const existingFu = toolFollowUps.get(fuKey);
69
- if (existingFu) {
70
- existingFu.count++;
71
- }
72
- else {
73
- toolFollowUps.set(fuKey, { count: 1, toolId: fuKey });
74
- }
75
- }
76
- }
77
- }
78
- /** Get summary of all instruction firings and follow-up offerings. */
79
- getSummary() {
80
- let totalFired = 0;
81
- let totalFollowUpsOffered = 0;
82
- const byTool = {};
83
- // All tool IDs that have any activity
84
- const allToolIds = new Set([...this.firings.keys(), ...this.followUps.keys()]);
85
- for (const toolId of allToolIds) {
86
- const instructions = {};
87
- const followUps = {};
88
- const toolFirings = this.firings.get(toolId);
89
- if (toolFirings) {
90
- for (const [instrId, data] of toolFirings) {
91
- instructions[instrId] = { fired: data.count, safety: data.safety };
92
- totalFired += data.count;
93
- }
94
- }
95
- const toolFollowUps = this.followUps.get(toolId);
96
- if (toolFollowUps) {
97
- for (const [fuToolId, data] of toolFollowUps) {
98
- followUps[fuToolId] = { offered: data.count, toolId: data.toolId };
99
- totalFollowUpsOffered += data.count;
100
- }
101
- }
102
- byTool[toolId] = { instructions, followUps };
103
- }
104
- return { totalFired, totalFollowUpsOffered, byTool };
105
- }
106
- /** Get firing count for a specific instruction on a specific tool. */
107
- getFiringCount(toolId, instructionId) {
108
- return this.firings.get(toolId)?.get(instructionId)?.count ?? 0;
109
- }
110
- /** Get all instruction IDs that fired for a tool. */
111
- getFiredInstructionIds(toolId) {
112
- const toolFirings = this.firings.get(toolId);
113
- return toolFirings ? [...toolFirings.keys()] : [];
114
- }
115
- toSnapshot() {
116
- return {
117
- name: 'Instructions',
118
- description: 'Translator (FlowRecorder) — per-tool instruction injection log',
119
- preferredOperation: 'translate',
120
- data: this.getSummary(),
121
- };
122
- }
123
- clear() {
124
- this.firings.clear();
125
- this.followUps.clear();
126
- }
127
- }
128
- exports.InstructionRecorder = InstructionRecorder;
129
- //# sourceMappingURL=InstructionRecorder.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"InstructionRecorder.js","sourceRoot":"","sources":["../../../src/lib/instructions/InstructionRecorder.ts"],"names":[],"mappings":"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"}
@@ -1,146 +0,0 @@
1
- "use strict";
2
- /**
3
- * Agent-level Instruction type — conditional context injection across all 3 LLM API positions.
4
- *
5
- * Unlike tool-level `LLMInstruction` (fires on a specific tool result),
6
- * an `AgentInstruction` fires based on accumulated Decision Scope state
7
- * and can inject into system prompt, tools, AND tool response rules.
8
- *
9
- * Evaluated by the InstructionsToLLM subflow BEFORE the 3 API slots.
10
- *
11
- * Naming:
12
- * `activeWhen` (agent-level, reads decision scope) vs
13
- * `when` (tool-level, reads tool result context) — no collision.
14
- */
15
- Object.defineProperty(exports, "__esModule", { value: true });
16
- exports.defineInstruction = exports.evaluateAgentInstructions = void 0;
17
- const isDevMode = () => typeof process !== 'undefined' && process.env?.['NODE_ENV'] !== 'production';
18
- // ── Evaluator ──────────────────────────────────────────────────────────
19
- /**
20
- * Check if an instruction has at least one output (prompt, tools, or onToolResult).
21
- */
22
- function hasOutputs(instr) {
23
- return !!(instr.prompt ||
24
- (instr.tools && instr.tools.length > 0) ||
25
- (instr.onToolResult && instr.onToolResult.length > 0));
26
- }
27
- /**
28
- * Evaluate agent-level instructions against the current decision scope.
29
- *
30
- * Returns categorized outputs for each of the 3 LLM API positions.
31
- * Instructions are sorted by priority (lower = first), with safety
32
- * instructions always sorted LAST (matching tool-level convention).
33
- *
34
- * Error handling follows the same pattern as tool-level instructions:
35
- * - Behavioral (safety: false): predicate throws → skip (fail-open)
36
- * - Safety (safety: true): predicate throws → fire (fail-closed)
37
- *
38
- * @example
39
- * ```typescript
40
- * const result = evaluateAgentInstructions(instructions, { orderStatus: 'denied' });
41
- * // result.promptInjections → ['Handle denied orders with empathy.']
42
- * // result.toolInjections → [processRefund, getTrace]
43
- * // result.responseRules → [{ id: 'empathy', text: '...' }]
44
- * // result.matchedIds → ['refund-handling']
45
- * ```
46
- */
47
- function evaluateAgentInstructions(instructions, decision) {
48
- const empty = {
49
- promptInjections: [],
50
- toolInjections: [],
51
- responseRules: [],
52
- matchedIds: [],
53
- };
54
- if (!instructions || instructions.length === 0)
55
- return empty;
56
- // Sort by priority, safety instructions LAST (matching tool-level convention).
57
- // Stable sort preserves registration order for ties.
58
- const sorted = [...instructions].sort((a, b) => {
59
- const aSafety = a.safety ?? false;
60
- const bSafety = b.safety ?? false;
61
- if (aSafety !== bSafety)
62
- return aSafety ? 1 : -1;
63
- return (a.priority ?? 0) - (b.priority ?? 0);
64
- });
65
- const promptInjections = [];
66
- const toolInjections = [];
67
- const responseRules = [];
68
- const matchedIds = [];
69
- const seenToolIds = new Set();
70
- for (const instr of sorted) {
71
- // Evaluate predicate
72
- if (instr.activeWhen) {
73
- try {
74
- if (!instr.activeWhen(decision))
75
- continue;
76
- }
77
- catch {
78
- if (instr.safety) {
79
- // Safety: fail-closed — fire when predicate errors
80
- }
81
- else {
82
- // Behavioral: fail-open — skip broken predicate
83
- continue;
84
- }
85
- }
86
- }
87
- // P0 review fix: warn in dev mode when safety instruction has no outputs
88
- if (instr.safety && !hasOutputs(instr)) {
89
- if (isDevMode()) {
90
- console.warn(`[agentfootprint] Safety instruction '${instr.id}' matched but has no outputs (prompt, tools, or onToolResult). ` +
91
- `It will appear in matchedIds but inject nothing.`);
92
- }
93
- }
94
- matchedIds.push(instr.id);
95
- if (instr.prompt) {
96
- promptInjections.push(instr.prompt);
97
- }
98
- if (instr.tools) {
99
- for (const tool of instr.tools) {
100
- // Deduplicate by tool ID — first registration wins
101
- if (!seenToolIds.has(tool.id)) {
102
- seenToolIds.add(tool.id);
103
- toolInjections.push(tool);
104
- }
105
- }
106
- }
107
- if (instr.onToolResult) {
108
- responseRules.push(...instr.onToolResult);
109
- }
110
- }
111
- return { promptInjections, toolInjections, responseRules, matchedIds };
112
- }
113
- exports.evaluateAgentInstructions = evaluateAgentInstructions;
114
- // ── Factory ────────────────────────────────────────────────────────────
115
- /**
116
- * Create a validated agent-level instruction.
117
- *
118
- * This is the preferred way to create instructions — validates the `id` field
119
- * at build time and provides good TypeScript inference for the decision type.
120
- *
121
- * @example
122
- * ```typescript
123
- * interface MyDecision {
124
- * orderStatus: 'pending' | 'denied' | null;
125
- * riskLevel: 'low' | 'high';
126
- * }
127
- *
128
- * const refund = defineInstruction<MyDecision>({
129
- * id: 'refund-handling',
130
- * activeWhen: (d) => d.orderStatus === 'denied',
131
- * prompt: 'Handle denied orders with empathy.',
132
- * tools: [processRefund, getTrace],
133
- * onToolResult: [
134
- * { id: 'empathy', text: 'Do NOT promise reversal.' },
135
- * ],
136
- * });
137
- * ```
138
- */
139
- function defineInstruction(config) {
140
- if (!config.id) {
141
- throw new Error('defineInstruction: id is required');
142
- }
143
- return config;
144
- }
145
- exports.defineInstruction = defineInstruction;
146
- //# sourceMappingURL=agentInstruction.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"agentInstruction.js","sourceRoot":"","sources":["../../../src/lib/instructions/agentInstruction.ts"],"names":[],"mappings":"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"}
@@ -1,87 +0,0 @@
1
- "use strict";
2
- /**
3
- * InstructionsToLLM subflow — evaluates agent-level instructions before the 3 API slots.
4
- *
5
- * Runs once per loop iteration (Dynamic pattern) or once before the loop (Regular).
6
- * Reads the current Decision Scope, evaluates all registered instructions'
7
- * `activeWhen` predicates, and outputs categorized injections for each slot:
8
- *
9
- * promptInjections → consumed by SystemPrompt slot
10
- * toolInjections → consumed by Tools slot
11
- * responseRules → consumed by tool execution subflow
12
- *
13
- * The instruction registry is baked into the subflow via closure at build time.
14
- * This is a footprintjs flowchart subflow — visible in narrative/BTS.
15
- *
16
- * Loop position:
17
- * Seed → [InstructionsToLLM] → [SystemPrompt] → [Messages] → [Tools] → ...
18
- */
19
- Object.defineProperty(exports, "__esModule", { value: true });
20
- exports.buildInstructionsToLLMSubflow = void 0;
21
- const footprintjs_1 = require("footprintjs");
22
- const agentInstruction_1 = require("./agentInstruction");
23
- /**
24
- * Build the InstructionsToLLM subflow from a registry of agent-level instructions.
25
- *
26
- * The instructions array is captured by closure — immutable after build (shallow freeze).
27
- * The subflow reads `scope.decision` (from parent inputMapper) and writes
28
- * the categorized outputs for downstream slots to consume.
29
- *
30
- * **Parent state requirements:** The parent chart's `inputMapper` MUST map the
31
- * `decision` field. If `decision` is missing (undefined), all instructions with
32
- * `activeWhen` predicates will evaluate against `undefined` — behavioral predicates
33
- * will throw and be skipped (fail-open), safety predicates will fire (fail-closed).
34
- *
35
- * The `outputMapper` should map the 3 output fields back to the parent state:
36
- * `promptInjections`, `toolInjections`, `responseRules` (and optionally
37
- * `matchedInstructions` for narrative enrichment).
38
- *
39
- * @param instructions - Agent-level instructions registered via `.instruction()`.
40
- * Empty array is valid (subflow becomes a no-op pass-through).
41
- *
42
- * @example
43
- * ```typescript
44
- * const subflow = buildInstructionsToLLMSubflow([refundInstruction, complianceInstruction]);
45
- *
46
- * // Mount in agent loop (parent state must include matching fields):
47
- * builder.addSubFlowChartNext('sf-instructions-to-llm', subflow, 'InstructionsToLLM', {
48
- * inputMapper: (parent) => ({ decision: parent.decision }),
49
- * outputMapper: (sf) => ({
50
- * promptInjections: sf.promptInjections,
51
- * toolInjections: sf.toolInjections,
52
- * responseRules: sf.responseRules,
53
- * matchedInstructions: sf.matchedInstructions,
54
- * }),
55
- * });
56
- * ```
57
- */
58
- function buildInstructionsToLLMSubflow(instructions) {
59
- // Freeze the instruction list — no mutations after build.
60
- // Note: shallow freeze — individual instruction objects are readonly-typed
61
- // but not deeply frozen. This is sufficient since TypeScript enforces readonly.
62
- const frozenInstructions = Object.freeze([...instructions]);
63
- return (0, footprintjs_1.flowChart)('EvaluateInstructions', (scope) => {
64
- // Read decision scope from parent. If missing (inputMapper didn't map it),
65
- // pass through as-is — predicates will see undefined and fail-open/closed
66
- // according to their safety flag.
67
- const decision = scope.decision;
68
- const result = (0, agentInstruction_1.evaluateAgentInstructions)(frozenInstructions, decision);
69
- scope.promptInjections = [...result.promptInjections];
70
- // Convert ToolDefinition → LLMToolDescription (strip handler for LLM consumption)
71
- scope.toolInjections = result.toolInjections.map((t) => ({
72
- name: t.id,
73
- description: t.description,
74
- inputSchema: t.inputSchema,
75
- }));
76
- scope.responseRules = [...result.responseRules];
77
- // Narrative enrichment — which instructions fired and why
78
- if (result.matchedIds.length > 0) {
79
- scope.matchedInstructions = `${result.matchedIds.length} matched: ${result.matchedIds.join(', ')}`;
80
- }
81
- else {
82
- scope.matchedInstructions = 'none matched';
83
- }
84
- }, 'evaluate-instructions', undefined, 'Evaluate agent instructions against Decision Scope').build();
85
- }
86
- exports.buildInstructionsToLLMSubflow = buildInstructionsToLLMSubflow;
87
- //# sourceMappingURL=buildInstructionsToLLMSubflow.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"buildInstructionsToLLMSubflow.js","sourceRoot":"","sources":["../../../src/lib/instructions/buildInstructionsToLLMSubflow.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,6CAAwC;AAKxC,yDAA+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,SAAgB,6BAA6B,CAC3C,YAAyC;IAEzC,0DAA0D;IAC1D,2EAA2E;IAC3E,gFAAgF;IAChF,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAE5D,OAAO,IAAA,uBAAS,EACd,sBAAsB,EACtB,CAAC,KAAyC,EAAE,EAAE;QAC5C,2EAA2E;QAC3E,0EAA0E;QAC1E,kCAAkC;QAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,MAAM,MAAM,GAAG,IAAA,4CAAyB,EAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;QAEvE,KAAK,CAAC,gBAAgB,GAAG,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACtD,kFAAkF;QAClF,KAAK,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAC9C,CAAC,CAAC,EAAsB,EAAE,CAAC,CAAC;YAC1B,IAAI,EAAE,CAAC,CAAC,EAAE;YACV,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CACH,CAAC;QACF,KAAK,CAAC,aAAa,GAAG,CAAC,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;QAEhD,0DAA0D;QAC1D,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,KAAK,CAAC,mBAAmB,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,aAAa,MAAM,CAAC,UAAU,CAAC,IAAI,CACxF,IAAI,CACL,EAAE,CAAC;QACN,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,mBAAmB,GAAG,cAAc,CAAC;QAC7C,CAAC;IACH,CAAC,EACD,uBAAuB,EACvB,SAAS,EACT,oDAAoD,CACrD,CAAC,KAAK,EAAE,CAAC;AACZ,CAAC;AAzCD,sEAyCC"}
@@ -1,202 +0,0 @@
1
- "use strict";
2
- /**
3
- * Instruction evaluator — matches instructions against tool results.
4
- *
5
- * Evaluates `when` predicates, sorts by priority, and orders for injection:
6
- * 1. Follow-up bindings (structured actions)
7
- * 2. Behavioral instructions (free text guidance)
8
- * 3. Safety instructions LAST (closest to LLM generation = highest attention)
9
- *
10
- * Predicates that throw are skipped with a warning (fail-open for behavioral,
11
- * fail-closed for safety). This is the defensive behavior — a broken predicate
12
- * should not prevent the agent from working, but safety instructions should
13
- * fail-closed (fire when in doubt).
14
- */
15
- Object.defineProperty(exports, "__esModule", { value: true });
16
- exports.applyInstructionOverrides = exports.mergeRuntimeInstructions = exports.evaluateInstructions = void 0;
17
- // ── Evaluator ───────────────────────────────────────────────────────────
18
- /**
19
- * Evaluate build-time instructions against a tool result context.
20
- *
21
- * Returns resolved instructions sorted for injection:
22
- * 1. Non-safety with follow-up only (structured actions first)
23
- * 2. Non-safety with inject (behavioral guidance)
24
- * 3. Safety instructions (LAST = highest attention weight)
25
- *
26
- * Within each group, sorted by priority (lower = first), then array order.
27
- *
28
- * @example
29
- * ```typescript
30
- * const fired = evaluateInstructions(tool.instructions, {
31
- * content: { status: 'denied', traceId: 'tr_8f3a' },
32
- * error: undefined,
33
- * latencyMs: 42,
34
- * input: { applicantId: 'a-1' },
35
- * toolId: 'evaluate_loan',
36
- * });
37
- *
38
- * // fired: [{ id: 'denial-empathy', text: '...', resolvedFollowUp: {...} }]
39
- * ```
40
- */
41
- function evaluateInstructions(instructions, ctx) {
42
- if (!instructions || instructions.length === 0)
43
- return [];
44
- const matched = [];
45
- for (const instr of instructions) {
46
- // Evaluate predicate — skip on throw for behavioral, fire on throw for safety
47
- if (instr.when) {
48
- try {
49
- if (!instr.when(ctx))
50
- continue; // predicate returned false
51
- }
52
- catch {
53
- if (instr.safety) {
54
- // Safety: fail-closed — fire the instruction when predicate errors
55
- // Better to inject a safety instruction unnecessarily than to miss it
56
- }
57
- else {
58
- // Behavioral: fail-open — skip broken predicate
59
- continue;
60
- }
61
- }
62
- }
63
- // No `when` = unconditional — always fires
64
- // Resolve follow-up params if present
65
- let resolvedFollowUp;
66
- if (instr.followUp) {
67
- try {
68
- const params = instr.followUp.params(ctx);
69
- resolvedFollowUp = {
70
- toolId: instr.followUp.toolId,
71
- params,
72
- description: instr.followUp.description,
73
- condition: instr.followUp.condition,
74
- strict: instr.followUp.strict ?? false,
75
- };
76
- }
77
- catch {
78
- // If params resolution fails, skip the follow-up but keep the inject
79
- resolvedFollowUp = undefined;
80
- }
81
- }
82
- matched.push({
83
- id: instr.id,
84
- text: instr.text,
85
- resolvedFollowUp,
86
- safety: instr.safety ?? false,
87
- priority: instr.priority ?? 0,
88
- });
89
- }
90
- // Sort for injection order:
91
- // 1. Non-safety sorted by priority (lower first), then array order (stable sort)
92
- // 2. Safety instructions at the end (closest to generation = highest attention)
93
- return matched.sort((a, b) => {
94
- // Safety always after non-safety
95
- if (a.safety !== b.safety)
96
- return a.safety ? 1 : -1;
97
- // Within same safety group, sort by priority
98
- return a.priority - b.priority;
99
- });
100
- }
101
- exports.evaluateInstructions = evaluateInstructions;
102
- /**
103
- * Merge build-time resolved instructions with runtime instructions/followUps.
104
- *
105
- * Runtime instructions (from handler return) are appended after build-time
106
- * behavioral instructions but before safety instructions.
107
- *
108
- * @example
109
- * ```typescript
110
- * const buildTime = evaluateInstructions(tool.instructions, ctx);
111
- * const runtime = {
112
- * instructions: ['Service degraded. Set expectations.'],
113
- * followUps: [{ toolId: 'status_page', params: {}, description: '...', condition: '...' }],
114
- * };
115
- * const merged = mergeRuntimeInstructions(buildTime, runtime);
116
- * ```
117
- */
118
- function mergeRuntimeInstructions(buildTime, runtime) {
119
- if (!runtime)
120
- return buildTime;
121
- const runtimeResolved = [];
122
- // Runtime follow-ups
123
- if (runtime.followUps) {
124
- for (const fu of runtime.followUps) {
125
- if (!fu.toolId || !fu.params)
126
- continue; // validate required fields
127
- runtimeResolved.push({
128
- id: `runtime-followup-${fu.toolId}`,
129
- resolvedFollowUp: {
130
- toolId: fu.toolId,
131
- params: fu.params,
132
- description: fu.description,
133
- condition: fu.condition,
134
- strict: fu.strict ?? false,
135
- },
136
- safety: false,
137
- priority: 0,
138
- });
139
- }
140
- }
141
- // Runtime behavioral instructions
142
- if (runtime.instructions) {
143
- for (let i = 0; i < runtime.instructions.length; i++) {
144
- runtimeResolved.push({
145
- id: `runtime-text-${i}`,
146
- text: runtime.instructions[i],
147
- safety: false,
148
- priority: 0,
149
- });
150
- }
151
- }
152
- // Merge: build-time non-safety → runtime → build-time safety
153
- const nonSafety = buildTime.filter((r) => !r.safety);
154
- const safety = buildTime.filter((r) => r.safety);
155
- return [...nonSafety, ...runtimeResolved, ...safety];
156
- }
157
- exports.mergeRuntimeInstructions = mergeRuntimeInstructions;
158
- /**
159
- * Apply agent-level overrides to a tool's instructions.
160
- *
161
- * Returns a new instruction array with overrides applied:
162
- * 1. Suppress: remove instructions by ID
163
- * 2. Replace: merge partial overrides into existing instructions by ID
164
- * 3. Add: append new instructions at the end
165
- *
166
- * @example
167
- * ```typescript
168
- * const original = tool.instructions;
169
- * const overridden = applyInstructionOverrides(original, {
170
- * suppress: ['low-stock'],
171
- * add: [{ id: 'premium-oos', when: ..., text: '...' }],
172
- * replace: { 'out-of-stock': { text: 'Suggest B2B channel.' } },
173
- * });
174
- * ```
175
- */
176
- function applyInstructionOverrides(instructions, override) {
177
- if (!instructions || instructions.length === 0) {
178
- return [...(override.add ?? [])];
179
- }
180
- const suppressSet = new Set(override.suppress ?? []);
181
- const replaceMap = override.replace ?? {};
182
- // 1. Filter suppressed, then apply replacements
183
- const result = [];
184
- for (const instr of instructions) {
185
- if (suppressSet.has(instr.id))
186
- continue; // suppressed
187
- const replacement = replaceMap[instr.id];
188
- if (replacement) {
189
- result.push({ ...instr, ...replacement, id: instr.id }); // merge, preserve ID
190
- }
191
- else {
192
- result.push(instr);
193
- }
194
- }
195
- // 2. Add new instructions
196
- if (override.add) {
197
- result.push(...override.add);
198
- }
199
- return result;
200
- }
201
- exports.applyInstructionOverrides = applyInstructionOverrides;
202
- //# sourceMappingURL=evaluator.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../../src/lib/instructions/evaluator.ts"],"names":[],"mappings":"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"}
@@ -1,27 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.buildInstructionsToLLMSubflow = exports.defineInstruction = exports.evaluateAgentInstructions = exports.PendingFollowUpManager = exports.defaultConditionMatcher = exports.InstructionRecorder = exports.previewInstructions = exports.processInstructions = exports.renderInstructions = exports.applyInstructionOverrides = exports.mergeRuntimeInstructions = exports.evaluateInstructions = exports.follow = exports.quickBind = void 0;
4
- var types_1 = require("./types");
5
- Object.defineProperty(exports, "quickBind", { enumerable: true, get: function () { return types_1.quickBind; } });
6
- Object.defineProperty(exports, "follow", { enumerable: true, get: function () { return types_1.follow; } });
7
- var evaluator_1 = require("./evaluator");
8
- Object.defineProperty(exports, "evaluateInstructions", { enumerable: true, get: function () { return evaluator_1.evaluateInstructions; } });
9
- Object.defineProperty(exports, "mergeRuntimeInstructions", { enumerable: true, get: function () { return evaluator_1.mergeRuntimeInstructions; } });
10
- Object.defineProperty(exports, "applyInstructionOverrides", { enumerable: true, get: function () { return evaluator_1.applyInstructionOverrides; } });
11
- var template_1 = require("./template");
12
- Object.defineProperty(exports, "renderInstructions", { enumerable: true, get: function () { return template_1.renderInstructions; } });
13
- var inject_1 = require("./inject");
14
- Object.defineProperty(exports, "processInstructions", { enumerable: true, get: function () { return inject_1.processInstructions; } });
15
- var preview_1 = require("./preview");
16
- Object.defineProperty(exports, "previewInstructions", { enumerable: true, get: function () { return preview_1.previewInstructions; } });
17
- var InstructionRecorder_1 = require("./InstructionRecorder");
18
- Object.defineProperty(exports, "InstructionRecorder", { enumerable: true, get: function () { return InstructionRecorder_1.InstructionRecorder; } });
19
- var strictFollowUp_1 = require("./strictFollowUp");
20
- Object.defineProperty(exports, "defaultConditionMatcher", { enumerable: true, get: function () { return strictFollowUp_1.defaultConditionMatcher; } });
21
- Object.defineProperty(exports, "PendingFollowUpManager", { enumerable: true, get: function () { return strictFollowUp_1.PendingFollowUpManager; } });
22
- var agentInstruction_1 = require("./agentInstruction");
23
- Object.defineProperty(exports, "evaluateAgentInstructions", { enumerable: true, get: function () { return agentInstruction_1.evaluateAgentInstructions; } });
24
- Object.defineProperty(exports, "defineInstruction", { enumerable: true, get: function () { return agentInstruction_1.defineInstruction; } });
25
- var buildInstructionsToLLMSubflow_1 = require("./buildInstructionsToLLMSubflow");
26
- Object.defineProperty(exports, "buildInstructionsToLLMSubflow", { enumerable: true, get: function () { return buildInstructionsToLLMSubflow_1.buildInstructionsToLLMSubflow; } });
27
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/instructions/index.ts"],"names":[],"mappings":";;;AAAA,iCAA4C;AAAnC,kGAAA,SAAS,OAAA;AAAE,+FAAA,MAAM,OAAA;AAW1B,yCAIqB;AAHnB,iHAAA,oBAAoB,OAAA;AACpB,qHAAA,wBAAwB,OAAA;AACxB,sHAAA,yBAAyB,OAAA;AAI3B,uCAAgD;AAAvC,8GAAA,kBAAkB,OAAA;AAG3B,mCAA+C;AAAtC,6GAAA,mBAAmB,OAAA;AAG5B,qCAAgD;AAAvC,8GAAA,mBAAmB,OAAA;AAG5B,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAQ5B,mDAAmF;AAA1E,yHAAA,uBAAuB,OAAA;AAAE,wHAAA,sBAAsB,OAAA;AAGxD,uDAAkF;AAAzE,6HAAA,yBAAyB,OAAA;AAAE,qHAAA,iBAAiB,OAAA;AAGrD,iFAAgF;AAAvE,8IAAA,6BAA6B,OAAA"}