Simplify debugging the agent and the extension at the same time (full-stack)

[sagerb]

… of the UX and the agent

Intent

This PR updates the launch configuration for the vscode extension, to have two targets:

• Debug with internal API agent
• Debug with external API agent on 9001

The first one maintains the functionality we had before, but the second one supports the ability to launch the VSCode extension so that it expects there is an external (independently managed) API agent at port 9001.

services.ts has been updated to implement this functionality, but by default, will continue its prior behavior of managing the agent process itself. The functionality is protected by also checking that it has been launched in development mode so that we will not have this functionality leak out to customers.

I have updated the extensions/vscode/CONTRIBUTING.md file to reflect these changes.

Type of Change

• • Bug Fix
• • New Feature
• • Breaking Change
• • Documentation
• • Refactor
• • Tooling

User Impact

Functionality is not exposed to customers by limiting extension logic to require execution in development mode.

Automated Tests

Not applicable

Directions for Reviewers

1. Confirm prior debugging capability is still maintained by using the launch configuration named Debug with internal API agent
2. Confirm new debugging capability works by following the updated steps within extensions/vscode/CONTRIBUTING.md for Debug with external API agent on 9001.
3. Build the extension and install the vsix file into a normal running VSCode instance. Confirm that the extension launches and talks with the agent, by viewing activity within the Publisher Output window.

Checklist

• I have updated CHANGELOG.md to cover notable changes.

[dotNomad]

All of my review comments are nitpicks or questions. This is fantastic. Thanks for putting the work into this to make it easier to do.

[dotNomad]

Thanks for adding the notes for how to accomplish simultaneous debugging 🎉

[dotNomad]

Thanks for making those changes, and for getting this in. It will be so helpful 🎉