💡 [Feature]: Rework and add more SPO Site management LM Tools

[Adam-it]

🎯 Aim of the feature

Currently we have basic operation that allow to add/remove/get SPO sites https://github.com/pnp/vscode-viva/blob/194d1c1f2ebbec270b4acf8938ed0f88915eb1c0/package.json#L262-L353

The aim is to rework/refactor what we have:

• improve model description following the guidance to cover:

  • What exactly does the tool do?
  • What kind of information does it return?
  • When should and shouldn't it be used?
  • Describe important limitations or constraints of the tool.

• reword the tool name to follow the naming {verb}_{noun}. so for example instead of spo_site_add we should have add_spo_site

• [ ] lets refactor the SiteAdd lets add support for the following options: siteDesign, siteDesignId, removeDeletedSite, withAppCatalog,

• [ ] lets refactor the SiteRemove lets add support for: skipRecycleBin, fromRecycleBin

lets add new tools:

• [ ] SiteList - which should under the hood use - https://pnp.github.io/cli-microsoft365/cmd/spo/tenant/tenant-site-list
• [ ] SiteSet - which should under the hood use - https://pnp.github.io/cli-microsoft365/cmd/spo/site/site-set it should allow to update the same properties as the Add tool. We could also research what would be the best verb for this tool for LLM to discover it and use, so we may check if set is ok or maybe update will be better etc.

📷 Images (if possible) with expected result

No response

🤔 Additional remarks or comments

VS Code LM docs: https://code.visualstudio.com/api/extension-guides/tools

CLI for Microsoft 365 commands we may use (or already use under the hood):

• https://pnp.github.io/cli-microsoft365/cmd/spo/site/site-add
• https://pnp.github.io/cli-microsoft365/cmd/spo/tenant/tenant-site-list
• https://pnp.github.io/cli-microsoft365/cmd/spo/site/site-set
• https://pnp.github.io/cli-microsoft365/cmd/spo/site/site-remove

[ktskumar]

Hi @Adam-it, can I work on this

[Adam-it]

Hi @Adam-it, can I work on this

All yours! This is an awesome feature of SPFx Toolkit. Already similar LM tools are implemented so be sure to use those for reference 👍. If you will need any help or guidance do not hesitate to reach out 🙂.

Also this issue is part of hacktoberfest event so if you do participate please be sure to open the PR no sooner than in October 💪🤩