@aspalagin/openclaw-max 0.8.2 → 0.9.2

package/dist/src/json-store-compat.js

@@ -0,0 +1,26 @@
+import { promises as fs } from 'node:fs';
+/**
+ * Local replacement for `readJsonFileWithFallback` from `openclaw/plugin-sdk/json-store`.
+ * OpenClaw 2026.10.5 dropped that export (only `loadJsonFile`, `saveJsonFile` and
+ * `writeJsonFileAtomically` remain), and a missing named export fails ESM linking for
+ * the whole plugin. Semantics match the 2026.9.x helper: a missing file yields the
+ * fallback with `exists: false`; an unreadable or invalid file yields the fallback with
+ * `exists: true`, so callers can warn and start empty.
+ */
+export async function readJsonFileWithFallback(filePath, fallback) {
+    let raw;
+    try {
+        raw = await fs.readFile(filePath, 'utf8');
+    }
+    catch (err) {
+        const code = err?.code;
+        return { value: fallback, exists: code !== 'ENOENT' };
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed == null ? { value: fallback, exists: true } : { value: parsed, exists: true };
+    }
+    catch {
+        return { value: fallback, exists: true };
+    }
+}

package/dist/src/state.js

@@ -9,7 +9,8 @@
  */
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
-import { readJsonFileWithFallback, writeJsonFileAtomically } from 'openclaw/plugin-sdk/json-store';
+import { writeJsonFileAtomically } from 'openclaw/plugin-sdk/json-store';
+import { readJsonFileWithFallback } from './json-store-compat.js';
 import { resolveStateDir } from 'openclaw/plugin-sdk/state-paths';
 export function resolveMaxStatePath(accountId) {
     const safeId = accountId.replace(/[^a-zA-Z0-9_-]/g, '_');

package/dist/src/stream-draft.js

@@ -5,6 +5,7 @@
  * message: a longer final answer is split by the reply delivery, which puts
  * the first chunk into the draft and sends the rest as new messages.
  */
+import { resolveMaxTableMode, toMaxMarkdown } from './format.js';
 import { deleteMaxMessage, editMaxMessage, resolveMaxSendFlags, sendMaxMessage, } from './send.js';
 const DRAFT_THROTTLE_MS = 1200;
 const DRAFT_MAX_CHARS = 4000;
@@ -32,7 +33,11 @@ export function createMaxDraftStream(params) {
     const draftUpdate = async (text) => {
         if (draftStopped || !text)
             return;
-        const trimmed = text.trimEnd();
+        // Formatted like the final answer (deliver.ts), so the final edit compares
+        // and replaces like with like.
+        const trimmed = toMaxMarkdown(text, {
+            tableMode: resolveMaxTableMode(account.config),
+        }).trimEnd();
         if (!trimmed || trimmed === draftLastText)
             return;
         if (trimmed.length > DRAFT_MAX_CHARS) {

package/dist/src/update-journal.js

@@ -18,7 +18,8 @@
  */
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
-import { readJsonFileWithFallback, writeJsonFileAtomically } from 'openclaw/plugin-sdk/json-store';
+import { writeJsonFileAtomically } from 'openclaw/plugin-sdk/json-store';
+import { readJsonFileWithFallback } from './json-store-compat.js';
 import { resolveStateDir } from 'openclaw/plugin-sdk/state-paths';
 /** How long a handled update's key rejects a redelivery (MAX retries within 8 h). */
 export const MAX_JOURNAL_COMPLETED_TTL_MS = 24 * 60 * 60 * 1000;

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-max",
   "name": "MAX",
   "description": "MAX messenger (max.ru) channel for OpenClaw: private and group chats over webhook or long polling; media, voice messages with transcription and voice replies; inline keyboards and command menus; message edits and pins; several bot accounts",
-  "version": "0.8.2",
+  "version": "0.9.2",
   "categories": [
     "channels"
   ],
@@ -69,7 +69,19 @@
                 "type": "boolean"
               },
               "markdown": {
-                "type": "object"
+                "type": "object",
+                "properties": {
+                  "tables": {
+                    "type": "string",
+                    "enum": [
+                      "off",
+                      "bullets",
+                      "code",
+                      "block"
+                    ]
+                  }
+                },
+                "additionalProperties": false
               },
               "botToken": {
                 "anyOf": [
@@ -798,8 +810,8 @@
           "help": "false at channel level disables all accounts; in an account, disables that account."
         },
         "markdown": {
-          "label": "Markdown (no effect)",
-          "help": "Accepted for compatibility with the common channel config; has no effect in MAX.",
+          "label": "Markdown tables",
+          "help": "markdown.tables: how tables in agent replies are sent (MAX has no native tables). Not set: by width, a table up to 36 monospace columns as a monospace block, a wider one as bullets. bullets: one bullet per cell under the bold row label; code: monospace block; block: same as code; off: raw Markdown.",
           "advanced": true
         },
         "botToken": {
@@ -1022,8 +1034,8 @@
           "help": "false disables this account; a channel switched off switches off every account."
         },
         "accounts.*.markdown": {
-          "label": "Markdown (no effect)",
-          "help": "Accepted for compatibility with the common channel config; has no effect in MAX.",
+          "label": "Markdown tables",
+          "help": "markdown.tables for this bot (off, bullets, code, block); inherits the channel value.",
           "advanced": true
         },
         "accounts.*.botToken": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aspalagin/openclaw-max",
-  "version": "0.8.2",
+  "version": "0.9.2",
   "description": "MAX messenger (max.ru) channel for OpenClaw: private and group chats over webhook or long polling; media, voice messages with transcription and voice replies; inline keyboards and command menus; message edits and pins; several bot accounts",
   "keywords": [
     "openclaw",

package/src/accounts.ts

@@ -10,6 +10,7 @@ import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from 'openclaw/plugin-sdk/core
 import { resolveSecretInputString } from 'openclaw/plugin-sdk/secret-input';
 import { canResolveEnvSecretRefInReadOnlyPath } from 'openclaw/plugin-sdk/secret-ref-readonly';
 
+import type { MaxMarkdownTableMode } from './format.js';
 import {
   bindMaxNetwork,
   type MaxNetwork,
@@ -23,6 +24,8 @@ export interface MaxAccountConfig {
   botToken?: string;
   tokenFile?: string;
   name?: string;
+  /** markdown.tables: tables of agent replies (format.ts; default bullets) */
+  markdown?: { tables?: MaxMarkdownTableMode };
   dmPolicy?: string;
   allowFrom?: Array<string | number>;
   groups?: Record<
@@ -313,6 +316,7 @@ export function readMaxAccount(params: {
       botToken: section.botToken as string | undefined,
       tokenFile: section.tokenFile as string | undefined,
       name: section.name as string | undefined,
+      markdown: section.markdown as MaxAccountConfig['markdown'],
       dmPolicy: section.dmPolicy as string | undefined,
       allowFrom: section.allowFrom as Array<string | number> | undefined,
       groups: section.groups as MaxAccountConfig['groups'],

package/src/actions.ts

@@ -15,6 +15,7 @@ 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,
@@ -345,6 +346,9 @@ export const maxMessageActions: ChannelMessageActionAdapter = {
     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: string) =>
+      toMaxMarkdown(text, { tableMode: resolveMaxTableMode(account.config) });
 
     // Strip provider prefix from target (e.g. "max:123456789" → "123456789")
     const stripPrefix = (val: string | undefined): string | undefined => {
@@ -360,11 +364,12 @@ export const maxMessageActions: ChannelMessageActionAdapter = {
       });
       const presentation = normalizeMessagePresentation(params.presentation);
       const pin = readMaxDeliveryPin(params.delivery, params.pin);
-      const content =
+      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.
@@ -410,7 +415,7 @@ export const maxMessageActions: ChannelMessageActionAdapter = {
       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
@@ -518,7 +523,7 @@ export const maxMessageActions: ChannelMessageActionAdapter = {
         required: true,
         allowEmpty: true,
       });
-      await editMaxMessage(messageId, text, {
+      await editMaxMessage(messageId, formatText(text), {
         token: account.token,
         format: 'markdown',
       });
@@ -588,8 +593,9 @@ export const maxMessageActions: ChannelMessageActionAdapter = {
       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;

package/src/channel-agent-prompt.ts

@@ -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.
  */
 
 import type { ChannelPlugin } from 'openclaw/plugin-sdk/channel-core';
@@ -19,6 +19,7 @@ export const maxAgentPromptAdapter: NonNullable<MaxChannelPlugin['agentPrompt']>
       '😂: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/src/channel-directory.ts

@@ -7,6 +7,7 @@ import type { ChannelPlugin } from 'openclaw/plugin-sdk/channel-core';
 
 import { type ResolvedMaxAccount, resolveMaxAccount } from './accounts.js';
 import { MaxApi } from './api.js';
+import { MAX_DECLARED_TABLE_MODE } from './format.js';
 import { loadMaxAccountState } from './state.js';
 
 type MaxChannelPlugin = ChannelPlugin<ResolvedMaxAccount>;
@@ -33,6 +34,10 @@ export const maxMessagingAdapter: NonNullable<MaxChannelPlugin['messaging']> = {
     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. */

package/src/channel-outbound.ts

@@ -8,6 +8,7 @@ import type { OpenClawConfig } from 'openclaw/plugin-sdk/core';
 import { getAgentScopedMediaLocalRoots } from 'openclaw/plugin-sdk/media-local-roots';
 
 import { type ResolvedMaxAccount, resolveMaxAccount } from './accounts.js';
+import { resolveMaxTableMode, toMaxMarkdown } from './format.js';
 import {
   materializeMaxPresentation,
   MAX_PRESENTATION_CAPABILITIES,
@@ -28,6 +29,11 @@ import {
 
 type MaxChannelPlugin = ChannelPlugin<ResolvedMaxAccount>;
 
+/** MAX dialect and tables of the account (markdown.tables); see format.ts. */
+function formatMaxText(text: string, account: ResolvedMaxAccount): string {
+  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
@@ -55,6 +61,12 @@ export const maxOutboundAdapter: NonNullable<MaxChannelPlugin['outbound']> = {
     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
@@ -86,7 +98,10 @@ export const maxOutboundAdapter: NonNullable<MaxChannelPlugin['outbound']> = {
     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,
@@ -149,7 +164,7 @@ export const maxOutboundAdapter: NonNullable<MaxChannelPlugin['outbound']> = {
     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',
@@ -163,11 +178,12 @@ export const maxOutboundAdapter: NonNullable<MaxChannelPlugin['outbound']> = {
   },
 
   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

package/src/config-schema.ts

@@ -84,7 +84,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/src/deliver.ts

@@ -13,6 +13,7 @@ import { LocalMediaAccessError } from 'openclaw/plugin-sdk/web-media';
 
 import type { ResolvedMaxAccount } from './accounts.js';
 import { MaxApiError } from './api.js';
+import { resolveMaxTableMode, toMaxMarkdown } from './format.js';
 import { readMaxDeliveryPin, resolveMaxTextChunkLimit } from './presentation.js';
 import { getMaxRuntime } from './runtime.js';
 import {
@@ -109,6 +110,11 @@ export async function deliverMaxReply(params: {
 }): Promise<void> {
   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 });
@@ -142,13 +148,13 @@ export async function deliverMaxReply(params: {
   if (answersCallback) {
     if (params.callbackState) params.callbackState.answered = true;
     try {
-      await answerMaxCallback(params.callbackId as string, payload.text ?? '', {
+      await answerMaxCallback(params.callbackId as string, 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: unknown) {
       // Like a failed text chunk: the media still goes, then reject.
@@ -182,10 +188,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];

package/src/format.ts

@@ -1,32 +1,215 @@
 /**
  * Конвертер форматирования 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';
+
+/** channels.max.markdown.tables (и accounts.<id>.markdown.tables). */
+export type MaxMarkdownTableMode = 'off' | 'bullets' | 'code' | 'block';
+
+/** Режим таблиц для toMaxMarkdown: auto — markdown.tables не задан, режим по ширине таблицы. */
+export type MaxTableMode = Exclude<MaxMarkdownTableMode, 'block'> | 'auto';
+
+/**
+ * Умолчание, которое видит ядро (messaging.defaultMarkdownTableMode). Режима
+ * «по ширине» в MarkdownTableMode ядра нет, а ядро по этому значению решает
+ * две вещи: добавлять ли в групповой промпт «Avoid Markdown tables» (да для
+ * всего, кроме block/off) и что вернёт resolveMarkdownTableMode для MAX без
+ * конфига. bullets: подсказка остаётся — нативных таблиц в MAX нет, широкая
+ * таблица в группе станет длинным списком; а если кто-то сконвертирует текст
+ * для MAX по этому ответу, пункты не развалятся на телефоне. block солгал бы
+ * ядру о нативных таблицах, off — о сырых.
+ */
+export const MAX_DECLARED_TABLE_MODE: MaxMarkdownTableMode = '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?: {
+  markdown?: { tables?: MaxMarkdownTableMode };
+}): MaxTableMode {
+  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: string): number {
+  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: string[], rows: string[][]): number {
+  const widths: number[] = [];
+  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: string): Set<'code' | 'bullets'> {
+  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: string, fence: string | undefined): string | undefined {
+  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: string): string {
+  let fence: string | undefined;
+  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: string): string[] {
+  const blocks: string[] = [];
+  let block = '';
+  let fence: string | undefined;
+  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: string): string {
+  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: string): string {
-  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: string): string {
+export function toMaxMarkdown(
+  text: string,
+  options: { tableMode?: MaxMarkdownTableMode | 'auto' } = {},
+): string {
   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('');

package/src/json-store-compat.ts

@@ -0,0 +1,28 @@
+import { promises as fs } from 'node:fs';
+
+/**
+ * Local replacement for `readJsonFileWithFallback` from `openclaw/plugin-sdk/json-store`.
+ * OpenClaw 2026.10.5 dropped that export (only `loadJsonFile`, `saveJsonFile` and
+ * `writeJsonFileAtomically` remain), and a missing named export fails ESM linking for
+ * the whole plugin. Semantics match the 2026.9.x helper: a missing file yields the
+ * fallback with `exists: false`; an unreadable or invalid file yields the fallback with
+ * `exists: true`, so callers can warn and start empty.
+ */
+export async function readJsonFileWithFallback<T>(
+  filePath: string,
+  fallback: T,
+): Promise<{ value: T; exists: boolean }> {
+  let raw: string;
+  try {
+    raw = await fs.readFile(filePath, 'utf8');
+  } catch (err) {
+    const code = (err as NodeJS.ErrnoException | undefined)?.code;
+    return { value: fallback, exists: code !== 'ENOENT' };
+  }
+  try {
+    const parsed = JSON.parse(raw) as T | null;
+    return parsed == null ? { value: fallback, exists: true } : { value: parsed, exists: true };
+  } catch {
+    return { value: fallback, exists: true };
+  }
+}