fix: improve prompt (#13832)

Author: chagong

packages/mcp-server/.vscode/tasks.json

@@ -4,7 +4,7 @@
     {
       "type": "npm",
       "script": "watch",
-      "problemMatcher": ["$tsc-watch"],
+      "problemMatcher": ["$ts-webpack-watch"],
       "isBackground": true,
       "label": "npm: watch",
       "group": {

packages/mcp-server/src/fetcher.ts

@@ -17,6 +17,7 @@ export type SchemaType = z.infer<typeof SchemaTypeEnum>;
  */
 interface SchemaRepository {
   baseUrl: string;
+  latestVersion: string;
 }
 
 /**
@@ -25,12 +26,15 @@ interface SchemaRepository {
 const schemaRepositories: Record<SchemaType, SchemaRepository> = {
   app_manifest: {
     baseUrl: `https://developer.microsoft.com/json-schemas/teams/{{version}}/MicrosoftTeams.schema.json`,
+    latestVersion: "v1.21",
   },
   declarative_agent_manifest: {
     baseUrl: `https://developer.microsoft.com/json-schemas/copilot/declarative-agent/{{version}}/schema.json`,
+    latestVersion: "v1.3",
   },
   api_plugin_manifest: {
     baseUrl: `https://developer.microsoft.com/json-schemas/copilot/plugin/{{version}}/schema.json`,
+    latestVersion: "v2.2",
   },
 };
 
@@ -69,6 +73,10 @@ export async function fetchSchema(schemaName: SchemaType, schemaVersion: string)
   }
 
   try {
+    if (schemaVersion === "latest") {
+      schemaVersion = repository.latestVersion;
+    }
+
     const url = repository.baseUrl.replace("{{version}}", schemaVersion);
     const response = await fetch(url);
 

packages/mcp-server/src/server.ts

@@ -15,7 +15,11 @@ export function createServer(): McpServer {
     'Get the schema for "App manifest", "Declarative agent manifest", "API plugin manifest", use it everytime before understanding, modifying or creating any of these manifest files.',
     {
       schema_name: SchemaTypeEnum.describe("name of schema"),
-      schema_version: z.string().describe("version of schema"),
+      schema_version: z
+        .string()
+        .describe(
+          'version of schema in semantic versioning format vX.Y, where X is the major version and Y is the minor version (e.g. v1.0, v1.19, v2.1). Use "latest" if unsure.'
+        ),
     },
     async ({ schema_name, schema_version }) => {
       const schema = await fetchSchema(schema_name, schema_version);

packages/mcp-server/tests/fetcher.test.ts

@@ -55,6 +55,30 @@ describe("fetcher", () => {
       );
     });
 
+    it("should handle 'latest' version by using the repository's latest version", async () => {
+      // Test app_manifest with 'latest' version
+      await fetchSchema("app_manifest", "latest");
+      expect(global.fetch).toHaveBeenCalledWith(
+        "https://developer.microsoft.com/json-schemas/teams/v1.21/MicrosoftTeams.schema.json"
+      );
+
+      jest.clearAllMocks();
+
+      // Test declarative_agent_manifest with 'latest' version
+      await fetchSchema("declarative_agent_manifest", "latest");
+      expect(global.fetch).toHaveBeenCalledWith(
+        "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.3/schema.json"
+      );
+
+      jest.clearAllMocks();
+
+      // Test api_plugin_manifest with 'latest' version
+      await fetchSchema("api_plugin_manifest", "latest");
+      expect(global.fetch).toHaveBeenCalledWith(
+        "https://developer.microsoft.com/json-schemas/copilot/plugin/v2.2/schema.json"
+      );
+    });
+
     it("should cache results for repeated requests", async () => {
       // First call should make a fetch request
       await fetchSchema("app_manifest", "v1.16");