agentfootprint 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (960) hide show
  1. package/AGENTS.md +297 -0
  2. package/CLAUDE.md +297 -0
  3. package/LICENSE +21 -0
  4. package/README.md +339 -0
  5. package/ai-instructions/claude-code/SKILL.md +597 -0
  6. package/ai-instructions/clinerules +85 -0
  7. package/ai-instructions/copilot-instructions.md +109 -0
  8. package/ai-instructions/cursor/agentfootprint.md +101 -0
  9. package/ai-instructions/kiro/agentfootprint.md +101 -0
  10. package/ai-instructions/setup.sh +140 -0
  11. package/ai-instructions/windsurfrules +85 -0
  12. package/dist/adapters/a2a/a2aRunner.js +36 -0
  13. package/dist/adapters/a2a/a2aRunner.js.map +1 -0
  14. package/dist/adapters/anthropic/AnthropicAdapter.js +293 -0
  15. package/dist/adapters/anthropic/AnthropicAdapter.js.map +1 -0
  16. package/dist/adapters/bedrock/BedrockAdapter.js +313 -0
  17. package/dist/adapters/bedrock/BedrockAdapter.js.map +1 -0
  18. package/dist/adapters/browser/BrowserAnthropicAdapter.js +349 -0
  19. package/dist/adapters/browser/BrowserAnthropicAdapter.js.map +1 -0
  20. package/dist/adapters/browser/BrowserOpenAIAdapter.js +303 -0
  21. package/dist/adapters/browser/BrowserOpenAIAdapter.js.map +1 -0
  22. package/dist/adapters/browser/index.js +8 -0
  23. package/dist/adapters/browser/index.js.map +1 -0
  24. package/dist/adapters/createAdapterSubflow.js +46 -0
  25. package/dist/adapters/createAdapterSubflow.js.map +1 -0
  26. package/dist/adapters/createProvider.js +107 -0
  27. package/dist/adapters/createProvider.js.map +1 -0
  28. package/dist/adapters/fallbackProvider.js +94 -0
  29. package/dist/adapters/fallbackProvider.js.map +1 -0
  30. package/dist/adapters/index.js +47 -0
  31. package/dist/adapters/index.js.map +1 -0
  32. package/dist/adapters/mcp/mcpToolProvider.js +44 -0
  33. package/dist/adapters/mcp/mcpToolProvider.js.map +1 -0
  34. package/dist/adapters/memory/inMemory.js +38 -0
  35. package/dist/adapters/memory/inMemory.js.map +1 -0
  36. package/dist/adapters/memory/index.js +6 -0
  37. package/dist/adapters/memory/index.js.map +1 -0
  38. package/dist/adapters/memory/stores.js +137 -0
  39. package/dist/adapters/memory/stores.js.map +1 -0
  40. package/dist/adapters/memory/types.js +14 -0
  41. package/dist/adapters/memory/types.js.map +1 -0
  42. package/dist/adapters/mock/MockAdapter.js +66 -0
  43. package/dist/adapters/mock/MockAdapter.js.map +1 -0
  44. package/dist/adapters/mock/MockRetriever.js +61 -0
  45. package/dist/adapters/mock/MockRetriever.js.map +1 -0
  46. package/dist/adapters/openai/OpenAIAdapter.js +276 -0
  47. package/dist/adapters/openai/OpenAIAdapter.js.map +1 -0
  48. package/dist/adapters/resilientProvider.js +93 -0
  49. package/dist/adapters/resilientProvider.js.map +1 -0
  50. package/dist/compositions/index.js +17 -0
  51. package/dist/compositions/index.js.map +1 -0
  52. package/dist/compositions/withCircuitBreaker.js +84 -0
  53. package/dist/compositions/withCircuitBreaker.js.map +1 -0
  54. package/dist/compositions/withFallback.js +33 -0
  55. package/dist/compositions/withFallback.js.map +1 -0
  56. package/dist/compositions/withRetry.js +59 -0
  57. package/dist/compositions/withRetry.js.map +1 -0
  58. package/dist/concepts/FlowChart.js +205 -0
  59. package/dist/concepts/FlowChart.js.map +1 -0
  60. package/dist/concepts/LLMCall.js +160 -0
  61. package/dist/concepts/LLMCall.js.map +1 -0
  62. package/dist/concepts/Parallel.js +254 -0
  63. package/dist/concepts/Parallel.js.map +1 -0
  64. package/dist/concepts/RAG.js +198 -0
  65. package/dist/concepts/RAG.js.map +1 -0
  66. package/dist/concepts/Swarm.js +270 -0
  67. package/dist/concepts/Swarm.js.map +1 -0
  68. package/dist/concepts/index.js +23 -0
  69. package/dist/concepts/index.js.map +1 -0
  70. package/dist/concepts/specIcons.js +48 -0
  71. package/dist/concepts/specIcons.js.map +1 -0
  72. package/dist/core/config.js +7 -0
  73. package/dist/core/config.js.map +1 -0
  74. package/dist/core/index.js +14 -0
  75. package/dist/core/index.js.map +1 -0
  76. package/dist/core/providers.js +19 -0
  77. package/dist/core/providers.js.map +1 -0
  78. package/dist/core/recorders.js +7 -0
  79. package/dist/core/recorders.js.map +1 -0
  80. package/dist/esm/adapters/a2a/a2aRunner.js +32 -0
  81. package/dist/esm/adapters/a2a/a2aRunner.js.map +1 -0
  82. package/dist/esm/adapters/anthropic/AnthropicAdapter.js +289 -0
  83. package/dist/esm/adapters/anthropic/AnthropicAdapter.js.map +1 -0
  84. package/dist/esm/adapters/bedrock/BedrockAdapter.js +309 -0
  85. package/dist/esm/adapters/bedrock/BedrockAdapter.js.map +1 -0
  86. package/dist/esm/adapters/browser/BrowserAnthropicAdapter.js +345 -0
  87. package/dist/esm/adapters/browser/BrowserAnthropicAdapter.js.map +1 -0
  88. package/dist/esm/adapters/browser/BrowserOpenAIAdapter.js +299 -0
  89. package/dist/esm/adapters/browser/BrowserOpenAIAdapter.js.map +1 -0
  90. package/dist/esm/adapters/browser/index.js +3 -0
  91. package/dist/esm/adapters/browser/index.js.map +1 -0
  92. package/dist/esm/adapters/createAdapterSubflow.js +42 -0
  93. package/dist/esm/adapters/createAdapterSubflow.js.map +1 -0
  94. package/dist/esm/adapters/createProvider.js +101 -0
  95. package/dist/esm/adapters/createProvider.js.map +1 -0
  96. package/dist/esm/adapters/fallbackProvider.js +90 -0
  97. package/dist/esm/adapters/fallbackProvider.js.map +1 -0
  98. package/dist/esm/adapters/index.js +23 -0
  99. package/dist/esm/adapters/index.js.map +1 -0
  100. package/dist/esm/adapters/mcp/mcpToolProvider.js +40 -0
  101. package/dist/esm/adapters/mcp/mcpToolProvider.js.map +1 -0
  102. package/dist/esm/adapters/memory/inMemory.js +34 -0
  103. package/dist/esm/adapters/memory/inMemory.js.map +1 -0
  104. package/dist/esm/adapters/memory/index.js +2 -0
  105. package/dist/esm/adapters/memory/index.js.map +1 -0
  106. package/dist/esm/adapters/memory/stores.js +131 -0
  107. package/dist/esm/adapters/memory/stores.js.map +1 -0
  108. package/dist/esm/adapters/memory/types.js +13 -0
  109. package/dist/esm/adapters/memory/types.js.map +1 -0
  110. package/dist/esm/adapters/mock/MockAdapter.js +61 -0
  111. package/dist/esm/adapters/mock/MockAdapter.js.map +1 -0
  112. package/dist/esm/adapters/mock/MockRetriever.js +56 -0
  113. package/dist/esm/adapters/mock/MockRetriever.js.map +1 -0
  114. package/dist/esm/adapters/openai/OpenAIAdapter.js +272 -0
  115. package/dist/esm/adapters/openai/OpenAIAdapter.js.map +1 -0
  116. package/dist/esm/adapters/resilientProvider.js +89 -0
  117. package/dist/esm/adapters/resilientProvider.js.map +1 -0
  118. package/dist/esm/compositions/index.js +10 -0
  119. package/dist/esm/compositions/index.js.map +1 -0
  120. package/dist/esm/compositions/withCircuitBreaker.js +79 -0
  121. package/dist/esm/compositions/withCircuitBreaker.js.map +1 -0
  122. package/dist/esm/compositions/withFallback.js +29 -0
  123. package/dist/esm/compositions/withFallback.js.map +1 -0
  124. package/dist/esm/compositions/withRetry.js +55 -0
  125. package/dist/esm/compositions/withRetry.js.map +1 -0
  126. package/dist/esm/concepts/FlowChart.js +200 -0
  127. package/dist/esm/concepts/FlowChart.js.map +1 -0
  128. package/dist/esm/concepts/LLMCall.js +155 -0
  129. package/dist/esm/concepts/LLMCall.js.map +1 -0
  130. package/dist/esm/concepts/Parallel.js +249 -0
  131. package/dist/esm/concepts/Parallel.js.map +1 -0
  132. package/dist/esm/concepts/RAG.js +193 -0
  133. package/dist/esm/concepts/RAG.js.map +1 -0
  134. package/dist/esm/concepts/Swarm.js +265 -0
  135. package/dist/esm/concepts/Swarm.js.map +1 -0
  136. package/dist/esm/concepts/index.js +8 -0
  137. package/dist/esm/concepts/index.js.map +1 -0
  138. package/dist/esm/concepts/specIcons.js +44 -0
  139. package/dist/esm/concepts/specIcons.js.map +1 -0
  140. package/dist/esm/core/config.js +6 -0
  141. package/dist/esm/core/config.js.map +1 -0
  142. package/dist/esm/core/index.js +13 -0
  143. package/dist/esm/core/index.js.map +1 -0
  144. package/dist/esm/core/providers.js +18 -0
  145. package/dist/esm/core/providers.js.map +1 -0
  146. package/dist/esm/core/recorders.js +6 -0
  147. package/dist/esm/core/recorders.js.map +1 -0
  148. package/dist/esm/executor/agentLoop.js +150 -0
  149. package/dist/esm/executor/agentLoop.js.map +1 -0
  150. package/dist/esm/executor/index.js +5 -0
  151. package/dist/esm/executor/index.js.map +1 -0
  152. package/dist/esm/explain.barrel.js +19 -0
  153. package/dist/esm/explain.barrel.js.map +1 -0
  154. package/dist/esm/index.js +29 -0
  155. package/dist/esm/index.js.map +1 -0
  156. package/dist/esm/instructions.barrel.js +22 -0
  157. package/dist/esm/instructions.barrel.js.map +1 -0
  158. package/dist/esm/lib/call/callLLMStage.js +64 -0
  159. package/dist/esm/lib/call/callLLMStage.js.map +1 -0
  160. package/dist/esm/lib/call/handleResponseStage.js +49 -0
  161. package/dist/esm/lib/call/handleResponseStage.js.map +1 -0
  162. package/dist/esm/lib/call/helpers.js +164 -0
  163. package/dist/esm/lib/call/helpers.js.map +1 -0
  164. package/dist/esm/lib/call/index.js +7 -0
  165. package/dist/esm/lib/call/index.js.map +1 -0
  166. package/dist/esm/lib/call/parseResponseStage.js +48 -0
  167. package/dist/esm/lib/call/parseResponseStage.js.map +1 -0
  168. package/dist/esm/lib/call/streamingCallLLMStage.js +103 -0
  169. package/dist/esm/lib/call/streamingCallLLMStage.js.map +1 -0
  170. package/dist/esm/lib/call/toolExecutionSubflow.js +87 -0
  171. package/dist/esm/lib/call/toolExecutionSubflow.js.map +1 -0
  172. package/dist/esm/lib/call/types.js +10 -0
  173. package/dist/esm/lib/call/types.js.map +1 -0
  174. package/dist/esm/lib/concepts/Agent.js +7 -0
  175. package/dist/esm/lib/concepts/Agent.js.map +1 -0
  176. package/dist/esm/lib/concepts/AgentBuilder.js +224 -0
  177. package/dist/esm/lib/concepts/AgentBuilder.js.map +1 -0
  178. package/dist/esm/lib/concepts/AgentRunner.js +337 -0
  179. package/dist/esm/lib/concepts/AgentRunner.js.map +1 -0
  180. package/dist/esm/lib/concepts/index.js +2 -0
  181. package/dist/esm/lib/concepts/index.js.map +1 -0
  182. package/dist/esm/lib/instructions/InstructionRecorder.js +121 -0
  183. package/dist/esm/lib/instructions/InstructionRecorder.js.map +1 -0
  184. package/dist/esm/lib/instructions/agentInstruction.js +139 -0
  185. package/dist/esm/lib/instructions/agentInstruction.js.map +1 -0
  186. package/dist/esm/lib/instructions/buildInstructionsToLLMSubflow.js +83 -0
  187. package/dist/esm/lib/instructions/buildInstructionsToLLMSubflow.js.map +1 -0
  188. package/dist/esm/lib/instructions/evaluator.js +196 -0
  189. package/dist/esm/lib/instructions/evaluator.js.map +1 -0
  190. package/dist/esm/lib/instructions/index.js +10 -0
  191. package/dist/esm/lib/instructions/index.js.map +1 -0
  192. package/dist/esm/lib/instructions/inject.js +55 -0
  193. package/dist/esm/lib/instructions/inject.js.map +1 -0
  194. package/dist/esm/lib/instructions/preview.js +88 -0
  195. package/dist/esm/lib/instructions/preview.js.map +1 -0
  196. package/dist/esm/lib/instructions/strictFollowUp.js +125 -0
  197. package/dist/esm/lib/instructions/strictFollowUp.js.map +1 -0
  198. package/dist/esm/lib/instructions/template.js +82 -0
  199. package/dist/esm/lib/instructions/template.js.map +1 -0
  200. package/dist/esm/lib/instructions/types.js +83 -0
  201. package/dist/esm/lib/instructions/types.js.map +1 -0
  202. package/dist/esm/lib/loop/buildAgentLoop.js +401 -0
  203. package/dist/esm/lib/loop/buildAgentLoop.js.map +1 -0
  204. package/dist/esm/lib/loop/index.js +3 -0
  205. package/dist/esm/lib/loop/index.js.map +1 -0
  206. package/dist/esm/lib/loop/types.js +71 -0
  207. package/dist/esm/lib/loop/types.js.map +1 -0
  208. package/dist/esm/lib/narrative/agentRenderer.js +293 -0
  209. package/dist/esm/lib/narrative/agentRenderer.js.map +1 -0
  210. package/dist/esm/lib/narrative/groundingHelpers.js +136 -0
  211. package/dist/esm/lib/narrative/groundingHelpers.js.map +1 -0
  212. package/dist/esm/lib/narrative/index.js +3 -0
  213. package/dist/esm/lib/narrative/index.js.map +1 -0
  214. package/dist/esm/lib/slots/helpers.js +23 -0
  215. package/dist/esm/lib/slots/helpers.js.map +1 -0
  216. package/dist/esm/lib/slots/index.js +4 -0
  217. package/dist/esm/lib/slots/index.js.map +1 -0
  218. package/dist/esm/lib/slots/messages/buildMessagesSubflow.js +108 -0
  219. package/dist/esm/lib/slots/messages/buildMessagesSubflow.js.map +1 -0
  220. package/dist/esm/lib/slots/messages/index.js +2 -0
  221. package/dist/esm/lib/slots/messages/index.js.map +1 -0
  222. package/dist/esm/lib/slots/messages/types.js +10 -0
  223. package/dist/esm/lib/slots/messages/types.js.map +1 -0
  224. package/dist/esm/lib/slots/system-prompt/buildSystemPromptSubflow.js +64 -0
  225. package/dist/esm/lib/slots/system-prompt/buildSystemPromptSubflow.js.map +1 -0
  226. package/dist/esm/lib/slots/system-prompt/index.js +2 -0
  227. package/dist/esm/lib/slots/system-prompt/index.js.map +1 -0
  228. package/dist/esm/lib/slots/system-prompt/types.js +9 -0
  229. package/dist/esm/lib/slots/system-prompt/types.js.map +1 -0
  230. package/dist/esm/lib/slots/tools/buildToolsSubflow.js +67 -0
  231. package/dist/esm/lib/slots/tools/buildToolsSubflow.js.map +1 -0
  232. package/dist/esm/lib/slots/tools/index.js +2 -0
  233. package/dist/esm/lib/slots/tools/index.js.map +1 -0
  234. package/dist/esm/lib/slots/tools/types.js +11 -0
  235. package/dist/esm/lib/slots/tools/types.js.map +1 -0
  236. package/dist/esm/lib/swarm/buildSwarmRouting.js +207 -0
  237. package/dist/esm/lib/swarm/buildSwarmRouting.js.map +1 -0
  238. package/dist/esm/lib/swarm/index.js +2 -0
  239. package/dist/esm/lib/swarm/index.js.map +1 -0
  240. package/dist/esm/memory/conversationHelpers.js +56 -0
  241. package/dist/esm/memory/conversationHelpers.js.map +1 -0
  242. package/dist/esm/memory/index.js +2 -0
  243. package/dist/esm/memory/index.js.map +1 -0
  244. package/dist/esm/models/index.js +3 -0
  245. package/dist/esm/models/index.js.map +1 -0
  246. package/dist/esm/models/pricing.js +23 -0
  247. package/dist/esm/models/pricing.js.map +1 -0
  248. package/dist/esm/models/providers.js +42 -0
  249. package/dist/esm/models/providers.js.map +1 -0
  250. package/dist/esm/models/types.js +6 -0
  251. package/dist/esm/models/types.js.map +1 -0
  252. package/dist/esm/observe.barrel.js +18 -0
  253. package/dist/esm/observe.barrel.js.map +1 -0
  254. package/dist/esm/providers/index.js +12 -0
  255. package/dist/esm/providers/index.js.map +1 -0
  256. package/dist/esm/providers/messages/charBudget.js +39 -0
  257. package/dist/esm/providers/messages/charBudget.js.map +1 -0
  258. package/dist/esm/providers/messages/compositeMessages.js +33 -0
  259. package/dist/esm/providers/messages/compositeMessages.js.map +1 -0
  260. package/dist/esm/providers/messages/fullHistory.js +15 -0
  261. package/dist/esm/providers/messages/fullHistory.js.map +1 -0
  262. package/dist/esm/providers/messages/index.js +11 -0
  263. package/dist/esm/providers/messages/index.js.map +1 -0
  264. package/dist/esm/providers/messages/persistentHistory.js +40 -0
  265. package/dist/esm/providers/messages/persistentHistory.js.map +1 -0
  266. package/dist/esm/providers/messages/slidingWindow.js +24 -0
  267. package/dist/esm/providers/messages/slidingWindow.js.map +1 -0
  268. package/dist/esm/providers/messages/summaryStrategy.js +41 -0
  269. package/dist/esm/providers/messages/summaryStrategy.js.map +1 -0
  270. package/dist/esm/providers/messages/withToolPairSafety.js +76 -0
  271. package/dist/esm/providers/messages/withToolPairSafety.js.map +1 -0
  272. package/dist/esm/providers/prompt/compositePrompt.js +28 -0
  273. package/dist/esm/providers/prompt/compositePrompt.js.map +1 -0
  274. package/dist/esm/providers/prompt/index.js +8 -0
  275. package/dist/esm/providers/prompt/index.js.map +1 -0
  276. package/dist/esm/providers/prompt/skillBasedPrompt.js +37 -0
  277. package/dist/esm/providers/prompt/skillBasedPrompt.js.map +1 -0
  278. package/dist/esm/providers/prompt/static.js +9 -0
  279. package/dist/esm/providers/prompt/static.js.map +1 -0
  280. package/dist/esm/providers/prompt/template.js +20 -0
  281. package/dist/esm/providers/prompt/template.js.map +1 -0
  282. package/dist/esm/providers/tools/PermissionPolicy.js +100 -0
  283. package/dist/esm/providers/tools/PermissionPolicy.js.map +1 -0
  284. package/dist/esm/providers/tools/agentAsTool.js +47 -0
  285. package/dist/esm/providers/tools/agentAsTool.js.map +1 -0
  286. package/dist/esm/providers/tools/compositeTools.js +49 -0
  287. package/dist/esm/providers/tools/compositeTools.js.map +1 -0
  288. package/dist/esm/providers/tools/dynamicTools.js +41 -0
  289. package/dist/esm/providers/tools/dynamicTools.js.map +1 -0
  290. package/dist/esm/providers/tools/gatedTools.js +90 -0
  291. package/dist/esm/providers/tools/gatedTools.js.map +1 -0
  292. package/dist/esm/providers/tools/index.js +11 -0
  293. package/dist/esm/providers/tools/index.js.map +1 -0
  294. package/dist/esm/providers/tools/noTools.js +9 -0
  295. package/dist/esm/providers/tools/noTools.js.map +1 -0
  296. package/dist/esm/providers/tools/staticTools.js +25 -0
  297. package/dist/esm/providers/tools/staticTools.js.map +1 -0
  298. package/dist/esm/providers.barrel.js +32 -0
  299. package/dist/esm/providers.barrel.js.map +1 -0
  300. package/dist/esm/recorders/index.js +5 -0
  301. package/dist/esm/recorders/index.js.map +1 -0
  302. package/dist/esm/recorders/v2/CompositeRecorder.js +65 -0
  303. package/dist/esm/recorders/v2/CompositeRecorder.js.map +1 -0
  304. package/dist/esm/recorders/v2/CostRecorder.js +47 -0
  305. package/dist/esm/recorders/v2/CostRecorder.js.map +1 -0
  306. package/dist/esm/recorders/v2/ExplainRecorder.js +93 -0
  307. package/dist/esm/recorders/v2/ExplainRecorder.js.map +1 -0
  308. package/dist/esm/recorders/v2/GuardrailRecorder.js +58 -0
  309. package/dist/esm/recorders/v2/GuardrailRecorder.js.map +1 -0
  310. package/dist/esm/recorders/v2/OTelRecorder.js +79 -0
  311. package/dist/esm/recorders/v2/OTelRecorder.js.map +1 -0
  312. package/dist/esm/recorders/v2/PermissionRecorder.js +86 -0
  313. package/dist/esm/recorders/v2/PermissionRecorder.js.map +1 -0
  314. package/dist/esm/recorders/v2/QualityRecorder.js +48 -0
  315. package/dist/esm/recorders/v2/QualityRecorder.js.map +1 -0
  316. package/dist/esm/recorders/v2/RecorderBridge.js +85 -0
  317. package/dist/esm/recorders/v2/RecorderBridge.js.map +1 -0
  318. package/dist/esm/recorders/v2/TokenRecorder.js +72 -0
  319. package/dist/esm/recorders/v2/TokenRecorder.js.map +1 -0
  320. package/dist/esm/recorders/v2/ToolUsageRecorder.js +54 -0
  321. package/dist/esm/recorders/v2/ToolUsageRecorder.js.map +1 -0
  322. package/dist/esm/recorders/v2/TurnRecorder.js +83 -0
  323. package/dist/esm/recorders/v2/TurnRecorder.js.map +1 -0
  324. package/dist/esm/recorders/v2/agentObservability.js +62 -0
  325. package/dist/esm/recorders/v2/agentObservability.js.map +1 -0
  326. package/dist/esm/recorders/v2/index.js +13 -0
  327. package/dist/esm/recorders/v2/index.js.map +1 -0
  328. package/dist/esm/resilience.barrel.js +16 -0
  329. package/dist/esm/resilience.barrel.js.map +1 -0
  330. package/dist/esm/scope/AgentScope.js +153 -0
  331. package/dist/esm/scope/AgentScope.js.map +1 -0
  332. package/dist/esm/scope/index.js +2 -0
  333. package/dist/esm/scope/index.js.map +1 -0
  334. package/dist/esm/scope/types.js +37 -0
  335. package/dist/esm/scope/types.js.map +1 -0
  336. package/dist/esm/security.barrel.js +17 -0
  337. package/dist/esm/security.barrel.js.map +1 -0
  338. package/dist/esm/stages/augmentPrompt.js +28 -0
  339. package/dist/esm/stages/augmentPrompt.js.map +1 -0
  340. package/dist/esm/stages/callLLM.js +15 -0
  341. package/dist/esm/stages/callLLM.js.map +1 -0
  342. package/dist/esm/stages/commitMemory.js +94 -0
  343. package/dist/esm/stages/commitMemory.js.map +1 -0
  344. package/dist/esm/stages/finalize.js +12 -0
  345. package/dist/esm/stages/finalize.js.map +1 -0
  346. package/dist/esm/stages/helpers.js +58 -0
  347. package/dist/esm/stages/helpers.js.map +1 -0
  348. package/dist/esm/stages/index.js +9 -0
  349. package/dist/esm/stages/index.js.map +1 -0
  350. package/dist/esm/stages/parseResponse.js +25 -0
  351. package/dist/esm/stages/parseResponse.js.map +1 -0
  352. package/dist/esm/stages/retrieve.js +18 -0
  353. package/dist/esm/stages/retrieve.js.map +1 -0
  354. package/dist/esm/stages/runnerAsStage.js +66 -0
  355. package/dist/esm/stages/runnerAsStage.js.map +1 -0
  356. package/dist/esm/stream.barrel.js +18 -0
  357. package/dist/esm/stream.barrel.js.map +1 -0
  358. package/dist/esm/streaming/StreamEmitter.js +43 -0
  359. package/dist/esm/streaming/StreamEmitter.js.map +1 -0
  360. package/dist/esm/streaming/index.js +2 -0
  361. package/dist/esm/streaming/index.js.map +1 -0
  362. package/dist/esm/subflows/index.js +2 -0
  363. package/dist/esm/subflows/index.js.map +1 -0
  364. package/dist/esm/subflows/prepareMemory.js +83 -0
  365. package/dist/esm/subflows/prepareMemory.js.map +1 -0
  366. package/dist/esm/tools/ToolRegistry.js +84 -0
  367. package/dist/esm/tools/ToolRegistry.js.map +1 -0
  368. package/dist/esm/tools/askHuman.js +63 -0
  369. package/dist/esm/tools/askHuman.js.map +1 -0
  370. package/dist/esm/tools/index.js +3 -0
  371. package/dist/esm/tools/index.js.map +1 -0
  372. package/dist/esm/tools/validateInput.js +56 -0
  373. package/dist/esm/tools/validateInput.js.map +1 -0
  374. package/dist/esm/tools/zodToJsonSchema.js +65 -0
  375. package/dist/esm/tools/zodToJsonSchema.js.map +1 -0
  376. package/dist/esm/types/adapter.js +11 -0
  377. package/dist/esm/types/adapter.js.map +1 -0
  378. package/dist/esm/types/agent.js +5 -0
  379. package/dist/esm/types/agent.js.map +1 -0
  380. package/dist/esm/types/content.js +82 -0
  381. package/dist/esm/types/content.js.map +1 -0
  382. package/dist/esm/types/errors.js +74 -0
  383. package/dist/esm/types/errors.js.map +1 -0
  384. package/dist/esm/types/index.js +5 -0
  385. package/dist/esm/types/index.js.map +1 -0
  386. package/dist/esm/types/llm.js +6 -0
  387. package/dist/esm/types/llm.js.map +1 -0
  388. package/dist/esm/types/messages.js +24 -0
  389. package/dist/esm/types/messages.js.map +1 -0
  390. package/dist/esm/types/multiAgent.js +5 -0
  391. package/dist/esm/types/multiAgent.js.map +1 -0
  392. package/dist/esm/types/retriever.js +6 -0
  393. package/dist/esm/types/retriever.js.map +1 -0
  394. package/dist/esm/types/tools.js +5 -0
  395. package/dist/esm/types/tools.js.map +1 -0
  396. package/dist/executor/agentLoop.js +154 -0
  397. package/dist/executor/agentLoop.js.map +1 -0
  398. package/dist/executor/index.js +9 -0
  399. package/dist/executor/index.js.map +1 -0
  400. package/dist/explain.barrel.js +27 -0
  401. package/dist/explain.barrel.js.map +1 -0
  402. package/dist/index.js +74 -0
  403. package/dist/index.js.map +1 -0
  404. package/dist/instructions.barrel.js +30 -0
  405. package/dist/instructions.barrel.js.map +1 -0
  406. package/dist/lib/call/callLLMStage.js +68 -0
  407. package/dist/lib/call/callLLMStage.js.map +1 -0
  408. package/dist/lib/call/handleResponseStage.js +53 -0
  409. package/dist/lib/call/handleResponseStage.js.map +1 -0
  410. package/dist/lib/call/helpers.js +169 -0
  411. package/dist/lib/call/helpers.js.map +1 -0
  412. package/dist/lib/call/index.js +17 -0
  413. package/dist/lib/call/index.js.map +1 -0
  414. package/dist/lib/call/parseResponseStage.js +52 -0
  415. package/dist/lib/call/parseResponseStage.js.map +1 -0
  416. package/dist/lib/call/streamingCallLLMStage.js +107 -0
  417. package/dist/lib/call/streamingCallLLMStage.js.map +1 -0
  418. package/dist/lib/call/toolExecutionSubflow.js +91 -0
  419. package/dist/lib/call/toolExecutionSubflow.js.map +1 -0
  420. package/dist/lib/call/types.js +11 -0
  421. package/dist/lib/call/types.js.map +1 -0
  422. package/dist/lib/concepts/Agent.js +12 -0
  423. package/dist/lib/concepts/Agent.js.map +1 -0
  424. package/dist/lib/concepts/AgentBuilder.js +228 -0
  425. package/dist/lib/concepts/AgentBuilder.js.map +1 -0
  426. package/dist/lib/concepts/AgentRunner.js +341 -0
  427. package/dist/lib/concepts/AgentRunner.js.map +1 -0
  428. package/dist/lib/concepts/index.js +7 -0
  429. package/dist/lib/concepts/index.js.map +1 -0
  430. package/dist/lib/instructions/InstructionRecorder.js +125 -0
  431. package/dist/lib/instructions/InstructionRecorder.js.map +1 -0
  432. package/dist/lib/instructions/agentInstruction.js +144 -0
  433. package/dist/lib/instructions/agentInstruction.js.map +1 -0
  434. package/dist/lib/instructions/buildInstructionsToLLMSubflow.js +87 -0
  435. package/dist/lib/instructions/buildInstructionsToLLMSubflow.js.map +1 -0
  436. package/dist/lib/instructions/evaluator.js +202 -0
  437. package/dist/lib/instructions/evaluator.js.map +1 -0
  438. package/dist/lib/instructions/index.js +27 -0
  439. package/dist/lib/instructions/index.js.map +1 -0
  440. package/dist/lib/instructions/inject.js +59 -0
  441. package/dist/lib/instructions/inject.js.map +1 -0
  442. package/dist/lib/instructions/preview.js +92 -0
  443. package/dist/lib/instructions/preview.js.map +1 -0
  444. package/dist/lib/instructions/strictFollowUp.js +130 -0
  445. package/dist/lib/instructions/strictFollowUp.js.map +1 -0
  446. package/dist/lib/instructions/template.js +86 -0
  447. package/dist/lib/instructions/template.js.map +1 -0
  448. package/dist/lib/instructions/types.js +88 -0
  449. package/dist/lib/instructions/types.js.map +1 -0
  450. package/dist/lib/loop/buildAgentLoop.js +405 -0
  451. package/dist/lib/loop/buildAgentLoop.js.map +1 -0
  452. package/dist/lib/loop/index.js +9 -0
  453. package/dist/lib/loop/index.js.map +1 -0
  454. package/dist/lib/loop/types.js +74 -0
  455. package/dist/lib/loop/types.js.map +1 -0
  456. package/dist/lib/narrative/agentRenderer.js +297 -0
  457. package/dist/lib/narrative/agentRenderer.js.map +1 -0
  458. package/dist/lib/narrative/groundingHelpers.js +142 -0
  459. package/dist/lib/narrative/groundingHelpers.js.map +1 -0
  460. package/dist/lib/narrative/index.js +10 -0
  461. package/dist/lib/narrative/index.js.map +1 -0
  462. package/dist/lib/slots/helpers.js +28 -0
  463. package/dist/lib/slots/helpers.js.map +1 -0
  464. package/dist/lib/slots/index.js +10 -0
  465. package/dist/lib/slots/index.js.map +1 -0
  466. package/dist/lib/slots/messages/buildMessagesSubflow.js +112 -0
  467. package/dist/lib/slots/messages/buildMessagesSubflow.js.map +1 -0
  468. package/dist/lib/slots/messages/index.js +6 -0
  469. package/dist/lib/slots/messages/index.js.map +1 -0
  470. package/dist/lib/slots/messages/types.js +11 -0
  471. package/dist/lib/slots/messages/types.js.map +1 -0
  472. package/dist/lib/slots/system-prompt/buildSystemPromptSubflow.js +68 -0
  473. package/dist/lib/slots/system-prompt/buildSystemPromptSubflow.js.map +1 -0
  474. package/dist/lib/slots/system-prompt/index.js +6 -0
  475. package/dist/lib/slots/system-prompt/index.js.map +1 -0
  476. package/dist/lib/slots/system-prompt/types.js +10 -0
  477. package/dist/lib/slots/system-prompt/types.js.map +1 -0
  478. package/dist/lib/slots/tools/buildToolsSubflow.js +71 -0
  479. package/dist/lib/slots/tools/buildToolsSubflow.js.map +1 -0
  480. package/dist/lib/slots/tools/index.js +6 -0
  481. package/dist/lib/slots/tools/index.js.map +1 -0
  482. package/dist/lib/slots/tools/types.js +12 -0
  483. package/dist/lib/slots/tools/types.js.map +1 -0
  484. package/dist/lib/swarm/buildSwarmRouting.js +211 -0
  485. package/dist/lib/swarm/buildSwarmRouting.js.map +1 -0
  486. package/dist/lib/swarm/index.js +6 -0
  487. package/dist/lib/swarm/index.js.map +1 -0
  488. package/dist/memory/conversationHelpers.js +66 -0
  489. package/dist/memory/conversationHelpers.js.map +1 -0
  490. package/dist/memory/index.js +12 -0
  491. package/dist/memory/index.js.map +1 -0
  492. package/dist/models/index.js +12 -0
  493. package/dist/models/index.js.map +1 -0
  494. package/dist/models/pricing.js +27 -0
  495. package/dist/models/pricing.js.map +1 -0
  496. package/dist/models/providers.js +49 -0
  497. package/dist/models/providers.js.map +1 -0
  498. package/dist/models/types.js +7 -0
  499. package/dist/models/types.js.map +1 -0
  500. package/dist/observe.barrel.js +31 -0
  501. package/dist/observe.barrel.js.map +1 -0
  502. package/dist/providers/index.js +34 -0
  503. package/dist/providers/index.js.map +1 -0
  504. package/dist/providers/messages/charBudget.js +43 -0
  505. package/dist/providers/messages/charBudget.js.map +1 -0
  506. package/dist/providers/messages/compositeMessages.js +37 -0
  507. package/dist/providers/messages/compositeMessages.js.map +1 -0
  508. package/dist/providers/messages/fullHistory.js +19 -0
  509. package/dist/providers/messages/fullHistory.js.map +1 -0
  510. package/dist/providers/messages/index.js +22 -0
  511. package/dist/providers/messages/index.js.map +1 -0
  512. package/dist/providers/messages/persistentHistory.js +45 -0
  513. package/dist/providers/messages/persistentHistory.js.map +1 -0
  514. package/dist/providers/messages/slidingWindow.js +28 -0
  515. package/dist/providers/messages/slidingWindow.js.map +1 -0
  516. package/dist/providers/messages/summaryStrategy.js +45 -0
  517. package/dist/providers/messages/summaryStrategy.js.map +1 -0
  518. package/dist/providers/messages/withToolPairSafety.js +80 -0
  519. package/dist/providers/messages/withToolPairSafety.js.map +1 -0
  520. package/dist/providers/prompt/compositePrompt.js +32 -0
  521. package/dist/providers/prompt/compositePrompt.js.map +1 -0
  522. package/dist/providers/prompt/index.js +15 -0
  523. package/dist/providers/prompt/index.js.map +1 -0
  524. package/dist/providers/prompt/skillBasedPrompt.js +41 -0
  525. package/dist/providers/prompt/skillBasedPrompt.js.map +1 -0
  526. package/dist/providers/prompt/static.js +13 -0
  527. package/dist/providers/prompt/static.js.map +1 -0
  528. package/dist/providers/prompt/template.js +24 -0
  529. package/dist/providers/prompt/template.js.map +1 -0
  530. package/dist/providers/tools/PermissionPolicy.js +104 -0
  531. package/dist/providers/tools/PermissionPolicy.js.map +1 -0
  532. package/dist/providers/tools/agentAsTool.js +51 -0
  533. package/dist/providers/tools/agentAsTool.js.map +1 -0
  534. package/dist/providers/tools/compositeTools.js +53 -0
  535. package/dist/providers/tools/compositeTools.js.map +1 -0
  536. package/dist/providers/tools/dynamicTools.js +45 -0
  537. package/dist/providers/tools/dynamicTools.js.map +1 -0
  538. package/dist/providers/tools/gatedTools.js +94 -0
  539. package/dist/providers/tools/gatedTools.js.map +1 -0
  540. package/dist/providers/tools/index.js +21 -0
  541. package/dist/providers/tools/index.js.map +1 -0
  542. package/dist/providers/tools/noTools.js +13 -0
  543. package/dist/providers/tools/noTools.js.map +1 -0
  544. package/dist/providers/tools/staticTools.js +29 -0
  545. package/dist/providers/tools/staticTools.js.map +1 -0
  546. package/dist/providers.barrel.js +61 -0
  547. package/dist/providers.barrel.js.map +1 -0
  548. package/dist/recorders/index.js +17 -0
  549. package/dist/recorders/index.js.map +1 -0
  550. package/dist/recorders/v2/CompositeRecorder.js +69 -0
  551. package/dist/recorders/v2/CompositeRecorder.js.map +1 -0
  552. package/dist/recorders/v2/CostRecorder.js +51 -0
  553. package/dist/recorders/v2/CostRecorder.js.map +1 -0
  554. package/dist/recorders/v2/ExplainRecorder.js +97 -0
  555. package/dist/recorders/v2/ExplainRecorder.js.map +1 -0
  556. package/dist/recorders/v2/GuardrailRecorder.js +62 -0
  557. package/dist/recorders/v2/GuardrailRecorder.js.map +1 -0
  558. package/dist/recorders/v2/OTelRecorder.js +83 -0
  559. package/dist/recorders/v2/OTelRecorder.js.map +1 -0
  560. package/dist/recorders/v2/PermissionRecorder.js +90 -0
  561. package/dist/recorders/v2/PermissionRecorder.js.map +1 -0
  562. package/dist/recorders/v2/QualityRecorder.js +52 -0
  563. package/dist/recorders/v2/QualityRecorder.js.map +1 -0
  564. package/dist/recorders/v2/RecorderBridge.js +89 -0
  565. package/dist/recorders/v2/RecorderBridge.js.map +1 -0
  566. package/dist/recorders/v2/TokenRecorder.js +76 -0
  567. package/dist/recorders/v2/TokenRecorder.js.map +1 -0
  568. package/dist/recorders/v2/ToolUsageRecorder.js +58 -0
  569. package/dist/recorders/v2/ToolUsageRecorder.js.map +1 -0
  570. package/dist/recorders/v2/TurnRecorder.js +87 -0
  571. package/dist/recorders/v2/TurnRecorder.js.map +1 -0
  572. package/dist/recorders/v2/agentObservability.js +66 -0
  573. package/dist/recorders/v2/agentObservability.js.map +1 -0
  574. package/dist/recorders/v2/index.js +25 -0
  575. package/dist/recorders/v2/index.js.map +1 -0
  576. package/dist/resilience.barrel.js +25 -0
  577. package/dist/resilience.barrel.js.map +1 -0
  578. package/dist/scope/AgentScope.js +156 -0
  579. package/dist/scope/AgentScope.js.map +1 -0
  580. package/dist/scope/index.js +10 -0
  581. package/dist/scope/index.js.map +1 -0
  582. package/dist/scope/types.js +40 -0
  583. package/dist/scope/types.js.map +1 -0
  584. package/dist/security.barrel.js +22 -0
  585. package/dist/security.barrel.js.map +1 -0
  586. package/dist/stages/augmentPrompt.js +32 -0
  587. package/dist/stages/augmentPrompt.js.map +1 -0
  588. package/dist/stages/callLLM.js +19 -0
  589. package/dist/stages/callLLM.js.map +1 -0
  590. package/dist/stages/commitMemory.js +98 -0
  591. package/dist/stages/commitMemory.js.map +1 -0
  592. package/dist/stages/finalize.js +16 -0
  593. package/dist/stages/finalize.js.map +1 -0
  594. package/dist/stages/helpers.js +63 -0
  595. package/dist/stages/helpers.js.map +1 -0
  596. package/dist/stages/index.js +21 -0
  597. package/dist/stages/index.js.map +1 -0
  598. package/dist/stages/parseResponse.js +29 -0
  599. package/dist/stages/parseResponse.js.map +1 -0
  600. package/dist/stages/retrieve.js +22 -0
  601. package/dist/stages/retrieve.js.map +1 -0
  602. package/dist/stages/runnerAsStage.js +70 -0
  603. package/dist/stages/runnerAsStage.js.map +1 -0
  604. package/dist/stream.barrel.js +23 -0
  605. package/dist/stream.barrel.js.map +1 -0
  606. package/dist/streaming/StreamEmitter.js +48 -0
  607. package/dist/streaming/StreamEmitter.js.map +1 -0
  608. package/dist/streaming/index.js +7 -0
  609. package/dist/streaming/index.js.map +1 -0
  610. package/dist/subflows/index.js +6 -0
  611. package/dist/subflows/index.js.map +1 -0
  612. package/dist/subflows/prepareMemory.js +87 -0
  613. package/dist/subflows/prepareMemory.js.map +1 -0
  614. package/dist/tools/ToolRegistry.js +89 -0
  615. package/dist/tools/ToolRegistry.js.map +1 -0
  616. package/dist/tools/askHuman.js +68 -0
  617. package/dist/tools/askHuman.js.map +1 -0
  618. package/dist/tools/index.js +9 -0
  619. package/dist/tools/index.js.map +1 -0
  620. package/dist/tools/validateInput.js +61 -0
  621. package/dist/tools/validateInput.js.map +1 -0
  622. package/dist/tools/zodToJsonSchema.js +70 -0
  623. package/dist/tools/zodToJsonSchema.js.map +1 -0
  624. package/dist/types/adapter.js +14 -0
  625. package/dist/types/adapter.js.map +1 -0
  626. package/dist/types/adapters/a2a/a2aRunner.d.ts +40 -0
  627. package/dist/types/adapters/a2a/a2aRunner.d.ts.map +1 -0
  628. package/dist/types/adapters/anthropic/AnthropicAdapter.d.ts +37 -0
  629. package/dist/types/adapters/anthropic/AnthropicAdapter.d.ts.map +1 -0
  630. package/dist/types/adapters/bedrock/BedrockAdapter.d.ts +44 -0
  631. package/dist/types/adapters/bedrock/BedrockAdapter.d.ts.map +1 -0
  632. package/dist/types/adapters/browser/BrowserAnthropicAdapter.d.ts +40 -0
  633. package/dist/types/adapters/browser/BrowserAnthropicAdapter.d.ts.map +1 -0
  634. package/dist/types/adapters/browser/BrowserOpenAIAdapter.d.ts +46 -0
  635. package/dist/types/adapters/browser/BrowserOpenAIAdapter.d.ts.map +1 -0
  636. package/dist/types/adapters/browser/index.d.ts +5 -0
  637. package/dist/types/adapters/browser/index.d.ts.map +1 -0
  638. package/dist/types/adapters/createAdapterSubflow.d.ts +36 -0
  639. package/dist/types/adapters/createAdapterSubflow.d.ts.map +1 -0
  640. package/dist/types/adapters/createProvider.d.ts +47 -0
  641. package/dist/types/adapters/createProvider.d.ts.map +1 -0
  642. package/dist/types/adapters/fallbackProvider.d.ts +45 -0
  643. package/dist/types/adapters/fallbackProvider.d.ts.map +1 -0
  644. package/dist/types/adapters/index.d.ts +30 -0
  645. package/dist/types/adapters/index.d.ts.map +1 -0
  646. package/dist/types/adapters/mcp/mcpToolProvider.d.ts +41 -0
  647. package/dist/types/adapters/mcp/mcpToolProvider.d.ts.map +1 -0
  648. package/dist/types/adapters/memory/inMemory.d.ts +22 -0
  649. package/dist/types/adapters/memory/inMemory.d.ts.map +1 -0
  650. package/dist/types/adapters/memory/index.d.ts +3 -0
  651. package/dist/types/adapters/memory/index.d.ts.map +1 -0
  652. package/dist/types/adapters/memory/stores.d.ts +92 -0
  653. package/dist/types/adapters/memory/stores.d.ts.map +1 -0
  654. package/dist/types/adapters/memory/types.d.ts +74 -0
  655. package/dist/types/adapters/memory/types.d.ts.map +1 -0
  656. package/dist/types/adapters/mock/MockAdapter.d.ts +51 -0
  657. package/dist/types/adapters/mock/MockAdapter.d.ts.map +1 -0
  658. package/dist/types/adapters/mock/MockRetriever.d.ts +43 -0
  659. package/dist/types/adapters/mock/MockRetriever.d.ts.map +1 -0
  660. package/dist/types/adapters/openai/OpenAIAdapter.d.ts +47 -0
  661. package/dist/types/adapters/openai/OpenAIAdapter.d.ts.map +1 -0
  662. package/dist/types/adapters/resilientProvider.d.ts +33 -0
  663. package/dist/types/adapters/resilientProvider.d.ts.map +1 -0
  664. package/dist/types/agent.js +6 -0
  665. package/dist/types/agent.js.map +1 -0
  666. package/dist/types/compositions/index.d.ts +13 -0
  667. package/dist/types/compositions/index.d.ts.map +1 -0
  668. package/dist/types/compositions/withCircuitBreaker.d.ts +43 -0
  669. package/dist/types/compositions/withCircuitBreaker.d.ts.map +1 -0
  670. package/dist/types/compositions/withFallback.d.ts +17 -0
  671. package/dist/types/compositions/withFallback.d.ts.map +1 -0
  672. package/dist/types/compositions/withRetry.d.ts +27 -0
  673. package/dist/types/compositions/withRetry.d.ts.map +1 -0
  674. package/dist/types/concepts/FlowChart.d.ts +52 -0
  675. package/dist/types/concepts/FlowChart.d.ts.map +1 -0
  676. package/dist/types/concepts/LLMCall.d.ts +56 -0
  677. package/dist/types/concepts/LLMCall.d.ts.map +1 -0
  678. package/dist/types/concepts/Parallel.d.ts +110 -0
  679. package/dist/types/concepts/Parallel.d.ts.map +1 -0
  680. package/dist/types/concepts/RAG.d.ts +71 -0
  681. package/dist/types/concepts/RAG.d.ts.map +1 -0
  682. package/dist/types/concepts/Swarm.d.ts +98 -0
  683. package/dist/types/concepts/Swarm.d.ts.map +1 -0
  684. package/dist/types/concepts/index.d.ts +12 -0
  685. package/dist/types/concepts/index.d.ts.map +1 -0
  686. package/dist/types/concepts/specIcons.d.ts +14 -0
  687. package/dist/types/concepts/specIcons.d.ts.map +1 -0
  688. package/dist/types/content.js +97 -0
  689. package/dist/types/content.js.map +1 -0
  690. package/dist/types/core/config.d.ts +24 -0
  691. package/dist/types/core/config.d.ts.map +1 -0
  692. package/dist/types/core/index.d.ts +15 -0
  693. package/dist/types/core/index.d.ts.map +1 -0
  694. package/dist/types/core/providers.d.ts +160 -0
  695. package/dist/types/core/providers.d.ts.map +1 -0
  696. package/dist/types/core/recorders.d.ts +54 -0
  697. package/dist/types/core/recorders.d.ts.map +1 -0
  698. package/dist/types/errors.js +80 -0
  699. package/dist/types/errors.js.map +1 -0
  700. package/dist/types/executor/agentLoop.d.ts +37 -0
  701. package/dist/types/executor/agentLoop.d.ts.map +1 -0
  702. package/dist/types/executor/index.d.ts +6 -0
  703. package/dist/types/executor/index.d.ts.map +1 -0
  704. package/dist/types/explain.barrel.d.ts +20 -0
  705. package/dist/types/explain.barrel.d.ts.map +1 -0
  706. package/dist/types/index.d.ts +31 -0
  707. package/dist/types/index.d.ts.map +1 -0
  708. package/dist/types/index.js +29 -0
  709. package/dist/types/index.js.map +1 -0
  710. package/dist/types/instructions.barrel.d.ts +24 -0
  711. package/dist/types/instructions.barrel.d.ts.map +1 -0
  712. package/dist/types/lib/call/callLLMStage.d.ts +29 -0
  713. package/dist/types/lib/call/callLLMStage.d.ts.map +1 -0
  714. package/dist/types/lib/call/handleResponseStage.d.ts +35 -0
  715. package/dist/types/lib/call/handleResponseStage.d.ts.map +1 -0
  716. package/dist/types/lib/call/helpers.d.ts +64 -0
  717. package/dist/types/lib/call/helpers.d.ts.map +1 -0
  718. package/dist/types/lib/call/index.d.ts +10 -0
  719. package/dist/types/lib/call/index.d.ts.map +1 -0
  720. package/dist/types/lib/call/parseResponseStage.d.ts +21 -0
  721. package/dist/types/lib/call/parseResponseStage.d.ts.map +1 -0
  722. package/dist/types/lib/call/streamingCallLLMStage.d.ts +23 -0
  723. package/dist/types/lib/call/streamingCallLLMStage.d.ts.map +1 -0
  724. package/dist/types/lib/call/toolExecutionSubflow.d.ts +70 -0
  725. package/dist/types/lib/call/toolExecutionSubflow.d.ts.map +1 -0
  726. package/dist/types/lib/call/types.d.ts +17 -0
  727. package/dist/types/lib/call/types.d.ts.map +1 -0
  728. package/dist/types/lib/concepts/Agent.d.ts +9 -0
  729. package/dist/types/lib/concepts/Agent.d.ts.map +1 -0
  730. package/dist/types/lib/concepts/AgentBuilder.d.ts +152 -0
  731. package/dist/types/lib/concepts/AgentBuilder.d.ts.map +1 -0
  732. package/dist/types/lib/concepts/AgentRunner.d.ts +100 -0
  733. package/dist/types/lib/concepts/AgentRunner.d.ts.map +1 -0
  734. package/dist/types/lib/concepts/index.d.ts +3 -0
  735. package/dist/types/lib/concepts/index.d.ts.map +1 -0
  736. package/dist/types/lib/instructions/InstructionRecorder.d.ts +85 -0
  737. package/dist/types/lib/instructions/InstructionRecorder.d.ts.map +1 -0
  738. package/dist/types/lib/instructions/agentInstruction.d.ts +150 -0
  739. package/dist/types/lib/instructions/agentInstruction.d.ts.map +1 -0
  740. package/dist/types/lib/instructions/buildInstructionsToLLMSubflow.d.ts +56 -0
  741. package/dist/types/lib/instructions/buildInstructionsToLLMSubflow.d.ts.map +1 -0
  742. package/dist/types/lib/instructions/evaluator.d.ts +99 -0
  743. package/dist/types/lib/instructions/evaluator.d.ts.map +1 -0
  744. package/dist/types/lib/instructions/index.d.ts +18 -0
  745. package/dist/types/lib/instructions/index.d.ts.map +1 -0
  746. package/dist/types/lib/instructions/inject.d.ts +54 -0
  747. package/dist/types/lib/instructions/inject.d.ts.map +1 -0
  748. package/dist/types/lib/instructions/preview.d.ts +85 -0
  749. package/dist/types/lib/instructions/preview.d.ts.map +1 -0
  750. package/dist/types/lib/instructions/strictFollowUp.d.ts +88 -0
  751. package/dist/types/lib/instructions/strictFollowUp.d.ts.map +1 -0
  752. package/dist/types/lib/instructions/template.d.ts +52 -0
  753. package/dist/types/lib/instructions/template.d.ts.map +1 -0
  754. package/dist/types/lib/instructions/types.d.ts +394 -0
  755. package/dist/types/lib/instructions/types.d.ts.map +1 -0
  756. package/dist/types/lib/loop/buildAgentLoop.d.ts +67 -0
  757. package/dist/types/lib/loop/buildAgentLoop.d.ts.map +1 -0
  758. package/dist/types/lib/loop/index.d.ts +5 -0
  759. package/dist/types/lib/loop/index.d.ts.map +1 -0
  760. package/dist/types/lib/loop/types.d.ts +248 -0
  761. package/dist/types/lib/loop/types.d.ts.map +1 -0
  762. package/dist/types/lib/narrative/agentRenderer.d.ts +51 -0
  763. package/dist/types/lib/narrative/agentRenderer.d.ts.map +1 -0
  764. package/dist/types/lib/narrative/groundingHelpers.d.ts +94 -0
  765. package/dist/types/lib/narrative/groundingHelpers.d.ts.map +1 -0
  766. package/dist/types/lib/narrative/index.d.ts +5 -0
  767. package/dist/types/lib/narrative/index.d.ts.map +1 -0
  768. package/dist/types/lib/slots/helpers.d.ts +16 -0
  769. package/dist/types/lib/slots/helpers.d.ts.map +1 -0
  770. package/dist/types/lib/slots/index.d.ts +7 -0
  771. package/dist/types/lib/slots/index.d.ts.map +1 -0
  772. package/dist/types/lib/slots/messages/buildMessagesSubflow.d.ts +40 -0
  773. package/dist/types/lib/slots/messages/buildMessagesSubflow.d.ts.map +1 -0
  774. package/dist/types/lib/slots/messages/index.d.ts +3 -0
  775. package/dist/types/lib/slots/messages/index.d.ts.map +1 -0
  776. package/dist/types/lib/slots/messages/types.d.ts +26 -0
  777. package/dist/types/lib/slots/messages/types.d.ts.map +1 -0
  778. package/dist/types/lib/slots/system-prompt/buildSystemPromptSubflow.d.ts +27 -0
  779. package/dist/types/lib/slots/system-prompt/buildSystemPromptSubflow.d.ts.map +1 -0
  780. package/dist/types/lib/slots/system-prompt/index.d.ts +3 -0
  781. package/dist/types/lib/slots/system-prompt/index.d.ts.map +1 -0
  782. package/dist/types/lib/slots/system-prompt/types.d.ts +17 -0
  783. package/dist/types/lib/slots/system-prompt/types.d.ts.map +1 -0
  784. package/dist/types/lib/slots/tools/buildToolsSubflow.d.ts +23 -0
  785. package/dist/types/lib/slots/tools/buildToolsSubflow.d.ts.map +1 -0
  786. package/dist/types/lib/slots/tools/index.d.ts +3 -0
  787. package/dist/types/lib/slots/tools/index.d.ts.map +1 -0
  788. package/dist/types/lib/slots/tools/types.d.ts +18 -0
  789. package/dist/types/lib/slots/tools/types.d.ts.map +1 -0
  790. package/dist/types/lib/swarm/buildSwarmRouting.d.ts +36 -0
  791. package/dist/types/lib/swarm/buildSwarmRouting.d.ts.map +1 -0
  792. package/dist/types/lib/swarm/index.d.ts +3 -0
  793. package/dist/types/lib/swarm/index.d.ts.map +1 -0
  794. package/dist/types/llm.js +7 -0
  795. package/dist/types/llm.js.map +1 -0
  796. package/dist/types/memory/conversationHelpers.d.ts +23 -0
  797. package/dist/types/memory/conversationHelpers.d.ts.map +1 -0
  798. package/dist/types/memory/index.d.ts +2 -0
  799. package/dist/types/memory/index.d.ts.map +1 -0
  800. package/dist/types/messages.js +32 -0
  801. package/dist/types/messages.js.map +1 -0
  802. package/dist/types/models/index.d.ts +4 -0
  803. package/dist/types/models/index.d.ts.map +1 -0
  804. package/dist/types/models/pricing.d.ts +8 -0
  805. package/dist/types/models/pricing.d.ts.map +1 -0
  806. package/dist/types/models/providers.d.ts +23 -0
  807. package/dist/types/models/providers.d.ts.map +1 -0
  808. package/dist/types/models/types.d.ts +25 -0
  809. package/dist/types/models/types.d.ts.map +1 -0
  810. package/dist/types/multiAgent.js +6 -0
  811. package/dist/types/multiAgent.js.map +1 -0
  812. package/dist/types/observe.barrel.d.ts +21 -0
  813. package/dist/types/observe.barrel.d.ts.map +1 -0
  814. package/dist/types/providers/index.d.ts +15 -0
  815. package/dist/types/providers/index.d.ts.map +1 -0
  816. package/dist/types/providers/messages/charBudget.d.ts +19 -0
  817. package/dist/types/providers/messages/charBudget.d.ts.map +1 -0
  818. package/dist/types/providers/messages/compositeMessages.d.ts +16 -0
  819. package/dist/types/providers/messages/compositeMessages.d.ts.map +1 -0
  820. package/dist/types/providers/messages/fullHistory.d.ts +12 -0
  821. package/dist/types/providers/messages/fullHistory.d.ts.map +1 -0
  822. package/dist/types/providers/messages/index.d.ts +15 -0
  823. package/dist/types/providers/messages/index.d.ts.map +1 -0
  824. package/dist/types/providers/messages/persistentHistory.d.ts +32 -0
  825. package/dist/types/providers/messages/persistentHistory.d.ts.map +1 -0
  826. package/dist/types/providers/messages/slidingWindow.d.ts +16 -0
  827. package/dist/types/providers/messages/slidingWindow.d.ts.map +1 -0
  828. package/dist/types/providers/messages/summaryStrategy.d.ts +29 -0
  829. package/dist/types/providers/messages/summaryStrategy.d.ts.map +1 -0
  830. package/dist/types/providers/messages/withToolPairSafety.d.ts +19 -0
  831. package/dist/types/providers/messages/withToolPairSafety.d.ts.map +1 -0
  832. package/dist/types/providers/prompt/compositePrompt.d.ts +20 -0
  833. package/dist/types/providers/prompt/compositePrompt.d.ts.map +1 -0
  834. package/dist/types/providers/prompt/index.d.ts +10 -0
  835. package/dist/types/providers/prompt/index.d.ts.map +1 -0
  836. package/dist/types/providers/prompt/skillBasedPrompt.d.ts +33 -0
  837. package/dist/types/providers/prompt/skillBasedPrompt.d.ts.map +1 -0
  838. package/dist/types/providers/prompt/static.d.ts +6 -0
  839. package/dist/types/providers/prompt/static.d.ts.map +1 -0
  840. package/dist/types/providers/prompt/template.d.ts +6 -0
  841. package/dist/types/providers/prompt/template.d.ts.map +1 -0
  842. package/dist/types/providers/tools/PermissionPolicy.d.ts +76 -0
  843. package/dist/types/providers/tools/PermissionPolicy.d.ts.map +1 -0
  844. package/dist/types/providers/tools/agentAsTool.d.ts +40 -0
  845. package/dist/types/providers/tools/agentAsTool.d.ts.map +1 -0
  846. package/dist/types/providers/tools/compositeTools.d.ts +18 -0
  847. package/dist/types/providers/tools/compositeTools.d.ts.map +1 -0
  848. package/dist/types/providers/tools/dynamicTools.d.ts +27 -0
  849. package/dist/types/providers/tools/dynamicTools.d.ts.map +1 -0
  850. package/dist/types/providers/tools/gatedTools.d.ts +52 -0
  851. package/dist/types/providers/tools/gatedTools.d.ts.map +1 -0
  852. package/dist/types/providers/tools/index.d.ts +15 -0
  853. package/dist/types/providers/tools/index.d.ts.map +1 -0
  854. package/dist/types/providers/tools/noTools.d.ts +6 -0
  855. package/dist/types/providers/tools/noTools.d.ts.map +1 -0
  856. package/dist/types/providers/tools/staticTools.d.ts +7 -0
  857. package/dist/types/providers/tools/staticTools.d.ts.map +1 -0
  858. package/dist/types/providers.barrel.d.ts +34 -0
  859. package/dist/types/providers.barrel.d.ts.map +1 -0
  860. package/dist/types/recorders/index.d.ts +6 -0
  861. package/dist/types/recorders/index.d.ts.map +1 -0
  862. package/dist/types/recorders/v2/CompositeRecorder.d.ts +30 -0
  863. package/dist/types/recorders/v2/CompositeRecorder.d.ts.map +1 -0
  864. package/dist/types/recorders/v2/CostRecorder.d.ts +43 -0
  865. package/dist/types/recorders/v2/CostRecorder.d.ts.map +1 -0
  866. package/dist/types/recorders/v2/ExplainRecorder.d.ts +67 -0
  867. package/dist/types/recorders/v2/ExplainRecorder.d.ts.map +1 -0
  868. package/dist/types/recorders/v2/GuardrailRecorder.d.ts +45 -0
  869. package/dist/types/recorders/v2/GuardrailRecorder.d.ts.map +1 -0
  870. package/dist/types/recorders/v2/OTelRecorder.d.ts +50 -0
  871. package/dist/types/recorders/v2/OTelRecorder.d.ts.map +1 -0
  872. package/dist/types/recorders/v2/PermissionRecorder.d.ts +66 -0
  873. package/dist/types/recorders/v2/PermissionRecorder.d.ts.map +1 -0
  874. package/dist/types/recorders/v2/QualityRecorder.d.ts +37 -0
  875. package/dist/types/recorders/v2/QualityRecorder.d.ts.map +1 -0
  876. package/dist/types/recorders/v2/RecorderBridge.d.ts +38 -0
  877. package/dist/types/recorders/v2/RecorderBridge.d.ts.map +1 -0
  878. package/dist/types/recorders/v2/TokenRecorder.d.ts +54 -0
  879. package/dist/types/recorders/v2/TokenRecorder.d.ts.map +1 -0
  880. package/dist/types/recorders/v2/ToolUsageRecorder.d.ts +34 -0
  881. package/dist/types/recorders/v2/ToolUsageRecorder.d.ts.map +1 -0
  882. package/dist/types/recorders/v2/TurnRecorder.d.ts +36 -0
  883. package/dist/types/recorders/v2/TurnRecorder.d.ts.map +1 -0
  884. package/dist/types/recorders/v2/agentObservability.d.ts +68 -0
  885. package/dist/types/recorders/v2/agentObservability.d.ts.map +1 -0
  886. package/dist/types/recorders/v2/index.d.ts +21 -0
  887. package/dist/types/recorders/v2/index.d.ts.map +1 -0
  888. package/dist/types/resilience.barrel.d.ts +18 -0
  889. package/dist/types/resilience.barrel.d.ts.map +1 -0
  890. package/dist/types/retriever.js +7 -0
  891. package/dist/types/retriever.js.map +1 -0
  892. package/dist/types/scope/AgentScope.d.ts +87 -0
  893. package/dist/types/scope/AgentScope.d.ts.map +1 -0
  894. package/dist/types/scope/index.d.ts +3 -0
  895. package/dist/types/scope/index.d.ts.map +1 -0
  896. package/dist/types/scope/types.d.ts +151 -0
  897. package/dist/types/scope/types.d.ts.map +1 -0
  898. package/dist/types/security.barrel.d.ts +17 -0
  899. package/dist/types/security.barrel.d.ts.map +1 -0
  900. package/dist/types/stages/augmentPrompt.d.ts +7 -0
  901. package/dist/types/stages/augmentPrompt.d.ts.map +1 -0
  902. package/dist/types/stages/callLLM.d.ts +8 -0
  903. package/dist/types/stages/callLLM.d.ts.map +1 -0
  904. package/dist/types/stages/commitMemory.d.ts +51 -0
  905. package/dist/types/stages/commitMemory.d.ts.map +1 -0
  906. package/dist/types/stages/finalize.d.ts +7 -0
  907. package/dist/types/stages/finalize.d.ts.map +1 -0
  908. package/dist/types/stages/helpers.d.ts +17 -0
  909. package/dist/types/stages/helpers.d.ts.map +1 -0
  910. package/dist/types/stages/index.d.ts +10 -0
  911. package/dist/types/stages/index.d.ts.map +1 -0
  912. package/dist/types/stages/parseResponse.d.ts +8 -0
  913. package/dist/types/stages/parseResponse.d.ts.map +1 -0
  914. package/dist/types/stages/retrieve.d.ts +8 -0
  915. package/dist/types/stages/retrieve.d.ts.map +1 -0
  916. package/dist/types/stages/runnerAsStage.d.ts +18 -0
  917. package/dist/types/stages/runnerAsStage.d.ts.map +1 -0
  918. package/dist/types/stream.barrel.d.ts +19 -0
  919. package/dist/types/stream.barrel.d.ts.map +1 -0
  920. package/dist/types/streaming/StreamEmitter.d.ts +93 -0
  921. package/dist/types/streaming/StreamEmitter.d.ts.map +1 -0
  922. package/dist/types/streaming/index.d.ts +3 -0
  923. package/dist/types/streaming/index.d.ts.map +1 -0
  924. package/dist/types/subflows/index.d.ts +3 -0
  925. package/dist/types/subflows/index.d.ts.map +1 -0
  926. package/dist/types/subflows/prepareMemory.d.ts +60 -0
  927. package/dist/types/subflows/prepareMemory.d.ts.map +1 -0
  928. package/dist/types/tools/ToolRegistry.d.ts +47 -0
  929. package/dist/types/tools/ToolRegistry.d.ts.map +1 -0
  930. package/dist/types/tools/askHuman.d.ts +39 -0
  931. package/dist/types/tools/askHuman.d.ts.map +1 -0
  932. package/dist/types/tools/index.d.ts +3 -0
  933. package/dist/types/tools/index.d.ts.map +1 -0
  934. package/dist/types/tools/validateInput.d.ts +29 -0
  935. package/dist/types/tools/validateInput.d.ts.map +1 -0
  936. package/dist/types/tools/zodToJsonSchema.d.ts +9 -0
  937. package/dist/types/tools/zodToJsonSchema.d.ts.map +1 -0
  938. package/dist/types/tools.js +6 -0
  939. package/dist/types/tools.js.map +1 -0
  940. package/dist/types/types/adapter.d.ts +36 -0
  941. package/dist/types/types/adapter.d.ts.map +1 -0
  942. package/dist/types/types/agent.d.ts +37 -0
  943. package/dist/types/types/agent.d.ts.map +1 -0
  944. package/dist/types/types/content.d.ts +104 -0
  945. package/dist/types/types/content.d.ts.map +1 -0
  946. package/dist/types/types/errors.d.ts +27 -0
  947. package/dist/types/types/errors.d.ts.map +1 -0
  948. package/dist/types/types/index.d.ts +14 -0
  949. package/dist/types/types/index.d.ts.map +1 -0
  950. package/dist/types/types/llm.d.ts +78 -0
  951. package/dist/types/types/llm.d.ts.map +1 -0
  952. package/dist/types/types/messages.d.ts +40 -0
  953. package/dist/types/types/messages.d.ts.map +1 -0
  954. package/dist/types/types/multiAgent.d.ts +57 -0
  955. package/dist/types/types/multiAgent.d.ts.map +1 -0
  956. package/dist/types/types/retriever.d.ts +41 -0
  957. package/dist/types/types/retriever.d.ts.map +1 -0
  958. package/dist/types/types/tools.d.ts +19 -0
  959. package/dist/types/types/tools.d.ts.map +1 -0
  960. package/package.json +178 -0
@@ -0,0 +1,345 @@
1
+ /**
2
+ * BrowserAnthropicAdapter — fetch-based Anthropic adapter for browser environments.
3
+ *
4
+ * Zero peer dependencies — uses the global fetch() API.
5
+ * Works in any modern browser. Requires the user's own API key.
6
+ *
7
+ * Note: Anthropic requires the `anthropic-dangerous-direct-browser-access` header
8
+ * to allow direct browser-to-API calls. This is intentional — the user explicitly
9
+ * provides their own key for prototyping/playground use.
10
+ *
11
+ * Usage:
12
+ * import { BrowserAnthropicAdapter } from 'agentfootprint';
13
+ * const provider = new BrowserAnthropicAdapter({
14
+ * apiKey: 'sk-ant-...',
15
+ * model: 'claude-sonnet-4-20250514',
16
+ * });
17
+ */
18
+ import { LLMError, classifyStatusCode } from '../../types/errors';
19
+ // ── Adapter ──────────────────────────────────────────────────
20
+ const ANTHROPIC_API_URL = 'https://api.anthropic.com/v1/messages';
21
+ const ANTHROPIC_API_VERSION = '2023-06-01';
22
+ export class BrowserAnthropicAdapter {
23
+ apiKey;
24
+ model;
25
+ defaultMaxTokens;
26
+ baseURL;
27
+ constructor(options) {
28
+ this.apiKey = options.apiKey;
29
+ this.model = options.model;
30
+ this.defaultMaxTokens = options.maxTokens ?? 4096;
31
+ this.baseURL = options.baseURL ?? ANTHROPIC_API_URL;
32
+ }
33
+ async chat(messages, options) {
34
+ const body = this.buildBody(messages, options);
35
+ const response = await this.fetchAPI(body, options?.signal);
36
+ const data = (await response.json());
37
+ return convertResponse(data);
38
+ }
39
+ async *chatStream(messages, options) {
40
+ const body = this.buildBody(messages, options);
41
+ body.stream = true;
42
+ const response = await this.fetchAPI(body, options?.signal);
43
+ const reader = response.body?.getReader();
44
+ if (!reader)
45
+ throw new LLMError({ message: 'No response body for streaming', code: 'unknown', provider: 'anthropic-browser' });
46
+ const decoder = new TextDecoder();
47
+ let buffer = '';
48
+ let finalUsage;
49
+ let inputTokens = 0;
50
+ let outputTokens = 0;
51
+ let finalContent = '';
52
+ const toolInputBuffers = new Map();
53
+ let blockIndex = 0;
54
+ try {
55
+ while (true) {
56
+ const { done, value } = await reader.read();
57
+ if (done)
58
+ break;
59
+ buffer += decoder.decode(value, { stream: true });
60
+ const lines = buffer.split('\n');
61
+ buffer = lines.pop() ?? '';
62
+ for (const line of lines) {
63
+ if (!line.startsWith('data: '))
64
+ continue;
65
+ const data = line.slice(6).trim();
66
+ if (data === '[DONE]')
67
+ continue;
68
+ let event;
69
+ try {
70
+ event = JSON.parse(data);
71
+ }
72
+ catch {
73
+ continue;
74
+ }
75
+ if (event.type === 'message_start' && event.message?.usage) {
76
+ // Anthropic sends input_tokens in message_start
77
+ inputTokens = event.message.usage.input_tokens ?? 0;
78
+ }
79
+ else if (event.type === 'content_block_start' && event.content_block) {
80
+ if (event.content_block.type === 'tool_use') {
81
+ toolInputBuffers.set(event.index ?? blockIndex, {
82
+ id: event.content_block.id,
83
+ name: event.content_block.name,
84
+ json: '',
85
+ });
86
+ yield {
87
+ type: 'tool_call',
88
+ toolCall: {
89
+ id: event.content_block.id,
90
+ name: event.content_block.name,
91
+ arguments: {},
92
+ },
93
+ };
94
+ }
95
+ blockIndex = (event.index ?? blockIndex) + 1;
96
+ }
97
+ else if (event.type === 'content_block_delta' && event.delta) {
98
+ if (event.delta.type === 'thinking_delta' && event.delta.thinking) {
99
+ yield { type: 'thinking', content: event.delta.thinking };
100
+ }
101
+ else if (event.delta.type === 'text_delta' && event.delta.text) {
102
+ finalContent += event.delta.text;
103
+ yield { type: 'token', content: event.delta.text };
104
+ }
105
+ else if (event.delta.type === 'input_json_delta' && event.delta.partial_json) {
106
+ const buf = toolInputBuffers.get(event.index ?? 0);
107
+ if (buf)
108
+ buf.json += event.delta.partial_json;
109
+ }
110
+ }
111
+ else if (event.type === 'message_delta' && event.usage) {
112
+ // Anthropic sends output_tokens in message_delta
113
+ outputTokens = event.usage.output_tokens ?? 0;
114
+ }
115
+ else if (event.type === 'message_stop') {
116
+ // Prefer accumulated values from message_start + message_delta.
117
+ // Fall back to message_stop.message.usage if present (older API format).
118
+ if (inputTokens === 0 && outputTokens === 0 && event.message) {
119
+ const resp = convertResponse(event.message);
120
+ if (resp.usage)
121
+ finalUsage = resp.usage;
122
+ }
123
+ }
124
+ }
125
+ }
126
+ }
127
+ finally {
128
+ reader.releaseLock();
129
+ }
130
+ // Build usage from accumulated message_start + message_delta values
131
+ if (inputTokens > 0 || outputTokens > 0) {
132
+ finalUsage = {
133
+ inputTokens,
134
+ outputTokens,
135
+ totalTokens: inputTokens + outputTokens,
136
+ };
137
+ }
138
+ if (finalUsage) {
139
+ yield { type: 'usage', usage: finalUsage };
140
+ }
141
+ yield { type: 'done', content: finalContent };
142
+ }
143
+ buildBody(messages, options) {
144
+ const systemMessages = messages.filter((m) => m.role === 'system');
145
+ let systemPrompt = systemMessages.length > 0
146
+ ? systemMessages.map((m) => (typeof m.content === 'string' ? m.content : '')).join('\n')
147
+ : undefined;
148
+ // Structured output: inject JSON Schema (Anthropic has no native response_format)
149
+ const schemaInstruction = options?.responseFormat?.type === 'json_schema'
150
+ ? `You MUST respond with valid JSON matching this schema:\n<json_schema>\n${JSON.stringify(options.responseFormat.schema, null, 2)}\n</json_schema>\nRespond ONLY with the JSON object, no other text.`
151
+ : undefined;
152
+ const injection = options?.responseFormat?.injection ?? 'system';
153
+ if (schemaInstruction && injection === 'system') {
154
+ systemPrompt = (systemPrompt ?? '') + '\n\n' + schemaInstruction;
155
+ }
156
+ let anthropicMessages = convertMessages(messages.filter((m) => m.role !== 'system'));
157
+ if (schemaInstruction && injection === 'user') {
158
+ anthropicMessages = [
159
+ ...anthropicMessages,
160
+ { role: 'user', content: schemaInstruction },
161
+ ];
162
+ }
163
+ const tools = options?.tools?.map(convertTool);
164
+ return {
165
+ model: this.model,
166
+ max_tokens: options?.maxTokens ?? this.defaultMaxTokens,
167
+ messages: anthropicMessages,
168
+ ...(systemPrompt ? { system: systemPrompt } : {}),
169
+ ...(tools && tools.length > 0 ? { tools } : {}),
170
+ ...(options?.temperature !== undefined ? { temperature: options.temperature } : {}),
171
+ ...(options?.stop ? { stop_sequences: options.stop } : {}),
172
+ };
173
+ }
174
+ async fetchAPI(body, signal) {
175
+ let response;
176
+ try {
177
+ response = await fetch(this.baseURL, {
178
+ method: 'POST',
179
+ headers: {
180
+ 'Content-Type': 'application/json',
181
+ 'x-api-key': this.apiKey,
182
+ 'anthropic-version': ANTHROPIC_API_VERSION,
183
+ 'anthropic-dangerous-direct-browser-access': 'true',
184
+ },
185
+ body: JSON.stringify(body),
186
+ signal,
187
+ });
188
+ }
189
+ catch (err) {
190
+ const error = err instanceof Error ? err : new Error(String(err));
191
+ if (error.name === 'AbortError') {
192
+ throw new LLMError({ message: 'Request aborted', code: 'aborted', provider: 'anthropic-browser', cause: error });
193
+ }
194
+ throw new LLMError({ message: error.message, code: 'network', provider: 'anthropic-browser', cause: error });
195
+ }
196
+ if (!response.ok) {
197
+ let errorMessage = `Anthropic API error: ${response.status}`;
198
+ try {
199
+ const errorBody = await response.json();
200
+ if (errorBody.error?.message) {
201
+ errorMessage = errorBody.error.message;
202
+ }
203
+ }
204
+ catch {
205
+ // ignore parse error
206
+ }
207
+ throw new LLMError({
208
+ message: errorMessage,
209
+ code: classifyStatusCode(response.status),
210
+ provider: 'anthropic-browser',
211
+ statusCode: response.status,
212
+ });
213
+ }
214
+ return response;
215
+ }
216
+ }
217
+ // ── Converters (same logic as Node adapter) ──────────────────
218
+ function convertContent(content) {
219
+ if (typeof content === 'string')
220
+ return content;
221
+ return content.map((block) => {
222
+ switch (block.type) {
223
+ case 'text':
224
+ return { type: 'text', text: block.text };
225
+ case 'image':
226
+ if (block.source.type === 'base64') {
227
+ return {
228
+ type: 'image',
229
+ source: {
230
+ type: 'base64',
231
+ media_type: block.source.mediaType,
232
+ data: block.source.data,
233
+ },
234
+ };
235
+ }
236
+ return {
237
+ type: 'image',
238
+ source: { type: 'base64', media_type: 'image/png', data: '' },
239
+ };
240
+ case 'tool_use':
241
+ return {
242
+ type: 'tool_use',
243
+ id: block.id,
244
+ name: block.name,
245
+ input: block.input,
246
+ };
247
+ case 'tool_result':
248
+ return {
249
+ type: 'tool_result',
250
+ tool_use_id: block.toolUseId,
251
+ content: typeof block.content === 'string' ? block.content : JSON.stringify(block.content),
252
+ is_error: block.isError,
253
+ };
254
+ }
255
+ });
256
+ }
257
+ function convertMessages(messages) {
258
+ const result = [];
259
+ for (const msg of messages) {
260
+ if (msg.role === 'user') {
261
+ result.push({ role: 'user', content: convertContent(msg.content) });
262
+ }
263
+ else if (msg.role === 'assistant') {
264
+ const blocks = [];
265
+ if (typeof msg.content === 'string') {
266
+ if (msg.content)
267
+ blocks.push({ type: 'text', text: msg.content });
268
+ }
269
+ else if (Array.isArray(msg.content)) {
270
+ const converted = convertContent(msg.content);
271
+ if (Array.isArray(converted))
272
+ blocks.push(...converted);
273
+ }
274
+ if (msg.toolCalls) {
275
+ for (const tc of msg.toolCalls) {
276
+ blocks.push({ type: 'tool_use', id: tc.id, name: tc.name, input: tc.arguments });
277
+ }
278
+ }
279
+ const text = typeof msg.content === 'string' ? msg.content : '';
280
+ result.push({ role: 'assistant', content: blocks.length > 0 ? blocks : text });
281
+ }
282
+ else if (msg.role === 'tool') {
283
+ const toolResultContent = typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content);
284
+ const toolResult = {
285
+ type: 'tool_result',
286
+ tool_use_id: msg.toolCallId,
287
+ content: toolResultContent,
288
+ };
289
+ const last = result[result.length - 1];
290
+ if (last && last.role === 'user' && Array.isArray(last.content)) {
291
+ last.content.push(toolResult);
292
+ }
293
+ else {
294
+ result.push({ role: 'user', content: [toolResult] });
295
+ }
296
+ }
297
+ }
298
+ return result;
299
+ }
300
+ function convertTool(tool) {
301
+ return {
302
+ name: tool.name,
303
+ description: tool.description,
304
+ input_schema: tool.inputSchema,
305
+ };
306
+ }
307
+ function convertResponse(response) {
308
+ const textParts = [];
309
+ const thinkingParts = [];
310
+ const toolCalls = [];
311
+ for (const block of response.content) {
312
+ if (block.type === 'thinking' && block.thinking) {
313
+ thinkingParts.push(block.thinking);
314
+ }
315
+ else if (block.type === 'text' && block.text) {
316
+ textParts.push(block.text);
317
+ }
318
+ else if (block.type === 'tool_use') {
319
+ toolCalls.push({
320
+ id: block.id,
321
+ name: block.name,
322
+ arguments: block.input ?? {},
323
+ });
324
+ }
325
+ }
326
+ const finishReason = response.stop_reason === 'tool_use'
327
+ ? 'tool_calls'
328
+ : response.stop_reason === 'max_tokens'
329
+ ? 'length'
330
+ : 'stop';
331
+ const usage = {
332
+ inputTokens: response.usage.input_tokens,
333
+ outputTokens: response.usage.output_tokens,
334
+ totalTokens: response.usage.input_tokens + response.usage.output_tokens,
335
+ };
336
+ return {
337
+ content: textParts.join(''),
338
+ toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
339
+ usage,
340
+ model: response.model,
341
+ finishReason: finishReason,
342
+ thinking: thinkingParts.length > 0 ? thinkingParts.join('') : undefined,
343
+ };
344
+ }
345
+ //# sourceMappingURL=BrowserAnthropicAdapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"BrowserAnthropicAdapter.js","sourceRoot":"","sources":["../../../../src/adapters/browser/BrowserAnthropicAdapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,299 @@
1
+ /**
2
+ * BrowserOpenAIAdapter — fetch-based OpenAI adapter for browser environments.
3
+ *
4
+ * Zero peer dependencies — uses the global fetch() API.
5
+ * Works in any modern browser. Requires the user's own API key.
6
+ *
7
+ * Also works with OpenAI-compatible APIs (Groq, Together, etc.)
8
+ * by setting the baseURL option.
9
+ *
10
+ * Usage:
11
+ * import { BrowserOpenAIAdapter } from 'agentfootprint';
12
+ * const provider = new BrowserOpenAIAdapter({
13
+ * apiKey: 'sk-...',
14
+ * model: 'gpt-4o',
15
+ * });
16
+ *
17
+ * // Groq (OpenAI-compatible):
18
+ * const groq = new BrowserOpenAIAdapter({
19
+ * apiKey: 'gsk_...',
20
+ * model: 'llama-3.3-70b-versatile',
21
+ * baseURL: 'https://api.groq.com/openai/v1/chat/completions',
22
+ * });
23
+ */
24
+ import { LLMError, classifyStatusCode } from '../../types/errors';
25
+ // ── Adapter ──────────────────────────────────────────────────
26
+ const OPENAI_API_URL = 'https://api.openai.com/v1/chat/completions';
27
+ export class BrowserOpenAIAdapter {
28
+ apiKey;
29
+ model;
30
+ defaultMaxTokens;
31
+ baseURL;
32
+ constructor(options) {
33
+ this.apiKey = options.apiKey;
34
+ this.model = options.model;
35
+ this.defaultMaxTokens = options.maxTokens;
36
+ this.baseURL = options.baseURL ?? OPENAI_API_URL;
37
+ }
38
+ async chat(messages, options) {
39
+ const body = this.buildBody(messages, options);
40
+ const response = await this.fetchAPI(body, options?.signal);
41
+ const data = (await response.json());
42
+ return convertResponse(data);
43
+ }
44
+ async *chatStream(messages, options) {
45
+ const body = this.buildBody(messages, options);
46
+ body.stream = true;
47
+ body.stream_options = { include_usage: true };
48
+ const response = await this.fetchAPI(body, options?.signal);
49
+ const reader = response.body?.getReader();
50
+ if (!reader)
51
+ throw new LLMError({ message: 'No response body for streaming', code: 'unknown', provider: 'openai-browser' });
52
+ const decoder = new TextDecoder();
53
+ let buffer = '';
54
+ const toolCallAccumulator = new Map();
55
+ try {
56
+ while (true) {
57
+ const { done, value } = await reader.read();
58
+ if (done)
59
+ break;
60
+ buffer += decoder.decode(value, { stream: true });
61
+ const lines = buffer.split('\n');
62
+ buffer = lines.pop() ?? '';
63
+ for (const line of lines) {
64
+ if (!line.startsWith('data: '))
65
+ continue;
66
+ const data = line.slice(6).trim();
67
+ if (data === '[DONE]')
68
+ continue;
69
+ let chunk;
70
+ try {
71
+ chunk = JSON.parse(data);
72
+ }
73
+ catch {
74
+ continue;
75
+ }
76
+ const choice = chunk.choices?.[0];
77
+ // Text token
78
+ if (choice?.delta?.content) {
79
+ yield { type: 'token', content: choice.delta.content };
80
+ }
81
+ // Tool call chunks
82
+ if (choice?.delta?.tool_calls) {
83
+ for (const tc of choice.delta.tool_calls) {
84
+ if (!toolCallAccumulator.has(tc.index)) {
85
+ toolCallAccumulator.set(tc.index, { id: tc.id ?? '', name: '', args: '' });
86
+ }
87
+ const acc = toolCallAccumulator.get(tc.index);
88
+ if (tc.id)
89
+ acc.id = tc.id;
90
+ if (tc.function?.name)
91
+ acc.name = tc.function.name;
92
+ if (tc.function?.arguments)
93
+ acc.args += tc.function.arguments;
94
+ }
95
+ }
96
+ // Usage (final chunk with stream_options)
97
+ if (chunk.usage) {
98
+ yield {
99
+ type: 'usage',
100
+ usage: {
101
+ inputTokens: chunk.usage.prompt_tokens,
102
+ outputTokens: chunk.usage.completion_tokens,
103
+ totalTokens: chunk.usage.total_tokens,
104
+ },
105
+ };
106
+ }
107
+ // Emit accumulated tool calls on finish
108
+ if (choice?.finish_reason === 'tool_calls') {
109
+ for (const [, tc] of toolCallAccumulator) {
110
+ let args = {};
111
+ try {
112
+ args = JSON.parse(tc.args);
113
+ }
114
+ catch {
115
+ args = { _raw: tc.args };
116
+ }
117
+ yield {
118
+ type: 'tool_call',
119
+ toolCall: { id: tc.id, name: tc.name, arguments: args },
120
+ };
121
+ }
122
+ }
123
+ }
124
+ }
125
+ }
126
+ finally {
127
+ reader.releaseLock();
128
+ }
129
+ yield { type: 'done' };
130
+ }
131
+ buildBody(messages, options) {
132
+ const openaiMessages = convertMessages(messages);
133
+ const tools = options?.tools?.map(convertTool);
134
+ return {
135
+ model: this.model,
136
+ messages: openaiMessages,
137
+ ...(tools && tools.length > 0 ? { tools } : {}),
138
+ ...(options?.maxTokens ?? this.defaultMaxTokens
139
+ ? { max_tokens: options?.maxTokens ?? this.defaultMaxTokens }
140
+ : {}),
141
+ ...(options?.temperature !== undefined ? { temperature: options.temperature } : {}),
142
+ ...(options?.stop ? { stop: options.stop } : {}),
143
+ };
144
+ }
145
+ async fetchAPI(body, signal) {
146
+ let response;
147
+ try {
148
+ response = await fetch(this.baseURL, {
149
+ method: 'POST',
150
+ headers: {
151
+ 'Content-Type': 'application/json',
152
+ 'Authorization': `Bearer ${this.apiKey}`,
153
+ },
154
+ body: JSON.stringify(body),
155
+ signal,
156
+ });
157
+ }
158
+ catch (err) {
159
+ const error = err instanceof Error ? err : new Error(String(err));
160
+ if (error.name === 'AbortError') {
161
+ throw new LLMError({ message: 'Request aborted', code: 'aborted', provider: 'openai-browser', cause: error });
162
+ }
163
+ throw new LLMError({ message: error.message, code: 'network', provider: 'openai-browser', cause: error });
164
+ }
165
+ if (!response.ok) {
166
+ let errorMessage = `OpenAI API error: ${response.status}`;
167
+ try {
168
+ const errorBody = await response.json();
169
+ if (errorBody.error?.message) {
170
+ errorMessage = errorBody.error.message;
171
+ }
172
+ }
173
+ catch {
174
+ // ignore parse error
175
+ }
176
+ throw new LLMError({
177
+ message: errorMessage,
178
+ code: classifyStatusCode(response.status),
179
+ provider: 'openai-browser',
180
+ statusCode: response.status,
181
+ });
182
+ }
183
+ return response;
184
+ }
185
+ }
186
+ // ── Converters (same logic as Node adapter) ──────────────────
187
+ function convertContent(content) {
188
+ if (typeof content === 'string')
189
+ return content;
190
+ const parts = [];
191
+ for (const block of content) {
192
+ switch (block.type) {
193
+ case 'text':
194
+ parts.push({ type: 'text', text: block.text });
195
+ break;
196
+ case 'image':
197
+ if (block.source.type === 'url') {
198
+ parts.push({ type: 'image_url', image_url: { url: block.source.url } });
199
+ }
200
+ else if (block.source.type === 'base64') {
201
+ parts.push({
202
+ type: 'image_url',
203
+ image_url: { url: `data:${block.source.mediaType};base64,${block.source.data}` },
204
+ });
205
+ }
206
+ break;
207
+ }
208
+ }
209
+ return parts.length > 0 ? parts : null;
210
+ }
211
+ function convertMessages(messages) {
212
+ return messages.map((msg) => {
213
+ switch (msg.role) {
214
+ case 'system':
215
+ return {
216
+ role: 'system',
217
+ content: typeof msg.content === 'string' ? msg.content : String(msg.content),
218
+ };
219
+ case 'user':
220
+ return {
221
+ role: 'user',
222
+ content: convertContent(msg.content),
223
+ };
224
+ case 'assistant': {
225
+ const toolCalls = msg.toolCalls?.map((tc) => ({
226
+ id: tc.id,
227
+ type: 'function',
228
+ function: {
229
+ name: tc.name,
230
+ arguments: JSON.stringify(tc.arguments),
231
+ },
232
+ }));
233
+ return {
234
+ role: 'assistant',
235
+ content: typeof msg.content === 'string' ? msg.content : null,
236
+ ...(toolCalls && toolCalls.length > 0 ? { tool_calls: toolCalls } : {}),
237
+ };
238
+ }
239
+ case 'tool':
240
+ return {
241
+ role: 'tool',
242
+ content: typeof msg.content === 'string' ? msg.content : String(msg.content),
243
+ tool_call_id: msg.toolCallId,
244
+ };
245
+ }
246
+ });
247
+ }
248
+ function convertTool(tool) {
249
+ return {
250
+ type: 'function',
251
+ function: {
252
+ name: tool.name,
253
+ description: tool.description,
254
+ parameters: tool.inputSchema,
255
+ },
256
+ };
257
+ }
258
+ function convertResponse(response) {
259
+ const choice = response.choices[0];
260
+ if (!choice) {
261
+ return { content: '', finishReason: 'error' };
262
+ }
263
+ const toolCalls = choice.message.tool_calls?.map((tc) => {
264
+ let args = {};
265
+ try {
266
+ args = JSON.parse(tc.function.arguments);
267
+ }
268
+ catch {
269
+ args = { _raw: tc.function.arguments };
270
+ }
271
+ return {
272
+ id: tc.id,
273
+ name: tc.function.name,
274
+ arguments: args,
275
+ };
276
+ });
277
+ const finishReason = choice.finish_reason === 'tool_calls'
278
+ ? 'tool_calls'
279
+ : choice.finish_reason === 'length'
280
+ ? 'length'
281
+ : choice.finish_reason === 'content_filter'
282
+ ? 'error'
283
+ : 'stop';
284
+ const usage = response.usage
285
+ ? {
286
+ inputTokens: response.usage.prompt_tokens,
287
+ outputTokens: response.usage.completion_tokens,
288
+ totalTokens: response.usage.total_tokens,
289
+ }
290
+ : undefined;
291
+ return {
292
+ content: choice.message.content ?? '',
293
+ toolCalls: toolCalls && toolCalls.length > 0 ? toolCalls : undefined,
294
+ usage,
295
+ model: response.model,
296
+ finishReason: finishReason,
297
+ };
298
+ }
299
+ //# sourceMappingURL=BrowserOpenAIAdapter.js.map