agentfootprint 3.0.0 → 3.1.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 (180) hide show
  1. package/README.md +1 -1
  2. package/dist/cache/CacheDecisionSubflow.js +13 -18
  3. package/dist/cache/CacheDecisionSubflow.js.map +1 -1
  4. package/dist/cache/CacheGateDecider.js +18 -3
  5. package/dist/cache/CacheGateDecider.js.map +1 -1
  6. package/dist/cache/cacheRecorder.js +12 -3
  7. package/dist/cache/cacheRecorder.js.map +1 -1
  8. package/dist/conventions.js +152 -2
  9. package/dist/conventions.js.map +1 -1
  10. package/dist/core/Agent.js +46 -9
  11. package/dist/core/Agent.js.map +1 -1
  12. package/dist/core/LLMCall.js +177 -44
  13. package/dist/core/LLMCall.js.map +1 -1
  14. package/dist/core/RunnerBase.js +14 -0
  15. package/dist/core/RunnerBase.js.map +1 -1
  16. package/dist/core/agent/buildAgentChart.js +117 -48
  17. package/dist/core/agent/buildAgentChart.js.map +1 -1
  18. package/dist/core/agent/buildAgentMessageApiChart.js +201 -0
  19. package/dist/core/agent/buildAgentMessageApiChart.js.map +1 -0
  20. package/dist/core/agent/buildCacheSubflow.js +62 -0
  21. package/dist/core/agent/buildCacheSubflow.js.map +1 -0
  22. package/dist/core/agent/buildDynamicAgentChart.js +364 -0
  23. package/dist/core/agent/buildDynamicAgentChart.js.map +1 -0
  24. package/dist/core/agent/buildMessageApiChart.js +154 -0
  25. package/dist/core/agent/buildMessageApiChart.js.map +1 -0
  26. package/dist/core/agent/stages/callLLM.js +11 -0
  27. package/dist/core/agent/stages/callLLM.js.map +1 -1
  28. package/dist/core/agent/stages/reliabilityExecution.js +64 -9
  29. package/dist/core/agent/stages/reliabilityExecution.js.map +1 -1
  30. package/dist/core/humanizeLLMError.js +66 -0
  31. package/dist/core/humanizeLLMError.js.map +1 -0
  32. package/dist/core/slots/buildMessagesSlot.js +1 -1
  33. package/dist/core/slots/buildMessagesSlot.js.map +1 -1
  34. package/dist/core/slots/buildToolsSlot.js.map +1 -1
  35. package/dist/core-flow/Conditional.js +1 -1
  36. package/dist/core-flow/Conditional.js.map +1 -1
  37. package/dist/core-flow/Loop.js +1 -1
  38. package/dist/core-flow/Loop.js.map +1 -1
  39. package/dist/core-flow/Parallel.js +1 -1
  40. package/dist/core-flow/Parallel.js.map +1 -1
  41. package/dist/esm/cache/CacheDecisionSubflow.js +11 -17
  42. package/dist/esm/cache/CacheDecisionSubflow.js.map +1 -1
  43. package/dist/esm/cache/CacheGateDecider.js +18 -3
  44. package/dist/esm/cache/CacheGateDecider.js.map +1 -1
  45. package/dist/esm/cache/cacheRecorder.js +12 -3
  46. package/dist/esm/cache/cacheRecorder.js.map +1 -1
  47. package/dist/esm/conventions.js +148 -1
  48. package/dist/esm/conventions.js.map +1 -1
  49. package/dist/esm/core/Agent.js +47 -10
  50. package/dist/esm/core/Agent.js.map +1 -1
  51. package/dist/esm/core/LLMCall.js +177 -44
  52. package/dist/esm/core/LLMCall.js.map +1 -1
  53. package/dist/esm/core/RunnerBase.js +14 -0
  54. package/dist/esm/core/RunnerBase.js.map +1 -1
  55. package/dist/esm/core/agent/buildAgentChart.js +118 -49
  56. package/dist/esm/core/agent/buildAgentChart.js.map +1 -1
  57. package/dist/esm/core/agent/buildAgentMessageApiChart.js +197 -0
  58. package/dist/esm/core/agent/buildAgentMessageApiChart.js.map +1 -0
  59. package/dist/esm/core/agent/buildCacheSubflow.js +58 -0
  60. package/dist/esm/core/agent/buildCacheSubflow.js.map +1 -0
  61. package/dist/esm/core/agent/buildDynamicAgentChart.js +360 -0
  62. package/dist/esm/core/agent/buildDynamicAgentChart.js.map +1 -0
  63. package/dist/esm/core/agent/buildMessageApiChart.js +150 -0
  64. package/dist/esm/core/agent/buildMessageApiChart.js.map +1 -0
  65. package/dist/esm/core/agent/stages/callLLM.js +11 -0
  66. package/dist/esm/core/agent/stages/callLLM.js.map +1 -1
  67. package/dist/esm/core/agent/stages/reliabilityExecution.js +64 -9
  68. package/dist/esm/core/agent/stages/reliabilityExecution.js.map +1 -1
  69. package/dist/esm/core/humanizeLLMError.js +61 -0
  70. package/dist/esm/core/humanizeLLMError.js.map +1 -0
  71. package/dist/esm/core/slots/buildMessagesSlot.js +1 -1
  72. package/dist/esm/core/slots/buildMessagesSlot.js.map +1 -1
  73. package/dist/esm/core/slots/buildToolsSlot.js.map +1 -1
  74. package/dist/esm/core-flow/Conditional.js +1 -1
  75. package/dist/esm/core-flow/Conditional.js.map +1 -1
  76. package/dist/esm/core-flow/Loop.js +1 -1
  77. package/dist/esm/core-flow/Loop.js.map +1 -1
  78. package/dist/esm/core-flow/Parallel.js +1 -1
  79. package/dist/esm/core-flow/Parallel.js.map +1 -1
  80. package/dist/esm/events/registry.js +10 -0
  81. package/dist/esm/events/registry.js.map +1 -1
  82. package/dist/esm/index.js +21 -1
  83. package/dist/esm/index.js.map +1 -1
  84. package/dist/esm/lib/injection-engine/buildInjectionEngineSubflow.js +15 -8
  85. package/dist/esm/lib/injection-engine/buildInjectionEngineSubflow.js.map +1 -1
  86. package/dist/esm/recorders/core/ContextEvaluatedRecorder.js +31 -0
  87. package/dist/esm/recorders/core/ContextEvaluatedRecorder.js.map +1 -0
  88. package/dist/esm/recorders/core/ContextRecorder.js +12 -14
  89. package/dist/esm/recorders/core/ContextRecorder.js.map +1 -1
  90. package/dist/esm/recorders/core/ErrorBridge.js +59 -0
  91. package/dist/esm/recorders/core/ErrorBridge.js.map +1 -0
  92. package/dist/esm/recorders/core/ReliabilityRecorder.js +29 -0
  93. package/dist/esm/recorders/core/ReliabilityRecorder.js.map +1 -0
  94. package/dist/esm/recorders/observability/BoundaryRecorder.js +23 -0
  95. package/dist/esm/recorders/observability/BoundaryRecorder.js.map +1 -1
  96. package/dist/esm/recorders/observability/LiveStateRecorder.js +8 -0
  97. package/dist/esm/recorders/observability/LiveStateRecorder.js.map +1 -1
  98. package/dist/esm/recorders/observability/commentary/commentaryTemplates.js +1 -0
  99. package/dist/esm/recorders/observability/commentary/commentaryTemplates.js.map +1 -1
  100. package/dist/esm/reliability/buildReliabilityGateChart.js +10 -4
  101. package/dist/esm/reliability/buildReliabilityGateChart.js.map +1 -1
  102. package/dist/events/registry.js +10 -0
  103. package/dist/events/registry.js.map +1 -1
  104. package/dist/index.js +26 -3
  105. package/dist/index.js.map +1 -1
  106. package/dist/lib/injection-engine/buildInjectionEngineSubflow.js +15 -8
  107. package/dist/lib/injection-engine/buildInjectionEngineSubflow.js.map +1 -1
  108. package/dist/recorders/core/ContextEvaluatedRecorder.js +35 -0
  109. package/dist/recorders/core/ContextEvaluatedRecorder.js.map +1 -0
  110. package/dist/recorders/core/ContextRecorder.js +11 -13
  111. package/dist/recorders/core/ContextRecorder.js.map +1 -1
  112. package/dist/recorders/core/ErrorBridge.js +64 -0
  113. package/dist/recorders/core/ErrorBridge.js.map +1 -0
  114. package/dist/recorders/core/ReliabilityRecorder.js +33 -0
  115. package/dist/recorders/core/ReliabilityRecorder.js.map +1 -0
  116. package/dist/recorders/observability/BoundaryRecorder.js +23 -0
  117. package/dist/recorders/observability/BoundaryRecorder.js.map +1 -1
  118. package/dist/recorders/observability/LiveStateRecorder.js +8 -0
  119. package/dist/recorders/observability/LiveStateRecorder.js.map +1 -1
  120. package/dist/recorders/observability/commentary/commentaryTemplates.js +1 -0
  121. package/dist/recorders/observability/commentary/commentaryTemplates.js.map +1 -1
  122. package/dist/reliability/buildReliabilityGateChart.js +10 -4
  123. package/dist/reliability/buildReliabilityGateChart.js.map +1 -1
  124. package/dist/types/cache/CacheDecisionSubflow.d.ts +7 -10
  125. package/dist/types/cache/CacheDecisionSubflow.d.ts.map +1 -1
  126. package/dist/types/cache/CacheGateDecider.d.ts +16 -2
  127. package/dist/types/cache/CacheGateDecider.d.ts.map +1 -1
  128. package/dist/types/cache/cacheRecorder.d.ts.map +1 -1
  129. package/dist/types/conventions.d.ts +101 -1
  130. package/dist/types/conventions.d.ts.map +1 -1
  131. package/dist/types/core/Agent.d.ts +8 -0
  132. package/dist/types/core/Agent.d.ts.map +1 -1
  133. package/dist/types/core/LLMCall.d.ts +48 -12
  134. package/dist/types/core/LLMCall.d.ts.map +1 -1
  135. package/dist/types/core/RunnerBase.d.ts +12 -0
  136. package/dist/types/core/RunnerBase.d.ts.map +1 -1
  137. package/dist/types/core/agent/buildAgentChart.d.ts +31 -18
  138. package/dist/types/core/agent/buildAgentChart.d.ts.map +1 -1
  139. package/dist/types/core/agent/buildAgentMessageApiChart.d.ts +41 -0
  140. package/dist/types/core/agent/buildAgentMessageApiChart.d.ts.map +1 -0
  141. package/dist/types/core/agent/buildCacheSubflow.d.ts +36 -0
  142. package/dist/types/core/agent/buildCacheSubflow.d.ts.map +1 -0
  143. package/dist/types/core/agent/buildDynamicAgentChart.d.ts +57 -0
  144. package/dist/types/core/agent/buildDynamicAgentChart.d.ts.map +1 -0
  145. package/dist/types/core/agent/buildMessageApiChart.d.ts +48 -0
  146. package/dist/types/core/agent/buildMessageApiChart.d.ts.map +1 -0
  147. package/dist/types/core/agent/stages/callLLM.d.ts.map +1 -1
  148. package/dist/types/core/agent/stages/reliabilityExecution.d.ts.map +1 -1
  149. package/dist/types/core/agent/types.d.ts +69 -2
  150. package/dist/types/core/agent/types.d.ts.map +1 -1
  151. package/dist/types/core/humanizeLLMError.d.ts +24 -0
  152. package/dist/types/core/humanizeLLMError.d.ts.map +1 -0
  153. package/dist/types/core/slots/buildMessagesSlot.d.ts.map +1 -1
  154. package/dist/types/events/payloads.d.ts +84 -0
  155. package/dist/types/events/payloads.d.ts.map +1 -1
  156. package/dist/types/events/registry.d.ts +11 -1
  157. package/dist/types/events/registry.d.ts.map +1 -1
  158. package/dist/types/index.d.ts +4 -1
  159. package/dist/types/index.d.ts.map +1 -1
  160. package/dist/types/lib/injection-engine/buildInjectionEngineSubflow.d.ts.map +1 -1
  161. package/dist/types/recorders/core/ContextEvaluatedRecorder.d.ts +24 -0
  162. package/dist/types/recorders/core/ContextEvaluatedRecorder.d.ts.map +1 -0
  163. package/dist/types/recorders/core/ContextRecorder.d.ts +0 -2
  164. package/dist/types/recorders/core/ContextRecorder.d.ts.map +1 -1
  165. package/dist/types/recorders/core/ErrorBridge.d.ts +39 -0
  166. package/dist/types/recorders/core/ErrorBridge.d.ts.map +1 -0
  167. package/dist/types/recorders/core/ReliabilityRecorder.d.ts +25 -0
  168. package/dist/types/recorders/core/ReliabilityRecorder.d.ts.map +1 -0
  169. package/dist/types/recorders/observability/BoundaryRecorder.d.ts +7 -0
  170. package/dist/types/recorders/observability/BoundaryRecorder.d.ts.map +1 -1
  171. package/dist/types/recorders/observability/LiveStateRecorder.d.ts.map +1 -1
  172. package/dist/types/recorders/observability/commentary/commentaryTemplates.d.ts.map +1 -1
  173. package/dist/types/reliability/buildReliabilityGateChart.d.ts.map +1 -1
  174. package/package.json +4 -3
  175. package/dist/core/agent/stages/iterationStart.js +0 -24
  176. package/dist/core/agent/stages/iterationStart.js.map +0 -1
  177. package/dist/esm/core/agent/stages/iterationStart.js +0 -20
  178. package/dist/esm/core/agent/stages/iterationStart.js.map +0 -1
  179. package/dist/types/core/agent/stages/iterationStart.d.ts +0 -16
  180. package/dist/types/core/agent/stages/iterationStart.d.ts.map +0 -1
package/dist/esm/core/agent/stages/iterationStart.js DELETED
@@ -1,20 +0,0 @@
1
- /**
2
- * iterationStart — per-iteration marker stage.
3
- *
4
- * Emits `agentfootprint.agent.iteration_start` so observability adapters
5
- * + recorders can bracket each ReAct iteration. Fires AFTER the slot
6
- * subflows (SystemPrompt, Messages, Tools, CacheDecision, CacheGate)
7
- * have produced this iteration's prompt assembly and BEFORE CallLLM.
8
- *
9
- * `turnIndex: 0` is intentional — the agent currently runs ONE turn per
10
- * `agent.run()`. The turn index is reserved for future multi-turn
11
- * orchestration; iteration index is the per-iteration counter.
12
- */
13
- import { typedEmit } from '../../../recorders/core/typedEmit.js';
14
- export const iterationStartStage = (scope) => {
15
- typedEmit(scope, 'agentfootprint.agent.iteration_start', {
16
- turnIndex: 0,
17
- iterIndex: scope.iteration,
18
- });
19
- };
20
- //# sourceMappingURL=iterationStart.js.map
package/dist/esm/core/agent/stages/iterationStart.js.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"iterationStart.js","sourceRoot":"","sources":["../../../../../src/core/agent/stages/iterationStart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAGjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAA6B,EAAQ,EAAE;IACzE,SAAS,CAAC,KAAK,EAAE,sCAAsC,EAAE;QACvD,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC,CAAC"}
package/dist/types/core/agent/stages/iterationStart.d.ts DELETED
@@ -1,16 +0,0 @@
1
- /**
2
- * iterationStart — per-iteration marker stage.
3
- *
4
- * Emits `agentfootprint.agent.iteration_start` so observability adapters
5
- * + recorders can bracket each ReAct iteration. Fires AFTER the slot
6
- * subflows (SystemPrompt, Messages, Tools, CacheDecision, CacheGate)
7
- * have produced this iteration's prompt assembly and BEFORE CallLLM.
8
- *
9
- * `turnIndex: 0` is intentional — the agent currently runs ONE turn per
10
- * `agent.run()`. The turn index is reserved for future multi-turn
11
- * orchestration; iteration index is the per-iteration counter.
12
- */
13
- import type { TypedScope } from 'footprintjs';
14
- import type { AgentState } from '../types.js';
15
- export declare const iterationStartStage: (scope: TypedScope<AgentState>) => void;
16
- //# sourceMappingURL=iterationStart.d.ts.map
package/dist/types/core/agent/stages/iterationStart.d.ts.map DELETED
@@ -1 +0,0 @@
1
- {"version":3,"file":"iterationStart.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/stages/iterationStart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,mBAAmB,UAAW,WAAW,UAAU,CAAC,KAAG,IAKnE,CAAC"}