@aspalagin/openclaw-max 0.8.2 → 0.9.2

package/README.md

@@ -6,11 +6,12 @@
 
 Плагин нужен тем, кто пользуется OpenClaw и хочет, чтобы ассистент был доступен в MAX. Понадобятся токен бота MAX (ботов создают организации на [business.max.ru](https://business.max.ru/self)) и собственный gateway OpenClaw.
 
-Версия 0.8.2. Изменения: [CHANGELOG.md](https://github.com/aspalagin/openclaw-max/blob/main/CHANGELOG.md).
+Версия 0.9.2. Изменения: [CHANGELOG.md](https://github.com/aspalagin/openclaw-max/blob/main/CHANGELOG.md).
 
 ## Содержание
 
 - [Поддерживаемые типы сообщений](#поддерживаемые-типы-сообщений)
+- [Форматирование исходящих](#форматирование-исходящих)
 - [Требования и совместимость](#требования-и-совместимость)
 - [Установка](#установка)
 - [Быстрый старт](#быстрый-старт)
@@ -38,7 +39,7 @@
 
 | Тип | Входящие (MAX → агент) | Исходящие (агент → MAX) |
 |---|---|---|
-| Текст | Да; упоминания распознаются по разметке MAX, `@username` и шаблонам упоминаний ядра | Да; markdown переводится в диалект MAX (`++underline++`) и делится на части по 4000 символов; если MAX отклоняет разметку, текст один раз отправляется заново без неё |
+| Текст | Да; упоминания распознаются по разметке MAX, `@username` и шаблонам упоминаний ядра | Да; markdown переводится в диалект MAX (заголовки, выделение, подчёркивание, линии, таблицы — см. [Форматирование исходящих](#форматирование-исходящих)) и делится на части по 4000 символов; если MAX отклоняет разметку, текст один раз отправляется заново без неё |
 | Изображение | Скачивается и передаётся агенту как медиа | Да; несколько изображений и видео уходят альбомами до 12 штук; публичная https-ссылка на изображение передаётся в MAX ссылкой |
 | Видео | Скачивается (лимит размера — `mediaMaxMb`) | Да |
 | Аудио и голосовые | Скачиваются; если MAX прислал расшифровку, используется она, иначе запись распознаёт ядро OpenClaw | Да; `asVoice` / `audioAsVoice` отправляет вложение MAX `audio` |
@@ -58,6 +59,39 @@
 
 Реакции и опросы не поддерживаются.
 
+## Форматирование исходящих
+
+Агент пишет обычный markdown, плагин переводит его в диалект MAX. Код, блоки ``` и ~~~ и ссылки не меняются. Что MAX разбирает сам, проверено живой отправкой 10.10.2026 (разметка из `GET /messages`):
+
+| В ответе агента | В MAX |
+|---|---|
+| `**жирный**`, `*курсив*`, `~~зачёркнутый~~`, `` `код` ``, блоки ```, ссылки, упоминания | как есть |
+| `# Заголовок` | заголовок |
+| `## …` — `###### …` | `# …`: в MAX один уровень заголовка, остальные он показывает простым текстом |
+| `^^текст^^`, `==текст==` | выделение (красным); `==` переводится в `^^` |
+| `<u>текст</u>`, `++текст++` | подчёркивание |
+| `> цитата` | блок цитаты: MAX разбирает её сам (на телефоне проверено 10.10.2026; в `markup` из Bot API цитата не видна) |
+| `---`, `***`, `___`, `* * *` | линия `───`: MAX сам линий не рисует |
+| таблица | узкая — моноширинным блоком, широкая — пунктами; см. ниже |
+
+Таблиц в MAX нет, а блок кода на телефоне не прокручивается: длинная строка переносится, и таблица разваливается. Поэтому по умолчанию (ключ `markdown.tables` не задан) плагин решает за каждую таблицу отдельно:
+
+- узкая — строка моноширинного блока не длиннее 36 символов (кириллица и латиница — один символ, эмодзи и иероглифы — два): уходит моноширинным блоком с выровненными столбцами. Столько влезает в блок кода на обычном телефоне;
+- широкая — пунктами: на каждую строку таблицы первая ячейка жирным, остальные `• Столбец: значение`. Читается на любом экране. Таблица со ссылками тоже уходит пунктами: в моноширинном блоке от ссылки остаётся только текст.
+
+Штатный ключ OpenClaw `markdown.tables` (в `channels.max` или в `accounts.<id>`) задаёт один режим для всех таблиц, без оглядки на ширину:
+
+- `bullets` — всегда пунктами, как у Signal и WhatsApp;
+- `code` — всегда моноширинным блоком, даже широкая таблица (на телефоне она переносится);
+- `block` — то же, что `code`;
+- `off` — как есть, сырым текстом с `|`.
+
+```json5
+{ channels: { max: { markdown: { tables: "code" } } } }
+```
+
+Ответ форматируется до того, как делится на части по 4000 символов: части меряются по отправляемому тексту, а блок таблицы, который помещается в одно сообщение, не разрывается (более длинный блок делится с закрытием и повторным открытием ```). Черновик стриминга, его правки, доставка ядра (cron, `openclaw message send`) и действия `send`, `edit`, `sendAttachment` форматируются так же, как обычный ответ. Если MAX отклонит разметку, текст, как и раньше, один раз уходит без неё.
+
 ## Требования и совместимость
 
 - OpenClaw ≥ 2026.9.6 (`peerDependencies.openclaw`, `openclaw.compat.minGatewayVersion`). Более ранние версии не работают — это проверено на 2026.9.3–2026.9.5 проверкой типов и набором тестов. В 2026.9.5 нет `createLivePreviewLifecycle` в `openclaw/plugin-sdk/channel-outbound`, поэтому модуль плагина не загружается (на этой функции построен статус хода); в 2026.9.3 и 2026.9.4 вдобавок нет проверки отправителя при ответе на вопросы агента кнопками (`authorize` в `resolveOption`), защищённого хука индикатора набора для heartbeat и формата пояснения к плану. Чтобы пользоваться плагином, обновите OpenClaw.
@@ -168,6 +202,7 @@ openclaw plugins install npm:@aspalagin/openclaw-max
 | `streamMode` | `off` \| `partial` \| `block` | `off` | `partial` — одно сообщение-черновик правится, пока ответ стримится; `block` — блочные ответы ядра |
 | `streaming` | настройка стриминга ядра | выключено | `streaming.mode` (`off`, `partial`, `block`, `progress`) сильнее `streamMode`; `streaming.progress.*` настраивает [статус хода](#статус-хода) |
 | `textChunkLimit` | целое | `4000` | Символов в одном исходящем сообщении; значение аккаунта в приоритете; всё, что больше лимита MAX в 4000, урезается до него |
+| `markdown.tables` | `bullets` \| `code` \| `block` \| `off` | по ширине | Как отправлять таблицы из ответов агента. Не задан — каждая по ширине: до 36 символов моноширинным блоком, шире пунктами. Заданный режим действует на все таблицы: пунктами, моноширинным блоком (`block` — то же, что `code`) или как есть; см. [Форматирование исходящих](#форматирование-исходящих) |
 | `responsePrefix` | строка | — | Префикс ответов агента, его применяет ядро OpenClaw (`"auto"` — имя агента) |
 | `historyLimit` | целое ≥ 0 | умолчание ядра | Читает ядро OpenClaw: сколько последних ходов групповой сессии встроенный рантайм агента держит в промпте (нативные CLI-рантаймы ведут историю сами) |
 | `dmHistoryLimit`, `dms.<userId>.historyLimit` | целое ≥ 0 | без ограничения | Читает ядро OpenClaw: то же для личных диалогов с сессией на канал (`session.dmScope`); значение для пользователя в приоритете |
@@ -190,7 +225,7 @@ openclaw plugins install npm:@aspalagin/openclaw-max
 | `systemPrompt` | — | Дополнительный системный промпт для ходов в этой группе |
 | `skills` | все | Навыки, которые может загружать ход в этой группе; `[]` — никакие |
 
-Ключи `markdown` (отрисовка таблиц), `blockStreaming` (используйте `streamMode` или `streaming.mode: "block"`) и `blockStreamingCoalesce` (ядро читает `streaming.block.coalesce`) схема принимает для совместимости с общим форматом конфигурации каналов, но **в MAX они ни на что не влияют**: ни плагин, ни ядро OpenClaw не читают их для этого канала. Они оставлены в схеме, чтобы существующие конфиги по-прежнему проходили проверку.
+Ключи `blockStreaming` (используйте `streamMode` или `streaming.mode: "block"`) и `blockStreamingCoalesce` (ядро читает `streaming.block.coalesce`) схема принимает для совместимости с общим форматом конфигурации каналов, но **в MAX они ни на что не влияют**: ни плагин, ни ядро OpenClaw не читают их для этого канала. Они оставлены в схеме, чтобы существующие конфиги по-прежнему проходили проверку.
 
 ## Доступ и политики
 

package/README_EN.md

@@ -6,11 +6,12 @@ A channel plugin that connects an [OpenClaw](https://openclaw.ai) assistant to t
 
 It is for OpenClaw users who need their assistant reachable in MAX. You need a MAX bot token (bots are created by organisations on [business.max.ru](https://business.max.ru/self)) and an OpenClaw gateway you run yourself.
 
-Version 0.8.2. Changes: [CHANGELOG.md](https://github.com/aspalagin/openclaw-max/blob/main/CHANGELOG.md) (in Russian).
+Version 0.9.2. Changes: [CHANGELOG.md](https://github.com/aspalagin/openclaw-max/blob/main/CHANGELOG.md) (in Russian).
 
 ## Contents
 
 - [Supported message types](#supported-message-types)
+- [Outgoing formatting](#outgoing-formatting)
 - [Requirements and compatibility](#requirements-and-compatibility)
 - [Installation](#installation)
 - [Quick start](#quick-start)
@@ -38,7 +39,7 @@ Version 0.8.2. Changes: [CHANGELOG.md](https://github.com/aspalagin/openclaw-max
 
 | Type | Incoming (MAX → agent) | Outgoing (agent → MAX) |
 |---|---|---|
-| Text | Yes; mentions detected from MAX markup, `@username` and core mention patterns | Yes; markdown converted to the MAX dialect (`++underline++`), split at 4000 characters; if MAX rejects the markup, resent once as plain text |
+| Text | Yes; mentions detected from MAX markup, `@username` and core mention patterns | Yes; markdown converted to the MAX dialect (headings, highlight, underline, rules, tables — see [Outgoing formatting](#outgoing-formatting)), split at 4000 characters; if MAX rejects the markup, resent once as plain text |
 | Image | Downloaded and passed to the agent as media | Yes; several images and videos go as albums of up to 12; a public https image URL is passed to MAX as a link |
 | Video | Downloaded (size limit `mediaMaxMb`) | Yes |
 | Audio and voice | Downloaded; the MAX transcript is used when present, otherwise OpenClaw core transcribes | Yes; `asVoice` / `audioAsVoice` sends a MAX `audio` attachment |
@@ -58,6 +59,39 @@ Version 0.8.2. Changes: [CHANGELOG.md](https://github.com/aspalagin/openclaw-max
 
 Reactions and polls are not supported.
 
+## Outgoing formatting
+
+The agent writes ordinary Markdown and the plugin converts it to the MAX dialect. Code, ``` and ~~~ blocks and links stay as written. What MAX parses itself was checked by live sends on 2026-10-10 (markup read back with `GET /messages`):
+
+| In the agent reply | In MAX |
+|---|---|
+| `**bold**`, `*italic*`, `~~strike~~`, `` `code` ``, ``` blocks, links, mentions | as is |
+| `# Heading` | heading |
+| `## …` to `###### …` | `# …`: MAX has one heading level and shows the others as plain text |
+| `^^text^^`, `==text==` | highlight (red); `==` becomes `^^` |
+| `<u>text</u>`, `++text++` | underline |
+| `> quote` | a quote block: MAX parses it itself (checked on a phone on 2026-10-10; the Bot API `markup` does not show it) |
+| `---`, `***`, `___`, `* * *` | a `───` line: MAX draws no rules itself |
+| table | a narrow one as a monospace block, a wide one as bullets; see below |
+
+MAX has no tables, and a code block does not scroll on a phone: a long line wraps and the table falls apart. So by default (`markdown.tables` not set) the plugin decides for each table on its own:
+
+- a narrow one — a monospace line of at most 36 columns (Cyrillic and Latin letters take one, emoji and CJK two) — goes as a monospace block with aligned columns. That much fits into a code block on an ordinary phone;
+- a wide one goes as bullets: per table row, the first cell in bold and the others as `• Column: value`. Reads on any screen. A table with links goes as bullets too: a monospace block keeps only the link text.
+
+The standard OpenClaw key `markdown.tables` (in `channels.max` or `accounts.<id>`) sets one mode for every table, whatever its width:
+
+- `bullets` — always bullets, as for Signal and WhatsApp;
+- `code` — always a monospace block, a wide table too (it wraps on a phone);
+- `block` — same as `code`;
+- `off` — as written, raw text with `|`.
+
+```json5
+{ channels: { max: { markdown: { tables: "code" } } } }
+```
+
+A reply is formatted before it is split into 4000-character parts: parts are measured as sent, and a table block that fits into one message is never split (a longer block is split with its ``` fence closed and reopened). The stream draft and its edits, core delivery (cron, `openclaw message send`) and the `send`, `edit` and `sendAttachment` actions are formatted like an ordinary reply. If MAX rejects the markup, the text is resent once without it, as before.
+
 ## Requirements and compatibility
 
 - OpenClaw ≥ 2026.9.6 (`peerDependencies.openclaw`, `openclaw.compat.minGatewayVersion`). Older releases do not work, checked against 2026.9.3–2026.9.5 by typecheck and the test suite: 2026.9.5 lacks `createLivePreviewLifecycle` in `openclaw/plugin-sdk/channel-outbound`, so the plugin module fails to load (turn status is built on it); 2026.9.3 and 2026.9.4 also lack the sender check for answering agent questions with buttons (`authorize` in `resolveOption`), the guarded heartbeat typing hook and the plan-explanation format. Upgrade OpenClaw to use this plugin.
@@ -168,6 +202,7 @@ All options live under `channels.max`; the same keys (except `accounts` and `com
 | `streamMode` | `off` \| `partial` \| `block` | `off` | `partial` — one draft message edited while the answer streams; `block` — core block replies |
 | `streaming` | core streaming config | off | `streaming.mode` (`off`, `partial`, `block`, `progress`) wins over `streamMode`; `streaming.progress.*` configures [turn status](#turn-status) |
 | `textChunkLimit` | integer | `4000` | Characters per outgoing message, account value first; values above MAX's 4000 are capped |
+| `markdown.tables` | `bullets` \| `code` \| `block` \| `off` | by width | How tables in agent replies are sent. Not set: each by its width, up to 36 columns as a monospace block, wider as bullets. A set mode applies to every table: bullets, a monospace block (`block` is the same as `code`) or as written; see [Outgoing formatting](#outgoing-formatting) |
 | `responsePrefix` | string | — | Prefix of agent replies, applied by OpenClaw core (`"auto"` — agent name) |
 | `historyLimit` | integer ≥ 0 | core default | Read by OpenClaw core: recent turns of a group session the embedded agent runtime keeps in the prompt (native CLI runtimes keep their own history) |
 | `dmHistoryLimit`, `dms.<userId>.historyLimit` | integer ≥ 0 | no limit | Read by OpenClaw core: the same for private dialogs with a per-channel session (`session.dmScope`), per user first |
@@ -190,7 +225,7 @@ Per-group settings (`groups.<chatId>` or `groups["*"]`):
 | `systemPrompt` | — | Extra system prompt for turns in this group |
 | `skills` | all | Skills a turn in this group may load; `[]` — none |
 
-Accepted by the schema for compatibility with the common channel config shape but **without effect in MAX** — neither the plugin nor OpenClaw core reads them for this channel: `markdown` (table rendering), `blockStreaming` (use `streamMode` or `streaming.mode: "block"`), `blockStreamingCoalesce` (core reads `streaming.block.coalesce`). They stay in the schema so existing configs keep validating.
+Accepted by the schema for compatibility with the common channel config shape but **without effect in MAX** — neither the plugin nor OpenClaw core reads them for this channel: `blockStreaming` (use `streamMode` or `streaming.mode: "block"`), `blockStreamingCoalesce` (core reads `streaming.block.coalesce`). They stay in the schema so existing configs keep validating.
 
 ## Access and policies
 

package/SKILL.md

@@ -9,7 +9,7 @@ description: Канал-плагин для подключения OpenClaw к
 
 ## Что делает
 
-- **Текст** — отправка и получение; исходящий markdown переводится в диалект MAX (`++подчёркивание++`). Если MAX отверг разметку, сообщение уходит обычным текстом.
+- **Текст** — отправка и получение; исходящий markdown переводится в диалект MAX: `# заголовок` (уровни `##`…`######` тоже идут как `#`), `^^выделение^^` (и `==…==`), `++подчёркивание++`, `> цитата`, линии `───`; таблицы — по умолчанию узкие моноширинным блоком, широкие пунктами (`markdown.tables` задаёт один режим). Если MAX отверг разметку, сообщение уходит обычным текстом.
 - **Медиа** — фото, видео, аудио, файлы, стикеры, контакты, геолокация; несколько вложений — альбомами до 12.
 - **Голосовые** — входящие распознаёт ядро (`tools.media.audio`) или берётся транскрипт MAX; голосовой ответ уходит аудиовложением MAX.
 - **Пересылки и цитаты** — агент видит пересланные сообщения и цитату сообщения, на которое ответили.

package/dist/src/accounts.js

@@ -187,6 +187,7 @@ export function readMaxAccount(params) {
             botToken: section.botToken,
             tokenFile: section.tokenFile,
             name: section.name,
+            markdown: section.markdown,
             dmPolicy: section.dmPolicy,
             allowFrom: section.allowFrom,
             groups: section.groups,

package/dist/src/actions.js

@@ -8,6 +8,7 @@ import { readStringParam } from 'openclaw/plugin-sdk/param-readers';
 import { jsonResult } from 'openclaw/plugin-sdk/tool-results';
 import { listMaxAccountIds, resolveMaxAccount } from './accounts.js';
 import { assertMaxActionInScope } from './action-scope.js';
+import { resolveMaxTableMode, toMaxMarkdown } from './format.js';
 import { sanitizeMaxFileName } from './media-temp.js';
 import { materializeMaxPresentation, readMaxDeliveryPin, resolveMaxTextChunkLimit, } from './presentation.js';
 import { getMaxRuntime } from './runtime.js';
@@ -273,6 +274,8 @@ export const maxMessageActions = {
         const sendFlags = resolveMaxSendFlags(account.config, {
             silent: typeof params.silent === 'boolean' ? params.silent : undefined,
         });
+        // MAX dialect and tables of the account (markdown.tables), before chunking.
+        const formatText = (text) => toMaxMarkdown(text, { tableMode: resolveMaxTableMode(account.config) });
         // Strip provider prefix from target (e.g. "max:123456789" → "123456789")
         const stripPrefix = (val) => {
             if (!val)
@@ -287,10 +290,10 @@ export const maxMessageActions = {
             });
             const presentation = normalizeMessagePresentation(params.presentation);
             const pin = readMaxDeliveryPin(params.delivery, params.pin);
-            const content = readStringParam(params, 'message', {
+            const content = formatText(readStringParam(params, 'message', {
                 required: !presentation,
                 allowEmpty: true,
-            }) ?? '';
+            }) ?? '');
             // Pin the sent message when delivery.pin (or pin=true) was requested.
             // Optional pin failures degrade; a required one fails the action.
             // Dialogs cannot pin: that is reported as pinned:false with pinSkipped.
@@ -333,7 +336,7 @@ export const maxMessageActions = {
             if (presentation) {
                 const rendered = await materializeMaxPresentation({ text: content, presentation });
                 const renderedButtons = readMaxChannelButtons(rendered.channelData);
-                const text = rendered.text ?? '';
+                const text = formatText(rendered.text ?? '');
                 const chunkLimit = resolveMaxTextChunkLimit(cfg, account.accountId);
                 const chunks = text.length > chunkLimit
                     ? getMaxRuntime().channel.text.chunkMarkdownText(text, chunkLimit)
@@ -431,7 +434,7 @@ export const maxMessageActions = {
                 required: true,
                 allowEmpty: true,
             });
-            await editMaxMessage(messageId, text, {
+            await editMaxMessage(messageId, formatText(text), {
                 token: account.token,
                 format: 'markdown',
             });
@@ -495,7 +498,7 @@ export const maxMessageActions = {
             const to = stripPrefix(readTargetParam(params));
             const replyTo = readStringParam(params, 'replyTo');
             await assertMaxActionInScope(ctx, account, { to, replyTo });
-            const caption = readStringParam(params, 'message') ?? readStringParam(params, 'caption') ?? '';
+            const caption = formatText(readStringParam(params, 'message') ?? readStringParam(params, 'caption') ?? '');
             const attachType = readStringParam(params, 'type') ?? readStringParam(params, 'attachmentType') ?? '';
             const mediaMaxBytes = (account.config.mediaMaxMb ?? 20) * 1024 * 1024;
             const mediaSources = readMediaSources(params, mediaMaxBytes);

package/dist/src/channel-agent-prompt.js

@@ -1,7 +1,7 @@
 /**
- * Agent prompt hints of the MAX channel: stickers, location, contact, pin,
- * button types, presentation, voice, inline files, silent sends, local file
- * roots and action scope for the message tool.
+ * Agent prompt hints of the MAX channel: text formatting, stickers, location,
+ * contact, pin, button types, presentation, voice, inline files, silent sends,
+ * local file roots and action scope for the message tool.
  */
 /** message tool hints for MAX-specific actions. */
 export const maxAgentPromptAdapter = {
@@ -10,6 +10,7 @@ export const maxAgentPromptAdapter = {
         // Codes are hex IDs derived from listmax.ru external_id: parseInt(extId).toString(16)
         const emojiMap = '😂:109550b5 😊:109971b5 😍:10931eb5 🥰:10931eb5 😢:109330b5 😭:109330b5 😡:10941fb5 😱:109302b5 🤔:109308b5 👍:109368b5 👎:109323b5 ❤️:10931eb5 🔥:b4867ebb 💪:c1254bbb 🎉:10933cb5 😘:10931eb5 🤗:109b94b5 😎:10931db5 🙄:c14211bb 😴:10936eb5 😤:10941fb5 🤮:6b8bb 🤯:109302b5 😳:109302b5 🥳:10933cb5 💀:b4863ebb 🙈:b4850cbb 😏:11e4c60bb 😅:109550b5 🤣:109550b5 😋:109d2db5 😜:455b5 🤷:10d5cf5bb 😫:10936eb5 😩:10997db5 🥺:109356b5 😌:14aae3bb 😒:109323b5 🤪:455b5 😇:11e4dedbb 🙏:50cb5 💔:10997db5 👀:b48534bb ✨:11e43b2bb 😈:10941fb5 🤝:109368b5 🤦:502b5 😬:5dab4b5 🤩:5dabfb5 😶:2ae2b5';
         return [
+            '- MAX formatting (replies and `send`): Markdown with **bold**, *italic*, ~~strike~~, ++underline++, ^^highlight^^ (red), `code`, ``` blocks, [links](https://example.com), `# Heading` (one level: `##`…`######` are sent as `#`) and `> quote`. MAX has no tables: by default a narrow Markdown table (up to 36 monospace columns) is sent as a monospace block and a wider one as bullets (bold first cell, a bullet per other cell); channels.max.markdown.tables fixes one mode. Keep tables to a few short columns, use lists for wide data.',
             '- MAX stickers: use `message(action="sticker", target="CHAT_ID", stickerId="CODE")`. Pick a sticker code matching the mood from the emoji map below. Each entry is emoji:hexCode.',
             `- Sticker emoji map: ${emojiMap}`,
             '- MAX location: use `message(action="sendAttachment", target="CHAT_ID", type="location", latitude="55.75", longitude="37.62")` to send a native map pin.',

package/dist/src/channel-directory.js

@@ -4,6 +4,7 @@
  */
 import { resolveMaxAccount } from './accounts.js';
 import { MaxApi } from './api.js';
+import { MAX_DECLARED_TABLE_MODE } from './format.js';
 import { loadMaxAccountState } from './state.js';
 /** `user:<id>` addresses a user (DM); a bare number is a chat id. */
 const MAX_TARGET_PATTERN = /^(?:user:\d+|-?\d+)$/;
@@ -25,6 +26,10 @@ export const maxMessagingAdapter = {
         looksLikeId: (raw) => MAX_TARGET_PATTERN.test(stripMaxPrefix(raw)),
         hint: '<chatId|user:userId>',
     },
+    // What core sees for MAX without markdown.tables: keeps the group prompt's
+    // "Avoid Markdown tables" and is the safe mode for core's resolver. The
+    // plugin itself picks code or bullets per table by width (format.ts).
+    defaultMarkdownTableMode: MAX_DECLARED_TABLE_MODE,
 };
 /** MAX has no member/chat listing for bots: peers come from allowFrom, groups from the chat registry. */
 export const maxDirectoryAdapter = {

package/dist/src/channel-outbound.js

@@ -4,9 +4,14 @@
  */
 import { getAgentScopedMediaLocalRoots } from 'openclaw/plugin-sdk/media-local-roots';
 import { resolveMaxAccount } from './accounts.js';
+import { resolveMaxTableMode, toMaxMarkdown } from './format.js';
 import { materializeMaxPresentation, MAX_PRESENTATION_CAPABILITIES, MAX_TEXT_LIMIT, renderMaxPresentation, resolveMaxTextChunkLimit, } from './presentation.js';
 import { getMaxRuntime, loadMaxConfig } from './runtime.js';
 import { pinMaxMessage, readMaxChannelButtons, resolveMaxSendFlags, sendMaxMediaGroup, sendMaxMediaMessage, sendMaxMessage, } from './send.js';
+/** MAX dialect and tables of the account (markdown.tables); see format.ts. */
+function formatMaxText(text, account) {
+    return toMaxMarkdown(text, { tableMode: resolveMaxTableMode(account.config) });
+}
 /**
  * Local media access for an outbound send: the roots and host reader core
  * passed with the delivery; without them the default media roots (no agent
@@ -29,6 +34,11 @@ export const maxOutboundAdapter = {
     chunker: (text, limit) => getMaxRuntime().channel.text.chunkMarkdownText(text, Math.min(limit, MAX_TEXT_LIMIT)),
     chunkerMode: 'markdown',
     textChunkLimit: 4000,
+    // Before core chunks the text: tables become bullets or one code block, so
+    // the chunker measures the text as sent and never splits a raw table.
+    normalizePayload: ({ payload, cfg, accountId }) => payload.text
+        ? { ...payload, text: formatMaxText(payload.text, resolveMaxAccount({ cfg, accountId })) }
+        : payload,
     // Presentation (docs/plugins/message-presentation.md): core adapts to these
     // capabilities, renders through renderPresentation and pins through
     // pinDeliveredMessage after the first delivered message.
@@ -59,7 +69,7 @@ export const maxOutboundAdapter = {
         const payload = rawPayload.presentation
             ? await materializeMaxPresentation(rawPayload)
             : rawPayload;
-        const effectiveText = payload === rawPayload ? text : (payload.text ?? '');
+        const effectiveText = formatMaxText(payload === rawPayload ? text : (payload.text ?? ''), account);
         const buttons = readMaxChannelButtons(payload.channelData);
         const sendFlags = resolveMaxSendFlags(account.config, {
             silent: ctx.silent,
@@ -118,7 +128,7 @@ export const maxOutboundAdapter = {
         const account = resolveMaxAccount({ cfg, accountId });
         if (!account.token)
             throw new Error('MAX bot token not configured');
-        const result = await sendMaxMessage(to, text, {
+        const result = await sendMaxMessage(to, formatMaxText(text, account), {
             token: account.token,
             replyToMessageId: replyToId ?? undefined,
             format: 'markdown',
@@ -130,12 +140,13 @@ export const maxOutboundAdapter = {
         };
     },
     sendMedia: async (ctx) => {
-        const { to, text, mediaUrl, accountId, replyToId } = ctx;
+        const { to, mediaUrl, accountId, replyToId } = ctx;
         const cfg = await loadMaxConfig();
         const account = resolveMaxAccount({ cfg, accountId });
         if (!account.token)
             throw new Error('MAX bot token not configured');
         const sendFlags = resolveMaxSendFlags(account.config, { silent: ctx.silent });
+        const text = formatMaxText(ctx.text, account);
         if (!mediaUrl) {
             // No media, send as text
             const result = await sendMaxMessage(to, text, {

package/dist/src/config-schema.js

@@ -68,7 +68,11 @@ export const MaxAccountSchemaBase = z
     .object({
     name: z.string().optional(),
     enabled: z.boolean().optional(),
-    /** No effect in MAX: neither the plugin nor core reads it for this channel. */
+    /**
+     * markdown.tables: how agent tables reach MAX, which has no native tables —
+     * not set: by width (narrow as a monospace block, wide as bullets); bullets,
+     * code (monospace block), block (same as code), off (raw) for every table.
+     */
     markdown: MarkdownConfigSchema.optional(),
     /** Plain token or a core SecretRef { source, provider, id } (also webhookSecret, httpProxy) */
     botToken: buildOptionalSecretInputSchema(),

package/dist/src/deliver.js

@@ -8,6 +8,7 @@ import { createChannelPartialDeliveryError } from 'openclaw/plugin-sdk/channel-i
 import { PlatformMessageNotDispatchedError } from 'openclaw/plugin-sdk/error-runtime';
 import { LocalMediaAccessError } from 'openclaw/plugin-sdk/web-media';
 import { MaxApiError } from './api.js';
+import { resolveMaxTableMode, toMaxMarkdown } from './format.js';
 import { readMaxDeliveryPin, resolveMaxTextChunkLimit } from './presentation.js';
 import { getMaxRuntime } from './runtime.js';
 import { answerMaxCallback, pinMaxMessage, readMaxChannelButtons, resolveMaxSendFlags, sendMaxMediaGroup, sendMaxMessage, } from './send.js';
@@ -49,6 +50,11 @@ function logSendFailure(account, log, what, err) {
 export async function deliverMaxReply(params) {
     const { payload, account, chatId, config, log, statusSink } = params;
     const core = getMaxRuntime();
+    // MAX dialect and tables (markdown.tables) before chunking: a table becomes
+    // bullets or one code block, and the chunks are measured as sent.
+    const replyText = payload.text
+        ? toMaxMarkdown(payload.text, { tableMode: resolveMaxTableMode(account.config) })
+        : payload.text;
     const buttons = readMaxChannelButtons(payload.channelData);
     // channelData.max (notify, silent, disableLinkPreview) beats the account defaults.
     const sendOptions = resolveMaxSendFlags(account.config, { channelData: payload.channelData });
@@ -79,14 +85,14 @@ export async function deliverMaxReply(params) {
         if (params.callbackState)
             params.callbackState.answered = true;
         try {
-            await answerMaxCallback(params.callbackId, payload.text ?? '', {
+            await answerMaxCallback(params.callbackId, replyText ?? '', {
                 token: account.token,
                 format: 'markdown',
                 buttons,
             });
             visible.callbackAnswered = true;
-            if (payload.text)
-                visible.texts.push(payload.text);
+            if (replyText)
+                visible.texts.push(replyText);
             statusSink?.({ lastOutboundAt: Date.now() });
         }
         catch (err) {
@@ -122,10 +128,10 @@ export async function deliverMaxReply(params) {
     if (answersCallback) {
         // The text went with the callback answer.
     }
-    else if (payload.text) {
+    else if (replyText) {
         const chunkLimit = resolveMaxTextChunkLimit(config, account.accountId);
         const chunkMode = core.channel.text.resolveChunkMode(config, 'max', account.accountId);
-        const chunks = core.channel.text.chunkMarkdownTextWithMode(payload.text, chunkLimit, chunkMode);
+        const chunks = core.channel.text.chunkMarkdownTextWithMode(replyText, chunkLimit, chunkMode);
         for (let index = 0; index < chunks.length; index += 1) {
             const chunk = chunks[index];
             const chunkButtons = index === chunks.length - 1 ? buttons : undefined;

package/dist/src/format.js

@@ -1,30 +1,187 @@
 /**
  * Конвертер форматирования OpenClaw/стандартный markdown → MAX markdown.
  *
- * Отличия MAX markdown от стандартного:
- * - Подчёркивание: MAX не поддерживает markdown-синтаксис подчёркивания, но
- *   рендерит HTML-тег <u>…</u> → конвертируем в ++…++.
- * - `**bold**` и `__bold__` MAX рендерит как жирный сам — НЕ трогаем.
- * - Упоминание: [Имя](max://user/user_id) — синтаксис MAX, оставляем как есть.
- * - bold, italic, strikethrough, code, ссылки — совпадают со стандартом.
+ * Что MAX разбирает сам (живая проба 10.10.2026, body.markup из GET /messages):
+ * `**`/`__` жирный, `*`/`_` курсив, `~~` зачёркнутый, `++` подчёркнутый,
+ * `^^` выделение, `код` и ```блоки```, ссылки, упоминания
+ * [Имя](max://user/user_id), `# заголовок` (один уровень; setext `===` тоже),
+ * `> цитата` и экранирование `\`. Это НЕ трогаем.
  *
- * Конвертация выполняется только ВНЕ inline-кода, fenced-блоков и URL, чтобы
- * не портить текст внутри `код` / ```блоков``` / ссылок.
+ * Что конвертируем (MAX показывает сырым или теряет):
+ * - pipe-таблицы — штатным convertMarkdownTables ядра (меняет только диапазоны
+ *   таблиц). Без `markdown.tables` (умолчание) каждая таблица по своей ширине:
+ *   узкая — моноширинным блоком, широкая — пунктами. Явный режим — как в ядре:
+ *   bullets — пункт на ячейку, code — моноширинный блок, block → code
+ *   (нативных таблиц в MAX нет), off — как есть;
+ * - `##`…`######` → `#`: уровни 2–6 MAX снимает без разметки;
+ * - горизонтальные линии `---`, `***`, `___` → `───`: MAX оставляет их сырыми,
+ *   `* * *` превращает во вложенные списки, а `---` под строкой текста
+ *   съедает вместе с её форматом (setext-заголовок второго уровня);
+ * - `==текст==` → `^^текст^^`;
+ * - `<u>…</u>` → `++…++`: подчёркивание тегом MAX в markdown не понимает.
+ *
+ * Заголовки и линии меняются только вне fenced-блоков, инлайн-замены — вне
+ * inline-кода, fenced-блоков и URL. Повторный вызов ничего не меняет, поэтому
+ * текст можно подготовить до разбиения на части, а send.ts пройдёт по каждой
+ * части ещё раз.
+ */
+import { convertMarkdownTables, markdownToIRWithMeta } from 'openclaw/plugin-sdk/text-chunking';
+/**
+ * Умолчание, которое видит ядро (messaging.defaultMarkdownTableMode). Режима
+ * «по ширине» в MarkdownTableMode ядра нет, а ядро по этому значению решает
+ * две вещи: добавлять ли в групповой промпт «Avoid Markdown tables» (да для
+ * всего, кроме block/off) и что вернёт resolveMarkdownTableMode для MAX без
+ * конфига. bullets: подсказка остаётся — нативных таблиц в MAX нет, широкая
+ * таблица в группе станет длинным списком; а если кто-то сконвертирует текст
+ * для MAX по этому ответу, пункты не развалятся на телефоне. block солгал бы
+ * ядру о нативных таблицах, off — о сырых.
+ */
+export const MAX_DECLARED_TABLE_MODE = 'bullets';
+/**
+ * Самая широкая таблица, которая без markdown.tables уходит моноширинным
+ * блоком: ширина строки блока в колонках. Блок кода в MAX не прокручивается,
+ * длинная строка переносится и таблица разваливается; на обычном телефоне
+ * в блок влезает 34–38 моноширинных символов (демо 10.10.2026). Шире — пункты.
+ */
+export const MAX_NARROW_TABLE_WIDTH = 36;
+/**
+ * Режим таблиц аккаунта: accounts.<id> наследует channels.max.markdown
+ * (accounts.ts). Не задан — auto; block → code: нативных таблиц в MAX нет.
+ */
+export function resolveMaxTableMode(config) {
+    const mode = config?.markdown?.tables;
+    if (!mode)
+        return 'auto';
+    return mode === 'block' ? 'code' : mode;
+}
+const graphemes = new Intl.Segmenter();
+const WIDE_GRAPHEME = /\p{Emoji_Presentation}|\p{Extended_Pictographic}\uFE0F|[\u1100-\u115F\u2E80-\u303E\u3041-\u33FF\u3400-\u4DBF\u4E00-\u9FFF\uA000-\uA4CF\uAC00-\uD7A3\uF900-\uFAFF\uFE30-\uFE4F\uFF00-\uFF60\uFFE0-\uFFE6\u{20000}-\u{3FFFD}]/u;
+const ZERO_WIDTH_GRAPHEME = /^[\p{Mn}\p{Me}\p{Cf}]+$/u;
+/** Ширина в моноширинных колонках: эмодзи и CJK — 2, метки и невидимые — 0, прочее — 1. */
+export function displayWidth(text) {
+    let width = 0;
+    for (const { segment } of graphemes.segment(text)) {
+        if (WIDE_GRAPHEME.test(segment))
+            width += 2;
+        else if (!ZERO_WIDTH_GRAPHEME.test(segment))
+            width += 1;
+    }
+    return width;
+}
+/** Ширина строки моноширинного блока таблицы, как его строит ядро: `| ячейка | … |`, колонка не уже 3. */
+export function codeTableWidth(headers, rows) {
+    const widths = [];
+    for (const row of [headers, ...rows]) {
+        row.forEach((cell, column) => {
+            widths[column] = Math.max(widths[column] ?? 3, displayWidth(cell));
+        });
+    }
+    return widths.reduce((sum, width) => sum + width + 3, 1);
+}
+/**
+ * Режимы таблиц текста в auto: узкая — code, широкая — bullets. Таблица со
+ * ссылками — тоже bullets: в моноширинном блоке ядро оставляет от ссылки только
+ * текст, адрес теряется.
  */
+function autoTableModes(markdown) {
+    if (!markdown.includes('|'))
+        return new Set();
+    const { tables } = markdownToIRWithMeta(markdown, {
+        linkify: false,
+        autolink: false,
+        tableMode: 'block',
+    });
+    return new Set(tables.map((table) => codeTableWidth(table.headers, table.rows) <= MAX_NARROW_TABLE_WIDTH &&
+        ![table.headerCells, ...table.rowCells].some((row) => row.some((cell) => cell.links.length))
+        ? 'code'
+        : 'bullets'));
+}
 const CODE_OR_URL = /(```[\s\S]*?```|`[^`]*`|https?:\/\/\S+)/g;
-/** Заменяет только <u>…</u> → ++…++; markdown-подчёркивание MAX не поддерживает. */
+/** Открывающая/закрывающая ограда блока кода, в том числе в списке или цитате. */
+const FENCE = /^\s*(?:>\s*)*(`{3,}|~{3,})/;
+const SUBHEADING = /^ {0,3}#{2,6}(?=[ \t])/;
+const THEMATIC_BREAK = /^ {0,3}([-*_])(?:[ \t]*\1){2,}[ \t]*$/;
+const HORIZONTAL_RULE = '───';
+const HIGHLIGHT = /(?<![\p{L}\p{N}_=])==(?=[^\s=])([^=\n]*?[^\s=])==(?![\p{L}\p{N}_=])/gu;
+/** Открытая ограда ```/~~~ блока после строки `line`; undefined — вне блока. */
+function fenceAfter(line, fence) {
+    const match = FENCE.exec(line);
+    if (!fence)
+        return match?.[1];
+    const closes = match &&
+        match[1][0] === fence[0] &&
+        match[1].length >= fence.length &&
+        !line.slice(match[0].length).trim();
+    return closes ? undefined : fence;
+}
+/** Заголовки уровней 2–6 и горизонтальные линии; строки внутри ```/~~~ блоков не трогаются. */
+function convertBlocks(text) {
+    let fence;
+    return text
+        .split('\n')
+        .map((line) => {
+        const inFence = fence !== undefined;
+        fence = fenceAfter(line, fence);
+        if (inFence || fence)
+            return line;
+        if (THEMATIC_BREAK.test(line))
+            return HORIZONTAL_RULE;
+        return line.replace(SUBHEADING, '#');
+    })
+        .join('\n');
+}
+/** Куски текста до пустой строки вне ```/~~~ блоков включительно; join('') возвращает текст. */
+function splitAtBlankLines(text) {
+    const blocks = [];
+    let block = '';
+    let fence;
+    for (const line of text.split(/(?<=\n)/)) {
+        block += line;
+        fence = fenceAfter(line, fence);
+        if (!fence && !line.trim()) {
+            blocks.push(block);
+            block = '';
+        }
+    }
+    return block ? [...blocks, block] : blocks;
+}
+/** auto: каждая таблица по ширине — узкая моноширинным блоком, широкая пунктами. */
+function convertTablesAuto(text) {
+    const modes = autoTableModes(text);
+    if (modes.size < 2) {
+        const [mode] = modes;
+        return mode ? convertMarkdownTables(text, mode) : text;
+    }
+    // convertMarkdownTables задаёт один режим на весь текст, поэтому разные
+    // таблицы конвертируются по кускам между пустыми строками: пустая строка
+    // таблицу завершает. Таблицу, которую кусок без контекста не распознал
+    // (глубоко вложенный список), добирает последний проход пунктами — готовые
+    // блоки и пункты он не трогает.
+    const converted = splitAtBlankLines(text)
+        .map((block) => convertMarkdownTables(block, autoTableModes(block).has('bullets') ? 'bullets' : 'code'))
+        .join('');
+    return convertMarkdownTables(converted, 'bullets');
+}
+/** Инлайн-замены сегмента вне кода и URL: <u>…</u> → ++…++, ==…== → ^^…^^. */
 function convertSegment(text) {
-    return text.replace(/<u>([\s\S]*?)<\/u>/gi, '++$1++');
+    return text.replace(/<u>([\s\S]*?)<\/u>/gi, '++$1++').replace(HIGHLIGHT, '^^$1^^');
 }
 /**
  * Конвертирует OpenClaw/стандартный markdown в MAX markdown, не затрагивая
- * содержимое inline-кода, fenced-блоков и URL.
+ * содержимое inline-кода, fenced-блоков и URL. Таблицы конвертируются, только
+ * если передан `tableMode` (режим аккаунта, resolveMaxTableMode).
  */
-export function toMaxMarkdown(text) {
+export function toMaxMarkdown(text, options = {}) {
     if (!text)
         return text;
+    const { tableMode } = options;
+    const withTables = tableMode === 'auto'
+        ? convertTablesAuto(text)
+        : tableMode && tableMode !== 'off'
+            ? convertMarkdownTables(text, tableMode === 'block' ? 'code' : tableMode)
+            : text;
     // split с захватывающей группой: нечётные индексы — код/URL (не трогаем)
-    return text
+    return convertBlocks(withTables)
         .split(CODE_OR_URL)
         .map((segment, index) => (index % 2 === 0 ? convertSegment(segment) : segment))
         .join('');