@xynehq/jaf 0.1.2

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 (279) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +596 -0
  3. package/dist/a2a/agent-card.d.ts +28 -0
  4. package/dist/a2a/agent-card.d.ts.map +1 -0
  5. package/dist/a2a/agent-card.js +250 -0
  6. package/dist/a2a/agent-card.js.map +1 -0
  7. package/dist/a2a/agent.d.ts +38 -0
  8. package/dist/a2a/agent.d.ts.map +1 -0
  9. package/dist/a2a/agent.js +223 -0
  10. package/dist/a2a/agent.js.map +1 -0
  11. package/dist/a2a/client.d.ts +35 -0
  12. package/dist/a2a/client.d.ts.map +1 -0
  13. package/dist/a2a/client.js +337 -0
  14. package/dist/a2a/client.js.map +1 -0
  15. package/dist/a2a/examples/client-example.d.ts +104 -0
  16. package/dist/a2a/examples/client-example.d.ts.map +1 -0
  17. package/dist/a2a/examples/client-example.js +232 -0
  18. package/dist/a2a/examples/client-example.js.map +1 -0
  19. package/dist/a2a/examples/server-example.d.ts +9 -0
  20. package/dist/a2a/examples/server-example.d.ts.map +1 -0
  21. package/dist/a2a/examples/server-example.js +209 -0
  22. package/dist/a2a/examples/server-example.js.map +1 -0
  23. package/dist/a2a/examples/weather-agent.d.ts +8 -0
  24. package/dist/a2a/examples/weather-agent.d.ts.map +1 -0
  25. package/dist/a2a/examples/weather-agent.js +232 -0
  26. package/dist/a2a/examples/weather-agent.js.map +1 -0
  27. package/dist/a2a/executor.d.ts +43 -0
  28. package/dist/a2a/executor.d.ts.map +1 -0
  29. package/dist/a2a/executor.js +507 -0
  30. package/dist/a2a/executor.js.map +1 -0
  31. package/dist/a2a/index.d.ts +378 -0
  32. package/dist/a2a/index.d.ts.map +1 -0
  33. package/dist/a2a/index.js +72 -0
  34. package/dist/a2a/index.js.map +1 -0
  35. package/dist/a2a/memory/cleanup.d.ts +58 -0
  36. package/dist/a2a/memory/cleanup.d.ts.map +1 -0
  37. package/dist/a2a/memory/cleanup.js +281 -0
  38. package/dist/a2a/memory/cleanup.js.map +1 -0
  39. package/dist/a2a/memory/factory.d.ts +38 -0
  40. package/dist/a2a/memory/factory.d.ts.map +1 -0
  41. package/dist/a2a/memory/factory.js +369 -0
  42. package/dist/a2a/memory/factory.js.map +1 -0
  43. package/dist/a2a/memory/index.d.ts +13 -0
  44. package/dist/a2a/memory/index.d.ts.map +1 -0
  45. package/dist/a2a/memory/index.js +16 -0
  46. package/dist/a2a/memory/index.js.map +1 -0
  47. package/dist/a2a/memory/providers/in-memory.d.ts +10 -0
  48. package/dist/a2a/memory/providers/in-memory.d.ts.map +1 -0
  49. package/dist/a2a/memory/providers/in-memory.js +539 -0
  50. package/dist/a2a/memory/providers/in-memory.js.map +1 -0
  51. package/dist/a2a/memory/providers/postgres.d.ts +10 -0
  52. package/dist/a2a/memory/providers/postgres.d.ts.map +1 -0
  53. package/dist/a2a/memory/providers/postgres.js +404 -0
  54. package/dist/a2a/memory/providers/postgres.js.map +1 -0
  55. package/dist/a2a/memory/providers/redis.d.ts +10 -0
  56. package/dist/a2a/memory/providers/redis.d.ts.map +1 -0
  57. package/dist/a2a/memory/providers/redis.js +435 -0
  58. package/dist/a2a/memory/providers/redis.js.map +1 -0
  59. package/dist/a2a/memory/serialization.d.ts +53 -0
  60. package/dist/a2a/memory/serialization.d.ts.map +1 -0
  61. package/dist/a2a/memory/serialization.js +233 -0
  62. package/dist/a2a/memory/serialization.js.map +1 -0
  63. package/dist/a2a/memory/types.d.ts +395 -0
  64. package/dist/a2a/memory/types.d.ts.map +1 -0
  65. package/dist/a2a/memory/types.js +85 -0
  66. package/dist/a2a/memory/types.js.map +1 -0
  67. package/dist/a2a/protocol.d.ts +38 -0
  68. package/dist/a2a/protocol.d.ts.map +1 -0
  69. package/dist/a2a/protocol.js +211 -0
  70. package/dist/a2a/protocol.js.map +1 -0
  71. package/dist/a2a/server.d.ts +343 -0
  72. package/dist/a2a/server.d.ts.map +1 -0
  73. package/dist/a2a/server.js +362 -0
  74. package/dist/a2a/server.js.map +1 -0
  75. package/dist/a2a/types.d.ts +730 -0
  76. package/dist/a2a/types.d.ts.map +1 -0
  77. package/dist/a2a/types.js +73 -0
  78. package/dist/a2a/types.js.map +1 -0
  79. package/dist/adk/agents/index.d.ts +48 -0
  80. package/dist/adk/agents/index.d.ts.map +1 -0
  81. package/dist/adk/agents/index.js +277 -0
  82. package/dist/adk/agents/index.js.map +1 -0
  83. package/dist/adk/artifacts/index.d.ts +62 -0
  84. package/dist/adk/artifacts/index.d.ts.map +1 -0
  85. package/dist/adk/artifacts/index.js +394 -0
  86. package/dist/adk/artifacts/index.js.map +1 -0
  87. package/dist/adk/config/llm-config.d.ts +75 -0
  88. package/dist/adk/config/llm-config.d.ts.map +1 -0
  89. package/dist/adk/config/llm-config.js +422 -0
  90. package/dist/adk/config/llm-config.js.map +1 -0
  91. package/dist/adk/content/index.d.ts +58 -0
  92. package/dist/adk/content/index.d.ts.map +1 -0
  93. package/dist/adk/content/index.js +220 -0
  94. package/dist/adk/content/index.js.map +1 -0
  95. package/dist/adk/examples/advanced-features.d.ts +22 -0
  96. package/dist/adk/examples/advanced-features.d.ts.map +1 -0
  97. package/dist/adk/examples/advanced-features.js +380 -0
  98. package/dist/adk/examples/advanced-features.js.map +1 -0
  99. package/dist/adk/examples/basic-agent.d.ts +28 -0
  100. package/dist/adk/examples/basic-agent.d.ts.map +1 -0
  101. package/dist/adk/examples/basic-agent.js +207 -0
  102. package/dist/adk/examples/basic-agent.js.map +1 -0
  103. package/dist/adk/examples/multi-agent.d.ts +24 -0
  104. package/dist/adk/examples/multi-agent.d.ts.map +1 -0
  105. package/dist/adk/examples/multi-agent.js +321 -0
  106. package/dist/adk/examples/multi-agent.js.map +1 -0
  107. package/dist/adk/examples/streaming-example.d.ts +9 -0
  108. package/dist/adk/examples/streaming-example.d.ts.map +1 -0
  109. package/dist/adk/examples/streaming-example.js +193 -0
  110. package/dist/adk/examples/streaming-example.js.map +1 -0
  111. package/dist/adk/index.d.ts +65 -0
  112. package/dist/adk/index.d.ts.map +1 -0
  113. package/dist/adk/index.js +251 -0
  114. package/dist/adk/index.js.map +1 -0
  115. package/dist/adk/models.d.ts +338 -0
  116. package/dist/adk/models.d.ts.map +1 -0
  117. package/dist/adk/models.js +466 -0
  118. package/dist/adk/models.js.map +1 -0
  119. package/dist/adk/providers/error-handler.d.ts +100 -0
  120. package/dist/adk/providers/error-handler.d.ts.map +1 -0
  121. package/dist/adk/providers/error-handler.js +289 -0
  122. package/dist/adk/providers/error-handler.js.map +1 -0
  123. package/dist/adk/providers/llm-service.d.ts +41 -0
  124. package/dist/adk/providers/llm-service.d.ts.map +1 -0
  125. package/dist/adk/providers/llm-service.js +520 -0
  126. package/dist/adk/providers/llm-service.js.map +1 -0
  127. package/dist/adk/providers/type-converters.d.ts +34 -0
  128. package/dist/adk/providers/type-converters.d.ts.map +1 -0
  129. package/dist/adk/providers/type-converters.js +436 -0
  130. package/dist/adk/providers/type-converters.js.map +1 -0
  131. package/dist/adk/runners/index.d.ts +33 -0
  132. package/dist/adk/runners/index.d.ts.map +1 -0
  133. package/dist/adk/runners/index.js +466 -0
  134. package/dist/adk/runners/index.js.map +1 -0
  135. package/dist/adk/schemas/index.d.ts +85 -0
  136. package/dist/adk/schemas/index.d.ts.map +1 -0
  137. package/dist/adk/schemas/index.js +363 -0
  138. package/dist/adk/schemas/index.js.map +1 -0
  139. package/dist/adk/sessions/examples/session-provider-usage.d.ts +10 -0
  140. package/dist/adk/sessions/examples/session-provider-usage.d.ts.map +1 -0
  141. package/dist/adk/sessions/examples/session-provider-usage.js +145 -0
  142. package/dist/adk/sessions/examples/session-provider-usage.js.map +1 -0
  143. package/dist/adk/sessions/index.d.ts +53 -0
  144. package/dist/adk/sessions/index.d.ts.map +1 -0
  145. package/dist/adk/sessions/index.js +451 -0
  146. package/dist/adk/sessions/index.js.map +1 -0
  147. package/dist/adk/sessions/postgres-provider.d.ts +22 -0
  148. package/dist/adk/sessions/postgres-provider.d.ts.map +1 -0
  149. package/dist/adk/sessions/postgres-provider.js +293 -0
  150. package/dist/adk/sessions/postgres-provider.js.map +1 -0
  151. package/dist/adk/sessions/redis-provider.d.ts +19 -0
  152. package/dist/adk/sessions/redis-provider.d.ts.map +1 -0
  153. package/dist/adk/sessions/redis-provider.js +237 -0
  154. package/dist/adk/sessions/redis-provider.js.map +1 -0
  155. package/dist/adk/streaming/index.d.ts +76 -0
  156. package/dist/adk/streaming/index.d.ts.map +1 -0
  157. package/dist/adk/streaming/index.js +419 -0
  158. package/dist/adk/streaming/index.js.map +1 -0
  159. package/dist/adk/tools/index.d.ts +27 -0
  160. package/dist/adk/tools/index.d.ts.map +1 -0
  161. package/dist/adk/tools/index.js +506 -0
  162. package/dist/adk/tools/index.js.map +1 -0
  163. package/dist/adk/types.d.ts +351 -0
  164. package/dist/adk/types.d.ts.map +1 -0
  165. package/dist/adk/types.js +107 -0
  166. package/dist/adk/types.js.map +1 -0
  167. package/dist/core/engine.d.ts +3 -0
  168. package/dist/core/engine.d.ts.map +1 -0
  169. package/dist/core/engine.js +438 -0
  170. package/dist/core/engine.js.map +1 -0
  171. package/dist/core/errors.d.ts +8 -0
  172. package/dist/core/errors.d.ts.map +1 -0
  173. package/dist/core/errors.js +84 -0
  174. package/dist/core/errors.js.map +1 -0
  175. package/dist/core/tool-results.d.ts +57 -0
  176. package/dist/core/tool-results.d.ts.map +1 -0
  177. package/dist/core/tool-results.js +133 -0
  178. package/dist/core/tool-results.js.map +1 -0
  179. package/dist/core/tracing.d.ts +32 -0
  180. package/dist/core/tracing.d.ts.map +1 -0
  181. package/dist/core/tracing.js +132 -0
  182. package/dist/core/tracing.js.map +1 -0
  183. package/dist/core/types.d.ts +165 -0
  184. package/dist/core/types.d.ts.map +1 -0
  185. package/dist/core/types.js +3 -0
  186. package/dist/core/types.js.map +1 -0
  187. package/dist/demo/agents.d.ts +23 -0
  188. package/dist/demo/agents.d.ts.map +1 -0
  189. package/dist/demo/agents.js +69 -0
  190. package/dist/demo/agents.js.map +1 -0
  191. package/dist/demo/index.d.ts +2 -0
  192. package/dist/demo/index.d.ts.map +1 -0
  193. package/dist/demo/index.js +250 -0
  194. package/dist/demo/index.js.map +1 -0
  195. package/dist/demo/mock-provider.d.ts +22 -0
  196. package/dist/demo/mock-provider.d.ts.map +1 -0
  197. package/dist/demo/mock-provider.js +138 -0
  198. package/dist/demo/mock-provider.js.map +1 -0
  199. package/dist/demo/tools.d.ts +14 -0
  200. package/dist/demo/tools.d.ts.map +1 -0
  201. package/dist/demo/tools.js +115 -0
  202. package/dist/demo/tools.js.map +1 -0
  203. package/dist/index.d.ts +20 -0
  204. package/dist/index.d.ts.map +1 -0
  205. package/dist/index.js +30 -0
  206. package/dist/index.js.map +1 -0
  207. package/dist/memory/factory.d.ts +22 -0
  208. package/dist/memory/factory.d.ts.map +1 -0
  209. package/dist/memory/factory.js +88 -0
  210. package/dist/memory/factory.js.map +1 -0
  211. package/dist/memory/providers/in-memory.d.ts +7 -0
  212. package/dist/memory/providers/in-memory.d.ts.map +1 -0
  213. package/dist/memory/providers/in-memory.js +287 -0
  214. package/dist/memory/providers/in-memory.js.map +1 -0
  215. package/dist/memory/providers/postgres.d.ts +15 -0
  216. package/dist/memory/providers/postgres.d.ts.map +1 -0
  217. package/dist/memory/providers/postgres.js +495 -0
  218. package/dist/memory/providers/postgres.js.map +1 -0
  219. package/dist/memory/providers/redis.d.ts +18 -0
  220. package/dist/memory/providers/redis.d.ts.map +1 -0
  221. package/dist/memory/providers/redis.js +354 -0
  222. package/dist/memory/providers/redis.js.map +1 -0
  223. package/dist/memory/types.d.ts +296 -0
  224. package/dist/memory/types.d.ts.map +1 -0
  225. package/dist/memory/types.js +93 -0
  226. package/dist/memory/types.js.map +1 -0
  227. package/dist/policies/handoff.d.ts +16 -0
  228. package/dist/policies/handoff.d.ts.map +1 -0
  229. package/dist/policies/handoff.js +20 -0
  230. package/dist/policies/handoff.js.map +1 -0
  231. package/dist/policies/validation.d.ts +14 -0
  232. package/dist/policies/validation.d.ts.map +1 -0
  233. package/dist/policies/validation.js +92 -0
  234. package/dist/policies/validation.js.map +1 -0
  235. package/dist/providers/mcp.d.ts +17 -0
  236. package/dist/providers/mcp.d.ts.map +1 -0
  237. package/dist/providers/mcp.js +111 -0
  238. package/dist/providers/mcp.js.map +1 -0
  239. package/dist/providers/model.d.ts +3 -0
  240. package/dist/providers/model.d.ts.map +1 -0
  241. package/dist/providers/model.js +113 -0
  242. package/dist/providers/model.js.map +1 -0
  243. package/dist/server/index.d.ts +35 -0
  244. package/dist/server/index.d.ts.map +1 -0
  245. package/dist/server/index.js +66 -0
  246. package/dist/server/index.js.map +1 -0
  247. package/dist/server/server.d.ts +12 -0
  248. package/dist/server/server.d.ts.map +1 -0
  249. package/dist/server/server.js +394 -0
  250. package/dist/server/server.js.map +1 -0
  251. package/dist/server/types.d.ts +456 -0
  252. package/dist/server/types.d.ts.map +1 -0
  253. package/dist/server/types.js +75 -0
  254. package/dist/server/types.js.map +1 -0
  255. package/dist/test-utils/db-setup.d.ts +34 -0
  256. package/dist/test-utils/db-setup.d.ts.map +1 -0
  257. package/dist/test-utils/db-setup.js +149 -0
  258. package/dist/test-utils/db-setup.js.map +1 -0
  259. package/dist/utils/logger.d.ts +63 -0
  260. package/dist/utils/logger.d.ts.map +1 -0
  261. package/dist/utils/logger.js +199 -0
  262. package/dist/utils/logger.js.map +1 -0
  263. package/dist/utils/safe-math.d.ts +31 -0
  264. package/dist/utils/safe-math.d.ts.map +1 -0
  265. package/dist/utils/safe-math.js +86 -0
  266. package/dist/utils/safe-math.js.map +1 -0
  267. package/dist/visualization/example.d.ts +9 -0
  268. package/dist/visualization/example.d.ts.map +1 -0
  269. package/dist/visualization/example.js +236 -0
  270. package/dist/visualization/example.js.map +1 -0
  271. package/dist/visualization/graphviz.d.ts +42 -0
  272. package/dist/visualization/graphviz.d.ts.map +1 -0
  273. package/dist/visualization/graphviz.js +403 -0
  274. package/dist/visualization/graphviz.js.map +1 -0
  275. package/dist/visualization/index.d.ts +10 -0
  276. package/dist/visualization/index.d.ts.map +1 -0
  277. package/dist/visualization/index.js +12 -0
  278. package/dist/visualization/index.js.map +1 -0
  279. package/package.json +99 -0
@@ -0,0 +1,438 @@
1
+ export async function run(initialState, config) {
2
+ try {
3
+ config.onEvent?.({
4
+ type: 'run_start',
5
+ data: { runId: initialState.runId, traceId: initialState.traceId }
6
+ });
7
+ // Load conversation history from memory if configured
8
+ let stateWithMemory = initialState;
9
+ if (config.memory?.autoStore && config.conversationId) {
10
+ console.log(`[JAF:ENGINE] Loading conversation history for ${config.conversationId}`);
11
+ stateWithMemory = await loadConversationHistory(initialState, config);
12
+ }
13
+ else {
14
+ console.log(`[JAF:ENGINE] Skipping memory load - autoStore: ${config.memory?.autoStore}, conversationId: ${config.conversationId}`);
15
+ }
16
+ const result = await runInternal(stateWithMemory, config);
17
+ // Store conversation history to memory if configured
18
+ if (config.memory?.autoStore && config.conversationId && result.finalState.messages.length > initialState.messages.length) {
19
+ console.log(`[JAF:ENGINE] Storing conversation history for ${config.conversationId}`);
20
+ await storeConversationHistory(result.finalState, config);
21
+ }
22
+ else {
23
+ console.log(`[JAF:ENGINE] Skipping memory store - autoStore: ${config.memory?.autoStore}, conversationId: ${config.conversationId}, messageChange: ${result.finalState.messages.length > initialState.messages.length}`);
24
+ }
25
+ config.onEvent?.({
26
+ type: 'run_end',
27
+ data: { outcome: result.outcome }
28
+ });
29
+ return result;
30
+ }
31
+ catch (error) {
32
+ const errorResult = {
33
+ finalState: initialState,
34
+ outcome: {
35
+ status: 'error',
36
+ error: {
37
+ _tag: 'ModelBehaviorError',
38
+ detail: error instanceof Error ? error.message : String(error)
39
+ }
40
+ }
41
+ };
42
+ config.onEvent?.({
43
+ type: 'run_end',
44
+ data: { outcome: errorResult.outcome }
45
+ });
46
+ return errorResult;
47
+ }
48
+ }
49
+ async function runInternal(state, config) {
50
+ if (state.turnCount === 0) {
51
+ const firstUserMessage = state.messages.find(m => m.role === 'user');
52
+ if (firstUserMessage && config.initialInputGuardrails) {
53
+ for (const guardrail of config.initialInputGuardrails) {
54
+ const result = await guardrail(firstUserMessage.content);
55
+ if (!result.isValid) {
56
+ return {
57
+ finalState: state,
58
+ outcome: {
59
+ status: 'error',
60
+ error: {
61
+ _tag: 'InputGuardrailTripwire',
62
+ reason: result.errorMessage
63
+ }
64
+ }
65
+ };
66
+ }
67
+ }
68
+ }
69
+ }
70
+ const maxTurns = config.maxTurns ?? 50;
71
+ if (state.turnCount >= maxTurns) {
72
+ return {
73
+ finalState: state,
74
+ outcome: {
75
+ status: 'error',
76
+ error: {
77
+ _tag: 'MaxTurnsExceeded',
78
+ turns: state.turnCount
79
+ }
80
+ }
81
+ };
82
+ }
83
+ const currentAgent = config.agentRegistry.get(state.currentAgentName);
84
+ if (!currentAgent) {
85
+ return {
86
+ finalState: state,
87
+ outcome: {
88
+ status: 'error',
89
+ error: {
90
+ _tag: 'AgentNotFound',
91
+ agentName: state.currentAgentName
92
+ }
93
+ }
94
+ };
95
+ }
96
+ console.log(`[JAF:ENGINE] Using agent: ${currentAgent.name}`);
97
+ console.log(`[JAF:ENGINE] Agent has ${currentAgent.tools?.length || 0} tools available`);
98
+ if (currentAgent.tools) {
99
+ console.log(`[JAF:ENGINE] Available tools:`, currentAgent.tools.map(t => t.schema.name));
100
+ }
101
+ const model = config.modelOverride ?? currentAgent.modelConfig?.name ?? "gpt-4o";
102
+ config.onEvent?.({
103
+ type: 'llm_call_start',
104
+ data: { agentName: currentAgent.name, model }
105
+ });
106
+ const llmResponse = await config.modelProvider.getCompletion(state, currentAgent, config);
107
+ config.onEvent?.({
108
+ type: 'llm_call_end',
109
+ data: { choice: llmResponse }
110
+ });
111
+ if (!llmResponse.message) {
112
+ return {
113
+ finalState: state,
114
+ outcome: {
115
+ status: 'error',
116
+ error: {
117
+ _tag: 'ModelBehaviorError',
118
+ detail: 'No message in model response'
119
+ }
120
+ }
121
+ };
122
+ }
123
+ const assistantMessage = {
124
+ role: 'assistant',
125
+ content: llmResponse.message.content || '',
126
+ tool_calls: llmResponse.message.tool_calls
127
+ };
128
+ const newMessages = [...state.messages, assistantMessage];
129
+ if (llmResponse.message.tool_calls && llmResponse.message.tool_calls.length > 0) {
130
+ console.log(`[JAF:ENGINE] Processing ${llmResponse.message.tool_calls.length} tool calls`);
131
+ console.log(`[JAF:ENGINE] Tool calls:`, llmResponse.message.tool_calls);
132
+ const toolResults = await executeToolCalls(llmResponse.message.tool_calls, currentAgent, state, config);
133
+ console.log(`[JAF:ENGINE] Tool execution completed. Results count:`, toolResults.length);
134
+ if (toolResults.some(r => r.isHandoff)) {
135
+ const handoffResult = toolResults.find(r => r.isHandoff);
136
+ if (handoffResult) {
137
+ const targetAgent = handoffResult.targetAgent;
138
+ if (!currentAgent.handoffs?.includes(targetAgent)) {
139
+ return {
140
+ finalState: { ...state, messages: newMessages },
141
+ outcome: {
142
+ status: 'error',
143
+ error: {
144
+ _tag: 'HandoffError',
145
+ detail: `Agent ${currentAgent.name} cannot handoff to ${targetAgent}`
146
+ }
147
+ }
148
+ };
149
+ }
150
+ config.onEvent?.({
151
+ type: 'handoff',
152
+ data: { from: currentAgent.name, to: targetAgent }
153
+ });
154
+ const nextState = {
155
+ ...state,
156
+ messages: [...newMessages, ...toolResults.map(r => r.message)],
157
+ currentAgentName: targetAgent,
158
+ turnCount: state.turnCount + 1
159
+ };
160
+ return runInternal(nextState, config);
161
+ }
162
+ }
163
+ const nextState = {
164
+ ...state,
165
+ messages: [...newMessages, ...toolResults.map(r => r.message)],
166
+ turnCount: state.turnCount + 1
167
+ };
168
+ return runInternal(nextState, config);
169
+ }
170
+ if (llmResponse.message.content) {
171
+ if (currentAgent.outputCodec) {
172
+ const parseResult = currentAgent.outputCodec.safeParse(tryParseJSON(llmResponse.message.content));
173
+ if (!parseResult.success) {
174
+ return {
175
+ finalState: { ...state, messages: newMessages },
176
+ outcome: {
177
+ status: 'error',
178
+ error: {
179
+ _tag: 'DecodeError',
180
+ errors: parseResult.error.issues
181
+ }
182
+ }
183
+ };
184
+ }
185
+ if (config.finalOutputGuardrails) {
186
+ for (const guardrail of config.finalOutputGuardrails) {
187
+ const result = await guardrail(parseResult.data);
188
+ if (!result.isValid) {
189
+ return {
190
+ finalState: { ...state, messages: newMessages },
191
+ outcome: {
192
+ status: 'error',
193
+ error: {
194
+ _tag: 'OutputGuardrailTripwire',
195
+ reason: result.errorMessage
196
+ }
197
+ }
198
+ };
199
+ }
200
+ }
201
+ }
202
+ return {
203
+ finalState: { ...state, messages: newMessages },
204
+ outcome: {
205
+ status: 'completed',
206
+ output: parseResult.data
207
+ }
208
+ };
209
+ }
210
+ else {
211
+ if (config.finalOutputGuardrails) {
212
+ for (const guardrail of config.finalOutputGuardrails) {
213
+ const result = await guardrail(llmResponse.message.content);
214
+ if (!result.isValid) {
215
+ return {
216
+ finalState: { ...state, messages: newMessages },
217
+ outcome: {
218
+ status: 'error',
219
+ error: {
220
+ _tag: 'OutputGuardrailTripwire',
221
+ reason: result.errorMessage
222
+ }
223
+ }
224
+ };
225
+ }
226
+ }
227
+ }
228
+ return {
229
+ finalState: { ...state, messages: newMessages },
230
+ outcome: {
231
+ status: 'completed',
232
+ output: llmResponse.message.content
233
+ }
234
+ };
235
+ }
236
+ }
237
+ return {
238
+ finalState: { ...state, messages: newMessages },
239
+ outcome: {
240
+ status: 'error',
241
+ error: {
242
+ _tag: 'ModelBehaviorError',
243
+ detail: 'Model produced neither content nor tool calls'
244
+ }
245
+ }
246
+ };
247
+ }
248
+ async function executeToolCalls(toolCalls, agent, state, config) {
249
+ const results = await Promise.all(toolCalls.map(async (toolCall) => {
250
+ config.onEvent?.({
251
+ type: 'tool_call_start',
252
+ data: {
253
+ toolName: toolCall.function.name,
254
+ args: tryParseJSON(toolCall.function.arguments)
255
+ }
256
+ });
257
+ try {
258
+ const tool = agent.tools?.find(t => t.schema.name === toolCall.function.name);
259
+ if (!tool) {
260
+ const errorResult = JSON.stringify({
261
+ error: "tool_not_found",
262
+ message: `Tool ${toolCall.function.name} not found`,
263
+ tool_name: toolCall.function.name,
264
+ });
265
+ config.onEvent?.({
266
+ type: 'tool_call_end',
267
+ data: { toolName: toolCall.function.name, result: errorResult }
268
+ });
269
+ return {
270
+ message: {
271
+ role: 'tool',
272
+ content: errorResult,
273
+ tool_call_id: toolCall.id
274
+ }
275
+ };
276
+ }
277
+ const rawArgs = tryParseJSON(toolCall.function.arguments);
278
+ const parseResult = tool.schema.parameters.safeParse(rawArgs);
279
+ if (!parseResult.success) {
280
+ const errorResult = JSON.stringify({
281
+ error: "validation_error",
282
+ message: `Invalid arguments for ${toolCall.function.name}: ${parseResult.error.message}`,
283
+ tool_name: toolCall.function.name,
284
+ validation_errors: parseResult.error.issues
285
+ });
286
+ config.onEvent?.({
287
+ type: 'tool_call_end',
288
+ data: { toolName: toolCall.function.name, result: errorResult }
289
+ });
290
+ return {
291
+ message: {
292
+ role: 'tool',
293
+ content: errorResult,
294
+ tool_call_id: toolCall.id
295
+ }
296
+ };
297
+ }
298
+ console.log(`[JAF:ENGINE] About to execute tool: ${toolCall.function.name}`);
299
+ console.log(`[JAF:ENGINE] Tool args:`, parseResult.data);
300
+ console.log(`[JAF:ENGINE] Tool context:`, state.context);
301
+ const toolResult = await tool.execute(parseResult.data, state.context);
302
+ // Handle both string and ToolResult formats
303
+ let resultString;
304
+ let toolResultObj = null;
305
+ if (typeof toolResult === 'string') {
306
+ resultString = toolResult;
307
+ console.log(`[JAF:ENGINE] Tool ${toolCall.function.name} returned string:`, resultString);
308
+ }
309
+ else {
310
+ // It's a ToolResult object
311
+ toolResultObj = toolResult;
312
+ const { toolResultToString } = await import('./tool-results');
313
+ resultString = toolResultToString(toolResult);
314
+ console.log(`[JAF:ENGINE] Tool ${toolCall.function.name} returned ToolResult:`, toolResult);
315
+ console.log(`[JAF:ENGINE] Converted to string:`, resultString);
316
+ }
317
+ config.onEvent?.({
318
+ type: 'tool_call_end',
319
+ data: {
320
+ toolName: toolCall.function.name,
321
+ result: resultString,
322
+ toolResult: toolResultObj,
323
+ status: toolResultObj?.status || 'success'
324
+ }
325
+ });
326
+ const handoffCheck = tryParseJSON(resultString);
327
+ if (handoffCheck && typeof handoffCheck === 'object' && 'handoff_to' in handoffCheck) {
328
+ return {
329
+ message: {
330
+ role: 'tool',
331
+ content: resultString,
332
+ tool_call_id: toolCall.id
333
+ },
334
+ isHandoff: true,
335
+ targetAgent: handoffCheck.handoff_to
336
+ };
337
+ }
338
+ return {
339
+ message: {
340
+ role: 'tool',
341
+ content: resultString,
342
+ tool_call_id: toolCall.id
343
+ }
344
+ };
345
+ }
346
+ catch (error) {
347
+ const errorResult = JSON.stringify({
348
+ error: "execution_error",
349
+ message: error instanceof Error ? error.message : String(error),
350
+ tool_name: toolCall.function.name,
351
+ });
352
+ config.onEvent?.({
353
+ type: 'tool_call_end',
354
+ data: { toolName: toolCall.function.name, result: errorResult }
355
+ });
356
+ return {
357
+ message: {
358
+ role: 'tool',
359
+ content: errorResult,
360
+ tool_call_id: toolCall.id
361
+ }
362
+ };
363
+ }
364
+ }));
365
+ return results;
366
+ }
367
+ function tryParseJSON(str) {
368
+ try {
369
+ return JSON.parse(str);
370
+ }
371
+ catch {
372
+ return str;
373
+ }
374
+ }
375
+ /**
376
+ * Load conversation history from memory and merge with initial state
377
+ */
378
+ async function loadConversationHistory(initialState, config) {
379
+ if (!config.memory?.provider || !config.conversationId) {
380
+ return initialState;
381
+ }
382
+ const result = await config.memory.provider.getConversation(config.conversationId);
383
+ if (!result.success) {
384
+ console.warn(`[JAF:MEMORY] Failed to load conversation history: ${result.error.message}`);
385
+ return initialState;
386
+ }
387
+ if (!result.data) {
388
+ console.log(`[JAF:MEMORY] No existing conversation found for ${config.conversationId}`);
389
+ return initialState;
390
+ }
391
+ // Apply memory limits if configured
392
+ const maxMessages = config.memory.maxMessages || result.data.messages.length;
393
+ const memoryMessages = result.data.messages.slice(-maxMessages);
394
+ // Merge existing messages with new messages, avoiding duplicates
395
+ const combinedMessages = [...memoryMessages, ...initialState.messages];
396
+ console.log(`[JAF:MEMORY] Loaded ${memoryMessages.length} messages from memory for conversation ${config.conversationId}`);
397
+ console.log(`[JAF:MEMORY] Memory messages:`, memoryMessages.map(m => ({ role: m.role, content: m.content?.substring(0, 100) + '...' })));
398
+ console.log(`[JAF:MEMORY] New messages:`, initialState.messages.map(m => ({ role: m.role, content: m.content?.substring(0, 100) + '...' })));
399
+ console.log(`[JAF:MEMORY] Combined messages (${combinedMessages.length} total):`, combinedMessages.map(m => ({ role: m.role, content: m.content?.substring(0, 100) + '...' })));
400
+ return {
401
+ ...initialState,
402
+ messages: combinedMessages
403
+ };
404
+ }
405
+ /**
406
+ * Store conversation history to memory
407
+ */
408
+ async function storeConversationHistory(finalState, config) {
409
+ if (!config.memory?.provider || !config.conversationId) {
410
+ return;
411
+ }
412
+ // Apply compression threshold if configured
413
+ let messagesToStore = finalState.messages;
414
+ if (config.memory.compressionThreshold && messagesToStore.length > config.memory.compressionThreshold) {
415
+ // Keep first few messages and recent messages
416
+ const keepFirst = Math.floor(config.memory.compressionThreshold * 0.2);
417
+ const keepRecent = config.memory.compressionThreshold - keepFirst;
418
+ messagesToStore = [
419
+ ...messagesToStore.slice(0, keepFirst),
420
+ ...messagesToStore.slice(-keepRecent)
421
+ ];
422
+ console.log(`[JAF:MEMORY] Compressed conversation from ${finalState.messages.length} to ${messagesToStore.length} messages`);
423
+ }
424
+ const metadata = {
425
+ userId: finalState.context?.userId,
426
+ traceId: finalState.traceId,
427
+ runId: finalState.runId,
428
+ agentName: finalState.currentAgentName,
429
+ turnCount: finalState.turnCount
430
+ };
431
+ const result = await config.memory.provider.storeMessages(config.conversationId, messagesToStore, metadata);
432
+ if (!result.success) {
433
+ console.warn(`[JAF:MEMORY] Failed to store conversation history: ${result.error.message}`);
434
+ return;
435
+ }
436
+ console.log(`[JAF:MEMORY] Stored ${messagesToStore.length} messages for conversation ${config.conversationId}`);
437
+ }
438
+ //# sourceMappingURL=engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/core/engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import { JAFError } from './types.js';
2
+ export declare class JAFErrorHandler {
3
+ static format(error: JAFError): string;
4
+ static isRetryable(error: JAFError): boolean;
5
+ static getSeverity(error: JAFError): 'low' | 'medium' | 'high' | 'critical';
6
+ }
7
+ export declare function createJAFError(tag: JAFError['_tag'], details: any): JAFError;
8
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,qBAAa,eAAe;IAC1B,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM;IAiCtC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAmB5C,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU;CAwB5E;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,QAAQ,CAqB5E"}
@@ -0,0 +1,84 @@
1
+ export class JAFErrorHandler {
2
+ static format(error) {
3
+ switch (error._tag) {
4
+ case 'MaxTurnsExceeded':
5
+ return `Maximum turns exceeded: ${error.turns} turns completed`;
6
+ case 'ModelBehaviorError':
7
+ return `Model behavior error: ${error.detail}`;
8
+ case 'DecodeError': {
9
+ const issues = error.errors.map(e => `${e.path.join('.')}: ${e.message}`).join(', ');
10
+ return `Decode error: ${issues}`;
11
+ }
12
+ case 'InputGuardrailTripwire':
13
+ return `Input guardrail triggered: ${error.reason}`;
14
+ case 'OutputGuardrailTripwire':
15
+ return `Output guardrail triggered: ${error.reason}`;
16
+ case 'ToolCallError':
17
+ return `Tool call error in ${error.tool}: ${error.detail}`;
18
+ case 'HandoffError':
19
+ return `Handoff error: ${error.detail}`;
20
+ case 'AgentNotFound':
21
+ return `Agent not found: ${error.agentName}`;
22
+ default:
23
+ return `Unknown error: ${JSON.stringify(error)}`;
24
+ }
25
+ }
26
+ static isRetryable(error) {
27
+ switch (error._tag) {
28
+ case 'ModelBehaviorError':
29
+ case 'ToolCallError':
30
+ return true;
31
+ case 'MaxTurnsExceeded':
32
+ case 'DecodeError':
33
+ case 'InputGuardrailTripwire':
34
+ case 'OutputGuardrailTripwire':
35
+ case 'HandoffError':
36
+ case 'AgentNotFound':
37
+ return false;
38
+ default:
39
+ return false;
40
+ }
41
+ }
42
+ static getSeverity(error) {
43
+ switch (error._tag) {
44
+ case 'ModelBehaviorError':
45
+ case 'ToolCallError':
46
+ return 'medium';
47
+ case 'DecodeError':
48
+ return 'high';
49
+ case 'MaxTurnsExceeded':
50
+ return 'low';
51
+ case 'InputGuardrailTripwire':
52
+ case 'OutputGuardrailTripwire':
53
+ return 'high';
54
+ case 'HandoffError':
55
+ case 'AgentNotFound':
56
+ return 'critical';
57
+ default:
58
+ return 'medium';
59
+ }
60
+ }
61
+ }
62
+ export function createJAFError(tag, details) {
63
+ switch (tag) {
64
+ case 'MaxTurnsExceeded':
65
+ return { _tag: tag, turns: details.turns };
66
+ case 'ModelBehaviorError':
67
+ return { _tag: tag, detail: details.detail || details };
68
+ case 'DecodeError':
69
+ return { _tag: tag, errors: details.errors || [] };
70
+ case 'InputGuardrailTripwire':
71
+ return { _tag: tag, reason: details.reason || details };
72
+ case 'OutputGuardrailTripwire':
73
+ return { _tag: tag, reason: details.reason || details };
74
+ case 'ToolCallError':
75
+ return { _tag: tag, tool: details.tool, detail: details.detail };
76
+ case 'HandoffError':
77
+ return { _tag: tag, detail: details.detail || details };
78
+ case 'AgentNotFound':
79
+ return { _tag: tag, agentName: details.agentName || details };
80
+ default:
81
+ throw new Error(`Unknown error tag: ${tag}`);
82
+ }
83
+ }
84
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,57 @@
1
+ /**
2
+ * Standardized tool result types for consistent error handling
3
+ */
4
+ export type ToolResultStatus = 'success' | 'error' | 'validation_error' | 'permission_denied' | 'not_found';
5
+ export interface ToolResult<T = any> {
6
+ readonly status: ToolResultStatus;
7
+ readonly data?: T;
8
+ readonly error?: {
9
+ readonly code: string;
10
+ readonly message: string;
11
+ readonly details?: any;
12
+ };
13
+ readonly metadata?: {
14
+ readonly executionTimeMs?: number;
15
+ readonly toolName?: string;
16
+ readonly [key: string]: any;
17
+ };
18
+ }
19
+ export declare const ToolErrorCodes: {
20
+ readonly INVALID_INPUT: "INVALID_INPUT";
21
+ readonly MISSING_REQUIRED_FIELD: "MISSING_REQUIRED_FIELD";
22
+ readonly INVALID_FORMAT: "INVALID_FORMAT";
23
+ readonly PERMISSION_DENIED: "PERMISSION_DENIED";
24
+ readonly INSUFFICIENT_PERMISSIONS: "INSUFFICIENT_PERMISSIONS";
25
+ readonly NOT_FOUND: "NOT_FOUND";
26
+ readonly RESOURCE_UNAVAILABLE: "RESOURCE_UNAVAILABLE";
27
+ readonly EXECUTION_FAILED: "EXECUTION_FAILED";
28
+ readonly TIMEOUT: "TIMEOUT";
29
+ readonly EXTERNAL_SERVICE_ERROR: "EXTERNAL_SERVICE_ERROR";
30
+ readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
31
+ };
32
+ export type ToolErrorCode = typeof ToolErrorCodes[keyof typeof ToolErrorCodes];
33
+ /**
34
+ * Helper functions for creating standardized tool results
35
+ */
36
+ export declare class ToolResponse {
37
+ static success<T>(data: T, metadata?: ToolResult['metadata']): ToolResult<T>;
38
+ static error(code: ToolErrorCode, message: string, details?: any, metadata?: ToolResult['metadata']): ToolResult;
39
+ static validationError(message: string, details?: any, metadata?: ToolResult['metadata']): ToolResult;
40
+ static permissionDenied(message: string, requiredPermissions?: string[], metadata?: ToolResult['metadata']): ToolResult;
41
+ static notFound(resource: string, identifier?: string, metadata?: ToolResult['metadata']): ToolResult;
42
+ }
43
+ /**
44
+ * Tool execution wrapper that provides standardized error handling
45
+ */
46
+ export declare function withErrorHandling<TArgs, TResult, TContext>(toolName: string, executor: (args: TArgs, context: TContext) => Promise<TResult> | TResult): (args: TArgs, context: TContext) => Promise<ToolResult<TResult>>;
47
+ /**
48
+ * Permission checking helper
49
+ */
50
+ export declare function requirePermissions<TContext extends {
51
+ permissions?: string[];
52
+ }>(requiredPermissions: string[]): (context: TContext) => ToolResult | null;
53
+ /**
54
+ * Convert ToolResult to string for backward compatibility with existing tools
55
+ */
56
+ export declare function toolResultToString(result: ToolResult): string;
57
+ //# sourceMappingURL=tool-results.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-results.d.ts","sourceRoot":"","sources":["../../src/core/tool-results.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,WAAW,CAAC;AAE5G,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,GAAG;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,KAAK,CAAC,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC;KACxB,CAAC;IACF,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KAC7B,CAAC;CACH;AAGD,eAAO,MAAM,cAAc;;;;;;;;;;;;CAqBjB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAE/E;;GAEG;AACH,qBAAa,YAAY;IACvB,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAQ5E,MAAM,CAAC,KAAK,CACV,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,GAAG,EACb,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAChC,UAAU;IAYb,MAAM,CAAC,eAAe,CACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,GAAG,EACb,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAChC,UAAU;IAYb,MAAM,CAAC,gBAAgB,CACrB,OAAO,EAAE,MAAM,EACf,mBAAmB,CAAC,EAAE,MAAM,EAAE,EAC9B,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAChC,UAAU;IAYb,MAAM,CAAC,QAAQ,CACb,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,GAChC,UAAU;CAWd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EACxD,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,IAE1D,MAAM,KAAK,EAAE,SAAS,QAAQ,KAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAqC5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,SAAS;IAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAC5E,mBAAmB,EAAE,MAAM,EAAE,IAErB,SAAS,QAAQ,KAAG,UAAU,GAAG,IAAI,CAe9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAgB7D"}