agentfootprint 1.22.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 +316 -208
  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 -88
  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 -239
  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 -289
  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 -310
  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 -234
  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 -284
  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 -305
  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 -508
  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 -513
  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 -67
  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 -120
  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 -108
  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 -309
  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,309 +0,0 @@
1
- /**
2
- * AgentTimelineRecorder — the canonical agent-shaped narrative.
3
- *
4
- * THE ABSTRACTION (mirrors footprintjs CombinedNarrativeRecorder):
5
- *
6
- * footprintjs agentfootprint
7
- * ─────────── ──────────────
8
- * CombinedNarrativeRecorder AgentTimelineRecorder
9
- * ↓ produces NarrativeEntry[] ↓ produces AgentTimeline
10
- * ↓ for ANY UI ↓ for ANY UI
11
- * ExplainableShell, custom shells Lens, Grafana panels,
12
- * CLI debuggers, replay tools
13
- *
14
- * The library emits `agentfootprint.stream.*` + `agentfootprint.context.*`
15
- * events at every interesting moment in a run. This recorder is the ONE
16
- * PLACE every UI / observability consumer translates that emit stream
17
- * into the agent-shaped narrative they render against (turns →
18
- * iterations → tool calls + per-iteration context injections + ledger).
19
- * One recorder, one shape, every consumer.
20
- *
21
- * Storage primitive: footprintjs `SequenceRecorder<TimelineEntry>` —
22
- * inherits insertion-ordered storage, O(1) per-step lookup via
23
- * runtimeStageId map, range index for time-travel sliders, and
24
- * progressive `accumulate()` reduction. We don't reinvent these.
25
- *
26
- * @example
27
- * ```ts
28
- * import { Agent, agentTimeline, anthropic } from 'agentfootprint';
29
- *
30
- * const t = agentTimeline();
31
- * const agent = Agent.create({ provider: anthropic('claude-sonnet-4') })
32
- * .recorder(t)
33
- * .build();
34
- *
35
- * await agent.run('Investigate port errors on switch-3');
36
- *
37
- * t.getTimeline(); // AgentTimeline { turns, messages, tools, ... }
38
- * t.getEntryRanges(); // O(1) per-step range index for sliders
39
- * t.aggregate(...); // reduce all entries
40
- * ```
41
- *
42
- * Multi-agent: each sub-agent in a Pipeline/Swarm gets its own named
43
- * instance — `agentTimeline({ id: 'classify' })` — and each lands in
44
- * its own `executor.getSnapshot().recorders[id]` slot. Multi-agent
45
- * shells aggregate them by id.
46
- */
47
- import type { EmitEvent, EmitRecorder } from 'footprintjs';
48
- import { SequenceRecorder } from 'footprintjs/trace';
49
- export interface AgentMessage {
50
- readonly role: 'system' | 'user' | 'assistant' | 'tool';
51
- readonly content: string;
52
- readonly toolCalls?: readonly AgentToolCallStub[];
53
- readonly toolCallId?: string;
54
- }
55
- /** Tool call stub as it appears on an assistant message. */
56
- export interface AgentToolCallStub {
57
- readonly id: string;
58
- readonly name: string;
59
- readonly arguments: Record<string, unknown>;
60
- }
61
- /** A resolved tool invocation with args + result + timing. */
62
- export interface AgentToolInvocation {
63
- readonly id: string;
64
- readonly name: string;
65
- readonly arguments: Record<string, unknown>;
66
- readonly result: string;
67
- readonly error?: boolean;
68
- readonly decisionUpdate?: Record<string, unknown>;
69
- /** 1-based iteration within the turn. */
70
- readonly iterationIndex: number;
71
- /** 0-based turn index. */
72
- readonly turnIndex: number;
73
- readonly durationMs?: number;
74
- }
75
- /**
76
- * One context-engineering injection captured during this iteration —
77
- * RAG retrieval, skill activation, memory write, instruction firing.
78
- * The library's "teaching surface" — every injection says WHO injected
79
- * WHAT into WHICH Agent slot.
80
- */
81
- export interface AgentContextInjection {
82
- /** Source name — `rag` / `memory` / `skill` / `instructions` / custom. */
83
- readonly source: string;
84
- /** Which Agent slot this injection lands in. */
85
- readonly slot: 'system-prompt' | 'messages' | 'tools';
86
- /** Short label rendered in UI tags (e.g. "3 chunks · top 0.95"). */
87
- readonly label: string;
88
- /** Wire-level LLM role when the slot is `messages`. */
89
- readonly role?: 'system' | 'user' | 'assistant' | 'tool';
90
- /** Index in `messages[]` where the injected message landed. */
91
- readonly targetIndex?: number;
92
- /** Per-counter deltas this injection contributed (open key set). */
93
- readonly deltaCount?: Record<string, number | boolean>;
94
- /** Raw payload from the emit event — for advanced consumers. */
95
- readonly payload: Record<string, unknown>;
96
- }
97
- /** Per-iteration accumulated ledger — sum of every injection's deltaCount. */
98
- export type AgentContextLedger = Record<string, number | boolean>;
99
- /** One LLM call + its tool loop. */
100
- export interface AgentIteration {
101
- readonly index: number;
102
- readonly inputTokens?: number;
103
- readonly outputTokens?: number;
104
- readonly model?: string;
105
- readonly durationMs?: number;
106
- readonly stopReason?: string;
107
- readonly assistantContent: string;
108
- readonly toolCalls: readonly AgentToolInvocation[];
109
- readonly decisionAtStart: Record<string, unknown>;
110
- readonly matchedInstructions?: readonly string[];
111
- readonly visibleTools: readonly string[];
112
- /** Context injections that shaped this iteration's prompt. */
113
- readonly contextInjections: readonly AgentContextInjection[];
114
- /** Folded ledger across this iteration's injections. */
115
- readonly contextLedger: AgentContextLedger;
116
- /**
117
- * Number of messages in the conversation when this iter's `llm_start`
118
- * fired. `messages.slice(0, messagesSentCount)` reproduces what the
119
- * LLM saw on this iteration. Wire-level fact, not a UI concept.
120
- */
121
- readonly messagesSentCount: number;
122
- }
123
- /** One `.run()` call. Multi-turn conversations stack these. */
124
- export interface AgentTurn {
125
- readonly index: number;
126
- readonly userPrompt: string;
127
- readonly iterations: readonly AgentIteration[];
128
- readonly finalContent: string;
129
- readonly totalInputTokens: number;
130
- readonly totalOutputTokens: number;
131
- readonly totalDurationMs: number;
132
- /** All injections this turn, flat union across iterations. */
133
- readonly contextInjections: readonly AgentContextInjection[];
134
- /** Folded ledger across all of this turn's iterations. */
135
- readonly contextLedger: AgentContextLedger;
136
- }
137
- /**
138
- * Agent identity attached to a timeline. The `id` matches the
139
- * recorder's id (the same one passed to `agentTimeline({ id })`); the
140
- * `name` is the display name from `Agent.create({ name })`. Single
141
- * source of truth for "which agent did this run belong to" — UI
142
- * libraries read `timeline.agent.name` instead of fishing it out of
143
- * the runtime snapshot or asking the consumer to thread a separate
144
- * prop. Also the foundation for multi-agent rendering: each sub-agent
145
- * has its own recorder, its own timeline, its own `agent` block.
146
- */
147
- export interface AgentInfo {
148
- /** Recorder id — also used as snapshot slot key for multi-agent. */
149
- readonly id: string;
150
- /** Display name for UI. Defaults to "Agent" when not supplied. */
151
- readonly name: string;
152
- }
153
- /**
154
- * One sub-agent inside a multi-agent timeline. Distinct from
155
- * `AgentInfo` because sub-agents carry their own slice of turns +
156
- * messages + tools — they're "small timelines" inside the bigger one.
157
- *
158
- * Detection: events from a sub-agent arrive with `subflowPath`
159
- * populated (e.g. `["classify"]` for the classify stage of a
160
- * Pipeline). The recorder groups entries by `subflowPath[0]` to
161
- * derive these sub-agent slices. Single-agent runs have empty
162
- * `subflowPath` on every event → no sub-agents derived.
163
- */
164
- export interface SubAgentTimeline {
165
- /** Sub-agent identity — derived from `subflowPath[0]`. */
166
- readonly id: string;
167
- /** Display name. Same as `id` until upstream wiring carries the
168
- * human-readable name (e.g. via `Agent.create({ name })` on the
169
- * sub-agent's builder). */
170
- readonly name: string;
171
- /** Turns owned by this sub-agent. */
172
- readonly turns: readonly AgentTurn[];
173
- /** Tool invocations from this sub-agent (subset of timeline.tools). */
174
- readonly tools: readonly AgentToolInvocation[];
175
- }
176
- /** The full picture: every turn stitched together. */
177
- export interface AgentTimeline {
178
- /** Identity of the agent that produced this timeline. UIs label
179
- * containers / cards / panels with this. */
180
- readonly agent: AgentInfo;
181
- readonly turns: readonly AgentTurn[];
182
- readonly messages: readonly AgentMessage[];
183
- readonly tools: readonly AgentToolInvocation[];
184
- readonly finalDecision: Record<string, unknown>;
185
- /**
186
- * Per-sub-agent slices for multi-agent runs (Pipeline / Swarm /
187
- * Routing patterns). Empty array for single-agent runs (the typical
188
- * Agent / LLMCall / RAG case). UIs check `subAgents.length > 0` to
189
- * decide between single-container and N-container rendering.
190
- *
191
- * Each entry is a self-contained sub-timeline keyed by the
192
- * `subflowPath[0]` of the events it owns. Multi-agent shells
193
- * iterate over `subAgents` and render one container per entry.
194
- */
195
- readonly subAgents: readonly SubAgentTimeline[];
196
- }
197
- type TimelineEntry = TurnStartEntry | LLMStartEntry | LLMEndEntry | ToolStartEntry | ToolEndEntry | TurnEndEntry | ContextInjectionEntry;
198
- interface BaseEntry {
199
- readonly runtimeStageId?: string;
200
- readonly timestamp: number;
201
- /**
202
- * Subflow path from outermost parent down to the subflow that
203
- * emitted this event. Populated by the executor on every EmitEvent
204
- * — preserved verbatim here so the folder can derive per-sub-agent
205
- * slices for multi-agent runs (group entries by `subflowPath[0]`).
206
- * Empty array for root-flowchart events (single-agent case).
207
- */
208
- readonly subflowPath: readonly string[];
209
- }
210
- interface TurnStartEntry extends BaseEntry {
211
- readonly type: 'turn_start';
212
- readonly userMessage: string;
213
- }
214
- interface LLMStartEntry extends BaseEntry {
215
- readonly type: 'llm_start';
216
- readonly iteration: number;
217
- }
218
- interface LLMEndEntry extends BaseEntry {
219
- readonly type: 'llm_end';
220
- readonly iteration: number;
221
- readonly content: string;
222
- readonly model?: string;
223
- readonly inputTokens?: number;
224
- readonly outputTokens?: number;
225
- readonly stopReason?: string;
226
- readonly durationMs?: number;
227
- readonly toolCallCount: number;
228
- }
229
- interface ToolStartEntry extends BaseEntry {
230
- readonly type: 'tool_start';
231
- readonly toolName: string;
232
- readonly toolCallId: string;
233
- readonly args: Record<string, unknown>;
234
- }
235
- interface ToolEndEntry extends BaseEntry {
236
- readonly type: 'tool_end';
237
- readonly toolCallId: string;
238
- readonly result: string;
239
- readonly error?: boolean;
240
- readonly durationMs?: number;
241
- }
242
- interface TurnEndEntry extends BaseEntry {
243
- readonly type: 'turn_end';
244
- readonly finalContent?: string;
245
- }
246
- interface ContextInjectionEntry extends BaseEntry {
247
- readonly type: 'context_injection';
248
- readonly source: string;
249
- readonly slot: 'system-prompt' | 'messages' | 'tools';
250
- readonly label: string;
251
- readonly role?: 'system' | 'user' | 'assistant' | 'tool';
252
- readonly targetIndex?: number;
253
- readonly deltaCount?: Record<string, number | boolean>;
254
- readonly payload: Record<string, unknown>;
255
- /**
256
- * Routing flag captured at emit time: was the LLM phase active?
257
- * True ⇒ this injection shapes THIS iter's prompt (e.g. RAG fired
258
- * between llm_start and llm_end). False ⇒ it prepares the NEXT iter
259
- * (e.g. skill activation post-`read_skill`). The folder uses this to
260
- * route injections to the correct iteration without re-deriving.
261
- */
262
- readonly attachedToCurrentIter: boolean;
263
- }
264
- export interface AgentTimelineRecorderOptions {
265
- /** Recorder id. Default: `agentfootprint-agent-timeline`. Override
266
- * for multi-agent so each sub-agent gets its own snapshot slot. */
267
- readonly id?: string;
268
- /**
269
- * Display name for the agent — surfaces on `timeline.agent.name` so
270
- * UIs can label the agent's container / card / panel without needing
271
- * the consumer to thread a separate prop. Defaults to "Agent" when
272
- * unset. Match this to `Agent.create({ name })` for end-to-end
273
- * consistency.
274
- */
275
- readonly name?: string;
276
- }
277
- export declare class AgentTimelineRecorder extends SequenceRecorder<TimelineEntry> implements EmitRecorder {
278
- readonly id: string;
279
- readonly name: string;
280
- /** True between an iter's llm_start and llm_end. Drives context-event
281
- * routing (THIS iter vs NEXT iter). */
282
- private llmPhaseActive;
283
- constructor(options?: AgentTimelineRecorderOptions);
284
- /**
285
- * Single entry point: every emit event the executor dispatches passes
286
- * through here. Translates the event into a TimelineEntry and stores
287
- * it via `SequenceRecorder.emit()`. Unknown events are silently
288
- * ignored — the executor delivers events from many subsystems and we
289
- * only care about agent-shaped ones.
290
- */
291
- onEmit(event: EmitEvent): void;
292
- /** Reset state. Called automatically by the executor before each
293
- * `run()` (recorder-pattern lifecycle hook). */
294
- clear(): void;
295
- /**
296
- * Fold the recorder's flat entry sequence into the agent-shaped
297
- * AgentTimeline. Pure derivation — same input always produces same
298
- * output. Cheap because entry count is bounded by run length.
299
- */
300
- getTimeline(): AgentTimeline;
301
- }
302
- /**
303
- * Public factory. Use this in app code rather than `new AgentTimelineRecorder()`
304
- * — matches the convention of `agentObservability()`, `contextEngineering()`,
305
- * and footprintjs's `narrative()` / `metrics()` / `debug()`.
306
- */
307
- export declare function agentTimeline(options?: AgentTimelineRecorderOptions): AgentTimelineRecorder;
308
- export {};
309
- //# sourceMappingURL=AgentTimelineRecorder.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"AgentTimelineRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/AgentTimelineRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAUrD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,yCAAyC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,GAAG,OAAO,CAAC;IACtD,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACzD,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACvD,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AAElE,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,iBAAiB,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC7D,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,iBAAiB,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC7D,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;CAC5C;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;gCAE4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B;iDAC6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD;;;;;;;;;OASG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACjD;AASD,KAAK,aAAa,GACd,cAAc,GACd,aAAa,GACb,WAAW,GACX,cAAc,GACd,YAAY,GACZ,YAAY,GACZ,qBAAqB,CAAC;AAE1B,UAAU,SAAS;IACjB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,UAAU,cAAe,SAAQ,SAAS;IACxC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AACD,UAAU,aAAc,SAAQ,SAAS;IACvC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AACD,UAAU,WAAY,SAAQ,SAAS;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AACD,UAAU,cAAe,SAAQ,SAAS;IACxC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AACD,UAAU,YAAa,SAAQ,SAAS;IACtC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AACD,UAAU,YAAa,SAAQ,SAAS;IACtC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AACD,UAAU,qBAAsB,SAAQ,SAAS;IAC/C,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,GAAG,OAAO,CAAC;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C;;;;;;OAMG;IACH,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACzC;AAID,MAAM,WAAW,4BAA4B;IAC3C;wEACoE;IACpE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,qBAAsB,SAAQ,gBAAgB,CAAC,aAAa,CAAE,YAAW,YAAY;IAChG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;4CACwC;IACxC,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,CAAC,EAAE,4BAA4B;IAQlD;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAW9B;qDACiD;IACxC,KAAK,IAAI,IAAI;IAOtB;;;;OAIG;IACH,WAAW,IAAI,aAAa;CAG7B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,4BAA4B,GAAG,qBAAqB,CAE3F"}
@@ -1,30 +0,0 @@
1
- /**
2
- * CompositeRecorder — fans out events to multiple AgentRecorders.
3
- *
4
- * Convenience wrapper that dispatches each event to all child recorders.
5
- * Error in one recorder does not affect others (error isolation).
6
- *
7
- * Usage:
8
- * const composite = new CompositeRecorder([
9
- * new TokenRecorder(),
10
- * new QualityRecorder(judge),
11
- * new GuardrailRecorder(check),
12
- * ]);
13
- * agent.recorder(composite);
14
- */
15
- import type { AgentRecorder, TurnStartEvent, LLMCallEvent, ToolCallEvent, TurnCompleteEvent, AgentErrorEvent } from '../core';
16
- export declare class CompositeRecorder implements AgentRecorder {
17
- readonly id: string;
18
- private readonly recorders;
19
- constructor(recorders: readonly AgentRecorder[], id?: string);
20
- onTurnStart(event: TurnStartEvent): void;
21
- onLLMCall(event: LLMCallEvent): void;
22
- onToolCall(event: ToolCallEvent): void;
23
- onTurnComplete(event: TurnCompleteEvent): void;
24
- onError(event: AgentErrorEvent): void;
25
- clear(): void;
26
- /** Access child recorders for inspection. */
27
- getRecorders(): readonly AgentRecorder[];
28
- private dispatch;
29
- }
30
- //# sourceMappingURL=CompositeRecorder.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"CompositeRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/CompositeRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,qBAAa,iBAAkB,YAAW,aAAa;IACrD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;gBAEzC,SAAS,EAAE,SAAS,aAAa,EAAE,EAAE,EAAE,SAAuB;IAK1E,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAIxC,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAIpC,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAItC,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAI9C,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAIrC,KAAK,IAAI,IAAI;IAUb,6CAA6C;IAC7C,YAAY,IAAI,SAAS,aAAa,EAAE;IAIxC,OAAO,CAAC,QAAQ;CAYjB"}
@@ -1,105 +0,0 @@
1
- /**
2
- * ContextEngineeringRecorder — captures every `agentfootprint.context.*`
3
- * emit and exposes a structured per-injection record + per-iteration
4
- * accumulated ledger.
5
- *
6
- * THE ABSTRACTION (parallels footprintjs CombinedNarrativeRecorder):
7
- * The library emits structured context-engineering events at every
8
- * injection point (RAG augmentPrompt, Memory formatDefault, Skill
9
- * activation, Instructions firing). This recorder is the one place
10
- * any UI / observability tool can consume that stream — Lens uses it,
11
- * a custom React dashboard uses it, a CLI logger uses it, a Datadog
12
- * exporter uses it. One recorder, one shape, every consumer.
13
- *
14
- * Mental model (from the user's library mission):
15
- * `agentfootprint = context engineering, visible.`
16
- * The library emits → ContextEngineeringRecorder collects → UI consumes.
17
- *
18
- * @example
19
- * ```ts
20
- * import { Agent, contextEngineering, anthropic } from 'agentfootprint';
21
- *
22
- * const ctx = contextEngineering();
23
- * const agent = Agent.create({ provider: anthropic('claude-sonnet-4') })
24
- * .recorder(ctx)
25
- * .build();
26
- *
27
- * await agent.run('Find the answer in our docs');
28
- *
29
- * ctx.injections(); // [{ source: 'rag', slot: 'messages', role: 'system', ... }]
30
- * ctx.ledger(); // { system: 1, systemPromptChars: 1200, tools: 3 }
31
- * ctx.bySource(); // { rag: [...], skill: [...] }
32
- * ctx.bySlot(); // { 'messages': [...], 'system-prompt': [...] }
33
- * ```
34
- *
35
- * Implements footprintjs's `EmitRecorder` interface so it attaches via
36
- * the same `.recorder()` chain as every other recorder. Idempotent on
37
- * re-attach (same id → replaces; different id → coexists).
38
- */
39
- import type { EmitRecorder } from 'footprintjs';
40
- /** A single context-engineering injection captured during a run.
41
- * Mirrors the emit-payload shape — extra fields in `payload` flow
42
- * through for advanced consumers that want the raw signal. */
43
- export interface ContextInjectionRecord {
44
- /** Source name — `rag` / `memory` / `skill` / `instructions` / etc. */
45
- readonly source: string;
46
- /** Which Agent slot this injection targets. */
47
- readonly slot: 'system-prompt' | 'messages' | 'tools';
48
- /** Wire-level LLM role when the slot is `messages`. Undefined for
49
- * system-prompt / tools (those mutate the slot directly). */
50
- readonly role?: 'system' | 'user' | 'assistant' | 'tool';
51
- /** Position in `messages[]` where the injected message landed. */
52
- readonly targetIndex?: number;
53
- /** Per-slot count deltas — sums into the ledger. Open keys: numeric
54
- * counters add, booleans OR. */
55
- readonly deltaCount?: Readonly<Record<string, number | boolean>>;
56
- /** Original emit-channel event name (e.g. `agentfootprint.context.rag.chunks`).
57
- * Lets consumers route on the SPECIFIC source variant when the
58
- * generic `source` isn't fine-grained enough. */
59
- readonly eventName: string;
60
- /** Raw payload from the emit event — full fidelity for advanced UIs. */
61
- readonly payload: Readonly<Record<string, unknown>>;
62
- /** Stage that fired the emit, from footprintjs's emit-event metadata.
63
- * Links the injection back to the exact stage in the execution tree. */
64
- readonly runtimeStageId?: string;
65
- /** Iteration number this injection landed in. Best-effort — derived
66
- * from how many `agentfootprint.stream.llm_start` events have fired
67
- * before this injection. Undefined when no LLM call yet. */
68
- readonly iteration?: number;
69
- }
70
- /** Open-keyed ledger — sum of every injection's `deltaCount`. Numbers
71
- * add, booleans OR. Standard keys: `system` / `user` / `assistant` /
72
- * `tool` (message-role counters), `systemPromptChars`, `tools`,
73
- * `toolsFromSkill`. New keys flow through unchanged. */
74
- export type ContextLedger = Readonly<Record<string, number | boolean>>;
75
- export interface ContextEngineeringRecorder extends EmitRecorder {
76
- /** All injections in emit order. */
77
- injections(): readonly ContextInjectionRecord[];
78
- /** Cumulative ledger across the whole run. */
79
- ledger(): ContextLedger;
80
- /** Per-iteration ledger (1-based iteration → ledger). Iteration
81
- * derived from preceding `agentfootprint.stream.llm_start` events. */
82
- ledgerByIteration(): ReadonlyMap<number, ContextLedger>;
83
- /** Injections grouped by source name. */
84
- bySource(): Readonly<Record<string, readonly ContextInjectionRecord[]>>;
85
- /** Injections grouped by Agent slot. */
86
- bySlot(): Readonly<Record<string, readonly ContextInjectionRecord[]>>;
87
- /** Reset to empty — called by runners between independent runs.
88
- * No-op when the recorder hasn't been attached yet. */
89
- clear(): void;
90
- }
91
- export interface ContextEngineeringRecorderOptions {
92
- /** Recorder id — defaults to `'context-engineering'`. Override only
93
- * when running multiple instances side-by-side (different filters,
94
- * different sinks). */
95
- readonly id?: string;
96
- }
97
- /**
98
- * Build a fresh ContextEngineeringRecorder.
99
- *
100
- * Function-factory style mirrors `agentObservability()` and footprintjs's
101
- * `narrative()` — keeps the construction site short and consumers don't
102
- * need to remember the class name.
103
- */
104
- export declare function contextEngineering(options?: ContextEngineeringRecorderOptions): ContextEngineeringRecorder;
105
- //# sourceMappingURL=ContextEngineeringRecorder.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"ContextEngineeringRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/ContextEngineeringRecorder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,aAAa,CAAC;AAE3D;;+DAE+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,GAAG,OAAO,CAAC;IACtD;kEAC8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACzD,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;qCACiC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IACjE;;sDAEkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD;6EACyE;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;iEAE6D;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;yDAGyD;AACzD,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;AAEvE,MAAM,WAAW,0BAA2B,SAAQ,YAAY;IAC9D,oCAAoC;IACpC,UAAU,IAAI,SAAS,sBAAsB,EAAE,CAAC;IAChD,8CAA8C;IAC9C,MAAM,IAAI,aAAa,CAAC;IACxB;2EACuE;IACvE,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxD,yCAAyC;IACzC,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,CAAC,CAAC;IACxE,wCAAwC;IACxC,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC,CAAC,CAAC;IACtE;4DACwD;IACxD,KAAK,IAAI,IAAI,CAAC;CACf;AAKD,MAAM,WAAW,iCAAiC;IAChD;;4BAEwB;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,CAAC,EAAE,iCAAiC,GAC1C,0BAA0B,CAsF5B"}
@@ -1,43 +0,0 @@
1
- /**
2
- * CostRecorder — calculates USD cost from AgentRecorder LLM call events.
3
- *
4
- * Extends KeyedRecorder<CostEntry> — Map keyed by runtimeStageId.
5
- */
6
- import { KeyedRecorder } from 'footprintjs/trace';
7
- import type { AgentRecorder, LLMCallEvent } from '../core';
8
- import type { ModelPricing } from '../models/types';
9
- export type { ModelPricing } from '../models/types';
10
- export interface CostEntry {
11
- readonly model: string;
12
- readonly inputTokens: number;
13
- readonly outputTokens: number;
14
- readonly inputCost: number;
15
- readonly outputCost: number;
16
- readonly totalCost: number;
17
- readonly runtimeStageId: string;
18
- }
19
- export interface CostRecorderOptions {
20
- readonly id?: string;
21
- readonly pricingTable?: Record<string, ModelPricing>;
22
- }
23
- export declare class CostRecorder extends KeyedRecorder<CostEntry> implements AgentRecorder {
24
- readonly id: string;
25
- private pricingTable;
26
- constructor(options?: CostRecorderOptions);
27
- onLLMCall(event: LLMCallEvent): void;
28
- getTotalCost(): number;
29
- getEntries(): CostEntry[];
30
- toSnapshot(): {
31
- name: string;
32
- description: string;
33
- preferredOperation: "accumulate";
34
- data: {
35
- numericField: string;
36
- grandTotal: number;
37
- steps: {
38
- [k: string]: CostEntry;
39
- };
40
- };
41
- };
42
- }
43
- //# sourceMappingURL=CostRecorder.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"CostRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/CostRecorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACtD;AAED,qBAAa,YAAa,SAAQ,aAAa,CAAC,SAAS,CAAE,YAAW,aAAa;IACjF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,YAAY,CAA+B;gBAEvC,OAAO,GAAE,mBAAwB;IAM7C,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAoBpC,YAAY,IAAI,MAAM;IAItB,UAAU,IAAI,SAAS,EAAE;IAIzB,UAAU;;;;;;;;;;;;CAYX"}
@@ -1,117 +0,0 @@
1
- /**
2
- * ExplainRecorder — collects grounding evidence + evaluation context during traversal.
3
- *
4
- * Data is structured per-iteration for evaluation:
5
- * iterations[0] = { context (what LLM had), decisions (tools chosen), sources (results), claim? }
6
- * iterations[1] = { context (updated with tool results), decisions, sources, claim (final answer) }
7
- *
8
- * An evaluator walks iterations: for each one that has a claim, check if it's
9
- * grounded in that iteration's sources + all prior sources.
10
- *
11
- * Usage:
12
- * const explain = new ExplainRecorder();
13
- * agent.recorder(explain);
14
- * await agent.run('Check order');
15
- *
16
- * const report = explain.explain();
17
- * report.iterations; // per-iteration evaluation units
18
- * report.sources; // flat convenience (all sources)
19
- * report.claims; // flat convenience (all claims)
20
- * report.context; // last context snapshot
21
- */
22
- import type { AgentRecorder, LLMCallEvent, ToolCallEvent, TurnStartEvent, TurnCompleteEvent } from '../core';
23
- /** A source of truth — data returned by a tool. */
24
- export interface ToolSource {
25
- readonly toolName: string;
26
- readonly args: Record<string, unknown>;
27
- readonly result: string;
28
- readonly turnNumber?: number;
29
- }
30
- /** A claim made by the LLM in its response. */
31
- export interface LLMClaim {
32
- readonly content: string;
33
- readonly model?: string;
34
- readonly iteration: number;
35
- }
36
- /** A decision the LLM made (tool call). */
37
- export interface AgentDecision {
38
- readonly toolName: string;
39
- readonly args: Record<string, unknown>;
40
- readonly latencyMs: number;
41
- }
42
- /** The context the LLM had when making decisions — for evaluation. */
43
- export interface LLMContext {
44
- /** The user's original question/input. */
45
- readonly input?: string;
46
- /** System prompt the LLM received. */
47
- readonly systemPrompt?: string;
48
- /** Tool descriptions sent to the LLM (what tools were available). */
49
- readonly availableTools?: ReadonlyArray<{
50
- name: string;
51
- description: string;
52
- }>;
53
- /** Messages sent to the LLM (conversation context). */
54
- readonly messages?: ReadonlyArray<{
55
- role: string;
56
- content: unknown;
57
- }>;
58
- /** Model used. */
59
- readonly model?: string;
60
- }
61
- /** One iteration of the agent loop — a self-contained evaluation unit. */
62
- export interface EvalIteration {
63
- /** Loop iteration number (0-based). */
64
- readonly iteration: number;
65
- /** Unique execution step identifier for this LLM call. */
66
- readonly runtimeStageId?: string;
67
- /** What the LLM had THIS iteration (context changes each loop — messages grow). */
68
- readonly context: LLMContext;
69
- /** Tool calls the LLM chose to make (empty if final response). */
70
- readonly decisions: readonly AgentDecision[];
71
- /** Tool results returned (empty if no tools called). */
72
- readonly sources: readonly ToolSource[];
73
- /** LLM's response — null for tool-calling iterations, string for final answer. */
74
- readonly claim: LLMClaim | null;
75
- }
76
- /** Structured explanation — everything needed for evaluation. */
77
- export interface Explanation {
78
- /** Per-iteration evaluation units — the connected data shape. */
79
- readonly iterations: readonly EvalIteration[];
80
- /** Flat convenience: all sources across all iterations. */
81
- readonly sources: readonly ToolSource[];
82
- /** Flat convenience: all claims across all iterations. */
83
- readonly claims: readonly LLMClaim[];
84
- /** Flat convenience: all decisions across all iterations. */
85
- readonly decisions: readonly AgentDecision[];
86
- /** Last context snapshot (same as iterations[last].context). */
87
- readonly context: LLMContext;
88
- readonly summary: string;
89
- }
90
- export declare class ExplainRecorder implements AgentRecorder {
91
- readonly id: string;
92
- private iterations;
93
- private currentIterationDecisions;
94
- private currentIterationSources;
95
- private currentTurn;
96
- private input?;
97
- private currentIteration;
98
- private currentRuntimeStageId?;
99
- private currentContext;
100
- constructor(id?: string);
101
- onTurnStart(event: TurnStartEvent): void;
102
- onLLMCall(event: LLMCallEvent): void;
103
- onToolCall(event: ToolCallEvent): void;
104
- onTurnComplete(event: TurnCompleteEvent): void;
105
- /** Flush current iteration data into the iterations array. */
106
- private flushIteration;
107
- getSources(): readonly ToolSource[];
108
- getClaims(): readonly LLMClaim[];
109
- getDecisions(): readonly AgentDecision[];
110
- getContext(): LLMContext;
111
- /** Per-iteration evaluation units. */
112
- getIterations(): readonly EvalIteration[];
113
- /** Structured explanation — flat + per-iteration, everything for evaluation. */
114
- explain(): Explanation;
115
- clear(): void;
116
- }
117
- //# sourceMappingURL=ExplainRecorder.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"ExplainRecorder.d.ts","sourceRoot":"","sources":["../../../src/recorders/ExplainRecorder.ts"],"names":[],"mappings":"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"}