yuchatlib 0.2.2__tar.gz

yuchatlib-0.2.2/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: yuchatlib
+Version: 0.2.2
+Summary: Асинхронная библиотека для ботов YuChat
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: pydantic<3,>=2
+Provides-Extra: test
+Requires-Dist: pytest<10,>=8; extra == "test"
+Requires-Dist: pytest-asyncio<2,>=0.23; extra == "test"
+Requires-Dist: python-dotenv<2,>=1; extra == "test"
+Requires-Dist: aiosqlite<1,>=0.20; extra == "test"
+Provides-Extra: stand
+Requires-Dist: python-dotenv<2,>=1; extra == "stand"
+Provides-Extra: env
+Requires-Dist: python-dotenv<2,>=1; extra == "env"
+Provides-Extra: dev
+Requires-Dist: ruff<1,>=0.11; extra == "dev"
+Provides-Extra: sqlite
+Requires-Dist: aiosqlite<1,>=0.20; extra == "sqlite"
+Provides-Extra: webhook
+Requires-Dist: aiohttp<4,>=3.10; extra == "webhook"
+
+# yuchatlib
+
+Асинхронная Python-библиотека для создания ботов YuChat. Она предоставляет обработчики команд и сообщений, роутеры, фильтры, middleware и управление состояниями диалога.
+
+Библиотека поддерживает **Python 3.11 и новее**, работу с YuChat Cloud и On-Premises.
+
+## Возможности
+
+- Получение событий в режимах **polling** и **webhook**.
+- Последовательная обработка событий через `Dispatcher`.
+- Вложенные роутеры и асинхронные обработчики.
+- Команды с префиксом `/`, фильтры и middleware.
+- Командные кнопки и обработка нажатий.
+- FSM для хранения состояния и данных диалога.
+- Хранение FSM и курсора polling в памяти или SQLite.
+- Отправка, чтение и редактирование сообщений.
+
+## Настройки
+
+Параметры можно указать в файле `.env` или в переменных окружения. Значения переменных окружения имеют приоритет над значениями из файла.
+
+| Переменная | Назначение | Значение по умолчанию |
+|---|---|---|
+| `YUCHAT_TOKEN` | Токен бота. | Не задан |
+| `YUCHAT_BASE_URL` | Базовый адрес API YuChat Cloud или вашего On-Premises-стенда. | Не задан |
+| `YUCHAT_WEBHOOK_SECRET` | Секрет для проверки входящих webhook-запросов. | Не задан |
+| `YUCHAT_WORKSPACE_ID` | Идентификатор рабочего пространства для сценариев, которым он необходим. | Не задан |
+| `YUCHAT_CHAT_ID` | Идентификатор чата для сценариев, которым он необходим. | Не задан |
+| `YUCHAT_FSM_NAMESPACE` | Постоянная идентичность бота для SQLite FSM и курсора. | Не задан |
+| `YUCHAT_FSM_SQLITE_PATH` | Путь к файлу SQLite для FSM и курсора. | Не задан |
+| `YUCHAT_HTTP_TIMEOUT` | Таймаут HTTP-запросов в секундах. | `30.0` |
+| `YUCHAT_POLLING_INTERVAL` | Задержка между запросами polling в секундах. | `1.0` |
+| `YUCHAT_POLLING_LIMIT` | Максимальное число событий в одном запросе. | `20` |
+| `YUCHAT_POLLING_MAX_RETRIES` | Максимальное число повторных попыток при временных ошибках. | `5` |
+
+## Быстрый старт: polling и команда
+
+```python
+import asyncio
+
+from yuchatlib import Bot, Dispatcher, Router
+from yuchatlib.api import MessageDto
+from yuchatlib.config import Settings
+
+router = Router()
+
+
+@router.command("start")
+async def start(message: MessageDto, bot: Bot) -> None:
+    await bot.send_message(
+        workspace_id=message.workspace_id,
+        chat_id=message.chat_id,
+        text="Привет! Я бот YuChat.",
+    )
+
+
+async def main() -> None:
+    settings = Settings.from_env()
+
+    dispatcher = Dispatcher()
+    dispatcher.include_router(router)
+
+    async with Bot(
+        settings.require_token(),
+        base_url=settings.require_base_url(),
+        timeout=settings.http_timeout,
+    ) as bot:
+        await dispatcher.start_polling(
+            bot,
+            interval=settings.polling_interval,
+            limit=settings.polling_limit,
+            max_retries=settings.polling_max_retries,
+        )
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+После запуска отправьте боту команду `/start`. В декораторе имя команды указывается **без** символа `/`.
+
+## Состояния диалога
+
+FSM позволяет сохранять состояние и данные отдельно для каждого участника чата. Обработчики ниже можно добавить в пример с polling.
+
+```python
+from yuchatlib.api import MessageDto
+from yuchatlib.fsm import FSMContext, State, StatesGroup
+
+
+class Form(StatesGroup):
+    waiting_for_name = State()
+
+
+@router.command("name")
+async def ask_name(message: MessageDto, state: FSMContext, bot: Bot) -> None:
+    await state.set_state(Form.waiting_for_name)
+    await bot.send_message(
+        workspace_id=message.workspace_id,
+        chat_id=message.chat_id,
+        text="Как вас зовут?",
+    )
+
+
+@router.message(Form.waiting_for_name)
+async def save_name(message: MessageDto, state: FSMContext, bot: Bot) -> None:
+    await state.update_data(name=message.content.text)
+    await bot.send_message(
+        workspace_id=message.workspace_id,
+        chat_id=message.chat_id,
+        text="Имя сохранено.",
+    )
+    await state.clear()
+```
+
+По умолчанию FSM хранится в памяти процесса и очищается при его завершении. `clear()` удаляет состояние и данные текущего контекста.
+
+## Командные кнопки
+
+Бот может отправить сообщение с кнопкой и обработать её нажатие.
+
+```python
+from yuchatlib.api import (
+    ButtonBarDto,
+    ButtonDto,
+    ButtonGroupDto,
+    CommandButtonDto,
+    MessageActionDto,
+    MessageDto,
+)
+
+
+@router.command("buttons")
+async def show_buttons(message: MessageDto, bot: Bot) -> None:
+    button_bar = ButtonBarDto(
+        button_groups=[
+            ButtonGroupDto(
+                buttons=[
+                    ButtonDto(
+                        command_button=CommandButtonDto(
+                            display_text="Подтвердить",
+                            command_key="/confirm",
+                        )
+                    )
+                ]
+            )
+        ]
+    )
+    await bot.send_message(
+        workspace_id=message.workspace_id,
+        chat_id=message.chat_id,
+        text="Выберите действие:",
+        button_bar=button_bar,
+    )
+
+
+@router.callback_query(command_key="/confirm")
+async def confirm(action: MessageActionDto, bot: Bot) -> None:
+    await bot.send_message(
+        workspace_id=action.workspace_id,
+        chat_id=action.chat_id,
+        text="Действие подтверждено.",
+    )
+```
+
+Для получения нажатий у бота должен быть включён тип обновлений `MESSAGE_ACTION`. Идентификатор нажавшего пользователя в модели действия кнопки не предусмотрен, поэтому персональный FSM-контекст для такого действия автоматически не создаётся.

yuchatlib-0.2.2/README.md

@@ -0,0 +1,166 @@
+# yuchatlib
+
+Асинхронная Python-библиотека для создания ботов YuChat. Она предоставляет обработчики команд и сообщений, роутеры, фильтры, middleware и управление состояниями диалога.
+
+Библиотека поддерживает **Python 3.11 и новее**, работу с YuChat Cloud и On-Premises.
+
+## Возможности
+
+- Получение событий в режимах **polling** и **webhook**.
+- Последовательная обработка событий через `Dispatcher`.
+- Вложенные роутеры и асинхронные обработчики.
+- Команды с префиксом `/`, фильтры и middleware.
+- Командные кнопки и обработка нажатий.
+- FSM для хранения состояния и данных диалога.
+- Хранение FSM и курсора polling в памяти или SQLite.
+- Отправка, чтение и редактирование сообщений.
+
+## Настройки
+
+Параметры можно указать в файле `.env` или в переменных окружения. Значения переменных окружения имеют приоритет над значениями из файла.
+
+| Переменная | Назначение | Значение по умолчанию |
+|---|---|---|
+| `YUCHAT_TOKEN` | Токен бота. | Не задан |
+| `YUCHAT_BASE_URL` | Базовый адрес API YuChat Cloud или вашего On-Premises-стенда. | Не задан |
+| `YUCHAT_WEBHOOK_SECRET` | Секрет для проверки входящих webhook-запросов. | Не задан |
+| `YUCHAT_WORKSPACE_ID` | Идентификатор рабочего пространства для сценариев, которым он необходим. | Не задан |
+| `YUCHAT_CHAT_ID` | Идентификатор чата для сценариев, которым он необходим. | Не задан |
+| `YUCHAT_FSM_NAMESPACE` | Постоянная идентичность бота для SQLite FSM и курсора. | Не задан |
+| `YUCHAT_FSM_SQLITE_PATH` | Путь к файлу SQLite для FSM и курсора. | Не задан |
+| `YUCHAT_HTTP_TIMEOUT` | Таймаут HTTP-запросов в секундах. | `30.0` |
+| `YUCHAT_POLLING_INTERVAL` | Задержка между запросами polling в секундах. | `1.0` |
+| `YUCHAT_POLLING_LIMIT` | Максимальное число событий в одном запросе. | `20` |
+| `YUCHAT_POLLING_MAX_RETRIES` | Максимальное число повторных попыток при временных ошибках. | `5` |
+
+## Быстрый старт: polling и команда
+
+```python
+import asyncio
+
+from yuchatlib import Bot, Dispatcher, Router
+from yuchatlib.api import MessageDto
+from yuchatlib.config import Settings
+
+router = Router()
+
+
+@router.command("start")
+async def start(message: MessageDto, bot: Bot) -> None:
+    await bot.send_message(
+        workspace_id=message.workspace_id,
+        chat_id=message.chat_id,
+        text="Привет! Я бот YuChat.",
+    )
+
+
+async def main() -> None:
+    settings = Settings.from_env()
+
+    dispatcher = Dispatcher()
+    dispatcher.include_router(router)
+
+    async with Bot(
+        settings.require_token(),
+        base_url=settings.require_base_url(),
+        timeout=settings.http_timeout,
+    ) as bot:
+        await dispatcher.start_polling(
+            bot,
+            interval=settings.polling_interval,
+            limit=settings.polling_limit,
+            max_retries=settings.polling_max_retries,
+        )
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+После запуска отправьте боту команду `/start`. В декораторе имя команды указывается **без** символа `/`.
+
+## Состояния диалога
+
+FSM позволяет сохранять состояние и данные отдельно для каждого участника чата. Обработчики ниже можно добавить в пример с polling.
+
+```python
+from yuchatlib.api import MessageDto
+from yuchatlib.fsm import FSMContext, State, StatesGroup
+
+
+class Form(StatesGroup):
+    waiting_for_name = State()
+
+
+@router.command("name")
+async def ask_name(message: MessageDto, state: FSMContext, bot: Bot) -> None:
+    await state.set_state(Form.waiting_for_name)
+    await bot.send_message(
+        workspace_id=message.workspace_id,
+        chat_id=message.chat_id,
+        text="Как вас зовут?",
+    )
+
+
+@router.message(Form.waiting_for_name)
+async def save_name(message: MessageDto, state: FSMContext, bot: Bot) -> None:
+    await state.update_data(name=message.content.text)
+    await bot.send_message(
+        workspace_id=message.workspace_id,
+        chat_id=message.chat_id,
+        text="Имя сохранено.",
+    )
+    await state.clear()
+```
+
+По умолчанию FSM хранится в памяти процесса и очищается при его завершении. `clear()` удаляет состояние и данные текущего контекста.
+
+## Командные кнопки
+
+Бот может отправить сообщение с кнопкой и обработать её нажатие.
+
+```python
+from yuchatlib.api import (
+    ButtonBarDto,
+    ButtonDto,
+    ButtonGroupDto,
+    CommandButtonDto,
+    MessageActionDto,
+    MessageDto,
+)
+
+
+@router.command("buttons")
+async def show_buttons(message: MessageDto, bot: Bot) -> None:
+    button_bar = ButtonBarDto(
+        button_groups=[
+            ButtonGroupDto(
+                buttons=[
+                    ButtonDto(
+                        command_button=CommandButtonDto(
+                            display_text="Подтвердить",
+                            command_key="/confirm",
+                        )
+                    )
+                ]
+            )
+        ]
+    )
+    await bot.send_message(
+        workspace_id=message.workspace_id,
+        chat_id=message.chat_id,
+        text="Выберите действие:",
+        button_bar=button_bar,
+    )
+
+
+@router.callback_query(command_key="/confirm")
+async def confirm(action: MessageActionDto, bot: Bot) -> None:
+    await bot.send_message(
+        workspace_id=action.workspace_id,
+        chat_id=action.chat_id,
+        text="Действие подтверждено.",
+    )
+```
+
+Для получения нажатий у бота должен быть включён тип обновлений `MESSAGE_ACTION`. Идентификатор нажавшего пользователя в модели действия кнопки не предусмотрен, поэтому персональный FSM-контекст для такого действия автоматически не создаётся.

yuchatlib-0.2.2/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "yuchatlib"
+version = "0.2.2"
+description = "Асинхронная библиотека для ботов YuChat"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = ["httpx>=0.27,<1", "pydantic>=2,<3"]
+
+[project.optional-dependencies]
+test = ["pytest>=8,<10", "pytest-asyncio>=0.23,<2", "python-dotenv>=1,<2", "aiosqlite>=0.20,<1"]
+stand = ["python-dotenv>=1,<2"]
+env = ["python-dotenv>=1,<2"]
+dev = ["ruff>=0.11,<1"]
+sqlite = ["aiosqlite>=0.20,<1"]
+webhook = ["aiohttp>=3.10,<4"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]

yuchatlib-0.2.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

yuchatlib-0.2.2/src/yuchatlib/__init__.py

@@ -0,0 +1,7 @@
+"""Асинхронная библиотека для ботов YuChat."""
+
+from .bot import Bot
+from .dispatcher import Dispatcher
+from .router import Router
+
+__all__ = ["Bot", "Dispatcher", "Router"]

yuchatlib-0.2.2/src/yuchatlib/api/__init__.py

@@ -0,0 +1,23 @@
+"""Интеграция с публичным API YuChat."""
+
+from .dto.message.button import ButtonDto
+from .dto.message.button_bar import ButtonBarDto
+from .dto.message.button_group import ButtonGroupDto
+from .dto.message.command_button import CommandButtonDto
+from .dto.message.get_messages_response import GetMessagesResponseDto
+from .dto.update.message import MessageDto
+from .dto.update.message_action import MessageActionDto
+from .dto.update.update import UpdateDto
+from .dto.webhook_info import WebhookInfoDto
+
+__all__ = [
+    "ButtonDto",
+    "ButtonBarDto",
+    "ButtonGroupDto",
+    "CommandButtonDto",
+    "GetMessagesResponseDto",
+    "MessageDto",
+    "MessageActionDto",
+    "UpdateDto",
+    "WebhookInfoDto",
+]

yuchatlib-0.2.2/src/yuchatlib/api/_transport.py

@@ -0,0 +1,59 @@
+"""Внутренний HTTP-транспорт публичного API YuChat."""
+
+from typing import Any
+
+import httpx
+
+from yuchatlib.exceptions import ApiError, AuthenticationError, InvalidResponseError, NetworkError, RateLimitError
+
+
+class _YuChatHttpTransport:
+    """Отправляет запросы и преобразует ответы без раскрытия данных."""
+
+    def __init__(self, client: httpx.AsyncClient, base_url: str, token: str) -> None:
+        self._client = client
+        self._base_url = base_url
+        self._token = token
+
+    async def post(self, method: str, body: dict[str, Any] | None = None) -> Any:
+        try:
+            response = await self._client.post(
+                f"{self._base_url}/public/v2/{method}",
+                headers={"Authorization": f"Bearer {self._token}"},
+                json=body,
+            )
+        except httpx.RequestError:
+            pass
+        else:
+            return self.parse_response(response)
+        raise NetworkError("Ошибка соединения с YuChat")
+
+    async def request(self, http_method: str, method: str) -> httpx.Response:
+        try:
+            response = await self._client.request(
+                http_method,
+                f"{self._base_url}/public/v2/{method}",
+                headers={"Authorization": f"Bearer {self._token}"},
+            )
+        except httpx.RequestError:
+            pass
+        else:
+            return response
+        raise NetworkError("Ошибка соединения с YuChat")
+
+    @staticmethod
+    def parse_response(response: httpx.Response) -> Any:
+        """Возвращает JSON или преобразует ошибки API в исключения SDK."""
+        if response.status_code in (401, 403):
+            raise AuthenticationError(response.status_code)
+        if response.status_code == 429:
+            raise RateLimitError(429, response.headers.get("Retry-After"))
+        if not response.is_success:
+            raise ApiError(response.status_code)
+        if not response.content:
+            return None
+        try:
+            return response.json()
+        except ValueError:
+            pass
+        raise InvalidResponseError("Ответ YuChat не содержит корректный JSON")

yuchatlib-0.2.2/src/yuchatlib/api/dto/__init__.py

@@ -0,0 +1 @@
+"""Контракты публичного API YuChat."""

yuchatlib-0.2.2/src/yuchatlib/api/dto/me/__init__.py

@@ -0,0 +1 @@
+"""Модели сведений о боте."""

yuchatlib-0.2.2/src/yuchatlib/api/dto/me/me_info.py

@@ -0,0 +1,19 @@
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .profile import ProfileDto
+
+
+class MeInfoDto(BaseModel):
+    """Сведения о боте и настройках обновлений."""
+
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+    profile: ProfileDto = Field(description="Профиль бота.")
+    workspaces: list[str] = Field(description="Рабочие пространства бота.")
+    update_api_version: int = Field(alias="updateApiVersion", description="Версия API обновлений.")
+    update_settings: list[str] = Field(alias="updateSettings", description="Включённые типы обновлений.")
+    auto_accept_workspace_invites: bool = Field(
+        alias="autoAcceptWorkspaceInvites", description="Автоматическое принятие приглашений."
+    )
+    scope: dict[str, Any] = Field(description="Область действия бота.")

yuchatlib-0.2.2/src/yuchatlib/api/dto/me/profile.py

@@ -0,0 +1,13 @@
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class ProfileDto(BaseModel):
+    """Профиль аккаунта бота."""
+
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+    account_id: str = Field(alias="accountId", description="Идентификатор аккаунта.")
+    created_at: datetime = Field(alias="createdAt", description="Время создания аккаунта.")
+    updated_at: datetime = Field(alias="updatedAt", description="Время изменения аккаунта.")
+    account_type: str = Field(alias="accountType", description="Тип аккаунта.")

yuchatlib-0.2.2/src/yuchatlib/api/dto/message/__init__.py

@@ -0,0 +1 @@
+"""Модели операций с сообщениями."""

yuchatlib-0.2.2/src/yuchatlib/api/dto/message/button.py

@@ -0,0 +1,13 @@
+"""Контракт кнопки сообщения."""
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .command_button import CommandButtonDto
+
+
+class ButtonDto(BaseModel):
+    """Командная кнопка сообщения."""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    command_button: CommandButtonDto = Field(alias="commandButton", description="Командная кнопка.")

yuchatlib-0.2.2/src/yuchatlib/api/dto/message/button_bar.py

@@ -0,0 +1,13 @@
+"""Контракт панели кнопок."""
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .button_group import ButtonGroupDto
+
+
+class ButtonBarDto(BaseModel):
+    """Панель кнопок сообщения."""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    button_groups: list[ButtonGroupDto] = Field(alias="buttonGroups", description="Ряды кнопок.")

yuchatlib-0.2.2/src/yuchatlib/api/dto/message/button_group.py

@@ -0,0 +1,11 @@
+"""Контракт группы кнопок."""
+
+from pydantic import BaseModel, Field
+
+from .button import ButtonDto
+
+
+class ButtonGroupDto(BaseModel):
+    """Ряд кнопок сообщения."""
+
+    buttons: list[ButtonDto] = Field(description="Кнопки в ряду.")

yuchatlib-0.2.2/src/yuchatlib/api/dto/message/command_button.py

@@ -0,0 +1,12 @@
+"""Контракт командной кнопки."""
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CommandButtonDto(BaseModel):
+    """Команда и отображаемый текст кнопки."""
+
+    model_config = ConfigDict(populate_by_name=True)
+
+    display_text: str = Field(alias="displayText", description="Текст кнопки.")
+    command_key: str = Field(alias="commandKey", description="Команда нажатой кнопки.")

yuchatlib-0.2.2/src/yuchatlib/api/dto/message/get_messages_response.py

@@ -0,0 +1,11 @@
+from pydantic import BaseModel, ConfigDict, Field
+
+from yuchatlib.api.dto.update.message import MessageDto
+
+
+class GetMessagesResponseDto(BaseModel):
+    """Список сообщений, полученных из чата."""
+
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+
+    messages: list[MessageDto] = Field(description="Сообщения чата.")

yuchatlib-0.2.2/src/yuchatlib/api/dto/message/send_message_response.py

@@ -0,0 +1,8 @@
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SendMessageResponseDto(BaseModel):
+    """Результат отправки сообщения."""
+
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+    message_id: str = Field(alias="messageId", description="Идентификатор отправленного сообщения.")

yuchatlib-0.2.2/src/yuchatlib/api/dto/update/__init__.py

@@ -0,0 +1 @@
+"""Модели получаемых обновлений."""

yuchatlib-0.2.2/src/yuchatlib/api/dto/update/message.py

@@ -0,0 +1,20 @@
+from datetime import datetime
+from typing import Literal
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .message_content import MessageContentDto
+
+
+class MessageDto(BaseModel):
+    """Сообщение в чате YuChat."""
+
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+    workspace_id: str = Field(alias="workspaceId", description="Идентификатор рабочего пространства.")
+    chat_id: str = Field(alias="chatId", description="Идентификатор чата.")
+    message_id: str = Field(alias="messageId", description="Идентификатор сообщения.")
+    message_type: Literal["USER", "SYSTEM"] = Field(alias="messageType", description="Тип сообщения.")
+    membership_id: str = Field(alias="membershipId", description="Идентификатор автора в рабочем пространстве.")
+    created_at: datetime = Field(alias="createdAt", description="Время создания сообщения.")
+    updated_at: datetime = Field(alias="updatedAt", description="Время изменения сообщения.")
+    content: MessageContentDto = Field(description="Содержимое сообщения.")

yuchatlib-0.2.2/src/yuchatlib/api/dto/update/message_action.py

@@ -0,0 +1,15 @@
+from pydantic import BaseModel, ConfigDict, Field
+
+from .pressed_button_command import PressedButtonCommandDto
+
+
+class MessageActionDto(BaseModel):
+    """Действие с кнопкой сообщения."""
+
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+    workspace_id: str = Field(alias="workspaceId", description="Идентификатор рабочего пространства.")
+    chat_id: str = Field(alias="chatId", description="Идентификатор чата.")
+    message_id: str = Field(alias="messageId", description="Идентификатор сообщения.")
+    pressed_button_command: PressedButtonCommandDto | None = Field(
+        default=None, alias="pressedButtonCommand", description="Команда нажатой кнопки, если передана."
+    )

yuchatlib-0.2.2/src/yuchatlib/api/dto/update/message_content.py

@@ -0,0 +1,11 @@
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class MessageContentDto(BaseModel):
+    """Содержимое сообщения YuChat."""
+
+    model_config = ConfigDict(extra="allow", populate_by_name=True)
+    text: str | None = Field(default=None, description="Текст сообщения в формате Markdown.")
+    file_ids: list[str] | None = Field(
+        default=None, alias="fileIds", description="Идентификаторы прикреплённых файлов."
+    )