fa-mcp-sdk 0.2.182 → 0.2.192

package/dist/core/web/openapi.d.ts

@@ -0,0 +1,64 @@
+import { Router } from 'express';
+/**
+ * OpenAPI specification response interface
+ */
+export interface OpenAPISpecResponse {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    servers?: Array<{
+        url: string;
+        description: string;
+    }>;
+    paths: Record<string, any>;
+    components?: {
+        schemas?: Record<string, any>;
+        securitySchemes?: Record<string, any>;
+    };
+    tags?: Array<{
+        name: string;
+        description: string;
+    }>;
+}
+/**
+ * Swagger UI configuration interface
+ */
+export interface SwaggerUIConfig {
+    customCss?: string;
+    customSiteTitle?: string;
+    customfavIcon?: string;
+    swaggerOptions?: {
+        persistAuthorization?: boolean;
+        displayRequestDuration?: boolean;
+        docExpansion?: string;
+        defaultModelsExpandDepth?: number;
+        urls?: Array<{
+            name: string;
+            url: string;
+        }>;
+    };
+}
+/**
+ * Automatically configures and serves OpenAPI documentation for APIs with tsoa
+ * decorators
+ *
+ * This function:
+ * 1. Detects if OpenAPI spec exists (generated by tsoa)
+ * 2. Creates OpenAPI and Swagger UI routes automatically
+ * 3. Serves documentation when apiRouter is provided
+ *
+ * @param apiRouter - Express router with tsoa-decorated endpoints
+ * @returns Object with swaggerSpecs and swaggerUi middleware, or null if apiRouter not provided
+ */
+export declare function configureOpenAPI(apiRouter?: Router | null): Promise<{
+    swaggerSpecs?: any;
+    swaggerUi?: any;
+} | null>;
+/**
+ * Serve Swagger UI static assets
+ */
+export declare function createSwaggerUIAssetsMiddleware(): import("express").RequestHandler<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>[];
+//# sourceMappingURL=openapi.d.ts.map

package/dist/core/web/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../src/core/web/openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAOpD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACvC,CAAC;IACF,IAAI,CAAC,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE;QACf,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,IAAI,CAAC,EAAE,KAAK,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,GAAG,EAAE,MAAM,CAAC;SACb,CAAC,CAAC;KACJ,CAAC;CACH;AA2FD;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC;IAC1E,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB,GAAG,IAAI,CAAC,CAgDR;AAkGD;;GAEG;AACH,wBAAgB,+BAA+B,mJAE9C"}

package/dist/core/web/openapi.js

@@ -0,0 +1,235 @@
+import { existsSync, readFileSync, mkdirSync } from 'fs';
+import * as path from 'path';
+import * as yaml from 'js-yaml';
+import swaggerUiExpress from 'swagger-ui-express';
+import { appConfig, ROOT_PROJECT_DIR } from '../index.js';
+/**
+ * Generate OpenAPI specification on-demand using tsoa programmatic API
+ */
+async function generateSpecOnDemand(specPath) {
+    try {
+        // Ensure directory exists
+        const specDir = path.dirname(specPath);
+        if (!existsSync(specDir)) {
+            mkdirSync(specDir, { recursive: true });
+        }
+        let controllerPathGlobs = ['./src/api/*.ts'];
+        let entryFile = './src/api/router.ts';
+        if (existsSync(path.join(ROOT_PROJECT_DIR, 'src/template/api/router.ts'))) {
+            controllerPathGlobs = ['./src/template/api/*.ts'];
+            entryFile = './src/template/api/router.ts';
+        }
+        // ExtendedSpecConfig structure for generateSpec
+        const specConfig = {
+            outputDirectory: specDir,
+            specVersion: 3,
+            specFileBaseName: 'openapi',
+            yaml: true,
+            entryFile,
+            noImplicitAdditionalProperties: 'throw-on-extras',
+            controllerPathGlobs,
+        };
+        // Use tsoa programmatic API
+        const { generateSpec } = await import('tsoa');
+        await generateSpec(specConfig);
+        if (existsSync(specPath)) {
+            console.log('OpenAPI specification generated successfully via tsoa programmatic API');
+            return;
+        }
+        // If tsoa didn't generate the file, create fallback
+        throw new Error('tsoa did not generate specification file');
+    }
+    catch (error) {
+        console.warn('tsoa spec generation failed, creating fallback spec:', error.message);
+        // Create fallback OpenAPI specification
+        const fallbackSpec = {
+            openapi: '3.0.0',
+            info: {
+                title: appConfig.productName || 'MCP Server API',
+                version: appConfig.version || '1.0.0',
+                description: appConfig.description || 'REST API for your MCP Server. This specification is automatically generated.',
+            },
+            servers: buildServersArray(),
+            paths: {
+                '/api/health': {
+                    get: {
+                        summary: 'Health check',
+                        description: 'Simple health check endpoint for monitoring',
+                        tags: ['Server'],
+                        responses: {
+                            '200': {
+                                description: 'Service is healthy',
+                                content: {
+                                    'application/json': {
+                                        schema: {
+                                            type: 'object',
+                                            properties: {
+                                                status: { type: 'string' },
+                                                timestamp: { type: 'string' },
+                                                version: { type: 'string' },
+                                            },
+                                        },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+            tags: [
+                { name: 'Server', description: 'Server management endpoints' },
+            ],
+        };
+        const { writeFileSync } = await import('fs');
+        writeFileSync(specPath, yaml.dump(fallbackSpec), 'utf8');
+        console.log('Fallback OpenAPI specification created successfully');
+    }
+}
+/**
+ * Automatically configures and serves OpenAPI documentation for APIs with tsoa
+ * decorators
+ *
+ * This function:
+ * 1. Detects if OpenAPI spec exists (generated by tsoa)
+ * 2. Creates OpenAPI and Swagger UI routes automatically
+ * 3. Serves documentation when apiRouter is provided
+ *
+ * @param apiRouter - Express router with tsoa-decorated endpoints
+ * @returns Object with swaggerSpecs and swaggerUi middleware, or null if apiRouter not provided
+ */
+export async function configureOpenAPI(apiRouter) {
+    if (!apiRouter) {
+        return null;
+    }
+    try {
+        // Try to load the generated OpenAPI spec
+        const specPath = path.join(process.cwd(), 'swagger/openapi.yaml');
+        if (!existsSync(specPath)) {
+            // Generate OpenAPI spec on-demand if it doesn't exist
+            console.log('OpenAPI specification not found. Generating on-demand...');
+            try {
+                await generateSpecOnDemand(specPath);
+            }
+            catch (error) {
+                console.warn('Failed to generate OpenAPI specification:', error);
+                return null;
+            }
+        }
+        // Load OpenAPI spec
+        const specContent = readFileSync(specPath, 'utf8');
+        let openAPISpec;
+        try {
+            // Try YAML first (tsoa default)
+            openAPISpec = yaml.load(specContent);
+        }
+        catch {
+            // Fallback to JSON
+            openAPISpec = JSON.parse(specContent);
+        }
+        // Enhance spec with dynamic configuration
+        const enhancedSpec = enhanceOpenAPISpec(openAPISpec);
+        // Create OpenAPI documentation routes
+        createOpenAPIRoutes(apiRouter, enhancedSpec);
+        // Return swagger-compatible objects for backward compatibility
+        return {
+            swaggerSpecs: enhancedSpec,
+            swaggerUi: createSwaggerUIMiddleware(enhancedSpec),
+        };
+    }
+    catch (error) {
+        console.error('Failed to configure OpenAPI documentation:', error);
+        return null;
+    }
+}
+/**
+ * Enhances the OpenAPI specification with dynamic configuration
+ */
+function enhanceOpenAPISpec(spec) {
+    const enhanced = { ...spec };
+    // Update info from app config
+    enhanced.info = {
+        ...spec.info,
+        title: appConfig.productName || 'MCP Server API',
+        version: appConfig.version || '1.0.0',
+    };
+    // Build servers array from config with fallback
+    enhanced.servers = buildServersArray();
+    // Add default security scheme if auth is configured
+    if (appConfig.webServer?.auth?.enabled) {
+        enhanced.components = enhanced.components || {};
+        enhanced.components.securitySchemes = {
+            bearerAuth: {
+                type: 'http',
+                scheme: 'bearer',
+                bearerFormat: 'JWT',
+                description: 'JWT authorization token',
+            },
+            ...enhanced.components.securitySchemes,
+        };
+    }
+    return enhanced;
+}
+/**
+ * Builds servers array from configuration
+ */
+function buildServersArray() {
+    const servers = [];
+    // Use servers from config if available
+    if (appConfig.swagger?.servers?.length) {
+        appConfig.swagger.servers.forEach((server) => {
+            servers.push({
+                url: server.url,
+                description: server.description,
+            });
+        });
+    }
+    else {
+        // Fallback to default development server
+        servers.push({
+            url: `http://localhost:${appConfig.webServer.port}`,
+            description: 'Development server',
+        });
+    }
+    return servers;
+}
+/**
+ * Creates OpenAPI documentation routes on the provided router
+ */
+function createOpenAPIRoutes(router, spec) {
+    // OpenAPI specification endpoint
+    router.get('/openapi.json', (req, res) => {
+        res.json(spec);
+    });
+    router.get('/openapi.yaml', (req, res) => {
+        res.type('application/yaml').send(yaml.dump(spec));
+    });
+}
+/**
+ * Creates Swagger UI middleware function
+ */
+function createSwaggerUIMiddleware(spec) {
+    const swaggerUiConfig = {
+        customSiteTitle: `${spec.info.title} Documentation`,
+        customCss: '.swagger-ui .topbar { display: none }',
+        swaggerOptions: {
+            persistAuthorization: true,
+            displayRequestDuration: true,
+            docExpansion: 'list',
+            defaultModelsExpandDepth: 2,
+            urls: [
+                {
+                    name: 'API Specification',
+                    url: '/api/openapi.json',
+                },
+            ],
+        },
+    };
+    return swaggerUiExpress.setup(spec, swaggerUiConfig);
+}
+/**
+ * Serve Swagger UI static assets
+ */
+export function createSwaggerUIAssetsMiddleware() {
+    return swaggerUiExpress.serve;
+}
+//# sourceMappingURL=openapi.js.map

package/dist/core/web/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../../src/core/web/openapi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACzD,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAChC,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA8C1D;;GAEG;AACH,KAAK,UAAU,oBAAoB,CAAE,QAAgB;IACnD,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,mBAAmB,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC7C,IAAI,SAAS,GAAG,qBAAqB,CAAC;QACtC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,4BAA4B,CAAC,CAAC,EAAE,CAAC;YAC1E,mBAAmB,GAAG,CAAC,yBAAyB,CAAC,CAAC;YAClD,SAAS,GAAG,8BAA8B,CAAC;QAC7C,CAAC;QAED,gDAAgD;QAChD,MAAM,UAAU,GAAG;YACjB,eAAe,EAAE,OAAO;YACxB,WAAW,EAAE,CAAU;YACvB,gBAAgB,EAAE,SAAS;YAC3B,IAAI,EAAE,IAAI;YACV,SAAS;YACT,8BAA8B,EAAE,iBAA0B;YAC1D,mBAAmB;SACpB,CAAC;QAEF,4BAA4B;QAC5B,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;QAE/B,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;YACtF,OAAO;QACT,CAAC;QAED,oDAAoD;QACpD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAE9D,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,sDAAsD,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAEpF,wCAAwC;QACxC,MAAM,YAAY,GAAwB;YACxC,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE;gBACJ,KAAK,EAAE,SAAS,CAAC,WAAW,IAAI,gBAAgB;gBAChD,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,OAAO;gBACrC,WAAW,EAAE,SAAS,CAAC,WAAW,IAAI,8EAA8E;aACrH;YACD,OAAO,EAAE,iBAAiB,EAAE;YAC5B,KAAK,EAAE;gBACL,aAAa,EAAE;oBACb,GAAG,EAAE;wBACH,OAAO,EAAE,cAAc;wBACvB,WAAW,EAAE,6CAA6C;wBAC1D,IAAI,EAAE,CAAC,QAAQ,CAAC;wBAChB,SAAS,EAAE;4BACT,KAAK,EAAE;gCACL,WAAW,EAAE,oBAAoB;gCACjC,OAAO,EAAE;oCACP,kBAAkB,EAAE;wCAClB,MAAM,EAAE;4CACN,IAAI,EAAE,QAAQ;4CACd,UAAU,EAAE;gDACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gDAC1B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gDAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;6CAC5B;yCACF;qCACF;iCACF;6BACF;yBACF;qBACF;iBACF;aACF;YACD,IAAI,EAAE;gBACJ,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;aAC/D;SACF,CAAC;QAEF,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7C,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAE,SAAyB;IAI/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,yCAAyC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC;QAElE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,sDAAsD;YACtD,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;YACxE,IAAI,CAAC;gBACH,MAAM,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;gBACjE,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,WAAgC,CAAC;QAErC,IAAI,CAAC;YACH,gCAAgC;YAChC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAwB,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,mBAAmB;YACnB,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAwB,CAAC;QAC/D,CAAC;QAED,0CAA0C;QAC1C,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAErD,sCAAsC;QACtC,mBAAmB,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAE7C,+DAA+D;QAC/D,OAAO;YACL,YAAY,EAAE,YAAY;YAC1B,SAAS,EAAE,yBAAyB,CAAC,YAAY,CAAC;SACnD,CAAC;IAEJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAE,IAAyB;IACpD,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAE7B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,GAAG;QACd,GAAG,IAAI,CAAC,IAAI;QACZ,KAAK,EAAE,SAAS,CAAC,WAAW,IAAI,gBAAgB;QAChD,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,OAAO;KACtC,CAAC;IAEF,gDAAgD;IAChD,QAAQ,CAAC,OAAO,GAAG,iBAAiB,EAAE,CAAC;IAEvC,oDAAoD;IACpD,IAAI,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACvC,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,IAAI,EAAE,CAAC;QAChD,QAAQ,CAAC,UAAU,CAAC,eAAe,GAAG;YACpC,UAAU,EAAE;gBACV,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,QAAQ;gBAChB,YAAY,EAAE,KAAK;gBACnB,WAAW,EAAE,yBAAyB;aACvC;YACD,GAAG,QAAQ,CAAC,UAAU,CAAC,eAAe;SACvC,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB;IACxB,MAAM,OAAO,GAAG,EAAE,CAAC;IAEnB,uCAAuC;IACvC,IAAI,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACvC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAW,EAAE,EAAE;YAChD,OAAO,CAAC,IAAI,CAAC;gBACX,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,yCAAyC;QACzC,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,EAAE,oBAAoB,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE;YACnD,WAAW,EAAE,oBAAoB;SAClC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAE,MAAc,EAAE,IAAyB;IACrE,iCAAiC;IACjC,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC1D,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC1D,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAE,IAAyB;IAC3D,MAAM,eAAe,GAAoB;QACvC,eAAe,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,gBAAgB;QACnD,SAAS,EAAE,uCAAuC;QAClD,cAAc,EAAE;YACd,oBAAoB,EAAE,IAAI;YAC1B,sBAAsB,EAAE,IAAI;YAC5B,YAAY,EAAE,MAAM;YACpB,wBAAwB,EAAE,CAAC;YAC3B,IAAI,EAAE;gBACJ;oBACE,IAAI,EAAE,mBAAmB;oBACzB,GAAG,EAAE,mBAAmB;iBACzB;aACF;SACF;KACF,CAAC;IAEF,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B;IAC7C,OAAO,gBAAgB,CAAC,KAAK,CAAC;AAChC,CAAC"}

package/dist/core/web/server-http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-http.d.ts","sourceRoot":"","sources":["../../../src/core/web/server-http.ts"],"names":[],"mappings":"AAqCA,eAAO,MAAM,cAAc,SAA8B,CAAC;AAyC1D;;GAEG;AACH,wBAAsB,eAAe,IAAK,OAAO,CAAC,IAAI,CAAC,CA+ZtD"}
+{"version":3,"file":"server-http.d.ts","sourceRoot":"","sources":["../../../src/core/web/server-http.ts"],"names":[],"mappings":"AAsCA,eAAO,MAAM,cAAc,SAA8B,CAAC;AAyC1D;;GAEG;AACH,wBAAsB,eAAe,IAAK,OAAO,CAAC,IAAI,CAAC,CAiatD"}

package/dist/core/web/server-http.js

@@ -7,6 +7,7 @@ import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
 import { appConfig, getProjectData } from '../bootstrap/init-config.js';
 import { getResource, getResourcesList } from '../mcp/resources.js';
+import { configureOpenAPI, createSwaggerUIAssetsMiddleware } from './openapi.js';
 import { createAuthMW } from '../auth/middleware.js';
 import { createMcpServer } from '../mcp/create-mcp-server.js';
 import { logger as lgr } from '../logger.js';
@@ -110,17 +111,16 @@ export async function startHttpServer() {
         res.json(health);
     });
     const { httpComponents, tools, toolHandler } = getProjectData();
-    const swagger = httpComponents?.swagger;
     const apiRouter = httpComponents?.apiRouter;
-    if (swagger) {
-        app.use('/docs', swagger.swaggerUi.serve, swagger.swaggerUi.setup(swagger.swaggerSpecs, {
-            customCss: '.swagger-ui .topbar { display: none }',
-            customSiteTitle: 'MCP Staff Search API Documentation',
-        }));
-    }
+    // Auto-configure OpenAPI documentation if apiRouter is provided
+    const openAPIConfig = apiRouter ? await configureOpenAPI(apiRouter) : null;
     // API routes
     if (apiRouter) {
         app.use('/api', apiRouter);
+        // Serve Swagger UI assets if OpenAPI is configured
+        if (openAPIConfig) {
+            app.use('/docs', createSwaggerUIAssetsMiddleware(), openAPIConfig.swaggerUi);
+        }
     }
     // Admin panel routes (Token Generator & Validator)
     if (isAdminEnabled) {
@@ -380,8 +380,10 @@ export async function startHttpServer() {
             messages: 'POST /messages',
             mcp: 'POST /mcp',
         };
-        if (swagger) {
-            availableEndpoints.docs = 'GET /docs';
+        if (openAPIConfig) {
+            availableEndpoints.swagger = 'GET /docs';
+            availableEndpoints.openapi = 'GET /api/openapi.json';
+            availableEndpoints.openapiYaml = 'GET /api/openapi.yaml';
         }
         if (isAdminEnabled) {
             availableEndpoints.admin = 'GET /admin';

package/dist/core/web/server-http.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-http.js","sourceRoot":"","sources":["../../../src/core/web/server-http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,uBAAuB;AACvB,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAE7C,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAEzE,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;AAE1D;;GAEG;AACH,KAAK,UAAU,eAAe,CAC5B,WAA8B,EAC9B,QAAgB,EAChB,EAAU,EACV,UAAkB,EAAE,EACpB,GAAsB,EACtB,EAAQ;IAER,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,cAAc,EAAE,CAAC;QACxB,IAAI,gBAAgB,CAAC,cAAc,CAAC,EAAE,CAAC;YACrC,MAAM,gBAAgB,GAAG,oBAAoB,CAC3C,cAAqB,EACrB,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CACpC,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,CAAC,CAAC,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;YAEhF,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,EAAE,EAAE,EAAE,IAAI,CAAC;oBACX,KAAK,EAAE;wBACL,IAAI,EAAE,CAAC,KAAK;wBACZ,OAAO,EAAE,gBAAgB;qBAC1B;iBACF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,MAAM,cAAc,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,0BAA0B;IAC1B,MAAM,WAAW,GAAG,IAAI,iBAAiB,CAAC;QACxC,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW;QAC3C,QAAQ,EAAE,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,EAAE,qBAAqB;KACzE,CAAC,CAAC;IAEH,qDAAqD;IACrD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,sBAAsB;IACtB,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;QACb,qBAAqB,EAAE,KAAK,EAAE,gBAAgB;QAC9C,yBAAyB,EAAE,KAAK;KACjC,CAAC,CAAC,CAAC;IAEJ,eAAe;IACf,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAE/D,SAAS,CAAC,GAAG,CAAC,CAAC;IAEf,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;IAEtB,oCAAoC;IACpC,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IAE/C,oCAAoC;IACpC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;IAEnC,yBAAyB;IACzB,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IAE1C,yCAAyC;IACzC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACxB,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,wBAAwB;IACxB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACpC,IAAI,MAAM,GAAQ;YAChB,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE;gBACP,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;gBACxB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF,CAAC;QACF,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;YAC3B,MAAM,CAAC,OAAO,CAAC,kBAAkB,GAAG,MAAM,yBAAyB,EAAE,CAAC;YACtE,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,KAAK,OAAO,EAAE,CAAC;gBAClD,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CAAC;IAChE,MAAM,OAAO,GAAG,cAAc,EAAE,OAAO,CAAC;IACxC,MAAM,SAAS,GAAG,cAAc,EAAE,SAAS,CAAC;IAE5C,IAAI,OAAO,EAAE,CAAC;QACZ,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE;YACtF,SAAS,EAAE,uCAAuC;YAClD,eAAe,EAAE,oCAAoC;SACtD,CAAC,CAAC,CAAC;IACN,CAAC;IAED,aAAa;IACb,IAAI,SAAS,EAAE,CAAC;QACd,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,mDAAmD;IACnD,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,gBAAgB,GAAG,uBAAuB,EAAE,CAAC;QACnD,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,CAAC,KAAK,CAAC,mCAAmC,gBAAgB,EAAE,CAAC,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,mCAAmC,gBAAgB,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;QACxC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC/C,CAAC;IAED,6CAA6C;IAC7C,iGAAiG;IACjG,MAAM,aAAa,GAAG,IAAI,GAAG,EAKzB,CAAC;IAEL,mGAAmG;IACnG,KAAK,UAAU,eAAe,CAAE,gBAAwC,EAAE,WAAkD;QAC1H,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;QAEpC,8FAA8F;QAC9F,SAAS,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACnE,6CAA6C;YAC7C,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;YAC5C,MAAM,eAAe,CAAC,WAAW,EAAE,gBAAgB,EAAE,SAAS,EAAE,yBAAyB,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAEhH,6FAA6F;YAC7F,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;gBAC/B,GAAG,OAAO,CAAC,MAAM;gBACjB,OAAO,EAAE,gBAAgB,EAAE,uDAAuD;gBAClF,OAAO,EAAE,WAAW,CAAC,4DAA4D;aAClF,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gDAAgD;IAChD,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACzC,IAAI,CAAC;YACH,yCAAyC;YACzC,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,EAAE,IAAI,SAAS,EAAE,CAAC;YAC9C,MAAM,eAAe,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,IAAI,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAEjF,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YAEpC,gEAAgE;YAChE,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACvD,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAEjF,uDAAuD;YACvD,MAAM,QAAQ,GAAI,GAAW,CAAC,QAAQ,CAAC;YACvC,MAAM,WAAW,GAAG,QAAQ,EAAE,OAAO,CAAC;YAEtC,yEAAyE;YACzE,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAEtD,qGAAqG;YACrG,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;YAEvE,0EAA0E;YAC1E,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE;gBACrC,SAAS;gBACT,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,gBAAgB;gBACzB,OAAO,EAAE,WAAW;aACrB,CAAC,CAAC;YAEH,oDAAoD;YACpD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACnB,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;gBAC1C,MAAM,CAAC,IAAI,CAAC,4BAA4B,SAAS,CAAC,SAAS,EAAE,CAAC,CAAC;YACjE,CAAC,CAAC,CAAC;YAEH,MAAM,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAEnC,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;YACvD,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;YAC9C,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,0BAA0B,CACpD,IAAI,WAAW,CAAC,oCAAoC,CAAC,CACtD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,gEAAgE;IAChE,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAiB,EAAE;QAC9D,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,SAAmB,CAAC;YAChD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE;wBACL,IAAI,EAAE,CAAC,KAAK;wBACZ,OAAO,EAAE,qBAAqB;qBAC/B;oBACD,EAAE,EAAE,IAAI;iBACT,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE;wBACL,IAAI,EAAE,CAAC,KAAK;wBACZ,OAAO,EAAE,mBAAmB;qBAC7B;oBACD,EAAE,EAAE,IAAI;iBACT,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,MAAM,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC;YACpC,MAAM,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;YACnD,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAC7C,IAAI,WAAW,CAAC,8BAA8B,CAAC,CAChD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,sFAAsF;IACtF,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAiB,EAAE;QACzD,IAAI,CAAC;YACH,oEAAoE;YACpE,iJAAiJ;YACjJ,IAAI,eAAe,GAAG,IAAI,CAAC;YAE3B,KAAK,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;gBAClE,kEAAkE;gBAClE,eAAe,GAAG,aAAa,CAAC,SAAS,CAAC;gBAC1C,MAAM;YACR,CAAC;YAED,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE;wBACL,IAAI,EAAE,CAAC,KAAK;wBACZ,OAAO,EAAE,4DAA4D;qBACtE;oBACD,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,IAAI;iBACzB,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,sBAAsB;YACtB,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE,IAAI,SAAS,CAAC;YACrC,MAAM,eAAe,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,IAAI,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAEjG,MAAM,CAAC,IAAI,CAAC,qCAAqC,GAAG,CAAC,IAAI,CAAC,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YAEzF,wDAAwD;YACxD,MAAM,eAAe,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YAC/C,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAC7C,IAAI,WAAW,CAAC,mCAAmC,CAAC,CACrD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,iCAAiC;IACjC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,sBAAsB;YACtB,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE,IAAI,SAAS,CAAC;YACrC,MAAM,eAAe,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,IAAI,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAEjG,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC;YACzB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC;YAEvC,MAAM,CAAC,IAAI,CAAC,8BAA8B,MAAM,UAAU,EAAE,EAAE,CAAC,CAAC;YAEhE,IAAI,MAAM,CAAC;YAEX,QAAQ,MAAM,EAAE,CAAC;gBACf,KAAK,YAAY;oBACf,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,EAAE,CAAC;oBACvF,MAAM,CAAC,IAAI,CAAC,6CAA6C,eAAe,0BAA0B,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;oBACpL,MAAM,GAAG;wBACP,eAAe,EAAE,YAAY;wBAC7B,YAAY,EAAE;4BACZ,KAAK,EAAE,EAAE;4BACT,OAAO,EAAE,EAAE;4BACX,SAAS,EAAE,EAAE;yBACd;wBACD,UAAU,EAAE;4BACV,IAAI,EAAE,SAAS,CAAC,IAAI;4BACpB,OAAO,EAAE,SAAS,CAAC,OAAO;yBAC3B;qBACF,CAAC;oBACF,MAAM;gBAER,KAAK,YAAY;oBACf,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC;oBACnB,MAAM;gBAER,KAAK,YAAY;oBACf,qCAAqC;oBACrC,MAAM,gBAAgB,GAAG,QAAQ,GAAG,CAAC,EAAE,IAAI,SAAS,EAAE,CAAC;oBACvD,MAAM,eAAe,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,IAAI,SAAS,EAAE,qBAAqB,MAAM,EAAE,IAAI,IAAI,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;oBACrI,uDAAuD;oBACvD,MAAM,cAAc,GAAI,GAAW,CAAC,QAAQ,EAAE,OAAO,CAAC;oBACtD,MAAM,GAAG,MAAM,WAAW,CAAC;wBACzB,GAAG,MAAM;wBACT,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC;wBACtC,OAAO,EAAE,cAAc;qBACxB,CAAC,CAAC;oBACH,MAAM;gBAER,KAAK,cAAc;oBACjB,MAAM,GAAG,cAAc,EAAE,CAAC;oBAC1B,MAAM;gBAER,KAAK,aAAa,CAAC,CAAC,CAAC;oBACnB,MAAM,GAAG,MAAM,SAAS,CAAC,OAA4B,CAAC,CAAC;oBACvD,MAAM;gBACR,CAAC;gBAED,KAAK,gBAAgB;oBACnB,MAAM,GAAG,gBAAgB,EAAE,CAAC;oBAC5B,MAAM;gBAER,KAAK,gBAAgB,CAAC,CAAC,CAAC;oBACtB,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACvC,MAAM;gBACR,CAAC;gBAED,KAAK,2BAA2B;oBAC9B,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;oBACnD,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;gBAEhC,KAAK,MAAM;oBACT,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;oBACxB,MAAM;gBAER;oBACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;YACjD,CAAC;YAED,OAAO,GAAG,CAAC,IAAI,CAAC;gBACd,OAAO,EAAE,KAAK;gBACd,EAAE;gBACF,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAkB,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnB,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;gBACnD,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACvB,CAAC;YACD,IAAI,aAAa,CAAC;YAClB,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;gBAClC,6DAA6D;gBAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBAChC,aAAa,GAAG;oBACd,IAAI,EAAE,CAAC,CAAC;oBACR,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ,CAAC,IAAI;wBACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;wBACzB,6EAA6E;qBAC9E;iBACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,6CAA6C;gBAC7C,aAAa,GAAG;oBACd,IAAI,EAAE,CAAC,CAAC;oBACR,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;iBACtB,CAAC;YACJ,CAAC;YACD,OAAO,GAAG,CAAC,IAAI,CAAC;gBACd,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC;gBACrB,KAAK,EAAE,aAAa;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,iCAAiC;IACjC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,kBAAkB,GAAQ;YAC9B,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,aAAa;YACrB,GAAG,EAAE,qBAAqB;YAC1B,QAAQ,EAAE,gBAAgB;YAC1B,GAAG,EAAE,WAAW;SACjB,CAAC;QAEF,IAAI,OAAO,EAAE,CAAC;YACZ,kBAAkB,CAAC,IAAI,GAAG,WAAW,CAAC;QACxC,CAAC;QACD,IAAI,cAAc,EAAE,CAAC;YACnB,kBAAkB,CAAC,KAAK,GAAG,YAAY,CAAC;QAC1C,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE;YAChC,GAAG,CAAC,cAAc,EAAE,cAAc,IAAI,EAAE,CAAC;SAC1C,CAAC,CAAC;QAEH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,UAAU,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE;YAC3C,kBAAkB;SACnB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,iFAAiF;IACjF,GAAG,CAAC,GAAG,CAAC,CAAC,KAAY,EAAE,GAAoB,EAAE,GAAqB,EAAE,KAA2B,EAAE,EAAE;QACjG,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAE7C,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC;IACtC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE;QAC/B,IAAI,GAAG,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,iBAAiB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;8BAChG,IAAI,GAAG,CAAC;QAClC,IAAI,cAAc,EAAE,CAAC;YACnB,GAAG,IAAI,mCAAmC,IAAI,QAAQ,CAAC;QACzD,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"server-http.js","sourceRoot":"","sources":["../../../src/core/web/server-http.ts"],"names":[],"mappings":"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"}

package/dist/core/web/static/home/index.html

@@ -80,12 +80,14 @@
         </div>
       </section>
 
-      <!-- Swagger -->
+      <!-- OpenAPI Documentation -->
       <section class="info-section" id="swaggerSection" style="display: none;">
         <div class="info-row">
           <span class="label">API Reference:</span>
           <span class="value">
-            <a href="/docs" target="_blank" rel="noopener" class="clickable">Swagger</a>
+            <a href="/docs" target="_blank" rel="noopener" class="clickable">OpenAPI Documentation</a>
+            <a href="/api/openapi.json" target="_blank" rel="noopener" class="clickable">JSON</a> |
+            <a href="/api/openapi.yaml" target="_blank" rel="noopener" class="clickable">YAML</a>
           </span>
         </div>
       </section>

package/dist/core/web/static/home/script.js

@@ -89,10 +89,10 @@ function renderPageInfo (data) {
     }
   }
 
-  // Swagger info
+  // OpenAPI info
   const swaggerSection = document.getElementById('swaggerSection');
   if (swaggerSection) {
-    swaggerSection.style.display = data.swagger ? 'block' : 'none';
+    swaggerSection.style.display = data.openAPI ? 'block' : 'none';
   }
 
   // Auth info

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fa-mcp-sdk",
   "productName": "FA MCP SDK",
-  "version": "0.2.182",
+  "version": "0.2.192",
   "description": "Core infrastructure and templates for building Model Context Protocol (MCP) servers with TypeScript",
   "type": "module",
   "main": "dist/core/index.js",
@@ -38,7 +38,8 @@
     "prepublishOnly": "npm run cb",
     "template:start": "node dist/template/start.js",
     "template:stdio": "node dist/template/start.js stdio",
-    "token-gen": "node dist/core/auth/token-generator/server.js"
+    "token-gen": "node dist/core/auth/token-generator/server.js",
+    "tsoa:spec": "tsoa spec"
   },
   "keywords": [
     "mcp",
@@ -66,7 +67,8 @@
   "homepage": "https://github.com/Bazilio-san/fa-mcp-sdk#readme",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.24.3",
-    "af-ad-ts": "^0.0.67",
+    "@tsoa/runtime": "^6.4.0",
+    "af-ad-ts": "^0.0.69",
     "af-db-ts": "^3.0.23",
     "af-logger-ts": "^0.0.24",
     "chalk": "^5.6.2",
@@ -80,27 +82,22 @@
     "node-cache": "^5.1.2",
     "pgvector": "^0.2.1",
     "rate-limiter-flexible": "^9.0.0",
+    "swagger-ui-express": "^5.0.1",
+    "tsoa": "^6.4.0",
     "uuid": "^13.0.0",
     "ya-express-ntlm": "^1.0.39"
   },
-  "optionalDependencies": {
-    "swagger-jsdoc": "^6.2.8",
-    "swagger-ui-express": "^5.0.1"
-  },
   "devDependencies": {
+    "@tsoa/cli": "^6.4.0",
     "@types/config": "^3.3.5",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "@types/js-yaml": "^4.0.9",
     "@types/mssql": "^9.1.8",
     "@types/node": "^24.10.1",
-    "@types/swagger-jsdoc": "^6.0.4",
     "@types/swagger-ui-express": "^4.1.8",
-    "@typescript-eslint/eslint-plugin": "^8.48.1",
-    "@typescript-eslint/parser": "^8.48.1",
     "eslint": "^9.39.1",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-unused-imports": "^4.3.0",
+    "eslint-config-at-26": "^25.12.23",
     "rimraf": "^6.1.2",
     "typescript": "^5.9.3"
   }

package/src/template/api/router.ts

@@ -1,16 +1,78 @@
 import { Router, Request, Response } from 'express';
+import { Route, Get, Tags } from 'tsoa';
 import { logger, createAuthMW, IEndpointsOn404 } from '../../core/index.js';
 
 export const apiRouter: Router | null = Router();
 
+// Create universal auth middleware
+const authMW = createAuthMW();
+
+// Example response interfaces for tsoa
+export interface ExampleResponse {
+  success: boolean;
+  message: string;
+  data: {
+    timestamp: string;
+  };
+}
+
+export interface ErrorResponse {
+  success: boolean;
+  error: string;
+  code?: string;
+}
+
 /**
- * Template for API routes
- * Modify this file to implement your specific API endpoints
+ * Example TSOA Controller
+ * This demonstrates how to use tsoa decorators for automatic OpenAPI generation
  */
+@Route('api')
+export class ExampleController {
+  /**
+   * Example protected endpoint
+   * Template endpoint - customize as needed
+   */
+  @Get('example')
+  @Tags('Example')
+  public async getExample (): Promise<ExampleResponse> {
+    try {
+      logger.info('Example endpoint called');
 
-// Create universal auth middleware
-const authMW = createAuthMW();
+      return {
+        success: true,
+        message: 'This is a template endpoint',
+        data: {
+          timestamp: new Date().toISOString(),
+        },
+      };
+    } catch (error) {
+      logger.error('Error in example endpoint:', error);
+      throw new Error(error instanceof Error ? error.message : 'Unknown error');
+    }
+  }
+
+  /**
+   * Health check endpoint
+   * Simple health check for monitoring
+   */
+  @Get('health')
+  @Tags('Server')
+  public async getHealth (): Promise<{
+    status: string;
+    timestamp: string;
+    version: string;
+  }> {
+    const { appConfig } = await import('../../core/index.js');
+
+    return {
+      status: 'ok',
+      timestamp: new Date().toISOString(),
+      version: appConfig.version || '1.0.0',
+    };
+  }
+}
 
+// Manual Express routes for backward compatibility and custom endpoints
 // Example protected endpoint using auth middleware
 apiRouter.get('/example', authMW, async (req: Request, res: Response) => {
   try {

package/src/template/start.ts

@@ -8,7 +8,6 @@ import { AGENT_PROMPT } from './prompts/agent-prompt.js';
 import { customPrompts } from './prompts/custom-prompts.js';
 import { customResources } from './custom-resources.js';
 import { apiRouter, endpointsOn404 } from './api/router.js';
-import { swagger } from './api/swagger.js';
 
 const isConsulProd = (process.env.NODE_CONSUL_ENV || process.env.NODE_ENV) === 'production';
 
@@ -37,10 +36,6 @@ const startProject = async (): Promise<void> => {
     httpComponents: {
       apiRouter,
       endpointsOn404,
-      swagger: {
-        swaggerSpecs: swagger.swaggerSpecs,
-        swaggerUi: swagger.swaggerUi,
-      },
     },
 
     // Assets