@ainetwork/adk 0.0.2 → 0.1.1

package/dist/esm/chunk-ILFWNK3W.js

@@ -0,0 +1,22 @@
+import {
+  logger
+} from "./chunk-64GEXWSE.js";
+
+// src/middlewares/error.middleware.ts
+var errorMiddleware = (error, req, res, next) => {
+  try {
+    const status = error.status || 500;
+    const message = error.message || "Something went wrong";
+    logger.error(
+      `[${req.method}] ${req.path} >> StatusCode:: ${status}, Message:: ${message}`
+    );
+    res.status(status).json({ message });
+  } catch (error2) {
+    next(error2);
+  }
+};
+
+export {
+  errorMiddleware
+};
+//# sourceMappingURL=chunk-ILFWNK3W.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/middlewares/error.middleware.ts"],"sourcesContent":["import type { NextFunction, Request, Response } from \"express\";\nimport type { AinHttpError } from \"@/types/agent\";\nimport { logger } from \"@/utils/logger\";\n\nexport const errorMiddleware = (\n\terror: AinHttpError,\n\treq: Request,\n\tres: Response,\n\tnext: NextFunction,\n): void => {\n\ttry {\n\t\tconst status: number = error.status || 500;\n\t\tconst message: string = error.message || \"Something went wrong\";\n\n\t\tlogger.error(\n\t\t\t`[${req.method}] ${req.path} >> StatusCode:: ${status}, Message:: ${message}`,\n\t\t);\n\t\tres.status(status).json({ message });\n\t} catch (error) {\n\t\tnext(error);\n\t}\n};\n"],"mappings":";;;;;AAIO,IAAM,kBAAkB,CAC9B,OACA,KACA,KACA,SACU;AACV,MAAI;AACH,UAAM,SAAiB,MAAM,UAAU;AACvC,UAAM,UAAkB,MAAM,WAAW;AAEzC,WAAO;AAAA,MACN,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,oBAAoB,MAAM,eAAe,OAAO;AAAA,IAC5E;AACA,QAAI,OAAO,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC;AAAA,EACpC,SAASA,QAAO;AACf,SAAKA,MAAK;AAAA,EACX;AACD;","names":["error"]}

package/dist/esm/chunk-KJ4MVCYE.js

@@ -0,0 +1,8 @@
+// src/modules/auth/base.auth.ts
+var BaseAuth = class {
+};
+
+export {
+  BaseAuth
+};
+//# sourceMappingURL=chunk-KJ4MVCYE.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/modules/auth/base.auth.ts"],"sourcesContent":["import type { Request, Response } from \"express\";\n\nexport abstract class BaseAuth {\n\tabstract authenticate(req: Request, res: Response): Promise<boolean>;\n}\n"],"mappings":";AAEO,IAAe,WAAf,MAAwB;AAE/B;","names":[]}

package/dist/esm/chunk-KUMCCCED.js

@@ -0,0 +1,8 @@
+// src/modules/memory/base.memory.ts
+var BaseMemory = class {
+};
+
+export {
+  BaseMemory
+};
+//# sourceMappingURL=chunk-KUMCCCED.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/modules/memory/base.memory.ts"],"sourcesContent":["import type { ChatObject, SessionObject } from \"@/types/memory.js\";\n\n/**\n * Abstract base class for memory storage implementations.\n *\n * Provides an interface for storing and retrieving conversation history\n * and query-intent pairs. Implementations can use various backends\n * such as in-memory storage, databases, or file systems.\n */\nexport abstract class BaseMemory {\n\t/**\n\t * Retrieves the conversation history for a specific session.\n\t *\n\t * @param sessionId - Unique identifier for the session\n\t * @returns Promise resolving to the session's conversation history\n\t */\n\tabstract getSessionHistory(sessionId: string): Promise<SessionObject>;\n\t/**\n\t * Adds a new chat message to the session history.\n\t *\n\t * @param sessionId - Unique identifier for the session\n\t * @param chat - The chat object to add to the history\n\t */\n\tabstract updateSessionHistory(\n\t\tsessionId: string,\n\t\tchat: ChatObject,\n\t): Promise<void>;\n\t/**\n\t * Stores a query-intent pair for analysis or training purposes.\n\t *\n\t * @param query - The user's input query\n\t * @param intent - The detected intent for the query\n\t * @param sessionId - Unique identifier for the session\n\t */\n\tabstract storeQueryAndIntent(\n\t\tquery: string,\n\t\tintent: string,\n\t\tsessionId: string,\n\t): Promise<void>;\n}\n"],"mappings":";AASO,IAAe,aAAf,MAA0B;AA8BjC;","names":[]}

package/dist/esm/chunk-M4HGSCXF.js

@@ -0,0 +1,17 @@
+import {
+  SessionApiController
+} from "./chunk-X47DAWPH.js";
+
+// src/routes/api/sessions.routes.ts
+import { Router } from "express";
+var createSessionApiRouter = (memoryModule) => {
+  const router = Router();
+  const sessionApiController = new SessionApiController(memoryModule);
+  router.get("/:id", sessionApiController.handleSessionHistory);
+  return router;
+};
+
+export {
+  createSessionApiRouter
+};
+//# sourceMappingURL=chunk-M4HGSCXF.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routes/api/sessions.routes.ts"],"sourcesContent":["import { Router } from \"express\";\nimport { SessionApiController } from \"@/controllers/api/session.api.controller.js\";\nimport type { MemoryModule } from \"@/modules/index.js\";\n\nexport const createSessionApiRouter = (memoryModule: MemoryModule): Router => {\n\tconst router = Router();\n\tconst sessionApiController = new SessionApiController(memoryModule);\n\n\t// APIs (prefix: /api/sessions)\n\trouter.get(\"/:id\", sessionApiController.handleSessionHistory);\n\n\treturn router;\n};\n"],"mappings":";;;;;AAAA,SAAS,cAAc;AAIhB,IAAM,yBAAyB,CAAC,iBAAuC;AAC7E,QAAM,SAAS,OAAO;AACtB,QAAM,uBAAuB,IAAI,qBAAqB,YAAY;AAGlE,SAAO,IAAI,QAAQ,qBAAqB,oBAAoB;AAE5D,SAAO;AACR;","names":[]}

package/dist/esm/chunk-PHKK5NHK.js

@@ -0,0 +1,52 @@
+// src/modules/models/model.module.ts
+var ModelModule = class {
+  /** Registry of available models indexed by name */
+  models = {};
+  /** Name of the default model to use when none specified */
+  defaultModelName;
+  /**
+   * Registers a new model with the module.
+   *
+   * @param name - Unique identifier for the model
+   * @param model - Model instance implementing BaseModel
+   * @param isDefault - Whether to set this as the default model
+   */
+  addModel(name, model, isDefault) {
+    this.models[name] = model;
+    if (isDefault || !this.defaultModelName) {
+      this.defaultModelName = name;
+    }
+  }
+  /**
+   * Retrieves a model by name or returns the default model.
+   *
+   * @param name - Optional model name to retrieve
+   * @returns The requested model or default model if name not provided
+   * @throws Error if no default model is set and name is not provided
+   */
+  getModel(name) {
+    if (!this.defaultModelName) {
+      throw Error("No default model");
+    }
+    if (!name || !this.models[name]) {
+      return this.models[this.defaultModelName];
+    }
+    return this.models[name];
+  }
+  /**
+   * Returns information about all registered models.
+   *
+   * @returns Object containing all models and the default model name
+   */
+  getModelList() {
+    return {
+      models: Object.keys(this.models),
+      defaultModelName: this.defaultModelName
+    };
+  }
+};
+
+export {
+  ModelModule
+};
+//# sourceMappingURL=chunk-PHKK5NHK.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/modules/models/model.module.ts"],"sourcesContent":["import type { BaseModel } from \"./base.model.js\";\n\n/*\n * Module for managing multiple AI model implementations.\n *\n * Allows registration of multiple models and provides a unified interface\n * for accessing them. Supports setting a default model for convenience.\n *\n * @example\n * ```typescript\n * const modelModule = new ModelModule();\n * modelModule.addModel(\"gpt-4\", new OpenAIModel(\"gpt-4\"), true);\n * modelModule.addModel(\"gemini\", new GeminiModel(\"gemini-pro\"));\n *\n * const defaultModel = modelModule.getModel();\n * const specificModel = modelModule.getModel(\"gemini\");\n * ```\n */\nexport class ModelModule {\n\t/** Registry of available models indexed by name */\n\tprivate models: { [name: string]: BaseModel<unknown, unknown> } = {};\n\t/** Name of the default model to use when none specified */\n\tprivate defaultModelName?: string;\n\n\t/**\n\t * Registers a new model with the module.\n\t *\n\t * @param name - Unique identifier for the model\n\t * @param model - Model instance implementing BaseModel\n\t * @param isDefault - Whether to set this as the default model\n\t */\n\tpublic addModel(\n\t\tname: string,\n\t\tmodel: BaseModel<unknown, unknown>,\n\t\tisDefault?: boolean,\n\t) {\n\t\tthis.models[name] = model;\n\t\tif (isDefault || !this.defaultModelName) {\n\t\t\tthis.defaultModelName = name;\n\t\t}\n\t}\n\n\t/**\n\t * Retrieves a model by name or returns the default model.\n\t *\n\t * @param name - Optional model name to retrieve\n\t * @returns The requested model or default model if name not provided\n\t * @throws Error if no default model is set and name is not provided\n\t */\n\tpublic getModel(name?: string): BaseModel<unknown, unknown> {\n\t\tif (!this.defaultModelName) {\n\t\t\tthrow Error(\"No default model\");\n\t\t}\n\n\t\tif (!name || !this.models[name]) {\n\t\t\treturn this.models[this.defaultModelName];\n\t\t}\n\t\treturn this.models[name];\n\t}\n\n\t/**\n\t * Returns information about all registered models.\n\t *\n\t * @returns Object containing all models and the default model name\n\t */\n\tpublic getModelList() {\n\t\treturn {\n\t\t\tmodels: Object.keys(this.models),\n\t\t\tdefaultModelName: this.defaultModelName,\n\t\t};\n\t}\n}\n"],"mappings":";AAkBO,IAAM,cAAN,MAAkB;AAAA;AAAA,EAEhB,SAA0D,CAAC;AAAA;AAAA,EAE3D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASD,SACN,MACA,OACA,WACC;AACD,SAAK,OAAO,IAAI,IAAI;AACpB,QAAI,aAAa,CAAC,KAAK,kBAAkB;AACxC,WAAK,mBAAmB;AAAA,IACzB;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASO,SAAS,MAA4C;AAC3D,QAAI,CAAC,KAAK,kBAAkB;AAC3B,YAAM,MAAM,kBAAkB;AAAA,IAC/B;AAEA,QAAI,CAAC,QAAQ,CAAC,KAAK,OAAO,IAAI,GAAG;AAChC,aAAO,KAAK,OAAO,KAAK,gBAAgB;AAAA,IACzC;AACA,WAAO,KAAK,OAAO,IAAI;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,eAAe;AACrB,WAAO;AAAA,MACN,QAAQ,OAAO,KAAK,KAAK,MAAM;AAAA,MAC/B,kBAAkB,KAAK;AAAA,IACxB;AAAA,EACD;AACD;","names":[]}

package/dist/esm/chunk-SQWZXP4P.js

@@ -0,0 +1,168 @@
+import {
+  A2ATool
+} from "./chunk-DGH3GB5I.js";
+import {
+  loggers
+} from "./chunk-64GEXWSE.js";
+
+// src/modules/a2a/a2a.module.ts
+import { randomUUID } from "crypto";
+import { A2AClient } from "@a2a-js/sdk/client";
+var A2AModule = class {
+  /** Map of A2A server URLs to their corresponding tool instances */
+  a2aPeerServers = /* @__PURE__ */ new Map();
+  /** Map of session IDs to their A2A session state */
+  a2aSessions = /* @__PURE__ */ new Map();
+  /**
+   * Registers a new A2A peer server URL for connection.
+   *
+   * @param url - The URL of the A2A-compatible agent to connect to
+   */
+  async addA2APeerServer(url) {
+    this.a2aPeerServers.set(url, null);
+  }
+  /**
+   * Retrieves tools from all registered A2A peer servers.
+   *
+   * Attempts to connect to each registered server, fetch their agent cards,
+   * and create tool instances. Disables tools for unreachable servers.
+   *
+   * @returns Promise resolving to array of available A2A tools
+   */
+  async getTools() {
+    const tools = [];
+    for (const url of [...this.a2aPeerServers.keys()]) {
+      const tool = this.a2aPeerServers.get(url);
+      if (!tool || !tool.enabled) {
+        try {
+          const client = new A2AClient(url);
+          const card = await client.getAgentCard();
+          const toolName = card.name.replaceAll(" ", "-");
+          const a2aTool = new A2ATool(toolName, client, card);
+          tools.push(a2aTool);
+        } catch (_error) {
+          if (tool) {
+            tool.disable();
+          }
+        }
+      } else {
+        tools.push(tool);
+      }
+    }
+    return tools;
+  }
+  /**
+   * Gets or creates an A2A session for the given session ID.
+   *
+   * @param sessionId - The session identifier
+   * @returns A2ASession object with task and context IDs
+   */
+  getA2ASessionWithId = (sessionId) => {
+    const a2aSession = this.a2aSessions.get(sessionId) ?? {
+      taskId: void 0,
+      contextId: void 0
+    };
+    if (!this.a2aSessions.has(sessionId)) {
+      this.a2aSessions.set(sessionId, a2aSession);
+    }
+    return a2aSession;
+  };
+  /**
+   * Constructs a message payload for A2A communication.
+   *
+   * Includes session context (task ID and context ID) if available
+   * for maintaining conversation continuity.
+   *
+   * @param query - The message content to send
+   * @param sessionId - The session identifier
+   * @returns Formatted Message object for A2A protocol
+   */
+  getMessagePayload(query, sessionId) {
+    const messagePayload = {
+      messageId: randomUUID(),
+      kind: "message",
+      role: "user",
+      // FIXME: it could be 'agent'
+      metadata: {
+        sessionId
+      },
+      parts: [
+        {
+          kind: "text",
+          text: query
+        }
+      ]
+    };
+    const a2aSession = this.getA2ASessionWithId(sessionId);
+    if (a2aSession.taskId) {
+      messagePayload.taskId = a2aSession.taskId;
+    }
+    if (a2aSession.contextId) {
+      messagePayload.contextId = a2aSession.contextId;
+    }
+    return messagePayload;
+  }
+  /**
+   * Executes an A2A tool by sending a message to the remote agent.
+   *
+   * Handles streaming responses, maintains session state, and extracts
+   * text content from various event types in the response stream.
+   *
+   * @param tool - The A2ATool instance to use
+   * @param messagePayload - The message to send to the agent
+   * @param sessionId - The session identifier for context tracking
+   * @returns Promise resolving to array of text responses from the agent
+   */
+  async useTool(tool, messagePayload, sessionId) {
+    const finalText = [];
+    const client = tool.client;
+    const params = {
+      message: messagePayload
+    };
+    const a2aSession = this.getA2ASessionWithId(sessionId);
+    try {
+      const stream = client.sendMessageStream(params);
+      for await (const event of stream) {
+        if (event.kind === "status-update") {
+          const typedEvent = event;
+          if (typedEvent.final && typedEvent.status.state !== "input-required") {
+            a2aSession.taskId = void 0;
+          }
+          const texts = typedEvent.status.message?.parts.filter((part) => part.kind === "text").map((part) => part.text).join("\n");
+          if (texts) {
+            finalText.push(texts);
+          }
+        } else if (event.kind === "message") {
+          const msg = event;
+          if (msg.taskId && msg.taskId !== a2aSession.taskId) {
+            a2aSession.taskId = msg.taskId;
+          }
+          if (msg.contextId && msg.contextId !== a2aSession.contextId) {
+            a2aSession.contextId = msg.contextId;
+          }
+        } else if (event.kind === "task") {
+          const task = event;
+          if (task.id !== a2aSession.taskId) {
+            a2aSession.taskId = task.id;
+          }
+          if (task.contextId && task.contextId !== a2aSession.contextId) {
+            a2aSession.contextId = task.contextId;
+          }
+        } else {
+          loggers.a2a.warn("Received unknown event structure from stream:", {
+            event
+          });
+        }
+      }
+    } catch (error) {
+      loggers.a2a.error("Error communicating with agent:", { error });
+      tool.disable();
+    }
+    return finalText;
+  }
+};
+
+export {
+  A2AModule
+};
+//# sourceMappingURL=chunk-SQWZXP4P.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/modules/a2a/a2a.module.ts"],"sourcesContent":["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: unknown) {\n\t\t\tloggers.a2a.error(\"Error communicating with agent:\", { error });\n\t\t\ttool.disable();\n\t\t\t// TODO: add failed & disabled text for next inference?\n\t\t}\n\n\t\treturn finalText;\n\t}\n}\n"],"mappings":"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","names":[]}

package/dist/esm/chunk-TMHRCGTE.js

@@ -0,0 +1,20 @@
+// src/types/memory.ts
+var MemoryType = /* @__PURE__ */ ((MemoryType2) => {
+  MemoryType2["_DEFAULT"] = "_DEFAULT";
+  MemoryType2["SESSION"] = "SESSION";
+  MemoryType2["INTENT"] = "INTENT";
+  MemoryType2["USER"] = "USER";
+  return MemoryType2;
+})(MemoryType || {});
+var ChatRole = /* @__PURE__ */ ((ChatRole2) => {
+  ChatRole2["USER"] = "USER";
+  ChatRole2["SYSTEM"] = "SYSTEM";
+  ChatRole2["MODEL"] = "MODEL";
+  return ChatRole2;
+})(ChatRole || {});
+
+export {
+  MemoryType,
+  ChatRole
+};
+//# sourceMappingURL=chunk-TMHRCGTE.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/memory.ts"],"sourcesContent":["export enum MemoryType {\n\t_DEFAULT = \"_DEFAULT\",\n\tSESSION = \"SESSION\",\n\tINTENT = \"INTENT\",\n\tUSER = \"USER\",\n}\n\n/**\n * Roles for participants in a chat conversation.\n */\nexport enum ChatRole {\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 chat messages.\n *\n * Supports multi-part content with different types (text, images, etc.).\n */\nexport type ChatContentObject = {\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 chat conversation.\n *\n * @example\n * ```typescript\n * const message: ChatObject = {\n *   role: ChatRole.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 ChatObject = {\n\t/** Role of the message sender */\n\trole: ChatRole;\n\t/** Message content with type and parts */\n\tcontent: ChatContentObject;\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\n/**\n * Represents a conversation session containing multiple chat messages.\n *\n * Messages are stored in a key-value structure where keys are unique chat IDs\n * and values are the corresponding chat objects.\n *\n * @example\n * ```typescript\n * const session: SessionObject = {\n *   chats: {\n *     \"<UUID_1>\": { role: ChatRole.USER, content: {...}, timestamp: 1234567890 },\n *     \"<UUID_2>\": { role: ChatRole.MODEL, content: {...}, timestamp: 1234567891 }\n *   }\n * };\n * ```\n */\nexport type SessionObject = {\n\t/** Collection of chat messages indexed by unique chat ID */\n\tchats: {\n\t\t[chatId: string]: ChatObject;\n\t};\n};\n"],"mappings":";AAAO,IAAK,aAAL,kBAAKA,gBAAL;AACN,EAAAA,YAAA,cAAW;AACX,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,YAAS;AACT,EAAAA,YAAA,UAAO;AAJI,SAAAA;AAAA,GAAA;AAUL,IAAK,WAAL,kBAAKC,cAAL;AAEN,EAAAA,UAAA,UAAO;AAEP,EAAAA,UAAA,YAAS;AAET,EAAAA,UAAA,WAAQ;AANG,SAAAA;AAAA,GAAA;","names":["MemoryType","ChatRole"]}

package/dist/esm/chunk-UA44VKFE.js

@@ -0,0 +1,20 @@
+// src/controllers/api/model.api.controller.ts
+var ModelApiController = class {
+  modelModule;
+  constructor(modelModule) {
+    this.modelModule = modelModule;
+  }
+  handleModelList = (_req, res, next) => {
+    try {
+      const models = this.modelModule.getModelList();
+      res.json(models);
+    } catch (error) {
+      next(error);
+    }
+  };
+};
+
+export {
+  ModelApiController
+};
+//# sourceMappingURL=chunk-UA44VKFE.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/api/model.api.controller.ts"],"sourcesContent":["import type { NextFunction, Request, Response } from \"express\";\nimport type { ModelModule } from \"@/modules/index.js\";\n\nexport class ModelApiController {\n\tprivate modelModule: ModelModule;\n\n\tconstructor(modelModule: ModelModule) {\n\t\tthis.modelModule = modelModule;\n\t}\n\n\tpublic handleModelList = (\n\t\t_req: Request,\n\t\tres: Response,\n\t\tnext: NextFunction,\n\t) => {\n\t\ttry {\n\t\t\tconst models = this.modelModule.getModelList();\n\t\t\tres.json(models);\n\t\t} catch (error) {\n\t\t\tnext(error);\n\t\t}\n\t};\n}\n"],"mappings":";AAGO,IAAM,qBAAN,MAAyB;AAAA,EACvB;AAAA,EAER,YAAY,aAA0B;AACrC,SAAK,cAAc;AAAA,EACpB;AAAA,EAEO,kBAAkB,CACxB,MACA,KACA,SACI;AACJ,QAAI;AACH,YAAM,SAAS,KAAK,YAAY,aAAa;AAC7C,UAAI,KAAK,MAAM;AAAA,IAChB,SAAS,OAAO;AACf,WAAK,KAAK;AAAA,IACX;AAAA,EACD;AACD;","names":[]}

package/dist/esm/chunk-UZQZXNND.js

@@ -0,0 +1,22 @@
+import {
+  createModelApiRouter
+} from "./chunk-2Z7GJVJJ.js";
+import {
+  createSessionApiRouter
+} from "./chunk-M4HGSCXF.js";
+
+// src/routes/api.routes.ts
+import { Router } from "express";
+var createApiRouter = (agent) => {
+  const router = Router();
+  router.use("/api/models", createModelApiRouter(agent.modelModule));
+  if (agent.memoryModule) {
+    router.use("/api/sessions", createSessionApiRouter(agent.memoryModule));
+  }
+  return router;
+};
+
+export {
+  createApiRouter
+};
+//# sourceMappingURL=chunk-UZQZXNND.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/routes/api.routes.ts"],"sourcesContent":["import { Router } from \"express\";\nimport type { AINAgent } from \"@/index.js\";\n\nimport { createModelApiRouter } from \"./api/models.routes.js\";\nimport { createSessionApiRouter } from \"./api/sessions.routes.js\";\n\nexport const createApiRouter = (agent: AINAgent): Router => {\n\tconst router = Router();\n\n\trouter.use(\"/api/models\", createModelApiRouter(agent.modelModule));\n\tif (agent.memoryModule) {\n\t\trouter.use(\"/api/sessions\", createSessionApiRouter(agent.memoryModule));\n\t}\n\n\treturn router;\n};\n"],"mappings":";;;;;;;;AAAA,SAAS,cAAc;AAMhB,IAAM,kBAAkB,CAAC,UAA4B;AAC3D,QAAM,SAAS,OAAO;AAEtB,SAAO,IAAI,eAAe,qBAAqB,MAAM,WAAW,CAAC;AACjE,MAAI,MAAM,cAAc;AACvB,WAAO,IAAI,iBAAiB,uBAAuB,MAAM,YAAY,CAAC;AAAA,EACvE;AAEA,SAAO;AACR;","names":[]}

package/dist/esm/chunk-WZBXLGQK.js

@@ -0,0 +1,171 @@
+import {
+  loggers
+} from "./chunk-64GEXWSE.js";
+
+// src/services/query.service.ts
+var QueryService = 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 a user query.
+   *
+   * @param query - The user's input query
+   * @returns The detected intent (currently returns the query as-is)
+   * @todo Implement actual intent detection logic
+   */
+  async intentTriggering(query) {
+    return query;
+  }
+  /**
+   * 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 sessionId - Session identifier for context
+   * @param sessionHistory - Previous conversation history
+   * @returns Object containing process steps and final response
+   */
+  async intentFulfilling(query, sessionId, sessionHistory) {
+    const systemPrompt = `
+Today is ${(/* @__PURE__ */ new Date()).toLocaleDateString()}.
+
+${this.prompts?.agent || ""}
+
+${this.prompts?.system || ""}
+    `;
+    const modelInstance = this.modelModule.getModel();
+    const messages = modelInstance.generateMessages({
+      query,
+      sessionHistory,
+      systemPrompt: systemPrompt.trim()
+    });
+    const tools = [];
+    if (this.mcpModule) {
+      tools.push(...this.mcpModule.getTools());
+    }
+    if (this.a2aModule) {
+      tools.push(...await this.a2aModule.getTools());
+    }
+    const functions = modelInstance.convertToolsToFunctions(tools);
+    const processList = [];
+    let finalMessage = "";
+    let didCallTool = false;
+    while (true) {
+      const response = await modelInstance.fetchWithContextMessage(
+        messages,
+        functions
+      );
+      didCallTool = false;
+      loggers.intent.debug("messages", { messages });
+      const { content, toolCalls } = response;
+      loggers.intent.debug("content", { content });
+      loggers.intent.debug("tool_calls", { ...toolCalls });
+      if (toolCalls) {
+        const messagePayload = this.a2aModule?.getMessagePayload(
+          query,
+          sessionId
+        );
+        for (const toolCall of toolCalls) {
+          const toolName = toolCall.name;
+          didCallTool = true;
+          const selectedTool = tools.filter((tool) => tool.id === toolName)[0];
+          let toolResult = "";
+          if (this.mcpModule && selectedTool.protocol === "MCP" /* MCP */) {
+            const toolArgs = toolCall.arguments;
+            loggers.intent.debug("MCP tool call", { toolName, toolArgs });
+            const result = await this.mcpModule.useTool(
+              selectedTool,
+              toolArgs
+            );
+            toolResult = `[Bot Called MCP Tool ${toolName} with args ${JSON.stringify(toolArgs)}]
+` + JSON.stringify(result.content, null, 2);
+          } else if (this.a2aModule && selectedTool.protocol === "A2A" /* A2A */) {
+            const result = await this.a2aModule.useTool(
+              selectedTool,
+              messagePayload,
+              sessionId
+            );
+            toolResult = `[Bot Called A2A Tool ${toolName}]
+${result.join("\n")}`;
+          } else {
+            loggers.intent.warn(
+              `Unrecognized tool type: ${selectedTool.protocol}`
+            );
+            continue;
+          }
+          loggers.intent.debug("toolResult", { toolResult });
+          processList.push(toolResult);
+          modelInstance.appendMessages(messages, toolResult);
+        }
+      } else if (content) {
+        processList.push(content);
+        finalMessage = content;
+      }
+      if (!didCallTool) break;
+    }
+    const botResponse = {
+      process: processList.join("\n"),
+      response: finalMessage
+    };
+    return botResponse;
+  }
+  /**
+   * Main entry point for processing user queries.
+   *
+   * Handles the complete query lifecycle:
+   * 1. Loads session history from memory
+   * 2. Detects intent from the query
+   * 3. Fulfills the intent with AI response
+   * 4. Updates conversation history
+   *
+   * @param query - The user's input query
+   * @param sessionId - Unique session identifier
+   * @returns Object containing the AI-generated response
+   */
+  async handleQuery(query, sessionId) {
+    const queryStartAt = Date.now();
+    const memoryInstance = this.memoryModule?.getMemory();
+    const sessionHistory = await memoryInstance?.getSessionHistory(
+      sessionId
+    ) || { chats: {} };
+    const intent = this.intentTriggering(query);
+    const result = await this.intentFulfilling(
+      query,
+      sessionId,
+      sessionHistory
+    );
+    if (sessionId) {
+      await memoryInstance?.updateSessionHistory(sessionId, {
+        role: "USER" /* USER */,
+        timestamp: queryStartAt,
+        content: { type: "text", parts: [query] }
+      });
+      await memoryInstance?.updateSessionHistory(sessionId, {
+        role: "MODEL" /* MODEL */,
+        timestamp: Date.now(),
+        content: { type: "text", parts: [result.response] }
+      });
+    }
+    return { content: result.response };
+  }
+};
+
+export {
+  QueryService
+};
+//# sourceMappingURL=chunk-WZBXLGQK.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/query.service.ts"],"sourcesContent":["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\tconst result = 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\ttoolResult =\n\t\t\t\t\t\t\t`[Bot Called MCP Tool ${toolName} with args ${JSON.stringify(toolArgs)}]\\n` +\n\t\t\t\t\t\t\tJSON.stringify(result.content, null, 2);\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\tconst result = 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\ttoolResult = `[Bot Called A2A Tool ${toolName}]\\n${result.join(\"\\n\")}`;\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 * @returns Object containing the AI-generated response\n\t */\n\tpublic async handleQuery(query: string, sessionId: string) {\n\t\t// 1. Load session history with sessionId\n\t\tconst queryStartAt = Date.now();\n\t\tconst memoryInstance = this.memoryModule?.getMemory();\n\t\tconst sessionHistory = (await memoryInstance?.getSessionHistory(\n\t\t\tsessionId,\n\t\t)) || { chats: {} } /* FIXME */;\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(\n\t\t\tquery,\n\t\t\tsessionId,\n\t\t\tsessionHistory,\n\t\t);\n\t\tif (sessionId) {\n\t\t\tawait memoryInstance?.updateSessionHistory(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 memoryInstance?.updateSessionHistory(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"],"mappings":"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","names":[]}

package/dist/esm/chunk-X47DAWPH.js

@@ -0,0 +1,34 @@
+import {
+  AinHttpError
+} from "./chunk-FL3JRQM4.js";
+
+// src/controllers/api/session.api.controller.ts
+import { StatusCodes } from "http-status-codes";
+var SessionApiController = class {
+  memoryModule;
+  constructor(memoryModule) {
+    this.memoryModule = memoryModule;
+  }
+  handleSessionHistory = async (req, res, next) => {
+    try {
+      const { id: sessionId } = req.params;
+      const memoryInstance = this.memoryModule.getMemory();
+      if (!memoryInstance) {
+        const error = new AinHttpError(
+          StatusCodes.SERVICE_UNAVAILABLE,
+          "Memory module is not initialized"
+        );
+        throw error;
+      }
+      const session = await memoryInstance.getSessionHistory(sessionId);
+      res.json(session);
+    } catch (error) {
+      next(error);
+    }
+  };
+};
+
+export {
+  SessionApiController
+};
+//# sourceMappingURL=chunk-X47DAWPH.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/api/session.api.controller.ts"],"sourcesContent":["import type { NextFunction, Request, Response } from \"express\";\nimport { StatusCodes } from \"http-status-codes\";\nimport type { MemoryModule } from \"@/modules/index.js\";\nimport { AinHttpError } from \"@/types/agent.js\";\nexport class SessionApiController {\n\tprivate memoryModule: MemoryModule;\n\n\tconstructor(memoryModule: MemoryModule) {\n\t\tthis.memoryModule = memoryModule;\n\t}\n\n\tpublic handleSessionHistory = async (\n\t\treq: Request,\n\t\tres: Response,\n\t\tnext: NextFunction,\n\t) => {\n\t\ttry {\n\t\t\tconst { id: sessionId } = req.params;\n\t\t\tconst memoryInstance = this.memoryModule.getMemory();\n\t\t\tif (!memoryInstance) {\n\t\t\t\tconst error = new AinHttpError(\n\t\t\t\t\tStatusCodes.SERVICE_UNAVAILABLE,\n\t\t\t\t\t\"Memory module is not initialized\",\n\t\t\t\t);\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tconst session = await memoryInstance.getSessionHistory(sessionId);\n\t\t\tres.json(session);\n\t\t} catch (error) {\n\t\t\tnext(error);\n\t\t}\n\t};\n}\n"],"mappings":";;;;;AACA,SAAS,mBAAmB;AAGrB,IAAM,uBAAN,MAA2B;AAAA,EACzB;AAAA,EAER,YAAY,cAA4B;AACvC,SAAK,eAAe;AAAA,EACrB;AAAA,EAEO,uBAAuB,OAC7B,KACA,KACA,SACI;AACJ,QAAI;AACH,YAAM,EAAE,IAAI,UAAU,IAAI,IAAI;AAC9B,YAAM,iBAAiB,KAAK,aAAa,UAAU;AACnD,UAAI,CAAC,gBAAgB;AACpB,cAAM,QAAQ,IAAI;AAAA,UACjB,YAAY;AAAA,UACZ;AAAA,QACD;AACA,cAAM;AAAA,MACP;AACA,YAAM,UAAU,MAAM,eAAe,kBAAkB,SAAS;AAChE,UAAI,KAAK,OAAO;AAAA,IACjB,SAAS,OAAO;AACf,WAAK,KAAK;AAAA,IACX;AAAA,EACD;AACD;","names":[]}