@microsoft/m365-spec-parser 0.1.1-alpha.4cb5c08a8.0 → 0.1.1-alpha.4e708f092.0

package/dist/index.esm2017.mjs

@@ -103,6 +103,7 @@ ConstantString.AdaptiveCardVersion = "1.5";
 ConstantString.AdaptiveCardSchema = "http://adaptivecards.io/schemas/adaptive-card.json";
 ConstantString.AdaptiveCardType = "AdaptiveCard";
 ConstantString.TextBlockType = "TextBlock";
+ConstantString.ImageType = "Image";
 ConstantString.ContainerType = "Container";
 ConstantString.RegistrationIdPostfix = "REGISTRATION_ID";
 ConstantString.OAuthRegistrationIdPostFix = "OAUTH_REGISTRATION_ID";
@@ -166,7 +167,8 @@ ConstantString.CommandDescriptionMaxLens = 128;
 ConstantString.ParameterDescriptionMaxLens = 128;
 ConstantString.CommandTitleMaxLens = 32;
 ConstantString.ParameterTitleMaxLens = 32;
-ConstantString.SMERequiredParamsMaxNum = 5;
+ConstantString.SMERequiredParamsMaxNum = 5;
+ConstantString.DefaultPluginId = "plugin_1";
 
 // Copyright (c) Microsoft Corporation.
 class SpecParserError extends Error {
@@ -189,249 +191,9 @@ class Utils {
         }
         return false;
     }
-    static checkParameters(paramObject, isCopilot) {
-        const paramResult = {
-            requiredNum: 0,
-            optionalNum: 0,
-            isValid: true,
-            reason: [],
-        };
-        if (!paramObject) {
-            return paramResult;
-        }
-        for (let i = 0; i < paramObject.length; i++) {
-            const param = paramObject[i];
-            const schema = param.schema;
-            if (isCopilot && this.hasNestedObjectInSchema(schema)) {
-                paramResult.isValid = false;
-                paramResult.reason.push(ErrorType.ParamsContainsNestedObject);
-                continue;
-            }
-            const isRequiredWithoutDefault = param.required && schema.default === undefined;
-            if (isCopilot) {
-                if (isRequiredWithoutDefault) {
-                    paramResult.requiredNum = paramResult.requiredNum + 1;
-                }
-                else {
-                    paramResult.optionalNum = paramResult.optionalNum + 1;
-                }
-                continue;
-            }
-            if (param.in === "header" || param.in === "cookie") {
-                if (isRequiredWithoutDefault) {
-                    paramResult.isValid = false;
-                    paramResult.reason.push(ErrorType.ParamsContainRequiredUnsupportedSchema);
-                }
-                continue;
-            }
-            if (schema.type !== "boolean" &&
-                schema.type !== "string" &&
-                schema.type !== "number" &&
-                schema.type !== "integer") {
-                if (isRequiredWithoutDefault) {
-                    paramResult.isValid = false;
-                    paramResult.reason.push(ErrorType.ParamsContainRequiredUnsupportedSchema);
-                }
-                continue;
-            }
-            if (param.in === "query" || param.in === "path") {
-                if (isRequiredWithoutDefault) {
-                    paramResult.requiredNum = paramResult.requiredNum + 1;
-                }
-                else {
-                    paramResult.optionalNum = paramResult.optionalNum + 1;
-                }
-            }
-        }
-        return paramResult;
-    }
-    static checkPostBody(schema, isRequired = false, isCopilot = false) {
-        var _a;
-        const paramResult = {
-            requiredNum: 0,
-            optionalNum: 0,
-            isValid: true,
-            reason: [],
-        };
-        if (Object.keys(schema).length === 0) {
-            return paramResult;
-        }
-        const isRequiredWithoutDefault = isRequired && schema.default === undefined;
-        if (isCopilot && this.hasNestedObjectInSchema(schema)) {
-            paramResult.isValid = false;
-            paramResult.reason = [ErrorType.RequestBodyContainsNestedObject];
-            return paramResult;
-        }
-        if (schema.type === "string" ||
-            schema.type === "integer" ||
-            schema.type === "boolean" ||
-            schema.type === "number") {
-            if (isRequiredWithoutDefault) {
-                paramResult.requiredNum = paramResult.requiredNum + 1;
-            }
-            else {
-                paramResult.optionalNum = paramResult.optionalNum + 1;
-            }
-        }
-        else if (schema.type === "object") {
-            const { properties } = schema;
-            for (const property in properties) {
-                let isRequired = false;
-                if (schema.required && ((_a = schema.required) === null || _a === void 0 ? void 0 : _a.indexOf(property)) >= 0) {
-                    isRequired = true;
-                }
-                const result = Utils.checkPostBody(properties[property], isRequired, isCopilot);
-                paramResult.requiredNum += result.requiredNum;
-                paramResult.optionalNum += result.optionalNum;
-                paramResult.isValid = paramResult.isValid && result.isValid;
-                paramResult.reason.push(...result.reason);
-            }
-        }
-        else {
-            if (isRequiredWithoutDefault && !isCopilot) {
-                paramResult.isValid = false;
-                paramResult.reason.push(ErrorType.PostBodyContainsRequiredUnsupportedSchema);
-            }
-        }
-        return paramResult;
-    }
     static containMultipleMediaTypes(bodyObject) {
         return Object.keys((bodyObject === null || bodyObject === void 0 ? void 0 : bodyObject.content) || {}).length > 1;
     }
-    /**
-     * Checks if the given API is supported.
-     * @param {string} method - The HTTP method of the API.
-     * @param {string} path - The path of the API.
-     * @param {OpenAPIV3.Document} spec - The OpenAPI specification document.
-     * @returns {boolean} - Returns true if the API is supported, false otherwise.
-     * @description The following APIs are supported:
-     * 1. only support Get/Post operation without auth property
-     * 2. parameter inside query or path only support string, number, boolean and integer
-     * 3. parameter inside post body only support string, number, boolean, integer and object
-     * 4. request body + required parameters <= 1
-     * 5. response body should be “application/json” and not empty, and response code should be 20X
-     * 6. only support request body with “application/json” content type
-     */
-    static isSupportedApi(method, path, spec, options) {
-        var _a;
-        const result = { isValid: true, reason: [] };
-        method = method.toLocaleLowerCase();
-        if (options.allowMethods && !options.allowMethods.includes(method)) {
-            result.isValid = false;
-            result.reason.push(ErrorType.MethodNotAllowed);
-            return result;
-        }
-        const pathObj = spec.paths[path];
-        if (!pathObj || !pathObj[method]) {
-            result.isValid = false;
-            result.reason.push(ErrorType.UrlPathNotExist);
-            return result;
-        }
-        const securities = pathObj[method].security;
-        const isTeamsAi = options.projectType === ProjectType.TeamsAi;
-        const isCopilot = options.projectType === ProjectType.Copilot;
-        // Teams AI project doesn't care about auth, it will use authProvider for user to implement
-        if (!isTeamsAi) {
-            const authArray = Utils.getAuthArray(securities, spec);
-            const authCheckResult = Utils.isSupportedAuth(authArray, options);
-            if (!authCheckResult.isValid) {
-                result.reason.push(...authCheckResult.reason);
-            }
-        }
-        const operationObject = pathObj[method];
-        if (!options.allowMissingId && !operationObject.operationId) {
-            result.reason.push(ErrorType.MissingOperationId);
-        }
-        const rootServer = spec.servers && spec.servers[0];
-        const methodServer = spec.paths[path].servers && ((_a = spec.paths[path]) === null || _a === void 0 ? void 0 : _a.servers[0]);
-        const operationServer = operationObject.servers && operationObject.servers[0];
-        const serverUrl = operationServer || methodServer || rootServer;
-        if (!serverUrl) {
-            result.reason.push(ErrorType.NoServerInformation);
-        }
-        else {
-            const serverValidateResult = Utils.checkServerUrl([serverUrl]);
-            result.reason.push(...serverValidateResult.map((item) => item.type));
-        }
-        const paramObject = operationObject.parameters;
-        const requestBody = operationObject.requestBody;
-        const requestJsonBody = requestBody === null || requestBody === void 0 ? void 0 : requestBody.content["application/json"];
-        if (!isTeamsAi && Utils.containMultipleMediaTypes(requestBody)) {
-            result.reason.push(ErrorType.PostBodyContainMultipleMediaTypes);
-        }
-        const { json, multipleMediaType } = Utils.getResponseJson(operationObject, isTeamsAi);
-        if (multipleMediaType && !isTeamsAi) {
-            result.reason.push(ErrorType.ResponseContainMultipleMediaTypes);
-        }
-        else if (Object.keys(json).length === 0) {
-            result.reason.push(ErrorType.ResponseJsonIsEmpty);
-        }
-        // Teams AI project doesn't care about request parameters/body
-        if (!isTeamsAi) {
-            let requestBodyParamResult = {
-                requiredNum: 0,
-                optionalNum: 0,
-                isValid: true,
-                reason: [],
-            };
-            if (requestJsonBody) {
-                const requestBodySchema = requestJsonBody.schema;
-                if (isCopilot && requestBodySchema.type !== "object") {
-                    result.reason.push(ErrorType.PostBodySchemaIsNotJson);
-                }
-                requestBodyParamResult = Utils.checkPostBody(requestBodySchema, requestBody.required, isCopilot);
-                if (!requestBodyParamResult.isValid && requestBodyParamResult.reason) {
-                    result.reason.push(...requestBodyParamResult.reason);
-                }
-            }
-            const paramResult = Utils.checkParameters(paramObject, isCopilot);
-            if (!paramResult.isValid && paramResult.reason) {
-                result.reason.push(...paramResult.reason);
-            }
-            // Copilot support arbitrary parameters
-            if (!isCopilot && paramResult.isValid && requestBodyParamResult.isValid) {
-                const totalRequiredParams = requestBodyParamResult.requiredNum + paramResult.requiredNum;
-                const totalParams = totalRequiredParams + requestBodyParamResult.optionalNum + paramResult.optionalNum;
-                if (totalRequiredParams > 1) {
-                    if (!options.allowMultipleParameters ||
-                        totalRequiredParams > ConstantString.SMERequiredParamsMaxNum) {
-                        result.reason.push(ErrorType.ExceededRequiredParamsLimit);
-                    }
-                }
-                else if (totalParams === 0) {
-                    result.reason.push(ErrorType.NoParameter);
-                }
-            }
-        }
-        if (result.reason.length > 0) {
-            result.isValid = false;
-        }
-        return result;
-    }
-    static isSupportedAuth(authSchemeArray, options) {
-        if (authSchemeArray.length === 0) {
-            return { isValid: true, reason: [] };
-        }
-        if (options.allowAPIKeyAuth || options.allowOauth2 || options.allowBearerTokenAuth) {
-            // Currently we don't support multiple auth in one operation
-            if (authSchemeArray.length > 0 && authSchemeArray.every((auths) => auths.length > 1)) {
-                return {
-                    isValid: false,
-                    reason: [ErrorType.MultipleAuthNotSupported],
-                };
-            }
-            for (const auths of authSchemeArray) {
-                if (auths.length === 1) {
-                    if ((options.allowAPIKeyAuth && Utils.isAPIKeyAuth(auths[0].authScheme)) ||
-                        (options.allowOauth2 && Utils.isOAuthWithAuthCodeFlow(auths[0].authScheme)) ||
-                        (options.allowBearerTokenAuth && Utils.isBearerTokenAuth(auths[0].authScheme))) {
-                        return { isValid: true, reason: [] };
-                    }
-                }
-            }
-        }
-        return { isValid: false, reason: [ErrorType.AuthTypeIsNotSupported] };
-    }
     static isBearerTokenAuth(authScheme) {
         return authScheme.type === "http" && authScheme.scheme === "bearer";
     }
@@ -439,10 +201,9 @@ class Utils {
         return authScheme.type === "apiKey";
     }
     static isOAuthWithAuthCodeFlow(authScheme) {
-        if (authScheme.type === "oauth2" && authScheme.flows && authScheme.flows.authorizationCode) {
-            return true;
-        }
-        return false;
+        return !!(authScheme.type === "oauth2" &&
+            authScheme.flows &&
+            authScheme.flows.authorizationCode);
     }
     static getAuthArray(securities, spec) {
         var _a;
@@ -470,7 +231,7 @@ class Utils {
     static updateFirstLetter(str) {
         return str.charAt(0).toUpperCase() + str.slice(1);
     }
-    static getResponseJson(operationObject, isTeamsAiProject = false) {
+    static getResponseJson(operationObject) {
         var _a, _b;
         let json = {};
         let multipleMediaType = false;
@@ -481,9 +242,6 @@ class Utils {
                 json = responseObject.content["application/json"];
                 if (Utils.containMultipleMediaTypes(responseObject)) {
                     multipleMediaType = true;
-                    if (isTeamsAiProject) {
-                        break;
-                    }
                     json = {};
                 }
                 else {
@@ -711,13 +469,7 @@ class Utils {
             }
         }
         const operationId = operationItem.operationId;
-        const parameters = [];
-        if (requiredParams.length !== 0) {
-            parameters.push(...requiredParams);
-        }
-        else {
-            parameters.push(optionalParams[0]);
-        }
+        const parameters = [...requiredParams, ...optionalParams];
         const command = {
             context: ["compose"],
             type: "query",
@@ -726,26 +478,51 @@ class Utils {
             parameters: parameters,
             description: ((_b = operationItem.description) !== null && _b !== void 0 ? _b : "").slice(0, ConstantString.CommandDescriptionMaxLens),
         };
-        let warning = undefined;
-        if (requiredParams.length === 0 && optionalParams.length > 1) {
-            warning = {
-                type: WarningType.OperationOnlyContainsOptionalParam,
-                content: Utils.format(ConstantString.OperationOnlyContainsOptionalParam, operationId),
-                data: operationId,
-            };
+        return command;
+    }
+    static format(str, ...args) {
+        let index = 0;
+        return str.replace(/%s/g, () => {
+            const arg = args[index++];
+            return arg !== undefined ? arg : "";
+        });
+    }
+    static getSafeRegistrationIdEnvName(authName) {
+        if (!authName) {
+            return "";
         }
-        return [command, warning];
+        let safeRegistrationIdEnvName = authName.toUpperCase().replace(/[^A-Z0-9_]/g, "_");
+        if (!safeRegistrationIdEnvName.match(/^[A-Z]/)) {
+            safeRegistrationIdEnvName = "PREFIX_" + safeRegistrationIdEnvName;
+        }
+        return safeRegistrationIdEnvName;
+    }
+    static getServerObject(spec, method, path) {
+        const pathObj = spec.paths[path];
+        const operationObject = pathObj[method];
+        const rootServer = spec.servers && spec.servers[0];
+        const methodServer = spec.paths[path].servers && spec.paths[path].servers[0];
+        const operationServer = operationObject.servers && operationObject.servers[0];
+        const serverUrl = operationServer || methodServer || rootServer;
+        return serverUrl;
     }
-    static listAPIs(spec, options) {
+}
+
+// Copyright (c) Microsoft Corporation.
+class Validator {
+    listAPIs() {
         var _a;
-        const paths = spec.paths;
+        if (this.apiMap) {
+            return this.apiMap;
+        }
+        const paths = this.spec.paths;
         const result = {};
         for (const path in paths) {
             const methods = paths[path];
             for (const method in methods) {
                 const operationObject = methods[method];
-                if (((_a = options.allowMethods) === null || _a === void 0 ? void 0 : _a.includes(method)) && operationObject) {
-                    const validateResult = Utils.isSupportedApi(method, path, spec, options);
+                if (((_a = this.options.allowMethods) === null || _a === void 0 ? void 0 : _a.includes(method)) && operationObject) {
+                    const validateResult = this.validateAPI(method, path);
                     result[`${method.toUpperCase()} ${path}`] = {
                         operation: operationObject,
                         isValid: validateResult.isValid,
@@ -754,38 +531,48 @@ class Utils {
                 }
             }
         }
+        this.apiMap = result;
         return result;
     }
-    static validateSpec(spec, parser, isSwaggerFile, options) {
-        const errors = [];
-        const warnings = [];
-        const apiMap = Utils.listAPIs(spec, options);
-        if (isSwaggerFile) {
-            warnings.push({
-                type: WarningType.ConvertSwaggerToOpenAPI,
-                content: ConstantString.ConvertSwaggerToOpenAPI,
-            });
-        }
-        const serverErrors = Utils.validateServer(spec, options);
-        errors.push(...serverErrors);
-        // Remote reference not supported
-        const refPaths = parser.$refs.paths();
-        // refPaths [0] is the current spec file path
-        if (refPaths.length > 1) {
-            errors.push({
-                type: ErrorType.RemoteRefNotSupported,
-                content: Utils.format(ConstantString.RemoteRefNotSupported, refPaths.join(", ")),
-                data: refPaths,
+    validateSpecVersion() {
+        const result = { errors: [], warnings: [] };
+        if (this.spec.openapi >= "3.1.0") {
+            result.errors.push({
+                type: ErrorType.SpecVersionNotSupported,
+                content: Utils.format(ConstantString.SpecVersionNotSupported, this.spec.openapi),
+                data: this.spec.openapi,
             });
         }
-        // No supported API
+        return result;
+    }
+    validateSpecServer() {
+        const result = { errors: [], warnings: [] };
+        const serverErrors = Utils.validateServer(this.spec, this.options);
+        result.errors.push(...serverErrors);
+        return result;
+    }
+    validateSpecNoSupportAPI() {
+        const result = { errors: [], warnings: [] };
+        const apiMap = this.listAPIs();
         const validAPIs = Object.entries(apiMap).filter(([, value]) => value.isValid);
         if (validAPIs.length === 0) {
-            errors.push({
+            const data = [];
+            for (const key in apiMap) {
+                const { reason } = apiMap[key];
+                const apiInvalidReason = { api: key, reason: reason };
+                data.push(apiInvalidReason);
+            }
+            result.errors.push({
                 type: ErrorType.NoSupportedApi,
                 content: ConstantString.NoSupportedApi,
+                data,
             });
         }
+        return result;
+    }
+    validateSpecOperationId() {
+        const result = { errors: [], warnings: [] };
+        const apiMap = this.listAPIs();
         // OperationId missing
         const apisMissingOperationId = [];
         for (const key in apiMap) {
@@ -795,54 +582,431 @@ class Utils {
             }
         }
         if (apisMissingOperationId.length > 0) {
-            warnings.push({
+            result.warnings.push({
                 type: WarningType.OperationIdMissing,
                 content: Utils.format(ConstantString.MissingOperationId, apisMissingOperationId.join(", ")),
                 data: apisMissingOperationId,
             });
         }
-        let status = ValidationStatus.Valid;
-        if (warnings.length > 0 && errors.length === 0) {
-            status = ValidationStatus.Warning;
+        return result;
+    }
+    validateMethodAndPath(method, path) {
+        const result = { isValid: true, reason: [] };
+        if (this.options.allowMethods && !this.options.allowMethods.includes(method)) {
+            result.isValid = false;
+            result.reason.push(ErrorType.MethodNotAllowed);
+            return result;
         }
-        else if (errors.length > 0) {
-            status = ValidationStatus.Error;
+        const pathObj = this.spec.paths[path];
+        if (!pathObj || !pathObj[method]) {
+            result.isValid = false;
+            result.reason.push(ErrorType.UrlPathNotExist);
+            return result;
         }
-        return {
-            status,
-            warnings,
-            errors,
-        };
-    }
-    static format(str, ...args) {
-        let index = 0;
-        return str.replace(/%s/g, () => {
-            const arg = args[index++];
-            return arg !== undefined ? arg : "";
-        });
+        return result;
     }
-    static getSafeRegistrationIdEnvName(authName) {
-        if (!authName) {
-            return "";
+    validateResponse(method, path) {
+        const result = { isValid: true, reason: [] };
+        const operationObject = this.spec.paths[path][method];
+        const { json, multipleMediaType } = Utils.getResponseJson(operationObject);
+        // only support response body only contains “application/json” content type
+        if (multipleMediaType) {
+            result.reason.push(ErrorType.ResponseContainMultipleMediaTypes);
         }
-        let safeRegistrationIdEnvName = authName.toUpperCase().replace(/[^A-Z0-9_]/g, "_");
-        if (!safeRegistrationIdEnvName.match(/^[A-Z]/)) {
-            safeRegistrationIdEnvName = "PREFIX_" + safeRegistrationIdEnvName;
+        else if (Object.keys(json).length === 0) {
+            // response body should not be empty
+            result.reason.push(ErrorType.ResponseJsonIsEmpty);
         }
-        return safeRegistrationIdEnvName;
+        return result;
     }
-    static getAllAPICount(spec) {
-        let count = 0;
-        const paths = spec.paths;
-        for (const path in paths) {
-            const methods = paths[path];
-            for (const method in methods) {
-                if (ConstantString.AllOperationMethods.includes(method)) {
-                    count++;
+    validateServer(method, path) {
+        const result = { isValid: true, reason: [] };
+        const serverObj = Utils.getServerObject(this.spec, method, path);
+        if (!serverObj) {
+            // should contain server URL
+            result.reason.push(ErrorType.NoServerInformation);
+        }
+        else {
+            // server url should be absolute url with https protocol
+            const serverValidateResult = Utils.checkServerUrl([serverObj]);
+            result.reason.push(...serverValidateResult.map((item) => item.type));
+        }
+        return result;
+    }
+    validateAuth(method, path) {
+        const pathObj = this.spec.paths[path];
+        const operationObject = pathObj[method];
+        const securities = operationObject.security;
+        const authSchemeArray = Utils.getAuthArray(securities, this.spec);
+        if (authSchemeArray.length === 0) {
+            return { isValid: true, reason: [] };
+        }
+        if (this.options.allowAPIKeyAuth ||
+            this.options.allowOauth2 ||
+            this.options.allowBearerTokenAuth) {
+            // Currently we don't support multiple auth in one operation
+            if (authSchemeArray.length > 0 && authSchemeArray.every((auths) => auths.length > 1)) {
+                return {
+                    isValid: false,
+                    reason: [ErrorType.MultipleAuthNotSupported],
+                };
+            }
+            for (const auths of authSchemeArray) {
+                if (auths.length === 1) {
+                    if ((this.options.allowAPIKeyAuth && Utils.isAPIKeyAuth(auths[0].authScheme)) ||
+                        (this.options.allowOauth2 && Utils.isOAuthWithAuthCodeFlow(auths[0].authScheme)) ||
+                        (this.options.allowBearerTokenAuth && Utils.isBearerTokenAuth(auths[0].authScheme))) {
+                        return { isValid: true, reason: [] };
+                    }
+                }
+            }
+        }
+        return { isValid: false, reason: [ErrorType.AuthTypeIsNotSupported] };
+    }
+    checkPostBodySchema(schema, isRequired = false) {
+        var _a;
+        const paramResult = {
+            requiredNum: 0,
+            optionalNum: 0,
+            isValid: true,
+            reason: [],
+        };
+        if (Object.keys(schema).length === 0) {
+            return paramResult;
+        }
+        const isRequiredWithoutDefault = isRequired && schema.default === undefined;
+        const isCopilot = this.projectType === ProjectType.Copilot;
+        if (isCopilot && this.hasNestedObjectInSchema(schema)) {
+            paramResult.isValid = false;
+            paramResult.reason = [ErrorType.RequestBodyContainsNestedObject];
+            return paramResult;
+        }
+        if (schema.type === "string" ||
+            schema.type === "integer" ||
+            schema.type === "boolean" ||
+            schema.type === "number") {
+            if (isRequiredWithoutDefault) {
+                paramResult.requiredNum = paramResult.requiredNum + 1;
+            }
+            else {
+                paramResult.optionalNum = paramResult.optionalNum + 1;
+            }
+        }
+        else if (schema.type === "object") {
+            const { properties } = schema;
+            for (const property in properties) {
+                let isRequired = false;
+                if (schema.required && ((_a = schema.required) === null || _a === void 0 ? void 0 : _a.indexOf(property)) >= 0) {
+                    isRequired = true;
                 }
+                const result = this.checkPostBodySchema(properties[property], isRequired);
+                paramResult.requiredNum += result.requiredNum;
+                paramResult.optionalNum += result.optionalNum;
+                paramResult.isValid = paramResult.isValid && result.isValid;
+                paramResult.reason.push(...result.reason);
             }
         }
-        return count;
+        else {
+            if (isRequiredWithoutDefault && !isCopilot) {
+                paramResult.isValid = false;
+                paramResult.reason.push(ErrorType.PostBodyContainsRequiredUnsupportedSchema);
+            }
+        }
+        return paramResult;
+    }
+    checkParamSchema(paramObject) {
+        const paramResult = {
+            requiredNum: 0,
+            optionalNum: 0,
+            isValid: true,
+            reason: [],
+        };
+        if (!paramObject) {
+            return paramResult;
+        }
+        const isCopilot = this.projectType === ProjectType.Copilot;
+        for (let i = 0; i < paramObject.length; i++) {
+            const param = paramObject[i];
+            const schema = param.schema;
+            if (isCopilot && this.hasNestedObjectInSchema(schema)) {
+                paramResult.isValid = false;
+                paramResult.reason.push(ErrorType.ParamsContainsNestedObject);
+                continue;
+            }
+            const isRequiredWithoutDefault = param.required && schema.default === undefined;
+            if (isCopilot) {
+                if (isRequiredWithoutDefault) {
+                    paramResult.requiredNum = paramResult.requiredNum + 1;
+                }
+                else {
+                    paramResult.optionalNum = paramResult.optionalNum + 1;
+                }
+                continue;
+            }
+            if (param.in === "header" || param.in === "cookie") {
+                if (isRequiredWithoutDefault) {
+                    paramResult.isValid = false;
+                    paramResult.reason.push(ErrorType.ParamsContainRequiredUnsupportedSchema);
+                }
+                continue;
+            }
+            if (schema.type !== "boolean" &&
+                schema.type !== "string" &&
+                schema.type !== "number" &&
+                schema.type !== "integer") {
+                if (isRequiredWithoutDefault) {
+                    paramResult.isValid = false;
+                    paramResult.reason.push(ErrorType.ParamsContainRequiredUnsupportedSchema);
+                }
+                continue;
+            }
+            if (param.in === "query" || param.in === "path") {
+                if (isRequiredWithoutDefault) {
+                    paramResult.requiredNum = paramResult.requiredNum + 1;
+                }
+                else {
+                    paramResult.optionalNum = paramResult.optionalNum + 1;
+                }
+            }
+        }
+        return paramResult;
+    }
+    hasNestedObjectInSchema(schema) {
+        if (schema.type === "object") {
+            for (const property in schema.properties) {
+                const nestedSchema = schema.properties[property];
+                if (nestedSchema.type === "object") {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+}
+
+// Copyright (c) Microsoft Corporation.
+class CopilotValidator extends Validator {
+    constructor(spec, options) {
+        super();
+        this.projectType = ProjectType.Copilot;
+        this.options = options;
+        this.spec = spec;
+    }
+    validateSpec() {
+        const result = { errors: [], warnings: [] };
+        // validate spec version
+        let validationResult = this.validateSpecVersion();
+        result.errors.push(...validationResult.errors);
+        // validate spec server
+        validationResult = this.validateSpecServer();
+        result.errors.push(...validationResult.errors);
+        // validate no supported API
+        validationResult = this.validateSpecNoSupportAPI();
+        result.errors.push(...validationResult.errors);
+        // validate operationId missing
+        validationResult = this.validateSpecOperationId();
+        result.warnings.push(...validationResult.warnings);
+        return result;
+    }
+    validateAPI(method, path) {
+        const result = { isValid: true, reason: [] };
+        method = method.toLocaleLowerCase();
+        // validate method and path
+        const methodAndPathResult = this.validateMethodAndPath(method, path);
+        if (!methodAndPathResult.isValid) {
+            return methodAndPathResult;
+        }
+        const operationObject = this.spec.paths[path][method];
+        // validate auth
+        const authCheckResult = this.validateAuth(method, path);
+        result.reason.push(...authCheckResult.reason);
+        // validate operationId
+        if (!this.options.allowMissingId && !operationObject.operationId) {
+            result.reason.push(ErrorType.MissingOperationId);
+        }
+        // validate server
+        const validateServerResult = this.validateServer(method, path);
+        result.reason.push(...validateServerResult.reason);
+        // validate response
+        const validateResponseResult = this.validateResponse(method, path);
+        result.reason.push(...validateResponseResult.reason);
+        // validate requestBody
+        const requestBody = operationObject.requestBody;
+        const requestJsonBody = requestBody === null || requestBody === void 0 ? void 0 : requestBody.content["application/json"];
+        if (Utils.containMultipleMediaTypes(requestBody)) {
+            result.reason.push(ErrorType.PostBodyContainMultipleMediaTypes);
+        }
+        if (requestJsonBody) {
+            const requestBodySchema = requestJsonBody.schema;
+            if (requestBodySchema.type !== "object") {
+                result.reason.push(ErrorType.PostBodySchemaIsNotJson);
+            }
+            const requestBodyParamResult = this.checkPostBodySchema(requestBodySchema, requestBody.required);
+            result.reason.push(...requestBodyParamResult.reason);
+        }
+        // validate parameters
+        const paramObject = operationObject.parameters;
+        const paramResult = this.checkParamSchema(paramObject);
+        result.reason.push(...paramResult.reason);
+        if (result.reason.length > 0) {
+            result.isValid = false;
+        }
+        return result;
+    }
+}
+
+// Copyright (c) Microsoft Corporation.
+class SMEValidator extends Validator {
+    constructor(spec, options) {
+        super();
+        this.projectType = ProjectType.SME;
+        this.options = options;
+        this.spec = spec;
+    }
+    validateSpec() {
+        const result = { errors: [], warnings: [] };
+        // validate spec version
+        let validationResult = this.validateSpecVersion();
+        result.errors.push(...validationResult.errors);
+        // validate spec server
+        validationResult = this.validateSpecServer();
+        result.errors.push(...validationResult.errors);
+        // validate no supported API
+        validationResult = this.validateSpecNoSupportAPI();
+        result.errors.push(...validationResult.errors);
+        // validate operationId missing
+        if (this.options.allowMissingId) {
+            validationResult = this.validateSpecOperationId();
+            result.warnings.push(...validationResult.warnings);
+        }
+        return result;
+    }
+    validateAPI(method, path) {
+        const result = { isValid: true, reason: [] };
+        method = method.toLocaleLowerCase();
+        // validate method and path
+        const methodAndPathResult = this.validateMethodAndPath(method, path);
+        if (!methodAndPathResult.isValid) {
+            return methodAndPathResult;
+        }
+        const operationObject = this.spec.paths[path][method];
+        // validate auth
+        const authCheckResult = this.validateAuth(method, path);
+        result.reason.push(...authCheckResult.reason);
+        // validate operationId
+        if (!this.options.allowMissingId && !operationObject.operationId) {
+            result.reason.push(ErrorType.MissingOperationId);
+        }
+        // validate server
+        const validateServerResult = this.validateServer(method, path);
+        result.reason.push(...validateServerResult.reason);
+        // validate response
+        const validateResponseResult = this.validateResponse(method, path);
+        result.reason.push(...validateResponseResult.reason);
+        let postBodyResult = {
+            requiredNum: 0,
+            optionalNum: 0,
+            isValid: true,
+            reason: [],
+        };
+        // validate requestBody
+        const requestBody = operationObject.requestBody;
+        const requestJsonBody = requestBody === null || requestBody === void 0 ? void 0 : requestBody.content["application/json"];
+        if (Utils.containMultipleMediaTypes(requestBody)) {
+            result.reason.push(ErrorType.PostBodyContainMultipleMediaTypes);
+        }
+        if (requestJsonBody) {
+            const requestBodySchema = requestJsonBody.schema;
+            postBodyResult = this.checkPostBodySchema(requestBodySchema, requestBody.required);
+            result.reason.push(...postBodyResult.reason);
+        }
+        // validate parameters
+        const paramObject = operationObject.parameters;
+        const paramResult = this.checkParamSchema(paramObject);
+        result.reason.push(...paramResult.reason);
+        // validate total parameters count
+        if (paramResult.isValid && postBodyResult.isValid) {
+            const paramCountResult = this.validateParamCount(postBodyResult, paramResult);
+            result.reason.push(...paramCountResult.reason);
+        }
+        if (result.reason.length > 0) {
+            result.isValid = false;
+        }
+        return result;
+    }
+    validateParamCount(postBodyResult, paramResult) {
+        const result = { isValid: true, reason: [] };
+        const totalRequiredParams = postBodyResult.requiredNum + paramResult.requiredNum;
+        const totalParams = totalRequiredParams + postBodyResult.optionalNum + paramResult.optionalNum;
+        if (totalRequiredParams > 1) {
+            if (!this.options.allowMultipleParameters ||
+                totalRequiredParams > SMEValidator.SMERequiredParamsMaxNum) {
+                result.reason.push(ErrorType.ExceededRequiredParamsLimit);
+            }
+        }
+        else if (totalParams === 0) {
+            result.reason.push(ErrorType.NoParameter);
+        }
+        return result;
+    }
+}
+SMEValidator.SMERequiredParamsMaxNum = 5;
+
+// Copyright (c) Microsoft Corporation.
+class TeamsAIValidator extends Validator {
+    constructor(spec, options) {
+        super();
+        this.projectType = ProjectType.TeamsAi;
+        this.options = options;
+        this.spec = spec;
+    }
+    validateSpec() {
+        const result = { errors: [], warnings: [] };
+        // validate spec server
+        let validationResult = this.validateSpecServer();
+        result.errors.push(...validationResult.errors);
+        // validate no supported API
+        validationResult = this.validateSpecNoSupportAPI();
+        result.errors.push(...validationResult.errors);
+        return result;
+    }
+    validateAPI(method, path) {
+        const result = { isValid: true, reason: [] };
+        method = method.toLocaleLowerCase();
+        // validate method and path
+        const methodAndPathResult = this.validateMethodAndPath(method, path);
+        if (!methodAndPathResult.isValid) {
+            return methodAndPathResult;
+        }
+        const operationObject = this.spec.paths[path][method];
+        // validate operationId
+        if (!this.options.allowMissingId && !operationObject.operationId) {
+            result.reason.push(ErrorType.MissingOperationId);
+        }
+        // validate server
+        const validateServerResult = this.validateServer(method, path);
+        result.reason.push(...validateServerResult.reason);
+        if (result.reason.length > 0) {
+            result.isValid = false;
+        }
+        return result;
+    }
+}
+
+class ValidatorFactory {
+    static create(spec, options) {
+        var _a;
+        const type = (_a = options.projectType) !== null && _a !== void 0 ? _a : ProjectType.SME;
+        switch (type) {
+            case ProjectType.SME:
+                return new SMEValidator(spec, options);
+            case ProjectType.Copilot:
+                return new CopilotValidator(spec, options);
+            case ProjectType.TeamsAi:
+                return new TeamsAIValidator(spec, options);
+            default:
+                throw new Error(`Invalid project type: ${type}`);
+        }
     }
 }
 
@@ -860,7 +1024,8 @@ class SpecFilter {
                 if (ConstantString.AllOperationMethods.includes(methodName) &&
                     pathObj &&
                     pathObj[methodName]) {
-                    const validateResult = Utils.isSupportedApi(methodName, path, resolvedSpec, options);
+                    const validator = ValidatorFactory.create(resolvedSpec, options);
+                    const validateResult = validator.validateAPI(methodName, path);
                     if (!validateResult.isValid) {
                         continue;
                     }
@@ -886,6 +1051,293 @@ class SpecFilter {
     }
 }
 
+// Copyright (c) Microsoft Corporation.
+class AdaptiveCardGenerator {
+    static generateAdaptiveCard(operationItem) {
+        try {
+            const { json } = Utils.getResponseJson(operationItem);
+            let cardBody = [];
+            let schema = json.schema;
+            let jsonPath = "$";
+            if (schema && Object.keys(schema).length > 0) {
+                jsonPath = AdaptiveCardGenerator.getResponseJsonPathFromSchema(schema);
+                if (jsonPath !== "$") {
+                    schema = schema.properties[jsonPath];
+                }
+                cardBody = AdaptiveCardGenerator.generateCardFromResponse(schema, "");
+            }
+            // if no schema, try to use example value
+            if (cardBody.length === 0 && (json.examples || json.example)) {
+                cardBody = [
+                    {
+                        type: ConstantString.TextBlockType,
+                        text: "${jsonStringify($root)}",
+                        wrap: true,
+                    },
+                ];
+            }
+            // if no example value, use default success response
+            if (cardBody.length === 0) {
+                cardBody = [
+                    {
+                        type: ConstantString.TextBlockType,
+                        text: "success",
+                        wrap: true,
+                    },
+                ];
+            }
+            const fullCard = {
+                type: ConstantString.AdaptiveCardType,
+                $schema: ConstantString.AdaptiveCardSchema,
+                version: ConstantString.AdaptiveCardVersion,
+                body: cardBody,
+            };
+            return [fullCard, jsonPath];
+        }
+        catch (err) {
+            throw new SpecParserError(err.toString(), ErrorType.GenerateAdaptiveCardFailed);
+        }
+    }
+    static generateCardFromResponse(schema, name, parentArrayName = "") {
+        if (schema.type === "array") {
+            // schema.items can be arbitrary object: schema { type: array, items: {} }
+            if (Object.keys(schema.items).length === 0) {
+                return [
+                    {
+                        type: ConstantString.TextBlockType,
+                        text: name ? `${name}: \${jsonStringify(${name})}` : "result: ${jsonStringify($root)}",
+                        wrap: true,
+                    },
+                ];
+            }
+            const obj = AdaptiveCardGenerator.generateCardFromResponse(schema.items, "", name);
+            const template = {
+                type: ConstantString.ContainerType,
+                $data: name ? `\${${name}}` : "${$root}",
+                items: Array(),
+            };
+            template.items.push(...obj);
+            return [template];
+        }
+        // some schema may not contain type but contain properties
+        if (schema.type === "object" || (!schema.type && schema.properties)) {
+            const { properties } = schema;
+            const result = [];
+            for (const property in properties) {
+                const obj = AdaptiveCardGenerator.generateCardFromResponse(properties[property], name ? `${name}.${property}` : property, parentArrayName);
+                result.push(...obj);
+            }
+            if (schema.additionalProperties) {
+                // TODO: better ways to handler warnings.
+                console.warn(ConstantString.AdditionalPropertiesNotSupported);
+            }
+            return result;
+        }
+        if (schema.type === "string" ||
+            schema.type === "integer" ||
+            schema.type === "boolean" ||
+            schema.type === "number") {
+            if (!AdaptiveCardGenerator.isImageUrlProperty(schema, name, parentArrayName)) {
+                // string in root: "ddd"
+                let text = "result: ${$root}";
+                if (name) {
+                    // object { id: "1" }
+                    text = `${name}: \${if(${name}, ${name}, 'N/A')}`;
+                    if (parentArrayName) {
+                        // object types inside array: { tags: ["id": 1, "name": "name"] }
+                        text = `${parentArrayName}.${text}`;
+                    }
+                }
+                else if (parentArrayName) {
+                    // string array: photoUrls: ["1", "2"]
+                    text = `${parentArrayName}: ` + "${$data}";
+                }
+                return [
+                    {
+                        type: ConstantString.TextBlockType,
+                        text,
+                        wrap: true,
+                    },
+                ];
+            }
+            else {
+                if (name) {
+                    return [
+                        {
+                            type: "Image",
+                            url: `\${${name}}`,
+                            $when: `\${${name} != null}`,
+                        },
+                    ];
+                }
+                else {
+                    return [
+                        {
+                            type: "Image",
+                            url: "${$data}",
+                            $when: "${$data != null}",
+                        },
+                    ];
+                }
+            }
+        }
+        if (schema.oneOf || schema.anyOf || schema.not || schema.allOf) {
+            throw new Error(Utils.format(ConstantString.SchemaNotSupported, JSON.stringify(schema)));
+        }
+        throw new Error(Utils.format(ConstantString.UnknownSchema, JSON.stringify(schema)));
+    }
+    // Find the first array property in the response schema object with the well-known name
+    static getResponseJsonPathFromSchema(schema) {
+        if (schema.type === "object" || (!schema.type && schema.properties)) {
+            const { properties } = schema;
+            for (const property in properties) {
+                const schema = properties[property];
+                if (schema.type === "array" &&
+                    Utils.isWellKnownName(property, ConstantString.WellknownResultNames)) {
+                    return property;
+                }
+            }
+        }
+        return "$";
+    }
+    static isImageUrlProperty(schema, name, parentArrayName) {
+        const propertyName = name ? name : parentArrayName;
+        return (!!propertyName &&
+            schema.type === "string" &&
+            Utils.isWellKnownName(propertyName, ConstantString.WellknownImageName) &&
+            (propertyName.toLocaleLowerCase().indexOf("url") >= 0 || schema.format === "uri"));
+    }
+}
+
+// Copyright (c) Microsoft Corporation.
+function wrapAdaptiveCard(card, jsonPath) {
+    const result = {
+        version: ConstantString.WrappedCardVersion,
+        $schema: ConstantString.WrappedCardSchema,
+        jsonPath: jsonPath,
+        responseLayout: ConstantString.WrappedCardResponseLayout,
+        responseCardTemplate: card,
+        previewCardTemplate: inferPreviewCardTemplate(card),
+    };
+    return result;
+}
+function wrapResponseSemantics(card, jsonPath) {
+    const props = inferProperties(card);
+    const dataPath = jsonPath === "$" ? "$" : "$." + jsonPath;
+    const result = {
+        data_path: dataPath,
+    };
+    if (props.title || props.subtitle || props.imageUrl) {
+        result.properties = {};
+        if (props.title) {
+            result.properties.title = "$." + props.title;
+        }
+        if (props.subtitle) {
+            result.properties.subtitle = "$." + props.subtitle;
+        }
+        if (props.imageUrl) {
+            result.properties.url = "$." + props.imageUrl;
+        }
+    }
+    result.static_template = card;
+    return result;
+}
+/**
+ * Infers the preview card template from an Adaptive Card and a JSON path.
+ * The preview card template includes a title and an optional subtitle and image.
+ * It populates the preview card template with the first text block that matches
+ * each well-known name, in the order of title, subtitle, and image.
+ * If no text block matches the title or subtitle, it uses the first two text block as the title and subtitle.
+ * If the title is still empty and the subtitle is not empty, it uses subtitle as the title.
+ * @param card The Adaptive Card to infer the preview card template from.
+ * @param jsonPath The JSON path to the root object in the card body.
+ * @returns The inferred preview card template.
+ */
+function inferPreviewCardTemplate(card) {
+    const result = {
+        title: "result",
+    };
+    const inferredProperties = inferProperties(card);
+    if (inferredProperties.title) {
+        result.title = `\${if(${inferredProperties.title}, ${inferredProperties.title}, 'N/A')}`;
+    }
+    if (inferredProperties.subtitle) {
+        result.subtitle = `\${if(${inferredProperties.subtitle}, ${inferredProperties.subtitle}, 'N/A')}`;
+    }
+    if (inferredProperties.imageUrl) {
+        result.image = {
+            url: `\${${inferredProperties.imageUrl}}`,
+            alt: `\${if(${inferredProperties.imageUrl}, ${inferredProperties.imageUrl}, 'N/A')}`,
+            $when: `\${${inferredProperties.imageUrl} != null}`,
+        };
+    }
+    return result;
+}
+function inferProperties(card) {
+    var _a;
+    const result = {};
+    const nameSet = new Set();
+    let rootObject;
+    if (((_a = card.body[0]) === null || _a === void 0 ? void 0 : _a.type) === ConstantString.ContainerType) {
+        rootObject = card.body[0].items;
+    }
+    else {
+        rootObject = card.body;
+    }
+    for (const element of rootObject) {
+        if (element.type === ConstantString.TextBlockType) {
+            const textElement = element;
+            const index = textElement.text.indexOf("${if(");
+            if (index > 0) {
+                const text = textElement.text.substring(index);
+                const match = text.match(/\${if\(([^,]+),/);
+                const property = match ? match[1] : "";
+                if (property) {
+                    nameSet.add(property);
+                }
+            }
+        }
+        else if (element.type === ConstantString.ImageType) {
+            const imageElement = element;
+            const match = imageElement.url.match(/\${([^,]+)}/);
+            const property = match ? match[1] : "";
+            if (property) {
+                nameSet.add(property);
+            }
+        }
+    }
+    for (const name of nameSet) {
+        if (!result.title && Utils.isWellKnownName(name, ConstantString.WellknownTitleName)) {
+            result.title = name;
+            nameSet.delete(name);
+        }
+        else if (!result.subtitle &&
+            Utils.isWellKnownName(name, ConstantString.WellknownSubtitleName)) {
+            result.subtitle = name;
+            nameSet.delete(name);
+        }
+        else if (!result.imageUrl && Utils.isWellKnownName(name, ConstantString.WellknownImageName)) {
+            result.imageUrl = name;
+            nameSet.delete(name);
+        }
+    }
+    for (const name of nameSet) {
+        if (!result.title) {
+            result.title = name;
+            nameSet.delete(name);
+        }
+        else if (!result.subtitle) {
+            result.subtitle = name;
+            nameSet.delete(name);
+        }
+    }
+    if (!result.title && result.subtitle) {
+        result.title = result.subtitle;
+        delete result.subtitle;
+    }
+    return result;
+}
+
 // Copyright (c) Microsoft Corporation.
 class ManifestUpdater {
     static async updateManifestWithAiPlugin(manifestPath, outputSpecPath, apiPluginFilePath, spec, options) {
@@ -893,13 +1345,14 @@ class ManifestUpdater {
         const apiPluginRelativePath = ManifestUpdater.getRelativePath(manifestPath, apiPluginFilePath);
         manifest.plugins = [
             {
-                pluginFile: apiPluginRelativePath,
+                file: apiPluginRelativePath,
+                id: ConstantString.DefaultPluginId,
             },
         ];
         const appName = this.removeEnvs(manifest.name.short);
         ManifestUpdater.updateManifestDescription(manifest, spec);
         const specRelativePath = ManifestUpdater.getRelativePath(manifestPath, outputSpecPath);
-        const apiPlugin = ManifestUpdater.generatePluginManifestSchema(spec, specRelativePath, appName, options);
+        const apiPlugin = await ManifestUpdater.generatePluginManifestSchema(spec, specRelativePath, apiPluginFilePath, appName, options);
         return [manifest, apiPlugin];
     }
     static updateManifestDescription(manifest, spec) {
@@ -923,10 +1376,11 @@ class ManifestUpdater {
         }
         return parameter;
     }
-    static generatePluginManifestSchema(spec, specRelativePath, appName, options) {
-        var _a, _b, _c;
+    static async generatePluginManifestSchema(spec, specRelativePath, apiPluginFilePath, appName, options) {
+        var _a, _b, _c, _d;
         const functions = [];
         const functionNames = [];
+        const conversationStarters = [];
         const paths = spec.paths;
         for (const pathUrl in paths) {
             const pathItem = paths[pathUrl];
@@ -979,31 +1433,82 @@ class ManifestUpdater {
                                 description: description,
                                 parameters: parameters,
                             };
+                            if (options.allowResponseSemantics) {
+                                const [card, jsonPath] = AdaptiveCardGenerator.generateAdaptiveCard(operationItem);
+                                const responseSemantic = wrapResponseSemantics(card, jsonPath);
+                                funcObj.capabilities = {
+                                    response_semantics: responseSemantic,
+                                };
+                            }
                             functions.push(funcObj);
                             functionNames.push(operationId);
+                            if (description) {
+                                conversationStarters.push(description);
+                            }
                         }
                     }
                 }
             }
         }
-        const apiPlugin = {
-            schema_version: "v2",
-            name_for_human: appName,
-            description_for_human: (_c = spec.info.description) !== null && _c !== void 0 ? _c : "<Please add description of the plugin>",
-            functions: functions,
-            runtimes: [
-                {
-                    type: "OpenApi",
-                    auth: {
-                        type: "none", // TODO, support auth in the future
-                    },
-                    spec: {
-                        url: specRelativePath,
-                    },
-                    run_for_functions: functionNames,
+        let apiPlugin;
+        if (await fs.pathExists(apiPluginFilePath)) {
+            apiPlugin = await fs.readJSON(apiPluginFilePath);
+        }
+        else {
+            apiPlugin = {
+                schema_version: "v2",
+                name_for_human: "",
+                description_for_human: "",
+                functions: [],
+                runtimes: [],
+            };
+        }
+        apiPlugin.functions = apiPlugin.functions || [];
+        for (const func of functions) {
+            const index = (_c = apiPlugin.functions) === null || _c === void 0 ? void 0 : _c.findIndex((f) => f.name === func.name);
+            if (index === -1) {
+                apiPlugin.functions.push(func);
+            }
+            else {
+                apiPlugin.functions[index] = func;
+            }
+        }
+        apiPlugin.runtimes = apiPlugin.runtimes || [];
+        const index = apiPlugin.runtimes.findIndex((runtime) => runtime.spec.url === specRelativePath);
+        if (index === -1) {
+            apiPlugin.runtimes.push({
+                type: "OpenApi",
+                auth: {
+                    type: "none",
                 },
-            ],
-        };
+                spec: {
+                    url: specRelativePath,
+                },
+                run_for_functions: functionNames,
+            });
+        }
+        else {
+            apiPlugin.runtimes[index].run_for_functions = functionNames;
+        }
+        if (!apiPlugin.name_for_human) {
+            apiPlugin.name_for_human = appName;
+        }
+        if (!apiPlugin.description_for_human) {
+            apiPlugin.description_for_human =
+                (_d = spec.info.description) !== null && _d !== void 0 ? _d : "<Please add description of the plugin>";
+        }
+        if (options.allowConversationStarters && conversationStarters.length > 0) {
+            if (!apiPlugin.capabilities) {
+                apiPlugin.capabilities = {
+                    localization: {},
+                };
+            }
+            if (!apiPlugin.capabilities.conversation_starters) {
+                apiPlugin.capabilities.conversation_starters = conversationStarters
+                    .slice(0, 5)
+                    .map((text) => ({ text }));
+            }
+        }
         return apiPlugin;
     }
     static async updateManifest(manifestPath, outputSpecPath, spec, options, adaptiveCardFolder, authInfo) {
@@ -1072,16 +1577,26 @@ class ManifestUpdater {
                         if ((_a = options.allowMethods) === null || _a === void 0 ? void 0 : _a.includes(method)) {
                             const operationItem = operations[method];
                             if (operationItem) {
-                                const [command, warning] = Utils.parseApiInfo(operationItem, options);
+                                const command = Utils.parseApiInfo(operationItem, options);
+                                if (command.parameters &&
+                                    command.parameters.length >= 1 &&
+                                    command.parameters.some((param) => param.isRequired)) {
+                                    command.parameters = command.parameters.filter((param) => param.isRequired);
+                                }
+                                else if (command.parameters && command.parameters.length > 0) {
+                                    command.parameters = [command.parameters[0]];
+                                    warnings.push({
+                                        type: WarningType.OperationOnlyContainsOptionalParam,
+                                        content: Utils.format(ConstantString.OperationOnlyContainsOptionalParam, command.id),
+                                        data: command.id,
+                                    });
+                                }
                                 if (adaptiveCardFolder) {
                                     const adaptiveCardPath = path.join(adaptiveCardFolder, command.id + ".json");
                                     command.apiResponseRenderingTemplateFile = (await fs.pathExists(adaptiveCardPath))
                                         ? ManifestUpdater.getRelativePath(manifestPath, adaptiveCardPath)
                                         : "";
                                 }
-                                if (warning) {
-                                    warnings.push(warning);
-                                }
                                 commands.push(command);
                             }
                         }
@@ -1106,255 +1621,6 @@ class ManifestUpdater {
     }
 }
 
-// Copyright (c) Microsoft Corporation.
-class AdaptiveCardGenerator {
-    static generateAdaptiveCard(operationItem) {
-        try {
-            const { json } = Utils.getResponseJson(operationItem);
-            let cardBody = [];
-            let schema = json.schema;
-            let jsonPath = "$";
-            if (schema && Object.keys(schema).length > 0) {
-                jsonPath = AdaptiveCardGenerator.getResponseJsonPathFromSchema(schema);
-                if (jsonPath !== "$") {
-                    schema = schema.properties[jsonPath];
-                }
-                cardBody = AdaptiveCardGenerator.generateCardFromResponse(schema, "");
-            }
-            // if no schema, try to use example value
-            if (cardBody.length === 0 && (json.examples || json.example)) {
-                cardBody = [
-                    {
-                        type: ConstantString.TextBlockType,
-                        text: "${jsonStringify($root)}",
-                        wrap: true,
-                    },
-                ];
-            }
-            // if no example value, use default success response
-            if (cardBody.length === 0) {
-                cardBody = [
-                    {
-                        type: ConstantString.TextBlockType,
-                        text: "success",
-                        wrap: true,
-                    },
-                ];
-            }
-            const fullCard = {
-                type: ConstantString.AdaptiveCardType,
-                $schema: ConstantString.AdaptiveCardSchema,
-                version: ConstantString.AdaptiveCardVersion,
-                body: cardBody,
-            };
-            return [fullCard, jsonPath];
-        }
-        catch (err) {
-            throw new SpecParserError(err.toString(), ErrorType.GenerateAdaptiveCardFailed);
-        }
-    }
-    static generateCardFromResponse(schema, name, parentArrayName = "") {
-        if (schema.type === "array") {
-            // schema.items can be arbitrary object: schema { type: array, items: {} }
-            if (Object.keys(schema.items).length === 0) {
-                return [
-                    {
-                        type: ConstantString.TextBlockType,
-                        text: name ? `${name}: \${jsonStringify(${name})}` : "result: ${jsonStringify($root)}",
-                        wrap: true,
-                    },
-                ];
-            }
-            const obj = AdaptiveCardGenerator.generateCardFromResponse(schema.items, "", name);
-            const template = {
-                type: ConstantString.ContainerType,
-                $data: name ? `\${${name}}` : "${$root}",
-                items: Array(),
-            };
-            template.items.push(...obj);
-            return [template];
-        }
-        // some schema may not contain type but contain properties
-        if (schema.type === "object" || (!schema.type && schema.properties)) {
-            const { properties } = schema;
-            const result = [];
-            for (const property in properties) {
-                const obj = AdaptiveCardGenerator.generateCardFromResponse(properties[property], name ? `${name}.${property}` : property, parentArrayName);
-                result.push(...obj);
-            }
-            if (schema.additionalProperties) {
-                // TODO: better ways to handler warnings.
-                console.warn(ConstantString.AdditionalPropertiesNotSupported);
-            }
-            return result;
-        }
-        if (schema.type === "string" ||
-            schema.type === "integer" ||
-            schema.type === "boolean" ||
-            schema.type === "number") {
-            if (!AdaptiveCardGenerator.isImageUrlProperty(schema, name, parentArrayName)) {
-                // string in root: "ddd"
-                let text = "result: ${$root}";
-                if (name) {
-                    // object { id: "1" }
-                    text = `${name}: \${if(${name}, ${name}, 'N/A')}`;
-                    if (parentArrayName) {
-                        // object types inside array: { tags: ["id": 1, "name": "name"] }
-                        text = `${parentArrayName}.${text}`;
-                    }
-                }
-                else if (parentArrayName) {
-                    // string array: photoUrls: ["1", "2"]
-                    text = `${parentArrayName}: ` + "${$data}";
-                }
-                return [
-                    {
-                        type: ConstantString.TextBlockType,
-                        text,
-                        wrap: true,
-                    },
-                ];
-            }
-            else {
-                if (name) {
-                    return [
-                        {
-                            type: "Image",
-                            url: `\${${name}}`,
-                            $when: `\${${name} != null}`,
-                        },
-                    ];
-                }
-                else {
-                    return [
-                        {
-                            type: "Image",
-                            url: "${$data}",
-                            $when: "${$data != null}",
-                        },
-                    ];
-                }
-            }
-        }
-        if (schema.oneOf || schema.anyOf || schema.not || schema.allOf) {
-            throw new Error(Utils.format(ConstantString.SchemaNotSupported, JSON.stringify(schema)));
-        }
-        throw new Error(Utils.format(ConstantString.UnknownSchema, JSON.stringify(schema)));
-    }
-    // Find the first array property in the response schema object with the well-known name
-    static getResponseJsonPathFromSchema(schema) {
-        if (schema.type === "object" || (!schema.type && schema.properties)) {
-            const { properties } = schema;
-            for (const property in properties) {
-                const schema = properties[property];
-                if (schema.type === "array" &&
-                    Utils.isWellKnownName(property, ConstantString.WellknownResultNames)) {
-                    return property;
-                }
-            }
-        }
-        return "$";
-    }
-    static isImageUrlProperty(schema, name, parentArrayName) {
-        const propertyName = name ? name : parentArrayName;
-        return (!!propertyName &&
-            schema.type === "string" &&
-            Utils.isWellKnownName(propertyName, ConstantString.WellknownImageName) &&
-            (propertyName.toLocaleLowerCase().indexOf("url") >= 0 || schema.format === "uri"));
-    }
-}
-
-// Copyright (c) Microsoft Corporation.
-function wrapAdaptiveCard(card, jsonPath) {
-    const result = {
-        version: ConstantString.WrappedCardVersion,
-        $schema: ConstantString.WrappedCardSchema,
-        jsonPath: jsonPath,
-        responseLayout: ConstantString.WrappedCardResponseLayout,
-        responseCardTemplate: card,
-        previewCardTemplate: inferPreviewCardTemplate(card),
-    };
-    return result;
-}
-/**
- * Infers the preview card template from an Adaptive Card and a JSON path.
- * The preview card template includes a title and an optional subtitle and image.
- * It populates the preview card template with the first text block that matches
- * each well-known name, in the order of title, subtitle, and image.
- * If no text block matches the title or subtitle, it uses the first two text block as the title and subtitle.
- * If the title is still empty and the subtitle is not empty, it uses subtitle as the title.
- * @param card The Adaptive Card to infer the preview card template from.
- * @param jsonPath The JSON path to the root object in the card body.
- * @returns The inferred preview card template.
- */
-function inferPreviewCardTemplate(card) {
-    var _a;
-    const result = {
-        title: "",
-    };
-    const textBlockElements = new Set();
-    let rootObject;
-    if (((_a = card.body[0]) === null || _a === void 0 ? void 0 : _a.type) === ConstantString.ContainerType) {
-        rootObject = card.body[0].items;
-    }
-    else {
-        rootObject = card.body;
-    }
-    for (const element of rootObject) {
-        if (element.type === ConstantString.TextBlockType) {
-            const textElement = element;
-            const index = textElement.text.indexOf("${if(");
-            if (index > 0) {
-                textElement.text = textElement.text.substring(index);
-                textBlockElements.add(textElement);
-            }
-        }
-    }
-    for (const element of textBlockElements) {
-        const text = element.text;
-        if (!result.title && Utils.isWellKnownName(text, ConstantString.WellknownTitleName)) {
-            result.title = text;
-            textBlockElements.delete(element);
-        }
-        else if (!result.subtitle &&
-            Utils.isWellKnownName(text, ConstantString.WellknownSubtitleName)) {
-            result.subtitle = text;
-            textBlockElements.delete(element);
-        }
-        else if (!result.image && Utils.isWellKnownName(text, ConstantString.WellknownImageName)) {
-            const match = text.match(/\${if\(([^,]+),/);
-            const property = match ? match[1] : "";
-            if (property) {
-                result.image = {
-                    url: `\${${property}}`,
-                    alt: text,
-                    $when: `\${${property} != null}`,
-                };
-            }
-            textBlockElements.delete(element);
-        }
-    }
-    for (const element of textBlockElements) {
-        const text = element.text;
-        if (!result.title) {
-            result.title = text;
-            textBlockElements.delete(element);
-        }
-        else if (!result.subtitle) {
-            result.subtitle = text;
-            textBlockElements.delete(element);
-        }
-    }
-    if (!result.title && result.subtitle) {
-        result.title = result.subtitle;
-        delete result.subtitle;
-    }
-    if (!result.title) {
-        result.title = "result";
-    }
-    return result;
-}
-
 // Copyright (c) Microsoft Corporation.
 /**
  * A class that parses an OpenAPI specification file and provides methods to validate, list, and generate artifacts.
@@ -1374,6 +1640,8 @@ class SpecParser {
             allowMultipleParameters: false,
             allowOauth2: false,
             allowMethods: ["get", "post"],
+            allowConversationStarters: false,
+            allowResponseSemantics: false,
             projectType: ProjectType.SME,
         };
         this.pathOrSpec = pathOrDoc;
@@ -1398,6 +1666,8 @@ class SpecParser {
                     errors: [{ type: ErrorType.SpecNotValid, content: e.toString() }],
                 };
             }
+            const errors = [];
+            const warnings = [];
             if (!this.options.allowSwagger && this.isSwaggerFile) {
                 return {
                     status: ValidationStatus.Error,
@@ -1407,23 +1677,38 @@ class SpecParser {
                     ],
                 };
             }
-            if (this.options.projectType === ProjectType.SME ||
-                this.options.projectType === ProjectType.Copilot) {
-                if (this.spec.openapi >= "3.1.0") {
-                    return {
-                        status: ValidationStatus.Error,
-                        warnings: [],
-                        errors: [
-                            {
-                                type: ErrorType.SpecVersionNotSupported,
-                                content: Utils.format(ConstantString.SpecVersionNotSupported, this.spec.openapi),
-                                data: this.spec.openapi,
-                            },
-                        ],
-                    };
-                }
+            // Remote reference not supported
+            const refPaths = this.parser.$refs.paths();
+            // refPaths [0] is the current spec file path
+            if (refPaths.length > 1) {
+                errors.push({
+                    type: ErrorType.RemoteRefNotSupported,
+                    content: Utils.format(ConstantString.RemoteRefNotSupported, refPaths.join(", ")),
+                    data: refPaths,
+                });
             }
-            return Utils.validateSpec(this.spec, this.parser, !!this.isSwaggerFile, this.options);
+            if (!!this.isSwaggerFile && this.options.allowSwagger) {
+                warnings.push({
+                    type: WarningType.ConvertSwaggerToOpenAPI,
+                    content: ConstantString.ConvertSwaggerToOpenAPI,
+                });
+            }
+            const validator = this.getValidator(this.spec);
+            const validationResult = validator.validateSpec();
+            warnings.push(...validationResult.warnings);
+            errors.push(...validationResult.errors);
+            let status = ValidationStatus.Valid;
+            if (warnings.length > 0 && errors.length === 0) {
+                status = ValidationStatus.Warning;
+            }
+            else if (errors.length > 0) {
+                status = ValidationStatus.Error;
+            }
+            return {
+                status: status,
+                warnings: warnings,
+                errors: errors,
+            };
         }
         catch (err) {
             throw new SpecParserError(err.toString(), ErrorType.ValidateFailed);
@@ -1452,34 +1737,27 @@ class SpecParser {
             for (const apiKey in apiMap) {
                 const { operation, isValid, reason } = apiMap[apiKey];
                 const [method, path] = apiKey.split(" ");
+                const operationId = (_a = operation.operationId) !== null && _a !== void 0 ? _a : `${method.toLowerCase()}${Utils.convertPathToCamelCase(path)}`;
                 const apiResult = {
-                    api: "",
+                    api: apiKey,
                     server: "",
-                    operationId: "",
+                    operationId: operationId,
                     isValid: isValid,
                     reason: reason,
                 };
-                const rootServer = spec.servers && spec.servers[0];
-                const methodServer = spec.paths[path].servers && ((_a = spec.paths[path]) === null || _a === void 0 ? void 0 : _a.servers[0]);
-                const operationServer = operation.servers && operation.servers[0];
-                const serverUrl = operationServer || methodServer || rootServer;
-                if (!serverUrl) {
-                    throw new SpecParserError(ConstantString.NoServerInformation, ErrorType.NoServerInformation);
-                }
-                apiResult.server = Utils.resolveEnv(serverUrl.url);
-                let operationId = operation.operationId;
-                if (!operationId) {
-                    operationId = `${method.toLowerCase()}${Utils.convertPathToCamelCase(path)}`;
-                }
-                apiResult.operationId = operationId;
-                const authArray = Utils.getAuthArray(operation.security, spec);
-                for (const auths of authArray) {
-                    if (auths.length === 1) {
-                        apiResult.auth = auths[0];
-                        break;
+                if (isValid) {
+                    const serverObj = Utils.getServerObject(spec, method.toLocaleLowerCase(), path);
+                    if (serverObj) {
+                        apiResult.server = Utils.resolveEnv(serverObj.url);
+                    }
+                    const authArray = Utils.getAuthArray(operation.security, spec);
+                    for (const auths of authArray) {
+                        if (auths.length === 1) {
+                            apiResult.auth = auths[0];
+                            break;
+                        }
                     }
                 }
-                apiResult.api = apiKey;
                 result.APIs.push(apiResult);
             }
             result.allAPICount = result.APIs.length;
@@ -1659,12 +1937,17 @@ class SpecParser {
         }
     }
     getAPIs(spec) {
-        if (this.apiMap !== undefined) {
-            return this.apiMap;
+        const validator = this.getValidator(spec);
+        const apiMap = validator.listAPIs();
+        return apiMap;
+    }
+    getValidator(spec) {
+        if (this.validator) {
+            return this.validator;
         }
-        const result = Utils.listAPIs(spec, this.options);
-        this.apiMap = result;
-        return result;
+        const validator = ValidatorFactory.create(spec, this.options);
+        this.validator = validator;
+        return validator;
     }
 }