Release v1.8.1 — answer/reply/answer_file/answer_voice return bound Message

- message.answer(), reply(), answer_thread(), answer_file(), answer_voice()
  now return a bound Message instead of Any, enabling sent.delete(),
  sent.edit_text() chaining without manually tracking chat_id/msg_id
- Added /vanish example to echo_bot.py demonstrating the pattern
- PRESENTATION.md added to .gitignore

Author: TimmekHW

.gitignore

@@ -28,3 +28,4 @@ bench_report*.txt
 *.jsonl
 .claude/
 docs/*
+PRESENTATION.md

CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/),
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
+## [1.8.1] - 2026-02-20
+
+### Added
+- `message.answer()`, `reply()`, `answer_thread()`, `answer_file()`, `answer_voice()` now return a bound `Message` instead of `Any` — enables chaining `.delete()`, `.edit_text()` on the sent message directly
+- `examples/echo_bot.py`: added `/vanish` command demonstrating `sent = await message.answer(...); await sent.delete()`
+
+### Changed
+- `PRESENTATION.md` added to `.gitignore` — kept out of public repository
+
 ## [1.8.0] - 2026-02-18
 
 ### Fixed

examples/echo_bot.py

@@ -31,6 +31,13 @@ async def cmd_help(message: Message) -> None:
     )
 
 
+@router.message(Command("vanish"))
+async def cmd_vanish(message: Message) -> None:
+    sent = await message.answer("I will vanish in 5 seconds...")
+    await asyncio.sleep(5)
+    await sent.delete()
+
+
 @router.message(F.text)
 async def echo(message: Message) -> None:
     assert message.text is not None  # guaranteed by F.text filter

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "vkworkspace"
-version = "1.8.0"
+version = "1.8.1"
 description = "Fully async framework for building VK Teams (VK Workspace) bots, inspired by aiogram 3"
 readme = "README.md"
 license = { text = "MIT" }

vkworkspace/__meta__.py

@@ -1,2 +1,2 @@
-__version__ = "1.8.0"
+__version__ = "1.8.1"
 __api_version__ = "v1"

vkworkspace/types/message.py

@@ -224,11 +224,14 @@ async def answer(
         parse_mode: ParseMode | str | None = _UNSET,
         inline_keyboard_markup: Any = None,
         **kwargs: Any,
-    ) -> Any:
+    ) -> Message:
         """Send a text message to the same chat.
 
         If this message is from a thread, the reply stays in the same thread.
 
+        Returns a bound :class:`Message` — you can call ``.delete()``,
+        ``.edit_text()``, etc. on it directly.
+
         Args:
             text: Message text.
             parse_mode: ``"HTML"`` / ``"MarkdownV2"`` / ``None``.
@@ -239,6 +242,11 @@ async def answer(
 
             await message.answer("Got it!")
             await message.answer("*Bold*", parse_mode="MarkdownV2")
+
+            # Delete the sent message after a delay:
+            sent = await message.answer("I will vanish in 5 seconds")
+            await asyncio.sleep(5)
+            await sent.delete()
         """
         if parse_mode is not _UNSET:
             kwargs["parse_mode"] = parse_mode
@@ -247,22 +255,26 @@ async def answer(
         # If this message is from a thread, reply stays in the same thread
         if self.parent_topic is not None and "parent_topic" not in kwargs:
             kwargs["parent_topic"] = self.parent_topic
-        return await self.bot.send_text(
+        resp = await self.bot.send_text(
             chat_id=self.chat.chat_id,
             text=text,
             **kwargs,
         )
+        sent = Message(msg_id=resp.msg_id or "", chat=self.chat, text=text)
+        sent.set_bot(self.bot)
+        return sent
 
     async def answer_thread(
         self,
         text: str,
         parse_mode: ParseMode | str | None = _UNSET,
         inline_keyboard_markup: Any = None,
         **kwargs: Any,
-    ) -> Any:
+    ) -> Message:
         """Create a thread under this message and post *text* into it.
 
         If this message already lives in a thread, posts there instead.
+        Returns a bound :class:`Message` — supports ``.delete()``, ``.edit_text()``.
         """
         if parse_mode is not _UNSET:
             kwargs["parse_mode"] = parse_mode
@@ -276,22 +288,27 @@ async def answer_thread(
                 messageId=int(self.msg_id) if self.msg_id.isdigit() else 0,
                 type="thread",
             )
-        return await self.bot.send_text(
+        resp = await self.bot.send_text(
             chat_id=self.chat.chat_id,
             text=text,
             parent_topic=pt,
             **kwargs,
         )
+        sent = Message(msg_id=resp.msg_id or "", chat=self.chat, text=text)
+        sent.set_bot(self.bot)
+        return sent
 
     async def reply(
         self,
         text: str,
         parse_mode: ParseMode | str | None = _UNSET,
         inline_keyboard_markup: Any = None,
         **kwargs: Any,
-    ) -> Any:
+    ) -> Message:
         """Reply with a quote — shows the original message above the response.
 
+        Returns a bound :class:`Message` — supports ``.delete()``, ``.edit_text()``.
+
         Args:
             text: Reply text.
             parse_mode: ``"HTML"`` / ``"MarkdownV2"`` / ``None``.
@@ -305,12 +322,15 @@ async def reply(
             kwargs["parse_mode"] = parse_mode
         if inline_keyboard_markup is not None:
             kwargs["inline_keyboard_markup"] = inline_keyboard_markup
-        return await self.bot.send_text(
+        resp = await self.bot.send_text(
             chat_id=self.chat.chat_id,
             text=text,
             reply_msg_id=self.msg_id,
             **kwargs,
         )
+        sent = Message(msg_id=resp.msg_id or "", chat=self.chat, text=text)
+        sent.set_bot(self.bot)
+        return sent
 
     async def delete(self) -> Any:
         """Delete this message from the chat."""
@@ -424,9 +444,11 @@ async def answer_file(
         parse_mode: ParseMode | str | None = _UNSET,
         inline_keyboard_markup: Any = None,
         **kwargs: Any,
-    ) -> Any:
+    ) -> Message:
         """Send a file/image to the same chat.
 
+        Returns a bound :class:`Message` — supports ``.delete()``.
+
         Args:
             file_id: ID of a previously uploaded file (no re-upload).
             file: ``InputFile`` or open ``BinaryIO`` to upload.
@@ -440,23 +462,28 @@ async def answer_file(
             kwargs["parse_mode"] = parse_mode
         if inline_keyboard_markup is not None:
             kwargs["inline_keyboard_markup"] = inline_keyboard_markup
-        return await self.bot.send_file(
+        resp = await self.bot.send_file(
             chat_id=self.chat.chat_id,
             file_id=file_id,
             file=file,
             caption=caption,
             **kwargs,
         )
+        sent = Message(msg_id=resp.msg_id or "", chat=self.chat, text=caption)
+        sent.set_bot(self.bot)
+        return sent
 
     async def answer_voice(
         self,
         file_id: str | None = None,
         file: Any = None,
         inline_keyboard_markup: Any = None,
         **kwargs: Any,
-    ) -> Any:
+    ) -> Message:
         """Send a voice message to the same chat.
 
+        Returns a bound :class:`Message` — supports ``.delete()``.
+
         Recommended format: OGG/Opus. Convert with
         ``vkworkspace.utils.voice.convert_to_ogg_opus()`` if needed.
 
@@ -471,9 +498,12 @@ async def answer_voice(
         """
         if inline_keyboard_markup is not None:
             kwargs["inline_keyboard_markup"] = inline_keyboard_markup
-        return await self.bot.send_voice(
+        resp = await self.bot.send_voice(
             chat_id=self.chat.chat_id,
             file_id=file_id,
             file=file,
             **kwargs,
         )
+        sent = Message(msg_id=resp.msg_id or "", chat=self.chat)
+        sent.set_bot(self.bot)
+        return sent