@ainetwork/adk 0.4.1 → 0.5.1

package/dist/cjs/chunk-KGSFW2NW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/shyun/comcom/ain-agent/ain-adk-v0/dist/cjs/chunk-KGSFW2NW.cjs","../../src/container/index.ts"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B;AACA;ACKA,IAAM,UAAA,EAAN,MAAgB;AAAA,EACP;AAAA,EACA;AAAA,EAER,WAAA,CAAA,EAAc;AACb,IAAA,IAAA,CAAK,UAAA,EAAY,IAAI,uCAAA,CAAiB,CAAA;AACtC,IAAA,IAAA,CAAK,aAAA,EAAe,IAAI,0CAAA,CAAoB,IAAA,CAAK,SAAS,CAAA;AAAA,EAC3D;AAAA;AAAA,EAGA,IAAI,QAAA,CAAA,EAA6B;AAChC,IAAA,OAAO,IAAA,CAAK,SAAA;AAAA,EACb;AAAA;AAAA,EAGA,IAAI,WAAA,CAAA,EAAmC;AACtC,IAAA,OAAO,IAAA,CAAK,YAAA;AAAA,EACb;AAAA;AAAA,EAGA,gBAAA,CAAA,EAAmB;AAClB,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,gBAAA,CAAiB,CAAA;AAAA,EACxC;AAAA,EACA,uBAAA,CAAA,EAA0B;AACzB,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,uBAAA,CAAwB,CAAA;AAAA,EAC/C;AAAA,EACA,uBAAA,CAAA,EAA0B;AACzB,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,uBAAA,CAAwB,CAAA;AAAA,EAC/C;AAAA,EACA,eAAA,CAAA,EAAkB;AACjB,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,eAAA,CAAgB,CAAA;AAAA,EACvC;AAAA,EACA,aAAA,CAAA,EAAgB;AACf,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,aAAA,CAAc,CAAA;AAAA,EACrC;AAAA,EACA,sBAAA,CAAA,EAAyB;AACxB,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,sBAAA,CAAuB,CAAA;AAAA,EAC9C;AAAA,EACA,mBAAA,CAAA,EAAsB;AACrB,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,mBAAA,CAAoB,CAAA;AAAA,EAC3C;AAAA,EAEA,kBAAA,CAAA,EAAqB;AACpB,IAAA,OAAO,IAAA,CAAK,YAAA,CAAa,kBAAA,CAAmB,CAAA;AAAA,EAC7C;AAAA,EACA,mBAAA,CAAA,EAAsB;AACrB,IAAA,OAAO,IAAA,CAAK,YAAA,CAAa,mBAAA,CAAoB,CAAA;AAAA,EAC9C;AAAA,EACA,qBAAA,CAAA,EAAwB;AACvB,IAAA,OAAO,IAAA,CAAK,YAAA,CAAa,qBAAA,CAAsB,CAAA;AAAA,EAChD;AAAA,EACA,qBAAA,CAAA,EAAwB;AACvB,IAAA,OAAO,IAAA,CAAK,YAAA,CAAa,qBAAA,CAAsB,CAAA;AAAA,EAChD;AAAA,EACA,sBAAA,CAAA,EAAyB;AACxB,IAAA,OAAO,IAAA,CAAK,YAAA,CAAa,sBAAA,CAAuB,CAAA;AAAA,EACjD;AAAA,EACA,sBAAA,CAAA,EAAyB;AACxB,IAAA,OAAO,IAAA,CAAK,YAAA,CAAa,sBAAA,CAAuB,CAAA;AAAA,EACjD;AAAA,EACA,gCAAA,CAAA,EAAmC;AAClC,IAAA,OAAO,IAAA,CAAK,YAAA,CAAa,gCAAA,CAAiC,CAAA;AAAA,EAC3D;AAAA,EACA,4BAAA,CAAA,EAA+B;AAC9B,IAAA,OAAO,IAAA,CAAK,YAAA,CAAa,4BAAA,CAA6B,CAAA;AAAA,EACvD;AAAA;AAAA;AAAA;AAAA,EAKA,KAAA,CAAA,EAAc;AACb,IAAA,IAAA,CAAK,SAAA,CAAU,KAAA,CAAM,CAAA;AACrB,IAAA,IAAA,CAAK,YAAA,CAAa,KAAA,CAAM,CAAA;AAAA,EACzB;AACD,CAAA;AAGO,IAAM,UAAA,EAAY,IAAI,SAAA,CAAU,CAAA;ADXvC;AACA;AACE;AACF,8BAAC","file":"/Users/shyun/comcom/ain-agent/ain-adk-v0/dist/cjs/chunk-KGSFW2NW.cjs","sourcesContent":[null,"import { ControllerContainer } from \"./controllers\";\nimport { ServiceContainer } from \"./services\";\n\n/**\n * Dependency Injection Container\n *\n * Provides singleton instances of services and controllers with proper dependency injection.\n * Benefits:\n * - Services maintain DI pattern (testable with mocks)\n * - Routes use clean, simple API\n * - Dependencies are explicit and traceable\n */\nclass Container {\n\tprivate _services: ServiceContainer;\n\tprivate _controllers: ControllerContainer;\n\n\tconstructor() {\n\t\tthis._services = new ServiceContainer();\n\t\tthis._controllers = new ControllerContainer(this._services);\n\t}\n\n\t// Services\n\tget services(): ServiceContainer {\n\t\treturn this._services;\n\t}\n\n\t// Controllers\n\tget controllers(): ControllerContainer {\n\t\treturn this._controllers;\n\t}\n\n\t// Convenience methods for direct access\n\tgetThreadService() {\n\t\treturn this._services.getThreadService();\n\t}\n\tgetIntentTriggerService() {\n\t\treturn this._services.getIntentTriggerService();\n\t}\n\tgetIntentFulfillService() {\n\t\treturn this._services.getIntentFulfillService();\n\t}\n\tgetQueryService() {\n\t\treturn this._services.getQueryService();\n\t}\n\tgetA2AService() {\n\t\treturn this._services.getA2AService();\n\t}\n\tgetUserWorkflowService() {\n\t\treturn this._services.getUserWorkflowService();\n\t}\n\tgetSchedulerService() {\n\t\treturn this._services.getSchedulerService();\n\t}\n\n\tgetQueryController() {\n\t\treturn this._controllers.getQueryController();\n\t}\n\tgetIntentController() {\n\t\treturn this._controllers.getIntentController();\n\t}\n\tgetModelApiController() {\n\t\treturn this._controllers.getModelApiController();\n\t}\n\tgetAgentApiController() {\n\t\treturn this._controllers.getAgentApiController();\n\t}\n\tgetThreadApiController() {\n\t\treturn this._controllers.getThreadApiController();\n\t}\n\tgetIntentApiController() {\n\t\treturn this._controllers.getIntentApiController();\n\t}\n\tgetWorkflowTemplateApiController() {\n\t\treturn this._controllers.getWorkflowTemplateApiController();\n\t}\n\tgetUserWorkflowApiController() {\n\t\treturn this._controllers.getUserWorkflowApiController();\n\t}\n\n\t/**\n\t * Reset all instances (useful for testing)\n\t */\n\treset(): void {\n\t\tthis._services.reset();\n\t\tthis._controllers.reset();\n\t}\n}\n\n// Export singleton instance\nexport const container = new Container();\n\n// Export types for testing\nexport { ControllerContainer } from \"./controllers\";\nexport { ServiceContainer } from \"./services\";\n"]}

package/dist/cjs/chunk-KWKSHAQX.cjs

@@ -0,0 +1,18 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkIZZVA7UVcjs = require('./chunk-IZZVA7UV.cjs');
+
+// src/routes/query.routes.ts
+var _express = require('express');
+var createQueryRouter = () => {
+  const router = _express.Router.call(void 0, );
+  const queryController = _chunkIZZVA7UVcjs.container.getQueryController();
+  router.post("/", queryController.handleQueryRequest);
+  router.post("/stream", queryController.handleQueryStreamRequest);
+  return router;
+};
+
+
+
+exports.createQueryRouter = createQueryRouter;
+//# sourceMappingURL=chunk-KWKSHAQX.cjs.map

package/dist/cjs/chunk-KWKSHAQX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/shyun/comcom/ain-agent/ain-adk-v0/dist/cjs/chunk-KWKSHAQX.cjs","../../src/routes/query.routes.ts"],"names":[],"mappings":"AAAA;AACE;AACF,wDAA6B;AAC7B;AACA;ACJA,kCAAuB;AAGhB,IAAM,kBAAA,EAAoB,CAAA,EAAA,GAAc;AAC9C,EAAA,MAAM,OAAA,EAAS,6BAAA,CAAO;AAEtB,EAAA,MAAM,gBAAA,EAAkB,2BAAA,CAAU,kBAAA,CAAmB,CAAA;AAErD,EAAA,MAAA,CAAO,IAAA,CAAK,GAAA,EAAK,eAAA,CAAgB,kBAAkB,CAAA;AACnD,EAAA,MAAA,CAAO,IAAA,CAAK,SAAA,EAAW,eAAA,CAAgB,wBAAwB,CAAA;AAE/D,EAAA,OAAO,MAAA;AACR,CAAA;ADCA;AACA;AACE;AACF,8CAAC","file":"/Users/shyun/comcom/ain-agent/ain-adk-v0/dist/cjs/chunk-KWKSHAQX.cjs","sourcesContent":[null,"import { Router } from \"express\";\nimport { container } from \"@/container\";\n\nexport const createQueryRouter = (): Router => {\n\tconst router = Router();\n\n\tconst queryController = container.getQueryController();\n\n\trouter.post(\"/\", queryController.handleQueryRequest);\n\trouter.post(\"/stream\", queryController.handleQueryStreamRequest);\n\n\treturn router;\n};\n"]}

package/dist/cjs/chunk-L6RI7RO4.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/shyun/comcom/ain-agent/ain-adk/dist/cjs/chunk-L6RI7RO4.cjs","../../src/types/connector.ts"],"names":["CONNECTOR_PROTOCOL_TYPE"],"mappings":"AAAA;ACGO,IAAK,wBAAA,kBAAL,CAAA,CAAKA,wBAAAA,EAAAA,GAAL;AAEN,EAAAA,wBAAAA,CAAA,KAAA,EAAA,EAAM,KAAA;AAEN,EAAAA,wBAAAA,CAAA,KAAA,EAAA,EAAM,KAAA;AAJK,EAAA,OAAAA,wBAAAA;AAAA,CAAA,CAAA,CAAA,wBAAA,GAAA,CAAA,CAAA,CAAA;ADGZ;AACA;AACE;AACF,0DAAC","file":"/Users/shyun/comcom/ain-agent/ain-adk/dist/cjs/chunk-L6RI7RO4.cjs","sourcesContent":[null,"/**\n * Supported tool protocol types in the AIN-ADK framework.\n */\nexport enum CONNECTOR_PROTOCOL_TYPE {\n\t/** Agent-to-Agent protocol */\n\tA2A = \"A2A\",\n\t/** Model Context Protocol */\n\tMCP = \"MCP\",\n}\n\nexport type ConnectorTool = {\n\ttoolName: string;\n\tconnectorName: string;\n\tprotocol: CONNECTOR_PROTOCOL_TYPE;\n\tdescription?: string;\n\tinputSchema?: any;\n};\n\n/**\n * Represents a tool invocation request.\n */\nexport type ToolCall = {\n\t/** Name of the tool to invoke */\n\tname: string;\n\t/** Arguments to pass to the tool */\n\targuments?: Record<string, unknown>;\n};\n\n/**\n * Response from a model fetch operation.\n *\n * Contains either content (text response) or tool calls (function invocations),\n * or both in the case of mixed responses.\n */\nexport type FetchResponse = {\n\t/** Text content response from the model */\n\tcontent?: string;\n\t/** Array of tool calls requested by the model */\n\ttoolCalls?: ToolCall[];\n};\n\n/**\n * Base interface for all tools in the AIN-ADK framework.\n *\n * Provides a protocol-agnostic interface for tool management,\n * allowing tools from different sources (MCP, A2A) to be used\n * interchangeably throughout the system.\n *\n * @example\n * ```typescript\n * const tool: IAgentTool = {\n *   name: \"search-tool\",\n *   protocol: TOOL_PROTOCOL_TYPE.MCP,\n *   enabled: true,\n *   enable: () => { this.enabled = true; },\n *   disable: () => { this.enabled = false; }\n * };\n * ```\n */\nexport interface IAgentConnector {\n\t/** Unique identifier for the connector */\n\tname: string;\n\t/** Protocol type (MCP or A2A) */\n\tprotocol: CONNECTOR_PROTOCOL_TYPE;\n\t/** Whether the tool is currently enabled for use */\n\tenabled: boolean;\n\t/** Enables the tool for use */\n\tenable: () => void;\n\t/** Disables the tool from being used */\n\tdisable: () => void;\n}\n"]}
+{"version":3,"sources":["/Users/shyun/comcom/ain-agent/ain-adk-v0/dist/cjs/chunk-L6RI7RO4.cjs","../../src/types/connector.ts"],"names":["CONNECTOR_PROTOCOL_TYPE"],"mappings":"AAAA;ACGO,IAAK,wBAAA,kBAAL,CAAA,CAAKA,wBAAAA,EAAAA,GAAL;AAEN,EAAAA,wBAAAA,CAAA,KAAA,EAAA,EAAM,KAAA;AAEN,EAAAA,wBAAAA,CAAA,KAAA,EAAA,EAAM,KAAA;AAJK,EAAA,OAAAA,wBAAAA;AAAA,CAAA,CAAA,CAAA,wBAAA,GAAA,CAAA,CAAA,CAAA;ADGZ;AACA;AACE;AACF,0DAAC","file":"/Users/shyun/comcom/ain-agent/ain-adk-v0/dist/cjs/chunk-L6RI7RO4.cjs","sourcesContent":[null,"/**\n * Supported tool protocol types in the AIN-ADK framework.\n */\nexport enum CONNECTOR_PROTOCOL_TYPE {\n\t/** Agent-to-Agent protocol */\n\tA2A = \"A2A\",\n\t/** Model Context Protocol */\n\tMCP = \"MCP\",\n}\n\nexport type ConnectorTool = {\n\ttoolName: string;\n\tconnectorName: string;\n\tprotocol: CONNECTOR_PROTOCOL_TYPE;\n\tdescription?: string;\n\tinputSchema?: any;\n};\n\n/**\n * Represents a tool invocation request.\n */\nexport type ToolCall = {\n\t/** Name of the tool to invoke */\n\tname: string;\n\t/** Arguments to pass to the tool */\n\targuments?: Record<string, unknown>;\n};\n\n/**\n * Response from a model fetch operation.\n *\n * Contains either content (text response) or tool calls (function invocations),\n * or both in the case of mixed responses.\n */\nexport type FetchResponse = {\n\t/** Text content response from the model */\n\tcontent?: string;\n\t/** Array of tool calls requested by the model */\n\ttoolCalls?: ToolCall[];\n};\n\n/**\n * Base interface for all tools in the AIN-ADK framework.\n *\n * Provides a protocol-agnostic interface for tool management,\n * allowing tools from different sources (MCP, A2A) to be used\n * interchangeably throughout the system.\n *\n * @example\n * ```typescript\n * const tool: IAgentTool = {\n *   name: \"search-tool\",\n *   protocol: TOOL_PROTOCOL_TYPE.MCP,\n *   enabled: true,\n *   enable: () => { this.enabled = true; },\n *   disable: () => { this.enabled = false; }\n * };\n * ```\n */\nexport interface IAgentConnector {\n\t/** Unique identifier for the connector */\n\tname: string;\n\t/** Protocol type (MCP or A2A) */\n\tprotocol: CONNECTOR_PROTOCOL_TYPE;\n\t/** Whether the tool is currently enabled for use */\n\tenabled: boolean;\n\t/** Enables the tool for use */\n\tenable: () => void;\n\t/** Disables the tool from being used */\n\tdisable: () => void;\n}\n"]}

package/dist/cjs/chunk-L6VNJY2J.cjs

@@ -0,0 +1,380 @@
+"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; }
+
+var _chunk6HZDMDWTcjs = require('./chunk-6HZDMDWT.cjs');
+
+
+var _chunkRINANUYCcjs = require('./chunk-RINANUYC.cjs');
+
+
+var _chunk4VRDSSQUcjs = require('./chunk-4VRDSSQU.cjs');
+
+
+var _chunkO5X5QT63cjs = require('./chunk-O5X5QT63.cjs');
+
+
+var _chunk2CQQ34EDcjs = require('./chunk-2CQQ34ED.cjs');
+
+// src/services/intents/fulfill.service.ts
+var _crypto = require('crypto');
+var IntentFulfillService = class {
+  
+  
+  
+  
+  
+  
+  
+  constructor(modelModule, memoryModule, a2aModule, mcpModule, onIntentFallback, piiService) {
+    this.modelModule = modelModule;
+    this.memoryModule = memoryModule;
+    this.a2aModule = a2aModule;
+    this.mcpModule = mcpModule;
+    this.onIntentFallback = onIntentFallback;
+    this.aggregateService = new (0, _chunk4VRDSSQUcjs.AggregateService)(modelModule, memoryModule);
+    this.piiService = piiService;
+  }
+  async addToThreadMessages(thread, params) {
+    try {
+      const threadMemory = this.memoryModule.getThreadMemory();
+      const { userId, threadId } = thread;
+      const newMessage = {
+        messageId: _crypto.randomUUID.call(void 0, ),
+        role: params.role,
+        timestamp: Date.now(),
+        content: { type: "text", parts: [params.content] },
+        metadata: params.metadata
+      };
+      thread.messages.push(newMessage);
+      await _optionalChain([threadMemory, 'optionalAccess', _ => _.addMessagesToThread, 'call', _2 => _2(userId, threadId, [newMessage])]);
+    } catch (error) {
+      _chunk2CQQ34EDcjs.loggers.intentStream.error("Error adding message to thread", error);
+    }
+  }
+  /**
+   * Fulfills the detected intent by generating a streaming response.
+   *
+   * Manages the complete inference loop including:
+   * - Loading prompts and conversation history
+   * - Collecting available tools from modules
+   * - Executing model inference with tool support
+   * - Processing tool calls iteratively until completion
+   * - Streaming results as Server-Sent Events
+   *
+   * @param query - The user's input query
+   * @param threadId - Thread identifier for context
+   * @param thread - Previous conversation history
+   * @param intent - Optional detected intent with custom prompt
+   * @returns AsyncGenerator yielding StreamEvent objects
+   */
+  async *intentFulfilling(query, thread, intent) {
+    const prompt = await _chunkRINANUYCcjs.fulfill_default.call(void 0, this.memoryModule, intent);
+    const modelInstance = this.modelModule.getModel();
+    const modelOptions = this.modelModule.getModelOptions();
+    const messages = modelInstance.generateMessages({
+      query,
+      thread,
+      systemPrompt: prompt.trim()
+    });
+    _chunk2CQQ34EDcjs.loggers.intent.debug("Intent fulfillment start", {
+      threadId: thread.threadId,
+      messages
+    });
+    const tools = [];
+    const toolPrompt = await _chunk6HZDMDWTcjs.tool_select_default.call(void 0, this.memoryModule);
+    this.mcpModule && tools.push(...this.mcpModule.getTools(toolPrompt));
+    this.a2aModule && tools.push(...await this.a2aModule.getTools(toolPrompt));
+    const processList = [];
+    while (true) {
+      const functions = modelInstance.convertToolsToFunctions(tools);
+      const responseStream = await modelInstance.fetchStreamWithContextMessage(
+        messages,
+        functions,
+        modelOptions
+      );
+      const assembledToolCalls = [];
+      for await (const chunk of responseStream) {
+        const delta = chunk.delta;
+        if (_optionalChain([delta, 'optionalAccess', _3 => _3.tool_calls])) {
+          for (const { index, id, function: func } of delta.tool_calls) {
+            assembledToolCalls[index] ??= {
+              id: "",
+              type: "function",
+              function: { name: "", arguments: "" }
+            };
+            if (id) assembledToolCalls[index].id = id;
+            if (_optionalChain([func, 'optionalAccess', _4 => _4.name])) assembledToolCalls[index].function.name = func.name;
+            if (_optionalChain([func, 'optionalAccess', _5 => _5.arguments]))
+              assembledToolCalls[index].function.arguments += func.arguments;
+          }
+        } else if (_optionalChain([chunk, 'access', _6 => _6.delta, 'optionalAccess', _7 => _7.content])) {
+          yield {
+            event: "text_chunk",
+            data: { delta: chunk.delta.content }
+          };
+        }
+      }
+      _chunk2CQQ34EDcjs.loggers.intentStream.debug("assembledToolCalls", {
+        threadId: thread.threadId,
+        assembledToolCalls
+      });
+      if (assembledToolCalls.length > 0) {
+        for (const toolCall of assembledToolCalls) {
+          const toolName = toolCall.function.name;
+          let selectedTool;
+          for (const [index, toolTmp] of tools.entries()) {
+            if (toolTmp.toolName === toolName) {
+              if (toolTmp.protocol === "A2A" /* A2A */) {
+                selectedTool = tools.splice(index, 1)[0];
+                break;
+              }
+              selectedTool = toolTmp;
+            }
+          }
+          if (!selectedTool) {
+            continue;
+          }
+          const toolArgs = JSON.parse(toolCall.function.arguments);
+          const thinkData = {
+            title: `[${_chunkO5X5QT63cjs.getManifest.call(void 0, ).name}] ${selectedTool.protocol} \uC2E4\uD589: ${toolName}`,
+            description: `${toolArgs.thinking_text || ""}`
+          };
+          yield {
+            event: "thinking_process",
+            data: thinkData
+          };
+          let toolResult = "";
+          if (this.mcpModule && selectedTool.protocol === "MCP" /* MCP */) {
+            _chunk2CQQ34EDcjs.loggers.intent.info("MCP tool call", { toolName, toolArgs });
+            toolResult = await this.mcpModule.useTool(selectedTool, toolArgs);
+          } else if (this.a2aModule && selectedTool.protocol === "A2A" /* A2A */) {
+            _chunk2CQQ34EDcjs.loggers.intent.info("A2A tool call", { toolName });
+            const a2aStream = this.a2aModule.useTool(
+              selectedTool,
+              query,
+              thread.threadId
+            );
+            let result = await a2aStream.next();
+            while (!result.done) {
+              if (result.value.event === "thinking_process") {
+                yield result.value;
+              }
+              result = await a2aStream.next();
+            }
+            toolResult = result.value;
+          } else {
+            _chunk2CQQ34EDcjs.loggers.intent.warn(
+              `Unrecognized tool type: ${selectedTool.protocol}`
+            );
+            continue;
+          }
+          _chunk2CQQ34EDcjs.loggers.intent.debug("Tool Result", { toolResult });
+          processList.push(toolResult);
+          modelInstance.appendMessages(messages, toolResult);
+        }
+      } else {
+        break;
+      }
+    }
+    _chunk2CQQ34EDcjs.loggers.intent.debug("Intent fulfillment completed", {
+      threadId: thread.threadId,
+      toolCallsExecuted: processList.length,
+      intentName: _optionalChain([intent, 'optionalAccess', _8 => _8.name])
+    });
+  }
+  /**
+   * Returns the appropriate stream for a triggered intent.
+   * Uses fallback handler if no intent matched and fallback is configured.
+   */
+  getIntentStream(triggeredIntent, thread) {
+    const { subquery = "", intent } = triggeredIntent;
+    if (!intent && this.onIntentFallback) {
+      _chunk2CQQ34EDcjs.loggers.intent.info("No intent matched, calling fallback handler");
+      const fallbackStream = this.onIntentFallback({
+        triggeredIntent,
+        thread
+      });
+      if (fallbackStream !== void 0) {
+        return fallbackStream;
+      }
+    }
+    return this.intentFulfilling(subquery, thread, intent);
+  }
+  /**
+   * Processes all triggered intents and generates a unified response.
+   *
+   * Workflow:
+   * 1. Process each intent sequentially, collecting results
+   * 2. Yield thinking_process events for progress visibility
+   * 3. Use AggregateService to unify results if needsAggregation is true
+   * 4. Stream the final (possibly aggregated) response
+   *
+   * @param intents - Array of triggered intents to process
+   * @param thread - The thread history
+   * @param originalQuery - The user's original query (for aggregate context)
+   * @param needsAggregation - Whether the results need to be aggregated
+   * @returns AsyncGenerator yielding StreamEvent objects
+   */
+  async *intentFulfill(intents, thread, originalQuery, needsAggregation) {
+    const streamStartTime = Date.now();
+    _chunk2CQQ34EDcjs.loggers.intentStream.info("Stream session started", {
+      threadId: thread.threadId,
+      intentCount: intents.length,
+      needsAggregation,
+      startTime: new Date(streamStartTime).toISOString()
+    });
+    let finalResponseText = "";
+    let collectionName;
+    if (intents.length <= 1) {
+      const triggeredIntent = intents[0];
+      if (!triggeredIntent) {
+        return;
+      }
+      const { subquery = "", intent, actionPlan } = triggeredIntent;
+      _chunk2CQQ34EDcjs.loggers.intent.info(
+        `Process single intent: ${subquery}, ${_optionalChain([intent, 'optionalAccess', _9 => _9.name])}`
+      );
+      _chunk2CQQ34EDcjs.loggers.intent.info(`Action plan: ${actionPlan}`);
+      yield {
+        event: "thinking_process",
+        data: {
+          title: `[${_chunkO5X5QT63cjs.getManifest.call(void 0, ).name}] ${subquery}`,
+          description: actionPlan || ""
+        }
+      };
+      const stream = this.getIntentStream(triggeredIntent, thread);
+      if (!stream) {
+        return;
+      }
+      for await (const event of stream) {
+        if (event.event === "text_chunk" && event.data.delta) {
+          finalResponseText += event.data.delta;
+        } else if (event.event === "collection_name") {
+          collectionName = event.data.name;
+        }
+        yield event;
+      }
+    } else if (!needsAggregation) {
+      for (let i = 0; i < intents.length; i++) {
+        const triggeredIntent = intents[i];
+        const { subquery = "", intent, actionPlan } = triggeredIntent;
+        _chunk2CQQ34EDcjs.loggers.intent.info(`Process query: ${subquery}, ${_optionalChain([intent, 'optionalAccess', _10 => _10.name])}`);
+        _chunk2CQQ34EDcjs.loggers.intent.info(`Action plan: ${actionPlan}`);
+        const isLastIntent = i === intents.length - 1;
+        yield {
+          event: "thinking_process",
+          data: {
+            title: `[${_chunkO5X5QT63cjs.getManifest.call(void 0, ).name}] ${subquery}`,
+            description: actionPlan || ""
+          }
+        };
+        const stream = this.getIntentStream(triggeredIntent, thread);
+        if (!stream) {
+          continue;
+        }
+        if (isLastIntent) {
+          for await (const event of stream) {
+            if (event.event === "text_chunk" && event.data.delta) {
+              finalResponseText += event.data.delta;
+            } else if (event.event === "collection_name") {
+              collectionName = event.data.name;
+            }
+            yield event;
+          }
+        } else {
+          let responseText = "";
+          for await (const event of stream) {
+            if (event.event === "text_chunk" && event.data.delta) {
+              responseText += event.data.delta;
+            } else if (event.event === "collection_name") {
+              collectionName = event.data.name;
+            } else if (event.event === "thinking_process") {
+              yield event;
+            }
+          }
+          thread.messages.push({
+            messageId: _crypto.randomUUID.call(void 0, ),
+            role: "MODEL" /* MODEL */,
+            timestamp: Date.now(),
+            content: { type: "text", parts: [responseText] },
+            metadata: { isThinking: true }
+          });
+        }
+      }
+    } else {
+      const fulfillmentResults = [];
+      for (let i = 0; i < intents.length; i++) {
+        const triggeredIntent = intents[i];
+        const { subquery = "", intent, actionPlan } = triggeredIntent;
+        _chunk2CQQ34EDcjs.loggers.intent.info(`Process query: ${subquery}, ${_optionalChain([intent, 'optionalAccess', _11 => _11.name])}`);
+        _chunk2CQQ34EDcjs.loggers.intent.info(`Action plan: ${actionPlan}`);
+        if (fulfillmentResults.length > 0) {
+          const lastResult = fulfillmentResults[fulfillmentResults.length - 1];
+          thread.messages.push({
+            messageId: _crypto.randomUUID.call(void 0, ),
+            role: "MODEL" /* MODEL */,
+            timestamp: Date.now(),
+            content: { type: "text", parts: [lastResult.response] },
+            metadata: { isThinking: true }
+          });
+        }
+        yield {
+          event: "thinking_process",
+          data: {
+            title: `[${_chunkO5X5QT63cjs.getManifest.call(void 0, ).name}] ${subquery}`,
+            description: actionPlan || ""
+          }
+        };
+        const stream = this.getIntentStream(triggeredIntent, thread);
+        if (!stream) {
+          continue;
+        }
+        let responseText = "";
+        for await (const event of stream) {
+          if (event.event === "text_chunk" && event.data.delta) {
+            responseText += event.data.delta;
+          } else if (event.event === "collection_name") {
+            collectionName = event.data.name;
+          } else if (event.event === "thinking_process") {
+            yield event;
+          }
+        }
+        fulfillmentResults.push({
+          subquery,
+          intent,
+          actionPlan,
+          response: responseText
+        });
+      }
+      const aggregateStream = this.aggregateService.aggregate(
+        originalQuery,
+        fulfillmentResults
+      );
+      for await (const event of aggregateStream) {
+        if (event.event === "text_chunk" && event.data.delta) {
+          finalResponseText += event.data.delta;
+        }
+        yield event;
+      }
+    }
+    if (_optionalChain([this, 'access', _12 => _12.piiService, 'optionalAccess', _13 => _13.getMode, 'call', _14 => _14()]) === "mask" /* MASK */) {
+      finalResponseText = await this.piiService.filterText(finalResponseText);
+    }
+    await this.addToThreadMessages(thread, {
+      role: "MODEL" /* MODEL */,
+      content: finalResponseText,
+      metadata: collectionName ? { collectionName } : void 0
+    });
+    const streamEndTime = Date.now();
+    const streamDuration = streamEndTime - streamStartTime;
+    _chunk2CQQ34EDcjs.loggers.intentStream.info("Stream session completed", {
+      threadId: thread.threadId,
+      duration: `${streamDuration}ms`,
+      endTime: new Date(streamEndTime).toISOString()
+    });
+  }
+};
+
+
+
+exports.IntentFulfillService = IntentFulfillService;
+//# sourceMappingURL=chunk-L6VNJY2J.cjs.map

package/dist/cjs/chunk-L6VNJY2J.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/shyun/comcom/ain-agent/ain-adk-v0/dist/cjs/chunk-L6VNJY2J.cjs","../../src/services/intents/fulfill.service.ts"],"names":[],"mappings":"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","file":"/Users/shyun/comcom/ain-agent/ain-adk-v0/dist/cjs/chunk-L6VNJY2J.cjs","sourcesContent":[null,"import { randomUUID } from \"node:crypto\";\nimport { getManifest } from \"@/config/manifest\";\nimport type {\n\tA2AModule,\n\tMCPModule,\n\tMemoryModule,\n\tModelModule,\n} from \"@/modules\";\nimport type { OnIntentFallback } from \"@/types/agent\";\nimport { CONNECTOR_PROTOCOL_TYPE, type ConnectorTool } from \"@/types/connector\";\nimport {\n\ttype FulfillmentResult,\n\ttype Intent,\n\ttype MessageObject,\n\tMessageRole,\n\ttype ThreadObject,\n\ttype TriggeredIntent,\n} from \"@/types/memory\";\nimport type { StreamEvent } from \"@/types/stream\";\nimport { loggers } from \"@/utils/logger\";\nimport { PIIFilterMode, type PIIService } from \"../pii.service\";\nimport fulfillPrompt from \"../prompts/fulfill\";\nimport toolSelectPrompt from \"../prompts/tool-select\";\nimport { AggregateService } from \"./aggregate.service\";\n\nexport class IntentFulfillService {\n\tprivate modelModule: ModelModule;\n\tprivate memoryModule: MemoryModule;\n\tprivate a2aModule?: A2AModule;\n\tprivate mcpModule?: MCPModule;\n\tprivate onIntentFallback?: OnIntentFallback;\n\tprivate aggregateService: AggregateService;\n\tprivate piiService?: PIIService;\n\n\tconstructor(\n\t\tmodelModule: ModelModule,\n\t\tmemoryModule: MemoryModule,\n\t\ta2aModule?: A2AModule,\n\t\tmcpModule?: MCPModule,\n\t\tonIntentFallback?: OnIntentFallback,\n\t\tpiiService?: PIIService,\n\t) {\n\t\tthis.modelModule = modelModule;\n\t\tthis.memoryModule = memoryModule;\n\t\tthis.a2aModule = a2aModule;\n\t\tthis.mcpModule = mcpModule;\n\t\tthis.onIntentFallback = onIntentFallback;\n\t\tthis.aggregateService = new AggregateService(modelModule, memoryModule);\n\t\tthis.piiService = piiService;\n\t}\n\n\tprivate async addToThreadMessages(\n\t\tthread: ThreadObject,\n\t\tparams: {\n\t\t\trole: MessageRole;\n\t\t\tcontent: string;\n\t\t\tmetadata?: Record<string, unknown>;\n\t\t},\n\t) {\n\t\ttry {\n\t\t\tconst threadMemory = this.memoryModule.getThreadMemory();\n\t\t\tconst { userId, threadId } = thread;\n\t\t\tconst newMessage: MessageObject = {\n\t\t\t\tmessageId: randomUUID(),\n\t\t\t\trole: params.role,\n\t\t\t\ttimestamp: Date.now(),\n\t\t\t\tcontent: { type: \"text\", parts: [params.content] },\n\t\t\t\tmetadata: params.metadata,\n\t\t\t};\n\t\t\tthread.messages.push(newMessage);\n\t\t\tawait threadMemory?.addMessagesToThread(userId, threadId, [newMessage]);\n\t\t} catch (error) {\n\t\t\tloggers.intentStream.error(\"Error adding message to thread\", error);\n\t\t}\n\t}\n\n\t/**\n\t * Fulfills the detected intent by generating a streaming 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 * - Streaming results as Server-Sent Events\n\t *\n\t * @param query - The user's input query\n\t * @param threadId - Thread identifier for context\n\t * @param thread - Previous conversation history\n\t * @param intent - Optional detected intent with custom prompt\n\t * @returns AsyncGenerator yielding StreamEvent objects\n\t */\n\tprivate async *intentFulfilling(\n\t\tquery: string,\n\t\tthread: ThreadObject,\n\t\tintent?: Intent,\n\t): AsyncGenerator<StreamEvent> {\n\t\tconst prompt = await fulfillPrompt(this.memoryModule, intent);\n\n\t\tconst modelInstance = this.modelModule.getModel();\n\t\tconst modelOptions = this.modelModule.getModelOptions();\n\t\tconst messages = modelInstance.generateMessages({\n\t\t\tquery,\n\t\t\tthread,\n\t\t\tsystemPrompt: prompt.trim(),\n\t\t});\n\n\t\tloggers.intent.debug(\"Intent fulfillment start\", {\n\t\t\tthreadId: thread.threadId,\n\t\t\tmessages,\n\t\t});\n\n\t\tconst tools: ConnectorTool[] = [];\n\t\tconst toolPrompt = await toolSelectPrompt(this.memoryModule);\n\t\tthis.mcpModule && tools.push(...this.mcpModule.getTools(toolPrompt));\n\t\tthis.a2aModule &&\n\t\t\ttools.push(...(await this.a2aModule.getTools(toolPrompt)));\n\n\t\tconst processList: string[] = [];\n\n\t\twhile (true) {\n\t\t\tconst functions = modelInstance.convertToolsToFunctions(tools);\n\t\t\tconst responseStream = await modelInstance.fetchStreamWithContextMessage(\n\t\t\t\tmessages,\n\t\t\t\tfunctions,\n\t\t\t\tmodelOptions,\n\t\t\t);\n\n\t\t\tconst assembledToolCalls: {\n\t\t\t\tid: string;\n\t\t\t\ttype: \"function\";\n\t\t\t\tfunction: { name: string; arguments: string };\n\t\t\t}[] = [];\n\n\t\t\tfor await (const chunk of responseStream) {\n\t\t\t\tconst delta = chunk.delta;\n\t\t\t\tif (delta?.tool_calls) {\n\t\t\t\t\tfor (const { index, id, function: func } of delta.tool_calls) {\n\t\t\t\t\t\tassembledToolCalls[index] ??= {\n\t\t\t\t\t\t\tid: \"\",\n\t\t\t\t\t\t\ttype: \"function\",\n\t\t\t\t\t\t\tfunction: { name: \"\", arguments: \"\" },\n\t\t\t\t\t\t};\n\n\t\t\t\t\t\tif (id) assembledToolCalls[index].id = id;\n\t\t\t\t\t\tif (func?.name) assembledToolCalls[index].function.name = func.name;\n\t\t\t\t\t\tif (func?.arguments)\n\t\t\t\t\t\t\tassembledToolCalls[index].function.arguments += func.arguments;\n\t\t\t\t\t}\n\t\t\t\t} else if (chunk.delta?.content) {\n\t\t\t\t\tyield {\n\t\t\t\t\t\tevent: \"text_chunk\",\n\t\t\t\t\t\tdata: { delta: chunk.delta.content },\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tloggers.intentStream.debug(\"assembledToolCalls\", {\n\t\t\t\tthreadId: thread.threadId,\n\t\t\t\tassembledToolCalls,\n\t\t\t});\n\n\t\t\tif (assembledToolCalls.length > 0) {\n\t\t\t\tfor (const toolCall of assembledToolCalls) {\n\t\t\t\t\tconst toolName = toolCall.function.name;\n\t\t\t\t\tlet selectedTool: ConnectorTool | undefined;\n\t\t\t\t\tfor (const [index, toolTmp] of tools.entries()) {\n\t\t\t\t\t\tif (toolTmp.toolName === toolName) {\n\t\t\t\t\t\t\tif (toolTmp.protocol === CONNECTOR_PROTOCOL_TYPE.A2A) {\n\t\t\t\t\t\t\t\t// remove used tool to prevent infinite loop\n\t\t\t\t\t\t\t\tselectedTool = tools.splice(index, 1)[0];\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tselectedTool = toolTmp;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\tif (!selectedTool) {\n\t\t\t\t\t\t// it cannot be happened...\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst toolArgs = JSON.parse(toolCall.function.arguments);\n\t\t\t\t\tconst thinkData = {\n\t\t\t\t\t\ttitle: `[${getManifest().name}] ${selectedTool.protocol} 실행: ${toolName}`,\n\t\t\t\t\t\tdescription: `${toolArgs.thinking_text || \"\"}`,\n\t\t\t\t\t};\n\t\t\t\t\tyield {\n\t\t\t\t\t\tevent: \"thinking_process\",\n\t\t\t\t\t\tdata: thinkData,\n\t\t\t\t\t};\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 === CONNECTOR_PROTOCOL_TYPE.MCP\n\t\t\t\t\t) {\n\t\t\t\t\t\tloggers.intent.info(\"MCP tool call\", { toolName, toolArgs });\n\t\t\t\t\t\ttoolResult = await this.mcpModule.useTool(selectedTool, toolArgs);\n\t\t\t\t\t} else if (\n\t\t\t\t\t\tthis.a2aModule &&\n\t\t\t\t\t\tselectedTool.protocol === CONNECTOR_PROTOCOL_TYPE.A2A\n\t\t\t\t\t) {\n\t\t\t\t\t\tloggers.intent.info(\"A2A tool call\", { toolName });\n\t\t\t\t\t\tconst a2aStream = this.a2aModule.useTool(\n\t\t\t\t\t\t\tselectedTool,\n\t\t\t\t\t\t\tquery,\n\t\t\t\t\t\t\tthread.threadId,\n\t\t\t\t\t\t);\n\t\t\t\t\t\t// yield intermediate events and get final result\n\t\t\t\t\t\tlet result = await a2aStream.next();\n\t\t\t\t\t\twhile (!result.done) {\n\t\t\t\t\t\t\tif (result.value.event === \"thinking_process\") {\n\t\t\t\t\t\t\t\tyield result.value;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\tresult = await a2aStream.next();\n\t\t\t\t\t\t}\n\t\t\t\t\t\ttoolResult = result.value;\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(\"Tool Result\", { 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 {\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\tloggers.intent.debug(\"Intent fulfillment completed\", {\n\t\t\tthreadId: thread.threadId,\n\t\t\ttoolCallsExecuted: processList.length,\n\t\t\tintentName: intent?.name,\n\t\t});\n\t}\n\n\t/**\n\t * Returns the appropriate stream for a triggered intent.\n\t * Uses fallback handler if no intent matched and fallback is configured.\n\t */\n\tprivate getIntentStream(\n\t\ttriggeredIntent: TriggeredIntent,\n\t\tthread: ThreadObject,\n\t): AsyncGenerator<StreamEvent> | undefined {\n\t\tconst { subquery = \"\", intent } = triggeredIntent;\n\n\t\tif (!intent && this.onIntentFallback) {\n\t\t\tloggers.intent.info(\"No intent matched, calling fallback handler\");\n\t\t\tconst fallbackStream = this.onIntentFallback({\n\t\t\t\ttriggeredIntent,\n\t\t\t\tthread,\n\t\t\t});\n\t\t\tif (fallbackStream !== undefined) {\n\t\t\t\treturn fallbackStream;\n\t\t\t}\n\t\t}\n\n\t\treturn this.intentFulfilling(subquery, thread, intent);\n\t}\n\n\t/**\n\t * Processes all triggered intents and generates a unified response.\n\t *\n\t * Workflow:\n\t * 1. Process each intent sequentially, collecting results\n\t * 2. Yield thinking_process events for progress visibility\n\t * 3. Use AggregateService to unify results if needsAggregation is true\n\t * 4. Stream the final (possibly aggregated) response\n\t *\n\t * @param intents - Array of triggered intents to process\n\t * @param thread - The thread history\n\t * @param originalQuery - The user's original query (for aggregate context)\n\t * @param needsAggregation - Whether the results need to be aggregated\n\t * @returns AsyncGenerator yielding StreamEvent objects\n\t */\n\tpublic async *intentFulfill(\n\t\tintents: Array<TriggeredIntent>,\n\t\tthread: ThreadObject,\n\t\toriginalQuery: string,\n\t\tneedsAggregation: boolean,\n\t): AsyncGenerator<StreamEvent> {\n\t\tconst streamStartTime = Date.now();\n\t\tloggers.intentStream.info(\"Stream session started\", {\n\t\t\tthreadId: thread.threadId,\n\t\t\tintentCount: intents.length,\n\t\t\tneedsAggregation,\n\t\t\tstartTime: new Date(streamStartTime).toISOString(),\n\t\t});\n\n\t\tlet finalResponseText = \"\";\n\t\tlet collectionName: string | undefined;\n\n\t\tif (intents.length <= 1) {\n\t\t\t// Single intent: stream response directly\n\t\t\tconst triggeredIntent = intents[0];\n\t\t\tif (!triggeredIntent) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst { subquery = \"\", intent, actionPlan } = triggeredIntent;\n\t\t\tloggers.intent.info(\n\t\t\t\t`Process single intent: ${subquery}, ${intent?.name}`,\n\t\t\t);\n\t\t\tloggers.intent.info(`Action plan: ${actionPlan}`);\n\n\t\t\t// Yield thinking_process for progress visibility\n\t\t\tyield {\n\t\t\t\tevent: \"thinking_process\",\n\t\t\t\tdata: {\n\t\t\t\t\ttitle: `[${getManifest().name}] ${subquery}`,\n\t\t\t\t\tdescription: actionPlan || \"\",\n\t\t\t\t},\n\t\t\t};\n\n\t\t\t// Get the stream for this intent\n\t\t\tconst stream = this.getIntentStream(triggeredIntent, thread);\n\t\t\tif (!stream) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Stream response directly\n\t\t\tfor await (const event of stream) {\n\t\t\t\tif (event.event === \"text_chunk\" && event.data.delta) {\n\t\t\t\t\tfinalResponseText += event.data.delta;\n\t\t\t\t} else if (event.event === \"collection_name\") {\n\t\t\t\t\tcollectionName = event.data.name;\n\t\t\t\t}\n\t\t\t\tyield event;\n\t\t\t}\n\t\t} else if (!needsAggregation) {\n\t\t\t// Multiple intents but no aggregation needed: collect intermediate results, stream only last\n\t\t\tfor (let i = 0; i < intents.length; i++) {\n\t\t\t\tconst triggeredIntent = intents[i];\n\t\t\t\tconst { subquery = \"\", intent, actionPlan } = triggeredIntent;\n\t\t\t\tloggers.intent.info(`Process query: ${subquery}, ${intent?.name}`);\n\t\t\t\tloggers.intent.info(`Action plan: ${actionPlan}`);\n\n\t\t\t\tconst isLastIntent = i === intents.length - 1;\n\n\t\t\t\t// Yield thinking_process for progress visibility\n\t\t\t\tyield {\n\t\t\t\t\tevent: \"thinking_process\",\n\t\t\t\t\tdata: {\n\t\t\t\t\t\ttitle: `[${getManifest().name}] ${subquery}`,\n\t\t\t\t\t\tdescription: actionPlan || \"\",\n\t\t\t\t\t},\n\t\t\t\t};\n\n\t\t\t\t// Get the stream for this intent\n\t\t\t\tconst stream = this.getIntentStream(triggeredIntent, thread);\n\t\t\t\tif (!stream) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\tif (isLastIntent) {\n\t\t\t\t\t// Stream last intent response directly\n\t\t\t\t\tfor await (const event of stream) {\n\t\t\t\t\t\tif (event.event === \"text_chunk\" && event.data.delta) {\n\t\t\t\t\t\t\tfinalResponseText += event.data.delta;\n\t\t\t\t\t\t} else if (event.event === \"collection_name\") {\n\t\t\t\t\t\t\tcollectionName = event.data.name;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tyield event;\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\t// Collect intermediate results without streaming text_chunk\n\t\t\t\t\tlet responseText = \"\";\n\t\t\t\t\tfor await (const event of stream) {\n\t\t\t\t\t\tif (event.event === \"text_chunk\" && event.data.delta) {\n\t\t\t\t\t\t\tresponseText += event.data.delta;\n\t\t\t\t\t\t} else if (event.event === \"collection_name\") {\n\t\t\t\t\t\t\tcollectionName = event.data.name;\n\t\t\t\t\t\t} else if (event.event === \"thinking_process\") {\n\t\t\t\t\t\t\t// Tool execution thinking_process events are yielded immediately\n\t\t\t\t\t\t\tyield event;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\t// Add intermediate result to thread context for next intent\n\t\t\t\t\tthread.messages.push({\n\t\t\t\t\t\tmessageId: randomUUID(),\n\t\t\t\t\t\trole: MessageRole.MODEL,\n\t\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t\t\tcontent: { type: \"text\", parts: [responseText] },\n\t\t\t\t\t\tmetadata: { isThinking: true },\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t} else {\n\t\t\t// Multi-intent mode with aggregation: collect all results then aggregate\n\t\t\tconst fulfillmentResults: FulfillmentResult[] = [];\n\n\t\t\tfor (let i = 0; i < intents.length; i++) {\n\t\t\t\tconst triggeredIntent = intents[i];\n\t\t\t\tconst { subquery = \"\", intent, actionPlan } = triggeredIntent;\n\t\t\t\tloggers.intent.info(`Process query: ${subquery}, ${intent?.name}`);\n\t\t\t\tloggers.intent.info(`Action plan: ${actionPlan}`);\n\n\t\t\t\t// Add previous result to thread context for inference (not stored in memory)\n\t\t\t\tif (fulfillmentResults.length > 0) {\n\t\t\t\t\tconst lastResult = fulfillmentResults[fulfillmentResults.length - 1];\n\t\t\t\t\tthread.messages.push({\n\t\t\t\t\t\tmessageId: randomUUID(),\n\t\t\t\t\t\trole: MessageRole.MODEL,\n\t\t\t\t\t\ttimestamp: Date.now(),\n\t\t\t\t\t\tcontent: { type: \"text\", parts: [lastResult.response] },\n\t\t\t\t\t\tmetadata: { isThinking: true },\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\t// Yield thinking_process for progress visibility\n\t\t\t\tyield {\n\t\t\t\t\tevent: \"thinking_process\",\n\t\t\t\t\tdata: {\n\t\t\t\t\t\ttitle: `[${getManifest().name}] ${subquery}`,\n\t\t\t\t\t\tdescription: actionPlan || \"\",\n\t\t\t\t\t},\n\t\t\t\t};\n\n\t\t\t\t// Get the stream for this intent\n\t\t\t\tconst stream = this.getIntentStream(triggeredIntent, thread);\n\t\t\t\tif (!stream) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\t// Collect response text (don't yield text_chunk yet)\n\t\t\t\tlet responseText = \"\";\n\t\t\t\tfor await (const event of stream) {\n\t\t\t\t\tif (event.event === \"text_chunk\" && event.data.delta) {\n\t\t\t\t\t\tresponseText += event.data.delta;\n\t\t\t\t\t} else if (event.event === \"collection_name\") {\n\t\t\t\t\t\tcollectionName = event.data.name;\n\t\t\t\t\t} else if (event.event === \"thinking_process\") {\n\t\t\t\t\t\t// Tool execution thinking_process events are yielded immediately\n\t\t\t\t\t\tyield event;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tfulfillmentResults.push({\n\t\t\t\t\tsubquery,\n\t\t\t\t\tintent,\n\t\t\t\t\tactionPlan,\n\t\t\t\t\tresponse: responseText,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\t// Aggregate step: generate unified response\n\t\t\tconst aggregateStream = this.aggregateService.aggregate(\n\t\t\t\toriginalQuery,\n\t\t\t\tfulfillmentResults,\n\t\t\t);\n\n\t\t\tfor await (const event of aggregateStream) {\n\t\t\t\tif (event.event === \"text_chunk\" && event.data.delta) {\n\t\t\t\t\tfinalResponseText += event.data.delta;\n\t\t\t\t}\n\t\t\t\tyield event;\n\t\t\t}\n\t\t}\n\n\t\t// PII filtering on output before saving to memory (mask mode only)\n\t\tif (this.piiService?.getMode() === PIIFilterMode.MASK) {\n\t\t\tfinalResponseText = await this.piiService.filterText(finalResponseText);\n\t\t}\n\n\t\t// Save final response to memory\n\t\tawait this.addToThreadMessages(thread, {\n\t\t\trole: MessageRole.MODEL,\n\t\t\tcontent: finalResponseText,\n\t\t\tmetadata: collectionName ? { collectionName } : undefined,\n\t\t});\n\n\t\tconst streamEndTime = Date.now();\n\t\tconst streamDuration = streamEndTime - streamStartTime;\n\n\t\tloggers.intentStream.info(\"Stream session completed\", {\n\t\t\tthreadId: thread.threadId,\n\t\t\tduration: `${streamDuration}ms`,\n\t\t\tendTime: new Date(streamEndTime).toISOString(),\n\t\t});\n\t}\n}\n"]}