Refactors spo_list_remove LM tool. Closes #592

[Copilot]

🎯 Aim

Aligns the spo_list_remove Language Model Tool with established naming conventions ({verb}_{noun}) and adds support for recycling lists instead of permanent deletion.

📷 Result

No visual changes - this is a backend tool enhancement for the Language Model Tools.

✅ What was done

• Renamed tool: spo_list_remove → remove_spo_list

  • Updated registration in ChatTools.ts
  • Updated metadata in package.json

• Added recycle parameter: Optional boolean (default: false) to send lists to recycle bin

  interface ISharePointListRemoveParameters {
      title: string;
      webUrl: string;
      recycle?: boolean;  // New parameter with default: false
  }

  • Always included in CLI command with nullish coalescing operator for default value
  • Response message reflects action taken (recycled vs. permanently removed)

• Enhanced model description: Concise documentation covering:

  • Core functionality (permanent removal vs. recycling based on parameter)
  • Use cases (cleanup unused lists, remove test data, manage site content)

• Applied review feedback:

  • Simplified modelDescription to be more concise
  • Updated recycle parameter description for clarity
  • Set default value for recycle to false instead of empty string
  • Refactored code to always include recycle parameter in command inputs

🔗 Related issue

Follows patterns from PR #596 / issue #586.

Fixes #592

Original prompt

---

This section details on the original issue you should resolve

<issue_title>💡 [Feature]: Update spo_list_remove Language Model Tool to Follow standards</issue_title>
<issue_description>### 🎯 Aim of the feature

Refactor the existing spo_list_remove Language Model Tool to align with updated naming conventions, improve model descriptions, and add additional list removal options for enhanced SharePoint list management capabilities.

Issues to address:

• Rename the tool to remove_spo_list following the naming convention {verb}_{noun} as established in the codebase
• Improve modelDescription:
  • What exactly does the tool do? - describe the specific functionality and capabilities
  • What kind of information does it return? - detail the expected response format
  • When should and shouldn't it be used? - provide clear use cases and scenarios to avoid
  • Describe important limitations or constraints of the tool - identify technical and permission limitations
• Refactor ListRemove
  • Missing Properties: lets add support for the following options: recycle

Under the hood use: spo list remove

The issue #586 has been implemented and can be used as a reference to ensure consistency with the correct standards.

🤖 Agent info

• create your feature branch with the implementation based on dev branch. This is a must
• when opening a PR you MUST target dev branch
• similar change was done in this commit 796856b. you must use it as refrence

🤔 Additional remarks or comments

• VS Code LM docs: https://code.visualstudio.com/api/extension-guides/tools
• CLI for Microsoft 365 Reference: https://pnp.github.io/cli-microsoft365/cmd/spo/list/list-remove</issue_description>

<agent_instructions>don't forget your feature branch MUST be created based on dev branch and NOT main.
</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes 💡 [Feature]: Update spo_list_remove Language Model Tool to Follow standards #592

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[Adam-it]

@copilot Can you apply the changes I pointed out

[Copilot]

@copilot Can you apply the changes I pointed out

All changes have been applied in commit ccb39b3.

[Adam-it]

checked locally and works properly

[Adam-it]

before proceeding with the merge I need to first update our version of CLI for M365
https://github.com/Adam-it/cli-microsoft365/blob/cli-cjs/src/m365/spo/commands/list/list-remove.ts

as currently it does not support recycle
https://github.com/Adam-it/cli-microsoft365/blob/ec6f17a5e9076596c3550d6bb98cd5a3650ab955/src/m365/spo/commands/list/list-remove.ts#L49-L64