@ainetwork/adk 0.0.1

package/README.md

@@ -0,0 +1,299 @@
+# AI Network Agent Development Kit (AIN-ADK)
+
+A TypeScript library for building AI agents with multi-protocol support including MCP (Model Context Protocol) and A2A (Agent-to-Agent) communication.
+
+# NOTE
+IMPORTANT: This project is currently under active development. Features may be incomplete, and there might be significant changes in future updates. Please be aware that some functionalities may not work as expected or might change without prior notice.
+
+# Features
+
+- **Multi-Protocol Support**: Integrate with MCP servers and A2A agents
+- **Modular Architecture**: Flexible module system for models, memory, MCP, and A2A
+- **Multiple AI Models**: Support for OpenAI and Gemini with easy extensibility
+- **Session Management**: Built-in memory module for conversation history
+- **Dual Build System**: Supports both ESM and CJS formats for maximum compatibility
+- **Structured Logging**: Winston-based logging system with service-specific loggers
+- **TypeScript First**: Built with strict TypeScript configuration
+
+## Installation
+
+```bash
+npm install @ainetwork/adk
+```
+
+## Requirements
+
+- Node.js >= 20
+- TypeScript >= 5.8
+
+## Quick Start
+
+### Basic Agent Setup
+
+```typescript
+import { AINAgent } from '@ainetwork/adk/app';
+import { ModelModule, MCPModule, MemoryModule } from '@ainetwork/adk/modules';
+import { AzureOpenAI } from '@ainetwork/adk/modules/models/openai';
+import { InMemoryMemory } from '@ainetwork/adk/modules/memory/inmemory';
+import { AinAgentManifest } from '@ainetwork/adk/types';
+
+// Initialize modules
+const modelModule = new ModelModule();
+const model = new AzureOpenAI(
+  process.env.AZURE_OPENAI_BASE_URL!,
+  process.env.AZURE_OPENAI_API_KEY!,
+  process.env.AZURE_OPENAI_API_VERSION!,
+  process.env.AZURE_OPENAI_MODEL_NAME!
+);
+modelModule.addModel('azure-gpt-4o', model);
+
+const memoryModule = new MemoryModule(new InMemoryMemory(""));
+
+// Define agent manifest
+const manifest: AinAgentManifest = {
+  name: "My Agent",
+  description: "An intelligent AI agent",
+  version: "0.0.1",
+};
+
+// Create and start agent
+const agent = new AINAgent(manifest, { modelModule, memoryModule });
+agent.start(3000);
+```
+
+### Adding MCP Support
+
+```typescript
+import { MCPModule } from '@ainetwork/adk/modules';
+
+const mcpModule = new MCPModule();
+
+// Add MCP server configuration
+await mcpModule.addMCPConfig({
+  notionApi: {
+    command: 'npx',
+    args: ['-y', '@notionhq/notion-mcp-server'],
+    env: {
+      NOTION_API_KEY: process.env.NOTION_API_KEY!
+    }
+  }
+});
+
+// Pass to agent constructor
+const agent = new AINAgent(manifest, { modelModule, mcpModule, memoryModule });
+```
+
+### Adding A2A Support
+
+```typescript
+import { A2AModule } from '@ainetwork/adk/modules';
+
+// Define agent manifest
+const manifest: AinAgentManifest = {
+  ...,
+  url: "<AGENT_ENDPOINT_URL>"   // configure manifest.url
+};
+
+const agent = new AINAgent(
+  manifest,
+  { modelModule, a2aModule, memoryModule },
+);
+```
+
+## Architecture
+
+### Core Components
+
+- **AINAgent** (`src/app.ts`): Main Express.js server class that orchestrates all modules
+- **ModelModule** (`src/modules/models/`): Manages AI model integrations (OpenAI, Gemini)
+- **MCPModule** (`src/modules/mcp/`): Handles Model Context Protocol connections
+- **A2AModule** (`src/modules/a2a/`): Manages agent-to-agent communication
+- **MemoryModule** (`src/modules/memory/`): Provides session and conversation history
+
+### Module System
+
+The library uses a flexible module architecture:
+
+```typescript
+interface AINAgentModules {
+  modelModule?: ModelModule;
+  mcpModule?: MCPModule;
+  a2aModule?: A2AModule;
+  memoryModule?: MemoryModule;
+}
+```
+
+Each module can be independently configured and passed to the agent constructor.
+
+### Protocol Support
+
+#### MCP (Model Context Protocol)
+- Connects to external MCP servers via stdio
+- Automatic tool discovery and execution
+- Supports multiple concurrent MCP servers
+
+#### A2A (Agent-to-Agent)  
+- RESTful API for inter-agent communication
+- Streaming response support
+- Agent discovery via well-known endpoints
+- Task delegation and context passing
+
+### Key Features
+
+- **Unified Tool Interface**: Protocol-agnostic `IAgentTool` interface
+- **Service Layer**: Clean separation with controllers and services
+- **Type Safety**: Comprehensive TypeScript types throughout
+- **Error Handling**: Global error middleware with structured logging
+- **Authentication**: Optional auth middleware support
+
+## Development
+
+### Scripts
+
+```bash
+# Build commands
+yarn build          # Build both ESM and CJS distributions
+yarn build:esm      # Build ESM format only  
+yarn build:cjs      # Build CJS format only
+
+# Development
+yarn dev            # Run TypeScript directly with tsx
+
+# Code quality
+yarn lint           # Run linting with Biome
+yarn format         # Format code with Biome
+yarn check          # Check code with Biome
+yarn check:write    # Check and auto-fix with Biome
+
+# Testing
+yarn test           # Run Jest tests
+```
+
+### Examples
+
+```bash
+# Run example applications
+npx tsx examples/simpleAgent.ts
+npx tsx examples/a2aClientAgent.ts
+```
+
+## Logging System
+
+The library uses Winston for structured logging with service-specific loggers:
+
+```typescript
+import { getLogger } from '@ainetwork/adk/utils/logger';
+
+// Get service-specific loggers
+const agentLogger = getLogger('agent');
+const mcpLogger = getLogger('mcp');
+const a2aLogger = getLogger('a2a');
+const modelLogger = getLogger('model');
+
+// Usage examples
+agentLogger.info('AINAgent started');
+mcpLogger.debug('Connected to MCP server');
+a2aLogger.warn('A2A connection timeout');
+modelLogger.error('Model API error');
+```
+
+### Available Loggers
+- `agent`: Main agent operations
+- `intent`: Query processing and intent analysis
+- `mcp`: MCP server connections and tool execution
+- `a2a`: Agent-to-agent communication
+- `model`: AI model interactions
+- `server`: HTTP server operations
+- `memory`: Session and memory management
+
+### Log Levels
+- `error`: Error conditions
+- `warn`: Warning conditions  
+- `info`: Informational messages (default)
+- `debug`: Debug-level messages
+
+## API Endpoints
+
+### Standard Endpoints
+- `GET /` - Welcome message
+- `POST /query` - Process queries
+  - Request: `{ message: string, sessionId?: string }`
+  - Response: `{ content: string }`
+
+### A2A Server Endpoints (when `manifest.url` is configured)
+- `GET /agent-card` - Get agent card information
+- `GET /.well-known/agent.json` - Agent discovery endpoint  
+- `POST /a2a` - A2A communication endpoint
+  - Supports streaming responses
+  - Request: `{ message: string, stream?: boolean }`
+
+## Build System
+
+The project supports dual build output:
+
+- **ESM** (`dist/esm/`): ES Module format with `{"type": "module"}`
+- **CJS** (`dist/cjs/`): CommonJS format with `{"type": "commonjs"}`
+
+Import paths use `@/` alias for `src/` directory.
+
+## Models Support
+
+### Built-in Models
+- **OpenAI/Azure OpenAI**: Full support for GPT models
+- **Google Gemini**: Support for Gemini models
+
+### Custom Models
+Extend the `BaseModel` class to add support for other AI models:
+
+```typescript
+import { BaseModel } from '@ainetwork/adk/modules/models/base';
+
+class MyCustomModel extends BaseModel {
+  async generateResponse(messages: any[], tools?: any[]): Promise<any> {
+    // Implement your model logic
+  }
+}
+```
+
+## Error Handling
+
+The library includes comprehensive error handling:
+- Global error middleware for uncaught errors
+- Service-specific error logging
+- Graceful handling of:
+  - MCP server connection failures
+  - A2A agent communication errors  
+  - Model API failures
+  - Tool execution errors
+  - Invalid requests
+
+All errors are logged with appropriate context for debugging.
+
+## Authentication
+
+The library supports optional authentication middleware:
+
+```typescript
+import { BaseAuth } from '@ainetwork/adk/middlewares/auth/base';
+
+class MyAuth extends BaseAuth {
+  async authenticate(req: Request): Promise<boolean> {
+    // Implement your auth logic
+    return true;
+  }
+}
+
+const agent = new AINAgent(manifest, modules, false, new MyAuth());
+```
+
+## Contributing
+
+1. Follow the established code conventions
+2. Use TypeScript strict mode
+3. Add appropriate service-specific logging
+4. Run `yarn check:write` and `yarn test` before submitting
+5. Maintain the modular architecture
+
+## License
+
+MIT

package/dist/cjs/ainagent.d.ts

@@ -0,0 +1,15 @@
+import express from "express";
+import type { IntentAnalyzer } from "./intent/analyzer.js";
+import type { AINAgentInfo } from "./types/index.js";
+export declare class AINAgent {
+    app: express.Application;
+    info: AINAgentInfo;
+    private authScheme?;
+    private sessionManager?;
+    private intentAnalyzer;
+    private a2aRouter?;
+    constructor(intentAnalyzer: IntentAnalyzer, info: AINAgentInfo, url?: string);
+    private infoToCard;
+    start(port: number): void;
+}
+//# sourceMappingURL=ainagent.d.ts.map

package/dist/cjs/ainagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ainagent.d.ts","sourceRoot":"","sources":["../../src/ainagent.ts"],"names":[],"mappings":"AAEA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,qBAAa,QAAQ;IACb,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC;IACzB,IAAI,EAAE,YAAY,CAAC;IAG1B,OAAO,CAAC,UAAU,CAAC,CAAW;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAc;IACrC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAAC,CAAY;gBAG7B,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE,YAAY,EAClB,GAAG,CAAC,EAAE,MAAM;IAeb,OAAO,CAAC,UAAU;IAkBX,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAsChC"}

package/dist/cjs/ainagent.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AINAgent = void 0;
+const cors_1 = __importDefault(require("cors"));
+const express_1 = __importDefault(require("express"));
+const logger_js_1 = require("./utils/logger.js");
+const router_js_1 = require("./router/a2a/router.js");
+class AINAgent {
+    constructor(intentAnalyzer, info, url) {
+        this.app = (0, express_1.default)();
+        this.app.use((0, cors_1.default)());
+        this.app.use(express_1.default.json());
+        this.intentAnalyzer = intentAnalyzer;
+        this.info = info;
+        if (url) {
+            // A2A Server enabled
+            const card = this.infoToCard(info, url);
+            this.a2aRouter = new router_js_1.A2ARouter(intentAnalyzer, card);
+        }
+    }
+    infoToCard(info, url) {
+        const _url = new URL(url);
+        _url.pathname = "a2a";
+        return {
+            ...info,
+            url: _url.toString(),
+            capabilities: {
+                streaming: true, // The new framework supports streaming
+                pushNotifications: false, // Assuming not implemented for this agent yet
+                stateTransitionHistory: true, // Agent uses history
+            },
+            defaultInputModes: ["text"],
+            defaultOutputModes: ["text", "task-status"], // task-status is a common output mode
+            skills: [],
+            supportsAuthenticatedExtendedCard: false,
+        };
+    }
+    start(port) {
+        if (this.authScheme) {
+            this.app.use(this.authScheme.middleware());
+        }
+        this.app.get("/", async (_req, res) => {
+            const { name, description, version } = this.info;
+            res.status(200).send(`
+        ⚡ AIN Agent: ${name} v${version}<br/>
+        ${description}<br/><br/>
+        Agent status: Online and ready.
+      `.trim());
+        });
+        this.app.post("/query", async (req, res) => {
+            const { message, sessionId } = req.body;
+            // load session memory
+            const sessionHistory = (await this.sessionManager?.getSessionHistory(sessionId)) || {};
+            // TODO: Handle query type
+            const response = await this.intentAnalyzer?.handleQueryWithSession(message, sessionId, sessionHistory);
+            res.json(response);
+        });
+        this.a2aRouter?.setupRoutes(this.app);
+        this.app.listen(port, () => {
+            logger_js_1.loggers.agent.info(`AINAgent is running on port ${port}`);
+        });
+    }
+}
+exports.AINAgent = AINAgent;
+//# sourceMappingURL=ainagent.js.map

package/dist/cjs/ainagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ainagent.js","sourceRoot":"","sources":["../../src/ainagent.ts"],"names":[],"mappings":"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"}

package/dist/cjs/app.d.ts

@@ -0,0 +1,102 @@
+import type { AgentCard } from "@a2a-js/sdk";
+import express from "express";
+import type { BaseAuth } from "./middlewares/auth/base.js";
+import type { FOLModule } from "./modules/fol/fol.module.js";
+import type { A2AModule, MCPModule, MemoryModule, ModelModule } from "./modules/index.js";
+import type { AinAgentManifest } from "./types/index.js";
+/**
+ * Main class for AI Network Agent Development Kit (AIN-ADK).
+ *
+ * AINAgent orchestrates all modules and provides an Express server for handling
+ * agent interactions through both standard query endpoints and A2A protocol endpoints.
+ *
+ * @example
+ * ```typescript
+ * const manifest = {
+ *   name: "MyAgent",
+ *   description: "An example AI agent",
+ *   version: "1.0.0"
+ * };
+ *
+ * const agent = new AINAgent(manifest, {
+ *   modelModule: new ModelModule(),
+ *   a2aModule: new A2AModule(),
+ *   mcpModule: new MCPModule()
+ * });
+ *
+ * agent.start(3000);
+ * ```
+ */
+export declare class AINAgent {
+    /** Express application instance */
+    app: express.Application;
+    /** Agent manifest containing metadata and configuration */
+    manifest: AinAgentManifest;
+    /** Modules */
+    modelModule: ModelModule;
+    a2aModule?: A2AModule;
+    mcpModule?: MCPModule;
+    memoryModule?: MemoryModule;
+    folModule?: FOLModule;
+    /** Optional authentication scheme for securing endpoints */
+    authScheme?: BaseAuth;
+    /**
+     * Creates a new AINAgent instance.
+     *
+     * @param manifest - Agent manifest containing name, description, version, and optional URL
+     * @param modules - Required and optional modules for the agent
+     * @param modules.modelModule - Required module for AI model integrations
+     * @param modules.a2aModule - Optional module for A2A protocol support
+     * @param modules.mcpModule - Optional module for MCP server connections
+     * @param modules.memoryModule - Optional module for memory management
+     * @param modules.folModule - Optional module for fol management
+     * @param authScheme - Optional authentication middleware for securing endpoints
+     */
+    constructor(manifest: AinAgentManifest, modules: {
+        modelModule: ModelModule;
+        a2aModule?: A2AModule;
+        mcpModule?: MCPModule;
+        memoryModule?: MemoryModule;
+        folModule?: FOLModule;
+    }, authScheme?: BaseAuth);
+    /**
+     * Initializes Express middlewares for security, CORS, and body parsing.
+     * Also applies authentication middleware if configured.
+     */
+    private initializeMiddlewares;
+    /**
+     * Validates if a string is a valid HTTP or HTTPS URL.
+     *
+     * @param urlString - The URL string to validate
+     * @returns true if the URL is valid HTTP/HTTPS, false otherwise
+     */
+    private isValidUrl;
+    /**
+     * Generates an A2A protocol agent card for discovery.
+     *
+     * The agent card contains metadata about the agent's capabilities,
+     * supported input/output modes, and connection information.
+     *
+     * @returns AgentCard object with agent metadata and capabilities
+     * @throws Error if manifest URL is invalid or missing
+     */
+    generateAgentCard: () => AgentCard;
+    /**
+     * Initializes all HTTP routes including health check, agent discovery,
+     * query endpoints, and optional A2A endpoints.
+     *
+     * Routes initialized:
+     * - GET / - Health check endpoint
+     * - GET /.well-known/agent.json - Agent card discovery endpoint
+     * - /query/* - Query processing endpoints
+     * - /a2a/* - A2A protocol endpoints (only if valid URL is configured)
+     */
+    private initializeRoutes;
+    /**
+     * Starts the Express server on the specified port.
+     *
+     * @param port - The port number to listen on
+     */
+    start(port: number): void;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/cjs/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,OAA0B,MAAM,SAAS,CAAC;AAGjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,MAAM,oBAAoB,CAAC;AAG5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,QAAQ;IACpB,mCAAmC;IAC5B,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC;IAEhC,2DAA2D;IACpD,QAAQ,EAAE,gBAAgB,CAAC;IAElC,cAAc;IACP,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,SAAS,CAAC;IAE7B,4DAA4D;IACrD,UAAU,CAAC,EAAE,QAAQ,CAAC;IAE7B;;;;;;;;;;;OAWG;gBAEF,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE;QACR,WAAW,EAAE,WAAW,CAAC;QACzB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,YAAY,CAAC,EAAE,YAAY,CAAC;QAC5B,SAAS,CAAC,EAAE,SAAS,CAAC;KACtB,EACD,UAAU,CAAC,EAAE,QAAQ;IAqBtB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAalB;;;;;;;;OAQG;IACI,iBAAiB,QAAO,SAAS,CAmBtC;IAEF;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB,CAyBtB;IAEF;;;;OAIG;IACI,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAKhC"}

package/dist/cjs/app.js

@@ -0,0 +1,170 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AINAgent = void 0;
+const cors_1 = __importDefault(require("cors"));
+const express_1 = __importDefault(require("express"));
+const helmet_1 = __importDefault(require("helmet"));
+const http_status_codes_1 = require("http-status-codes");
+const logger_js_1 = require("./utils/logger.js");
+const error_middleware_js_1 = require("./middlewares/error.middleware.js");
+const a2a_routes_js_1 = require("./routes/a2a.routes.js");
+const query_routes_js_1 = require("./routes/query.routes.js");
+/**
+ * Main class for AI Network Agent Development Kit (AIN-ADK).
+ *
+ * AINAgent orchestrates all modules and provides an Express server for handling
+ * agent interactions through both standard query endpoints and A2A protocol endpoints.
+ *
+ * @example
+ * ```typescript
+ * const manifest = {
+ *   name: "MyAgent",
+ *   description: "An example AI agent",
+ *   version: "1.0.0"
+ * };
+ *
+ * const agent = new AINAgent(manifest, {
+ *   modelModule: new ModelModule(),
+ *   a2aModule: new A2AModule(),
+ *   mcpModule: new MCPModule()
+ * });
+ *
+ * agent.start(3000);
+ * ```
+ */
+class AINAgent {
+    /**
+     * Creates a new AINAgent instance.
+     *
+     * @param manifest - Agent manifest containing name, description, version, and optional URL
+     * @param modules - Required and optional modules for the agent
+     * @param modules.modelModule - Required module for AI model integrations
+     * @param modules.a2aModule - Optional module for A2A protocol support
+     * @param modules.mcpModule - Optional module for MCP server connections
+     * @param modules.memoryModule - Optional module for memory management
+     * @param modules.folModule - Optional module for fol management
+     * @param authScheme - Optional authentication middleware for securing endpoints
+     */
+    constructor(manifest, modules, authScheme) {
+        /**
+         * Generates an A2A protocol agent card for discovery.
+         *
+         * The agent card contains metadata about the agent's capabilities,
+         * supported input/output modes, and connection information.
+         *
+         * @returns AgentCard object with agent metadata and capabilities
+         * @throws Error if manifest URL is invalid or missing
+         */
+        this.generateAgentCard = () => {
+            const _url = new URL(this.manifest.url || "");
+            _url.pathname = "a2a";
+            return {
+                name: this.manifest.name,
+                description: this.manifest.description,
+                version: this.manifest.version,
+                url: _url.toString(),
+                capabilities: {
+                    streaming: true, // The new framework supports streaming
+                    pushNotifications: false, // Assuming not implemented for this agent yet
+                    stateTransitionHistory: true, // Agent uses history
+                },
+                defaultInputModes: ["text"],
+                defaultOutputModes: ["text", "task-status"], // task-status is a common output mode
+                skills: [],
+                supportsAuthenticatedExtendedCard: false,
+            };
+        };
+        /**
+         * Initializes all HTTP routes including health check, agent discovery,
+         * query endpoints, and optional A2A endpoints.
+         *
+         * Routes initialized:
+         * - GET / - Health check endpoint
+         * - GET /.well-known/agent.json - Agent card discovery endpoint
+         * - /query/* - Query processing endpoints
+         * - /a2a/* - A2A protocol endpoints (only if valid URL is configured)
+         */
+        this.initializeRoutes = () => {
+            this.app.get("/", async (_, res) => {
+                const { name, description, version } = this.manifest;
+                res.status(200).send(`
+        ⚡ AIN Agent: ${name} v${version}<br/>
+        ${description}<br/><br/>
+        Agent status: Online and ready.
+      `.trim());
+            });
+            this.app.get("/.well-known/agent.json", async (_, res) => {
+                try {
+                    const card = this.generateAgentCard();
+                    res.json(card);
+                }
+                catch (_error) {
+                    res.status(http_status_codes_1.StatusCodes.NOT_FOUND).send("No agent card");
+                }
+            });
+            this.app.use((0, query_routes_js_1.createQueryRouter)(this));
+            if (this.isValidUrl(this.manifest.url)) {
+                this.app.use((0, a2a_routes_js_1.createA2ARouter)(this));
+            }
+        };
+        this.app = (0, express_1.default)();
+        // Set manifest
+        this.manifest = manifest;
+        // Set modules
+        this.modelModule = modules.modelModule;
+        this.a2aModule = modules.a2aModule;
+        this.mcpModule = modules.mcpModule;
+        this.memoryModule = modules.memoryModule;
+        this.folModule = modules.folModule;
+        this.authScheme = authScheme;
+        this.initializeMiddlewares();
+        this.initializeRoutes();
+        this.app.use(error_middleware_js_1.errorMiddleware);
+    }
+    /**
+     * Initializes Express middlewares for security, CORS, and body parsing.
+     * Also applies authentication middleware if configured.
+     */
+    initializeMiddlewares() {
+        this.app.use((0, helmet_1.default)());
+        this.app.use((0, cors_1.default)());
+        this.app.use(express_1.default.json());
+        this.app.use(express_1.default.urlencoded({ extended: true }));
+        if (this.authScheme) {
+            this.app.use(this.authScheme.middleware());
+        }
+    }
+    /**
+     * Validates if a string is a valid HTTP or HTTPS URL.
+     *
+     * @param urlString - The URL string to validate
+     * @returns true if the URL is valid HTTP/HTTPS, false otherwise
+     */
+    isValidUrl(urlString) {
+        if (!urlString) {
+            return false;
+        }
+        try {
+            const url = new URL(urlString);
+            return url.protocol === "http:" || url.protocol === "https:";
+        }
+        catch (_error) {
+            return false;
+        }
+    }
+    /**
+     * Starts the Express server on the specified port.
+     *
+     * @param port - The port number to listen on
+     */
+    start(port) {
+        this.app.listen(port, () => {
+            logger_js_1.loggers.agent.info(`AINAgent is running on port ${port}`);
+        });
+    }
+}
+exports.AINAgent = AINAgent;
+//# sourceMappingURL=app.js.map

package/dist/cjs/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"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"}