@microsoft/teamsfx-core 3.1.0 → 3.1.1

package/resource/yaml-schema/yaml.schema.json

@@ -14,7 +14,7 @@
     "version": {
       "type": "string",
       "description": "The version of the yaml file schema",
-      "const": "v1.11"
+      "const": "v1.13"
     },
     "additionalMetadata": {
       "type": "object",
@@ -81,9 +81,11 @@
           { "$ref": "#/definitions/apiKeyUpdate"},
           { "$ref": "#/definitions/oauthRegister"},
           { "$ref": "#/definitions/oauthUpdate"},
+          { "$ref": "#/definitions/dcrRegister"},
           { "$ref": "#/definitions/devChannelCreate"},
           { "$ref": "#/definitions/devChannelInstallApp"},
-          { "$ref": "#/definitions/typeSpecCompile"}
+          { "$ref": "#/definitions/typeSpecCompile"},
+          { "$ref": "#/definitions/copilotAgentPublish"}
         ]
       }
     },
@@ -747,6 +749,9 @@
           "properties": {
             "teamsAppId": {
               "$ref": "#/definitions/envVarName"
+            },
+            "teamsAppTenantId": {
+              "$ref": "#/definitions/envVarName"
             }
           }
         }
@@ -1941,6 +1946,66 @@
         }
       }
     },
+    "dcrRegister": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Create a Dynamic Client Registration (DCR) configuration.",
+      "required": ["uses", "with", "writeToEnvironmentFile"],
+      "properties": {
+        "uses": {
+          "type": "string",
+          "description": "Register a DCR configuration.",
+          "const": "dcr/register"
+        },
+        "with": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Parameters for this action",
+          "required": ["name", "wellKnownAuthorizationServer"],
+          "properties": {
+            "name": {
+              "type": "string",
+              "description": "The display name of the DCR configuration. Becomes the clientName sent during RFC 7591 registration. Max 128 characters."
+            },
+            "appId": {
+              "type": "string",
+              "description": "The Teams app id associated with this configuration. Only takes effect when applicableToApps is SpecificApp."
+            },
+            "wellKnownAuthorizationServer": {
+              "type": "string",
+              "description": "URL to the authorization server's RFC 8414 metadata document. TGS fetches this to discover the registration_endpoint and performs the RFC 7591 exchange server-side."
+            },
+            "targetUrlsShouldStartWith": {
+              "type": "array",
+              "description": "Outbound URL allowlist. TGS only allows this configuration to authorize calls whose destination URL starts with one of these prefixes.",
+              "items": { "type": "string" }
+            },
+            "applicableToApps": {
+              "type": "string",
+              "description": "Which app can use this DCR configuration. Default is \"AnyApp\".",
+              "enum": ["SpecificApp", "AnyApp"]
+            },
+            "targetAudience": {
+              "type": "string",
+              "description": "Which tenant can use this DCR configuration. Default is \"HomeTenant\".",
+              "enum": ["HomeTenant", "AnyTenant"]
+            }
+          }
+        },
+        "writeToEnvironmentFile": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Write environment variables to environment file",
+          "required": ["configurationId"],
+          "properties": {
+            "configurationId": {
+              "description": "Required. The configuration id of the created DCR registration.",
+              "$ref": "#/definitions/envVarName"
+            }
+          }
+        }
+      }
+    },
     "devChannelCreate": {
       "type": "object",
       "additionalProperties": false,
@@ -2063,6 +2128,66 @@
           }
         }
       }
+    },
+    "copilotAgentPublish": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Publish Copilot agent to Microsoft Admin Center. Refer to https://aka.ms/teamsfx-actions/copilotagent-publish for more details.",
+      "required": ["uses", "with"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "An optional name of this action."
+        },
+        "env": {
+          "type": "object",
+          "description": "Define environment variables for this action.",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "uses": {
+          "type": "string",
+          "description": "Publish Copilot agent to Microsoft Admin Center. Refer to https://aka.ms/teamsfx-actions/copilotagent-publish for more details.",
+          "const": "copilotAgent/publish"
+        },
+        "with": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "parameters for this action",
+          "required": ["appPackagePath"],
+          "properties": {
+            "appPackagePath": {
+              "type": "string",
+              "description": "Path to app package to be published."
+            },
+            "scope": {
+              "type": "string",
+              "description": "Scope of the agent. 'personal' is only visible to the owners. 'shared' can be visible to other users in the tenant. 'tenant' is visible to all users in the tenant. Default is 'personal'."
+            }
+          }
+        },
+        "writeToEnvironmentFile": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Write environment variables to environment file",
+          "required": ["titleId", "appId"],
+          "properties": {
+            "titleId": {
+              "description": "Required. The title ID of the published agent.",
+              "$ref": "#/definitions/envVarName"
+            },
+            "appId": {
+              "description": "Required. The app ID of the published agent.",
+              "$ref": "#/definitions/envVarName"
+            },
+            "shareLink": {
+              "description": "Optional. The share link of the app.",
+              "$ref": "#/definitions/envVarName"
+            }
+          }
+        }
+      }
     }
   }
 }

package/templates/configs/playground/typescript/.vscode/tasks.json

@@ -70,7 +70,7 @@
             "isBackground": true,
             "options": {
                 "env": {
-                  "PATH": "${workspaceFolder}/devTools/playground/node_modules/.bin;${env:PATH}"
+                  "PATH": "${workspaceFolder}/devTools/playground/node_modules/.bin:${env:PATH}"
                 }
             },
             "windows": {

package/templates/metadata/allTemplates.json

@@ -15,6 +15,14 @@
     "displayName": "Declarative Agent",
     "description": "Basic Declarative Agent without action"
   },
+  {
+    "id": "declarative-agent-with-skill",
+    "name": "declarative-agent-with-skill",
+    "alias": "declarative-agent-skill",
+    "language": "common",
+    "displayName": "Declarative Agent with Skill",
+    "description": "Declarative Agent with a hello-atk agent skill"
+  },
   {
     "id": "declarative-agent-with-action-from-scratch-ts",
     "name": "api-plugin-from-scratch",
@@ -103,20 +111,6 @@
     "displayName": "Declarative Agent with Action from Existing API",
     "description": "Declarative Agent with action from an existing API specification"
   },
-  {
-    "id": "declarative-agent-meta-os-new-project",
-    "name": "declarative-agent-meta-os-new-project",
-    "language": "common",
-    "displayName": "Declarative Agent for MetaOS (New Project)",
-    "description": "Declarative Agent for MetaOS - new project"
-  },
-  {
-    "id": "declarative-agent-meta-os-upgrade-project",
-    "name": "declarative-agent-meta-os-upgrade-project",
-    "language": "common",
-    "displayName": "Declarative Agent for MetaOS (Upgrade Project)",
-    "description": "Declarative Agent for MetaOS - upgrade existing project"
-  },
   {
     "id": "declarative-agent-with-action-from-mcp",
     "name": "declarative-agent-with-action-from-mcp",
@@ -385,6 +379,14 @@
     "displayName": "Message Extension",
     "description": "Receive user input, process it, and send customized results"
   },
+  {
+    "id": "blank-app",
+    "name": "blank-app",
+    "alias": "blank",
+    "language": "common",
+    "displayName": "Blank App",
+    "description": "Blank M365 app with minimal structure"
+  },
   {
     "id": "office-addin-outlook-taskpane-ts",
     "name": "office-addin-outlook-taskpane",
@@ -403,8 +405,22 @@
     "id": "office-addin-excel-cfshortcut-ts",
     "name": "office-addin-excel-cfshortcut",
     "language": "typescript",
-    "displayName": "Excel Custom Functions",
-    "description": "Create custom functions in Excel with keyboard shortcuts"
+    "displayName": "Excel Custom Functions (Shared Runtime)",
+    "description": "Create custom functions in Excel using a shared runtime"
+  },
+  {
+    "id": "office-addin-excel-customfunctions-ts",
+    "name": "office-addin-excel-customfunctions",
+    "language": "typescript",
+    "displayName": "Excel Custom Functions (JavaScript-only Runtime)",
+    "description": "Create custom functions in Excel using a JavaScript-only runtime"
+  },
+  {
+    "id": "office-addin-sso-naa-ts",
+    "name": "office-addin-sso-naa",
+    "language": "typescript",
+    "displayName": "Single Sign-On with Nested App Auth",
+    "description": "Build a task pane add-in that uses Nested App Auth for single sign-on"
   },
   {
     "id": "office-addin-config-ts",

package/templates/metadata/defaultGeneratorTemplates.json

@@ -206,6 +206,14 @@
     "displayName": "Message Extension",
     "description": "Receive user input, process it, and send customized results"
   },
+  {
+    "id": "blank-app",
+    "name": "blank-app",
+    "alias": "blank",
+    "language": "common",
+    "displayName": "Blank App",
+    "description": "Blank M365 app with minimal structure"
+  },
   {
     "id": "empty-csharp",
     "name": "empty",

package/templates/ui/ceaNode.json

@@ -0,0 +1,30 @@
+{
+  "condition": {
+    "equals": "custom-engine-agent-type"
+  },
+  "data": {
+    "title": "template.customEngineAgent.title",
+    "name": "capabilities",
+    "type": "singleSelect",
+    "options": [
+      {
+        "id": "basic-custom-engine-agent",
+        "label": "template.customEngineAgent.basic.label",
+        "detail": "template.customEngineAgent.basic.detail",
+        "data": "basic-custom-engine-agent"
+      },
+      {
+        "id": "weather-agent",
+        "label": "template.customEngineAgent.weather.label",
+        "detail": "template.customEngineAgent.weather.detail",
+        "data": "weather-agent"
+      }
+    ],
+    "placeholder": "template.customEngineAgent.placeholder"
+  },
+  "children": [
+    {
+      "node": "llmServiceNode"
+    }
+  ]
+}

package/templates/ui/tdpNode.json

@@ -71,6 +71,13 @@
                 "detail": "template.createProjectQuestion.addGC.detail",
                 "data": "declarative-agent-with-graph-connector"
               },
+              {
+                "id": "skill",
+                "label": "template.createProjectQuestion.addSkill.label",
+                "detail": "template.createProjectQuestion.addSkill.detail",
+                "data": "declarative-agent-with-skill",
+                "featureFlag": "TEAMSFX_AGENT_SKILLS"
+              },
               {
                 "id": "type-spec",
                 "label": "template.createProjectQuestion.apiPlugin.typeSpec.label",
@@ -101,19 +108,11 @@
                     "detail": "template.createProjectQuestion.capability.copilotPluginApiSpecOption.detail",
                     "data": "api-plugin-from-existing-api"
                   },
-                  {
-                    "id": "da-meta-os",
-                    "label": "template.createProjectQuestion.capability.DAMetaOS.label",
-                    "detail": "template.createProjectQuestion.capability.DAMetaOS.detail",
-                    "data": "declarative-agent-meta-os-new-project",
-                    "featureFlag": "TEAMSFX_DA_METAOS"
-                  },
                   {
                     "id": "mcp",
                     "label": "template.createProjectQuestion.mcpForDa.label",
                     "detail": "template.createProjectQuestion.mcpForDa.detail",
-                    "data": "declarative-agent-with-action-from-mcp",
-                    "featureFlag": "TEAMSFX_MCP_FOR_DA"
+                    "data": "declarative-agent-with-action-from-mcp"
                   }
                 ]
               },
@@ -130,29 +129,29 @@
                     "options": [
                       {
                         "id": "none",
-                        "label": "None",
+                        "label": "template.createProjectQuestion.apiDeclarativeAgentAuth.none",
                         "data": "api-plugin-from-scratch"
                       },
                       {
                         "id": "api-key",
-                        "label": "API Key",
+                        "label": "template.createProjectQuestion.apiDeclarativeAgentAuth.apiKey",
                         "data": "api-plugin-from-scratch-bearer"
                       },
                       {
                         "id": "microsoft-entra",
-                        "label": "Microsoft Entra",
+                        "label": "template.createProjectQuestion.apiDeclarativeAgentAuth.microsoftEntra",
                         "data": "api-plugin-from-scratch-oauth"
                       },
                       {
                         "id": "oauth",
-                        "label": "OAuth",
+                        "label": "template.createProjectQuestion.apiDeclarativeAgentAuth.oauth",
                         "data": "api-plugin-from-scratch-oauth"
                       }
                     ]
                   }
                 },
                 {
-                  "node": "apiSpecNode",
+                  "node": "apiSpecWithSearchNode",
                   "condition": {
                     "equals": "api-spec"
                   }

package/templates/ui/teamsNode.json

@@ -0,0 +1,124 @@
+{
+  "condition": {
+    "equals": "teams-agent-and-app-type"
+  },
+  "data": {
+    "title": "template.teams.title",
+    "name": "teams-app-type",
+    "type": "singleSelect",
+    "options": [
+      {
+        "id": "custom-copilot-basic",
+        "label": "template.teams.general.label",
+        "detail": "template.teams.general.detail",
+        "data": "custom-copilot-basic"
+      },
+      {
+        "id": "custom-copilot-rag",
+        "label": "template.teams.rag.label",
+        "detail": "template.teams.rag.detail"
+      },
+      {
+        "id": "teams-collaborator-agent",
+        "label": "template.teams.collaboratorAgent.label",
+        "detail": "template.teams.collaboratorAgent.detail",
+        "data": "teams-collaborator-agent"
+      },
+      {
+        "id": "teams-other-app-type",
+        "label": "template.teams.others.label",
+        "detail": "template.teams.others.detail"
+      }
+    ],
+    "placeholder": "template.customEngineAgent.placeholder"
+  },
+  "children": [
+    {
+      "condition": {
+        "equals": "custom-copilot-rag"
+      },
+      "data": {
+        "type": "singleSelect",
+        "name": "custom-copilot-rag",
+        "title": "template.teams.rag.label",
+        "placeholder": "template.teams.rag.source.placeholder",
+        "default": "custom-copilot-rag-customize",
+        "options": [
+          {
+            "id": "custom-copilot-rag-customize",
+            "label": "template.teams.rag.source.customize.label",
+            "detail": "template.teams.rag.source.customize.detail",
+            "data": "custom-copilot-rag-customize"
+          },
+          {
+            "id": "custom-copilot-rag-azure-ai-search",
+            "label": "template.teams.rag.source.azureAISearch.label",
+            "detail": "template.teams.rag.source.azureAISearch.detail",
+            "data": "custom-copilot-rag-azure-ai-search"
+          },
+          {
+            "id": "custom-copilot-rag-custom-api",
+            "label": "template.teams.rag.source.customApi.label",
+            "detail": "template.teams.rag.source.customApi.detail",
+            "data": "custom-copilot-rag-custom-api"
+          }
+        ]
+      },
+      "children": [
+        {
+          "condition": {
+            "equals": "custom-copilot-rag-custom-api"
+          },
+          "node": "apiSpecNode"
+        }
+      ]
+    },
+    {
+      "condition": {
+        "enum": [
+          "custom-copilot-basic",
+          "custom-copilot-rag"
+        ]
+      },
+      "node": "llmServiceNode"
+    },
+    {
+      "condition": {
+        "equals": "teams-collaborator-agent"
+      },
+      "node": "azureOpenAINode"
+    },
+    {
+      "condition": {
+        "equals": "teams-other-app-type"
+      },
+      "data": {
+        "type": "singleSelect",
+        "name": "teams-other-app-type",
+        "title": "template.teams.others.capability.title",
+        "options": [
+          {
+            "id": "non-sso-tab",
+            "label": "template.teams.others.tab.label",
+            "detail": "template.teams.others.tab.detail",
+            "data": "non-sso-tab"
+          },
+          {
+            "id": "default-message-extension",
+            "label": "template.teams.others.messageExtension.label",
+            "detail": "template.teams.others.messageExtension.detail",
+            "data": "default-message-extension"
+          },
+          {
+            "id": "default-bot",
+            "label": "template.teams.others.bot.label",
+            "detail": "template.teams.others.bot.detail",
+            "data": "default-bot"
+          }
+        ],
+        "placeholder": "template.customEngineAgent.placeholder"
+      },
+      "children": []
+    }
+  ]
+}