From 8e8ee064d3f9d42d441d5503d0decd04789dbb5e Mon Sep 17 00:00:00 2001
From: Yaroslav Yashin <yaroslav.yashin@gmail.com>
Date: Sat, 5 Oct 2024 21:24:36 +0200
Subject: [PATCH] Release notes provided

---
 messages.json     |  3 ++-
 messages/4.2.0.md | 36 ++++++++++++++++++++++++++++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)
 create mode 100644 messages/4.2.0.md

diff --git a/messages.json b/messages.json
index 9433eff..ea03e09 100644
--- a/messages.json
+++ b/messages.json
@@ -23,5 +23,6 @@
     "4.0.0": "messages/4.0.0.md",
     "4.0.1": "messages/4.0.1.md",
     "4.1.0": "messages/4.1.0.md",
-    "4.1.1": "messages/4.1.1.md"
+    "4.1.1": "messages/4.1.1.md",
+    "4.2.0": "messages/4.2.0.md"
 }
diff --git a/messages/4.2.0.md b/messages/4.2.0.md
new file mode 100644
index 0000000..19c2af5
--- /dev/null
+++ b/messages/4.2.0.md
@@ -0,0 +1,36 @@
+## Featues
+
+- New in buffer mode `phantom`
+- `stream` toggle for responses brought back
+- images handling UX improved
+- advertisement logic improved
+
+## Deprecated
+- `append`, `replace`, `insert` in prompt modes is deprecated and will be removed in 5.0 release.
+
+## Detaied description
+
+### Phantom mode
+
+Phantom is the overlay UI placed inline in the editor view (see the picture below). It doesn't affects content of the view. 
+
+1. You can set `"prompt_mode": "phantom"` for AI assistant in its settings.
+2. [optional] Select some text to pass in context in to manipulate with.
+3. Hit `OpenAI: New Message` or `OpenAI: Chat Model Select` and ask whatever you'd like in popup input pane.
+4. Phantom will appear below the cursor position or the beginning of the selection while the streaming LLM answer occurs.
+5. You can apply actions to the llm prompt, they're quite self descriptive and follows behavior deprecated in buffer commands.
+6. You can hit `ctrl+c` to stop prompting same as with in `panel` mode.
+
+### Stream toggle
+
+You can toggle streaming behavior of a model response with `"stream": false` setting in per assistant basis. That's pretty much it, the default value is `true`.
+
+### Images handling UX improved
+
+Images paths can now be fetched from the clipboard in addition to be extracted from the selection in a given view. It could be either a single image path [and nothing more than that] or a list of such paths separated with a new line, e.g. `/Users/username/Documents/Project/image0.png\n/Users/username/Documents/Project/image1.png`.
+
+Please note the parser that is trying to deduct whether the content of your clipboard is an [list of] image[s] is made by AI and quite fragile, so don't expect too much from it.
+
+### Advertisement logic improvement
+
+Advertisements now appear only when users excessively utilize the plugin, such as by processing too many tokens or sending/receiving an excessive number of messages.