agentfootprint 8.19.0 → 9.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 (400) hide show
  1. package/README.md +2 -2
  2. package/bin/agentfootprint-index.mjs +28 -3
  3. package/dist/adapters/hosting/agentcore.js +1 -1
  4. package/dist/adapters/identity/agentcore.js +1 -1
  5. package/dist/adapters/llm/AnthropicProvider.js +1 -1
  6. package/dist/adapters/llm/BrowserOpenAIProvider.js +1 -1
  7. package/dist/adapters/llm/MockProvider.js +1 -1
  8. package/dist/adapters/llm/OpenAIProvider.js +2 -2
  9. package/dist/adapters/memory/agentcore.js +1 -1
  10. package/dist/adapters/memory/bedrockAgentMemory.js +1 -1
  11. package/dist/adapters/memory/redis.js +1 -1
  12. package/dist/adapters/observability/agentcore.js +2 -2
  13. package/dist/adapters/observability/audit.js +1 -1
  14. package/dist/adapters/observability/cloudwatch.js +2 -2
  15. package/dist/adapters/observability/otel.js +3 -3
  16. package/dist/adapters/observability/xray.js +2 -2
  17. package/dist/core/Agent.js +1 -1
  18. package/dist/core/agent/AgentBuilder.js +35 -23
  19. package/dist/core/agent/AgentBuilder.js.map +1 -1
  20. package/dist/core/agent/stages/window.js +11 -13
  21. package/dist/core/agent/stages/window.js.map +1 -1
  22. package/dist/core/agent/watch.js +1 -1
  23. package/dist/core/agent/window/index.js.map +1 -1
  24. package/dist/core/agent/window/strategies/summarizeOldest.js +0 -5
  25. package/dist/core/agent/window/strategies/summarizeOldest.js.map +1 -1
  26. package/dist/core/slots/helpers.js +4 -7
  27. package/dist/core/slots/helpers.js.map +1 -1
  28. package/dist/debug/finders.js +7 -10
  29. package/dist/debug/finders.js.map +1 -1
  30. package/dist/debug.js +4 -4
  31. package/dist/doors/context.js +3 -3
  32. package/dist/esm/adapters/hosting/agentcore.d.ts +1 -1
  33. package/dist/esm/adapters/hosting/agentcore.js +1 -1
  34. package/dist/esm/adapters/identity/agentcore.d.ts +1 -1
  35. package/dist/esm/adapters/identity/agentcore.js +1 -1
  36. package/dist/esm/adapters/llm/AnthropicProvider.d.ts +1 -1
  37. package/dist/esm/adapters/llm/AnthropicProvider.js +1 -1
  38. package/dist/esm/adapters/llm/BrowserOpenAIProvider.d.ts +1 -1
  39. package/dist/esm/adapters/llm/BrowserOpenAIProvider.js +1 -1
  40. package/dist/esm/adapters/llm/MockProvider.d.ts +1 -1
  41. package/dist/esm/adapters/llm/MockProvider.js +1 -1
  42. package/dist/esm/adapters/llm/OpenAIProvider.d.ts +2 -2
  43. package/dist/esm/adapters/llm/OpenAIProvider.js +2 -2
  44. package/dist/esm/adapters/memory/agentcore.d.ts +1 -1
  45. package/dist/esm/adapters/memory/agentcore.js +1 -1
  46. package/dist/esm/adapters/memory/bedrockAgentMemory.d.ts +1 -1
  47. package/dist/esm/adapters/memory/bedrockAgentMemory.js +1 -1
  48. package/dist/esm/adapters/memory/redis.d.ts +1 -1
  49. package/dist/esm/adapters/memory/redis.js +1 -1
  50. package/dist/esm/adapters/observability/agentcore.d.ts +2 -2
  51. package/dist/esm/adapters/observability/agentcore.js +2 -2
  52. package/dist/esm/adapters/observability/audit.d.ts +1 -1
  53. package/dist/esm/adapters/observability/audit.js +1 -1
  54. package/dist/esm/adapters/observability/cloudwatch.d.ts +2 -2
  55. package/dist/esm/adapters/observability/cloudwatch.js +2 -2
  56. package/dist/esm/adapters/observability/otel.d.ts +4 -4
  57. package/dist/esm/adapters/observability/otel.js +3 -3
  58. package/dist/esm/adapters/observability/xray.d.ts +2 -2
  59. package/dist/esm/adapters/observability/xray.js +2 -2
  60. package/dist/esm/core/Agent.js +1 -1
  61. package/dist/esm/core/agent/AgentBuilder.d.ts +17 -14
  62. package/dist/esm/core/agent/AgentBuilder.js +35 -23
  63. package/dist/esm/core/agent/AgentBuilder.js.map +1 -1
  64. package/dist/esm/core/agent/stages/window.js +11 -13
  65. package/dist/esm/core/agent/stages/window.js.map +1 -1
  66. package/dist/esm/core/agent/types.d.ts +2 -2
  67. package/dist/esm/core/agent/watch.d.ts +1 -1
  68. package/dist/esm/core/agent/watch.js +1 -1
  69. package/dist/esm/core/agent/window/index.d.ts +1 -1
  70. package/dist/esm/core/agent/window/index.js.map +1 -1
  71. package/dist/esm/core/agent/window/strategies/summarizeOldest.js +0 -5
  72. package/dist/esm/core/agent/window/strategies/summarizeOldest.js.map +1 -1
  73. package/dist/esm/core/agent/window/types.d.ts +0 -30
  74. package/dist/esm/core/runner.d.ts +1 -1
  75. package/dist/esm/core/slots/helpers.d.ts +3 -4
  76. package/dist/esm/core/slots/helpers.js +4 -7
  77. package/dist/esm/core/slots/helpers.js.map +1 -1
  78. package/dist/esm/debug/finders.d.ts +7 -10
  79. package/dist/esm/debug/finders.js +7 -10
  80. package/dist/esm/debug/finders.js.map +1 -1
  81. package/dist/esm/debug.d.ts +4 -4
  82. package/dist/esm/debug.js +4 -4
  83. package/dist/esm/doors/context.d.ts +3 -3
  84. package/dist/esm/doors/context.js +3 -3
  85. package/dist/esm/embedders/index.d.ts +4 -4
  86. package/dist/esm/events/payloads.d.ts +10 -14
  87. package/dist/esm/hosting-providers.d.ts +16 -16
  88. package/dist/esm/hosting-providers.js +16 -16
  89. package/dist/esm/identity/types.d.ts +1 -1
  90. package/dist/esm/identity/types.js +1 -1
  91. package/dist/esm/identity/withCredentialRetry.d.ts +1 -1
  92. package/dist/esm/identity/withCredentialRetry.js +1 -1
  93. package/dist/esm/identity.d.ts +5 -5
  94. package/dist/esm/identity.js +5 -5
  95. package/dist/esm/index.d.ts +1 -1
  96. package/dist/esm/index.js +4 -4
  97. package/dist/esm/index.js.map +1 -1
  98. package/dist/esm/injection-engine.d.ts +4 -4
  99. package/dist/esm/injection-engine.js +4 -4
  100. package/dist/esm/lib/context-ledger/gates.d.ts +1 -1
  101. package/dist/esm/lib/context-ledger/gates.js +1 -1
  102. package/dist/esm/lib/injection-engine/SkillRegistry.d.ts +1 -1
  103. package/dist/esm/lib/injection-engine/SkillRegistry.js +1 -1
  104. package/dist/esm/lib/injection-engine/factories/defineSkill.d.ts +1 -16
  105. package/dist/esm/lib/injection-engine/factories/defineSkill.js +29 -1
  106. package/dist/esm/lib/injection-engine/factories/defineSkill.js.map +1 -1
  107. package/dist/esm/lib/injection-engine/skillsFromDir.d.ts +1 -11
  108. package/dist/esm/lib/injection-engine/skillsFromDir.js +22 -2
  109. package/dist/esm/lib/injection-engine/skillsFromDir.js.map +1 -1
  110. package/dist/esm/lib/injection-engine/types.d.ts +1 -1
  111. package/dist/esm/lib/mcp/gatewayTransport.d.ts +2 -2
  112. package/dist/esm/lib/mcp/gatewayTransport.js +2 -2
  113. package/dist/esm/lib/rag/defineRAG.d.ts +9 -6
  114. package/dist/esm/lib/rag/defineRAG.js.map +1 -1
  115. package/dist/esm/lib/recorded-chat/index.d.ts +1 -1
  116. package/dist/esm/lib/recorded-chat/index.js +1 -1
  117. package/dist/esm/llm-providers.d.ts +5 -19
  118. package/dist/esm/llm-providers.js +5 -19
  119. package/dist/esm/llm-providers.js.map +1 -1
  120. package/dist/esm/locales/index.d.ts +7 -7
  121. package/dist/esm/locales/index.js +7 -7
  122. package/dist/esm/memory/causal/evidenceRecorder.d.ts +1 -1
  123. package/dist/esm/memory/causal/evidenceRecorder.js +1 -1
  124. package/dist/esm/memory/define.types.d.ts +3 -2
  125. package/dist/esm/memory/define.types.js.map +1 -1
  126. package/dist/esm/memory/index.d.ts +0 -10
  127. package/dist/esm/memory/index.js +6 -0
  128. package/dist/esm/memory/index.js.map +1 -1
  129. package/dist/esm/memory/retrieval/topK.d.ts +12 -6
  130. package/dist/esm/memory/retrieval/topK.js.map +1 -1
  131. package/dist/esm/memory/store/index.d.ts +1 -0
  132. package/dist/esm/memory/store/index.js +1 -0
  133. package/dist/esm/memory/store/index.js.map +1 -1
  134. package/dist/esm/memory/store/staticVectorStore.d.ts +83 -0
  135. package/dist/esm/memory/store/staticVectorStore.js +224 -0
  136. package/dist/esm/memory/store/staticVectorStore.js.map +1 -0
  137. package/dist/esm/memory-providers.d.ts +8 -24
  138. package/dist/esm/memory-providers.js +8 -24
  139. package/dist/esm/memory-providers.js.map +1 -1
  140. package/dist/esm/observability/contextError/finders/index.d.ts +4 -4
  141. package/dist/esm/observability-providers.d.ts +5 -5
  142. package/dist/esm/observability-providers.js +5 -5
  143. package/dist/esm/observe.d.ts +1 -0
  144. package/dist/esm/observe.js +11 -6
  145. package/dist/esm/observe.js.map +1 -1
  146. package/dist/esm/providers.d.ts +2 -2
  147. package/dist/esm/providers.js +2 -2
  148. package/dist/esm/rag/exportCorpus.d.ts +64 -0
  149. package/dist/esm/rag/exportCorpus.js +172 -0
  150. package/dist/esm/rag/exportCorpus.js.map +1 -0
  151. package/dist/esm/rag/index.d.ts +3 -1
  152. package/dist/esm/rag/index.js +8 -1
  153. package/dist/esm/rag/index.js.map +1 -1
  154. package/dist/esm/rag/splitters/byHeading.d.ts +39 -0
  155. package/dist/esm/rag/splitters/byHeading.js +133 -15
  156. package/dist/esm/rag/splitters/byHeading.js.map +1 -1
  157. package/dist/esm/rag/splitters/byParagraph.d.ts +14 -0
  158. package/dist/esm/rag/splitters/byParagraph.js +4 -2
  159. package/dist/esm/rag/splitters/byParagraph.js.map +1 -1
  160. package/dist/esm/rag/splitters/constants.d.ts +24 -1
  161. package/dist/esm/rag/splitters/constants.js +24 -1
  162. package/dist/esm/rag/splitters/constants.js.map +1 -1
  163. package/dist/esm/rag/splitters/index.d.ts +15 -1
  164. package/dist/esm/rag/splitters/index.js +15 -1
  165. package/dist/esm/rag/splitters/index.js.map +1 -1
  166. package/dist/esm/rag/splitters/shared.d.ts +32 -0
  167. package/dist/esm/rag/splitters/shared.js +77 -1
  168. package/dist/esm/rag/splitters/shared.js.map +1 -1
  169. package/dist/esm/recorders/core/ContextRecorder.js +47 -11
  170. package/dist/esm/recorders/core/ContextRecorder.js.map +1 -1
  171. package/dist/esm/recorders/core/types.d.ts +16 -18
  172. package/dist/esm/recorders/core/types.js.map +1 -1
  173. package/dist/esm/recorders/observability/BoundaryRecorder.d.ts +24 -0
  174. package/dist/esm/recorders/observability/BoundaryRecorder.js +19 -6
  175. package/dist/esm/recorders/observability/BoundaryRecorder.js.map +1 -1
  176. package/dist/esm/recorders/observability/RouteRecorder.d.ts +1 -1
  177. package/dist/esm/recorders/observability/RouteRecorder.js +1 -1
  178. package/dist/esm/recorders/observability/ToolChoiceRecorder.d.ts +1 -1
  179. package/dist/esm/recorders/observability/ToolChoiceRecorder.js +1 -1
  180. package/dist/esm/recorders/observability/embeddingSummary.d.ts +56 -0
  181. package/dist/esm/recorders/observability/embeddingSummary.js +114 -0
  182. package/dist/esm/recorders/observability/embeddingSummary.js.map +1 -0
  183. package/dist/esm/recorders/observability/recordRun.d.ts +16 -0
  184. package/dist/esm/recorders/observability/recordRun.js +17 -3
  185. package/dist/esm/recorders/observability/recordRun.js.map +1 -1
  186. package/dist/esm/reliability/index.d.ts +15 -3
  187. package/dist/esm/reliability/index.js +15 -3
  188. package/dist/esm/reliability/index.js.map +1 -1
  189. package/dist/esm/resilience/fallbackProvider.d.ts +1 -1
  190. package/dist/esm/resilience/fallbackProvider.js +1 -1
  191. package/dist/esm/resilience/withCircuitBreaker.d.ts +1 -1
  192. package/dist/esm/resilience/withCircuitBreaker.js +1 -1
  193. package/dist/esm/resilience/withRetry.d.ts +1 -1
  194. package/dist/esm/resilience/withRetry.js +1 -1
  195. package/dist/esm/security/PermissionPolicy.d.ts +2 -2
  196. package/dist/esm/security/PermissionPolicy.js +2 -2
  197. package/dist/esm/security/index.d.ts +3 -3
  198. package/dist/esm/security/index.js +3 -3
  199. package/dist/esm/status.d.ts +14 -24
  200. package/dist/esm/status.js +15 -25
  201. package/dist/esm/status.js.map +1 -1
  202. package/dist/esm/strategies/index.d.ts +9 -16
  203. package/dist/esm/strategies/index.js +9 -16
  204. package/dist/esm/strategies/index.js.map +1 -1
  205. package/dist/esm/strategies/registry.d.ts +1 -1
  206. package/dist/esm/strategies/registry.js +1 -1
  207. package/dist/esm/stream.d.ts +4 -4
  208. package/dist/esm/stream.js +4 -4
  209. package/dist/esm/thinking/index.d.ts +5 -5
  210. package/dist/esm/thinking/index.js +5 -5
  211. package/dist/esm/tool-providers/index.d.ts +4 -4
  212. package/dist/esm/tool-providers/index.js +4 -4
  213. package/dist/hosting-providers.js +16 -16
  214. package/dist/identity/types.js +1 -1
  215. package/dist/identity/withCredentialRetry.js +1 -1
  216. package/dist/identity.js +5 -5
  217. package/dist/index.js +4 -4
  218. package/dist/index.js.map +1 -1
  219. package/dist/injection-engine.js +4 -4
  220. package/dist/lib/context-ledger/gates.js +1 -1
  221. package/dist/lib/injection-engine/SkillRegistry.js +1 -1
  222. package/dist/lib/injection-engine/factories/defineSkill.js +29 -1
  223. package/dist/lib/injection-engine/factories/defineSkill.js.map +1 -1
  224. package/dist/lib/injection-engine/skillsFromDir.js +22 -2
  225. package/dist/lib/injection-engine/skillsFromDir.js.map +1 -1
  226. package/dist/lib/mcp/gatewayTransport.js +2 -2
  227. package/dist/lib/rag/defineRAG.js.map +1 -1
  228. package/dist/lib/recorded-chat/index.js +1 -1
  229. package/dist/llm-providers.js +5 -19
  230. package/dist/llm-providers.js.map +1 -1
  231. package/dist/locales/index.js +6 -6
  232. package/dist/memory/causal/evidenceRecorder.js +1 -1
  233. package/dist/memory/define.types.js.map +1 -1
  234. package/dist/memory/index.js +6 -0
  235. package/dist/memory/index.js.map +1 -1
  236. package/dist/memory/retrieval/topK.js.map +1 -1
  237. package/dist/memory/store/index.js +6 -1
  238. package/dist/memory/store/index.js.map +1 -1
  239. package/dist/memory/store/staticVectorStore.js +230 -0
  240. package/dist/memory/store/staticVectorStore.js.map +1 -0
  241. package/dist/memory-providers.js +8 -24
  242. package/dist/memory-providers.js.map +1 -1
  243. package/dist/observability-providers.js +5 -5
  244. package/dist/observe.js +14 -7
  245. package/dist/observe.js.map +1 -1
  246. package/dist/providers.js +2 -2
  247. package/dist/rag/exportCorpus.js +177 -0
  248. package/dist/rag/exportCorpus.js.map +1 -0
  249. package/dist/rag/index.js +13 -1
  250. package/dist/rag/index.js.map +1 -1
  251. package/dist/rag/splitters/byHeading.js +132 -14
  252. package/dist/rag/splitters/byHeading.js.map +1 -1
  253. package/dist/rag/splitters/byParagraph.js +3 -1
  254. package/dist/rag/splitters/byParagraph.js.map +1 -1
  255. package/dist/rag/splitters/constants.js +25 -2
  256. package/dist/rag/splitters/constants.js.map +1 -1
  257. package/dist/rag/splitters/index.js +16 -1
  258. package/dist/rag/splitters/index.js.map +1 -1
  259. package/dist/rag/splitters/shared.js +79 -1
  260. package/dist/rag/splitters/shared.js.map +1 -1
  261. package/dist/recorders/core/ContextRecorder.js +47 -11
  262. package/dist/recorders/core/ContextRecorder.js.map +1 -1
  263. package/dist/recorders/core/types.js.map +1 -1
  264. package/dist/recorders/observability/BoundaryRecorder.js +19 -6
  265. package/dist/recorders/observability/BoundaryRecorder.js.map +1 -1
  266. package/dist/recorders/observability/RouteRecorder.js +1 -1
  267. package/dist/recorders/observability/ToolChoiceRecorder.js +1 -1
  268. package/dist/recorders/observability/embeddingSummary.js +119 -0
  269. package/dist/recorders/observability/embeddingSummary.js.map +1 -0
  270. package/dist/recorders/observability/recordRun.js +17 -3
  271. package/dist/recorders/observability/recordRun.js.map +1 -1
  272. package/dist/reliability/index.js +15 -3
  273. package/dist/reliability/index.js.map +1 -1
  274. package/dist/resilience/fallbackProvider.js +1 -1
  275. package/dist/resilience/withCircuitBreaker.js +1 -1
  276. package/dist/resilience/withRetry.js +1 -1
  277. package/dist/security/PermissionPolicy.js +2 -2
  278. package/dist/security/index.js +3 -3
  279. package/dist/status.js +14 -24
  280. package/dist/status.js.map +1 -1
  281. package/dist/strategies/index.js +9 -16
  282. package/dist/strategies/index.js.map +1 -1
  283. package/dist/strategies/registry.js +1 -1
  284. package/dist/stream.js +4 -4
  285. package/dist/thinking/index.js +5 -5
  286. package/dist/tool-providers/index.js +4 -4
  287. package/dist/types/adapters/hosting/agentcore.d.ts +1 -1
  288. package/dist/types/adapters/identity/agentcore.d.ts +1 -1
  289. package/dist/types/adapters/llm/AnthropicProvider.d.ts +1 -1
  290. package/dist/types/adapters/llm/BrowserOpenAIProvider.d.ts +1 -1
  291. package/dist/types/adapters/llm/MockProvider.d.ts +1 -1
  292. package/dist/types/adapters/llm/OpenAIProvider.d.ts +2 -2
  293. package/dist/types/adapters/memory/agentcore.d.ts +1 -1
  294. package/dist/types/adapters/memory/bedrockAgentMemory.d.ts +1 -1
  295. package/dist/types/adapters/memory/redis.d.ts +1 -1
  296. package/dist/types/adapters/observability/agentcore.d.ts +2 -2
  297. package/dist/types/adapters/observability/audit.d.ts +1 -1
  298. package/dist/types/adapters/observability/cloudwatch.d.ts +2 -2
  299. package/dist/types/adapters/observability/otel.d.ts +4 -4
  300. package/dist/types/adapters/observability/xray.d.ts +2 -2
  301. package/dist/types/core/agent/AgentBuilder.d.ts +17 -14
  302. package/dist/types/core/agent/AgentBuilder.d.ts.map +1 -1
  303. package/dist/types/core/agent/stages/window.d.ts.map +1 -1
  304. package/dist/types/core/agent/types.d.ts +2 -2
  305. package/dist/types/core/agent/watch.d.ts +1 -1
  306. package/dist/types/core/agent/window/index.d.ts +1 -1
  307. package/dist/types/core/agent/window/index.d.ts.map +1 -1
  308. package/dist/types/core/agent/window/strategies/summarizeOldest.d.ts.map +1 -1
  309. package/dist/types/core/agent/window/types.d.ts +0 -30
  310. package/dist/types/core/agent/window/types.d.ts.map +1 -1
  311. package/dist/types/core/runner.d.ts +1 -1
  312. package/dist/types/core/slots/helpers.d.ts +3 -4
  313. package/dist/types/core/slots/helpers.d.ts.map +1 -1
  314. package/dist/types/debug/finders.d.ts +7 -10
  315. package/dist/types/debug/finders.d.ts.map +1 -1
  316. package/dist/types/debug.d.ts +4 -4
  317. package/dist/types/doors/context.d.ts +3 -3
  318. package/dist/types/embedders/index.d.ts +4 -4
  319. package/dist/types/events/payloads.d.ts +10 -14
  320. package/dist/types/events/payloads.d.ts.map +1 -1
  321. package/dist/types/hosting-providers.d.ts +16 -16
  322. package/dist/types/identity/types.d.ts +1 -1
  323. package/dist/types/identity/withCredentialRetry.d.ts +1 -1
  324. package/dist/types/identity.d.ts +5 -5
  325. package/dist/types/index.d.ts +1 -1
  326. package/dist/types/index.d.ts.map +1 -1
  327. package/dist/types/injection-engine.d.ts +4 -4
  328. package/dist/types/lib/context-ledger/gates.d.ts +1 -1
  329. package/dist/types/lib/injection-engine/SkillRegistry.d.ts +1 -1
  330. package/dist/types/lib/injection-engine/factories/defineSkill.d.ts +1 -16
  331. package/dist/types/lib/injection-engine/factories/defineSkill.d.ts.map +1 -1
  332. package/dist/types/lib/injection-engine/skillsFromDir.d.ts +1 -11
  333. package/dist/types/lib/injection-engine/skillsFromDir.d.ts.map +1 -1
  334. package/dist/types/lib/injection-engine/types.d.ts +1 -1
  335. package/dist/types/lib/mcp/gatewayTransport.d.ts +2 -2
  336. package/dist/types/lib/rag/defineRAG.d.ts +9 -6
  337. package/dist/types/lib/rag/defineRAG.d.ts.map +1 -1
  338. package/dist/types/lib/recorded-chat/index.d.ts +1 -1
  339. package/dist/types/llm-providers.d.ts +5 -19
  340. package/dist/types/llm-providers.d.ts.map +1 -1
  341. package/dist/types/locales/index.d.ts +7 -7
  342. package/dist/types/memory/causal/evidenceRecorder.d.ts +1 -1
  343. package/dist/types/memory/define.types.d.ts +3 -2
  344. package/dist/types/memory/define.types.d.ts.map +1 -1
  345. package/dist/types/memory/index.d.ts +0 -10
  346. package/dist/types/memory/index.d.ts.map +1 -1
  347. package/dist/types/memory/retrieval/topK.d.ts +12 -6
  348. package/dist/types/memory/retrieval/topK.d.ts.map +1 -1
  349. package/dist/types/memory/store/index.d.ts +1 -0
  350. package/dist/types/memory/store/index.d.ts.map +1 -1
  351. package/dist/types/memory/store/staticVectorStore.d.ts +84 -0
  352. package/dist/types/memory/store/staticVectorStore.d.ts.map +1 -0
  353. package/dist/types/memory-providers.d.ts +8 -24
  354. package/dist/types/memory-providers.d.ts.map +1 -1
  355. package/dist/types/observability/contextError/finders/index.d.ts +4 -4
  356. package/dist/types/observability-providers.d.ts +5 -5
  357. package/dist/types/observe.d.ts +1 -0
  358. package/dist/types/observe.d.ts.map +1 -1
  359. package/dist/types/providers.d.ts +2 -2
  360. package/dist/types/rag/exportCorpus.d.ts +65 -0
  361. package/dist/types/rag/exportCorpus.d.ts.map +1 -0
  362. package/dist/types/rag/index.d.ts +3 -1
  363. package/dist/types/rag/index.d.ts.map +1 -1
  364. package/dist/types/rag/splitters/byHeading.d.ts +39 -0
  365. package/dist/types/rag/splitters/byHeading.d.ts.map +1 -1
  366. package/dist/types/rag/splitters/byParagraph.d.ts +14 -0
  367. package/dist/types/rag/splitters/byParagraph.d.ts.map +1 -1
  368. package/dist/types/rag/splitters/constants.d.ts +24 -1
  369. package/dist/types/rag/splitters/constants.d.ts.map +1 -1
  370. package/dist/types/rag/splitters/index.d.ts +15 -1
  371. package/dist/types/rag/splitters/index.d.ts.map +1 -1
  372. package/dist/types/rag/splitters/shared.d.ts +32 -0
  373. package/dist/types/rag/splitters/shared.d.ts.map +1 -1
  374. package/dist/types/recorders/core/ContextRecorder.d.ts.map +1 -1
  375. package/dist/types/recorders/core/types.d.ts +16 -18
  376. package/dist/types/recorders/core/types.d.ts.map +1 -1
  377. package/dist/types/recorders/observability/BoundaryRecorder.d.ts +24 -0
  378. package/dist/types/recorders/observability/BoundaryRecorder.d.ts.map +1 -1
  379. package/dist/types/recorders/observability/RouteRecorder.d.ts +1 -1
  380. package/dist/types/recorders/observability/ToolChoiceRecorder.d.ts +1 -1
  381. package/dist/types/recorders/observability/embeddingSummary.d.ts +57 -0
  382. package/dist/types/recorders/observability/embeddingSummary.d.ts.map +1 -0
  383. package/dist/types/recorders/observability/recordRun.d.ts +16 -0
  384. package/dist/types/recorders/observability/recordRun.d.ts.map +1 -1
  385. package/dist/types/reliability/index.d.ts +15 -3
  386. package/dist/types/reliability/index.d.ts.map +1 -1
  387. package/dist/types/resilience/fallbackProvider.d.ts +1 -1
  388. package/dist/types/resilience/withCircuitBreaker.d.ts +1 -1
  389. package/dist/types/resilience/withRetry.d.ts +1 -1
  390. package/dist/types/security/PermissionPolicy.d.ts +2 -2
  391. package/dist/types/security/index.d.ts +3 -3
  392. package/dist/types/status.d.ts +14 -24
  393. package/dist/types/status.d.ts.map +1 -1
  394. package/dist/types/strategies/index.d.ts +9 -16
  395. package/dist/types/strategies/index.d.ts.map +1 -1
  396. package/dist/types/strategies/registry.d.ts +1 -1
  397. package/dist/types/stream.d.ts +4 -4
  398. package/dist/types/thinking/index.d.ts +5 -5
  399. package/dist/types/tool-providers/index.d.ts +4 -4
  400. package/package.json +1 -209
@@ -110,8 +110,6 @@ function summarizeOldest(options) {
110
110
  ...base,
111
111
  removedStageIds: [],
112
112
  removedMessageCount: 0,
113
- foldedStageIds: [],
114
- foldedMessageCount: 0,
115
113
  windowCharsAfter: charsBefore,
116
114
  summaryChars: 0,
117
115
  refusals,
@@ -216,9 +214,6 @@ function summarizeOldest(options) {
216
214
  ...base,
217
215
  removedStageIds: facts.removedStageIds,
218
216
  removedMessageCount: span.length,
219
- // The 7.16 names for the two values above, kept and deprecated.
220
- foldedStageIds: facts.removedStageIds,
221
- foldedMessageCount: span.length,
222
217
  windowCharsAfter: (0, turns_js_1.windowChars)(window),
223
218
  summaryChars: summaryMessage.content.length,
224
219
  summarizerTokens: summary.usage,
@@ -1 +1 @@
1
- {"version":3,"file":"summarizeOldest.js","sourceRoot":"","sources":["../../../../../src/core/agent/window/strategies/summarizeOldest.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"summarizeOldest.js","sourceRoot":"","sources":["../../../../../src/core/agent/window/strategies/summarizeOldest.ts"],"names":[],"mappings":"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"}
@@ -75,10 +75,9 @@ exports.composeSlot = composeSlot;
75
75
  * truncate NOTHING, so the full content went to the LLM and this record is
76
76
  * the loud signal that the slot's budget is not being respected.
77
77
  *
78
- * Units are CHARS. The historical `*Tokens` field names say otherwise, which
79
- * is why 8.14.0 added `unit` / `cap` / `projected` beside them and this
80
- * function writes all six: the two old names for existing readers, and the
81
- * three honest ones for everyone else. A window strategy fills the same
78
+ * Units are CHARS, and the record says so: `unit` / `cap` / `projected`, added
79
+ * in 8.14.0 and the only spelling since 9.0.0 removed the `*Tokens` names that
80
+ * asserted a unit this channel does not use. A window strategy fills the same
82
81
  * fields with `unit: 'tokens'`, and one subscriber gets both.
83
82
  */
84
83
  function slotOverflow(composition) {
@@ -87,8 +86,6 @@ function slotOverflow(composition) {
87
86
  return null;
88
87
  return {
89
88
  slot: composition.slot,
90
- capTokens: cap,
91
- projectedTokens: used,
92
89
  overflowBy: used - cap,
93
90
  planAction: 'none',
94
91
  unit: 'chars',
@@ -109,7 +106,7 @@ function formatOverflowWarning(opts) {
109
106
  const { pressure, itemCount, itemNoun, contentNoun, remedy } = opts;
110
107
  const unit = pressure.unit ?? 'chars';
111
108
  return (`[agentfootprint] ${pressure.slot} slot over budget: ` +
112
- `${pressure.projectedTokens}/${pressure.capTokens} ${unit} (+${pressure.overflowBy}), ` +
109
+ `${pressure.projected}/${pressure.cap} ${unit} (+${pressure.overflowBy}), ` +
113
110
  `${itemCount} ${itemNoun}(s). Nothing was truncated — the full ${contentNoun} were sent ` +
114
111
  `to the LLM — but the slot budget signal is unreliable. ${remedy}`);
115
112
  }
@@ -1 +1 @@
1
- {"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/core/slots/helpers.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/core/slots/helpers.ts"],"names":[],"mappings":"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"}
@@ -15,19 +15,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
17
  /**
18
- * agentfootprint/debug/finders — context-error finder strategies.
18
+ * debug/finders — context-error finder strategies.
19
19
  *
20
20
  * Collapsed home for what was the 3-level-deep
21
- * `agentfootprint/observability/contextError/finders` path. Same
22
- * tree-shakeable, re-export-only barrel — one finder = one file = one
23
- * named export — now under the Debug category where it belongs.
21
+ * `src/observability/contextError/finders/` barrel. Same tree-shakeable,
22
+ * re-export-only shape — one finder = one file = one named export — now under
23
+ * the Debug category where it belongs.
24
24
  *
25
- * The old `agentfootprint/observability/contextError/finders` path is kept
26
- * (deprecated) for one transition version.
27
- *
28
- * @deprecated Since 8.0.0 — import from `agentfootprint/observe` instead.
29
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
30
- * here is the same symbol on the new door, not a copy.
25
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
26
+ * behind `agentfootprint/observe`, which re-exports every name here — same
27
+ * symbols, one door. Import from the door.
31
28
  */
32
29
  __exportStar(require("../observability/contextError/finders/index.js"), exports);
33
30
  //# sourceMappingURL=finders.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"finders.js","sourceRoot":"","sources":["../../src/debug/finders.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;GAcG;AACH,iFAA+D"}
1
+ {"version":3,"file":"finders.js","sourceRoot":"","sources":["../../src/debug/finders.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;GAWG;AACH,iFAA+D"}
package/dist/debug.js CHANGED
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  /**
3
- * agentfootprint/debug — diagnosis tools for a BROKEN run.
3
+ * debug — diagnosis tools for a BROKEN run.
4
4
  *
5
5
  * Where `agentfootprint/observe` watches a HEALTHY run (recorders), this
6
6
  * subpath is the autopsy kit for a wrong answer. Split out of `observe` in
@@ -18,9 +18,9 @@
18
18
  * For backward compatibility these are ALSO re-exported (deprecated) from
19
19
  * `agentfootprint/observe` for one transition version.
20
20
  *
21
- * @deprecated Since 8.0.0 — import from `agentfootprint/observe` instead.
22
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
23
- * here is the same symbol on the new door, not a copy.
21
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
22
+ * behind `agentfootprint/observe`, which re-exports every name here — same
23
+ * symbols, one door. Import from the door.
24
24
  */
25
25
  Object.defineProperty(exports, "__esModule", { value: true });
26
26
  exports.assignCostVerdicts = exports.assembleTrajectory = exports.applyAblations = exports.ablationForSuspect = exports.traceDebugAgent = exports.SelfExplainBinding = exports.SELF_EXPLAIN_MAX_EVENTS = exports.buildSelfExplainToolProvider = exports.buildSelfExplainSkill = exports.mergeInnerRuns = exports.innerRunsOf = exports.innerRunStore = exports.INNER_RUN_RECORDS = exports.DEFAULT_INNER_RUN_LIMIT = exports.openRecording = exports.traceToolpack = exports.TRACE_TOOL_NAMES = exports.TOOLPACK_HARD_CAPS = exports.NO_COMPLETED_RUN_MESSAGE = exports.lazyTraceToolpack = exports.callTraceTool = exports.structuralProximity = exports.snippetUnits = exports.semanticAlignmentStrategy = exports.scoreMargin = exports.scoreLexicalInfluence = exports.scoreInfluence = exports.scoreContrastiveInfluence = exports.ratioStrategy = exports.rankingConfidence = exports.persistence = exports.pairwiseSimilarity = exports.marginStrategy = exports.listInfluenceStrategies = exports.lexicalOverlapStrategy = exports.explainChoice = exports.attributeChoice = exports.finalAnswerSimilarity = exports.embeddingCache = exports.EmbeddingCache = exports.DEFAULT_SHORTLIST_BAND = exports.DEFAULT_PERSISTENCE_THRESHOLD = exports.DEFAULT_MARGIN_THRESHOLD = exports.DEFAULT_INFLUENCE_WEIGHTS = exports.DEFAULT_CLEAR_WINNER_RATIO = exports.DEFAULT_CLEAR_WINNER_MARGIN = exports.contentHash = exports.compositeScore = exports.averageRelevancy = exports.adaptWeights = void 0;
@@ -6,9 +6,9 @@
6
6
  * one, and the engine subflow that resolves them into the three slots a
7
7
  * request is made of (system prompt, messages, tools).
8
8
  *
9
- * Named for the job rather than the machine — this was
10
- * `agentfootprint/injection-engine`, which described our implementation
11
- * instead of your task.
9
+ * Named for the job rather than the machine — through 8.x this was also
10
+ * reachable at `agentfootprint/injection-engine`, which described our
11
+ * implementation instead of your task. That path was removed in 9.0.0.
12
12
  *
13
13
  * @example
14
14
  * ```ts
@@ -2,7 +2,7 @@
2
2
  * adapters/hosting/agentcore — AWS Bedrock **AgentCore Runtime** adapters for
3
3
  * the two hosting ports.
4
4
  *
5
- * import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting-providers';
5
+ * import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting';
6
6
  * import { standingAgent } from 'agentfootprint/hosting';
7
7
  *
8
8
  * const handle = await standingAgent({
@@ -2,7 +2,7 @@
2
2
  * adapters/hosting/agentcore — AWS Bedrock **AgentCore Runtime** adapters for
3
3
  * the two hosting ports.
4
4
  *
5
- * import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting-providers';
5
+ * import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting';
6
6
  * import { standingAgent } from 'agentfootprint/hosting';
7
7
  *
8
8
  * const handle = await standingAgent({
@@ -2,7 +2,7 @@
2
2
  * agentCoreIdentity — AWS Bedrock AgentCore Identity adapter (peer-dep
3
3
  * `@aws-sdk/client-bedrock-agentcore`).
4
4
  *
5
- * import { agentCoreIdentity } from 'agentfootprint/identity';
5
+ * import { agentCoreIdentity } from 'agentfootprint/security';
6
6
  * const credentials = agentCoreIdentity({ region: 'us-east-1' });
7
7
  *
8
8
  * Maps the {@link CredentialProvider} port onto AgentCore Identity's
@@ -2,7 +2,7 @@
2
2
  * agentCoreIdentity — AWS Bedrock AgentCore Identity adapter (peer-dep
3
3
  * `@aws-sdk/client-bedrock-agentcore`).
4
4
  *
5
- * import { agentCoreIdentity } from 'agentfootprint/identity';
5
+ * import { agentCoreIdentity } from 'agentfootprint/security';
6
6
  * const credentials = agentCoreIdentity({ region: 'us-east-1' });
7
7
  *
8
8
  * Maps the {@link CredentialProvider} port onto AgentCore Identity's
@@ -160,7 +160,7 @@ export interface AnthropicProviderOptions {
160
160
  *
161
161
  * @example
162
162
  * import { Agent } from 'agentfootprint';
163
- * import { anthropic } from 'agentfootprint/llm-providers';
163
+ * import { anthropic } from 'agentfootprint/providers';
164
164
  *
165
165
  * const agent = Agent.create({
166
166
  * provider: anthropic({ defaultModel: 'claude-sonnet-4-5-20250929' }),
@@ -32,7 +32,7 @@ const CARRIES_IN_MESSAGES = Object.freeze(['user', 'assistant']);
32
32
  *
33
33
  * @example
34
34
  * import { Agent } from 'agentfootprint';
35
- * import { anthropic } from 'agentfootprint/llm-providers';
35
+ * import { anthropic } from 'agentfootprint/providers';
36
36
  *
37
37
  * const agent = Agent.create({
38
38
  * provider: anthropic({ defaultModel: 'claude-sonnet-4-5-20250929' }),
@@ -81,7 +81,7 @@ export interface BrowserAzureOpenAIProviderOptions {
81
81
  * proxy) or a backend. Same trade-off as `browserOpenai`.
82
82
  *
83
83
  * @example
84
- * import { browserAzureOpenai } from 'agentfootprint/llm-providers';
84
+ * import { browserAzureOpenai } from 'agentfootprint/providers';
85
85
  * const provider = browserAzureOpenai({
86
86
  * endpoint: 'https://my-co.openai.azure.com',
87
87
  * apiKey: userKey, apiVersion: '2024-12-01-preview', deployment: 'gpt-4o-128k',
@@ -194,7 +194,7 @@ const AZURE_BROWSER_SHORTHANDS = new Set([
194
194
  * proxy) or a backend. Same trade-off as `browserOpenai`.
195
195
  *
196
196
  * @example
197
- * import { browserAzureOpenai } from 'agentfootprint/llm-providers';
197
+ * import { browserAzureOpenai } from 'agentfootprint/providers';
198
198
  * const provider = browserAzureOpenai({
199
199
  * endpoint: 'https://my-co.openai.azure.com',
200
200
  * apiKey: userKey, apiVersion: '2024-12-01-preview', deployment: 'gpt-4o-128k',
@@ -155,7 +155,7 @@ export declare class MockProvider implements LLMProvider {
155
155
  *
156
156
  * @example
157
157
  * import { Agent, defineTool } from 'agentfootprint'
158
- import { mock } from 'agentfootprint/llm-providers';
158
+ import { mock } from 'agentfootprint/providers';
159
159
  *
160
160
  * const agent = Agent.create({ provider: mock({ reply: 'hello' }) })
161
161
  * .tool(defineTool({ name: 'echo', ... }))
@@ -173,7 +173,7 @@ export class MockProvider {
173
173
  *
174
174
  * @example
175
175
  * import { Agent, defineTool } from 'agentfootprint'
176
- import { mock } from 'agentfootprint/llm-providers';
176
+ import { mock } from 'agentfootprint/providers';
177
177
  *
178
178
  * const agent = Agent.create({ provider: mock({ reply: 'hello' }) })
179
179
  * .tool(defineTool({ name: 'echo', ... }))
@@ -143,7 +143,7 @@ export interface OpenAIProviderOptions {
143
143
  *
144
144
  * @example
145
145
  * import { Agent } from 'agentfootprint';
146
- * import { openai } from 'agentfootprint/llm-providers';
146
+ * import { openai } from 'agentfootprint/providers';
147
147
  *
148
148
  * const agent = Agent.create({
149
149
  * provider: openai({ defaultModel: 'gpt-4o' }),
@@ -205,7 +205,7 @@ export interface AzureOpenAIProviderOptions {
205
205
  * configured default `deployment`.
206
206
  *
207
207
  * @example
208
- * import { azureOpenai } from 'agentfootprint/llm-providers';
208
+ * import { azureOpenai } from 'agentfootprint/providers';
209
209
  *
210
210
  * const agent = Agent.create({
211
211
  * provider: azureOpenai({
@@ -33,7 +33,7 @@ const CARRIES_IN_MESSAGES = Object.freeze(['system', 'user', 'assistant']);
33
33
  *
34
34
  * @example
35
35
  * import { Agent } from 'agentfootprint';
36
- * import { openai } from 'agentfootprint/llm-providers';
36
+ * import { openai } from 'agentfootprint/providers';
37
37
  *
38
38
  * const agent = Agent.create({
39
39
  * provider: openai({ defaultModel: 'gpt-4o' }),
@@ -194,7 +194,7 @@ const AZURE_MODEL_SHORTHANDS = new Set(['azure', 'azure-openai', 'openai']);
194
194
  * configured default `deployment`.
195
195
  *
196
196
  * @example
197
- * import { azureOpenai } from 'agentfootprint/llm-providers';
197
+ * import { azureOpenai } from 'agentfootprint/providers';
198
198
  *
199
199
  * const agent = Agent.create({
200
200
  * provider: azureOpenai({
@@ -2,7 +2,7 @@
2
2
  * AgentCoreStore — AWS Bedrock **AgentCore Memory** adapter
3
3
  * (peer-dep `@aws-sdk/client-bedrock-agentcore`).
4
4
  *
5
- * import { AgentCoreStore } from 'agentfootprint/memory-providers';
5
+ * import { AgentCoreStore } from 'agentfootprint/memory';
6
6
  *
7
7
  * const store = new AgentCoreStore({
8
8
  * memoryId: 'arn:aws:bedrock-agentcore:us-west-2:...:memory/my-mem',
@@ -2,7 +2,7 @@
2
2
  * AgentCoreStore — AWS Bedrock **AgentCore Memory** adapter
3
3
  * (peer-dep `@aws-sdk/client-bedrock-agentcore`).
4
4
  *
5
- * import { AgentCoreStore } from 'agentfootprint/memory-providers';
5
+ * import { AgentCoreStore } from 'agentfootprint/memory';
6
6
  *
7
7
  * const store = new AgentCoreStore({
8
8
  * memoryId: 'arn:aws:bedrock-agentcore:us-west-2:...:memory/my-mem',
@@ -2,7 +2,7 @@
2
2
  * BedrockAgentMemory — read the **auto-generated session-summary memory** of a
3
3
  * (legacy) Amazon **Bedrock Agents** agent (peer-dep `@aws-sdk/client-bedrock-agent-runtime`).
4
4
  *
5
- * import { BedrockAgentMemory } from 'agentfootprint/memory-providers';
5
+ * import { BedrockAgentMemory } from 'agentfootprint/memory';
6
6
  *
7
7
  * const mem = new BedrockAgentMemory({ agentId, agentAliasId, region: 'us-west-2' });
8
8
  * const summaries = await mem.readSummaries(userMemoryId); // string summaries Bedrock wrote
@@ -2,7 +2,7 @@
2
2
  * BedrockAgentMemory — read the **auto-generated session-summary memory** of a
3
3
  * (legacy) Amazon **Bedrock Agents** agent (peer-dep `@aws-sdk/client-bedrock-agent-runtime`).
4
4
  *
5
- * import { BedrockAgentMemory } from 'agentfootprint/memory-providers';
5
+ * import { BedrockAgentMemory } from 'agentfootprint/memory';
6
6
  *
7
7
  * const mem = new BedrockAgentMemory({ agentId, agentAliasId, region: 'us-west-2' });
8
8
  * const summaries = await mem.readSummaries(userMemoryId); // string summaries Bedrock wrote
@@ -4,7 +4,7 @@
4
4
  * Import from the canonical subpath (the `agentfootprint/memory-redis` alias
5
5
  * was removed in 4.0.0):
6
6
  *
7
- * import { RedisStore } from 'agentfootprint/memory-providers';
7
+ * import { RedisStore } from 'agentfootprint/memory';
8
8
  *
9
9
  * const store = new RedisStore({ url: 'redis://localhost:6379' });
10
10
  *
@@ -4,7 +4,7 @@
4
4
  * Import from the canonical subpath (the `agentfootprint/memory-redis` alias
5
5
  * was removed in 4.0.0):
6
6
  *
7
- * import { RedisStore } from 'agentfootprint/memory-providers';
7
+ * import { RedisStore } from 'agentfootprint/memory';
8
8
  *
9
9
  * const store = new RedisStore({ url: 'redis://localhost:6379' });
10
10
  *
@@ -11,7 +11,7 @@
11
11
  * behavior in CloudWatch Insights / X-Ray traces using the same
12
12
  * schema AgentCore uses internally.
13
13
  *
14
- * Subpath: `agentfootprint/observability-providers`
14
+ * Subpath: `agentfootprint/observe`
15
15
  * Peer dep: `@aws-sdk/client-cloudwatch-logs` (OPTIONAL — installed
16
16
  * only when this adapter is used; declared via
17
17
  * `peerDependenciesMeta.{name}.optional = true`).
@@ -25,7 +25,7 @@
25
25
  *
26
26
  * @example Basic
27
27
  * ```ts
28
- * import { agentcoreObservability } from 'agentfootprint/observability-providers';
28
+ * import { agentcoreObservability } from 'agentfootprint/observe';
29
29
  * import { microtaskBatchDriver } from 'footprintjs/detach';
30
30
  *
31
31
  * agent.enable.observability({
@@ -11,7 +11,7 @@
11
11
  * behavior in CloudWatch Insights / X-Ray traces using the same
12
12
  * schema AgentCore uses internally.
13
13
  *
14
- * Subpath: `agentfootprint/observability-providers`
14
+ * Subpath: `agentfootprint/observe`
15
15
  * Peer dep: `@aws-sdk/client-cloudwatch-logs` (OPTIONAL — installed
16
16
  * only when this adapter is used; declared via
17
17
  * `peerDependenciesMeta.{name}.optional = true`).
@@ -25,7 +25,7 @@
25
25
  *
26
26
  * @example Basic
27
27
  * ```ts
28
- * import { agentcoreObservability } from 'agentfootprint/observability-providers';
28
+ * import { agentcoreObservability } from 'agentfootprint/observe';
29
29
  * import { microtaskBatchDriver } from 'footprintjs/detach';
30
30
  *
31
31
  * agent.enable.observability({
@@ -115,7 +115,7 @@
115
115
  *
116
116
  * @example Capture → export → verify
117
117
  * ```ts
118
- * import { auditExport, verifyAuditBundle } from 'agentfootprint/observability-providers';
118
+ * import { auditExport, verifyAuditBundle } from 'agentfootprint/observe';
119
119
  *
120
120
  * const audit = auditExport({ agent: 'loan-officer' });
121
121
  * const stop = agent.enable.observability({ strategy: audit });
@@ -115,7 +115,7 @@
115
115
  *
116
116
  * @example Capture → export → verify
117
117
  * ```ts
118
- * import { auditExport, verifyAuditBundle } from 'agentfootprint/observability-providers';
118
+ * import { auditExport, verifyAuditBundle } from 'agentfootprint/observe';
119
119
  *
120
120
  * const audit = auditExport({ agent: 'loan-officer' });
121
121
  * const stop = agent.enable.observability({ strategy: audit });
@@ -13,7 +13,7 @@
13
13
  * 2. You want full control over log group / stream / format and
14
14
  * don't need AgentCore's hosted-agent telemetry conventions.
15
15
  *
16
- * Subpath: `agentfootprint/observability-providers`
16
+ * Subpath: `agentfootprint/observe`
17
17
  * Peer dep: `@aws-sdk/client-cloudwatch-logs` (OPTIONAL — installed
18
18
  * only when this adapter is used; declared via
19
19
  * `peerDependenciesMeta.{name}.optional = true`).
@@ -25,7 +25,7 @@
25
25
  *
26
26
  * @example
27
27
  * ```ts
28
- * import { cloudwatchObservability } from 'agentfootprint/observability-providers';
28
+ * import { cloudwatchObservability } from 'agentfootprint/observe';
29
29
  * import { microtaskBatchDriver } from 'footprintjs/detach';
30
30
  *
31
31
  * agent.enable.observability({
@@ -13,7 +13,7 @@
13
13
  * 2. You want full control over log group / stream / format and
14
14
  * don't need AgentCore's hosted-agent telemetry conventions.
15
15
  *
16
- * Subpath: `agentfootprint/observability-providers`
16
+ * Subpath: `agentfootprint/observe`
17
17
  * Peer dep: `@aws-sdk/client-cloudwatch-logs` (OPTIONAL — installed
18
18
  * only when this adapter is used; declared via
19
19
  * `peerDependenciesMeta.{name}.optional = true`).
@@ -25,7 +25,7 @@
25
25
  *
26
26
  * @example
27
27
  * ```ts
28
- * import { cloudwatchObservability } from 'agentfootprint/observability-providers';
28
+ * import { cloudwatchObservability } from 'agentfootprint/observe';
29
29
  * import { microtaskBatchDriver } from 'footprintjs/detach';
30
30
  *
31
31
  * agent.enable.observability({
@@ -17,7 +17,7 @@
17
17
  * - **Lightstep / ServiceNow Cloud Observability** (OTLP)
18
18
  * - any custom OTel collector / processor pipeline
19
19
  *
20
- * Subpath: `agentfootprint/observability-providers`
20
+ * Subpath: `agentfootprint/observe`
21
21
  * Peer dep: `@opentelemetry/api` (OPTIONAL — installed only when
22
22
  * this adapter is used. The consumer ALSO installs the
23
23
  * OTel SDK + exporter of their choice — that's the BYO
@@ -90,7 +90,7 @@
90
90
  * import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
91
91
  * import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
92
92
  * import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
93
- * import { otelObservability } from 'agentfootprint/observability-providers';
93
+ * import { otelObservability } from 'agentfootprint/observe';
94
94
  *
95
95
  * // Set up OTel ONCE at app startup.
96
96
  * const provider = new NodeTracerProvider();
@@ -106,7 +106,7 @@
106
106
  * });
107
107
  * agent.enable.observability({ strategy: otel });
108
108
  * // Optional — operator-level decide()/select() evidence as span events:
109
- * // Agent.create({...}).recorder(otel.decisionEvidenceRecorder())
109
+ * // Agent.create({...}).watch(otel.decisionEvidenceRecorder())
110
110
  * ```
111
111
  *
112
112
  * @example Test injection
@@ -205,7 +205,7 @@ export interface OtelSpanLike {
205
205
  * footprintjs CombinedRecorder (FlowRecorder channel) that forwards
206
206
  * decide()/select() operator-level evidence into the paired
207
207
  * otelObservability strategy as span events. Attach via
208
- * `Agent.create({...}).recorder(...)` or
208
+ * `Agent.create({...}).watch(...)` or
209
209
  * `executor.attachCombinedRecorder(...)`.
210
210
  */
211
211
  export interface OtelDecisionEvidenceRecorder {
@@ -17,7 +17,7 @@
17
17
  * - **Lightstep / ServiceNow Cloud Observability** (OTLP)
18
18
  * - any custom OTel collector / processor pipeline
19
19
  *
20
- * Subpath: `agentfootprint/observability-providers`
20
+ * Subpath: `agentfootprint/observe`
21
21
  * Peer dep: `@opentelemetry/api` (OPTIONAL — installed only when
22
22
  * this adapter is used. The consumer ALSO installs the
23
23
  * OTel SDK + exporter of their choice — that's the BYO
@@ -90,7 +90,7 @@
90
90
  * import { NodeTracerProvider } from '@opentelemetry/sdk-trace-node';
91
91
  * import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
92
92
  * import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
93
- * import { otelObservability } from 'agentfootprint/observability-providers';
93
+ * import { otelObservability } from 'agentfootprint/observe';
94
94
  *
95
95
  * // Set up OTel ONCE at app startup.
96
96
  * const provider = new NodeTracerProvider();
@@ -106,7 +106,7 @@
106
106
  * });
107
107
  * agent.enable.observability({ strategy: otel });
108
108
  * // Optional — operator-level decide()/select() evidence as span events:
109
- * // Agent.create({...}).recorder(otel.decisionEvidenceRecorder())
109
+ * // Agent.create({...}).watch(otel.decisionEvidenceRecorder())
110
110
  * ```
111
111
  *
112
112
  * @example Test injection
@@ -24,7 +24,7 @@
24
24
  * trace via `AWSTraceHeader` propagation (consumer's responsibility
25
25
  * to wire upstream/downstream IDs).
26
26
  *
27
- * Subpath: `agentfootprint/observability-providers`
27
+ * Subpath: `agentfootprint/observe`
28
28
  * Peer dep: `@aws-sdk/client-xray` (OPTIONAL — installed only when
29
29
  * this adapter is used).
30
30
  *
@@ -36,7 +36,7 @@
36
36
  *
37
37
  * @example
38
38
  * ```ts
39
- * import { xrayObservability } from 'agentfootprint/observability-providers';
39
+ * import { xrayObservability } from 'agentfootprint/observe';
40
40
  * import { microtaskBatchDriver } from 'footprintjs/detach';
41
41
  *
42
42
  * agent.enable.observability({
@@ -24,7 +24,7 @@
24
24
  * trace via `AWSTraceHeader` propagation (consumer's responsibility
25
25
  * to wire upstream/downstream IDs).
26
26
  *
27
- * Subpath: `agentfootprint/observability-providers`
27
+ * Subpath: `agentfootprint/observe`
28
28
  * Peer dep: `@aws-sdk/client-xray` (OPTIONAL — installed only when
29
29
  * this adapter is used).
30
30
  *
@@ -36,7 +36,7 @@
36
36
  *
37
37
  * @example
38
38
  * ```ts
39
- * import { xrayObservability } from 'agentfootprint/observability-providers';
39
+ * import { xrayObservability } from 'agentfootprint/observe';
40
40
  * import { microtaskBatchDriver } from 'footprintjs/detach';
41
41
  *
42
42
  * agent.enable.observability({
@@ -442,7 +442,7 @@ export class Agent extends RunnerBase {
442
442
  "'authorization-required', and with no provider no credential is ever requested (the " +
443
443
  'fail-closed stand-in throws instead). Pass `credentials` — agentCoreIdentity({ ' +
444
444
  'region }), staticTokens({ … }), or any CredentialProvider from ' +
445
- "'agentfootprint/identity' — or drop `onAuthorizationRequired`.");
445
+ "'agentfootprint/security' — or drop `onAuthorizationRequired`.");
446
446
  }
447
447
  // 8.6.0 — default `'pause'`: consent is work waiting on a person, and the
448
448
  // model is the one party that cannot click a link.