[WIP] Add documentation for using VSCode Speech API as a consumer

[Copilot]

Thanks for asking me to work on this. I will get started on it and keep this PR's description up to date as I form a plan and make progress.

Original prompt

I need some reference docs and example code

I need a very thorough explanation of how to use the VSCode Speech API's - NOT as a Speech provider, but as a consumer, ie. use an installed VScode Speech Extension to recognize my speech from ANOTHER Visual Studio Code Extension.

I need all the startup / initialization code, how to initiate it listening to the microphone, geting the stream of words and then turning it off.

The vscode project already has this implemented in the Chat area, there is a Microphone icon that lights up when you install the VS Code Speech Extension - marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-speech allows you to press it and dictate into the chat area.

I require details and code pointers for the flow of the API's that vscode uses.

vscode uses the NPM speech package at - npmjs.com/package/@vscode/node-speech

There is an offficial Provisional Specch API in the .proposed.tx namespace.

Please write out the architecture and docs to an md file

Then give me a plan I can give back to you at a later date when I implement this in a VS Code extension.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}