@ainetwork/adk 0.1.6 → 0.1.8

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 (164) hide show
  1. package/dist/cjs/chunk-2E6X6IDL.cjs +37 -0
  2. package/dist/cjs/chunk-2E6X6IDL.cjs.map +1 -0
  3. package/dist/cjs/chunk-2G7V7SC5.cjs +18 -0
  4. package/dist/cjs/chunk-2G7V7SC5.cjs.map +1 -0
  5. package/dist/cjs/chunk-3JKRJYJ6.cjs +111 -0
  6. package/dist/cjs/chunk-3JKRJYJ6.cjs.map +1 -0
  7. package/dist/cjs/chunk-466ED5WN.cjs +41 -0
  8. package/dist/cjs/chunk-466ED5WN.cjs.map +1 -0
  9. package/dist/cjs/chunk-4ESGHH2M.cjs +20 -0
  10. package/dist/cjs/chunk-4ESGHH2M.cjs.map +1 -0
  11. package/dist/cjs/chunk-4HY26I2C.cjs +168 -0
  12. package/dist/cjs/chunk-4HY26I2C.cjs.map +1 -0
  13. package/dist/cjs/chunk-5OWM5IH4.cjs +20 -0
  14. package/dist/cjs/chunk-5OWM5IH4.cjs.map +1 -0
  15. package/dist/cjs/chunk-6S6GEY3D.cjs +37 -0
  16. package/dist/cjs/chunk-6S6GEY3D.cjs.map +1 -0
  17. package/dist/cjs/chunk-CYW6ICAW.cjs +106 -0
  18. package/dist/cjs/chunk-CYW6ICAW.cjs.map +1 -0
  19. package/dist/cjs/chunk-DQP6RGIR.cjs +162 -0
  20. package/dist/cjs/chunk-DQP6RGIR.cjs.map +1 -0
  21. package/dist/cjs/chunk-FWFEVDEY.cjs +172 -0
  22. package/dist/cjs/chunk-FWFEVDEY.cjs.map +1 -0
  23. package/dist/cjs/chunk-GEQMVWSK.cjs +275 -0
  24. package/dist/cjs/chunk-GEQMVWSK.cjs.map +1 -0
  25. package/dist/cjs/chunk-HKIUAJ45.cjs +37 -0
  26. package/dist/cjs/chunk-HKIUAJ45.cjs.map +1 -0
  27. package/dist/cjs/chunk-ICFTUZP5.cjs +111 -0
  28. package/dist/cjs/chunk-ICFTUZP5.cjs.map +1 -0
  29. package/dist/cjs/chunk-MIXAV5OD.cjs +43 -0
  30. package/dist/cjs/chunk-MIXAV5OD.cjs.map +1 -0
  31. package/dist/cjs/chunk-MMWEU2MO.cjs +100 -0
  32. package/dist/cjs/chunk-MMWEU2MO.cjs.map +1 -0
  33. package/dist/cjs/chunk-NYYEZ4ER.cjs +22 -0
  34. package/dist/cjs/chunk-NYYEZ4ER.cjs.map +1 -0
  35. package/dist/cjs/chunk-OBUCVZNU.cjs +37 -0
  36. package/dist/cjs/chunk-OBUCVZNU.cjs.map +1 -0
  37. package/dist/cjs/chunk-RMRFCEP4.cjs +8 -0
  38. package/dist/cjs/chunk-RMRFCEP4.cjs.map +1 -0
  39. package/dist/cjs/chunk-RPMERDHU.cjs +44 -0
  40. package/dist/cjs/chunk-RPMERDHU.cjs.map +1 -0
  41. package/dist/cjs/chunk-RWQDV2XY.cjs +166 -0
  42. package/dist/cjs/chunk-RWQDV2XY.cjs.map +1 -0
  43. package/dist/cjs/chunk-TNLJ6AVP.cjs +22 -0
  44. package/dist/cjs/chunk-TNLJ6AVP.cjs.map +1 -0
  45. package/dist/cjs/chunk-TRT5ABOM.cjs +43 -0
  46. package/dist/cjs/chunk-TRT5ABOM.cjs.map +1 -0
  47. package/dist/cjs/chunk-UQ72NNHV.cjs +225 -0
  48. package/dist/cjs/chunk-UQ72NNHV.cjs.map +1 -0
  49. package/dist/cjs/chunk-XZAKXJYO.cjs +20 -0
  50. package/dist/cjs/chunk-XZAKXJYO.cjs.map +1 -0
  51. package/dist/cjs/chunk-YE52UBF3.cjs +66 -0
  52. package/dist/cjs/chunk-YE52UBF3.cjs.map +1 -0
  53. package/dist/cjs/chunk-ZAZ3KYP5.cjs +43 -0
  54. package/dist/cjs/chunk-ZAZ3KYP5.cjs.map +1 -0
  55. package/dist/cjs/chunk-ZSEBMINV.cjs +44 -0
  56. package/dist/cjs/chunk-ZSEBMINV.cjs.map +1 -0
  57. package/dist/cjs/controllers/a2a.controller.cjs +3 -3
  58. package/dist/cjs/controllers/index.cjs +4 -4
  59. package/dist/cjs/controllers/query.controller.cjs +2 -2
  60. package/dist/cjs/index.cjs +17 -16
  61. package/dist/cjs/index.cjs.map +1 -1
  62. package/dist/cjs/middlewares/error.middleware.cjs +3 -3
  63. package/dist/cjs/modules/a2a/a2a.module.cjs +3 -3
  64. package/dist/cjs/modules/index.cjs +9 -9
  65. package/dist/cjs/modules/index.cjs.map +1 -1
  66. package/dist/cjs/modules/mcp/mcp.module.cjs +3 -3
  67. package/dist/cjs/modules/models/base.model.cjs +2 -2
  68. package/dist/cjs/routes/a2a.routes.cjs +7 -7
  69. package/dist/cjs/routes/index.cjs +10 -9
  70. package/dist/cjs/routes/index.cjs.map +1 -1
  71. package/dist/cjs/routes/query.routes.cjs +7 -6
  72. package/dist/cjs/routes/query.routes.cjs.map +1 -1
  73. package/dist/cjs/services/a2a.service.cjs +3 -3
  74. package/dist/cjs/services/index.cjs +10 -6
  75. package/dist/cjs/services/index.cjs.map +1 -1
  76. package/dist/cjs/services/query-stream.service.cjs +10 -0
  77. package/dist/cjs/services/query-stream.service.cjs.map +1 -0
  78. package/dist/cjs/services/query.service.cjs +4 -4
  79. package/dist/cjs/types/memory.cjs +2 -2
  80. package/dist/cjs/types/stream.cjs +1 -0
  81. package/dist/cjs/types/stream.cjs.map +1 -0
  82. package/dist/cjs/utils/logger.cjs +2 -2
  83. package/dist/esm/{chunk-GZFRRFOE.js → chunk-2BITOA2R.js} +1 -1
  84. package/dist/esm/chunk-2BITOA2R.js.map +1 -0
  85. package/dist/esm/{chunk-BTZVK3EA.js → chunk-BDMVIJPF.js} +18 -12
  86. package/dist/esm/{chunk-BTZVK3EA.js.map → chunk-BDMVIJPF.js.map} +1 -1
  87. package/dist/esm/{chunk-SQWZXP4P.js → chunk-C6SGV7JV.js} +7 -3
  88. package/dist/esm/{chunk-SQWZXP4P.js.map → chunk-C6SGV7JV.js.map} +1 -1
  89. package/dist/esm/{chunk-N6T2JOGC.js → chunk-DRUCJYPJ.js} +4 -8
  90. package/dist/esm/chunk-DRUCJYPJ.js.map +1 -0
  91. package/dist/esm/chunk-F3YHV3TK.js +43 -0
  92. package/dist/esm/chunk-F3YHV3TK.js.map +1 -0
  93. package/dist/esm/{chunk-EODMRV4H.js → chunk-HAE333YO.js} +2 -2
  94. package/dist/esm/{chunk-U2Y64SAC.js → chunk-JOE4VYJJ.js} +4 -4
  95. package/dist/esm/{chunk-ILFWNK3W.js → chunk-MAU2MAK2.js} +2 -2
  96. package/dist/esm/{chunk-64GEXWSE.js → chunk-N7VYM2R5.js} +2 -1
  97. package/dist/esm/chunk-N7VYM2R5.js.map +1 -0
  98. package/dist/esm/chunk-OWL56P6L.js +275 -0
  99. package/dist/esm/chunk-OWL56P6L.js.map +1 -0
  100. package/dist/esm/chunk-RN3S44OH.js +44 -0
  101. package/dist/esm/chunk-RN3S44OH.js.map +1 -0
  102. package/dist/esm/{chunk-F727XG4N.js → chunk-VAZWF5IK.js} +1 -1
  103. package/dist/esm/{chunk-F727XG4N.js.map → chunk-VAZWF5IK.js.map} +1 -1
  104. package/dist/esm/{chunk-AQ5YZERE.js → chunk-Y6E73I7I.js} +2 -2
  105. package/dist/esm/{chunk-7QSZHJU5.js → chunk-YT6PD6UF.js} +4 -4
  106. package/dist/esm/controllers/a2a.controller.d.ts +1 -0
  107. package/dist/esm/controllers/a2a.controller.js +2 -2
  108. package/dist/esm/controllers/api/model.api.controller.d.ts +1 -0
  109. package/dist/esm/controllers/index.d.ts +2 -0
  110. package/dist/esm/controllers/index.js +7 -7
  111. package/dist/esm/controllers/query.controller.d.ts +5 -1
  112. package/dist/esm/controllers/query.controller.js +1 -1
  113. package/dist/esm/index.d.ts +2 -1
  114. package/dist/esm/index.js +22 -21
  115. package/dist/esm/index.js.map +1 -1
  116. package/dist/esm/middlewares/error.middleware.js +2 -2
  117. package/dist/esm/modules/a2a/a2a.module.d.ts +1 -1
  118. package/dist/esm/modules/a2a/a2a.module.js +2 -2
  119. package/dist/esm/modules/index.d.ts +1 -0
  120. package/dist/esm/modules/index.js +10 -10
  121. package/dist/esm/modules/mcp/mcp.module.d.ts +1 -1
  122. package/dist/esm/modules/mcp/mcp.module.js +2 -2
  123. package/dist/esm/modules/memory/base.memory.d.ts +3 -3
  124. package/dist/esm/modules/models/base.model.d.ts +13 -0
  125. package/dist/esm/modules/models/base.model.js +1 -1
  126. package/dist/esm/modules/models/model.module.d.ts +1 -0
  127. package/dist/esm/routes/a2a.routes.d.ts +1 -0
  128. package/dist/esm/routes/a2a.routes.js +6 -6
  129. package/dist/esm/routes/api/models.routes.d.ts +1 -0
  130. package/dist/esm/routes/api.routes.d.ts +1 -0
  131. package/dist/esm/routes/api.routes.js +2 -2
  132. package/dist/esm/routes/index.d.ts +1 -0
  133. package/dist/esm/routes/index.js +17 -16
  134. package/dist/esm/routes/query.routes.d.ts +2 -1
  135. package/dist/esm/routes/query.routes.js +6 -5
  136. package/dist/esm/services/a2a.service.d.ts +1 -0
  137. package/dist/esm/services/a2a.service.js +2 -2
  138. package/dist/esm/services/index.d.ts +3 -0
  139. package/dist/esm/services/index.js +9 -5
  140. package/dist/esm/services/query-stream.service.d.ts +81 -0
  141. package/dist/esm/services/query-stream.service.js +10 -0
  142. package/dist/esm/services/query-stream.service.js.map +1 -0
  143. package/dist/esm/services/query.service.d.ts +1 -0
  144. package/dist/esm/services/query.service.js +3 -3
  145. package/dist/esm/types/memory.d.ts +9 -1
  146. package/dist/esm/types/memory.js +1 -1
  147. package/dist/esm/types/stream.d.ts +45 -0
  148. package/dist/esm/types/stream.js +1 -0
  149. package/dist/esm/types/stream.js.map +1 -0
  150. package/dist/esm/utils/logger.d.ts +1 -0
  151. package/dist/esm/utils/logger.js +1 -1
  152. package/package.json +1 -1
  153. package/dist/esm/chunk-64GEXWSE.js.map +0 -1
  154. package/dist/esm/chunk-GZFRRFOE.js.map +0 -1
  155. package/dist/esm/chunk-N6T2JOGC.js.map +0 -1
  156. package/dist/esm/chunk-NH7BYWQV.js +0 -27
  157. package/dist/esm/chunk-NH7BYWQV.js.map +0 -1
  158. package/dist/esm/chunk-WIJDRP2A.js +0 -26
  159. package/dist/esm/chunk-WIJDRP2A.js.map +0 -1
  160. /package/dist/esm/{chunk-EODMRV4H.js.map → chunk-HAE333YO.js.map} +0 -0
  161. /package/dist/esm/{chunk-U2Y64SAC.js.map → chunk-JOE4VYJJ.js.map} +0 -0
  162. /package/dist/esm/{chunk-ILFWNK3W.js.map → chunk-MAU2MAK2.js.map} +0 -0
  163. /package/dist/esm/{chunk-AQ5YZERE.js.map → chunk-Y6E73I7I.js.map} +0 -0
  164. /package/dist/esm/{chunk-7QSZHJU5.js.map → chunk-YT6PD6UF.js.map} +0 -0
@@ -0,0 +1,106 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); var _class;
2
+
3
+ var _chunkE433ONENcjs = require('./chunk-E433ONEN.cjs');
4
+
5
+
6
+ var _chunk466ED5WNcjs = require('./chunk-466ED5WN.cjs');
7
+
8
+ // src/modules/mcp/mcp.module.ts
9
+ var _indexjs = require('@modelcontextprotocol/sdk/client/index.js');
10
+ var _stdiojs = require('@modelcontextprotocol/sdk/client/stdio.js');
11
+ var MCPModule = (_class = class {constructor() { _class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this); }
12
+ /** Map of MCP server names to their client instances */
13
+ __init() {this.mcpMap = /* @__PURE__ */ new Map()}
14
+ /** Map of MCP server names to their transport instances */
15
+ __init2() {this.transportMap = /* @__PURE__ */ new Map()}
16
+ /** Array of all discovered tools from connected MCP servers */
17
+ __init3() {this.tools = []}
18
+ /**
19
+ * Connects to MCP servers based on the provided configuration.
20
+ *
21
+ * For each server in the config, establishes a connection, discovers
22
+ * available tools, and adds them to the module's tool collection.
23
+ * Skips servers that are already connected.
24
+ *
25
+ * @param mcpConfig - Configuration object mapping server names to connection details
26
+ * @throws Error if connection to any MCP server fails
27
+ */
28
+ async addMCPConfig(mcpConfig) {
29
+ try {
30
+ for (const [name, conf] of Object.entries(mcpConfig)) {
31
+ if (this.mcpMap.get(name) && this.transportMap.get(name)) continue;
32
+ const transport = new (0, _stdiojs.StdioClientTransport)(conf);
33
+ this.transportMap.set(name, transport);
34
+ const mcp = new (0, _indexjs.Client)({ name: "mcp-client-cli", version: "1.0.0" });
35
+ await mcp.connect(transport);
36
+ this.mcpMap.set(name, mcp);
37
+ const toolsResult = await mcp.listTools();
38
+ this.tools.push(
39
+ ...toolsResult.tools.map((tool) => {
40
+ return new (0, _chunkE433ONENcjs.MCPTool)(name, tool);
41
+ })
42
+ );
43
+ }
44
+ _chunk466ED5WNcjs.loggers.mcp.info("Connected to MCP server with tools:", {
45
+ tools: this.tools.map((tool) => tool.id)
46
+ });
47
+ } catch (error) {
48
+ _chunk466ED5WNcjs.loggers.mcp.error("Failed to connect to MCP server:", { error });
49
+ throw error;
50
+ }
51
+ }
52
+ /**
53
+ * Returns all available tools from connected MCP servers.
54
+ *
55
+ * @returns Array of MCPTool instances representing available tools
56
+ */
57
+ getTools() {
58
+ return this.tools;
59
+ }
60
+ /**
61
+ * Executes a tool on its corresponding MCP server.
62
+ *
63
+ * @param tool - The MCPTool instance to execute
64
+ * @param _args - Arguments to pass to the tool
65
+ * @returns Promise resolving to the tool's execution result
66
+ * @throws Error if the MCP server for the tool is not found
67
+ */
68
+ async useTool(tool, _args) {
69
+ const { serverName, mcpTool } = tool;
70
+ const toolName = mcpTool.name;
71
+ const mcp = this.mcpMap.get(serverName);
72
+ try {
73
+ if (!mcp) {
74
+ throw new Error(`Invalid MCP Tool ${serverName}-${mcpTool.name}`);
75
+ }
76
+ const result = await mcp.callTool({
77
+ name: toolName,
78
+ arguments: _args
79
+ });
80
+ const toolResult = `[Bot Called Tool ${toolName} with args ${JSON.stringify(_args)}]
81
+ ` + JSON.stringify(result.content, null, 2);
82
+ return toolResult;
83
+ } catch (error) {
84
+ _chunk466ED5WNcjs.loggers.mcp.error("Failed to call tool", { error });
85
+ const toolResult = `[Bot Called Tool ${toolName} with args ${JSON.stringify(_args)}]
86
+ ${typeof error === "string" ? error : JSON.stringify(error, null, 2)}`;
87
+ return toolResult;
88
+ }
89
+ }
90
+ /**
91
+ * Closes all MCP client connections.
92
+ *
93
+ * Should be called when shutting down the application to ensure
94
+ * all MCP connections are properly closed.
95
+ */
96
+ async cleanup() {
97
+ this.mcpMap.forEach((mcp) => {
98
+ mcp.close();
99
+ });
100
+ }
101
+ }, _class);
102
+
103
+
104
+
105
+ exports.MCPModule = MCPModule;
106
+ //# sourceMappingURL=chunk-CYW6ICAW.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/shyun/comcom/ain-agent/ain-adk/dist/cjs/chunk-CYW6ICAW.cjs","../../src/modules/mcp/mcp.module.ts"],"names":[],"mappings":"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","file":"/Users/shyun/comcom/ain-agent/ain-adk/dist/cjs/chunk-CYW6ICAW.cjs","sourcesContent":[null,"import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport type { MCPConfig } from \"@/types/mcp.js\";\nimport { loggers } from \"@/utils/logger.js\";\nimport { MCPTool } from \"./mcp.tool.js\";\n\n/**\n * Module for managing Model Context Protocol (MCP) server connections.\n *\n * This module handles the lifecycle of MCP client connections, discovers\n * available tools from connected servers, and provides an interface for\n * executing those tools. Multiple MCP servers can be connected simultaneously.\n *\n * @example\n * ```typescript\n * const mcpModule = new MCPModule();\n * await mcpModule.addMCPConfig({\n * \"filesystem\": {\n * command: \"npx\",\n * args: [\"@modelcontextprotocol/server-filesystem\", \"/path/to/files\"]\n * }\n * });\n *\n * const tools = mcpModule.getTools();\n * const result = await mcpModule.useTool(tools[0], { path: \"/example.txt\" });\n * ```\n */\nexport class MCPModule {\n\t/** Map of MCP server names to their client instances */\n\tprivate mcpMap: Map<string, Client> = new Map();\n\t/** Map of MCP server names to their transport instances */\n\tprivate transportMap: Map<string, StdioClientTransport> = new Map();\n\t/** Array of all discovered tools from connected MCP servers */\n\tprivate tools: MCPTool[] = [];\n\n\t/**\n\t * Connects to MCP servers based on the provided configuration.\n\t *\n\t * For each server in the config, establishes a connection, discovers\n\t * available tools, and adds them to the module's tool collection.\n\t * Skips servers that are already connected.\n\t *\n\t * @param mcpConfig - Configuration object mapping server names to connection details\n\t * @throws Error if connection to any MCP server fails\n\t */\n\tasync addMCPConfig(mcpConfig: MCPConfig) {\n\t\ttry {\n\t\t\tfor (const [name, conf] of Object.entries(mcpConfig)) {\n\t\t\t\t// FIXME(yoojin): Need strict duplication check.\n\t\t\t\tif (this.mcpMap.get(name) && this.transportMap.get(name)) continue; // Duplicated mcp: skip\n\n\t\t\t\tconst transport = new StdioClientTransport(conf);\n\t\t\t\tthis.transportMap.set(name, transport);\n\t\t\t\tconst mcp = new Client({ name: \"mcp-client-cli\", version: \"1.0.0\" });\n\t\t\t\tawait mcp.connect(transport);\n\t\t\t\tthis.mcpMap.set(name, mcp);\n\n\t\t\t\tconst toolsResult = await mcp.listTools();\n\t\t\t\tthis.tools.push(\n\t\t\t\t\t...toolsResult.tools.map((tool) => {\n\t\t\t\t\t\treturn new MCPTool(name, tool);\n\t\t\t\t\t}),\n\t\t\t\t);\n\t\t\t}\n\t\t\tloggers.mcp.info(\"Connected to MCP server with tools:\", {\n\t\t\t\ttools: this.tools.map((tool) => tool.id),\n\t\t\t});\n\t\t} catch (error: unknown) {\n\t\t\tloggers.mcp.error(\"Failed to connect to MCP server:\", { error });\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\t/**\n\t * Returns all available tools from connected MCP servers.\n\t *\n\t * @returns Array of MCPTool instances representing available tools\n\t */\n\tgetTools() {\n\t\treturn this.tools;\n\t}\n\n\t/**\n\t * Executes a tool on its corresponding MCP server.\n\t *\n\t * @param tool - The MCPTool instance to execute\n\t * @param _args - Arguments to pass to the tool\n\t * @returns Promise resolving to the tool's execution result\n\t * @throws Error if the MCP server for the tool is not found\n\t */\n\tasync useTool(tool: MCPTool, _args?: any): Promise<string> {\n\t\tconst { serverName, mcpTool } = tool;\n\t\tconst toolName = mcpTool.name;\n\t\tconst mcp = this.mcpMap.get(serverName);\n\n\t\ttry {\n\t\t\tif (!mcp) {\n\t\t\t\tthrow new Error(`Invalid MCP Tool ${serverName}-${mcpTool.name}`);\n\t\t\t}\n\n\t\t\tconst result = await mcp.callTool({\n\t\t\t\tname: toolName,\n\t\t\t\targuments: _args,\n\t\t\t});\n\t\t\tconst toolResult =\n\t\t\t\t`[Bot Called Tool ${toolName} with args ${JSON.stringify(_args)}]\\n` +\n\t\t\t\tJSON.stringify(result.content, null, 2);\n\t\t\treturn toolResult;\n\t\t} catch (error) {\n\t\t\tloggers.mcp.error(\"Failed to call tool\", { error });\n\t\t\tconst toolResult = `[Bot Called Tool ${toolName} with args ${JSON.stringify(_args)}]\\n${typeof error === \"string\" ? error : JSON.stringify(error, null, 2)}`;\n\t\t\treturn toolResult;\n\t\t}\n\t}\n\n\t/**\n\t * Closes all MCP client connections.\n\t *\n\t * Should be called when shutting down the application to ensure\n\t * all MCP connections are properly closed.\n\t */\n\tasync cleanup() {\n\t\tthis.mcpMap.forEach((mcp: Client) => {\n\t\t\tmcp.close();\n\t\t});\n\t}\n}\n"]}
@@ -0,0 +1,162 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
2
+
3
+ var _chunk466ED5WNcjs = require('./chunk-466ED5WN.cjs');
4
+
5
+ // src/services/query.service.ts
6
+ var QueryService = class {
7
+
8
+
9
+
10
+
11
+
12
+ constructor(modelModule, a2aModule, mcpModule, memoryModule, prompts) {
13
+ this.modelModule = modelModule;
14
+ this.a2aModule = a2aModule;
15
+ this.mcpModule = mcpModule;
16
+ this.memoryModule = memoryModule;
17
+ this.prompts = prompts;
18
+ }
19
+ /**
20
+ * Detects the intent from a user query.
21
+ *
22
+ * @param query - The user's input query
23
+ * @returns The detected intent (currently returns the query as-is)
24
+ * @todo Implement actual intent detection logic
25
+ */
26
+ async intentTriggering(query) {
27
+ return query;
28
+ }
29
+ /**
30
+ * Fulfills the detected intent by generating a response.
31
+ *
32
+ * Manages the complete inference loop including:
33
+ * - Loading prompts and conversation history
34
+ * - Collecting available tools from modules
35
+ * - Executing model inference with tool support
36
+ * - Processing tool calls iteratively until completion
37
+ *
38
+ * @param query - The user's input query
39
+ * @param sessionId - Session identifier for context
40
+ * @param sessionHistory - Previous conversation history
41
+ * @returns Object containing process steps and final response
42
+ */
43
+ async intentFulfilling(query, sessionId, sessionHistory) {
44
+ const systemPrompt = `
45
+ Today is ${(/* @__PURE__ */ new Date()).toLocaleDateString()}.
46
+
47
+ ${_optionalChain([this, 'access', _ => _.prompts, 'optionalAccess', _2 => _2.agent]) || ""}
48
+
49
+ ${_optionalChain([this, 'access', _3 => _3.prompts, 'optionalAccess', _4 => _4.system]) || ""}
50
+ `;
51
+ const modelInstance = this.modelModule.getModel();
52
+ const messages = modelInstance.generateMessages({
53
+ query,
54
+ sessionHistory,
55
+ systemPrompt: systemPrompt.trim()
56
+ });
57
+ const tools = [];
58
+ if (this.mcpModule) {
59
+ tools.push(...this.mcpModule.getTools());
60
+ }
61
+ if (this.a2aModule) {
62
+ tools.push(...await this.a2aModule.getTools());
63
+ }
64
+ const functions = modelInstance.convertToolsToFunctions(tools);
65
+ const processList = [];
66
+ let finalMessage = "";
67
+ let didCallTool = false;
68
+ while (true) {
69
+ const response = await modelInstance.fetchWithContextMessage(
70
+ messages,
71
+ functions
72
+ );
73
+ didCallTool = false;
74
+ _chunk466ED5WNcjs.loggers.intent.debug("messages", { messages });
75
+ const { content, toolCalls } = response;
76
+ _chunk466ED5WNcjs.loggers.intent.debug("content", { content });
77
+ _chunk466ED5WNcjs.loggers.intent.debug("tool_calls", { ...toolCalls });
78
+ if (toolCalls) {
79
+ const messagePayload = _optionalChain([this, 'access', _5 => _5.a2aModule, 'optionalAccess', _6 => _6.getMessagePayload, 'call', _7 => _7(
80
+ query,
81
+ sessionId
82
+ )]);
83
+ for (const toolCall of toolCalls) {
84
+ const toolName = toolCall.name;
85
+ didCallTool = true;
86
+ const selectedTool = tools.filter((tool) => tool.id === toolName)[0];
87
+ let toolResult = "";
88
+ if (this.mcpModule && selectedTool.protocol === "MCP" /* MCP */) {
89
+ const toolArgs = toolCall.arguments;
90
+ _chunk466ED5WNcjs.loggers.intent.debug("MCP tool call", { toolName, toolArgs });
91
+ toolResult = await this.mcpModule.useTool(
92
+ selectedTool,
93
+ toolArgs
94
+ );
95
+ } else if (this.a2aModule && selectedTool.protocol === "A2A" /* A2A */) {
96
+ toolResult = await this.a2aModule.useTool(
97
+ selectedTool,
98
+ messagePayload,
99
+ sessionId
100
+ );
101
+ } else {
102
+ _chunk466ED5WNcjs.loggers.intent.warn(
103
+ `Unrecognized tool type: ${selectedTool.protocol}`
104
+ );
105
+ continue;
106
+ }
107
+ _chunk466ED5WNcjs.loggers.intent.debug("toolResult", { toolResult });
108
+ processList.push(toolResult);
109
+ modelInstance.appendMessages(messages, toolResult);
110
+ }
111
+ } else if (content) {
112
+ processList.push(content);
113
+ finalMessage = content;
114
+ }
115
+ if (!didCallTool) break;
116
+ }
117
+ const botResponse = {
118
+ process: processList.join("\n"),
119
+ response: finalMessage
120
+ };
121
+ return botResponse;
122
+ }
123
+ /**
124
+ * Main entry point for processing user queries.
125
+ *
126
+ * Handles the complete query lifecycle:
127
+ * 1. Loads session history from memory
128
+ * 2. Detects intent from the query
129
+ * 3. Fulfills the intent with AI response
130
+ * 4. Updates conversation history
131
+ *
132
+ * @param query - The user's input query
133
+ * @param sessionId - Unique session identifier
134
+ * @param userId - Unique user identifier
135
+ * @returns Object containing the AI-generated response
136
+ */
137
+ async handleQuery(query, sessionId, userId) {
138
+ const queryStartAt = Date.now();
139
+ const sessionMemory = _optionalChain([this, 'access', _8 => _8.memoryModule, 'optionalAccess', _9 => _9.getSessionMemory, 'call', _10 => _10()]);
140
+ const session = !userId ? void 0 : await _optionalChain([sessionMemory, 'optionalAccess', _11 => _11.getSession, 'call', _12 => _12(userId, sessionId)]);
141
+ const intent = this.intentTriggering(query);
142
+ const result = await this.intentFulfilling(query, sessionId, session);
143
+ if (userId) {
144
+ await _optionalChain([sessionMemory, 'optionalAccess', _13 => _13.addChatToSession, 'call', _14 => _14(userId, sessionId, {
145
+ role: "USER" /* USER */,
146
+ timestamp: queryStartAt,
147
+ content: { type: "text", parts: [query] }
148
+ })]);
149
+ await _optionalChain([sessionMemory, 'optionalAccess', _15 => _15.addChatToSession, 'call', _16 => _16(userId, sessionId, {
150
+ role: "MODEL" /* MODEL */,
151
+ timestamp: Date.now(),
152
+ content: { type: "text", parts: [result.response] }
153
+ })]);
154
+ }
155
+ return { content: result.response };
156
+ }
157
+ };
158
+
159
+
160
+
161
+ exports.QueryService = QueryService;
162
+ //# sourceMappingURL=chunk-DQP6RGIR.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/shyun/comcom/ain-agent/ain-adk/dist/cjs/chunk-DQP6RGIR.cjs","../../src/services/query.service.ts"],"names":[],"mappings":"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","file":"/Users/shyun/comcom/ain-agent/ain-adk/dist/cjs/chunk-DQP6RGIR.cjs","sourcesContent":[null,"import type {\n\tA2AModule,\n\tMCPModule,\n\tMemoryModule,\n\tModelModule,\n} from \"@/modules/index.js\";\nimport type { AinAgentPrompts } from \"@/types/agent.js\";\nimport { ChatRole, type SessionObject } from \"@/types/memory.js\";\nimport {\n\ttype IA2ATool,\n\ttype IAgentTool,\n\ttype IMCPTool,\n\tTOOL_PROTOCOL_TYPE,\n} from \"@/types/tool.js\";\nimport { loggers } from \"@/utils/logger.js\";\n\n/**\n * Service for processing user queries through the agent's AI pipeline.\n *\n * Orchestrates the query processing workflow including intent detection,\n * model inference, tool execution, and response generation. Manages\n * conversation context and coordinates between different modules.\n */\nexport class QueryService {\n\tprivate modelModule: ModelModule;\n\tprivate a2aModule?: A2AModule;\n\tprivate mcpModule?: MCPModule;\n\tprivate memoryModule?: MemoryModule;\n\tprivate prompts?: AinAgentPrompts;\n\n\tconstructor(\n\t\tmodelModule: ModelModule,\n\t\ta2aModule?: A2AModule,\n\t\tmcpModule?: MCPModule,\n\t\tmemoryModule?: MemoryModule,\n\t\tprompts?: AinAgentPrompts,\n\t) {\n\t\tthis.modelModule = modelModule;\n\t\tthis.a2aModule = a2aModule;\n\t\tthis.mcpModule = mcpModule;\n\t\tthis.memoryModule = memoryModule;\n\t\tthis.prompts = prompts;\n\t}\n\n\t/**\n\t * Detects the intent from a user query.\n\t *\n\t * @param query - The user's input query\n\t * @returns The detected intent (currently returns the query as-is)\n\t * @todo Implement actual intent detection logic\n\t */\n\tprivate async intentTriggering(query: string) {\n\t\t/* TODO */\n\t\treturn query;\n\t}\n\n\t/**\n\t * Fulfills the detected intent by generating a response.\n\t *\n\t * Manages the complete inference loop including:\n\t * - Loading prompts and conversation history\n\t * - Collecting available tools from modules\n\t * - Executing model inference with tool support\n\t * - Processing tool calls iteratively until completion\n\t *\n\t * @param query - The user's input query\n\t * @param sessionId - Session identifier for context\n\t * @param sessionHistory - Previous conversation history\n\t * @returns Object containing process steps and final response\n\t */\n\tprivate async intentFulfilling(\n\t\tquery: string,\n\t\tsessionId: string,\n\t\tsessionHistory?: SessionObject,\n\t) {\n\t\t// 1. Load agent / system prompt from memory\n\t\tconst systemPrompt = `\nToday is ${new Date().toLocaleDateString()}.\n\n${this.prompts?.agent || \"\"}\n\n${this.prompts?.system || \"\"}\n `;\n\n\t\tconst modelInstance = this.modelModule.getModel();\n\t\tconst messages = modelInstance.generateMessages({\n\t\t\tquery,\n\t\t\tsessionHistory,\n\t\t\tsystemPrompt: systemPrompt.trim(),\n\t\t});\n\n\t\tconst tools: IAgentTool[] = [];\n\t\tif (this.mcpModule) {\n\t\t\ttools.push(...this.mcpModule.getTools());\n\t\t}\n\t\tif (this.a2aModule) {\n\t\t\ttools.push(...(await this.a2aModule.getTools()));\n\t\t}\n\t\tconst functions = modelInstance.convertToolsToFunctions(tools);\n\n\t\tconst processList: string[] = [];\n\t\tlet finalMessage = \"\";\n\t\tlet didCallTool = false;\n\n\t\twhile (true) {\n\t\t\tconst response = await modelInstance.fetchWithContextMessage(\n\t\t\t\tmessages,\n\t\t\t\tfunctions,\n\t\t\t);\n\t\t\tdidCallTool = false;\n\n\t\t\tloggers.intent.debug(\"messages\", { messages });\n\n\t\t\tconst { content, toolCalls } = response;\n\n\t\t\tloggers.intent.debug(\"content\", { content });\n\t\t\tloggers.intent.debug(\"tool_calls\", { ...toolCalls });\n\n\t\t\tif (toolCalls) {\n\t\t\t\tconst messagePayload = this.a2aModule?.getMessagePayload(\n\t\t\t\t\tquery,\n\t\t\t\t\tsessionId,\n\t\t\t\t);\n\n\t\t\t\tfor (const toolCall of toolCalls) {\n\t\t\t\t\tconst toolName = toolCall.name;\n\t\t\t\t\tdidCallTool = true;\n\t\t\t\t\tconst selectedTool = tools.filter((tool) => tool.id === toolName)[0];\n\n\t\t\t\t\tlet toolResult = \"\";\n\t\t\t\t\tif (\n\t\t\t\t\t\tthis.mcpModule &&\n\t\t\t\t\t\tselectedTool.protocol === TOOL_PROTOCOL_TYPE.MCP\n\t\t\t\t\t) {\n\t\t\t\t\t\tconst toolArgs = toolCall.arguments as\n\t\t\t\t\t\t\t| { [x: string]: unknown }\n\t\t\t\t\t\t\t| undefined;\n\t\t\t\t\t\tloggers.intent.debug(\"MCP tool call\", { toolName, toolArgs });\n\t\t\t\t\t\ttoolResult = await this.mcpModule.useTool(\n\t\t\t\t\t\t\tselectedTool as IMCPTool,\n\t\t\t\t\t\t\ttoolArgs,\n\t\t\t\t\t\t);\n\t\t\t\t\t} else if (\n\t\t\t\t\t\tthis.a2aModule &&\n\t\t\t\t\t\tselectedTool.protocol === TOOL_PROTOCOL_TYPE.A2A\n\t\t\t\t\t) {\n\t\t\t\t\t\ttoolResult = await this.a2aModule.useTool(\n\t\t\t\t\t\t\tselectedTool as IA2ATool,\n\t\t\t\t\t\t\tmessagePayload!,\n\t\t\t\t\t\t\tsessionId,\n\t\t\t\t\t\t);\n\t\t\t\t\t} else {\n\t\t\t\t\t\t// Unrecognized tool type. It cannot be happened...\n\t\t\t\t\t\tloggers.intent.warn(\n\t\t\t\t\t\t\t`Unrecognized tool type: ${selectedTool.protocol}`,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tloggers.intent.debug(\"toolResult\", { toolResult });\n\n\t\t\t\t\tprocessList.push(toolResult);\n\t\t\t\t\tmodelInstance.appendMessages(messages, toolResult);\n\t\t\t\t}\n\t\t\t} else if (content) {\n\t\t\t\tprocessList.push(content);\n\t\t\t\tfinalMessage = content;\n\t\t\t}\n\n\t\t\tif (!didCallTool) break;\n\t\t}\n\n\t\tconst botResponse = {\n\t\t\tprocess: processList.join(\"\\n\"),\n\t\t\tresponse: finalMessage,\n\t\t};\n\n\t\treturn botResponse;\n\t}\n\n\t/**\n\t * Main entry point for processing user queries.\n\t *\n\t * Handles the complete query lifecycle:\n\t * 1. Loads session history from memory\n\t * 2. Detects intent from the query\n\t * 3. Fulfills the intent with AI response\n\t * 4. Updates conversation history\n\t *\n\t * @param query - The user's input query\n\t * @param sessionId - Unique session identifier\n\t * @param userId - Unique user identifier\n\t * @returns Object containing the AI-generated response\n\t */\n\tpublic async handleQuery(query: string, sessionId: string, userId?: string) {\n\t\t// 1. Load session history with sessionId\n\t\tconst queryStartAt = Date.now();\n\t\tconst sessionMemory = this.memoryModule?.getSessionMemory();\n\t\tconst session = !userId\n\t\t\t? undefined\n\t\t\t: await sessionMemory?.getSession(userId, sessionId);\n\n\t\t// 2. intent triggering\n\t\tconst intent = this.intentTriggering(query);\n\n\t\t// 3. intent fulfillment\n\t\tconst result = await this.intentFulfilling(query, sessionId, session);\n\t\tif (userId) {\n\t\t\tawait sessionMemory?.addChatToSession(userId, sessionId, {\n\t\t\t\trole: ChatRole.USER,\n\t\t\t\ttimestamp: queryStartAt,\n\t\t\t\tcontent: { type: \"text\", parts: [query] },\n\t\t\t});\n\t\t\tawait sessionMemory?.addChatToSession(userId, sessionId, {\n\t\t\t\trole: ChatRole.MODEL,\n\t\t\t\ttimestamp: Date.now(),\n\t\t\t\tcontent: { type: \"text\", parts: [result.response] },\n\t\t\t});\n\t\t}\n\n\t\treturn { content: result.response };\n\t}\n}\n"]}
@@ -0,0 +1,172 @@
1
+ "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class;
2
+
3
+ var _chunkF7I4G6JGcjs = require('./chunk-F7I4G6JG.cjs');
4
+
5
+
6
+ var _chunk466ED5WNcjs = require('./chunk-466ED5WN.cjs');
7
+
8
+ // src/modules/a2a/a2a.module.ts
9
+ var _crypto = require('crypto');
10
+ var _client = require('@a2a-js/sdk/client');
11
+ var A2AModule = (_class = class {constructor() { _class.prototype.__init.call(this);_class.prototype.__init2.call(this);_class.prototype.__init3.call(this); }
12
+ /** Map of A2A server URLs to their corresponding tool instances */
13
+ __init() {this.a2aPeerServers = /* @__PURE__ */ new Map()}
14
+ /** Map of session IDs to their A2A session state */
15
+ __init2() {this.a2aSessions = /* @__PURE__ */ new Map()}
16
+ /**
17
+ * Registers a new A2A peer server URL for connection.
18
+ *
19
+ * @param url - The URL of the A2A-compatible agent to connect to
20
+ */
21
+ async addA2APeerServer(url) {
22
+ this.a2aPeerServers.set(url, null);
23
+ }
24
+ /**
25
+ * Retrieves tools from all registered A2A peer servers.
26
+ *
27
+ * Attempts to connect to each registered server, fetch their agent cards,
28
+ * and create tool instances. Disables tools for unreachable servers.
29
+ *
30
+ * @returns Promise resolving to array of available A2A tools
31
+ */
32
+ async getTools() {
33
+ const tools = [];
34
+ for (const url of [...this.a2aPeerServers.keys()]) {
35
+ const tool = this.a2aPeerServers.get(url);
36
+ if (!tool || !tool.enabled) {
37
+ try {
38
+ const client = new (0, _client.A2AClient)(url);
39
+ const card = await client.getAgentCard();
40
+ const toolName = card.name.replaceAll(" ", "-");
41
+ const a2aTool = new (0, _chunkF7I4G6JGcjs.A2ATool)(toolName, client, card);
42
+ tools.push(a2aTool);
43
+ } catch (_error) {
44
+ if (tool) {
45
+ tool.disable();
46
+ }
47
+ }
48
+ } else {
49
+ tools.push(tool);
50
+ }
51
+ }
52
+ return tools;
53
+ }
54
+ /**
55
+ * Gets or creates an A2A session for the given session ID.
56
+ *
57
+ * @param sessionId - The session identifier
58
+ * @returns A2ASession object with task and context IDs
59
+ */
60
+ __init3() {this.getA2ASessionWithId = (sessionId) => {
61
+ const a2aSession = _nullishCoalesce(this.a2aSessions.get(sessionId), () => ( {
62
+ taskId: void 0,
63
+ contextId: void 0
64
+ }));
65
+ if (!this.a2aSessions.has(sessionId)) {
66
+ this.a2aSessions.set(sessionId, a2aSession);
67
+ }
68
+ return a2aSession;
69
+ }}
70
+ /**
71
+ * Constructs a message payload for A2A communication.
72
+ *
73
+ * Includes session context (task ID and context ID) if available
74
+ * for maintaining conversation continuity.
75
+ *
76
+ * @param query - The message content to send
77
+ * @param sessionId - The session identifier
78
+ * @returns Formatted Message object for A2A protocol
79
+ */
80
+ getMessagePayload(query, sessionId) {
81
+ const messagePayload = {
82
+ messageId: _crypto.randomUUID.call(void 0, ),
83
+ kind: "message",
84
+ role: "user",
85
+ // FIXME: it could be 'agent'
86
+ metadata: {
87
+ sessionId
88
+ },
89
+ parts: [
90
+ {
91
+ kind: "text",
92
+ text: query
93
+ }
94
+ ]
95
+ };
96
+ const a2aSession = this.getA2ASessionWithId(sessionId);
97
+ if (a2aSession.taskId) {
98
+ messagePayload.taskId = a2aSession.taskId;
99
+ }
100
+ if (a2aSession.contextId) {
101
+ messagePayload.contextId = a2aSession.contextId;
102
+ }
103
+ return messagePayload;
104
+ }
105
+ /**
106
+ * Executes an A2A tool by sending a message to the remote agent.
107
+ *
108
+ * Handles streaming responses, maintains session state, and extracts
109
+ * text content from various event types in the response stream.
110
+ *
111
+ * @param tool - The A2ATool instance to use
112
+ * @param messagePayload - The message to send to the agent
113
+ * @param sessionId - The session identifier for context tracking
114
+ * @returns Promise resolving to array of text responses from the agent
115
+ */
116
+ async useTool(tool, messagePayload, sessionId) {
117
+ const finalText = [];
118
+ const client = tool.client;
119
+ const params = {
120
+ message: messagePayload
121
+ };
122
+ const a2aSession = this.getA2ASessionWithId(sessionId);
123
+ try {
124
+ const stream = client.sendMessageStream(params);
125
+ for await (const event of stream) {
126
+ if (event.kind === "status-update") {
127
+ const typedEvent = event;
128
+ if (typedEvent.final && typedEvent.status.state !== "input-required") {
129
+ a2aSession.taskId = void 0;
130
+ }
131
+ const texts = _optionalChain([typedEvent, 'access', _ => _.status, 'access', _2 => _2.message, 'optionalAccess', _3 => _3.parts, 'access', _4 => _4.filter, 'call', _5 => _5((part) => part.kind === "text"), 'access', _6 => _6.map, 'call', _7 => _7((part) => part.text), 'access', _8 => _8.join, 'call', _9 => _9("\n")]);
132
+ if (texts) {
133
+ finalText.push(texts);
134
+ }
135
+ } else if (event.kind === "message") {
136
+ const msg = event;
137
+ if (msg.taskId && msg.taskId !== a2aSession.taskId) {
138
+ a2aSession.taskId = msg.taskId;
139
+ }
140
+ if (msg.contextId && msg.contextId !== a2aSession.contextId) {
141
+ a2aSession.contextId = msg.contextId;
142
+ }
143
+ } else if (event.kind === "task") {
144
+ const task = event;
145
+ if (task.id !== a2aSession.taskId) {
146
+ a2aSession.taskId = task.id;
147
+ }
148
+ if (task.contextId && task.contextId !== a2aSession.contextId) {
149
+ a2aSession.contextId = task.contextId;
150
+ }
151
+ } else {
152
+ _chunk466ED5WNcjs.loggers.a2a.warn("Received unknown event structure from stream:", {
153
+ event
154
+ });
155
+ }
156
+ }
157
+ } catch (error) {
158
+ _chunk466ED5WNcjs.loggers.a2a.error("Error communicating with agent:", { error });
159
+ tool.disable();
160
+ const toolResult = `[Bot Called A2A Tool ${tool.card.name}]
161
+ ${typeof error === "string" ? error : JSON.stringify(error, null, 2)}`;
162
+ return toolResult;
163
+ }
164
+ return `[Bot Called A2A Tool ${tool.card.name}]
165
+ ${finalText.join("\n")}`;
166
+ }
167
+ }, _class);
168
+
169
+
170
+
171
+ exports.A2AModule = A2AModule;
172
+ //# sourceMappingURL=chunk-FWFEVDEY.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["/Users/shyun/comcom/ain-agent/ain-adk/dist/cjs/chunk-FWFEVDEY.cjs","../../src/modules/a2a/a2a.module.ts"],"names":[],"mappings":"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","file":"/Users/shyun/comcom/ain-agent/ain-adk/dist/cjs/chunk-FWFEVDEY.cjs","sourcesContent":[null,"import { randomUUID } from \"node:crypto\";\nimport type {\n\tAgentCard,\n\tMessage,\n\tMessageSendParams,\n\tTask,\n\tTaskStatusUpdateEvent,\n\tTextPart,\n} from \"@a2a-js/sdk\";\nimport { A2AClient } from \"@a2a-js/sdk/client\";\nimport { loggers } from \"@/utils/logger.js\";\nimport { A2ATool } from \"./a2a.tool.js\";\n\n/**\n * Represents an active A2A communication session.\n */\ninterface A2ASession {\n\t/** Current task ID for multi-turn conversations */\n\ttaskId: string | undefined;\n\t/** Context ID for maintaining conversation state */\n\tcontextId: string | undefined;\n}\n\n/**\n * Module for managing Agent-to-Agent (A2A) protocol connections.\n *\n * This module handles connections to other A2A-compatible agents, manages\n * conversation sessions, and provides an interface for inter-agent communication.\n * Supports multi-turn conversations with task and context tracking.\n *\n * @example\n * ```typescript\n * const a2aModule = new A2AModule();\n * await a2aModule.addA2APeerServer(\"https://api.example.com/agent\");\n *\n * const tools = await a2aModule.getTools();\n * const message = a2aModule.getMessagePayload(\"Hello\", \"session-123\");\n * const response = await a2aModule.useTool(tools[0], message, \"session-123\");\n * ```\n */\nexport class A2AModule {\n\t/** Map of A2A server URLs to their corresponding tool instances */\n\tprivate a2aPeerServers: Map<string, A2ATool | null> = new Map();\n\t/** Map of session IDs to their A2A session state */\n\tprivate a2aSessions: Map<string, A2ASession> = new Map();\n\n\t/**\n\t * Registers a new A2A peer server URL for connection.\n\t *\n\t * @param url - The URL of the A2A-compatible agent to connect to\n\t */\n\tpublic async addA2APeerServer(url: string): Promise<void> {\n\t\tthis.a2aPeerServers.set(url, null);\n\t}\n\n\t/**\n\t * Retrieves tools from all registered A2A peer servers.\n\t *\n\t * Attempts to connect to each registered server, fetch their agent cards,\n\t * and create tool instances. Disables tools for unreachable servers.\n\t *\n\t * @returns Promise resolving to array of available A2A tools\n\t */\n\tpublic async getTools(): Promise<A2ATool[]> {\n\t\tconst tools: A2ATool[] = [];\n\t\tfor (const url of [...this.a2aPeerServers.keys()]) {\n\t\t\tconst tool = this.a2aPeerServers.get(url);\n\t\t\tif (!tool || !tool.enabled) {\n\t\t\t\ttry {\n\t\t\t\t\tconst client = new A2AClient(url);\n\t\t\t\t\tconst card: AgentCard = await client.getAgentCard();\n\t\t\t\t\tconst toolName = card.name.replaceAll(\" \", \"-\");\n\t\t\t\t\tconst a2aTool = new A2ATool(toolName, client, card);\n\n\t\t\t\t\ttools.push(a2aTool);\n\t\t\t\t} catch (_error: any) {\n\t\t\t\t\t// Agent not responded\n\t\t\t\t\tif (tool) {\n\t\t\t\t\t\ttool.disable();\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\ttools.push(tool);\n\t\t\t}\n\t\t}\n\t\treturn tools;\n\t}\n\n\t/**\n\t * Gets or creates an A2A session for the given session ID.\n\t *\n\t * @param sessionId - The session identifier\n\t * @returns A2ASession object with task and context IDs\n\t */\n\tprivate getA2ASessionWithId = (sessionId: string): A2ASession => {\n\t\tconst a2aSession = this.a2aSessions.get(sessionId) ?? {\n\t\t\ttaskId: undefined,\n\t\t\tcontextId: undefined,\n\t\t};\n\t\tif (!this.a2aSessions.has(sessionId)) {\n\t\t\tthis.a2aSessions.set(sessionId, a2aSession);\n\t\t}\n\n\t\treturn a2aSession;\n\t};\n\n\t/**\n\t * Constructs a message payload for A2A communication.\n\t *\n\t * Includes session context (task ID and context ID) if available\n\t * for maintaining conversation continuity.\n\t *\n\t * @param query - The message content to send\n\t * @param sessionId - The session identifier\n\t * @returns Formatted Message object for A2A protocol\n\t */\n\tpublic getMessagePayload(query: string, sessionId: string): Message {\n\t\tconst messagePayload: Message = {\n\t\t\tmessageId: randomUUID(),\n\t\t\tkind: \"message\",\n\t\t\trole: \"user\", // FIXME: it could be 'agent'\n\t\t\tmetadata: {\n\t\t\t\tsessionId,\n\t\t\t},\n\t\t\tparts: [\n\t\t\t\t{\n\t\t\t\t\tkind: \"text\",\n\t\t\t\t\ttext: query,\n\t\t\t\t},\n\t\t\t],\n\t\t};\n\n\t\tconst a2aSession = this.getA2ASessionWithId(sessionId);\n\t\tif (a2aSession.taskId) {\n\t\t\tmessagePayload.taskId = a2aSession.taskId;\n\t\t}\n\t\tif (a2aSession.contextId) {\n\t\t\tmessagePayload.contextId = a2aSession.contextId;\n\t\t}\n\n\t\treturn messagePayload;\n\t}\n\n\t/**\n\t * Executes an A2A tool by sending a message to the remote agent.\n\t *\n\t * Handles streaming responses, maintains session state, and extracts\n\t * text content from various event types in the response stream.\n\t *\n\t * @param tool - The A2ATool instance to use\n\t * @param messagePayload - The message to send to the agent\n\t * @param sessionId - The session identifier for context tracking\n\t * @returns Promise resolving to array of text responses from the agent\n\t */\n\tpublic async useTool(\n\t\ttool: A2ATool,\n\t\tmessagePayload: Message,\n\t\tsessionId: string,\n\t): Promise<string> {\n\t\tconst finalText: string[] = [];\n\t\tconst client = tool.client;\n\t\tconst params: MessageSendParams = {\n\t\t\tmessage: messagePayload,\n\t\t};\n\t\tconst a2aSession = this.getA2ASessionWithId(sessionId);\n\n\t\ttry {\n\t\t\tconst stream = client.sendMessageStream(params);\n\t\t\tfor await (const event of stream) {\n\t\t\t\tif (event.kind === \"status-update\") {\n\t\t\t\t\tconst typedEvent = event as TaskStatusUpdateEvent;\n\t\t\t\t\tif (\n\t\t\t\t\t\ttypedEvent.final &&\n\t\t\t\t\t\ttypedEvent.status.state !== \"input-required\"\n\t\t\t\t\t) {\n\t\t\t\t\t\ta2aSession.taskId = undefined;\n\t\t\t\t\t}\n\t\t\t\t\t// TODO: handle 'file', 'data' parts\n\t\t\t\t\tconst texts = typedEvent.status.message?.parts\n\t\t\t\t\t\t.filter((part) => part.kind === \"text\")\n\t\t\t\t\t\t.map((part: TextPart) => part.text)\n\t\t\t\t\t\t.join(\"\\n\");\n\t\t\t\t\tif (texts) {\n\t\t\t\t\t\tfinalText.push(texts);\n\t\t\t\t\t}\n\t\t\t\t} else if (event.kind === \"message\") {\n\t\t\t\t\t// FIXME: handling text in 'message'?\n\t\t\t\t\tconst msg = event as Message;\n\t\t\t\t\tif (msg.taskId && msg.taskId !== a2aSession.taskId) {\n\t\t\t\t\t\ta2aSession.taskId = msg.taskId;\n\t\t\t\t\t}\n\t\t\t\t\tif (msg.contextId && msg.contextId !== a2aSession.contextId) {\n\t\t\t\t\t\ta2aSession.contextId = msg.contextId;\n\t\t\t\t\t}\n\t\t\t\t} else if (event.kind === \"task\") {\n\t\t\t\t\t// FIXME: handling text in 'task'?\n\t\t\t\t\tconst task = event as Task;\n\t\t\t\t\tif (task.id !== a2aSession.taskId) {\n\t\t\t\t\t\ta2aSession.taskId = task.id;\n\t\t\t\t\t}\n\t\t\t\t\tif (task.contextId && task.contextId !== a2aSession.contextId) {\n\t\t\t\t\t\ta2aSession.contextId = task.contextId;\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tloggers.a2a.warn(\"Received unknown event structure from stream:\", {\n\t\t\t\t\t\tevent,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tloggers.a2a.error(\"Error communicating with agent:\", { error });\n\t\t\ttool.disable();\n\t\t\tconst toolResult = `[Bot Called A2A Tool ${tool.card.name}]\\n${typeof error === \"string\" ? error : JSON.stringify(error, null, 2)}`;\n\t\t\treturn toolResult;\n\t\t}\n\n\t\treturn `[Bot Called A2A Tool ${tool.card.name}]\\n${finalText.join(\"\\n\")}`;\n\t}\n}\n"]}