Merge branch 'main' into ihrpr/resource-link

src/types.ts

@@ -203,7 +203,14 @@ export const BaseMetadataSchema = z
   .object({
     /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
     name: z.string(),
-    /** Intended for UI and end-user contexts — optimized to be human-readable */
+    /**
+    * Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
+    * even by those unfamiliar with domain-specific terminology.
+    *
+    * If not provided, the name should be used for display (except for Tool,
+    * where `annotations.title` should be given precedence over using `name`,
+    * if present).
+    */
     title: z.optional(z.string()),
   })
   .passthrough();