@ainetwork/adk 0.1.12 → 0.2.0

package/dist/esm/chunk-M4EJC7LZ.js

@@ -0,0 +1,289 @@
+import {
+  loggers
+} from "./chunk-N7VYM2R5.js";
+
+// src/services/query-stream.service.ts
+import { randomUUID } from "crypto";
+var QueryStreamService = class {
+  modelModule;
+  a2aModule;
+  mcpModule;
+  memoryModule;
+  prompts;
+  constructor(modelModule, a2aModule, mcpModule, memoryModule, prompts) {
+    this.modelModule = modelModule;
+    this.a2aModule = a2aModule;
+    this.mcpModule = mcpModule;
+    this.memoryModule = memoryModule;
+    this.prompts = prompts;
+  }
+  /**
+   * Detects the intent from context.
+   *
+   * @param query - The user's input query
+   * @param thread - The thread history
+   * @returns The detected intent
+   */
+  async intentTriggering(query, thread) {
+    const modelInstance = this.modelModule.getModel();
+    const intentMemory = this.memoryModule?.getIntentMemory();
+    if (!intentMemory) {
+      return void 0;
+    }
+    const intents = await intentMemory.listIntents();
+    if (intents.length === 0) {
+      loggers.intentStream.warn("No intent found");
+      return void 0;
+    }
+    const intentList = intents.map((intent2) => `- ${intent2.name}: ${intent2.description}`).join("\n");
+    const historyMessages = !thread ? "" : Object.entries(thread.messages).sort(([, a], [, b]) => a.timestamp - b.timestamp).map(([_chatId, chat]) => {
+      const role = chat.role === "USER" ? "User" : chat.role === "MODEL" ? "Assistant" : "System";
+      const content = Array.isArray(chat.content.parts) ? chat.content.parts.join(" ") : String(chat.content.parts);
+      return `${role}: """${content}"""`;
+    }).join("\n");
+    const systemPrompt = `You are an expert in accurately identifying user intentions.
+
+Available intent list:
+${intentList}
+
+Please select and answer only from the above intent list. 
+Please return only the exact intent name without any additional explanations or text.`;
+    const userMessage = `The following is the conversation history with the user:
+
+${historyMessages}
+
+Last user question: "${query}"
+
+Based on the above conversation history, please determine what the intention of the last user question is. 
+Please select and answer the most appropriate intent name from the available intent list.`;
+    const messages = modelInstance.generateMessages({
+      query: userMessage,
+      systemPrompt
+    });
+    const response = await modelInstance.fetch(messages);
+    if (!response.content) {
+      throw new Error("No intent detected");
+    }
+    const intentName = response.content.trim();
+    const intent = await intentMemory.getIntentByName(intentName);
+    if (!intent) {
+      throw new Error(`No intent found: ${intentName}`);
+    }
+    return intent;
+  }
+  /**
+   * Fulfills the detected intent by generating a 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
+   *
+   * @param query - The user's input query
+   * @param threadId - Thread identifier for context
+   * @param thread - Previous conversation history
+   * @returns Object containing process steps and final response
+   */
+  async *intentFulfilling(query, threadId, thread, intent) {
+    const systemPrompt = `
+Today is ${(/* @__PURE__ */ new Date()).toLocaleDateString()}.
+
+${this.prompts?.agent || ""}
+
+${this.prompts?.system || ""}
+
+${intent?.prompt || ""}
+	`.trim();
+    const modelInstance = this.modelModule.getModel();
+    const messages = modelInstance.generateMessages({
+      query,
+      thread,
+      systemPrompt: systemPrompt.trim()
+    });
+    const tools = [];
+    this.mcpModule && tools.push(...this.mcpModule.getTools());
+    this.a2aModule && tools.push(...await this.a2aModule.getTools());
+    const functions = modelInstance.convertToolsToFunctions(tools);
+    const processList = [];
+    while (true) {
+      const responseStream = await modelInstance.fetchStreamWithContextMessage(
+        messages,
+        functions
+      );
+      const assembledToolCalls = [];
+      loggers.intentStream.debug("messages", { messages });
+      for await (const chunk of responseStream) {
+        const delta = chunk.delta;
+        if (delta?.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 (func?.name) assembledToolCalls[index].function.name = func.name;
+            if (func?.arguments)
+              assembledToolCalls[index].function.arguments += func.arguments;
+          }
+        } else if (chunk.delta?.content) {
+          yield {
+            event: "text_chunk",
+            data: { delta: chunk.delta.content }
+          };
+        }
+      }
+      loggers.intentStream.debug("assembledToolCalls", {
+        assembledToolCalls
+      });
+      if (assembledToolCalls.length > 0) {
+        const messagePayload = this.a2aModule?.getMessagePayload(
+          query,
+          threadId
+        );
+        for (const toolCall of assembledToolCalls) {
+          const toolName = toolCall.function.name;
+          const selectedTool = tools.filter((tool) => tool.id === toolName)[0];
+          let toolResult = "";
+          if (this.mcpModule && selectedTool.protocol === "MCP" /* MCP */) {
+            const toolArgs = JSON.parse(toolCall.function.arguments);
+            yield {
+              event: "tool_start",
+              data: { protocol: "MCP" /* MCP */, toolName, toolArgs }
+            };
+            loggers.intent.debug("MCP tool call", { toolName, toolArgs });
+            toolResult = await this.mcpModule.useTool(
+              selectedTool,
+              toolArgs
+            );
+          } else if (this.a2aModule && selectedTool.protocol === "A2A" /* A2A */) {
+            yield {
+              event: "tool_start",
+              data: {
+                protocol: "A2A" /* A2A */,
+                toolName,
+                toolArgs: null
+              }
+            };
+            loggers.intent.debug("A2A tool call", { toolName });
+            toolResult = await this.a2aModule.useTool(
+              selectedTool,
+              // biome-ignore lint/style/noNonNullAssertion: <a2aModule is guaranteed to be defined>
+              messagePayload,
+              threadId
+            );
+          } else {
+            loggers.intent.warn(
+              `Unrecognized tool type: ${selectedTool.protocol}`
+            );
+            continue;
+          }
+          yield {
+            event: "tool_output",
+            data: {
+              protocol: selectedTool.protocol,
+              toolName,
+              result: toolResult
+            }
+          };
+          loggers.intent.debug("toolResult", { toolResult });
+          processList.push(toolResult);
+          modelInstance.appendMessages(messages, toolResult);
+        }
+      } else {
+        break;
+      }
+    }
+  }
+  /**
+   * Generates a title for the conversation based on the query.
+   *
+   * @param query - The user's input query
+   * @returns Promise resolving to a generated title
+   */
+  async generateTitle(query) {
+    const DEFAULT_TITLE = "New Chat";
+    try {
+      const modelInstance = this.modelModule.getModel();
+      const messages = modelInstance.generateMessages({
+        query,
+        systemPrompt: `You are a helpful assistant that generates titles for conversations.
+  Please analyze the user's query and create a concise title that accurately reflects the conversation's core topic.
+  The title must be no more than 5 words long.
+  Respond with only the title. Do not include any punctuation or extra explanations.`
+      });
+      const response = await modelInstance.fetch(messages);
+      return response.content || DEFAULT_TITLE;
+    } catch (error) {
+      loggers.intentStream.error("Error generating title", {
+        error,
+        query
+      });
+      return DEFAULT_TITLE;
+    }
+  }
+  /**
+   * Main entry point for processing user queries.
+   *
+   * Handles the complete query lifecycle:
+   * 1. Loads thread from memory
+   * 2. Detects intent from the query
+   * 3. Fulfills the intent with AI response
+   * 4. Updates conversation history
+   *
+   * @param type - The type of thread (e.g., chat, workflow)
+   * @param userId - The user's unique identifier
+   * @param threadId - Unique thread identifier
+   * @param query - The user's input query
+   * @returns Object containing the AI-generated response
+   */
+  async *handleQueryStream(threadMetadata, query) {
+    const { type, userId } = threadMetadata;
+    const queryStartAt = Date.now();
+    const threadMemory = this.memoryModule?.getThreadMemory();
+    let threadId = threadMetadata.threadId;
+    let thread;
+    if (threadId) {
+      thread = await threadMemory?.getThread(type, userId, threadId);
+    } else {
+      threadId = randomUUID();
+      const title = await this.generateTitle(query);
+      const metadata = await threadMemory?.createThread(type, userId, threadId, title) || {
+        type,
+        threadId,
+        title,
+        updatedAt: Date.now()
+      };
+      loggers.intentStream.info("Create new thread", { metadata });
+      yield { event: "thread_id", data: metadata };
+    }
+    const intent = await this.intentTriggering(query, thread);
+    const stream = this.intentFulfilling(query, threadId, thread, intent);
+    let finalResponseText = "";
+    for await (const event of stream) {
+      if (event.event === "text_chunk" && event.data.delta) {
+        loggers.intentStream.debug("text_chunk", { event });
+        finalResponseText += event.data.delta;
+      }
+      yield event;
+    }
+    await threadMemory?.addMessagesToThread(userId, threadId, [
+      {
+        role: "USER" /* USER */,
+        timestamp: queryStartAt,
+        content: { type: "text", parts: [query] }
+      },
+      {
+        role: "MODEL" /* MODEL */,
+        timestamp: Date.now(),
+        content: { type: "text", parts: [finalResponseText] }
+      }
+    ]);
+  }
+};
+
+export {
+  QueryStreamService
+};
+//# sourceMappingURL=chunk-M4EJC7LZ.js.map

package/dist/esm/chunk-M4EJC7LZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/query-stream.service.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type {\n\tA2AModule,\n\tMCPModule,\n\tMemoryModule,\n\tModelModule,\n} from \"@/modules/index.js\";\nimport type { AinAgentPrompts } from \"@/types/agent.js\";\nimport {\n\ttype Intent,\n\tMessageRole,\n\ttype ThreadMetadata,\n\ttype ThreadObject,\n\ttype ThreadType,\n} from \"@/types/memory.js\";\nimport type { StreamEvent } from \"@/types/stream\";\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 QueryStreamService {\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 context.\n\t *\n\t * @param query - The user's input query\n\t * @param thread - The thread history\n\t * @returns The detected intent\n\t */\n\tprivate async intentTriggering(\n\t\tquery: string,\n\t\tthread: ThreadObject | undefined,\n\t): Promise<Intent | undefined> {\n\t\tconst modelInstance = this.modelModule.getModel();\n\t\tconst intentMemory = this.memoryModule?.getIntentMemory();\n\t\tif (!intentMemory) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\t// 인텐트 목록 가져오기\n\t\tconst intents = await intentMemory.listIntents();\n\n\t\tif (intents.length === 0) {\n\t\t\tloggers.intentStream.warn(\"No intent found\");\n\t\t\treturn undefined;\n\t\t}\n\n\t\tconst intentList = intents\n\t\t\t.map((intent) => `- ${intent.name}: ${intent.description}`)\n\t\t\t.join(\"\\n\");\n\n\t\t// Convert session history to a string\n\t\tconst historyMessages = !thread\n\t\t\t? \"\"\n\t\t\t: Object.entries(thread.messages)\n\t\t\t\t\t.sort(([, a], [, b]) => a.timestamp - b.timestamp)\n\t\t\t\t\t.map(([_chatId, chat]) => {\n\t\t\t\t\t\tconst role =\n\t\t\t\t\t\t\tchat.role === \"USER\"\n\t\t\t\t\t\t\t\t? \"User\"\n\t\t\t\t\t\t\t\t: chat.role === \"MODEL\"\n\t\t\t\t\t\t\t\t\t? \"Assistant\"\n\t\t\t\t\t\t\t\t\t: \"System\";\n\t\t\t\t\t\tconst content = Array.isArray(chat.content.parts)\n\t\t\t\t\t\t\t? chat.content.parts.join(\" \")\n\t\t\t\t\t\t\t: String(chat.content.parts);\n\t\t\t\t\t\treturn `${role}: \"\"\"${content}\"\"\"`;\n\t\t\t\t\t})\n\t\t\t\t\t.join(\"\\n\");\n\n\t\tconst systemPrompt = `You are an expert in accurately identifying user intentions.\n\nAvailable intent list:\n${intentList}\n\nPlease select and answer only from the above intent list. \nPlease return only the exact intent name without any additional explanations or text.`;\n\n\t\tconst userMessage = `The following is the conversation history with the user:\n\n${historyMessages}\n\nLast user question: \"${query}\"\n\nBased on the above conversation history, please determine what the intention of the last user question is. \nPlease select and answer the most appropriate intent name from the available intent list.`;\n\n\t\tconst messages = modelInstance.generateMessages({\n\t\t\tquery: userMessage,\n\t\t\tsystemPrompt,\n\t\t});\n\n\t\tconst response = await modelInstance.fetch(messages);\n\t\tif (!response.content) {\n\t\t\tthrow new Error(\"No intent detected\");\n\t\t}\n\t\tconst intentName = response.content.trim();\n\t\tconst intent = await intentMemory.getIntentByName(intentName);\n\t\tif (!intent) {\n\t\t\tthrow new Error(`No intent found: ${intentName}`);\n\t\t}\n\t\treturn intent;\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 threadId - Thread identifier for context\n\t * @param thread - Previous conversation history\n\t * @returns Object containing process steps and final response\n\t */\n\tpublic async *intentFulfilling(\n\t\tquery: string,\n\t\tthreadId: string,\n\t\tthread?: ThreadObject,\n\t\tintent?: Intent,\n\t): AsyncGenerator<StreamEvent> {\n\t\tconst systemPrompt = `\nToday is ${new Date().toLocaleDateString()}.\n\n${this.prompts?.agent || \"\"}\n\n${this.prompts?.system || \"\"}\n\n${intent?.prompt || \"\"}\n\t`.trim();\n\n\t\tconst modelInstance = this.modelModule.getModel();\n\t\tconst messages = modelInstance.generateMessages({\n\t\t\tquery,\n\t\t\tthread,\n\t\t\tsystemPrompt: systemPrompt.trim(),\n\t\t});\n\n\t\tconst tools: IAgentTool[] = [];\n\t\tthis.mcpModule && tools.push(...this.mcpModule.getTools());\n\t\tthis.a2aModule && tools.push(...(await this.a2aModule.getTools()));\n\n\t\tconst functions = modelInstance.convertToolsToFunctions(tools);\n\n\t\tconst processList: string[] = [];\n\n\t\twhile (true) {\n\t\t\tconst responseStream = await modelInstance.fetchStreamWithContextMessage(\n\t\t\t\tmessages,\n\t\t\t\tfunctions,\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\tloggers.intentStream.debug(\"messages\", { messages });\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\tassembledToolCalls,\n\t\t\t});\n\n\t\t\tif (assembledToolCalls.length > 0) {\n\t\t\t\tconst messagePayload = this.a2aModule?.getMessagePayload(\n\t\t\t\t\tquery,\n\t\t\t\t\tthreadId,\n\t\t\t\t);\n\t\t\t\tfor (const toolCall of assembledToolCalls) {\n\t\t\t\t\tconst toolName = toolCall.function.name;\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 = JSON.parse(toolCall.function.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\tyield {\n\t\t\t\t\t\t\tevent: \"tool_start\",\n\t\t\t\t\t\t\tdata: { protocol: TOOL_PROTOCOL_TYPE.MCP, toolName, toolArgs },\n\t\t\t\t\t\t};\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\tyield {\n\t\t\t\t\t\t\tevent: \"tool_start\",\n\t\t\t\t\t\t\tdata: {\n\t\t\t\t\t\t\t\tprotocol: TOOL_PROTOCOL_TYPE.A2A,\n\t\t\t\t\t\t\t\ttoolName,\n\t\t\t\t\t\t\t\ttoolArgs: null,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t};\n\t\t\t\t\t\tloggers.intent.debug(\"A2A tool call\", { toolName });\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\t// biome-ignore lint/style/noNonNullAssertion: <a2aModule is guaranteed to be defined>\n\t\t\t\t\t\t\tmessagePayload!,\n\t\t\t\t\t\t\tthreadId,\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\t\t\t\t\tyield {\n\t\t\t\t\t\tevent: \"tool_output\",\n\t\t\t\t\t\tdata: {\n\t\t\t\t\t\t\tprotocol: selectedTool.protocol,\n\t\t\t\t\t\t\ttoolName,\n\t\t\t\t\t\t\tresult: toolResult,\n\t\t\t\t\t\t},\n\t\t\t\t\t};\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 {\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Generates a title for the conversation based on the query.\n\t *\n\t * @param query - The user's input query\n\t * @returns Promise resolving to a generated title\n\t */\n\n\tprivate async generateTitle(query: string): Promise<string> {\n\t\tconst DEFAULT_TITLE = \"New Chat\";\n\t\ttry {\n\t\t\tconst modelInstance = this.modelModule.getModel();\n\t\t\tconst messages = modelInstance.generateMessages({\n\t\t\t\tquery,\n\t\t\t\tsystemPrompt: `You are a helpful assistant that generates titles for conversations.\n  Please analyze the user's query and create a concise title that accurately reflects the conversation's core topic.\n  The title must be no more than 5 words long.\n  Respond with only the title. Do not include any punctuation or extra explanations.`,\n\t\t\t});\n\t\t\tconst response = await modelInstance.fetch(messages);\n\t\t\treturn response.content || DEFAULT_TITLE;\n\t\t} catch (error) {\n\t\t\tloggers.intentStream.error(\"Error generating title\", {\n\t\t\t\terror,\n\t\t\t\tquery,\n\t\t\t});\n\t\t\treturn DEFAULT_TITLE;\n\t\t}\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 thread 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 type - The type of thread (e.g., chat, workflow)\n\t * @param userId - The user's unique identifier\n\t * @param threadId - Unique thread identifier\n\t * @param query - The user's input query\n\t * @returns Object containing the AI-generated response\n\t */\n\tpublic async *handleQueryStream(\n\t\tthreadMetadata: {\n\t\t\ttype: ThreadType;\n\t\t\tuserId: string;\n\t\t\tthreadId?: string;\n\t\t},\n\t\tquery: string,\n\t): AsyncGenerator<StreamEvent> {\n\t\tconst { type, userId } = threadMetadata;\n\t\tconst queryStartAt = Date.now();\n\t\tconst threadMemory = this.memoryModule?.getThreadMemory();\n\n\t\tlet threadId = threadMetadata.threadId;\n\t\tlet thread: ThreadObject | undefined;\n\n\t\tif (threadId) {\n\t\t\tthread = await threadMemory?.getThread(type, userId, threadId);\n\t\t} else {\n\t\t\tthreadId = randomUUID();\n\t\t\tconst title = await this.generateTitle(query);\n\n\t\t\tconst metadata =\n\t\t\t\t(await threadMemory?.createThread(type, userId, threadId, title)) ||\n\t\t\t\t({\n\t\t\t\t\ttype,\n\t\t\t\t\tthreadId,\n\t\t\t\t\ttitle,\n\t\t\t\t\tupdatedAt: Date.now(),\n\t\t\t\t} as ThreadMetadata);\n\t\t\tloggers.intentStream.info(\"Create new thread\", { metadata });\n\t\t\tyield { event: \"thread_id\", data: metadata };\n\t\t}\n\n\t\t// 2. intent triggering\n\t\tconst intent = await this.intentTriggering(query, thread);\n\n\t\t// 3. intent fulfillment\n\t\tconst stream = this.intentFulfilling(query, threadId, thread, intent);\n\n\t\tlet finalResponseText = \"\";\n\t\tfor await (const event of stream) {\n\t\t\tif (event.event === \"text_chunk\" && event.data.delta) {\n\t\t\t\tloggers.intentStream.debug(\"text_chunk\", { event });\n\t\t\t\tfinalResponseText += event.data.delta;\n\t\t\t}\n\t\t\tyield event;\n\t\t}\n\n\t\tawait threadMemory?.addMessagesToThread(userId, threadId, [\n\t\t\t{\n\t\t\t\trole: MessageRole.USER,\n\t\t\t\ttimestamp: queryStartAt,\n\t\t\t\tcontent: { type: \"text\", parts: [query] },\n\t\t\t},\n\t\t\t{\n\t\t\t\trole: MessageRole.MODEL,\n\t\t\t\ttimestamp: Date.now(),\n\t\t\t\tcontent: { type: \"text\", parts: [finalResponseText] },\n\t\t\t},\n\t\t]);\n\t}\n}\n"],"mappings":"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","names":["intent"]}

package/dist/esm/chunk-MNAWSBYP.js

@@ -0,0 +1,18 @@
+// src/types/memory.ts
+var MessageRole = /* @__PURE__ */ ((MessageRole2) => {
+  MessageRole2["USER"] = "USER";
+  MessageRole2["SYSTEM"] = "SYSTEM";
+  MessageRole2["MODEL"] = "MODEL";
+  return MessageRole2;
+})(MessageRole || {});
+var ThreadType = /* @__PURE__ */ ((ThreadType2) => {
+  ThreadType2["WORKFLOW"] = "WORKFLOW";
+  ThreadType2["CHAT"] = "CHAT";
+  return ThreadType2;
+})(ThreadType || {});
+
+export {
+  MessageRole,
+  ThreadType
+};
+//# sourceMappingURL=chunk-MNAWSBYP.js.map

package/dist/esm/chunk-MNAWSBYP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/memory.ts"],"sourcesContent":["/**\n * Roles for participants in a message.\n */\nexport enum MessageRole {\n\t/** User/human participant */\n\tUSER = \"USER\",\n\t/** System-generated messages or instructions */\n\tSYSTEM = \"SYSTEM\",\n\t/** AI model responses */\n\tMODEL = \"MODEL\",\n}\n\n/**\n * Content structure for message content.\n *\n * Supports multi-part content with different types (text, images, etc.).\n */\nexport type MessageContentObject = {\n\t/** Content type (e.g., \"text\", \"image\", \"tool_use\") */\n\ttype: string;\n\t/** Array of content parts, structure depends on content type */\n\tparts: any[];\n};\n\n/**\n * Represents a single message in a thread.\n *\n * @example\n * ```typescript\n * const message: MessageObject = {\n *   role: MessageRole.USER,\n *   content: {\n *     type: \"text\",\n *     parts: [\"Hello, how can you help me?\"]\n *   },\n *   timestamp: Date.now(),\n *   metadata: { source: \"web-ui\" }\n * };\n * ```\n */\nexport type MessageObject = {\n\t/** Role of the message sender */\n\trole: MessageRole;\n\t/** Message content with type and parts */\n\tcontent: MessageContentObject;\n\t/** Unix timestamp when the message was created */\n\ttimestamp: number;\n\t/** Optional metadata for additional context */\n\tmetadata?: { [key: string]: unknown };\n};\n\nexport enum ThreadType {\n\tWORKFLOW = \"WORKFLOW\",\n\tCHAT = \"CHAT\",\n}\n\nexport type ThreadMetadata = {\n\ttype: ThreadType;\n\ttitle: string;\n\tthreadId: string;\n\tupdatedAt: number;\n};\n\n/**\n * Represents a conversation thread containing multiple messages.\n *\n * Messages are stored in a key-value structure where keys are unique message IDs\n * and values are the corresponding message objects.\n *\n * @example\n * ```typescript\n * const thread: ThreadObject = {\n * \t title: \"New conversation\",\n *   messages: {\n *     \"<UUID_1>\": { role: MessageRole.USER, content: {...}, timestamp: 1234567890 },\n *     \"<UUID_2>\": { role: MessageRole.MODEL, content: {...}, timestamp: 1234567891 }\n *   }\n * };\n * ```\n */\nexport type ThreadObject = {\n\ttype: ThreadType;\n\ttitle: string;\n\t/* Collection of messages indexed by unique message ID */\n\tmessages: {\n\t\t[messageId: string]: MessageObject;\n\t};\n};\n\nexport interface Intent {\n\tname: string;\n\tdescription: string;\n\tprompt?: string;\n\tllm?: string;\n}\n"],"mappings":";AAGO,IAAK,cAAL,kBAAKA,iBAAL;AAEN,EAAAA,aAAA,UAAO;AAEP,EAAAA,aAAA,YAAS;AAET,EAAAA,aAAA,WAAQ;AANG,SAAAA;AAAA,GAAA;AAgDL,IAAK,aAAL,kBAAKC,gBAAL;AACN,EAAAA,YAAA,cAAW;AACX,EAAAA,YAAA,UAAO;AAFI,SAAAA;AAAA,GAAA;","names":["MessageRole","ThreadType"]}

package/dist/esm/chunk-VA3XOZBV.js

@@ -0,0 +1,17 @@
+import {
+  ThreadApiController
+} from "./chunk-ADIAIRNH.js";
+
+// src/routes/api/thread.routes.ts
+import { Router } from "express";
+var createThreadApiRouter = (memoryModule) => {
+  const router = Router();
+  const threadApiController = new ThreadApiController(memoryModule);
+  router.get("/:id", threadApiController.handleGetThread);
+  return router;
+};
+
+export {
+  createThreadApiRouter
+};
+//# sourceMappingURL=chunk-VA3XOZBV.js.map

package/dist/esm/chunk-VA3XOZBV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routes/api/thread.routes.ts"],"sourcesContent":["import { Router } from \"express\";\nimport { ThreadApiController } from \"@/controllers/api/thread.api.controller.js\";\nimport type { MemoryModule } from \"@/modules/index.js\";\n\nexport const createThreadApiRouter = (memoryModule: MemoryModule): Router => {\n\tconst router = Router();\n\tconst threadApiController = new ThreadApiController(memoryModule);\n\n\t// APIs (prefix: /api/thread)\n\trouter.get(\"/:id\", threadApiController.handleGetThread);\n\n\treturn router;\n};\n"],"mappings":";;;;;AAAA,SAAS,cAAc;AAIhB,IAAM,wBAAwB,CAAC,iBAAuC;AAC5E,QAAM,SAAS,OAAO;AACtB,QAAM,sBAAsB,IAAI,oBAAoB,YAAY;AAGhE,SAAO,IAAI,QAAQ,oBAAoB,eAAe;AAEtD,SAAO;AACR;","names":[]}

package/dist/esm/{chunk-CKTURH34.js → chunk-XBMWWTSX.js}

@@ -1,11 +1,11 @@
 // src/modules/memory/memory.module.ts
 var MemoryModule = class {
   agentMemory;
-  sessionMemory;
+  threadMemory;
   intentMemory;
   constructor(config) {
     this.agentMemory = config.agent;
-    this.sessionMemory = config.session;
+    this.threadMemory = config.thread;
     this.intentMemory = config.intent;
   }
   async initialize() {
@@ -13,8 +13,8 @@ var MemoryModule = class {
     if (this.agentMemory) {
       connectPromises.push(this.agentMemory.connect());
     }
-    if (this.sessionMemory) {
-      connectPromises.push(this.sessionMemory.connect());
+    if (this.threadMemory) {
+      connectPromises.push(this.threadMemory.connect());
     }
     if (this.intentMemory) {
       connectPromises.push(this.intentMemory.connect());
@@ -26,8 +26,8 @@ var MemoryModule = class {
     if (this.agentMemory?.isConnected()) {
       disconnectPromises.push(this.agentMemory.disconnect());
     }
-    if (this.sessionMemory?.isConnected()) {
-      disconnectPromises.push(this.sessionMemory.disconnect());
+    if (this.threadMemory?.isConnected()) {
+      disconnectPromises.push(this.threadMemory.disconnect());
     }
     if (this.intentMemory?.isConnected()) {
       disconnectPromises.push(this.intentMemory.disconnect());
@@ -37,8 +37,8 @@ var MemoryModule = class {
   getAgentMemory() {
     return this.agentMemory;
   }
-  getSessionMemory() {
-    return this.sessionMemory;
+  getThreadMemory() {
+    return this.threadMemory;
   }
   getIntentMemory() {
     return this.intentMemory;
@@ -48,4 +48,4 @@ var MemoryModule = class {
 export {
   MemoryModule
 };
-//# sourceMappingURL=chunk-CKTURH34.js.map
+//# sourceMappingURL=chunk-XBMWWTSX.js.map

package/dist/esm/chunk-XBMWWTSX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/modules/memory/memory.module.ts"],"sourcesContent":["import type {\n\tIAgentMemory,\n\tIIntentMemory,\n\tIThreadMemory,\n} from \"./base.memory.js\";\n\nexport interface MemoryConfig {\n\tagent?: IAgentMemory;\n\tthread?: IThreadMemory;\n\tintent?: IIntentMemory;\n}\n\nexport class MemoryModule {\n\tprivate agentMemory?: IAgentMemory;\n\tprivate threadMemory?: IThreadMemory;\n\tprivate intentMemory?: IIntentMemory;\n\n\tconstructor(config: MemoryConfig) {\n\t\tthis.agentMemory = config.agent;\n\t\tthis.threadMemory = config.thread;\n\t\tthis.intentMemory = config.intent;\n\t}\n\n\tasync initialize(): Promise<void> {\n\t\tconst connectPromises: Promise<void>[] = [];\n\n\t\tif (this.agentMemory) {\n\t\t\tconnectPromises.push(this.agentMemory.connect());\n\t\t}\n\t\tif (this.threadMemory) {\n\t\t\tconnectPromises.push(this.threadMemory.connect());\n\t\t}\n\t\tif (this.intentMemory) {\n\t\t\tconnectPromises.push(this.intentMemory.connect());\n\t\t}\n\n\t\tawait Promise.all(connectPromises);\n\t}\n\n\tasync shutdown(): Promise<void> {\n\t\tconst disconnectPromises: Promise<void>[] = [];\n\n\t\tif (this.agentMemory?.isConnected()) {\n\t\t\tdisconnectPromises.push(this.agentMemory.disconnect());\n\t\t}\n\t\tif (this.threadMemory?.isConnected()) {\n\t\t\tdisconnectPromises.push(this.threadMemory.disconnect());\n\t\t}\n\t\tif (this.intentMemory?.isConnected()) {\n\t\t\tdisconnectPromises.push(this.intentMemory.disconnect());\n\t\t}\n\n\t\tawait Promise.all(disconnectPromises);\n\t}\n\n\tpublic getAgentMemory(): IAgentMemory | undefined {\n\t\treturn this.agentMemory;\n\t}\n\n\tpublic getThreadMemory(): IThreadMemory | undefined {\n\t\treturn this.threadMemory;\n\t}\n\n\tpublic getIntentMemory(): IIntentMemory | undefined {\n\t\treturn this.intentMemory;\n\t}\n}\n"],"mappings":";AAYO,IAAM,eAAN,MAAmB;AAAA,EACjB;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,QAAsB;AACjC,SAAK,cAAc,OAAO;AAC1B,SAAK,eAAe,OAAO;AAC3B,SAAK,eAAe,OAAO;AAAA,EAC5B;AAAA,EAEA,MAAM,aAA4B;AACjC,UAAM,kBAAmC,CAAC;AAE1C,QAAI,KAAK,aAAa;AACrB,sBAAgB,KAAK,KAAK,YAAY,QAAQ,CAAC;AAAA,IAChD;AACA,QAAI,KAAK,cAAc;AACtB,sBAAgB,KAAK,KAAK,aAAa,QAAQ,CAAC;AAAA,IACjD;AACA,QAAI,KAAK,cAAc;AACtB,sBAAgB,KAAK,KAAK,aAAa,QAAQ,CAAC;AAAA,IACjD;AAEA,UAAM,QAAQ,IAAI,eAAe;AAAA,EAClC;AAAA,EAEA,MAAM,WAA0B;AAC/B,UAAM,qBAAsC,CAAC;AAE7C,QAAI,KAAK,aAAa,YAAY,GAAG;AACpC,yBAAmB,KAAK,KAAK,YAAY,WAAW,CAAC;AAAA,IACtD;AACA,QAAI,KAAK,cAAc,YAAY,GAAG;AACrC,yBAAmB,KAAK,KAAK,aAAa,WAAW,CAAC;AAAA,IACvD;AACA,QAAI,KAAK,cAAc,YAAY,GAAG;AACrC,yBAAmB,KAAK,KAAK,aAAa,WAAW,CAAC;AAAA,IACvD;AAEA,UAAM,QAAQ,IAAI,kBAAkB;AAAA,EACrC;AAAA,EAEO,iBAA2C;AACjD,WAAO,KAAK;AAAA,EACb;AAAA,EAEO,kBAA6C;AACnD,WAAO,KAAK;AAAA,EACb;AAAA,EAEO,kBAA6C;AACnD,WAAO,KAAK;AAAA,EACb;AACD;","names":[]}

package/dist/esm/controllers/a2a.controller.d.ts

@@ -12,9 +12,9 @@ import '../modules/mcp/mcp.module.js';
 import '../types/mcp.js';
 import '@modelcontextprotocol/sdk/client/stdio.js';
 import '../modules/mcp/mcp.tool.js';
+import '../types/memory.js';
 import '../modules/memory/memory.module.js';
 import '../modules/memory/base.memory.js';
-import '../types/memory.js';
 import '../modules/models/model.module.js';
 import '../modules/models/base.model.js';
 import '../types/stream.js';

package/dist/esm/controllers/api/{session.api.controller.d.ts → thread.api.controller.d.ts}

@@ -3,10 +3,10 @@ import { MemoryModule } from '../../modules/memory/memory.module.js';
 import '../../modules/memory/base.memory.js';
 import '../../types/memory.js';
 
-declare class SessionApiController {
+declare class ThreadApiController {
     private memoryModule;
     constructor(memoryModule: MemoryModule);
-    handleSessionHistory: (req: Request, res: Response, next: NextFunction) => Promise<void>;
+    handleGetThread: (req: Request, res: Response, next: NextFunction) => Promise<void>;
 }
 
-export { SessionApiController };
+export { ThreadApiController };

package/dist/esm/controllers/api/thread.api.controller.js

@@ -0,0 +1,8 @@
+import {
+  ThreadApiController
+} from "../../chunk-ADIAIRNH.js";
+import "../../chunk-FL3JRQM4.js";
+export {
+  ThreadApiController
+};
+//# sourceMappingURL=thread.api.controller.js.map

package/dist/esm/controllers/index.d.ts

@@ -1,6 +1,6 @@
 export { A2AController } from './a2a.controller.js';
 export { ModelApiController } from './api/model.api.controller.js';
-export { SessionApiController } from './api/session.api.controller.js';
+export { ThreadApiController } from './api/thread.api.controller.js';
 export { QueryController } from './query.controller.js';
 import '@a2a-js/sdk';
 import '@a2a-js/sdk/server';
@@ -16,9 +16,9 @@ import '../modules/mcp/mcp.module.js';
 import '../types/mcp.js';
 import '@modelcontextprotocol/sdk/client/stdio.js';
 import '../modules/mcp/mcp.tool.js';
+import '../types/memory.js';
 import '../modules/memory/memory.module.js';
 import '../modules/memory/base.memory.js';
-import '../types/memory.js';
 import '../modules/models/model.module.js';
 import '../modules/models/base.model.js';
 import '../types/stream.js';

package/dist/esm/controllers/index.js

@@ -2,11 +2,11 @@ import {
   ModelApiController
 } from "../chunk-UA44VKFE.js";
 import {
-  SessionApiController
-} from "../chunk-5EPK37PE.js";
+  ThreadApiController
+} from "../chunk-ADIAIRNH.js";
 import {
   QueryController
-} from "../chunk-Q6HHVAO6.js";
+} from "../chunk-7D4SKPIS.js";
 import "../chunk-FL3JRQM4.js";
 import {
   A2AController
@@ -16,6 +16,6 @@ export {
   A2AController,
   ModelApiController,
   QueryController,
-  SessionApiController
+  ThreadApiController
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/controllers/query.controller.d.ts

@@ -11,9 +11,9 @@ import '../modules/mcp/mcp.module.js';
 import '../types/mcp.js';
 import '@modelcontextprotocol/sdk/client/stdio.js';
 import '../modules/mcp/mcp.tool.js';
+import '../types/memory.js';
 import '../modules/memory/memory.module.js';
 import '../modules/memory/base.memory.js';
-import '../types/memory.js';
 import '../modules/models/model.module.js';
 import '../modules/models/base.model.js';
 import '../types/stream.js';

package/dist/esm/controllers/query.controller.js

@@ -1,6 +1,7 @@
 import {
   QueryController
-} from "../chunk-Q6HHVAO6.js";
+} from "../chunk-7D4SKPIS.js";
+import "../chunk-FL3JRQM4.js";
 export {
   QueryController
 };

package/dist/esm/index.d.ts

@@ -103,6 +103,7 @@ declare class AINAgent {
      * - GET / - Health check endpoint
      * - GET /.well-known/agent.json - Agent card discovery endpoint
      * - /query/* - Query processing endpoints
+     * - /api/* - API endpoints for agent management
      * - /a2a/* - A2A protocol endpoints (only if valid URL is configured)
      */
     private initializeRoutes;

package/dist/esm/index.js

@@ -1,16 +1,16 @@
 import "./chunk-XYCWK2ZM.js";
 import {
   createApiRouter
-} from "./chunk-YT6PD6UF.js";
-import "./chunk-2Z7GJVJJ.js";
-import "./chunk-QROUPWWO.js";
+} from "./chunk-HOFAK5J2.js";
+import "./chunk-AMRKK46V.js";
+import "./chunk-VA3XOZBV.js";
 import {
   createQueryRouter
-} from "./chunk-GNWF6QG4.js";
-import "./chunk-3NEV3O2X.js";
+} from "./chunk-G37LGM6P.js";
+import "./chunk-M4EJC7LZ.js";
 import "./chunk-UA44VKFE.js";
-import "./chunk-5EPK37PE.js";
-import "./chunk-Q6HHVAO6.js";
+import "./chunk-ADIAIRNH.js";
+import "./chunk-7D4SKPIS.js";
 import {
   AuthMiddleware
 } from "./chunk-PN6NMQBM.js";
@@ -20,11 +20,11 @@ import {
 } from "./chunk-MAU2MAK2.js";
 import {
   createA2ARouter
-} from "./chunk-5N4X25IK.js";
-import "./chunk-Y6E73I7I.js";
-import "./chunk-DRUCJYPJ.js";
-import "./chunk-VAZWF5IK.js";
+} from "./chunk-KMQX6T56.js";
+import "./chunk-2RW77MJB.js";
+import "./chunk-A65XRRHY.js";
 import "./chunk-HAE333YO.js";
+import "./chunk-MNAWSBYP.js";
 import "./chunk-FI2UQLVC.js";
 import {
   loggers
@@ -621,8 +621,8 @@ var AINAgent = class {
   initializeMiddlewares() {
     this.app.use(helmet());
     this.app.use(cors());
-    this.app.use(express.json());
-    this.app.use(express.urlencoded({ extended: true }));
+    this.app.use(express.json({ limit: "25mb" }));
+    this.app.use(express.urlencoded({ limit: "25mb", extended: true }));
   }
   /**
    * Validates if a string is a valid HTTP or HTTPS URL.
@@ -681,6 +681,7 @@ var AINAgent = class {
    * - GET / - Health check endpoint
    * - GET /.well-known/agent.json - Agent card discovery endpoint
    * - /query/* - Query processing endpoints
+   * - /api/* - API endpoints for agent management
    * - /a2a/* - A2A protocol endpoints (only if valid URL is configured)
    */
   initializeRoutes = (allowStream = false) => {