@microsoft/teamsfx-core 2.0.10-alpha.fa1ce1fbb.0 → 2.0.10-alpha.ff616a623.0

package/build/component/generator/apiSpec/generator.js

@@ -0,0 +1,260 @@
+"use strict";
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpecGenerator = void 0;
+const tslib_1 = require("tslib");
+/**
+ * @author yuqzho@microsoft.com
+ */
+const m365_spec_parser_1 = require("@microsoft/m365-spec-parser");
+const teamsfx_api_1 = require("@microsoft/teamsfx-api");
+const fs = tslib_1.__importStar(require("fs-extra"));
+const lodash_1 = require("lodash");
+const path_1 = tslib_1.__importDefault(require("path"));
+const featureFlags_1 = require("../../../common/featureFlags");
+const stringUtils_1 = require("../../../common/stringUtils");
+const error_1 = require("../../../error");
+const constants_1 = require("../../../question/constants");
+const ManifestUtils_1 = require("../../driver/teamsApp/utils/ManifestUtils");
+const generator_1 = require("../generator");
+const templateGenerator_1 = require("../templates/templateGenerator");
+const helper_1 = require("./helper");
+const CopilotGptManifestUtils_1 = require("../../driver/teamsApp/utils/CopilotGptManifestUtils");
+const constant_1 = require("../constant");
+const utils_1 = require("../../../common/utils");
+const defaultDeclarativeCopilotActionId = "action_1";
+// const fromApiSpecComponentName = "copilot-plugin-existing-api";
+// const pluginFromApiSpecComponentName = "api-copilot-plugin-existing-api";
+const fromApiSpecTemplateName = "copilot-plugin-existing-api";
+// const fromOpenAIPlugincomponentName = "copilot-plugin-from-oai-plugin";
+const forCustomCopilotRagCustomApi = "custom-copilot-rag-custom-api";
+const copilotPluginExistingApiSpecUrlTelemetryEvent = "copilot-plugin-existing-api-spec-url";
+const apiPluginFromApiSpecTemplateName = "api-plugin-existing-api";
+const failedToUpdateCustomApiTemplateErrorName = "failed-to-update-custom-api-template";
+const defaultDeclarativeCopilotManifestFileName = "declarativeCopilot.json";
+function normalizePath(path) {
+    return "./" + path.replace(/\\/g, "/");
+}
+class SpecGenerator extends templateGenerator_1.DefaultTemplateGenerator {
+    constructor() {
+        super(...arguments);
+        this.componentName = "spec-generator";
+    }
+    // isYaml = false;
+    // templateName = "";
+    // url = "";
+    // isPlugin = false;
+    // type = -1;
+    // activation condition
+    activate(context, inputs) {
+        const capability = inputs.capabilities;
+        const meArchitecture = inputs[constants_1.QuestionNames.MeArchitectureType];
+        return (inputs[constants_1.QuestionNames.ApiPluginType] === constants_1.ApiPluginStartOptions.apiSpec().id ||
+            meArchitecture === constants_1.MeArchitectureOptions.apiSpec().id ||
+            (capability === constants_1.CapabilityOptions.customCopilotRag().id &&
+                inputs[constants_1.QuestionNames.CustomCopilotRag] === constants_1.CustomCopilotRagOptions.customApi().id));
+    }
+    getTemplateName(inputs) {
+        const capability = inputs.capabilities;
+        const meArchitecture = inputs[constants_1.QuestionNames.MeArchitectureType];
+        let templateName = "";
+        if ((capability === constants_1.CapabilityOptions.apiPlugin().id ||
+            capability === constants_1.CapabilityOptions.declarativeCopilot().id) &&
+            inputs[constants_1.QuestionNames.ApiPluginType] === constants_1.ApiPluginStartOptions.apiSpec().id) {
+            templateName = apiPluginFromApiSpecTemplateName;
+        }
+        else if (meArchitecture === constants_1.MeArchitectureOptions.apiSpec().id) {
+            templateName = fromApiSpecTemplateName;
+        }
+        else if (capability === constants_1.CapabilityOptions.customCopilotRag().id &&
+            inputs[constants_1.QuestionNames.CustomCopilotRag] === constants_1.CustomCopilotRagOptions.customApi().id) {
+            templateName = forCustomCopilotRagCustomApi;
+        }
+        return templateName;
+    }
+    async getTemplateInfos(context, inputs, destinationPath, actionContext) {
+        var _a;
+        const meArchitecture = inputs[constants_1.QuestionNames.MeArchitectureType];
+        const getTemplateInfosState = {
+            isYaml: false,
+            templateName: this.getTemplateName(inputs),
+            url: inputs[constants_1.QuestionNames.ApiSpecLocation].trim(),
+            isPlugin: false,
+            type: m365_spec_parser_1.ProjectType.SME,
+        };
+        let authData = undefined;
+        if (inputs[constants_1.QuestionNames.ApiPluginType] === constants_1.ApiPluginStartOptions.apiSpec().id) {
+            getTemplateInfosState.isPlugin = true;
+            authData = inputs.apiAuthData;
+        }
+        else if (meArchitecture === constants_1.MeArchitectureOptions.apiSpec().id) {
+            authData = inputs.apiAuthData;
+        }
+        const isDeclarativeCopilot = inputs[constants_1.QuestionNames.Capabilities] === constants_1.CapabilityOptions.declarativeCopilot().id;
+        (0, lodash_1.merge)(actionContext === null || actionContext === void 0 ? void 0 : actionContext.telemetryProps, {
+            ["template-name" /* telemetryProperties.templateName */]: getTemplateInfosState.templateName,
+            ["is-declarative-copilot" /* telemetryProperties.isDeclarativeCopilot */]: isDeclarativeCopilot.toString(),
+        });
+        const appName = inputs[constants_1.QuestionNames.AppName];
+        let language = inputs[constants_1.QuestionNames.ProgrammingLanguage];
+        if (getTemplateInfosState.templateName !== forCustomCopilotRagCustomApi) {
+            language =
+                language === constants_1.ProgrammingLanguage.CSharp
+                    ? constants_1.ProgrammingLanguage.CSharp
+                    : constants_1.ProgrammingLanguage.None;
+        }
+        const safeProjectNameFromVS = language === "csharp" ? inputs[constants_1.QuestionNames.SafeProjectName] : undefined;
+        getTemplateInfosState.type =
+            getTemplateInfosState.templateName === forCustomCopilotRagCustomApi
+                ? m365_spec_parser_1.ProjectType.TeamsAi
+                : getTemplateInfosState.isPlugin
+                    ? m365_spec_parser_1.ProjectType.Copilot
+                    : m365_spec_parser_1.ProjectType.SME;
+        try {
+            getTemplateInfosState.isYaml = !(await (0, utils_1.isJsonSpecFile)(getTemplateInfosState.url));
+        }
+        catch (e) { }
+        const openapiSpecFileName = getTemplateInfosState.isYaml
+            ? teamsfx_api_1.DefaultApiSpecYamlFileName
+            : teamsfx_api_1.DefaultApiSpecJsonFileName;
+        const llmService = inputs[constants_1.QuestionNames.LLMService];
+        const openAIKey = inputs[constants_1.QuestionNames.OpenAIKey];
+        const azureOpenAIKey = inputs[constants_1.QuestionNames.AzureOpenAIKey];
+        const azureOpenAIEndpoint = inputs[constants_1.QuestionNames.AzureOpenAIEndpoint];
+        const azureOpenAIDeploymentName = inputs[constants_1.QuestionNames.AzureOpenAIDeploymentName];
+        const llmServiceData = {
+            llmService,
+            openAIKey,
+            azureOpenAIKey,
+            azureOpenAIEndpoint,
+            azureOpenAIDeploymentName,
+        };
+        if (authData === null || authData === void 0 ? void 0 : authData.authName) {
+            const envName = (0, helper_1.getEnvName)(authData.authName, authData.authType);
+            context.templateVariables = generator_1.Generator.getDefaultVariables(appName, safeProjectNameFromVS, inputs.targetFramework, inputs.placeProjectFileInSolutionDir === "true", {
+                authName: authData.authName,
+                openapiSpecPath: normalizePath(path_1.default.join(teamsfx_api_1.AppPackageFolderName, teamsfx_api_1.DefaultApiSpecFolderName, openapiSpecFileName)),
+                registrationIdEnvName: envName,
+                authType: authData.authType,
+            }, llmServiceData);
+        }
+        else {
+            context.templateVariables = generator_1.Generator.getDefaultVariables(appName, safeProjectNameFromVS, inputs.targetFramework, inputs.placeProjectFileInSolutionDir === "true", undefined, llmServiceData);
+        }
+        context.telemetryReporter.sendTelemetryEvent(copilotPluginExistingApiSpecUrlTelemetryEvent, {
+            ["remote-url" /* telemetryProperties.isRemoteUrlTelemetryProperty */]: (0, stringUtils_1.isValidHttpUrl)(getTemplateInfosState.url).toString(),
+            ["generate-type" /* telemetryProperties.generateType */]: getTemplateInfosState.type.toString(),
+            ["auth-type" /* telemetryProperties.authType */]: (_a = authData === null || authData === void 0 ? void 0 : authData.authName) !== null && _a !== void 0 ? _a : "None",
+        });
+        inputs.getTemplateInfosState = getTemplateInfosState;
+        return (0, teamsfx_api_1.ok)([
+            {
+                templateName: getTemplateInfosState.templateName,
+                language: language,
+                replaceMap: Object.assign(Object.assign({}, context.templateVariables), { DeclarativeCopilot: isDeclarativeCopilot ? "true" : "", FileFunction: featureFlags_1.featureFlagManager.getBooleanValue(featureFlags_1.FeatureFlags.EnvFileFunc) ? "true" : "" }),
+                filterFn: (fileName) => {
+                    if (fileName.includes(`${defaultDeclarativeCopilotManifestFileName}.tpl`)) {
+                        return isDeclarativeCopilot;
+                    }
+                    else if (fileName.includes(constant_1.declarativeCopilotInstructionFileName)) {
+                        return (isDeclarativeCopilot && featureFlags_1.featureFlagManager.getBooleanValue(featureFlags_1.FeatureFlags.EnvFileFunc));
+                    }
+                    {
+                        return true;
+                    }
+                },
+            },
+        ]);
+    }
+    async post(context, inputs, destinationPath, actionContext) {
+        try {
+            const getTemplateInfosState = inputs.getTemplateInfosState;
+            const isDeclarativeCopilot = inputs[constants_1.QuestionNames.Capabilities] === constants_1.CapabilityOptions.declarativeCopilot().id;
+            const manifestPath = path_1.default.join(destinationPath, teamsfx_api_1.AppPackageFolderName, teamsfx_api_1.ManifestTemplateFileName);
+            const apiSpecFolderPath = path_1.default.join(destinationPath, teamsfx_api_1.AppPackageFolderName, teamsfx_api_1.DefaultApiSpecFolderName);
+            const openapiSpecFileName = getTemplateInfosState.isYaml
+                ? teamsfx_api_1.DefaultApiSpecYamlFileName
+                : teamsfx_api_1.DefaultApiSpecJsonFileName;
+            const openapiSpecPath = path_1.default.join(apiSpecFolderPath, openapiSpecFileName);
+            await fs.ensureDir(apiSpecFolderPath);
+            let warnings;
+            const pluginManifestPath = getTemplateInfosState.type === m365_spec_parser_1.ProjectType.Copilot
+                ? path_1.default.join(destinationPath, teamsfx_api_1.AppPackageFolderName, teamsfx_api_1.DefaultPluginManifestFileName)
+                : undefined;
+            const responseTemplateFolder = getTemplateInfosState.type === m365_spec_parser_1.ProjectType.SME
+                ? path_1.default.join(destinationPath, teamsfx_api_1.AppPackageFolderName, teamsfx_api_1.ResponseTemplatesFolderName)
+                : undefined;
+            const specParser = new m365_spec_parser_1.SpecParser(getTemplateInfosState.url, (0, helper_1.getParserOptions)(getTemplateInfosState.type, isDeclarativeCopilot));
+            const generateResult = await (0, helper_1.generateFromApiSpec)(specParser, manifestPath, inputs, context, this.componentName, getTemplateInfosState.type, {
+                destinationApiSpecFilePath: openapiSpecPath,
+                pluginManifestFilePath: pluginManifestPath,
+                responseTemplateFolder,
+            });
+            if (generateResult.isErr()) {
+                return (0, teamsfx_api_1.err)(generateResult.error);
+            }
+            else {
+                warnings = generateResult.value.warnings;
+            }
+            if (isDeclarativeCopilot) {
+                const gptManifestPath = path_1.default.join(path_1.default.dirname(manifestPath), defaultDeclarativeCopilotManifestFileName);
+                const addAcionResult = await CopilotGptManifestUtils_1.copilotGptManifestUtils.addAction(gptManifestPath, defaultDeclarativeCopilotActionId, teamsfx_api_1.DefaultPluginManifestFileName);
+                if (addAcionResult.isErr()) {
+                    return (0, teamsfx_api_1.err)(addAcionResult.error);
+                }
+            }
+            if (getTemplateInfosState.templateName === forCustomCopilotRagCustomApi) {
+                const specs = await specParser.getFilteredSpecs(inputs[constants_1.QuestionNames.ApiOperation]);
+                const spec = specs[1];
+                try {
+                    const language = inputs[constants_1.QuestionNames.ProgrammingLanguage];
+                    await (0, helper_1.updateForCustomApi)(spec, language, destinationPath, openapiSpecFileName);
+                }
+                catch (error) {
+                    throw new teamsfx_api_1.SystemError(this.componentName, failedToUpdateCustomApiTemplateErrorName, error.message, error.message);
+                }
+            }
+            const manifestRes = await ManifestUtils_1.manifestUtils._readAppManifest(manifestPath);
+            if (manifestRes.isErr()) {
+                return (0, teamsfx_api_1.err)(manifestRes.error);
+            }
+            const teamsManifest = manifestRes.value;
+            // log warnings
+            if (inputs.platform === teamsfx_api_1.Platform.CLI || inputs.platform === teamsfx_api_1.Platform.VS) {
+                const warnSummary = await (0, helper_1.generateScaffoldingSummary)(warnings, teamsManifest, path_1.default.relative(destinationPath, openapiSpecPath), pluginManifestPath === undefined
+                    ? undefined
+                    : path_1.default.relative(destinationPath, pluginManifestPath), destinationPath);
+                if (warnSummary) {
+                    context.logProvider.info(warnSummary);
+                }
+            }
+            if (inputs.platform === teamsfx_api_1.Platform.VSCode) {
+                return (0, teamsfx_api_1.ok)({
+                    warnings: warnings.map((warning) => {
+                        return {
+                            type: warning.type,
+                            content: warning.content,
+                            data: warning.data,
+                        };
+                    }),
+                });
+            }
+            else {
+                return (0, teamsfx_api_1.ok)({ warnings: undefined });
+            }
+        }
+        catch (e) {
+            let error;
+            if (e instanceof m365_spec_parser_1.SpecParserError) {
+                error = (0, helper_1.convertSpecParserErrorToFxError)(e);
+            }
+            else {
+                error = (0, error_1.assembleError)(e);
+            }
+            return (0, teamsfx_api_1.err)(error);
+        }
+    }
+}
+exports.SpecGenerator = SpecGenerator;
+//# sourceMappingURL=generator.js.map

package/build/component/generator/apiSpec/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../src/component/generator/apiSpec/generator.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;;;;AAElC;;GAEG;AAEH,kEAKqC;AACrC,wDAmBgC;AAChC,qDAA+B;AAC/B,mCAA+B;AAC/B,wDAAwB;AACxB,+DAAgF;AAChF,6DAA6D;AAC7D,0CAA+C;AAC/C,2DAOqC;AACrC,6EAA0E;AAE1E,4CAAyC;AACzC,sEAA0E;AAE1E,qCAOkB;AAClB,iGAA8F;AAC9F,0CAAoE;AACpE,iDAAuD;AAEvD,MAAM,iCAAiC,GAAG,UAAU,CAAC;AACrD,kEAAkE;AAClE,4EAA4E;AAC5E,MAAM,uBAAuB,GAAG,6BAA6B,CAAC;AAC9D,0EAA0E;AAC1E,MAAM,4BAA4B,GAAG,+BAA+B,CAAC;AACrE,MAAM,6CAA6C,GAAG,sCAAsC,CAAC;AAE7F,MAAM,gCAAgC,GAAG,yBAAyB,CAAC;AAEnE,MAAM,wCAAwC,GAAG,sCAAsC,CAAC;AACxF,MAAM,yCAAyC,GAAG,yBAAyB,CAAC;AAU5E,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAcD,MAAa,aAAc,SAAQ,4CAAwB;IAA3D;;QACE,kBAAa,GAAG,gBAAgB,CAAC;IA6SnC,CAAC;IA5SC,kBAAkB;IAClB,qBAAqB;IACrB,YAAY;IACZ,oBAAoB;IACpB,aAAa;IAEb,uBAAuB;IAChB,QAAQ,CAAC,OAAgB,EAAE,MAAc;QAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,YAAsB,CAAC;QACjD,MAAM,cAAc,GAAG,MAAM,CAAC,yBAAa,CAAC,kBAAkB,CAAW,CAAC;QAC1E,OAAO,CACL,MAAM,CAAC,yBAAa,CAAC,aAAa,CAAC,KAAK,iCAAqB,CAAC,OAAO,EAAE,CAAC,EAAE;YAC1E,cAAc,KAAK,iCAAqB,CAAC,OAAO,EAAE,CAAC,EAAE;YACrD,CAAC,UAAU,KAAK,6BAAiB,CAAC,gBAAgB,EAAE,CAAC,EAAE;gBACrD,MAAM,CAAC,yBAAa,CAAC,gBAAgB,CAAC,KAAK,mCAAuB,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CACrF,CAAC;IACJ,CAAC;IAED,eAAe,CAAC,MAAc;QAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,YAAsB,CAAC;QACjD,MAAM,cAAc,GAAG,MAAM,CAAC,yBAAa,CAAC,kBAAkB,CAAW,CAAC;QAC1E,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,IACE,CAAC,UAAU,KAAK,6BAAiB,CAAC,SAAS,EAAE,CAAC,EAAE;YAC9C,UAAU,KAAK,6BAAiB,CAAC,kBAAkB,EAAE,CAAC,EAAE,CAAC;YAC3D,MAAM,CAAC,yBAAa,CAAC,aAAa,CAAC,KAAK,iCAAqB,CAAC,OAAO,EAAE,CAAC,EAAE,EAC1E;YACA,YAAY,GAAG,gCAAgC,CAAC;SACjD;aAAM,IAAI,cAAc,KAAK,iCAAqB,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;YAChE,YAAY,GAAG,uBAAuB,CAAC;SACxC;aAAM,IACL,UAAU,KAAK,6BAAiB,CAAC,gBAAgB,EAAE,CAAC,EAAE;YACtD,MAAM,CAAC,yBAAa,CAAC,gBAAgB,CAAC,KAAK,mCAAuB,CAAC,SAAS,EAAE,CAAC,EAAE,EACjF;YACA,YAAY,GAAG,4BAA4B,CAAC;SAC7C;QACD,OAAO,YAAY,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAC3B,OAAgB,EAChB,MAAc,EACd,eAAuB,EACvB,aAA6B;;QAE7B,MAAM,cAAc,GAAG,MAAM,CAAC,yBAAa,CAAC,kBAAkB,CAAW,CAAC;QAC1E,MAAM,qBAAqB,GAAuB;YAChD,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC;YAC1C,GAAG,EAAE,MAAM,CAAC,yBAAa,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE;YACjD,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,8BAAW,CAAC,GAAG;SACtB,CAAC;QACF,IAAI,QAAQ,GAAG,SAAS,CAAC;QACzB,IAAI,MAAM,CAAC,yBAAa,CAAC,aAAa,CAAC,KAAK,iCAAqB,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;YAC9E,qBAAqB,CAAC,QAAQ,GAAG,IAAI,CAAC;YACtC,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC;SAC/B;aAAM,IAAI,cAAc,KAAK,iCAAqB,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;YAChE,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC;SAC/B;QACD,MAAM,oBAAoB,GACxB,MAAM,CAAC,yBAAa,CAAC,YAAY,CAAC,KAAK,6BAAiB,CAAC,kBAAkB,EAAE,CAAC,EAAE,CAAC;QACnF,IAAA,cAAK,EAAC,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,cAAc,EAAE;YACnC,wDAAkC,EAAE,qBAAqB,CAAC,YAAY;YACtE,yEAA0C,EAAE,oBAAoB,CAAC,QAAQ,EAAE;SAC5E,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,yBAAa,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,QAAQ,GAAG,MAAM,CAAC,yBAAa,CAAC,mBAAmB,CAAwB,CAAC;QAChF,IAAI,qBAAqB,CAAC,YAAY,KAAK,4BAA4B,EAAE;YACvE,QAAQ;gBACN,QAAQ,KAAK,+BAAmB,CAAC,MAAM;oBACrC,CAAC,CAAC,+BAAmB,CAAC,MAAM;oBAC5B,CAAC,CAAC,+BAAmB,CAAC,IAAI,CAAC;SAChC;QACD,MAAM,qBAAqB,GACzB,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,yBAAa,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5E,qBAAqB,CAAC,IAAI;YACxB,qBAAqB,CAAC,YAAY,KAAK,4BAA4B;gBACjE,CAAC,CAAC,8BAAW,CAAC,OAAO;gBACrB,CAAC,CAAC,qBAAqB,CAAC,QAAQ;oBAChC,CAAC,CAAC,8BAAW,CAAC,OAAO;oBACrB,CAAC,CAAC,8BAAW,CAAC,GAAG,CAAC;QAEtB,IAAI;YACF,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,IAAA,sBAAc,EAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;SACnF;QAAC,OAAO,CAAC,EAAE,GAAE;QAEd,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,MAAM;YACtD,CAAC,CAAC,wCAA0B;YAC5B,CAAC,CAAC,wCAA0B,CAAC;QAC/B,MAAM,UAAU,GAAuB,MAAM,CAAC,yBAAa,CAAC,UAAU,CAAC,CAAC;QACxE,MAAM,SAAS,GAAuB,MAAM,CAAC,yBAAa,CAAC,SAAS,CAAC,CAAC;QACtE,MAAM,cAAc,GAAuB,MAAM,CAAC,yBAAa,CAAC,cAAc,CAAC,CAAC;QAChF,MAAM,mBAAmB,GAAuB,MAAM,CAAC,yBAAa,CAAC,mBAAmB,CAAC,CAAC;QAC1F,MAAM,yBAAyB,GAC7B,MAAM,CAAC,yBAAa,CAAC,yBAAyB,CAAC,CAAC;QAClD,MAAM,cAAc,GAAG;YACrB,UAAU;YACV,SAAS;YACT,cAAc;YACd,mBAAmB;YACnB,yBAAyB;SAC1B,CAAC;QACF,IAAI,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,QAAQ,EAAE;YACtB,MAAM,OAAO,GAAG,IAAA,mBAAU,EAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACjE,OAAO,CAAC,iBAAiB,GAAG,qBAAS,CAAC,mBAAmB,CACvD,OAAO,EACP,qBAAqB,EACrB,MAAM,CAAC,eAAe,EACtB,MAAM,CAAC,6BAA6B,KAAK,MAAM,EAC/C;gBACE,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,eAAe,EAAE,aAAa,CAC5B,cAAI,CAAC,IAAI,CAAC,kCAAoB,EAAE,sCAAwB,EAAE,mBAAmB,CAAC,CAC/E;gBACD,qBAAqB,EAAE,OAAO;gBAC9B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B,EACD,cAAc,CACf,CAAC;SACH;aAAM;YACL,OAAO,CAAC,iBAAiB,GAAG,qBAAS,CAAC,mBAAmB,CACvD,OAAO,EACP,qBAAqB,EACrB,MAAM,CAAC,eAAe,EACtB,MAAM,CAAC,6BAA6B,KAAK,MAAM,EAC/C,SAAS,EACT,cAAc,CACf,CAAC;SACH;QACD,OAAO,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,6CAA6C,EAAE;YAC1F,qEAAkD,EAAE,IAAA,4BAAc,EAChE,qBAAqB,CAAC,GAAG,CAC1B,CAAC,QAAQ,EAAE;YACZ,wDAAkC,EAAE,qBAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE;YACzE,gDAA8B,EAAE,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,QAAQ,mCAAI,MAAM;SAC7D,CAAC,CAAC;QACH,MAAM,CAAC,qBAAqB,GAAG,qBAAqB,CAAC;QACrD,OAAO,IAAA,gBAAE,EAAC;YACR;gBACE,YAAY,EAAE,qBAAqB,CAAC,YAAY;gBAChD,QAAQ,EAAE,QAAQ;gBAClB,UAAU,kCACL,OAAO,CAAC,iBAAiB,KAC5B,kBAAkB,EAAE,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EACtD,YAAY,EAAE,iCAAkB,CAAC,eAAe,CAAC,2BAAY,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GACzF;gBACD,QAAQ,EAAE,CAAC,QAAgB,EAAE,EAAE;oBAC7B,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,yCAAyC,MAAM,CAAC,EAAE;wBACzE,OAAO,oBAAoB,CAAC;qBAC7B;yBAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,gDAAqC,CAAC,EAAE;wBACnE,OAAO,CACL,oBAAoB,IAAI,iCAAkB,CAAC,eAAe,CAAC,2BAAY,CAAC,WAAW,CAAC,CACrF,CAAC;qBACH;oBACD;wBACE,OAAO,IAAI,CAAC;qBACb;gBACH,CAAC;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,IAAI,CACf,OAAgB,EAChB,MAAc,EACd,eAAuB,EACvB,aAA6B;QAE7B,IAAI;YACF,MAAM,qBAAqB,GAAG,MAAM,CAAC,qBAA2C,CAAC;YACjF,MAAM,oBAAoB,GACxB,MAAM,CAAC,yBAAa,CAAC,YAAY,CAAC,KAAK,6BAAiB,CAAC,kBAAkB,EAAE,CAAC,EAAE,CAAC;YACnF,MAAM,YAAY,GAAG,cAAI,CAAC,IAAI,CAC5B,eAAe,EACf,kCAAoB,EACpB,sCAAwB,CACzB,CAAC;YACF,MAAM,iBAAiB,GAAG,cAAI,CAAC,IAAI,CACjC,eAAe,EACf,kCAAoB,EACpB,sCAAwB,CACzB,CAAC;YACF,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,MAAM;gBACtD,CAAC,CAAC,wCAA0B;gBAC5B,CAAC,CAAC,wCAA0B,CAAC;YAC/B,MAAM,eAAe,GAAG,cAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;YAE1E,MAAM,EAAE,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAEtC,IAAI,QAAyB,CAAC;YAC9B,MAAM,kBAAkB,GACtB,qBAAqB,CAAC,IAAI,KAAK,8BAAW,CAAC,OAAO;gBAChD,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,eAAe,EAAE,kCAAoB,EAAE,2CAA6B,CAAC;gBACjF,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,sBAAsB,GAC1B,qBAAqB,CAAC,IAAI,KAAK,8BAAW,CAAC,GAAG;gBAC5C,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,eAAe,EAAE,kCAAoB,EAAE,yCAA2B,CAAC;gBAC/E,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,UAAU,GAAG,IAAI,6BAAU,CAC/B,qBAAqB,CAAC,GAAG,EACzB,IAAA,yBAAgB,EAAC,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,CAAC,CACnE,CAAC;YACF,MAAM,cAAc,GAAG,MAAM,IAAA,4BAAmB,EAC9C,UAAU,EACV,YAAY,EACZ,MAAM,EACN,OAAO,EACP,IAAI,CAAC,aAAa,EAClB,qBAAqB,CAAC,IAAI,EAC1B;gBACE,0BAA0B,EAAE,eAAe;gBAC3C,sBAAsB,EAAE,kBAAkB;gBAC1C,sBAAsB;aACvB,CACF,CAAC;YACF,IAAI,cAAc,CAAC,KAAK,EAAE,EAAE;gBAC1B,OAAO,IAAA,iBAAG,EAAC,cAAc,CAAC,KAAK,CAAC,CAAC;aAClC;iBAAM;gBACL,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC;aAC1C;YACD,IAAI,oBAAoB,EAAE;gBACxB,MAAM,eAAe,GAAG,cAAI,CAAC,IAAI,CAC/B,cAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAC1B,yCAAyC,CAC1C,CAAC;gBACF,MAAM,cAAc,GAAG,MAAM,iDAAuB,CAAC,SAAS,CAC5D,eAAe,EACf,iCAAiC,EACjC,2CAA6B,CAC9B,CAAC;gBACF,IAAI,cAAc,CAAC,KAAK,EAAE,EAAE;oBAC1B,OAAO,IAAA,iBAAG,EAAC,cAAc,CAAC,KAAK,CAAC,CAAC;iBAClC;aACF;YAED,IAAI,qBAAqB,CAAC,YAAY,KAAK,4BAA4B,EAAE;gBACvE,MAAM,KAAK,GAAG,MAAM,UAAU,CAAC,gBAAgB,CAAC,MAAM,CAAC,yBAAa,CAAC,YAAY,CAAC,CAAC,CAAC;gBACpF,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,IAAI;oBACF,MAAM,QAAQ,GAAG,MAAM,CAAC,yBAAa,CAAC,mBAAmB,CAAwB,CAAC;oBAClF,MAAM,IAAA,2BAAkB,EAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,CAAC,CAAC;iBAChF;gBAAC,OAAO,KAAU,EAAE;oBACnB,MAAM,IAAI,yBAAW,CACnB,IAAI,CAAC,aAAa,EAClB,wCAAwC,EACxC,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,OAAO,CACd,CAAC;iBACH;aACF;YAED,MAAM,WAAW,GAAG,MAAM,6BAAa,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;YAEvE,IAAI,WAAW,CAAC,KAAK,EAAE,EAAE;gBACvB,OAAO,IAAA,iBAAG,EAAC,WAAW,CAAC,KAAK,CAAC,CAAC;aAC/B;YAED,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC;YAExC,eAAe;YACf,IAAI,MAAM,CAAC,QAAQ,KAAK,sBAAQ,CAAC,GAAG,IAAI,MAAM,CAAC,QAAQ,KAAK,sBAAQ,CAAC,EAAE,EAAE;gBACvE,MAAM,WAAW,GAAG,MAAM,IAAA,mCAA0B,EAClD,QAAQ,EACR,aAAa,EACb,cAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC,EAC/C,kBAAkB,KAAK,SAAS;oBAC9B,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,cAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC,EACtD,eAAe,CAChB,CAAC;gBAEF,IAAI,WAAW,EAAE;oBACf,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;iBACvC;aACF;YAED,IAAI,MAAM,CAAC,QAAQ,KAAK,sBAAQ,CAAC,MAAM,EAAE;gBACvC,OAAO,IAAA,gBAAE,EAAC;oBACR,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;wBACjC,OAAO;4BACL,IAAI,EAAE,OAAO,CAAC,IAAI;4BAClB,OAAO,EAAE,OAAO,CAAC,OAAO;4BACxB,IAAI,EAAE,OAAO,CAAC,IAAI;yBACnB,CAAC;oBACJ,CAAC,CAAC;iBACH,CAAC,CAAC;aACJ;iBAAM;gBACL,OAAO,IAAA,gBAAE,EAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;aACpC;SACF;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,KAAc,CAAC;YACnB,IAAI,CAAC,YAAY,kCAAe,EAAE;gBAChC,KAAK,GAAG,IAAA,wCAA+B,EAAC,CAAC,CAAC,CAAC;aAC5C;iBAAM;gBACL,KAAK,GAAG,IAAA,qBAAa,EAAC,CAAC,CAAC,CAAC;aAC1B;YACD,OAAO,IAAA,iBAAG,EAAC,KAAK,CAAC,CAAC;SACnB;IACH,CAAC;CACF;AA9SD,sCA8SC"}

package/build/component/generator/{copilotPlugin → apiSpec}/helper.d.ts

@@ -1,18 +1,14 @@
 /**
  * @author yuqzho@microsoft.com
  */
-import { ErrorResult as ApiSpecErrorResult, ErrorType as ApiSpecErrorType, ParseOptions, SpecParserError, WarningResult } from "@microsoft/m365-spec-parser";
+import { ErrorResult as ApiSpecErrorResult, ErrorType as ApiSpecErrorType, ParseOptions, ProjectType, SpecParser, SpecParserError, WarningResult } from "@microsoft/m365-spec-parser";
 import { ApiOperation, Context, FxError, Inputs, Result, TeamsAppManifest, Warning } from "@microsoft/teamsfx-api";
 import { OpenAPIV3 } from "openapi-types";
-export declare const copilotPluginParserOptions: ParseOptions;
+export declare function getParserOptions(type: ProjectType, isDeclarativeCopilot?: boolean): ParseOptions;
 export declare const specParserGenerateResultTelemetryEvent = "spec-parser-generate-result";
 export declare const specParserGenerateResultAllSuccessTelemetryProperty = "all-success";
 export declare const specParserGenerateResultWarningsTelemetryProperty = "warnings";
 export declare const invalidApiSpecErrorName = "invalid-api-spec";
-export declare const defaultApiSpecFolderName = "apiSpecificationFile";
-export declare const defaultApiSpecYamlFileName = "openapi.yaml";
-export declare const defaultApiSpecJsonFileName = "openapi.json";
-export declare const defaultPluginManifestFileName = "ai-plugin.json";
 export interface ErrorResult {
     /**
      * The type of error.
@@ -26,11 +22,29 @@ export interface ErrorResult {
 }
 export declare function listOperations(context: Context, apiSpecUrl: string | undefined, inputs: Inputs, includeExistingAPIs?: boolean, shouldLogWarning?: boolean, existingCorrelationId?: string): Promise<Result<ApiOperation[], ErrorResult[]>>;
 export declare function listPluginExistingOperations(manifest: TeamsAppManifest, teamsManifestPath: string, destinationApiSpecFilePath: string): Promise<string[]>;
-export declare function logValidationResults(errors: ErrorResult[], warnings: WarningResult[], context: Context, shouldLogWarning: boolean, shouldSkipTelemetry: boolean, existingCorrelationId?: string): void;
-export declare function generateScaffoldingSummary(warnings: Warning[], teamsManifest: TeamsAppManifest, apiSpecFilePath: string): string;
+interface SpecParserOutputFilePath {
+    destinationApiSpecFilePath: string;
+    pluginManifestFilePath?: string;
+    responseTemplateFolder?: string;
+}
+interface SpecParserGenerateResult {
+    warnings: WarningResult[];
+}
+export declare function generateFromApiSpec(specParser: SpecParser, teamsManifestPath: string, inputs: Inputs, context: Context, sourceComponent: string, projectType: ProjectType, outputFilePath: SpecParserOutputFilePath): Promise<Result<SpecParserGenerateResult, FxError>>;
+export declare function logValidationResults(projectType: ProjectType, errors: ErrorResult[], warnings: WarningResult[], context: Context, shouldLogWarning: boolean, shouldSkipTelemetry: boolean, existingCorrelationId?: string): void;
+/**
+ * Generate scaffolding warning summary.
+ * @param warnings warnings returned from spec-parser.
+ * @param teamsManifest Teams manifest.
+ * @param apiSpecFilePath API spec path relative of project path.
+ * @param pluginManifestPath Plugin manifest path relative of project path.
+ * @param projectPath Project path.
+ * @returns Warning message.
+ */
+export declare function generateScaffoldingSummary(warnings: Warning[], teamsManifest: TeamsAppManifest, apiSpecFilePath: string, pluginManifestPath: string | undefined, projectPath: string): Promise<string>;
 export declare function convertSpecParserErrorToFxError(error: SpecParserError): FxError;
-export declare function isYamlSpecFile(specPath: string): Promise<boolean>;
 export declare function formatValidationErrors(errors: ApiSpecErrorResult[], inputs: Inputs): ApiSpecErrorResult[];
 export declare function updateForCustomApi(spec: OpenAPIV3.Document, language: string, destinationPath: string, openapiSpecFileName: string): Promise<void>;
 export declare function getEnvName(authName: string, authType?: string): string;
+export {};
 //# sourceMappingURL=helper.d.ts.map

package/build/component/generator/apiSpec/helper.d.ts.map

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