funora 0.0.1.dev2__py3-none-any.whl

funora/budget.py

@@ -0,0 +1,311 @@
+r"""Числа бюджета запросов.
+
+Файл порождён из спецификации, править его руками нельзя: правка исчезнет при
+следующей сборке. Источник - spec/runtime/budget.yaml в репозитории Funora-spec.
+Перестроить: .venv\Scripts\python.exe tools/codegen.py
+
+Числа помечены в спецификации провизорными: измерять настоящие пороги
+площадки означало бы намеренно их превышать. Поэтому они подобраны
+консервативно и будут уточняться наблюдением, а не подбором.
+
+Сетевые вёдра расходуют запросы, включая повторы и переходы по
+редиректам. Считать только логические операции нельзя: тогда шторм
+повторов оказывается бесплатным ровно в тот момент, когда площадке
+хуже всего.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import StrEnum
+from typing import Final
+
+__all__ = [
+    "BucketLimits",
+    "BUCKETS",
+    "MAX_WAIT_MS",
+    "WAIT_ATTEMPTS",
+    "WAIT_GUARD_MS",
+    "BURST_WINDOW_MS",
+    "RequestClass",
+    "ON_REFUSAL",
+    "FLOOR_SHARE",
+    "DEMAND_WINDOW_MS",
+    "COUNTS_RETRIES",
+    "COUNTS_REDIRECTS",
+    "MIN_HEALTH_INTERVAL_MS",
+    "OUTBOUND_MESSAGES_PER_HOUR",
+    "OUTBOUND_UNIQUE_RECIPIENTS_PER_HOUR",
+    "OUTBOUND_MIN_INTERVAL_PER_CHAT_MS",
+    "OUTBOUND_WINDOW_MS",
+    "OUTBOUND_WARMING_EVENTS",
+    "COLD_OUTREACH_QUOTA_PER_HOUR",
+    "COLD_OUTREACH_WINDOW_MS",
+    "MAX_QUEUE_DEPTH_PER_KEY",
+    "MAX_CONCURRENT_HANDLERS",
+    "HANDLER_TIMEOUT_MS",
+    "MAX_CONNECTIONS_PER_HOST",
+    "MAX_RESPONSE_BYTES",
+    "MAX_DECOMPRESSED_BYTES",
+    "MAX_REDIRECTS",
+    "RateLimitResponse",
+    "RATE_LIMIT_RESPONSE",
+    "Scheduling",
+    "SCHEDULING",
+    "PROVISIONAL",
+    "MARKET_INTERVAL_MS",
+    "MARKET_ABSENCES",
+    "MARKET_HISTORY_LIMIT",
+]
+
+
+@dataclass(frozen=True, slots=True)
+class BucketLimits:
+    """Ёмкость и скорость пополнения одного ведра.
+
+    Attributes:
+        name (str): Имя ведра.
+        capacity (int): Сколько единиц помещается всего.
+        refill_per_second (float): Сколько восстанавливается за секунду.
+        burst (int): Сколько можно потратить залпом.
+        unit (str): requests либо actions_per_hour для логических записей.
+    """
+
+    name: str
+    capacity: int
+    refill_per_second: float
+    burst: int
+    unit: str = "requests"
+
+
+#: Вёдра бюджета. Вложены: запрос расходует сначала общее, потом ведро
+#: аккаунта. Порядок нормативен, иначе при нескольких аккаунтах в одном
+#: процессе общий предел обходится.
+BUCKETS: Final[dict[str, BucketLimits]] = {
+    "host": BucketLimits(
+        name="host",
+        capacity=60,
+        refill_per_second=1.0,
+        burst=10,
+    ),
+    "account": BucketLimits(
+        name="account",
+        capacity=30,
+        refill_per_second=0.5,
+        burst=5,
+    ),
+    "write": BucketLimits(
+        name="write",
+        capacity=60,
+        refill_per_second=0.0167,
+        burst=5,
+        unit="actions_per_hour",
+    ),
+}
+
+#: Сколько ждать освобождения бюджета, прежде чем отказать.
+
+#: Ограничитель исходящих сообщений. Не ведро токенов.
+#:
+#: Три предела из четырёх ведром невыразимы: множество различных
+#: адресатов, пауза на отдельную переписку и условная квота. Ведро
+#: отвечает «сколько ждать», а здесь ждать нельзя - пределы часовые
+#: при пределе ожидания в пять секунд.
+OUTBOUND_MESSAGES_PER_HOUR: Final[int] = 30
+OUTBOUND_UNIQUE_RECIPIENTS_PER_HOUR: Final[int] = 15
+OUTBOUND_MIN_INTERVAL_PER_CHAT_MS: Final[int] = 30000
+OUTBOUND_WINDOW_MS: Final[int] = 3600000
+COLD_OUTREACH_QUOTA_PER_HOUR: Final[int] = 3
+COLD_OUTREACH_WINDOW_MS: Final[int] = 86400000
+
+#: События, которые ГРЕЮТ переписку. Только входящие.
+#:
+#: Счётчик непрочитанного сюда не входит нарочно: он меняется и от
+#: НАШЕЙ отправки, и ограничитель на нём отменял бы сам себя.
+OUTBOUND_WARMING_EVENTS: Final[tuple[str, ...]] = ("message.created",)
+MAX_WAIT_MS: Final[int] = 5000
+
+#: Сколько попыток занять бюджет делается всего.
+#:
+#: Одна пауза и одна повторная попытка. Цикл ожидания превратил бы
+#: предел ожидания в пожелание: каждая итерация ждала бы «не дольше
+#: предела», а вызов снаружи стал бы неотличим от зависшего процесса.
+WAIT_ATTEMPTS: Final[int] = 2
+
+#: Сколько миллисекунд прибавляется к вычисленной паузе.
+#:
+#: Пауза округляется вверх и строго больше точной величины. Вровень
+#: привело бы повторную попытку ровно на границу, где запаса ещё нет
+#: из-за последнего бита деления, - и вызов отказал бы, прождав всё
+#: положенное.
+WAIT_GUARD_MS: Final[int] = 1
+
+#: Окно, за которое считается право на залп.
+#:
+#: Ёмкость и залп ограничивают разное. Ёмкость - запас: она
+#: копится в простое. Залп - темп: сколько можно отправить подряд,
+#: не переводя дыхания, независимо от накопленного.
+#:
+#: Без второго предела клиент, простоявший минуту, выпускает
+#: шестьдесят запросов в одну секунду - и первым от собственного
+#: залпа страдает сам аккаунт.
+BURST_WINDOW_MS: Final[int] = 1000
+
+
+class RequestClass(StrEnum):
+    """Класс запроса.
+
+    Определяет, кого вытесняют при нехватке ёмкости. Проставляет его
+    служба, а не пользователь: пользователь не знает, чем его вызов
+    мешает соседнему.
+    """
+
+    INTERACTIVE = "interactive"
+    AUTOMATION = "automation"
+    POLL = "poll"
+    MONITORING = "monitoring"
+
+
+#: Что делать с запросом, которого ёмкость не пускает.
+#:
+#: "wait" - ждать пополнения, "refuse" - отказать немедленно.
+#: Отказать можно только тому, кого спецификация объявила
+#: отменяемым: ответ покупателю, не отправленный из-за собственного
+#: мониторинга продавца, - худший исход, какой этот раздел даёт.
+ON_REFUSAL: Final[dict[RequestClass, str]] = {
+    RequestClass.INTERACTIVE: "wait",
+    RequestClass.AUTOMATION: "wait",
+    RequestClass.POLL: "wait",
+    RequestClass.MONITORING: "refuse",
+}
+
+#: Гарантированная доля ёмкости для каждого класса.
+FLOOR_SHARE: Final[dict[RequestClass, float]] = {
+    RequestClass.INTERACTIVE: 0.3,
+    RequestClass.AUTOMATION: 0.3,
+    RequestClass.POLL: 0.25,
+    RequestClass.MONITORING: 0.15,
+}
+
+#: Сколько класс считается претендующим после обращения.
+#:
+#: Порог складывается только из долей претендующих. Вытеснять
+#: некого, когда никто не претендует, и запрещать циклу обновлений
+#: брать больше своей доли на пустой площадке значило бы наказывать
+#: его за чужое бездействие.
+DEMAND_WINDOW_MS: Final[int] = 60000
+
+#: Расходуют ли бюджет повторы.
+COUNTS_RETRIES: Final[bool] = True
+
+#: Расходуют ли бюджет переходы по редиректам.
+COUNTS_REDIRECTS: Final[bool] = True
+
+#: Предел числа переходов на один запрос.
+
+#: Раньше какого срока проверка сессии возвращает кэш, миллисекунды.
+MIN_HEALTH_INTERVAL_MS: Final[int] = 60000
+
+#: Сколько событий помещается в очередь одного ключа упорядочивания, штук.
+MAX_QUEUE_DEPTH_PER_KEY: Final[int] = 128
+
+#: Сколько обработчиков выполняется одновременно, штук.
+MAX_CONCURRENT_HANDLERS: Final[int] = 8
+
+#: Сколько ждать обработчик, прежде чем счесть его зависшим, миллисекунды.
+HANDLER_TIMEOUT_MS: Final[int] = 30000
+
+#: Сколько соединений с одним хостом держать одновременно, штук.
+MAX_CONNECTIONS_PER_HOST: Final[int] = 4
+
+#: Предел размера полученного тела, байты.
+MAX_RESPONSE_BYTES: Final[int] = 8388608
+
+#: Предел размера тела после распаковки, байты.
+MAX_DECOMPRESSED_BYTES: Final[int] = 33554432
+
+#: Предел числа переходов при ручном следовании, штук.
+MAX_REDIRECTS: Final[int] = 5
+
+
+@dataclass(frozen=True, slots=True)
+class RateLimitResponse:
+    """Как источник отвечает на ограничение частоты.
+
+    Восстановление медленнее падения намеренно. Симметричное
+    восстановление даёт автоколебания: система отступает, тут же
+    возвращается к прежней частоте, получает ограничение снова и так
+    по кругу.
+
+    Attributes:
+        capacity_multiplier (float): На сколько умножается ёмкость.
+        min_capacity_factor (float): Ниже этой доли ёмкость не падает.
+        cooldown_ms (int): Остывание за первое ограничение, мс.
+        window_ms (int): Окно учёта ограничений, мс.
+        successes_per_step (int): Успехов подряд на шаг восстановления.
+        recovery_multiplier (float): Во сколько раз растёт ёмкость.
+    """
+
+    capacity_multiplier: float
+    min_capacity_factor: float
+    cooldown_ms: int
+    window_ms: int
+    successes_per_step: int
+    recovery_multiplier: float
+
+
+#: Реакция на ограничение частоты.
+#:
+#: Раздел долго называл ступени именами и не давал ни одного числа:
+#: реализация не могла его выполнить, даже захотев.
+RATE_LIMIT_RESPONSE: Final[RateLimitResponse] = RateLimitResponse(
+    capacity_multiplier=0.5,
+    min_capacity_factor=0.125,
+    cooldown_ms=60000,
+    window_ms=900000,
+    successes_per_step=20,
+    recovery_multiplier=1.1,
+)
+
+
+@dataclass(frozen=True, slots=True)
+class Scheduling:
+    """Числа расписания опроса.
+
+    Attributes:
+        active_interval_ms (int): Интервал при активном аккаунте.
+        idle_step_multiplier (float): Во сколько раз растёт интервал в покое.
+        max_interval_ms (int): Потолок интервала.
+        activity_window_ms (int): Окно, в котором аккаунт считается активным.
+        min_floor_ms (int): Нижний предел интервала.
+    """
+
+    active_interval_ms: int
+    idle_step_multiplier: float
+    max_interval_ms: int
+    activity_window_ms: int
+    min_floor_ms: int
+
+
+#: Расписание опроса.
+#:
+#: Нижний предел интервала обычной настройкой не понижается. Это
+#: единственное число, которое защищает площадку от слишком уверенного
+#: пользователя, а аккаунт пользователя - от него самого.
+SCHEDULING: Final[Scheduling] = Scheduling(
+    active_interval_ms=3000,
+    idle_step_multiplier=1.5,
+    max_interval_ms=120000,
+    activity_window_ms=300000,
+    min_floor_ms=2000,
+)
+
+#: Признак того, что числа подобраны, а не измерены.
+#:
+#: Снимается только тогда, когда пороги станут известны из наблюдений.
+#: Измерять их намеренным превышением нельзя.
+PROVISIONAL: Final[bool] = True
+
+MARKET_INTERVAL_MS: Final[int] = 120000
+MARKET_ABSENCES: Final[int] = 2
+MARKET_HISTORY_LIMIT: Final[int] = 100000

funora/capabilities.py

@@ -0,0 +1,297 @@
+r"""Возможности адаптера и их состояния.
+
+Файл порождён из спецификации, править его руками нельзя: правка исчезнет при
+следующей сборке. Источник - spec/capabilities.yaml в репозитории Funora-spec.
+Перестроить: .venv\Scripts\python.exe tools/codegen.py
+
+Состояний пять, и разница между ними не косметическая. Вызов блокируется
+только при unsupported, то есть при позитивном свидетельстве отсутствия.
+При unknown вызов выполняется оптимистично: неудачная проверка не
+доказывает, что возможности нет, и блокировать по ней значило бы
+запрещать работу из-за собственной неуверенности.
+
+Признаки usable и opt_in_required вынесены в код намеренно. Именно из них
+выводится решение «звать или отказать», и если каждая из шести реализаций
+выведет его сама, они разойдутся в поведении, оставаясь согласными в
+названиях.
+"""
+
+from __future__ import annotations
+
+from enum import StrEnum
+from typing import Final, NoReturn
+
+__all__ = ["CapabilityState", "Capability", "CAPABILITY_SOURCE", "CAPABILITY_INITIAL"]
+
+
+class CapabilityState(StrEnum):
+    """Состояние возможности в текущем сеансе.
+
+    supported:
+        Возможность подтверждена и доступна.
+    unsupported:
+        Возможность отсутствует по позитивному свидетельству. Вызов завершается
+        UnsupportedCapabilityError.
+    experimental:
+        Возможность реализована, но контракт может измениться. Требует явного включения;
+        без него вызов завершается ExperimentalCapabilityError.
+    degraded:
+        Возможность работает, но адаптер наблюдает частичную деградацию извлечения на
+        связанной странице. Вызов разрешён, результат может быть неполным, и это
+        отражено в поле completeness результата. Состояние существует, чтобы
+        отличить «работает не полностью» от «не работает»: без него оба случая
+        пришлось бы кодировать одним значением, и на такое состояние невозможно
+        написать тест.
+    unknown:
+        Состояние не установлено. Вызов НЕ блокируется: выполняется оптимистично, и при
+        отказе пользователь получает типизированную ошибку. Молчаливый уход в
+        else-ветку невозможен по построению.
+    """
+
+    SUPPORTED = "supported"
+    UNSUPPORTED = "unsupported"
+    EXPERIMENTAL = "experimental"
+    DEGRADED = "degraded"
+    UNKNOWN = "unknown"
+
+    @property
+    def usable(self) -> bool:
+        """Сообщает, можно ли звать возможность без дополнительных условий.
+
+        Отвечает на вопрос «можно ли звать прямо сейчас», а не «работает ли
+        возможность вообще». У состояния experimental возможность работает,
+        но звать её без явного включения нельзя, поэтому здесь False.
+
+        Returns:
+            bool: True, если вызов разрешён без включения.
+        """
+        return self in _USABLE
+
+    @property
+    def opt_in_required(self) -> bool:
+        """Сообщает, требуется ли явное согласие вызывающего.
+
+        Returns:
+            bool: True, если без включения вызов отклоняется.
+        """
+        return self in _OPT_IN
+
+    def allows_call(self, *, opted_in: bool) -> bool:
+        """Решает, разрешён ли вызов в этом состоянии.
+
+        Правило взято из predicates в spec/capabilities.yaml, где оно
+        объявлено нормативным. Выводить его заново в каждой реализации
+        нельзя: шесть SDK выведут шесть разных решений, оставаясь
+        согласными в названиях состояний.
+
+        Args:
+            opted_in (bool): Включил ли вызывающий возможность явно.
+
+        Returns:
+            bool: True, если вызов разрешён.
+        """
+        return self in _USABLE or (opted_in and self in _OPT_IN)
+
+    def __bool__(self) -> NoReturn:
+        """Запрещает приведение к булеву значению.
+
+        Состояний пять, и к двум они не сводятся. Запись
+        ``if client.capability(cap): call()`` выглядит настолько
+        естественно, что её пишут не задумываясь, - а состояние это
+        строка, и любая непустая строка истинна. Проверка пропускала
+        вызов при unsupported: ровно тот случай, ради которого она и
+        написана.
+
+        Тот же запрет стоит у Observed и по той же причине.
+
+        Raises:
+            TypeError: Всегда.
+        """
+        raise TypeError(
+            "CapabilityState нельзя привести к булеву значению: состояний "
+            "пять, а не два, и unsupported истинно как непустая строка. "
+            "Спросите allows_call(opted_in=...), если нужен факт "
+            "допустимости вызова, либо сравните состояние с нужным"
+        )
+
+
+#: Состояния, в которых вызов разрешён без дополнительных условий.
+_USABLE: Final[frozenset[CapabilityState]] = frozenset(
+    {
+        CapabilityState.SUPPORTED,
+        CapabilityState.DEGRADED,
+        CapabilityState.UNKNOWN,
+    }
+)
+
+#: Состояния, требующие явного включения вызывающим.
+_OPT_IN: Final[frozenset[CapabilityState]] = frozenset(
+    {
+        CapabilityState.EXPERIMENTAL,
+    }
+)
+
+
+class Capability(StrEnum):
+    """Возможность адаптера.
+
+    Значение члена совпадает с именем возможности в спецификации, поэтому
+    перечисление пригодно и для сравнения, и для записи в журнал.
+    """
+
+    #: Чтение профиля аккаунта, от имени которого работает клиент.
+    ACCOUNT_PROFILE = "account.profile"
+    #: Чтение операций по счёту.
+    ACCOUNT_TRANSACTIONS = "account.transactions"
+    #: Смена валюты, в которой площадка показывает суммы.
+    ACCOUNT_SWITCH_CURRENCY = "account.switch_currency"
+    #: Чтение баланса аккаунта.
+    ACCOUNT_BALANCE = "account.balance"
+    #: Чтение дерева разделов каталога.
+    CATALOG_CATEGORIES = "catalog.categories"
+    #: Поиск игр и их разделов по названию.
+    CATALOG_SEARCH = "catalog.search"
+    #: Чтение схемы полей конкретной подкатегории.
+    CATALOG_FIELD_SCHEMA = "catalog.field_schema"
+    #: Чтение публичных предложений по подкатегории.
+    MARKET_OFFERS = "market.offers"
+    #: Снимок рынка для сравнения и мониторинга.
+    MARKET_SNAPSHOT = "market.snapshot"
+    #: Чтение публичной витрины продавца с его профиля.
+    LOTS_SHOWCASE = "lots.showcase"
+    #: Чтение публичного списка предложений раздела чипов.
+    CHIPS_OFFERS = "chips.offers"
+    #: Чтение формы правки одного предложения.
+    LOTS_FORM = "lots.form"
+    #: Чтение собственных предложений продавца.
+    LOTS_LIST_OWN = "lots.list_own"
+    #: Расчёт цены покупателя по цене продавца.
+    LOTS_CALCULATE_PRICES = "lots.calculate_prices"
+    #: Расчёт цены покупателя на рынке по количеству.
+    CHIPS_CALCULATE_PRICES = "chips.calculate_prices"
+    #: Включение лота в выдачу.
+    LOTS_ACTIVATE = "lots.activate"
+    #: Снятие лота с выдачи.
+    LOTS_DEACTIVATE = "lots.deactivate"
+    #: Изменение цены лота.
+    LOTS_UPDATE_PRICE = "lots.update_price"
+    #: Поднятие лота в выдаче.
+    LOTS_PROMOTE = "lots.promote"
+    #: Чтение списка заказов.
+    ORDERS_LIST = "orders.list"
+    #: Возврат средств покупателю по заказу.
+    ORDERS_REFUND = "orders.refund"
+    #: Структурное чтение подробностей заказов пачкой.
+    ORDERS_DETAILS = "orders.details"
+    #: Чтение конкретного заказа.
+    ORDERS_GET = "orders.get"
+    #: Распознавание событий заказа из канала обновлений.
+    ORDERS_EVENTS = "orders.events"
+    #: Чтение списка личных переписок.
+    CHATS_LIST = "chats.list"
+    #: Чтение недавней истории переписки.
+    CHATS_HISTORY = "chats.history"
+    #: Догрузка более старых сообщений через курсор.
+    CHATS_HISTORY_PAGINATION = "chats.history_pagination"
+    #: Отправка текстового сообщения.
+    CHATS_SEND_TEXT = "chats.send_text"
+    #: Отправка изображения или вложения.
+    CHATS_SEND_IMAGE = "chats.send_image"
+    #: Что покупатель смотрит прямо сейчас.
+    CHATS_BUYER_VIEWING = "chats.buyer_viewing"
+    #: Отметка переписки прочитанной.
+    CHATS_MARK_READ = "chats.mark_read"
+    #: Написание отзыва к заказу либо ответа на чужой.
+    REVIEWS_LEAVE = "reviews.leave"
+    #: Снятие своего отзыва либо ответа.
+    REVIEWS_REMOVE = "reviews.remove"
+    #: Чтение отзывов с профиля продавца.
+    REVIEWS_GET = "reviews.get"
+    #: Умеет ли адаптер распознавать системные тексты на той локали, которую площадка отдаёт
+    #: этому аккаунту.
+    PROTOCOL_LOCALE = "protocol.locale"
+
+
+#: Откуда берётся состояние возможности.
+#:
+#: static - известно из спецификации, probe - выясняется проверкой,
+#: derived - выводится из состояния других возможностей.
+CAPABILITY_SOURCE: Final[dict[Capability, str]] = {
+    Capability.ACCOUNT_PROFILE: "static",
+    Capability.ACCOUNT_TRANSACTIONS: "probe",
+    Capability.ACCOUNT_SWITCH_CURRENCY: "probe",
+    Capability.ACCOUNT_BALANCE: "probe",
+    Capability.CATALOG_CATEGORIES: "static",
+    Capability.CATALOG_SEARCH: "static",
+    Capability.CATALOG_FIELD_SCHEMA: "probe",
+    Capability.MARKET_OFFERS: "static",
+    Capability.MARKET_SNAPSHOT: "derived",
+    Capability.LOTS_SHOWCASE: "probe",
+    Capability.CHIPS_OFFERS: "probe",
+    Capability.LOTS_FORM: "probe",
+    Capability.LOTS_LIST_OWN: "static",
+    Capability.LOTS_CALCULATE_PRICES: "probe",
+    Capability.CHIPS_CALCULATE_PRICES: "probe",
+    Capability.LOTS_ACTIVATE: "probe",
+    Capability.LOTS_DEACTIVATE: "probe",
+    Capability.LOTS_UPDATE_PRICE: "probe",
+    Capability.LOTS_PROMOTE: "probe",
+    Capability.ORDERS_LIST: "static",
+    Capability.ORDERS_REFUND: "probe",
+    Capability.ORDERS_DETAILS: "probe",
+    Capability.ORDERS_GET: "static",
+    Capability.ORDERS_EVENTS: "probe",
+    Capability.CHATS_LIST: "static",
+    Capability.CHATS_HISTORY: "static",
+    Capability.CHATS_HISTORY_PAGINATION: "probe",
+    Capability.CHATS_SEND_TEXT: "static",
+    Capability.CHATS_SEND_IMAGE: "probe",
+    Capability.CHATS_BUYER_VIEWING: "probe",
+    Capability.CHATS_MARK_READ: "probe",
+    Capability.REVIEWS_LEAVE: "probe",
+    Capability.REVIEWS_REMOVE: "probe",
+    Capability.REVIEWS_GET: "probe",
+    Capability.PROTOCOL_LOCALE: "static",
+}
+
+#: Состояние возможности до первой проверки.
+#:
+#: Начальное значение unknown означает «ещё не выяснено», а не «нет».
+#: Разница определяет, будет вызов выполнен или отклонён.
+CAPABILITY_INITIAL: Final[dict[Capability, CapabilityState]] = {
+    Capability.ACCOUNT_PROFILE: CapabilityState.SUPPORTED,
+    Capability.ACCOUNT_TRANSACTIONS: CapabilityState.UNKNOWN,
+    Capability.ACCOUNT_SWITCH_CURRENCY: CapabilityState.UNKNOWN,
+    Capability.ACCOUNT_BALANCE: CapabilityState.UNKNOWN,
+    Capability.CATALOG_CATEGORIES: CapabilityState.SUPPORTED,
+    Capability.CATALOG_SEARCH: CapabilityState.SUPPORTED,
+    Capability.CATALOG_FIELD_SCHEMA: CapabilityState.UNKNOWN,
+    Capability.MARKET_OFFERS: CapabilityState.SUPPORTED,
+    Capability.MARKET_SNAPSHOT: CapabilityState.SUPPORTED,
+    Capability.LOTS_SHOWCASE: CapabilityState.UNKNOWN,
+    Capability.CHIPS_OFFERS: CapabilityState.UNKNOWN,
+    Capability.LOTS_FORM: CapabilityState.UNKNOWN,
+    Capability.LOTS_LIST_OWN: CapabilityState.SUPPORTED,
+    Capability.LOTS_CALCULATE_PRICES: CapabilityState.UNKNOWN,
+    Capability.CHIPS_CALCULATE_PRICES: CapabilityState.UNKNOWN,
+    Capability.LOTS_ACTIVATE: CapabilityState.UNKNOWN,
+    Capability.LOTS_DEACTIVATE: CapabilityState.UNKNOWN,
+    Capability.LOTS_UPDATE_PRICE: CapabilityState.UNKNOWN,
+    Capability.LOTS_PROMOTE: CapabilityState.UNKNOWN,
+    Capability.ORDERS_LIST: CapabilityState.SUPPORTED,
+    Capability.ORDERS_REFUND: CapabilityState.UNKNOWN,
+    Capability.ORDERS_DETAILS: CapabilityState.UNKNOWN,
+    Capability.ORDERS_GET: CapabilityState.SUPPORTED,
+    Capability.ORDERS_EVENTS: CapabilityState.UNKNOWN,
+    Capability.CHATS_LIST: CapabilityState.SUPPORTED,
+    Capability.CHATS_HISTORY: CapabilityState.SUPPORTED,
+    Capability.CHATS_HISTORY_PAGINATION: CapabilityState.UNKNOWN,
+    Capability.CHATS_SEND_TEXT: CapabilityState.SUPPORTED,
+    Capability.CHATS_SEND_IMAGE: CapabilityState.UNKNOWN,
+    Capability.CHATS_BUYER_VIEWING: CapabilityState.UNKNOWN,
+    Capability.CHATS_MARK_READ: CapabilityState.UNKNOWN,
+    Capability.REVIEWS_LEAVE: CapabilityState.UNKNOWN,
+    Capability.REVIEWS_REMOVE: CapabilityState.UNKNOWN,
+    Capability.REVIEWS_GET: CapabilityState.UNKNOWN,
+    Capability.PROTOCOL_LOCALE: CapabilityState.SUPPORTED,
+}