agentfootprint 8.20.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 (302) hide show
  1. package/README.md +2 -2
  2. package/dist/adapters/hosting/agentcore.js +1 -1
  3. package/dist/adapters/identity/agentcore.js +1 -1
  4. package/dist/adapters/llm/AnthropicProvider.js +1 -1
  5. package/dist/adapters/llm/BrowserOpenAIProvider.js +1 -1
  6. package/dist/adapters/llm/MockProvider.js +1 -1
  7. package/dist/adapters/llm/OpenAIProvider.js +2 -2
  8. package/dist/adapters/memory/agentcore.js +1 -1
  9. package/dist/adapters/memory/bedrockAgentMemory.js +1 -1
  10. package/dist/adapters/memory/redis.js +1 -1
  11. package/dist/adapters/observability/agentcore.js +2 -2
  12. package/dist/adapters/observability/audit.js +1 -1
  13. package/dist/adapters/observability/cloudwatch.js +2 -2
  14. package/dist/adapters/observability/otel.js +3 -3
  15. package/dist/adapters/observability/xray.js +2 -2
  16. package/dist/core/Agent.js +1 -1
  17. package/dist/core/agent/AgentBuilder.js +35 -23
  18. package/dist/core/agent/AgentBuilder.js.map +1 -1
  19. package/dist/core/agent/stages/window.js +11 -13
  20. package/dist/core/agent/stages/window.js.map +1 -1
  21. package/dist/core/agent/watch.js +1 -1
  22. package/dist/core/agent/window/index.js.map +1 -1
  23. package/dist/core/agent/window/strategies/summarizeOldest.js +0 -5
  24. package/dist/core/agent/window/strategies/summarizeOldest.js.map +1 -1
  25. package/dist/core/slots/helpers.js +4 -7
  26. package/dist/core/slots/helpers.js.map +1 -1
  27. package/dist/debug/finders.js +7 -10
  28. package/dist/debug/finders.js.map +1 -1
  29. package/dist/debug.js +4 -4
  30. package/dist/doors/context.js +3 -3
  31. package/dist/esm/adapters/hosting/agentcore.d.ts +1 -1
  32. package/dist/esm/adapters/hosting/agentcore.js +1 -1
  33. package/dist/esm/adapters/identity/agentcore.d.ts +1 -1
  34. package/dist/esm/adapters/identity/agentcore.js +1 -1
  35. package/dist/esm/adapters/llm/AnthropicProvider.d.ts +1 -1
  36. package/dist/esm/adapters/llm/AnthropicProvider.js +1 -1
  37. package/dist/esm/adapters/llm/BrowserOpenAIProvider.d.ts +1 -1
  38. package/dist/esm/adapters/llm/BrowserOpenAIProvider.js +1 -1
  39. package/dist/esm/adapters/llm/MockProvider.d.ts +1 -1
  40. package/dist/esm/adapters/llm/MockProvider.js +1 -1
  41. package/dist/esm/adapters/llm/OpenAIProvider.d.ts +2 -2
  42. package/dist/esm/adapters/llm/OpenAIProvider.js +2 -2
  43. package/dist/esm/adapters/memory/agentcore.d.ts +1 -1
  44. package/dist/esm/adapters/memory/agentcore.js +1 -1
  45. package/dist/esm/adapters/memory/bedrockAgentMemory.d.ts +1 -1
  46. package/dist/esm/adapters/memory/bedrockAgentMemory.js +1 -1
  47. package/dist/esm/adapters/memory/redis.d.ts +1 -1
  48. package/dist/esm/adapters/memory/redis.js +1 -1
  49. package/dist/esm/adapters/observability/agentcore.d.ts +2 -2
  50. package/dist/esm/adapters/observability/agentcore.js +2 -2
  51. package/dist/esm/adapters/observability/audit.d.ts +1 -1
  52. package/dist/esm/adapters/observability/audit.js +1 -1
  53. package/dist/esm/adapters/observability/cloudwatch.d.ts +2 -2
  54. package/dist/esm/adapters/observability/cloudwatch.js +2 -2
  55. package/dist/esm/adapters/observability/otel.d.ts +4 -4
  56. package/dist/esm/adapters/observability/otel.js +3 -3
  57. package/dist/esm/adapters/observability/xray.d.ts +2 -2
  58. package/dist/esm/adapters/observability/xray.js +2 -2
  59. package/dist/esm/core/Agent.js +1 -1
  60. package/dist/esm/core/agent/AgentBuilder.d.ts +17 -14
  61. package/dist/esm/core/agent/AgentBuilder.js +35 -23
  62. package/dist/esm/core/agent/AgentBuilder.js.map +1 -1
  63. package/dist/esm/core/agent/stages/window.js +11 -13
  64. package/dist/esm/core/agent/stages/window.js.map +1 -1
  65. package/dist/esm/core/agent/types.d.ts +2 -2
  66. package/dist/esm/core/agent/watch.d.ts +1 -1
  67. package/dist/esm/core/agent/watch.js +1 -1
  68. package/dist/esm/core/agent/window/index.d.ts +1 -1
  69. package/dist/esm/core/agent/window/index.js.map +1 -1
  70. package/dist/esm/core/agent/window/strategies/summarizeOldest.js +0 -5
  71. package/dist/esm/core/agent/window/strategies/summarizeOldest.js.map +1 -1
  72. package/dist/esm/core/agent/window/types.d.ts +0 -30
  73. package/dist/esm/core/runner.d.ts +1 -1
  74. package/dist/esm/core/slots/helpers.d.ts +3 -4
  75. package/dist/esm/core/slots/helpers.js +4 -7
  76. package/dist/esm/core/slots/helpers.js.map +1 -1
  77. package/dist/esm/debug/finders.d.ts +7 -10
  78. package/dist/esm/debug/finders.js +7 -10
  79. package/dist/esm/debug/finders.js.map +1 -1
  80. package/dist/esm/debug.d.ts +4 -4
  81. package/dist/esm/debug.js +4 -4
  82. package/dist/esm/doors/context.d.ts +3 -3
  83. package/dist/esm/doors/context.js +3 -3
  84. package/dist/esm/embedders/index.d.ts +4 -4
  85. package/dist/esm/events/payloads.d.ts +10 -14
  86. package/dist/esm/hosting-providers.d.ts +16 -16
  87. package/dist/esm/hosting-providers.js +16 -16
  88. package/dist/esm/identity/types.d.ts +1 -1
  89. package/dist/esm/identity/types.js +1 -1
  90. package/dist/esm/identity/withCredentialRetry.d.ts +1 -1
  91. package/dist/esm/identity/withCredentialRetry.js +1 -1
  92. package/dist/esm/identity.d.ts +5 -5
  93. package/dist/esm/identity.js +5 -5
  94. package/dist/esm/index.d.ts +1 -1
  95. package/dist/esm/index.js +4 -4
  96. package/dist/esm/index.js.map +1 -1
  97. package/dist/esm/injection-engine.d.ts +4 -4
  98. package/dist/esm/injection-engine.js +4 -4
  99. package/dist/esm/lib/context-ledger/gates.d.ts +1 -1
  100. package/dist/esm/lib/context-ledger/gates.js +1 -1
  101. package/dist/esm/lib/injection-engine/SkillRegistry.d.ts +1 -1
  102. package/dist/esm/lib/injection-engine/SkillRegistry.js +1 -1
  103. package/dist/esm/lib/injection-engine/factories/defineSkill.d.ts +1 -16
  104. package/dist/esm/lib/injection-engine/factories/defineSkill.js +29 -1
  105. package/dist/esm/lib/injection-engine/factories/defineSkill.js.map +1 -1
  106. package/dist/esm/lib/injection-engine/skillsFromDir.d.ts +1 -11
  107. package/dist/esm/lib/injection-engine/skillsFromDir.js +22 -2
  108. package/dist/esm/lib/injection-engine/skillsFromDir.js.map +1 -1
  109. package/dist/esm/lib/injection-engine/types.d.ts +1 -1
  110. package/dist/esm/lib/mcp/gatewayTransport.d.ts +2 -2
  111. package/dist/esm/lib/mcp/gatewayTransport.js +2 -2
  112. package/dist/esm/lib/recorded-chat/index.d.ts +1 -1
  113. package/dist/esm/lib/recorded-chat/index.js +1 -1
  114. package/dist/esm/llm-providers.d.ts +5 -19
  115. package/dist/esm/llm-providers.js +5 -19
  116. package/dist/esm/llm-providers.js.map +1 -1
  117. package/dist/esm/locales/index.d.ts +7 -7
  118. package/dist/esm/locales/index.js +7 -7
  119. package/dist/esm/memory/causal/evidenceRecorder.d.ts +1 -1
  120. package/dist/esm/memory/causal/evidenceRecorder.js +1 -1
  121. package/dist/esm/memory/define.types.d.ts +3 -2
  122. package/dist/esm/memory/define.types.js.map +1 -1
  123. package/dist/esm/memory/index.d.ts +0 -10
  124. package/dist/esm/memory/index.js +6 -0
  125. package/dist/esm/memory/index.js.map +1 -1
  126. package/dist/esm/memory-providers.d.ts +8 -24
  127. package/dist/esm/memory-providers.js +8 -24
  128. package/dist/esm/memory-providers.js.map +1 -1
  129. package/dist/esm/observability/contextError/finders/index.d.ts +4 -4
  130. package/dist/esm/observability-providers.d.ts +5 -5
  131. package/dist/esm/observability-providers.js +5 -5
  132. package/dist/esm/observe.js +6 -6
  133. package/dist/esm/observe.js.map +1 -1
  134. package/dist/esm/providers.d.ts +2 -2
  135. package/dist/esm/providers.js +2 -2
  136. package/dist/esm/recorders/core/ContextRecorder.js +47 -11
  137. package/dist/esm/recorders/core/ContextRecorder.js.map +1 -1
  138. package/dist/esm/recorders/core/types.d.ts +16 -18
  139. package/dist/esm/recorders/core/types.js.map +1 -1
  140. package/dist/esm/recorders/observability/RouteRecorder.d.ts +1 -1
  141. package/dist/esm/recorders/observability/RouteRecorder.js +1 -1
  142. package/dist/esm/recorders/observability/ToolChoiceRecorder.d.ts +1 -1
  143. package/dist/esm/recorders/observability/ToolChoiceRecorder.js +1 -1
  144. package/dist/esm/reliability/index.d.ts +15 -3
  145. package/dist/esm/reliability/index.js +15 -3
  146. package/dist/esm/reliability/index.js.map +1 -1
  147. package/dist/esm/resilience/fallbackProvider.d.ts +1 -1
  148. package/dist/esm/resilience/fallbackProvider.js +1 -1
  149. package/dist/esm/resilience/withCircuitBreaker.d.ts +1 -1
  150. package/dist/esm/resilience/withCircuitBreaker.js +1 -1
  151. package/dist/esm/resilience/withRetry.d.ts +1 -1
  152. package/dist/esm/resilience/withRetry.js +1 -1
  153. package/dist/esm/security/PermissionPolicy.d.ts +2 -2
  154. package/dist/esm/security/PermissionPolicy.js +2 -2
  155. package/dist/esm/security/index.d.ts +3 -3
  156. package/dist/esm/security/index.js +3 -3
  157. package/dist/esm/status.d.ts +14 -24
  158. package/dist/esm/status.js +15 -25
  159. package/dist/esm/status.js.map +1 -1
  160. package/dist/esm/strategies/index.d.ts +9 -16
  161. package/dist/esm/strategies/index.js +9 -16
  162. package/dist/esm/strategies/index.js.map +1 -1
  163. package/dist/esm/strategies/registry.d.ts +1 -1
  164. package/dist/esm/strategies/registry.js +1 -1
  165. package/dist/esm/stream.d.ts +4 -4
  166. package/dist/esm/stream.js +4 -4
  167. package/dist/esm/thinking/index.d.ts +5 -5
  168. package/dist/esm/thinking/index.js +5 -5
  169. package/dist/esm/tool-providers/index.d.ts +4 -4
  170. package/dist/esm/tool-providers/index.js +4 -4
  171. package/dist/hosting-providers.js +16 -16
  172. package/dist/identity/types.js +1 -1
  173. package/dist/identity/withCredentialRetry.js +1 -1
  174. package/dist/identity.js +5 -5
  175. package/dist/index.js +4 -4
  176. package/dist/index.js.map +1 -1
  177. package/dist/injection-engine.js +4 -4
  178. package/dist/lib/context-ledger/gates.js +1 -1
  179. package/dist/lib/injection-engine/SkillRegistry.js +1 -1
  180. package/dist/lib/injection-engine/factories/defineSkill.js +29 -1
  181. package/dist/lib/injection-engine/factories/defineSkill.js.map +1 -1
  182. package/dist/lib/injection-engine/skillsFromDir.js +22 -2
  183. package/dist/lib/injection-engine/skillsFromDir.js.map +1 -1
  184. package/dist/lib/mcp/gatewayTransport.js +2 -2
  185. package/dist/lib/recorded-chat/index.js +1 -1
  186. package/dist/llm-providers.js +5 -19
  187. package/dist/llm-providers.js.map +1 -1
  188. package/dist/locales/index.js +6 -6
  189. package/dist/memory/causal/evidenceRecorder.js +1 -1
  190. package/dist/memory/define.types.js.map +1 -1
  191. package/dist/memory/index.js +6 -0
  192. package/dist/memory/index.js.map +1 -1
  193. package/dist/memory-providers.js +8 -24
  194. package/dist/memory-providers.js.map +1 -1
  195. package/dist/observability-providers.js +5 -5
  196. package/dist/observe.js +6 -6
  197. package/dist/observe.js.map +1 -1
  198. package/dist/providers.js +2 -2
  199. package/dist/recorders/core/ContextRecorder.js +47 -11
  200. package/dist/recorders/core/ContextRecorder.js.map +1 -1
  201. package/dist/recorders/core/types.js.map +1 -1
  202. package/dist/recorders/observability/RouteRecorder.js +1 -1
  203. package/dist/recorders/observability/ToolChoiceRecorder.js +1 -1
  204. package/dist/reliability/index.js +15 -3
  205. package/dist/reliability/index.js.map +1 -1
  206. package/dist/resilience/fallbackProvider.js +1 -1
  207. package/dist/resilience/withCircuitBreaker.js +1 -1
  208. package/dist/resilience/withRetry.js +1 -1
  209. package/dist/security/PermissionPolicy.js +2 -2
  210. package/dist/security/index.js +3 -3
  211. package/dist/status.js +14 -24
  212. package/dist/status.js.map +1 -1
  213. package/dist/strategies/index.js +9 -16
  214. package/dist/strategies/index.js.map +1 -1
  215. package/dist/strategies/registry.js +1 -1
  216. package/dist/stream.js +4 -4
  217. package/dist/thinking/index.js +5 -5
  218. package/dist/tool-providers/index.js +4 -4
  219. package/dist/types/adapters/hosting/agentcore.d.ts +1 -1
  220. package/dist/types/adapters/identity/agentcore.d.ts +1 -1
  221. package/dist/types/adapters/llm/AnthropicProvider.d.ts +1 -1
  222. package/dist/types/adapters/llm/BrowserOpenAIProvider.d.ts +1 -1
  223. package/dist/types/adapters/llm/MockProvider.d.ts +1 -1
  224. package/dist/types/adapters/llm/OpenAIProvider.d.ts +2 -2
  225. package/dist/types/adapters/memory/agentcore.d.ts +1 -1
  226. package/dist/types/adapters/memory/bedrockAgentMemory.d.ts +1 -1
  227. package/dist/types/adapters/memory/redis.d.ts +1 -1
  228. package/dist/types/adapters/observability/agentcore.d.ts +2 -2
  229. package/dist/types/adapters/observability/audit.d.ts +1 -1
  230. package/dist/types/adapters/observability/cloudwatch.d.ts +2 -2
  231. package/dist/types/adapters/observability/otel.d.ts +4 -4
  232. package/dist/types/adapters/observability/xray.d.ts +2 -2
  233. package/dist/types/core/agent/AgentBuilder.d.ts +17 -14
  234. package/dist/types/core/agent/AgentBuilder.d.ts.map +1 -1
  235. package/dist/types/core/agent/stages/window.d.ts.map +1 -1
  236. package/dist/types/core/agent/types.d.ts +2 -2
  237. package/dist/types/core/agent/watch.d.ts +1 -1
  238. package/dist/types/core/agent/window/index.d.ts +1 -1
  239. package/dist/types/core/agent/window/index.d.ts.map +1 -1
  240. package/dist/types/core/agent/window/strategies/summarizeOldest.d.ts.map +1 -1
  241. package/dist/types/core/agent/window/types.d.ts +0 -30
  242. package/dist/types/core/agent/window/types.d.ts.map +1 -1
  243. package/dist/types/core/runner.d.ts +1 -1
  244. package/dist/types/core/slots/helpers.d.ts +3 -4
  245. package/dist/types/core/slots/helpers.d.ts.map +1 -1
  246. package/dist/types/debug/finders.d.ts +7 -10
  247. package/dist/types/debug/finders.d.ts.map +1 -1
  248. package/dist/types/debug.d.ts +4 -4
  249. package/dist/types/doors/context.d.ts +3 -3
  250. package/dist/types/embedders/index.d.ts +4 -4
  251. package/dist/types/events/payloads.d.ts +10 -14
  252. package/dist/types/events/payloads.d.ts.map +1 -1
  253. package/dist/types/hosting-providers.d.ts +16 -16
  254. package/dist/types/identity/types.d.ts +1 -1
  255. package/dist/types/identity/withCredentialRetry.d.ts +1 -1
  256. package/dist/types/identity.d.ts +5 -5
  257. package/dist/types/index.d.ts +1 -1
  258. package/dist/types/index.d.ts.map +1 -1
  259. package/dist/types/injection-engine.d.ts +4 -4
  260. package/dist/types/lib/context-ledger/gates.d.ts +1 -1
  261. package/dist/types/lib/injection-engine/SkillRegistry.d.ts +1 -1
  262. package/dist/types/lib/injection-engine/factories/defineSkill.d.ts +1 -16
  263. package/dist/types/lib/injection-engine/factories/defineSkill.d.ts.map +1 -1
  264. package/dist/types/lib/injection-engine/skillsFromDir.d.ts +1 -11
  265. package/dist/types/lib/injection-engine/skillsFromDir.d.ts.map +1 -1
  266. package/dist/types/lib/injection-engine/types.d.ts +1 -1
  267. package/dist/types/lib/mcp/gatewayTransport.d.ts +2 -2
  268. package/dist/types/lib/recorded-chat/index.d.ts +1 -1
  269. package/dist/types/llm-providers.d.ts +5 -19
  270. package/dist/types/llm-providers.d.ts.map +1 -1
  271. package/dist/types/locales/index.d.ts +7 -7
  272. package/dist/types/memory/causal/evidenceRecorder.d.ts +1 -1
  273. package/dist/types/memory/define.types.d.ts +3 -2
  274. package/dist/types/memory/define.types.d.ts.map +1 -1
  275. package/dist/types/memory/index.d.ts +0 -10
  276. package/dist/types/memory/index.d.ts.map +1 -1
  277. package/dist/types/memory-providers.d.ts +8 -24
  278. package/dist/types/memory-providers.d.ts.map +1 -1
  279. package/dist/types/observability/contextError/finders/index.d.ts +4 -4
  280. package/dist/types/observability-providers.d.ts +5 -5
  281. package/dist/types/providers.d.ts +2 -2
  282. package/dist/types/recorders/core/ContextRecorder.d.ts.map +1 -1
  283. package/dist/types/recorders/core/types.d.ts +16 -18
  284. package/dist/types/recorders/core/types.d.ts.map +1 -1
  285. package/dist/types/recorders/observability/RouteRecorder.d.ts +1 -1
  286. package/dist/types/recorders/observability/ToolChoiceRecorder.d.ts +1 -1
  287. package/dist/types/reliability/index.d.ts +15 -3
  288. package/dist/types/reliability/index.d.ts.map +1 -1
  289. package/dist/types/resilience/fallbackProvider.d.ts +1 -1
  290. package/dist/types/resilience/withCircuitBreaker.d.ts +1 -1
  291. package/dist/types/resilience/withRetry.d.ts +1 -1
  292. package/dist/types/security/PermissionPolicy.d.ts +2 -2
  293. package/dist/types/security/index.d.ts +3 -3
  294. package/dist/types/status.d.ts +14 -24
  295. package/dist/types/status.d.ts.map +1 -1
  296. package/dist/types/strategies/index.d.ts +9 -16
  297. package/dist/types/strategies/index.d.ts.map +1 -1
  298. package/dist/types/strategies/registry.d.ts +1 -1
  299. package/dist/types/stream.d.ts +4 -4
  300. package/dist/types/thinking/index.d.ts +5 -5
  301. package/dist/types/tool-providers/index.d.ts +4 -4
  302. package/package.json +1 -209
package/dist/esm/debug.js CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * agentfootprint/debug — diagnosis tools for a BROKEN run.
2
+ * debug — diagnosis tools for a BROKEN run.
3
3
  *
4
4
  * Where `agentfootprint/observe` watches a HEALTHY run (recorders), this
5
5
  * subpath is the autopsy kit for a wrong answer. Split out of `observe` in
@@ -17,9 +17,9 @@
17
17
  * For backward compatibility these are ALSO re-exported (deprecated) from
18
18
  * `agentfootprint/observe` for one transition version.
19
19
  *
20
- * @deprecated Since 8.0.0 — import from `agentfootprint/observe` instead.
21
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
22
- * here is the same symbol on the new door, not a copy.
20
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
21
+ * behind `agentfootprint/observe`, which re-exports every name here — same
22
+ * symbols, one door. Import from the door.
23
23
  */
24
24
  // influence-core — the ONE embedding-based scoring engine (RFC-002/003
25
25
  // block D6). Not a recorder: pure, embedder-injected scoring functions
@@ -5,9 +5,9 @@
5
5
  * one, and the engine subflow that resolves them into the three slots a
6
6
  * request is made of (system prompt, messages, tools).
7
7
  *
8
- * Named for the job rather than the machine — this was
9
- * `agentfootprint/injection-engine`, which described our implementation
10
- * instead of your task.
8
+ * Named for the job rather than the machine — through 8.x this was also
9
+ * reachable at `agentfootprint/injection-engine`, which described our
10
+ * implementation instead of your task. That path was removed in 9.0.0.
11
11
  *
12
12
  * @example
13
13
  * ```ts
@@ -5,9 +5,9 @@
5
5
  * one, and the engine subflow that resolves them into the three slots a
6
6
  * request is made of (system prompt, messages, tools).
7
7
  *
8
- * Named for the job rather than the machine — this was
9
- * `agentfootprint/injection-engine`, which described our implementation
10
- * instead of your task.
8
+ * Named for the job rather than the machine — through 8.x this was also
9
+ * reachable at `agentfootprint/injection-engine`, which described our
10
+ * implementation instead of your task. That path was removed in 9.0.0.
11
11
  *
12
12
  * @example
13
13
  * ```ts
@@ -1,5 +1,5 @@
1
1
  /**
2
- * agentfootprint/embedders — ready-made {@link Embedder} implementations for the
2
+ * embedders — ready-made {@link Embedder} implementations for the
3
3
  * embedding-backed scorers (memory retrieval, toolChoiceRecorder / scoreMargin).
4
4
  *
5
5
  * The core deliberately ships only `mockEmbedder` (bring-your-own). These are
@@ -36,9 +36,9 @@
36
36
  * AgentCoreStore): the library states the surface it needs, the host owns the
37
37
  * construction. Nothing changes for Node callers who pass nothing.
38
38
  *
39
- * @deprecated Since 8.0.0 — import from `agentfootprint/providers` instead.
40
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
41
- * here is the same symbol on the new door, not a copy.
39
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
40
+ * behind `agentfootprint/providers`, which re-exports every name here — same
41
+ * symbols, one door. Import from the door.
42
42
  */
43
43
  export type { Embedder } from '../memory/embedding/types.js';
44
44
  import type { Embedder } from '../memory/embedding/types.js';
@@ -248,18 +248,6 @@ export interface ContextSlotComposedPayload {
248
248
  */
249
249
  export interface ContextBudgetPressurePayload {
250
250
  readonly slot: ContextSlot;
251
- /**
252
- * @deprecated Misnamed since the event shipped: this is CHARS on the slot
253
- * channel and TOKENS on the window channel. Read {@link cap} with
254
- * {@link unit}. Still written, with the identical value, and not going
255
- * away in 8.x.
256
- */
257
- readonly capTokens: number;
258
- /**
259
- * @deprecated Misnamed — see {@link capTokens}. Read {@link projected} with
260
- * {@link unit}. Still written, with the identical value.
261
- */
262
- readonly projectedTokens: number;
263
251
  /** How far over the cap, in {@link unit}. Never carried a unit in its name. */
264
252
  readonly overflowBy: number;
265
253
  readonly planAction: 'evict' | 'summarize' | 'abort' | 'none';
@@ -270,9 +258,17 @@ export interface ContextBudgetPressurePayload {
270
258
  * anything.
271
259
  */
272
260
  readonly unit: 'chars' | 'tokens';
273
- /** The budget that was exceeded, in {@link unit}. Same value as `capTokens`. */
261
+ /**
262
+ * The budget that was exceeded, in {@link unit}.
263
+ *
264
+ * Called `capTokens` until 9.0.0 — a name that asserted tokens on a channel
265
+ * that is CHARS half the time, since `contextBudget` is on by default and a
266
+ * slot counts `String.length`. Both spellings shipped through 8.x with the
267
+ * identical value; 9.0.0 keeps only this one.
268
+ */
274
269
  readonly cap: number;
275
- /** What was measured, in {@link unit}. Same value as `projectedTokens`. */
270
+ /** What was measured, in {@link unit}. Called `projectedTokens` until 9.0.0
271
+ * — see {@link cap}. */
276
272
  readonly projected: number;
277
273
  }
278
274
  /**
@@ -1,19 +1,19 @@
1
1
  /**
2
- * agentfootprint/hosting-providers — adapters for the two hosting ports.
2
+ * hosting-providers — adapters for the two hosting ports.
3
3
  *
4
- * agentfootprint/hosting ← the PORTS (`AgentHost`, `SessionLifecycle`),
5
- * the composer, and the local adapters
6
- * agentfootprint/hosting-providers ← adapters for somewhere you deploy (this file)
4
+ * src/hosting/ ← the PORTS (`AgentHost`, `SessionLifecycle`), the
5
+ * composer, and the local adapters
6
+ * src/hosting-providers.ts ← adapters for somewhere you deploy (this file)
7
7
  *
8
- * Same split as `agentfootprint/memory` ↔ `agentfootprint/memory-providers`, and
9
- * for the same reason. `agentfootprint/hosting` promises that not one field,
10
- * name or assumption in it comes from any cloud, and a test greps its sources
11
- * for vendor names to keep that honest — including the barrel. So the cloud
12
- * adapters get their own subpath, and the port subpath stays a file you can
13
- * read without learning anybody's product names.
8
+ * The split is a source-tree split, not an import split: both halves come out
9
+ * of the one `agentfootprint/hosting` door. It exists because the PORT files
10
+ * promise that not one field, name or assumption in them comes from any cloud,
11
+ * and a test greps those sources for vendor names to keep that honest. So the
12
+ * cloud adapters live in this file, and the port files stay readable without
13
+ * learning anybody's product names.
14
14
  *
15
- * One subpath that grows: an adapter for the next runtime lands here beside
16
- * this one rather than minting `agentfootprint/hosting-<vendor>`.
15
+ * One file that grows: an adapter for the next runtime lands here beside this
16
+ * one.
17
17
  *
18
18
  * ── What ships here ──────────────────────────────────────────────────────────
19
19
  * • `agentCoreRuntimeHost({ port?, hostname?, busy? })` — an `AgentHost` for
@@ -42,7 +42,7 @@
42
42
  *
43
43
  * @example An agent in an AgentCore Runtime container
44
44
  * import { standingAgent } from 'agentfootprint/hosting';
45
- * import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting-providers';
45
+ * import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting';
46
46
  *
47
47
  * const handle = await standingAgent({
48
48
  * agent,
@@ -51,9 +51,9 @@
51
51
  * });
52
52
  * process.on('SIGTERM', () => void handle.close());
53
53
  *
54
- * @deprecated Since 8.0.0 — import from `agentfootprint/hosting` instead.
55
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
56
- * here is the same symbol on the new door, not a copy.
54
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
55
+ * behind `agentfootprint/hosting`, which re-exports every name here — same
56
+ * symbols, one door. Import from the door.
57
57
  */
58
58
  export { agentCoreRuntimeHost, agentCoreRuntimeWire, readAgentCoreConversation, agentCoreSessions, DEFAULT_SESSION_STORAGE_PATH, } from './adapters/hosting/agentcore.js';
59
59
  export type { AgentCoreRuntimeHostOptions, AgentCoreSessionsOptions, AgentCoreSessionStore, AgentCoreFileSessionsOptions, AgentCoreMemorySessionsOptions, AgentCoreSessionClientLike, AgentCoreSessionEvent, BedrockAgentCoreSessionSdkModule, } from './adapters/hosting/agentcore.js';
@@ -1,19 +1,19 @@
1
1
  /**
2
- * agentfootprint/hosting-providers — adapters for the two hosting ports.
2
+ * hosting-providers — adapters for the two hosting ports.
3
3
  *
4
- * agentfootprint/hosting ← the PORTS (`AgentHost`, `SessionLifecycle`),
5
- * the composer, and the local adapters
6
- * agentfootprint/hosting-providers ← adapters for somewhere you deploy (this file)
4
+ * src/hosting/ ← the PORTS (`AgentHost`, `SessionLifecycle`), the
5
+ * composer, and the local adapters
6
+ * src/hosting-providers.ts ← adapters for somewhere you deploy (this file)
7
7
  *
8
- * Same split as `agentfootprint/memory` ↔ `agentfootprint/memory-providers`, and
9
- * for the same reason. `agentfootprint/hosting` promises that not one field,
10
- * name or assumption in it comes from any cloud, and a test greps its sources
11
- * for vendor names to keep that honest — including the barrel. So the cloud
12
- * adapters get their own subpath, and the port subpath stays a file you can
13
- * read without learning anybody's product names.
8
+ * The split is a source-tree split, not an import split: both halves come out
9
+ * of the one `agentfootprint/hosting` door. It exists because the PORT files
10
+ * promise that not one field, name or assumption in them comes from any cloud,
11
+ * and a test greps those sources for vendor names to keep that honest. So the
12
+ * cloud adapters live in this file, and the port files stay readable without
13
+ * learning anybody's product names.
14
14
  *
15
- * One subpath that grows: an adapter for the next runtime lands here beside
16
- * this one rather than minting `agentfootprint/hosting-<vendor>`.
15
+ * One file that grows: an adapter for the next runtime lands here beside this
16
+ * one.
17
17
  *
18
18
  * ── What ships here ──────────────────────────────────────────────────────────
19
19
  * • `agentCoreRuntimeHost({ port?, hostname?, busy? })` — an `AgentHost` for
@@ -42,7 +42,7 @@
42
42
  *
43
43
  * @example An agent in an AgentCore Runtime container
44
44
  * import { standingAgent } from 'agentfootprint/hosting';
45
- * import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting-providers';
45
+ * import { agentCoreRuntimeHost, agentCoreSessions } from 'agentfootprint/hosting';
46
46
  *
47
47
  * const handle = await standingAgent({
48
48
  * agent,
@@ -51,9 +51,9 @@
51
51
  * });
52
52
  * process.on('SIGTERM', () => void handle.close());
53
53
  *
54
- * @deprecated Since 8.0.0 — import from `agentfootprint/hosting` instead.
55
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
56
- * here is the same symbol on the new door, not a copy.
54
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
55
+ * behind `agentfootprint/hosting`, which re-exports every name here — same
56
+ * symbols, one door. Import from the door.
57
57
  */
58
58
  export { agentCoreRuntimeHost, agentCoreRuntimeWire, readAgentCoreConversation, agentCoreSessions, DEFAULT_SESSION_STORAGE_PATH, } from './adapters/hosting/agentcore.js';
59
59
  //# sourceMappingURL=hosting-providers.js.map
@@ -1,5 +1,5 @@
1
1
  /**
2
- * agentfootprint/identity — the CredentialProvider port.
2
+ * identity — the CredentialProvider port.
3
3
  *
4
4
  * OUTBOUND auth: vend a credential/token so a tool can call a downstream service
5
5
  * (GitHub, Slack, Google…) on behalf of the agent or the end user. This is
@@ -1,5 +1,5 @@
1
1
  /**
2
- * agentfootprint/identity — the CredentialProvider port.
2
+ * identity — the CredentialProvider port.
3
3
  *
4
4
  * OUTBOUND auth: vend a credential/token so a tool can call a downstream service
5
5
  * (GitHub, Slack, Google…) on behalf of the agent or the end user. This is
@@ -37,7 +37,7 @@
37
37
  * No new event types.
38
38
  *
39
39
  * @example
40
- * import { agentCoreIdentity, withCredentialRetry } from 'agentfootprint/identity';
40
+ * import { agentCoreIdentity, withCredentialRetry } from 'agentfootprint/security';
41
41
  *
42
42
  * const credentials = withCredentialRetry(agentCoreIdentity({ region: 'us-east-1' }), {
43
43
  * maxAttempts: 3,
@@ -37,7 +37,7 @@
37
37
  * No new event types.
38
38
  *
39
39
  * @example
40
- * import { agentCoreIdentity, withCredentialRetry } from 'agentfootprint/identity';
40
+ * import { agentCoreIdentity, withCredentialRetry } from 'agentfootprint/security';
41
41
  *
42
42
  * const credentials = withCredentialRetry(agentCoreIdentity({ region: 'us-east-1' }), {
43
43
  * maxAttempts: 3,
@@ -1,5 +1,5 @@
1
1
  /**
2
- * agentfootprint/identity — outbound credential vending for agent tools.
2
+ * identity — outbound credential vending for agent tools.
3
3
  *
4
4
  * The {@link CredentialProvider} port + adapters. A tool calls
5
5
  * `provider.getCredential({ service })` to get a token for a downstream service;
@@ -12,7 +12,7 @@
12
12
  *
13
13
  * @example
14
14
  * ```ts
15
- * import { agentCoreIdentity } from 'agentfootprint/identity';
15
+ * import { agentCoreIdentity } from 'agentfootprint/security';
16
16
  *
17
17
  * const credentials = agentCoreIdentity({ region: 'us-east-1' });
18
18
  * const r = await credentials.getCredential({ service: 'github', mode: 'user', scopes: ['repo'] });
@@ -23,9 +23,9 @@
23
23
  * }
24
24
  * ```
25
25
  *
26
- * @deprecated Since 8.0.0 — import from `agentfootprint/security` instead.
27
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
28
- * here is the same symbol on the new door, not a copy.
26
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
27
+ * behind `agentfootprint/security`, which re-exports every name here — same
28
+ * symbols, one door. Import from the door.
29
29
  */
30
30
  export type { Credential, CredentialProvider, CredentialRequest, CredentialResult, CredentialIssued, CredentialAuthorizationRequired, CredentialNeed, } from './identity/types.js';
31
31
  export { isCredentialIssued, unconfiguredCredentialProvider } from './identity/types.js';
@@ -1,5 +1,5 @@
1
1
  /**
2
- * agentfootprint/identity — outbound credential vending for agent tools.
2
+ * identity — outbound credential vending for agent tools.
3
3
  *
4
4
  * The {@link CredentialProvider} port + adapters. A tool calls
5
5
  * `provider.getCredential({ service })` to get a token for a downstream service;
@@ -12,7 +12,7 @@
12
12
  *
13
13
  * @example
14
14
  * ```ts
15
- * import { agentCoreIdentity } from 'agentfootprint/identity';
15
+ * import { agentCoreIdentity } from 'agentfootprint/security';
16
16
  *
17
17
  * const credentials = agentCoreIdentity({ region: 'us-east-1' });
18
18
  * const r = await credentials.getCredential({ service: 'github', mode: 'user', scopes: ['repo'] });
@@ -23,9 +23,9 @@
23
23
  * }
24
24
  * ```
25
25
  *
26
- * @deprecated Since 8.0.0 — import from `agentfootprint/security` instead.
27
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
28
- * here is the same symbol on the new door, not a copy.
26
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
27
+ * behind `agentfootprint/security`, which re-exports every name here — same
28
+ * symbols, one door. Import from the door.
29
29
  */
30
30
  export { isCredentialIssued, unconfiguredCredentialProvider } from './identity/types.js';
31
31
  export { bearer, apiKey, basic, headers, } from './identity/kinds.js';
@@ -32,7 +32,7 @@ export { LLMCall, LLMCallBuilder, type LLMCallInput, type LLMCallOptions, type L
32
32
  export { type MessageApiChartDeps } from './core/agent/buildMessageApiChart.js';
33
33
  export { buildAgentMessageApiChart, type AgentMessageApiChartDeps, } from './core/agent/buildAgentMessageApiChart.js';
34
34
  export { Agent, AgentBuilder, type AgentInput, type AgentOptions, type AgentOutput, type ObserverDeliveryOptions, } from './core/Agent.js';
35
- export { CompactionUnmeasurableError, COMPACTED_FRAME_PREFIX, DROP_NOTICE_PREFIX, foldedMessages, foldedSpanFor, isCompactedSummary, isDropNotice, slidingWindow, summarizeOldest, tokenBudget, type CompactionOptions, type CompactionRecord, type CompactionRetention, type FoldedConversation, type FoldedSpan, type FoldRefusal, type FoldRefusalReason, type RemovalFacts, type RemovalPlan, type SlidingWindowOptions, type SlidingWindowRecord, type TokenBudgetOptions, type TokenBudgetRecord, type Turn, type WindowEviction, type WindowRecord, type WindowRefusal, type WindowRefusalReason, type WindowStrategy, type WindowStrategyInput, type WindowStrategyResult, } from './core/agent/window/index.js';
35
+ export { CompactionUnmeasurableError, COMPACTED_FRAME_PREFIX, DROP_NOTICE_PREFIX, foldedMessages, foldedSpanFor, isCompactedSummary, isDropNotice, slidingWindow, summarizeOldest, tokenBudget, type CompactionOptions, type CompactionRecord, type CompactionRetention, type FoldedConversation, type FoldedSpan, type RemovalFacts, type RemovalPlan, type SlidingWindowOptions, type SlidingWindowRecord, type TokenBudgetOptions, type TokenBudgetRecord, type Turn, type WindowEviction, type WindowRecord, type WindowRefusal, type WindowRefusalReason, type WindowStrategy, type WindowStrategyInput, type WindowStrategyResult, } from './core/agent/window/index.js';
36
36
  export type { SelfExplainInclude, SelfExplainOptions } from './lib/trace-toolpack/selfExplain.js';
37
37
  export type { ObserverDrainResult, ObserverStats } from 'footprintjs';
38
38
  export type { ToolArgValidationMode } from './core/agent/toolArgsValidation.js';
package/dist/esm/index.js CHANGED
@@ -166,14 +166,14 @@ export { graph, Graph, } from './core-flow/Graph.js';
166
166
  // because bundlers walking these never touch optional peer-dep code.
167
167
  //
168
168
  // Vendor-SDK-backed providers (AnthropicProvider, OpenAIProvider,
169
- // BedrockProvider) live ONLY at `agentfootprint/llm-providers`. That
169
+ // BedrockProvider) live ONLY at `agentfootprint/providers`. That
170
170
  // subpath segregation means bundlers walking from `agentfootprint` main
171
171
  // never see the lazy peer-dep requires for `@anthropic-ai/sdk`,
172
172
  // `openai`, `@aws-sdk/client-bedrock-runtime`, etc. — automatic
173
173
  // tree-shaking, no bundler-side workarounds.
174
174
  //
175
175
  // import { AnthropicProvider } from 'agentfootprint'; // ❌ not exported
176
- // import { AnthropicProvider } from 'agentfootprint/llm-providers'; // ✓ canonical
176
+ // import { AnthropicProvider } from 'agentfootprint/providers'; // ✓ canonical
177
177
  export { providerFromEnv, } from './adapters/llm/createProvider.js';
178
178
  // Streaming helpers — agent events → SSE for browser delivery.
179
179
  // Injection Engine — the unifying primitive of context engineering.
@@ -199,7 +199,7 @@ export { topK, } from './memory/retrieval/index.js';
199
199
  // which connect to a Model Context Protocol server and expose its tools
200
200
  // as agentfootprint `Tool[]` for `agent.tools(...)` — and the dispatch
201
201
  // primitives `staticTools` / `gatedTools` / `skillScopedTools` live
202
- // ONLY under `agentfootprint/tool-providers`: one subpath for
202
+ // ONLY under `agentfootprint/providers`: one subpath for
203
203
  // everything tool-related, so the main barrel stays focused on the core
204
204
  // agent API. NONE of them are re-exported here.
205
205
  // `@modelcontextprotocol/sdk` stays a lazy-required peer-dep, so an app
@@ -207,7 +207,7 @@ export { topK, } from './memory/retrieval/index.js';
207
207
  // Cross-cutting authorization (v2.5+). `agentfootprint/security` is the
208
208
  // dedicated subpath; the root barrel also re-exports `PermissionPolicy`
209
209
  // so existing v2.4 consumers find it at the top level.
210
- // Message Catalog Pattern (v2.5+). `agentfootprint/locales` is the
210
+ // Message Catalog Pattern (v2.5+). `agentfootprint/observe` is the
211
211
  // dedicated subpath; the root barrel also re-exports the helpers so
212
212
  // existing v2.4 consumers find them at the top level.
213
213
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
@@ -1,8 +1,8 @@
1
1
  /**
2
- * agentfootprint/injection-engine — public re-export for the InjectionEngine subsystem.
2
+ * injection-engine — public re-export for the InjectionEngine subsystem.
3
3
  *
4
- * @deprecated Since 8.0.0 — import from `agentfootprint/context` instead.
5
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
6
- * here is the same symbol on the new door, not a copy.
4
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
5
+ * behind `agentfootprint/context`, which re-exports every name here — same
6
+ * symbols, one door. Import from the door.
7
7
  */
8
8
  export * from './lib/injection-engine/index.js';
@@ -1,9 +1,9 @@
1
1
  /**
2
- * agentfootprint/injection-engine — public re-export for the InjectionEngine subsystem.
2
+ * injection-engine — public re-export for the InjectionEngine subsystem.
3
3
  *
4
- * @deprecated Since 8.0.0 — import from `agentfootprint/context` instead.
5
- * This path keeps working for all of 8.x and is removed in 9.0.0. Every name
6
- * here is the same symbol on the new door, not a copy.
4
+ * Not an import path of its own since 9.0.0. This is the implementation barrel
5
+ * behind `agentfootprint/context`, which re-exports every name here — same
6
+ * symbols, one door. Import from the door.
7
7
  */
8
8
  export * from './lib/injection-engine/index.js';
9
9
  //# sourceMappingURL=injection-engine.js.map
@@ -36,7 +36,7 @@ export interface LedgerPolicy {
36
36
  * TOOL GATE — plug into the existing provider combinator:
37
37
  *
38
38
  * ```ts
39
- * import { gatedTools, staticTools } from 'agentfootprint/tool-providers';
39
+ * import { gatedTools, staticTools } from 'agentfootprint/providers';
40
40
  * builder.toolProvider(gatedTools(staticTools(tools), ledgerToolGate(ledger)));
41
41
  * ```
42
42
  *
@@ -40,7 +40,7 @@ function makeVerdict(ledger, policy) {
40
40
  * TOOL GATE — plug into the existing provider combinator:
41
41
  *
42
42
  * ```ts
43
- * import { gatedTools, staticTools } from 'agentfootprint/tool-providers';
43
+ * import { gatedTools, staticTools } from 'agentfootprint/providers';
44
44
  * builder.toolProvider(gatedTools(staticTools(tools), ledgerToolGate(ledger)));
45
45
  * ```
46
46
  *
@@ -111,7 +111,7 @@ export declare class SkillRegistry {
111
111
  * const { listSkills, readSkill } = registry.toTools();
112
112
  * const tools = [listSkills, readSkill, ...other].filter(Boolean) as Tool[];
113
113
  *
114
- * Composes with `gatedTools` from `agentfootprint/tool-providers`
114
+ * Composes with `gatedTools` from `agentfootprint/providers`
115
115
  * so PermissionPolicy can scope which roles see the skill discovery
116
116
  * surface.
117
117
  *
@@ -120,7 +120,7 @@ export class SkillRegistry {
120
120
  * const { listSkills, readSkill } = registry.toTools();
121
121
  * const tools = [listSkills, readSkill, ...other].filter(Boolean) as Tool[];
122
122
  *
123
- * Composes with `gatedTools` from `agentfootprint/tool-providers`
123
+ * Composes with `gatedTools` from `agentfootprint/providers`
124
124
  * so PermissionPolicy can scope which roles see the skill discovery
125
125
  * surface.
126
126
  *
@@ -107,21 +107,6 @@ export interface DefineSkillOptions {
107
107
  * every leaf. If a tool must never be offered before activation, that is not a
108
108
  * default — say so with `autoActivate`. */
109
109
  readonly tools?: readonly Tool[];
110
- /**
111
- * Override the activation tool name. Defaults to `'read_skill'`.
112
- * Multiple Skills sharing one activation tool is the common pattern;
113
- * the LLM picks WHICH skill via the tool's argument.
114
- *
115
- * @deprecated Since 8.7.0 — `'read_skill'` is the only value that has ever worked,
116
- * and anything else is now REFUSED when the skill is mounted on an agent. No tool is
117
- * built from this name: the evaluator activates an `llm-activated` skill by matching
118
- * `ctx.activatedInjectionIds`, which only `read_skill` writes, and it never reads
119
- * this field. A skill declaring another name activated through `read_skill` exactly
120
- * like every other skill, so the declaration described a door that does not exist.
121
- * Drop it — skills already share ONE activation tool and the model picks which skill
122
- * by id. Removed in 9.0.0.
123
- */
124
- readonly viaToolName?: string;
125
110
  /**
126
111
  * Where the body lands when activated. See `SurfaceMode`. Default
127
112
  * `'auto'`, which delivers like `'system-prompt'`; name a mode
@@ -144,7 +129,7 @@ export interface DefineSkillOptions {
144
129
  * static tool list and offered to the model only on iterations where
145
130
  * the Skill is active. Outside the Agent's own wiring, materialize the
146
131
  * same gate with `skillScopedTools(id, tools)` from
147
- * `agentfootprint/tool-providers`.
132
+ * `agentfootprint/providers`.
148
133
  * - `undefined` (default) — additive: this Skill's tools go into the
149
134
  * agent's registry at BUILD time and the model can see and call them
150
135
  * from iteration 1, activated or not.
@@ -58,6 +58,33 @@ export function resolveSurfaceMode(provider, model) {
58
58
  }
59
59
  return 'tool-only';
60
60
  }
61
+ /**
62
+ * Refuse a `viaToolName` option that no longer exists (9.0.0 grace error).
63
+ *
64
+ * The option was deprecated in 8.7.0 and removed here. `'read_skill'` is the
65
+ * only activation tool this library has ever built: the evaluator activates an
66
+ * `llm-activated` skill by matching `ctx.activatedInjectionIds`, only
67
+ * `read_skill` writes that array, and nothing ever read the field. 8.7.0 made
68
+ * a non-`read_skill` value a mount-time refusal; 9.0.0 deletes the option.
69
+ *
70
+ * Deleting a type member alone would have been a silent DOWNGRADE: an object
71
+ * literal gets an excess-property error, but an options bag arriving through a
72
+ * variable does not — and the value would then be ignored where 8.7.0 refused
73
+ * it. So the field is read at run time exactly once more, to say it is gone.
74
+ *
75
+ * Deleted in 10.0.0.
76
+ */
77
+ function assertNoViaToolName(where, opts) {
78
+ const legacy = opts.viaToolName;
79
+ if (legacy === undefined)
80
+ return;
81
+ throw new Error(`${where}: \`viaToolName\` was removed in 9.0.0 (deprecated since 8.7.0), and this call ` +
82
+ `passes '${String(legacy)}'. It never did anything: 'read_skill' is the only activation ` +
83
+ `tool this library builds, the evaluator matches on ctx.activatedInjectionIds — which ` +
84
+ `only read_skill writes — and no tool was ever created from this name. Drop the option: ` +
85
+ `skills already share ONE activation tool and the model picks WHICH skill by id. If you ` +
86
+ `need the skill gated on something else, use a \`rule\` trigger or a skillGraph() edge.`);
87
+ }
61
88
  export function defineSkill(opts) {
62
89
  if (!opts.id || opts.id.trim().length === 0) {
63
90
  throw new Error('defineSkill: `id` is required and must be non-empty.');
@@ -68,13 +95,14 @@ export function defineSkill(opts) {
68
95
  if (!opts.body || opts.body.length === 0) {
69
96
  throw new Error(`defineSkill(${opts.id}): \`body\` is required.`);
70
97
  }
98
+ assertNoViaToolName(`defineSkill(${opts.id})`, opts);
71
99
  return Object.freeze({
72
100
  id: opts.id,
73
101
  description: opts.description,
74
102
  flavor: 'skill',
75
103
  trigger: {
76
104
  kind: 'llm-activated',
77
- viaToolName: opts.viaToolName ?? 'read_skill',
105
+ viaToolName: 'read_skill',
78
106
  },
79
107
  inject: {
80
108
  systemPrompt: opts.body,
@@ -1 +1 @@
1
- {"version":3,"file":"defineSkill.js","sourceRoot":"","sources":["../../../../../src/lib/injection-engine/factories/defineSkill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAuJxE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,KAAc;IACjE,MAAM,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;QACtB,2CAA2C;QAC3C,4CAA4C;QAC5C,+EAA+E;QAC/E,gFAAgF;QAChF,IAAI,KAAK,IAAI,iEAAiE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3F,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAwB;IAClD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,CAAC,EAAE,0EAA0E,CACjG,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,EAAE,0BAA0B,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,OAAgB;QACxB,OAAO,EAAE;YACP,IAAI,EAAE,eAAwB;YAC9B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,YAAY;SAC9C;QACD,MAAM,EAAE;YACN,YAAY,EAAE,IAAI,CAAC,IAAI;YACvB,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;SAClE;QACD,iEAAiE;QACjE,sEAAsE;QACtE,uEAAuE;QACvE,sEAAsE;QACtE,iBAAiB;QACjB,EAAE;QACF,qDAAqD;QACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,MAAM;YACvC,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;YAC7D,KAAK,EAAE,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;SAC/C,CAAC;KACH,CAAyB,CAAC;AAC7B,CAAC"}
1
+ {"version":3,"file":"defineSkill.js","sourceRoot":"","sources":["../../../../../src/lib/injection-engine/factories/defineSkill.ts"],"names":[],"mappings":"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"}
@@ -59,22 +59,12 @@
59
59
  *
60
60
  * Node-only. `node:fs/promises` and `node:path` are imported lazily inside the
61
61
  * call, the same gating `lib/tool-lint/cli.ts` uses: this module is reachable
62
- * from the `agentfootprint/injection-engine` barrel, and a TOP-LEVEL node:fs
62
+ * from the `agentfootprint/context` barrel, and a TOP-LEVEL node:fs
63
63
  * import detonates a browser bundle at module-eval even when nothing calls it.
64
64
  */
65
65
  import type { Injection } from './types.js';
66
66
  import { type SurfaceMode } from './factories/defineSkill.js';
67
67
  export interface SkillsFromDirOptions {
68
- /**
69
- * Override the activation tool name for every loaded skill. Defaults to
70
- * `defineSkill`'s own default, `'read_skill'`.
71
- *
72
- * @deprecated Since 8.7.0 — see {@link DefineSkillOptions.viaToolName}. Nothing has
73
- * ever read the field, and mounting a skill that carries another value is now
74
- * refused, so a directory loaded with this option produces skills no agent will
75
- * accept. Removed in 9.0.0.
76
- */
77
- readonly viaToolName?: string;
78
68
  /**
79
69
  * Where a loaded skill's body lands once activated. Defaults to
80
70
  * `defineSkill`'s own default, `'auto'`. See {@link SurfaceMode}.