@mrciphersmith/keryx 0.3.62 → 0.3.64

package/dist/cli.js

@@ -9600,6 +9600,9 @@ function renderMetaprojectGitignoreBlock() {
 # entries rather than inheriting coverage that does not exist.
 .metaproject/data/learning/observations/
 .metaproject/data/learning/candidates/
+# Recommendation journal (flow 392): what the human chose and why they deviated.
+# Personal runtime state, written 0o600.
+.metaproject/data/decisions/
 `;
 }
 function escapeRegExp2(value) {
@@ -20104,7 +20107,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@mrciphersmith/keryx",
-    version: "0.3.62",
+    version: "0.3.64",
     description: "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
     private: false,
     publishConfig: {
@@ -30909,6 +30912,9 @@ function summarizeSubmittedLine(line) {
 function isZeroWidth(cp) {
   return cp >= 768 && cp <= 879 || cp >= 8203 && cp <= 8207 || cp >= 65024 && cp <= 65039 || cp >= 8288 && cp <= 8292;
 }
+function isEmojiModifier(cp) {
+  return cp >= 127995 && cp <= 127999;
+}
 function codePointWidth(cp) {
   for (const [lo, hi] of WIDE_RANGES) {
     if (cp >= lo && cp <= hi) {
@@ -30919,11 +30925,17 @@ function codePointWidth(cp) {
 }
 function visualWidth(text) {
   let width = 0;
+  let previous = 0;
   for (const ch of text) {
     const codePoint = ch.codePointAt(0) ?? 0;
+    const joined = previous === ZERO_WIDTH_JOINER;
+    previous = codePoint;
     if (isZeroWidth(codePoint)) {
       continue;
     }
+    if (joined && codePointWidth(codePoint) === 2 || isEmojiModifier(codePoint)) {
+      continue;
+    }
     width += codePointWidth(codePoint);
   }
   return width;
@@ -30936,7 +30948,7 @@ function hugWidth(text, chrome) {
   }
   return widest + chrome;
 }
-var FENCE_LINE, HUNK_HEADER, MARKDOWN_LANGS, DIFF_LANGS, CODE_LANG_ALIASES, GENERIC_KEYWORDS, CODE_LANG_KEYWORDS, CODE_WORD_OR_NUMBER, WIDE_RANGES;
+var FENCE_LINE, HUNK_HEADER, MARKDOWN_LANGS, DIFF_LANGS, CODE_LANG_ALIASES, GENERIC_KEYWORDS, CODE_LANG_KEYWORDS, CODE_WORD_OR_NUMBER, WIDE_RANGES, ZERO_WIDTH_JOINER = 8205;
 var init_md_blocks = __esm(() => {
   FENCE_LINE = /^[ \t]{0,3}(```|~~~)(.*)\r?$/;
   HUNK_HEADER = /^@@ -\d+(?:,\d+)? \+\d+(?:,\d+)? @@/;
@@ -31184,8 +31196,48 @@ var init_md_blocks = __esm(() => {
     [65072, 65135],
     [65280, 65376],
     [65504, 65510],
+    [8986, 8987],
+    [9193, 9196],
+    [9200, 9200],
+    [9203, 9203],
+    [9725, 9726],
+    [9748, 9749],
+    [9800, 9811],
+    [9855, 9855],
+    [9875, 9875],
+    [9889, 9889],
+    [9898, 9899],
+    [9917, 9918],
+    [9924, 9925],
+    [9934, 9934],
+    [9940, 9940],
+    [9962, 9962],
+    [9970, 9971],
+    [9973, 9973],
+    [9978, 9978],
+    [9981, 9981],
+    [9989, 9989],
+    [9994, 9995],
+    [10024, 10024],
+    [10060, 10060],
+    [10062, 10062],
+    [10067, 10069],
+    [10071, 10071],
+    [10133, 10135],
+    [10160, 10160],
+    [10175, 10175],
+    [11035, 11036],
+    [11088, 11088],
+    [11093, 11093],
+    [126980, 126980],
+    [127183, 127183],
+    [127374, 127374],
+    [127377, 127386],
+    [127488, 127743],
     [127744, 128591],
+    [128640, 128767],
     [129280, 129535],
+    [129536, 129791],
     [131072, 262141]
   ];
 });
@@ -100458,6 +100510,264 @@ var init_live_render = __esm(() => {
   ANSI_RE = /\x1b\[[0-9;?]*[A-Za-z]/g;
 });
 
+// src/remote/paths.ts
+import path228 from "path";
+function remoteDirPath(dir) {
+  return path228.join(keryxConfigDir(dir), REMOTE_DIRNAME);
+}
+function ensureRemoteDir(dir, ...sub) {
+  return ensureKeryxSubdir([REMOTE_DIRNAME, ...sub], dir);
+}
+function botTokenPath(dir) {
+  return path228.join(remoteDirPath(dir), BOT_TOKEN_FILE);
+}
+function remoteConfigPath(dir) {
+  return path228.join(remoteDirPath(dir), REMOTE_CONFIG_FILE);
+}
+var REMOTE_DIRNAME = "remote", BOT_TOKEN_FILE = "bot-token", REMOTE_CONFIG_FILE = "config.json", REGISTRY_FILE = "sessions.json", SERVICE_TOPICS_FILE = "service-topics.json", POLLER_STATE_FILE = "poller-state.json", OUTBOUND_FILE = "outbound.jsonl", REJECTED_JOURNAL_FILE = "rejected.jsonl", INBOUND_DIRNAME = "inbound";
+var init_paths4 = __esm(() => {
+  init_config_dir();
+});
+
+// src/remote/rendering-mode.ts
+function isRenderMode(value) {
+  return typeof value === "string" && RENDER_MODES.includes(value);
+}
+var RENDER_MODES, DEFAULT_RENDER_MODE = "auto", RENDER_MODE_CHOICES;
+var init_rendering_mode = __esm(() => {
+  RENDER_MODES = ["auto", "rich", "html", "plain"];
+  RENDER_MODE_CHOICES = `one of ${RENDER_MODES.join(", ")}`;
+});
+
+// src/remote/config.ts
+import { statSync as statSync14, unlinkSync as unlinkSync4 } from "fs";
+function isSafeInt(value) {
+  return typeof value === "number" && Number.isSafeInteger(value);
+}
+function parseRemoteConfig(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return { ok: false, reason: "remote config must be a JSON object" };
+  }
+  const doc = value;
+  for (const key of Object.keys(doc)) {
+    if (!CONFIG_KEYS.has(key)) {
+      const shown = /^[A-Za-z_][A-Za-z0-9_]{0,30}$/.test(key) ? key : "<not shown>";
+      return { ok: false, reason: `remote config has an unknown key "${shown}" (the schema is closed)` };
+    }
+  }
+  if (doc.schemaVersion !== REMOTE_CONFIG_SCHEMA_VERSION) {
+    return { ok: false, reason: `remote config schemaVersion must be ${REMOTE_CONFIG_SCHEMA_VERSION}` };
+  }
+  if (!isSafeInt(doc.chatId) || doc.chatId === 0) {
+    return { ok: false, reason: "remote config chatId must be a non-zero integer (the supergroup id)" };
+  }
+  const ids = doc.allowedUserIds;
+  if (!Array.isArray(ids) || ids.length === 0 || !ids.every((id) => isSafeInt(id) && id > 0)) {
+    return { ok: false, reason: "remote config allowedUserIds must be a non-empty array of positive integers" };
+  }
+  const timeout = (key, fallback) => {
+    const raw = doc[key];
+    if (raw === undefined) {
+      return { ok: true, value: fallback };
+    }
+    if (!isSafeInt(raw) || raw < 1 || raw > MAX_TIMEOUT_MS3) {
+      return { ok: false, reason: `remote config ${key} must be an integer from 1 to ${MAX_TIMEOUT_MS3} (milliseconds)` };
+    }
+    return { ok: true, value: raw };
+  };
+  const orphan = timeout("orphanMs", DEFAULT_ORPHAN_MS);
+  if (!orphan.ok) {
+    return orphan;
+  }
+  const run = timeout("runTimeoutMs", DEFAULT_RUN_TIMEOUT_MS);
+  if (!run.ok) {
+    return run;
+  }
+  if (doc.rendering !== undefined && !isRenderMode(doc.rendering)) {
+    return { ok: false, reason: `remote config rendering must be ${RENDER_MODE_CHOICES}` };
+  }
+  return {
+    ok: true,
+    value: {
+      schemaVersion: REMOTE_CONFIG_SCHEMA_VERSION,
+      chatId: doc.chatId,
+      allowedUserIds: [...new Set(ids)],
+      orphanMs: orphan.value,
+      runTimeoutMs: run.value,
+      ...doc.rendering === undefined ? {} : { rendering: doc.rendering }
+    }
+  };
+}
+function loadRemoteConfig(dir) {
+  const file = remoteConfigPath(dir);
+  const read = readConfigFile(file);
+  if (!read.ok) {
+    return {
+      ok: false,
+      reason: read.reason === "absent" ? `no remote-control config at ${file}; create it with chatId and allowedUserIds` : `remote-control config at ${file} cannot be read (${read.reason})`
+    };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(read.text);
+  } catch {
+    return { ok: false, reason: `remote-control config at ${file} is not valid JSON` };
+  }
+  return parseRemoteConfig(parsed);
+}
+function saveRemoteConfig(config, dir) {
+  const checked = parseRemoteConfig(config);
+  if (!checked.ok) {
+    return checked;
+  }
+  ensureRemoteDir(dir);
+  writeOwnerOnlyFileAtomic(remoteConfigPath(dir), `${JSON.stringify(checked.value, null, 2)}
+`);
+  return checked;
+}
+function loadBotToken(dir) {
+  const file = botTokenPath(dir);
+  let mode;
+  try {
+    const stats = statSync14(file);
+    if (!stats.isFile()) {
+      return { ok: false, reason: `bot token path ${file} is not a regular file` };
+    }
+    mode = stats.mode & 511;
+  } catch {
+    return {
+      ok: false,
+      reason: `no bot token file at ${file}; put the token on one line in it and run: chmod 600 ${file}`
+    };
+  }
+  if (process.platform !== "win32" && (mode & 63) !== 0) {
+    return {
+      ok: false,
+      reason: `bot token file ${file} is accessible to other users (mode ${mode.toString(8)}); run: chmod 600 ${file}`
+    };
+  }
+  const read = readConfigFile(file);
+  if (!read.ok) {
+    return { ok: false, reason: `bot token file ${file} cannot be read (${read.reason})` };
+  }
+  const token = read.text.trim();
+  if (!TOKEN_SHAPE.test(token)) {
+    return {
+      ok: false,
+      reason: `bot token file ${file} does not hold a bot token (expected <digits>:<secret> on a single line)`
+    };
+  }
+  return { ok: true, value: token };
+}
+function saveBotToken(token, dir) {
+  const trimmed = token.trim();
+  if (!TOKEN_SHAPE.test(trimmed)) {
+    return { ok: false, reason: "that does not look like a bot token (expected <digits>:<secret>, as BotFather gives it)" };
+  }
+  const file = botTokenPath(dir);
+  try {
+    ensureRemoteDir(dir);
+    writeOwnerOnlyFileAtomic(file, `${trimmed}
+`);
+  } catch {
+    return { ok: false, reason: `could not write the bot token file at ${file}` };
+  }
+  return { ok: true, value: true };
+}
+function removeFile2(file) {
+  try {
+    unlinkSync4(file);
+    return true;
+  } catch (error) {
+    return error.code === "ENOENT";
+  }
+}
+function removeBotToken(dir) {
+  return removeFile2(botTokenPath(dir));
+}
+function removeRemoteConfig(dir) {
+  return removeFile2(remoteConfigPath(dir));
+}
+var REMOTE_CONFIG_SCHEMA_VERSION = 1, DEFAULT_ORPHAN_MS, DEFAULT_RUN_TIMEOUT_MS, MAX_TIMEOUT_MS3, CONFIG_KEYS, TOKEN_SHAPE;
+var init_config11 = __esm(() => {
+  init_config_dir();
+  init_paths4();
+  init_rendering_mode();
+  DEFAULT_ORPHAN_MS = 10 * 60000;
+  DEFAULT_RUN_TIMEOUT_MS = 30 * 60000;
+  MAX_TIMEOUT_MS3 = 7 * 24 * 60 * 60000;
+  CONFIG_KEYS = new Set(["schemaVersion", "chatId", "allowedUserIds", "orphanMs", "runTimeoutMs", "rendering"]);
+  TOKEN_SHAPE = /^\d{5,}:[A-Za-z0-9_-]{20,}$/;
+});
+
+// src/remote/rendering-config.ts
+function readRenderingSetting(dir) {
+  const loaded = loadRemoteConfig(dir);
+  if (!loaded.ok) {
+    return { mode: DEFAULT_RENDER_MODE, source: "default", saveable: false };
+  }
+  const mode = loaded.value.rendering;
+  return mode === undefined ? { mode: DEFAULT_RENDER_MODE, source: "default", saveable: true } : { mode, source: "config", saveable: true };
+}
+function writeRenderingMode(raw, dir) {
+  const wanted = raw.trim().toLowerCase();
+  if (!isRenderMode(wanted)) {
+    return { ok: false, reason: `rendering must be ${RENDER_MODE_CHOICES}` };
+  }
+  const loaded = loadRemoteConfig(dir);
+  if (!loaded.ok) {
+    return { ok: false, reason: `remote control is not set up on this machine, so the mode cannot be saved yet (${loaded.reason})` };
+  }
+  const saved = saveRemoteConfig({ ...loaded.value, rendering: wanted }, dir);
+  return saved.ok ? { ok: true, value: wanted } : saved;
+}
+var init_rendering_config = __esm(() => {
+  init_config11();
+  init_rendering_mode();
+});
+
+// src/tui/rendering-command.ts
+function isRenderingCommand(line) {
+  const token = line.trim().split(/\s+/)[0] ?? "";
+  return token === RENDERING_COMMAND;
+}
+function runRenderingCommand(argText, dir) {
+  const arg = argText.trim();
+  try {
+    if (arg.length > 0) {
+      const saved = writeRenderingMode(arg, dir);
+      return saved.ok ? `Telegram rendering: ${saved.value} (${RENDERING_MEANING[saved.value]}). Saved; it applies to the next message.
+` : `${RENDERING_COMMAND}: ${saved.reason}
+`;
+    }
+    const current = readRenderingSetting(dir);
+    const where = current.source === "config" ? "saved in the remote config" : current.saveable ? `default (${DEFAULT_RENDER_MODE})` : "default, remote control is not set up yet";
+    return [
+      `Telegram rendering: ${current.mode} (${where})`,
+      ...RENDER_MODES.map((mode) => `  ${mode === current.mode ? "*" : " "} ${mode}: ${RENDERING_MEANING[mode]}`),
+      RENDERING_FALLBACK_NOTE,
+      `Usage: ${RENDERING_COMMAND} [${RENDER_MODES.join("|")}]`,
+      ""
+    ].join(`
+`);
+  } catch (error) {
+    return `${RENDERING_COMMAND}: ${error instanceof Error ? error.message : String(error)}
+`;
+  }
+}
+var RENDERING_COMMAND = "/rendering", RENDERING_SUMMARY, RENDERING_MEANING, RENDERING_FALLBACK_NOTE = "Whatever the mode, a refused message is resent once one step down: rich, then HTML, then plain text.";
+var init_rendering_command = __esm(() => {
+  init_rendering_config();
+  init_rendering_mode();
+  RENDERING_SUMMARY = `How Telegram replies are written: ${RENDERING_COMMAND} [${RENDER_MODES.join("|")}]`;
+  RENDERING_MEANING = {
+    auto: "a reply with a table goes as a rich message, any other reply as HTML",
+    rich: "every reply goes as a rich message",
+    html: "every reply goes as Telegram HTML",
+    plain: "every reply goes as plain text, a table as aligned lines"
+  };
+});
+
 // src/tui/reasoning-display.ts
 function parseThinkDisplayMode(raw) {
   if (raw === undefined) {
@@ -100517,7 +100827,7 @@ var init_reasoning_display = __esm(() => {
 });
 
 // src/tui/debug-log.ts
-import path228 from "path";
+import path229 from "path";
 function isDebugEnabled() {
   return activeRun !== undefined;
 }
@@ -100545,11 +100855,11 @@ function startDebugRun(opts = {}) {
   const dir = ensureKeryxSubdir(["debug", name], opts.configDir);
   const run = {
     dir,
-    shellLog: path228.join(dir, "shell.ndjson"),
-    watcherLog: path228.join(dir, "watcher.ndjson")
+    shellLog: path229.join(dir, "shell.ndjson"),
+    watcherLog: path229.join(dir, "watcher.ndjson")
   };
   try {
-    writeOwnerOnlyFile(path228.join(path228.dirname(dir), "latest.txt"), `${dir}
+    writeOwnerOnlyFile(path229.join(path229.dirname(dir), "latest.txt"), `${dir}
 `);
   } catch {}
   activeRun = run;
@@ -100615,7 +100925,7 @@ var init_debug_log = __esm(() => {
 
 // src/tui/theme.ts
 import { existsSync as existsSync39 } from "fs";
-import path229 from "path";
+import path230 from "path";
 function hexChannels(hex) {
   return [1, 3, 5].map((offset) => Number.parseInt(hex.slice(offset, offset + 2), 16));
 }
@@ -100753,7 +101063,7 @@ function onThemeChange(listener) {
   };
 }
 function tuiConfigPath(dir) {
-  return path229.join(keryxConfigDir(dir), "tui.json");
+  return path230.join(keryxConfigDir(dir), "tui.json");
 }
 function loadPersistedThemeId(dir) {
   try {
@@ -101149,6 +101459,17 @@ function buildSettingsRows(state) {
       usage: "/external-agents [on|off]",
       actions: toggleActions("/external-agents", state.externalAgents.on)
     },
+    {
+      id: "rendering",
+      group: "External",
+      label: "Telegram rendering",
+      value: state.rendering.mode,
+      scope: "saved",
+      ...state.rendering.saveable ? {} : { detail: "remote control is not set up yet" },
+      command: "/rendering",
+      usage: `/rendering [${RENDER_MODES.join("|")}]`,
+      actions: RENDER_MODES.map((mode) => action(mode, `/rendering ${mode}`, mode === state.rendering.mode))
+    },
     {
       id: "jevprofile",
       group: "External",
@@ -101187,6 +101508,7 @@ var SETTING_GROUPS, onOff = (value) => value ? "on" : "off", EXTERNAL_PRIVACY_DE
 var init_settings_model = __esm(() => {
   init_agent();
   init_permission_mode();
+  init_rendering_mode();
   init_reasoning_display();
   init_theme();
   SETTING_GROUPS = ["Safety", "Routing", "Display", "External"];
@@ -101306,7 +101628,7 @@ var init_jev_profile = __esm(() => {
 
 // src/commands/review-jev-profile.ts
 import { readFile as readFile106 } from "fs/promises";
-import path230 from "path";
+import path231 from "path";
 function rejectUnknownJevProfileFlags(args) {
   const unknown = args.filter((arg) => arg.startsWith("--") && !JEV_PROFILE_FLAGS.includes(arg.split("=")[0]));
   if (unknown.length > 0) {
@@ -101315,7 +101637,7 @@ function rejectUnknownJevProfileFlags(args) {
 }
 async function readRawConfig(cwd) {
   try {
-    return JSON.parse(await readFile106(path230.join(cwd, REVIEW_GATE_CONFIG_PATH), "utf8"));
+    return JSON.parse(await readFile106(path231.join(cwd, REVIEW_GATE_CONFIG_PATH), "utf8"));
   } catch {
     return;
   }
@@ -101339,7 +101661,7 @@ async function runJevProfile(args) {
     return;
   }
   const merged = mergeRecommendedJevProfile(raw);
-  await writeFileAtomic(path230.join(cwd, REVIEW_GATE_CONFIG_PATH), `${JSON.stringify(merged, null, 2)}
+  await writeFileAtomic(path231.join(cwd, REVIEW_GATE_CONFIG_PATH), `${JSON.stringify(merged, null, 2)}
 `);
   const current = currentJevProfile(merged);
   if (args.includes("--json")) {
@@ -101354,13 +101676,13 @@ async function readJevProfileForShell(cwd) {
 async function toggleJevProfileKeyForShell(cwd, key) {
   const raw = await readRawConfig(cwd);
   const merged = toggleJevProfileKey(raw, key);
-  await writeFileAtomic(path230.join(cwd, REVIEW_GATE_CONFIG_PATH), `${JSON.stringify(merged, null, 2)}
+  await writeFileAtomic(path231.join(cwd, REVIEW_GATE_CONFIG_PATH), `${JSON.stringify(merged, null, 2)}
 `);
 }
 async function applyRecommendedJevProfileForShell(cwd) {
   const raw = await readRawConfig(cwd);
   const merged = mergeRecommendedJevProfile(raw);
-  await writeFileAtomic(path230.join(cwd, REVIEW_GATE_CONFIG_PATH), `${JSON.stringify(merged, null, 2)}
+  await writeFileAtomic(path231.join(cwd, REVIEW_GATE_CONFIG_PATH), `${JSON.stringify(merged, null, 2)}
 `);
 }
 var JEV_PROFILE_FLAGS;
@@ -101382,14 +101704,14 @@ import {
   openSync as openSync4,
   realpathSync as realpathSync16,
   renameSync as renameSync4,
-  statSync as statSync14,
-  unlinkSync as unlinkSync4,
+  statSync as statSync15,
+  unlinkSync as unlinkSync5,
   writeFileSync as writeFileSync7
 } from "fs";
-import path231 from "path";
+import path232 from "path";
 import { randomUUID as randomUUID28 } from "crypto";
 function projectRegistryPath(dir) {
-  return path231.join(keryxConfigDir(dir), "projects.json");
+  return path232.join(keryxConfigDir(dir), "projects.json");
 }
 function withRegistryLock(dir, fn, onWaiting) {
   return withFileLock2(`${projectRegistryPath(dir)}.lock`, fn, {
@@ -101405,7 +101727,7 @@ function validEntry(candidate) {
   return typeof entry.path === "string" && entry.path.length > 0 && typeof entry.projectId === "string" && entry.projectId.length > 0 && typeof entry.displayName === "string" && (entry.state === "active" || entry.state === "missing") && typeof entry.registeredAt === "string";
 }
 function projectIdentity(projectPath) {
-  const absolute = path231.resolve(projectPath);
+  const absolute = path232.resolve(projectPath);
   try {
     return realpathSync16.native(absolute);
   } catch {
@@ -101521,7 +101843,7 @@ function saveProjectRegistry(registry, dir, onWarn) {
     return true;
   } catch {
     try {
-      unlinkSync4(temp);
+      unlinkSync5(temp);
     } catch {}
     return false;
   }
@@ -101560,7 +101882,7 @@ function registerProject(projectPath, options = {}) {
     const entry = {
       projectId: randomUUID28(),
       path: absolute,
-      displayName: options.displayName ?? path231.basename(absolute),
+      displayName: options.displayName ?? path232.basename(absolute),
       state: "active",
       registeredAt: now,
       lastSeenAt: now
@@ -101597,7 +101919,7 @@ function forgetProject(projectId, dir, onWarn) {
   return outcome ?? "write-failed";
 }
 function isInitializedProject(projectPath) {
-  return statSync14(path231.join(projectPath, ".metaproject"), { throwIfNoEntry: false })?.isDirectory() === true;
+  return statSync15(path232.join(projectPath, ".metaproject"), { throwIfNoEntry: false })?.isDirectory() === true;
 }
 function listProjects(dir, onWarn) {
   const registry = loadProjectRegistry(dir, onWarn);
@@ -101651,9 +101973,9 @@ var init_project_registry = __esm(() => {
 });
 
 // src/lib/permission-mode-config.ts
-import path232 from "path";
+import path233 from "path";
 function permissionModeConfigPath(dir) {
-  return path232.join(keryxConfigDir(dir), "permission-mode.json");
+  return path233.join(keryxConfigDir(dir), "permission-mode.json");
 }
 function withRegistryLock2(dir, fn) {
   return withFileLock2(`${permissionModeConfigPath(dir)}.lock`, fn, {
@@ -101760,10 +102082,10 @@ var init_jev_edit_guard = __esm(() => {
 
 // src/review/jev-edit-guard-config.ts
 import { readFile as readFile107 } from "fs/promises";
-import path233 from "path";
+import path234 from "path";
 async function readReviewJevBlock(cwd) {
   try {
-    const parsed = JSON.parse(await readFile107(path233.join(cwd, REVIEW_GATE_CONFIG_PATH), "utf8"));
+    const parsed = JSON.parse(await readFile107(path234.join(cwd, REVIEW_GATE_CONFIG_PATH), "utf8"));
     if (typeof parsed !== "object" || parsed === null)
       return;
     const review = parsed["review"];
@@ -101808,7 +102130,7 @@ async function readJevEditGuardConfig(cwd, opts) {
   return { enabled, threshold, maxCalls };
 }
 async function writeJevEditGuardEnabled(cwd, enabled) {
-  const file = path233.join(cwd, REVIEW_GATE_CONFIG_PATH);
+  const file = path234.join(cwd, REVIEW_GATE_CONFIG_PATH);
   let root = {};
   if (await pathExists(file)) {
     try {
@@ -101842,6 +102164,14 @@ function readReasoning2(sessionOverride, globalEffort) {
   const afterRestart = describeReasoningEffortSource({ globalEffort });
   return resolved.source === "session" && afterRestart.source === "env" ? { ...resolved, envWinsOnRestart: true } : resolved;
 }
+function readRendering(dir) {
+  try {
+    const { mode, saveable } = readRenderingSetting(dir);
+    return { mode, saveable };
+  } catch {
+    return { mode: DEFAULT_RENDER_MODE, saveable: false };
+  }
+}
 async function orElse(read, fallback) {
   try {
     return await read();
@@ -101873,7 +102203,8 @@ async function loadSettingsSnapshot(cwd, live, configDir) {
       on: RECOMMENDED_JEV_PROFILE.filter((entry) => jevProfile[entry.key] === true).length,
       total: RECOMMENDED_JEV_PROFILE.length
     },
-    externalAgents: agents.ok ? { on: true } : { on: false, reason: agents.reason }
+    externalAgents: agents.ok ? { on: true } : { on: false, reason: agents.reason },
+    rendering: readRendering(configDir)
   };
 }
 var init_settings_state = __esm(() => {
@@ -101883,6 +102214,8 @@ var init_settings_state = __esm(() => {
   init_external_switch();
   init_permission_mode_config();
   init_shell_config();
+  init_rendering_config();
+  init_rendering_mode();
   init_jev_edit_guard_config();
   init_jev_profile();
   init_reasoning_display();
@@ -101938,7 +102271,7 @@ class NextStepSuggestionGate {
 var NEXT_STEP_SUGGESTION_MAX_LENGTH = 80, NEXT_STEP_SUGGESTION_MAX_WORDS = 20, NEXT_STEP_SUGGESTION_TIMEOUT_MS = 8000, NEXT_STEP_USER_TAIL = 800, NEXT_STEP_ASSISTANT_TAIL = 3000, NEXT_STEP_SYSTEM_PROMPT = "You are the next-step advisor of a coding assistant terminal. Based on the user's last request and the assistant's final reply, propose ONE short follow-up the user could do next: imperative, no quotes, no markdown, at most 80 characters. If nothing useful exists, reply with exactly one dot: .";
 
 // src/lib/version-check.ts
-import path234 from "path";
+import path235 from "path";
 function formatVersionUpdateAdvisory(result) {
   if (result.status !== "update-available")
     return;
@@ -102125,7 +102458,7 @@ async function checkVersion(options) {
   const now = options.now ?? Date.now;
   const timestamp = now();
   const configDir = ensureKeryxConfigDir(options.cacheDir);
-  const cacheFile = path234.join(configDir, "version-check.json");
+  const cacheFile = path235.join(configDir, "version-check.json");
   const cache = parseCache(cacheFile);
   if (cache?.latestVersion !== undefined && cache.successAt !== undefined && timestamp - cache.successAt >= 0 && timestamp - cache.successAt < SUCCESS_CACHE_TTL_MS) {
     return resultFor(options.currentVersion, current, cache.latestVersion, "cache");
@@ -102453,7 +102786,7 @@ var init_schemas2 = __esm(() => {
 var init_types7 = () => {};
 
 // src/standard/profiles.ts
-import path235 from "path";
+import path236 from "path";
 import { readFile as readFile108 } from "fs/promises";
 function namedEntrypoints(manifest) {
   const agentEntrypoints = manifest.agentEntrypoints;
@@ -102491,7 +102824,7 @@ function enabledModuleKeys(manifest) {
 }
 async function rootEntrypointLinksIndex(cwd, manifest) {
   for (const { path: name } of namedEntrypoints(manifest)) {
-    const filePath = path235.join(cwd, name);
+    const filePath = path236.join(cwd, name);
     if (!await pathExists(filePath)) {
       continue;
     }
@@ -102503,16 +102836,16 @@ async function rootEntrypointLinksIndex(cwd, manifest) {
   return false;
 }
 async function minimalSatisfied(cwd) {
-  const metaprojectRoot = path235.join(cwd, ".metaproject");
+  const metaprojectRoot = path236.join(cwd, ".metaproject");
   const requiredFiles = ["index.md", "README.md", "metaproject.json"];
   const requiredDirs = ["modules", "rules", "skills", "data"];
   for (const file of requiredFiles) {
-    if (!await pathExists(path235.join(metaprojectRoot, file))) {
+    if (!await pathExists(path236.join(metaprojectRoot, file))) {
       return false;
     }
   }
   for (const dir of requiredDirs) {
-    if (!await pathExists(path235.join(metaprojectRoot, dir))) {
+    if (!await pathExists(path236.join(metaprojectRoot, dir))) {
       return false;
     }
   }
@@ -102525,7 +102858,7 @@ async function ciSatisfied(cwd, manifest) {
     return false;
   }
   for (const key of ciModules) {
-    if (await pathExists(path235.join(cwd, ".metaproject", "data", key, "artifacts"))) {
+    if (await pathExists(path236.join(cwd, ".metaproject", "data", key, "artifacts"))) {
       return true;
     }
   }
@@ -102538,7 +102871,7 @@ async function evaluateProfiles(cwd, manifest) {
     satisfied.push("minimal");
   }
   const hasAgentModule = AGENT_MODULES.some((key) => new Set(enabledModuleKeys(manifest)).has(key));
-  const agent = minimal && hasAgentModule && await rootEntrypointLinksIndex(cwd, manifest) && await pathExists(path235.join(cwd, ".metaproject", "rules"));
+  const agent = minimal && hasAgentModule && await rootEntrypointLinksIndex(cwd, manifest) && await pathExists(path236.join(cwd, ".metaproject", "rules"));
   if (agent) {
     satisfied.push("agent");
   }
@@ -102571,7 +102904,7 @@ var init_profiles2 = __esm(() => {
 });
 
 // src/standard/validate.ts
-import path236 from "path";
+import path237 from "path";
 import { readFile as readFile109 } from "fs/promises";
 function isPlainObject14(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -102700,20 +103033,20 @@ function issue(code, message, fix) {
 async function validateWorkspace2(cwd) {
   const errors = [];
   const warnings = [];
-  const metaprojectRoot = path236.join(cwd, ".metaproject");
+  const metaprojectRoot = path237.join(cwd, ".metaproject");
   const requiredFiles = ["index.md", "README.md", "metaproject.json"];
   for (const file of requiredFiles) {
-    if (!await pathExists(path236.join(metaprojectRoot, file))) {
+    if (!await pathExists(path237.join(metaprojectRoot, file))) {
       errors.push(issue("missing-required-file", `Required file .metaproject/${file} is missing`, `Run \`keryx init\` to scaffold .metaproject/${file}.`));
     }
   }
   const requiredDirs = ["modules", "rules", "skills", "data"];
   for (const dir of requiredDirs) {
-    if (!await pathExists(path236.join(metaprojectRoot, dir))) {
+    if (!await pathExists(path237.join(metaprojectRoot, dir))) {
       errors.push(issue("missing-required-dir", `Required directory .metaproject/${dir}/ is missing`, `Run \`keryx init\` to create .metaproject/${dir}/.`));
     }
   }
-  const manifestPath = path236.join(metaprojectRoot, "metaproject.json");
+  const manifestPath = path237.join(metaprojectRoot, "metaproject.json");
   if (!await pathExists(manifestPath)) {
     return { ok: errors.length === 0, errors, warnings };
   }
@@ -102745,7 +103078,7 @@ async function validateWorkspace2(cwd) {
       if (typeof value !== "string") {
         continue;
       }
-      if (!await pathExists(path236.join(cwd, value))) {
+      if (!await pathExists(path237.join(cwd, value))) {
         errors.push(issue("missing-declared-path", `Declared path paths.${key} -> ${value} does not exist`, `Create ${value} or remove paths.${key} from metaproject.json.`));
       }
     }
@@ -102755,7 +103088,7 @@ async function validateWorkspace2(cwd) {
       continue;
     }
     if (typeof entry.manifest === "string") {
-      if (!await pathExists(path236.join(cwd, entry.manifest))) {
+      if (!await pathExists(path237.join(cwd, entry.manifest))) {
         errors.push(issue("missing-module-manifest", `Enabled module "${key}" manifest ${entry.manifest} is missing`, `Create ${entry.manifest} or run \`keryx update\` to regenerate module manifests.`));
       }
     }
@@ -102764,14 +103097,14 @@ async function validateWorkspace2(cwd) {
       if (typeof value !== "string") {
         continue;
       }
-      if (!await pathExists(path236.join(cwd, value))) {
+      if (!await pathExists(path237.join(cwd, value))) {
         const sink = field === "data" ? warnings : errors;
         sink.push(issue("missing-module-path", `Module "${key}" declares ${String(field)} ${value}, which does not exist`, field === "data" ? `Run the module (e.g. \`keryx ${key} ...\`) to generate ${value}, or update modules.${key}.data in metaproject.json.` : `Create ${value} or update modules.${key}.${String(field)} in metaproject.json.`));
       }
     }
   }
   for (const { path: name, scope } of namedEntrypoints(manifest)) {
-    const filePath = path236.join(cwd, name);
+    const filePath = path237.join(cwd, name);
     if (!await pathExists(filePath)) {
       continue;
     }
@@ -103436,6 +103769,12 @@ var init_help_groups = __esm(() => {
       group: "Automation",
       summary: "Connect, test or disconnect Telegram for this machine: bot token, one-time code, group. [status]."
     },
+    {
+      kind: "slash",
+      name: "/rendering",
+      group: "Automation",
+      summary: "How Telegram replies are written: tables and lists as rich messages or HTML, with a fallback. [auto|rich|html|plain]."
+    },
     {
       kind: "cli",
       name: "acp",
@@ -103628,6 +103967,12 @@ var init_help_groups = __esm(() => {
       group: "Maintenance and diagnostics",
       summary: "Bound stores that grow without bound (gdctx raw/artifacts, owner write-conflict sidecars)."
     },
+    {
+      kind: "cli",
+      name: "remote",
+      group: "Automation",
+      summary: "Preview how Telegram replies are rendered (tables, lists, rules) in every mode, with no network: format-sample."
+    },
     {
       kind: "cli",
       name: "forgetting",
@@ -103644,7 +103989,7 @@ var init_help_groups = __esm(() => {
 });
 
 // src/standard/service.ts
-import path237 from "path";
+import path238 from "path";
 import { readFile as readFile110 } from "fs/promises";
 async function runValidate(cwd) {
   return validateWorkspace2(cwd);
@@ -103653,7 +103998,7 @@ async function runDoctor2(cwd) {
   return validateWorkspace2(cwd);
 }
 async function readManifest2(cwd) {
-  const manifestPath = path237.join(cwd, ".metaproject", "metaproject.json");
+  const manifestPath = path238.join(cwd, ".metaproject", "metaproject.json");
   if (!await pathExists(manifestPath)) {
     throw new Error("Metaproject is not initialized (missing .metaproject/metaproject.json). Run `keryx init` first.");
   }
@@ -103680,7 +104025,7 @@ var init_service14 = __esm(() => {
 
 // src/rules/entrypoint-inspection.ts
 import { readFile as readFile111 } from "fs/promises";
-import path238 from "path";
+import path239 from "path";
 async function inspectEntrypoints(projectRoot, agentEntrypoints, options = {}) {
   const git = await resolveGitCommonDir(projectRoot) !== undefined;
   const resolved = await resolveProjectEntrypoints(projectRoot, agentEntrypoints);
@@ -103765,14 +104110,14 @@ async function inspectEntrypoints(projectRoot, agentEntrypoints, options = {}) {
       codex = { entry, mode: "skip" };
       continue;
     }
-    const sourceExists = await pathExists(path238.join(projectRoot, entry.source));
+    const sourceExists = await pathExists(path239.join(projectRoot, entry.source));
     const state = await codexOverrideState(projectRoot, entry);
     const bytes = await codexOverrideByteSize(projectRoot, entry);
     codex = { entry, mode: "override", sourceExists, state, ...bytes === undefined ? {} : { bytes } };
     localTargets.push({ path: entry.path, kind: "codex", exists: state !== "missing", expected: sourceExists });
   }
   if (targets.claudeSettings.scope === "local") {
-    const exists = await pathExists(path238.join(projectRoot, ...hooksTarget.split("/")));
+    const exists = await pathExists(path239.join(projectRoot, ...hooksTarget.split("/")));
     localTargets.push({ path: hooksTarget, kind: "claudeSettings", exists, expected: options.hooksExpected === true });
   }
   const existing = localTargets.filter((target) => target.exists);
@@ -103901,14 +104246,14 @@ function codexPreviewLines(codex) {
 }
 async function readText3(projectRoot, relativePath) {
   try {
-    return await readFile111(path238.join(projectRoot, ...relativePath.split("/")), "utf8");
+    return await readFile111(path239.join(projectRoot, ...relativePath.split("/")), "utf8");
   } catch {
     return;
   }
 }
 function displayPath2(projectRoot, target) {
-  const relative = path238.relative(projectRoot, target);
-  return relative.startsWith("..") || path238.isAbsolute(relative) ? target : relative.split(path238.sep).join("/");
+  const relative = path239.relative(projectRoot, target);
+  return relative.startsWith("..") || path239.isAbsolute(relative) ? target : relative.split(path239.sep).join("/");
 }
 function isRecord10(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -103932,7 +104277,7 @@ var init_entrypoint_inspection = __esm(() => {
 import { readdir as readdir35, readFile as readFile112 } from "fs/promises";
 import { existsSync as existsSync41 } from "fs";
 import { homedir as homedir10, tmpdir as tmpdir10 } from "os";
-import path239 from "path";
+import path240 from "path";
 async function registeredWorktrees(cwd) {
   if (!Bun.which("git"))
     return new Set;
@@ -103945,7 +104290,7 @@ async function registeredWorktrees(cwd) {
     for (const line of stdout.split(`
 `)) {
       if (line.startsWith("worktree ")) {
-        paths.add(path239.resolve(line.slice("worktree ".length).trim()));
+        paths.add(path240.resolve(line.slice("worktree ".length).trim()));
       }
     }
     return paths;
@@ -103955,7 +104300,7 @@ async function registeredWorktrees(cwd) {
 }
 async function checkWorktrees(cwd) {
   const mainRoot = await resolveMainCheckoutRoot(cwd) ?? cwd;
-  const worktreesDir = path239.join(mainRoot, ".claude", "worktrees");
+  const worktreesDir = path240.join(mainRoot, ".claude", "worktrees");
   let entries;
   try {
     entries = (await readdir35(worktreesDir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
@@ -103967,8 +104312,8 @@ async function checkWorktrees(cwd) {
   }
   const registered = await registeredWorktrees(cwd);
   const stale = entries.filter((name) => {
-    const full = path239.resolve(worktreesDir, name);
-    return !existsSync41(path239.join(full, ".git")) || !registered.has(full);
+    const full = path240.resolve(worktreesDir, name);
+    return !existsSync41(path240.join(full, ".git")) || !registered.has(full);
   });
   if (stale.length === 0) {
     return {
@@ -104134,7 +104479,7 @@ async function checkEntrypoints(cwd) {
   const projectRoot = resolveProjectRoot2(cwd);
   let manifest;
   try {
-    manifest = JSON.parse(await readFile112(path239.join(projectRoot, ".metaproject", "metaproject.json"), "utf8"));
+    manifest = JSON.parse(await readFile112(path240.join(projectRoot, ".metaproject", "metaproject.json"), "utf8"));
   } catch {
     manifest = undefined;
   }
@@ -104289,22 +104634,22 @@ async function checkWikiFreshness(cwd) {
   };
 }
 function isExcludedProjectRootCandidate(dir) {
-  return dir === path239.parse(dir).root || dir === "/tmp" || dir === tmpdir10();
+  return dir === path240.parse(dir).root || dir === "/tmp" || dir === tmpdir10();
 }
 function findMetaprojectUpward(cwd, ceiling) {
-  let current = path239.resolve(cwd);
-  const resolvedCeiling = path239.resolve(ceiling);
+  let current = path240.resolve(cwd);
+  const resolvedCeiling = path240.resolve(ceiling);
   for (;; ) {
     if (isExcludedProjectRootCandidate(current)) {
       return;
     }
-    if (existsSync41(path239.join(current, ".metaproject"))) {
+    if (existsSync41(path240.join(current, ".metaproject"))) {
       return current;
     }
     if (current === resolvedCeiling) {
       return;
     }
-    const parent = path239.dirname(current);
+    const parent = path240.dirname(current);
     if (parent === current) {
       return;
     }
@@ -104318,7 +104663,7 @@ async function isKeryxProject(cwd, overrides = {}) {
     return true;
   }
   const mainRoot = await resolveMainCheckoutRoot(cwd);
-  return mainRoot !== undefined && existsSync41(path239.join(mainRoot, ".metaproject"));
+  return mainRoot !== undefined && existsSync41(path240.join(mainRoot, ".metaproject"));
 }
 async function buildDoctorReport(cwd, env = process.env, overrides = {}) {
   const globalChecks = await Promise.all([
@@ -104406,7 +104751,7 @@ var init_doctor2 = __esm(() => {
 });
 
 // src/commands/goal-command.ts
-import path240 from "path";
+import path241 from "path";
 import { readFile as readFile113 } from "fs/promises";
 function parseGoalArgs(rest) {
   const trimmed = rest.trim();
@@ -104479,7 +104824,7 @@ function getFlowService() {
 async function autoProvisionFlow(cwd, goalText) {
   const service = getFlowService();
   const result = await service.init({ cwd, title: goalText });
-  const acFile = path240.join(cwd, result.dir, "acceptance-criteria.md");
+  const acFile = path241.join(cwd, result.dir, "acceptance-criteria.md");
   await writeFileAtomic(acFile, [
     "# Acceptance Criteria",
     "",
@@ -107517,7 +107862,7 @@ __export(exports_flow, {
   signerIdentityArgs: () => signerIdentityArgs
 });
 import { randomInt } from "crypto";
-import path241 from "path";
+import path242 from "path";
 function parseTaskKind(raw) {
   if (raw === undefined) {
     return;
@@ -108432,7 +108777,7 @@ async function runSchema(args) {
 `;
   const out = optionValue(args, "--out");
   if (out) {
-    const target = path241.isAbsolute(out) ? out : path241.join(process.cwd(), out);
+    const target = path242.isAbsolute(out) ? out : path242.join(process.cwd(), out);
     await writeFileAtomic(target, json);
     console.log(`  ${style.green(symbols.ok)} Wrote flow-state schema ${style.cyan(symbols.arrow)} ${out}`);
     return;
@@ -108724,7 +109069,7 @@ var init_lifecycle_flag = __esm(() => {
 // src/sac/catch-up.ts
 import { randomUUID as randomUUID30 } from "crypto";
 import { readdir as readdir36, stat as stat24 } from "fs/promises";
-import path242 from "path";
+import path243 from "path";
 async function buildCatchUp(input) {
   const [proposals, sessionCategories, lifecycleFlagsAll, unreviewedPathsAll] = await Promise.all([
     collectProposals(input.cwd, input.workspaceId),
@@ -108843,7 +109188,7 @@ async function readExternalUnboundCandidates(cwd) {
         }
         return groups;
       }, []));
-      const metaPath = path242.join(extDir, `${id}.json`);
+      const metaPath = path243.join(extDir, `${id}.json`);
       if (await pathExists(unboundDismissedReceiptPath(metaPath)))
         continue;
       candidates.push({
@@ -108857,7 +109202,7 @@ async function readExternalUnboundCandidates(cwd) {
   return candidates;
 }
 async function readNewestUnboundCandidateForExternal(cwd, externalSessionId) {
-  const evidenceDir = path242.join(externalSlatesDir(cwd), externalSessionId);
+  const evidenceDir = path243.join(externalSlatesDir(cwd), externalSessionId);
   let entries;
   try {
     entries = (await readdir36(evidenceDir)).filter((name) => name.endsWith("-unbound-candidate.json"));
@@ -108866,7 +109211,7 @@ async function readNewestUnboundCandidateForExternal(cwd, externalSessionId) {
   }
   entries.sort();
   for (let i = entries.length - 1;i >= 0; i--) {
-    const evidencePath = path242.join(evidenceDir, entries[i]);
+    const evidencePath = path243.join(evidenceDir, entries[i]);
     if (await pathExists(unboundDismissedReceiptPath(evidencePath)))
       continue;
     const result = readConfigFile(evidencePath);
@@ -108907,7 +109252,7 @@ async function collectSessionCategories(cwd) {
 }
 async function collectReceiptTargets(cwd, owner) {
   const targets = new Set;
-  const workspacesDir = path242.join(cwd, ".metaproject", "workspaces");
+  const workspacesDir = path243.join(cwd, ".metaproject", "workspaces");
   let workspaceIds;
   try {
     workspaceIds = (await readdir36(workspacesDir, { withFileTypes: true })).filter((entry) => entry.isDirectory()).map((entry) => entry.name);
@@ -108915,7 +109260,7 @@ async function collectReceiptTargets(cwd, owner) {
     return targets;
   }
   for (const workspaceId of workspaceIds) {
-    const receiptsDir = path242.join(workspacesDir, workspaceId, `${owner}-write-receipts`);
+    const receiptsDir = path243.join(workspacesDir, workspaceId, `${owner}-write-receipts`);
     let files;
     try {
       files = (await readdir36(receiptsDir)).filter((name) => name.endsWith(".json"));
@@ -108923,7 +109268,7 @@ async function collectReceiptTargets(cwd, owner) {
       continue;
     }
     for (const file of files) {
-      const result = readConfigFile(path242.join(receiptsDir, file));
+      const result = readConfigFile(path243.join(receiptsDir, file));
       if (!result.ok)
         continue;
       try {
@@ -108966,7 +109311,7 @@ async function findSkillFiles(dir) {
   }
   const found = [];
   for (const entry of entries) {
-    const full = path242.join(dir, entry.name);
+    const full = path243.join(dir, entry.name);
     if (entry.isDirectory()) {
       found.push(...await findSkillFiles(full));
     } else if (entry.isFile() && entry.name === "SKILL.md") {
@@ -109025,10 +109370,10 @@ async function detectUnreviewedSacPathChanges(cwd, sessions) {
       changedAt: attribution.changedAt
     });
   }
-  const sacSkillsDir = path242.join(cwd, ".metaproject", "project-skills", "sac");
+  const sacSkillsDir = path243.join(cwd, ".metaproject", "project-skills", "sac");
   const skillFiles = await findSkillFiles(sacSkillsDir);
   for (const absolutePath of skillFiles) {
-    const targetRef = path242.relative(path242.join(cwd, ".metaproject"), absolutePath).split(path242.sep).join("/");
+    const targetRef = path243.relative(path243.join(cwd, ".metaproject"), absolutePath).split(path243.sep).join("/");
     if (skillReceipts.has(targetRef))
       continue;
     const attribution = await attributeToSession(absolutePath, scoped);
@@ -109046,12 +109391,12 @@ async function detectUnreviewedSacPathChanges(cwd, sessions) {
   return items;
 }
 async function isSlateEngaged(dir) {
-  if (await pathExists(path242.join(dir, "slate.json")))
+  if (await pathExists(path243.join(dir, "slate.json")))
     return true;
-  if (await pathExists(path242.join(dir, "terminal-state.json")))
+  if (await pathExists(path243.join(dir, "terminal-state.json")))
     return true;
   try {
-    const entries = await readdir36(path242.join(dir, "slate-archive"));
+    const entries = await readdir36(path243.join(dir, "slate-archive"));
     return entries.length > 0;
   } catch {
     return false;
@@ -109076,7 +109421,7 @@ async function safeReadSlate(dir) {
   }
 }
 async function readTerminalState(dir) {
-  const result = readConfigFile(path242.join(dir, "terminal-state.json"));
+  const result = readConfigFile(path243.join(dir, "terminal-state.json"));
   if (!result.ok) {
     return;
   }
@@ -109100,7 +109445,7 @@ async function resolveUnboundCandidateTarget(cwd, target) {
   if (session === undefined) {
     throw new Error(`No session or evidence path matches "${target}"`);
   }
-  const archiveDir = path242.join(sessionDir(session.projectPath, session.id), "slate-archive");
+  const archiveDir = path243.join(sessionDir(session.projectPath, session.id), "slate-archive");
   let entries;
   try {
     entries = (await readdir36(archiveDir)).filter((name) => name.endsWith("-unbound-candidate.json"));
@@ -109110,7 +109455,7 @@ async function resolveUnboundCandidateTarget(cwd, target) {
   if (entries.length === 0)
     throw new Error(`No unbound-candidate artifacts for session ${session.id}`);
   entries.sort();
-  return path242.join(archiveDir, entries[entries.length - 1]);
+  return path243.join(archiveDir, entries[entries.length - 1]);
 }
 async function dismissUnboundByTarget(cwd, target, reason) {
   const evidencePath = await resolveUnboundCandidateTarget(cwd, target);
@@ -109136,7 +109481,7 @@ async function dismissUnboundCandidate(candidatePath, reason) {
   return { removed: candidatePath, receipt: receiptPath };
 }
 async function readNewestUnboundCandidate(dir) {
-  const archiveDir = path242.join(dir, "slate-archive");
+  const archiveDir = path243.join(dir, "slate-archive");
   let entries;
   try {
     entries = (await readdir36(archiveDir)).filter((name) => name.endsWith("-unbound-candidate.json"));
@@ -109145,7 +109490,7 @@ async function readNewestUnboundCandidate(dir) {
   }
   entries.sort();
   for (let i = entries.length - 1;i >= 0; i--) {
-    const evidencePath = path242.join(archiveDir, entries[i]);
+    const evidencePath = path243.join(archiveDir, entries[i]);
     if (await pathExists(unboundDismissedReceiptPath(evidencePath)))
       continue;
     const result = readConfigFile(evidencePath);
@@ -109175,7 +109520,7 @@ function isFailureOutcome2(g) {
   return g.outcome === "error" || g.outcome === "no_credential" || g.outcome === "conflict";
 }
 async function readNewestWrapUpOutcome(dir) {
-  const archiveDir = path242.join(dir, "slate-archive");
+  const archiveDir = path243.join(dir, "slate-archive");
   let entries;
   try {
     entries = (await readdir36(archiveDir)).filter((name) => name.endsWith("-wrap-up-outcome.json"));
@@ -109184,7 +109529,7 @@ async function readNewestWrapUpOutcome(dir) {
   }
   entries.sort();
   for (let i = entries.length - 1;i >= 0; i--) {
-    const evidencePath = path242.join(archiveDir, entries[i]);
+    const evidencePath = path243.join(archiveDir, entries[i]);
     const result = readConfigFile(evidencePath);
     if (!result.ok) {
       continue;
@@ -109934,12 +110279,12 @@ var init_extract3 = __esm(() => {
 // src/product/corpus.ts
 import { createHash as createHash62 } from "crypto";
 import { readdir as readdir37, readFile as readFile115 } from "fs/promises";
-import path243 from "path";
+import path244 from "path";
 function flowsDir(cwd) {
-  return path243.join(cwd, ".metaproject", "flows");
+  return path244.join(cwd, ".metaproject", "flows");
 }
 function requirementsDir(cwd) {
-  return path243.join(cwd, "docs", "requirements");
+  return path244.join(cwd, "docs", "requirements");
 }
 async function readOptional(file) {
   try {
@@ -109992,23 +110337,23 @@ async function corpusFingerprint(cwd) {
   for (const name of await listFlowPackages(cwd)) {
     lines.push(`package\x00flow\x00${name}`);
     for (const file of FLOW_SOURCE_FILES) {
-      const content = await readBytes(path243.join(flowsDir(cwd), name, file));
+      const content = await readBytes(path244.join(flowsDir(cwd), name, file));
       lines.push(`file\x00${FLOW_PREFIX}${name}/${file}\x00${digestOf4(content)}`);
     }
   }
   for (const name of await requirementPackages(cwd)) {
     lines.push(`package\x00docpack\x00${name}`);
-    const dir = path243.join(requirementsDir(cwd), name);
+    const dir = path244.join(requirementsDir(cwd), name);
     for (const candidate of PRIMARY_DOCS) {
-      const content = await readBytes(path243.join(dir, candidate));
+      const content = await readBytes(path244.join(dir, candidate));
       if (content === null)
         continue;
       lines.push(`file\x00docs/requirements/${name}/${candidate}\x00${digestOf4(content)}`);
       break;
     }
-    const readme = await readBytes(path243.join(dir, "README.md"));
+    const readme = await readBytes(path244.join(dir, "README.md"));
     lines.push(`file\x00docs/requirements/${name}/README.md\x00${digestOf4(readme)}`);
-    const specification = await readBytes(path243.join(dir, "specification.md"));
+    const specification = await readBytes(path244.join(dir, "specification.md"));
     lines.push(`file\x00docs/requirements/${name}/specification.md\x00${digestOf4(specification)}`);
   }
   return createHash62("sha256").update([...lines].sort().join(`
@@ -110050,19 +110395,19 @@ async function buildIntentIndex(cwd) {
   const intents = [];
   const failures = [];
   for (const name of await listFlowPackages(cwd)) {
-    const dir = path243.join(flowsDir(cwd), name);
+    const dir = path244.join(flowsDir(cwd), name);
     const repoPath = `${FLOW_PREFIX}${name}`;
     try {
-      const flowJson = await readSource(path243.join(dir, "flow.json"), `${repoPath}/flow.json`);
+      const flowJson = await readSource(path244.join(dir, "flow.json"), `${repoPath}/flow.json`);
       if (flowJson === null) {
         failures.push(`${repoPath}: no flow.json`);
         continue;
       }
-      const journal = await readSource(path243.join(dir, "journal.md"), `${repoPath}/journal.md`);
+      const journal = await readSource(path244.join(dir, "journal.md"), `${repoPath}/journal.md`);
       intents.push(extractFlowIntent({
         flowJson,
-        description: await readSource(path243.join(dir, "description.md"), `${repoPath}/description.md`),
-        criteria: await readSource(path243.join(dir, "acceptance-criteria.md"), `${repoPath}/acceptance-criteria.md`),
+        description: await readSource(path244.join(dir, "description.md"), `${repoPath}/description.md`),
+        criteria: await readSource(path244.join(dir, "acceptance-criteria.md"), `${repoPath}/acceptance-criteria.md`),
         journal
       }, repoPath));
       const problem = observationProblem(journal);
@@ -110073,17 +110418,17 @@ async function buildIntentIndex(cwd) {
     }
   }
   for (const name of await requirementPackages(cwd)) {
-    const dir = path243.join(requirementsDir(cwd), name);
+    const dir = path244.join(requirementsDir(cwd), name);
     const repoPath = `docs/requirements/${name}`;
     try {
       let primary = null;
       for (const candidate of PRIMARY_DOCS) {
-        primary = await readSource(path243.join(dir, candidate), `${repoPath}/${candidate}`);
+        primary = await readSource(path244.join(dir, candidate), `${repoPath}/${candidate}`);
         if (primary !== null)
           break;
       }
-      const specification = await readSource(path243.join(dir, "specification.md"), `${repoPath}/specification.md`);
-      const readme = await readSource(path243.join(dir, "README.md"), `${repoPath}/README.md`);
+      const specification = await readSource(path244.join(dir, "specification.md"), `${repoPath}/specification.md`);
+      const readme = await readSource(path244.join(dir, "README.md"), `${repoPath}/README.md`);
       const source = { name, primary, specification, readme };
       intents.push(extractDocpackIntent(source, repoPath));
       const problem = docpackObservationProblem(source);
@@ -110143,12 +110488,12 @@ var init_by_origin = __esm(() => {
 
 // src/product/store.ts
 import { readFile as readFile116 } from "fs/promises";
-import path244 from "path";
+import path245 from "path";
 function productDataRoot(cwd) {
-  return path244.join(cwd, ".metaproject", "data", "product");
+  return path245.join(cwd, ".metaproject", "data", "product");
 }
 function indexPath(cwd) {
-  return path244.join(productDataRoot(cwd), "index.json");
+  return path245.join(productDataRoot(cwd), "index.json");
 }
 function serializeIndex(index) {
   return `${JSON.stringify(index, null, 2)}
@@ -111639,9 +111984,9 @@ var init_repair = __esm(() => {
 
 // src/review/managed.ts
 import { mkdir as mkdir55, readFile as readFile117, readdir as readdir38, realpath as realpath18, rm as rm16, stat as stat25 } from "fs/promises";
-import path245 from "path";
+import path246 from "path";
 function reviewsRoot(cwd) {
-  return path245.join(cwd, ".metaproject", "reviews");
+  return path246.join(cwd, ".metaproject", "reviews");
 }
 async function resolveGitHead2(cwd) {
   try {
@@ -111774,26 +112119,26 @@ async function createManagedReviewPackage(input) {
     throw new Error(`Refusing to record findings that do not satisfy review-finding.schema.json: ${contractErrors.map((error) => `${error.path} ${error.message}`).join("; ")}`);
   }
   await mkdir55(packageDir, { recursive: true });
-  await writeFileAtomic(path245.join(packageDir, "manifest.json"), `${JSON.stringify(manifest, null, 2)}
+  await writeFileAtomic(path246.join(packageDir, "manifest.json"), `${JSON.stringify(manifest, null, 2)}
 `);
-  await writeFileAtomic(path245.join(packageDir, "scope.md"), renderScope(input, flowMatch, at, verification, carried, caps, externalReclaims, scopeB.record, filterStats));
-  await writeFileAtomic(path245.join(packageDir, "coverage.md"), renderCoverage(coverage));
-  await writeFileAtomic(path245.join(packageDir, "report.md"), renderReport2(report, input.mode));
-  await writeFileAtomic(path245.join(packageDir, "findings.json"), `${JSON.stringify(findings.map(toContractFinding), null, 2)}
+  await writeFileAtomic(path246.join(packageDir, "scope.md"), renderScope(input, flowMatch, at, verification, carried, caps, externalReclaims, scopeB.record, filterStats));
+  await writeFileAtomic(path246.join(packageDir, "coverage.md"), renderCoverage(coverage));
+  await writeFileAtomic(path246.join(packageDir, "report.md"), renderReport2(report, input.mode));
+  await writeFileAtomic(path246.join(packageDir, "findings.json"), `${JSON.stringify(findings.map(toContractFinding), null, 2)}
 `);
-  await writeFileAtomic(path245.join(packageDir, "learning.md"), renderLearning(findings));
-  await writeFileAtomic(path245.join(packageDir, "decisions.md"), renderDecisions(findings));
+  await writeFileAtomic(path246.join(packageDir, "learning.md"), renderLearning(findings));
+  await writeFileAtomic(path246.join(packageDir, "decisions.md"), renderDecisions(findings));
   await persistScreenRadius(packageDir, scopeB.resolved);
   const reviewNotes = await writeReviewNotes(findings, {
     cwd: input.cwd,
     reviewId,
     head,
-    packagePath: path245.relative(input.cwd, packageDir),
+    packagePath: path246.relative(input.cwd, packageDir),
     ...input.now === undefined ? {} : { now: input.now }
   });
   return {
     reviewId,
-    path: path245.relative(input.cwd, packageDir),
+    path: path246.relative(input.cwd, packageDir),
     manifest,
     verification: verification.counts,
     verificationRejections: verification.rejections,
@@ -111810,7 +112155,7 @@ async function screenScopeBFindings(input, packageDir, findings) {
   const scopeB = findings.filter((finding) => isBlastRadiusScopedFinding(finding, reviewers));
   if (resolved === undefined) {
     if (scopeB.length > 0) {
-      throw new Error(`Refusing to record ${scopeB.length} finding(s) raised under scope B (${scopeB.map((finding) => `${finding.id} by ${finding.reviewer}`).join(", ")}) with no blast-radius record: AC3 is enforced in code, and the screen cannot be applied without the computed set the round was dispatched over. Two ways out, and the first is the one that always works: (1) compute the set with \`keryx review blast-radius --json > <file>\` and pass \`--blast-radius <file>\` to this ingest; (2) write that record to \`${path245.relative(input.cwd, handoffBlastRadiusPath(packageDir))}\` and ingest again \u2014 the ingest reads it from there and consumes it. Do NOT write it to \`${path245.relative(input.cwd, path245.join(packageDir, BLAST_RADIUS_ARTIFACT))}\`: a round that names no --review-id has not allocated that directory yet, so creating it makes the next ingest take the NEXT free name and find nothing there either.`);
+      throw new Error(`Refusing to record ${scopeB.length} finding(s) raised under scope B (${scopeB.map((finding) => `${finding.id} by ${finding.reviewer}`).join(", ")}) with no blast-radius record: AC3 is enforced in code, and the screen cannot be applied without the computed set the round was dispatched over. Two ways out, and the first is the one that always works: (1) compute the set with \`keryx review blast-radius --json > <file>\` and pass \`--blast-radius <file>\` to this ingest; (2) write that record to \`${path246.relative(input.cwd, handoffBlastRadiusPath(packageDir))}\` and ingest again \u2014 the ingest reads it from there and consumes it. Do NOT write it to \`${path246.relative(input.cwd, path246.join(packageDir, BLAST_RADIUS_ARTIFACT))}\`: a round that names no --review-id has not allocated that directory yet, so creating it makes the next ingest take the NEXT free name and find nothing there either.`);
     }
     return { retained: [...findings], record: { source: "none", scopeBFindings: 0 }, resolved: undefined };
   }
@@ -111827,13 +112172,13 @@ async function screenScopeBFindings(input, packageDir, findings) {
   };
 }
 function handoffBlastRadiusPath(packageDir) {
-  return path245.join(path245.dirname(packageDir), BLAST_RADIUS_ARTIFACT);
+  return path246.join(path246.dirname(packageDir), BLAST_RADIUS_ARTIFACT);
 }
 async function resolveScreenRadius(input, packageDir) {
   if (input.blastRadius !== undefined) {
     return { radius: input.blastRadius, source: "input" };
   }
-  const inPackage = path245.join(packageDir, BLAST_RADIUS_ARTIFACT);
+  const inPackage = path246.join(packageDir, BLAST_RADIUS_ARTIFACT);
   const fromPackage = await readBlastRadiusRecordFile(inPackage);
   if (fromPackage !== undefined) {
     return { radius: fromPackage, source: "package", file: inPackage };
@@ -111859,7 +112204,7 @@ async function persistScreenRadius(packageDir, resolved) {
   if (resolved === undefined) {
     return;
   }
-  const inPackage = path245.join(packageDir, BLAST_RADIUS_ARTIFACT);
+  const inPackage = path246.join(packageDir, BLAST_RADIUS_ARTIFACT);
   if (resolved.source !== "package") {
     await writeFileAtomic(inPackage, `${JSON.stringify(resolved.radius, null, 2)}
 `);
@@ -111890,12 +112235,12 @@ function fromVerifierRefutations(findings) {
   }));
 }
 async function getManagedReviewStatus(cwd, ref) {
-  const manifestPath = ref.endsWith("manifest.json") ? path245.resolve(cwd, ref) : path245.join(await resolveReviewPackagePath(cwd, ref), "manifest.json");
+  const manifestPath = ref.endsWith("manifest.json") ? path246.resolve(cwd, ref) : path246.join(await resolveReviewPackagePath(cwd, ref), "manifest.json");
   return JSON.parse(await readFile117(manifestPath, "utf8"));
 }
 async function completeManagedReview(cwd, ref, options = {}) {
   const packageDir = await resolveReviewPackagePath(cwd, ref);
-  const manifestPath = path245.join(packageDir, "manifest.json");
+  const manifestPath = path246.join(packageDir, "manifest.json");
   const manifest = JSON.parse(await readFile117(manifestPath, "utf8"));
   const missing = await missingArtifacts(packageDir);
   if (missing.length > 0) {
@@ -111916,12 +112261,12 @@ async function completeManagedReview(cwd, ref, options = {}) {
   }
   await writeFileAtomic(manifestPath, `${JSON.stringify(updated, null, 2)}
 `);
-  const recorded = JSON.parse(await readFile117(path245.join(packageDir, "findings.json"), "utf8"));
+  const recorded = JSON.parse(await readFile117(path246.join(packageDir, "findings.json"), "utf8"));
   const reviewNotes = await writeReviewNotes(recorded, {
     cwd,
     reviewId: updated.reviewId,
     head: updated.target.head ?? null,
-    packagePath: path245.relative(cwd, packageDir),
+    packagePath: path246.relative(cwd, packageDir),
     ...options.now === undefined ? {} : { now: options.now }
   });
   return { manifest: updated, reviewNotes, dispositions: tallyDispositions(recorded) };
@@ -111987,16 +112332,16 @@ async function resolvePackageFlow(input) {
 }
 function packagePath(cwd, mode, reviewId, flowMatch) {
   if ((mode === "attach-review" || mode === "ingest") && flowMatch) {
-    return path245.join(flowsRoot(cwd), flowMatch.dir, "reviews", reviewId);
+    return path246.join(flowsRoot(cwd), flowMatch.dir, "reviews", reviewId);
   }
   if (mode === "attach-review") {
     throw new Error("attach-review requires an explicit or matched flow");
   }
-  return path245.join(reviewsRoot(cwd), reviewId);
+  return path246.join(reviewsRoot(cwd), reviewId);
 }
 function buildManifest(args) {
   const crossFamily = args.input.crossFamilyReview;
-  const artifactPath = (name) => path245.relative(args.input.cwd, path245.join(args.packageDir, name));
+  const artifactPath = (name) => path246.relative(args.input.cwd, path246.join(args.packageDir, name));
   const manifest = {
     schemaVersion: 1,
     reviewId: args.reviewId,
@@ -112043,7 +112388,7 @@ async function readReport(input) {
     return input.reportText;
   }
   if (input.reportPath) {
-    return readFile117(path245.resolve(input.cwd, input.reportPath), "utf8");
+    return readFile117(path246.resolve(input.cwd, input.reportPath), "utf8");
   }
   if (input.mode === "ingest") {
     throw new Error("ingest requires --report or reportText");
@@ -112054,7 +112399,7 @@ No reviewer findings recorded yet.
 `;
 }
 function reportLabel(input) {
-  return input.reportPath ? path245.resolve(input.cwd, input.reportPath) : "the report text passed to keryx review";
+  return input.reportPath ? path246.resolve(input.cwd, input.reportPath) : "the report text passed to keryx review";
 }
 async function normalizeFindings(args) {
   if (args.source !== undefined) {
@@ -112109,16 +112454,16 @@ async function anchorFindings(findings, input, head) {
   }
 }
 async function containedRelativePath(cwd, relative) {
-  const root = await realpath18(cwd).catch(() => path245.resolve(cwd));
-  const resolved = path245.resolve(root, relative);
+  const root = await realpath18(cwd).catch(() => path246.resolve(cwd));
+  const resolved = path246.resolve(root, relative);
   const real = await realpath18(resolved).catch(() => null);
-  if (real === null || real !== root && !real.startsWith(`${root}${path245.sep}`)) {
+  if (real === null || real !== root && !real.startsWith(`${root}${path246.sep}`)) {
     return null;
   }
   return real;
 }
 async function readFileAtCommit(cwd, commit, absolute) {
-  const relative = path245.relative(await realpath18(cwd).catch(() => path245.resolve(cwd)), absolute);
+  const relative = path246.relative(await realpath18(cwd).catch(() => path246.resolve(cwd)), absolute);
   try {
     const proc = Bun.spawn(["git", "show", `${commit}:${relative}`], {
       cwd,
@@ -112137,10 +112482,10 @@ async function readFileAtCommit(cwd, commit, absolute) {
 }
 function readFromWorkingTree(input) {
   return async (relative) => {
-    const root = await realpath18(input.cwd).catch(() => path245.resolve(input.cwd));
-    const resolved = path245.resolve(root, relative);
+    const root = await realpath18(input.cwd).catch(() => path246.resolve(input.cwd));
+    const resolved = path246.resolve(root, relative);
     const real = await realpath18(resolved).catch(() => null);
-    if (real === null || real !== root && !real.startsWith(`${root}${path245.sep}`)) {
+    if (real === null || real !== root && !real.startsWith(`${root}${path246.sep}`)) {
       return null;
     }
     try {
@@ -112272,7 +112617,7 @@ function refutedClassification(state) {
   return state === "dismissed-incorrect" ? "false_positive" : "out_of_scope";
 }
 async function recordDispositions(packageDir, records) {
-  const findingsPath = path245.join(packageDir, "findings.json");
+  const findingsPath = path246.join(packageDir, "findings.json");
   const findings = JSON.parse(await readFile117(findingsPath, "utf8"));
   const schema = await loadSchema("review-finding");
   const dispositionSchema = schema.properties?.["disposition"];
@@ -112599,7 +112944,7 @@ function upsertPreFilterScopeBlock(text, block) {
 ${body}`;
 }
 async function readPreFilterScopeBlock(packageDir) {
-  const scopePath = path245.join(packageDir, "scope.md");
+  const scopePath = path246.join(packageDir, "scope.md");
   if (!await pathExists(scopePath)) {
     return;
   }
@@ -112773,39 +113118,39 @@ function matchReason(flow, dir, kind, ref) {
 async function missingArtifacts(packageDir) {
   const missing = [];
   for (const artifact of ["scope.md", "coverage.md", "report.md", "findings.json", "learning.md", "decisions.md"]) {
-    if (!await pathExists(path245.join(packageDir, artifact))) {
+    if (!await pathExists(path246.join(packageDir, artifact))) {
       missing.push(artifact);
     }
   }
   return missing;
 }
 async function resolveReviewPackagePath(cwd, ref) {
-  const absolute = path245.resolve(cwd, ref);
-  if (await pathExists(path245.join(absolute, "manifest.json"))) {
+  const absolute = path246.resolve(cwd, ref);
+  if (await pathExists(path246.join(absolute, "manifest.json"))) {
     return absolute;
   }
   if (await pathExists(absolute) && absolute.endsWith("manifest.json")) {
-    return path245.dirname(absolute);
+    return path246.dirname(absolute);
   }
-  const standalone = path245.join(reviewsRoot(cwd), ref);
-  if (await pathExists(path245.join(standalone, "manifest.json"))) {
+  const standalone = path246.join(reviewsRoot(cwd), ref);
+  if (await pathExists(path246.join(standalone, "manifest.json"))) {
     return standalone;
   }
   for (const flowDir of await listFlowDirs(cwd)) {
-    const reviewsDir = path245.join(flowsRoot(cwd), flowDir, "reviews");
+    const reviewsDir = path246.join(flowsRoot(cwd), flowDir, "reviews");
     if (!await pathExists(reviewsDir)) {
       continue;
     }
     for (const entry of await readdir38(reviewsDir, { withFileTypes: true })) {
       if (entry.isDirectory() && entry.name === ref) {
-        return path245.join(reviewsDir, entry.name);
+        return path246.join(reviewsDir, entry.name);
       }
     }
   }
   throw new Error(`Managed review package not found: ${ref}`);
 }
 async function loadDocpackSchema(cwd) {
-  const schemaPath = path245.join(cwd, "docs", "requirements", "managed-review-feedback-loop", "schemas", "managed-review-package.schema.json");
+  const schemaPath = path246.join(cwd, "docs", "requirements", "managed-review-feedback-loop", "schemas", "managed-review-package.schema.json");
   if (!await pathExists(schemaPath)) {
     return null;
   }
@@ -112911,7 +113256,7 @@ function checkPullOpen(facts) {
 
 // src/review/bot/packages.ts
 import { readdir as readdir39, readFile as readFile118 } from "fs/promises";
-import path246 from "path";
+import path247 from "path";
 async function subdirectories2(dir) {
   try {
     const entries = await readdir39(dir, { withFileTypes: true });
@@ -112934,12 +113279,12 @@ function pullFromTarget(target) {
 }
 async function readPackage(dir) {
   try {
-    const manifest = JSON.parse(await readFile118(path246.join(dir, "manifest.json"), "utf8"));
+    const manifest = JSON.parse(await readFile118(path247.join(dir, "manifest.json"), "utf8"));
     if (manifest.target?.kind !== "pr")
       return null;
     let findings = [];
     try {
-      const parsed = JSON.parse(await readFile118(path246.join(dir, "findings.json"), "utf8"));
+      const parsed = JSON.parse(await readFile118(path247.join(dir, "findings.json"), "utf8"));
       if (Array.isArray(parsed))
         findings = parsed;
     } catch {
@@ -112954,16 +113299,16 @@ async function readPackage(dir) {
 function candidateDirs2(cwd) {
   return (async () => {
     const dirs = [];
-    const reviews = path246.join(cwd, ".metaproject", "reviews");
+    const reviews = path247.join(cwd, ".metaproject", "reviews");
     for (const name of await subdirectories2(reviews)) {
       if (name !== "bot")
-        dirs.push(path246.join(reviews, name));
+        dirs.push(path247.join(reviews, name));
     }
-    const flows = path246.join(cwd, ".metaproject", "flows");
+    const flows = path247.join(cwd, ".metaproject", "flows");
     for (const flow of await subdirectories2(flows)) {
-      const nested = path246.join(flows, flow, "reviews");
+      const nested = path247.join(flows, flow, "reviews");
       for (const name of await subdirectories2(nested))
-        dirs.push(path246.join(nested, name));
+        dirs.push(path247.join(nested, name));
     }
     return dirs;
   })();
@@ -112980,7 +113325,7 @@ async function listReviewPackages(cwd) {
 }
 async function loadReviewPackage(cwd, reviewId) {
   for (const dir of await candidateDirs2(cwd)) {
-    if (path246.basename(dir) !== reviewId)
+    if (path247.basename(dir) !== reviewId)
       continue;
     const listed = await readPackage(dir);
     if (listed !== null && listed.reviewId === reviewId)
@@ -112991,7 +113336,7 @@ async function loadReviewPackage(cwd, reviewId) {
 var init_packages = () => {};
 
 // src/review/bot/run.ts
-import path247 from "path";
+import path248 from "path";
 function capDiff(diff, maxBytes) {
   const totalBytes = Buffer.byteLength(diff);
   if (totalBytes <= maxBytes)
@@ -113036,7 +113381,7 @@ function parseVerifierVerdict2(reply) {
   return unverifiable;
 }
 function botStatePath(cwd, repo, number) {
-  return path247.join(cwd, ".metaproject", "reviews", "bot", `${repo.replace(/\//g, "__")}__${number}.json`);
+  return path248.join(cwd, ".metaproject", "reviews", "bot", `${repo.replace(/\//g, "__")}__${number}.json`);
 }
 function emptyBotState(repo, number) {
   return { schemaVersion: 1, repo, number, reviews: [], pull: null };
@@ -113659,9 +114004,9 @@ var init_reviews_inspector = __esm(() => {
 
 // src/lib/serve-config.ts
 import { existsSync as existsSync42 } from "fs";
-import path248 from "path";
+import path249 from "path";
 function serveConfigPath(dir) {
-  return path248.join(keryxConfigDir(dir), "serve.json");
+  return path249.join(keryxConfigDir(dir), "serve.json");
 }
 function parseIpv4(value) {
   const parts = value.split(".");
@@ -113787,7 +114132,7 @@ function projectServeConfig(value, onDrop) {
   if (!isRecord12(value)) {
     return null;
   }
-  reportUndeclared(value, CONFIG_KEYS, "", onDrop);
+  reportUndeclared(value, CONFIG_KEYS2, "", onDrop);
   if (value.schemaVersion !== SERVE_CONFIG_SCHEMA_VERSION) {
     return null;
   }
@@ -113959,10 +114304,10 @@ function saveServeConfig(config, dir, onWarn) {
     return false;
   }
 }
-var SERVE_CONFIG_SCHEMA_VERSION = "1.0.0", DEFAULT_SERVE_BIND_ADDRESS = "127.0.0.1", DEFAULT_SERVE_PORT = 7377, DEFAULT_SERVE_PROFILE = "remote-restricted", CONFIG_KEYS, BIND_KEYS, CREDENTIAL_REF_KEYS, APPROVAL_KEYS, BOUNDS_KEYS;
+var SERVE_CONFIG_SCHEMA_VERSION = "1.0.0", DEFAULT_SERVE_BIND_ADDRESS = "127.0.0.1", DEFAULT_SERVE_PORT = 7377, DEFAULT_SERVE_PROFILE = "remote-restricted", CONFIG_KEYS2, BIND_KEYS, CREDENTIAL_REF_KEYS, APPROVAL_KEYS, BOUNDS_KEYS;
 var init_serve_config = __esm(() => {
   init_config_dir();
-  CONFIG_KEYS = [
+  CONFIG_KEYS2 = [
     "schemaVersion",
     "enabled",
     "bind",
@@ -114098,25 +114443,6 @@ var init_protocol2 = __esm(() => {
   MESSAGE_STATES = ["reading", "working", "done", "failed"];
 });
 
-// src/remote/paths.ts
-import path249 from "path";
-function remoteDirPath(dir) {
-  return path249.join(keryxConfigDir(dir), REMOTE_DIRNAME);
-}
-function ensureRemoteDir(dir, ...sub) {
-  return ensureKeryxSubdir([REMOTE_DIRNAME, ...sub], dir);
-}
-function botTokenPath(dir) {
-  return path249.join(remoteDirPath(dir), BOT_TOKEN_FILE);
-}
-function remoteConfigPath(dir) {
-  return path249.join(remoteDirPath(dir), REMOTE_CONFIG_FILE);
-}
-var REMOTE_DIRNAME = "remote", BOT_TOKEN_FILE = "bot-token", REMOTE_CONFIG_FILE = "config.json", REGISTRY_FILE = "sessions.json", SERVICE_TOPICS_FILE = "service-topics.json", POLLER_STATE_FILE = "poller-state.json", OUTBOUND_FILE = "outbound.jsonl", REJECTED_JOURNAL_FILE = "rejected.jsonl", INBOUND_DIRNAME = "inbound";
-var init_paths4 = __esm(() => {
-  init_config_dir();
-});
-
 // src/remote/endpoint.ts
 import path250 from "path";
 function endpointPath(dir) {
@@ -114155,8 +114481,8 @@ import {
   fsyncSync as fsyncSync2,
   openSync as openSync5,
   renameSync as renameSync5,
-  statSync as statSync15,
-  unlinkSync as unlinkSync5,
+  statSync as statSync16,
+  unlinkSync as unlinkSync6,
   writeFileSync as writeFileSync8
 } from "fs";
 import path251 from "path";
@@ -114190,7 +114516,7 @@ function isGroupOrOtherAccessible(file) {
   if (process.platform === "win32") {
     return false;
   }
-  const mode = statSync15(file, { throwIfNoEntry: false })?.mode;
+  const mode = statSync16(file, { throwIfNoEntry: false })?.mode;
   return mode !== undefined && (mode & 63) !== 0;
 }
 function readServeCredential(dir) {
@@ -114247,7 +114573,7 @@ function writeStore(store, dir) {
     return true;
   } catch {
     try {
-      unlinkSync5(temp);
+      unlinkSync6(temp);
     } catch {}
     return false;
   }
@@ -114323,7 +114649,7 @@ var init_serve_credential = __esm(() => {
 
 // src/remote/shell-token.ts
 import { createHash as createHash64, createHmac as createHmac5, randomBytes as randomBytes12 } from "crypto";
-import { statSync as statSync16 } from "fs";
+import { statSync as statSync17 } from "fs";
 import path252 from "path";
 function shellTokenPath(dir) {
   return path252.join(remoteDirPath(dir), SHELL_TOKEN_FILE);
@@ -114331,7 +114657,7 @@ function shellTokenPath(dir) {
 function readValidated(file) {
   if (process.platform !== "win32") {
     try {
-      const mode = statSync16(file).mode & 511;
+      const mode = statSync17(file).mode & 511;
       if ((mode & 63) !== 0) {
         return { ok: false, reason: `shell token file ${file} is accessible to other users (mode ${mode.toString(8)}); run: chmod 600 ${file}` };
       }
@@ -114344,7 +114670,7 @@ function readValidated(file) {
     return { ok: false, reason: read.reason === "absent" ? `no shell token at ${file}; is \`keryx serve\` running with remote control configured?` : `shell token file ${file} cannot be read (${read.reason})` };
   }
   const token = read.text.trim();
-  if (!TOKEN_SHAPE.test(token)) {
+  if (!TOKEN_SHAPE2.test(token)) {
     return { ok: false, reason: `shell token file ${file} does not hold a shell token; delete it and restart \`keryx serve\`` };
   }
   return { ok: true, value: token };
@@ -114409,12 +114735,12 @@ function createShellTokenVerifier(token) {
     return constantTimeEqual(createHash64("sha256").update(presented, "utf8").digest(), expected);
   };
 }
-var SHELL_TOKEN_FILE = "shell-token", TOKEN_SHAPE, SERVE_PROOF_HEADER = "x-keryx-serve-proof", DERIVED_BEARER_PREFIX = "ksp1.", AUTH_DOMAIN = "keryx-shell-auth-v1", PROOF_DOMAIN = "keryx-serve-proof-v1", NONCE_SHAPE, MAC_SHAPE;
+var SHELL_TOKEN_FILE = "shell-token", TOKEN_SHAPE2, SERVE_PROOF_HEADER = "x-keryx-serve-proof", DERIVED_BEARER_PREFIX = "ksp1.", AUTH_DOMAIN = "keryx-shell-auth-v1", PROOF_DOMAIN = "keryx-serve-proof-v1", NONCE_SHAPE, MAC_SHAPE;
 var init_shell_token = __esm(() => {
   init_config_dir();
   init_serve_credential();
   init_paths4();
-  TOKEN_SHAPE = /^[A-Za-z0-9_-]{32,128}$/;
+  TOKEN_SHAPE2 = /^[A-Za-z0-9_-]{32,128}$/;
   NONCE_SHAPE = /^[A-Za-z0-9_-]{22,64}$/;
   MAC_SHAPE = /^[A-Za-z0-9_-]{43}$/;
 });
@@ -115862,162 +116188,6 @@ var init_shell_bridge = __esm(() => {
   init_protocol2();
 });
 
-// src/remote/config.ts
-import { statSync as statSync17, unlinkSync as unlinkSync6 } from "fs";
-function isSafeInt(value) {
-  return typeof value === "number" && Number.isSafeInteger(value);
-}
-function parseRemoteConfig(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return { ok: false, reason: "remote config must be a JSON object" };
-  }
-  const doc = value;
-  for (const key of Object.keys(doc)) {
-    if (!CONFIG_KEYS2.has(key)) {
-      const shown = /^[A-Za-z_][A-Za-z0-9_]{0,30}$/.test(key) ? key : "<not shown>";
-      return { ok: false, reason: `remote config has an unknown key "${shown}" (the schema is closed)` };
-    }
-  }
-  if (doc.schemaVersion !== REMOTE_CONFIG_SCHEMA_VERSION) {
-    return { ok: false, reason: `remote config schemaVersion must be ${REMOTE_CONFIG_SCHEMA_VERSION}` };
-  }
-  if (!isSafeInt(doc.chatId) || doc.chatId === 0) {
-    return { ok: false, reason: "remote config chatId must be a non-zero integer (the supergroup id)" };
-  }
-  const ids = doc.allowedUserIds;
-  if (!Array.isArray(ids) || ids.length === 0 || !ids.every((id) => isSafeInt(id) && id > 0)) {
-    return { ok: false, reason: "remote config allowedUserIds must be a non-empty array of positive integers" };
-  }
-  const timeout = (key, fallback) => {
-    const raw = doc[key];
-    if (raw === undefined) {
-      return { ok: true, value: fallback };
-    }
-    if (!isSafeInt(raw) || raw < 1 || raw > MAX_TIMEOUT_MS3) {
-      return { ok: false, reason: `remote config ${key} must be an integer from 1 to ${MAX_TIMEOUT_MS3} (milliseconds)` };
-    }
-    return { ok: true, value: raw };
-  };
-  const orphan = timeout("orphanMs", DEFAULT_ORPHAN_MS);
-  if (!orphan.ok) {
-    return orphan;
-  }
-  const run = timeout("runTimeoutMs", DEFAULT_RUN_TIMEOUT_MS);
-  if (!run.ok) {
-    return run;
-  }
-  return {
-    ok: true,
-    value: {
-      schemaVersion: REMOTE_CONFIG_SCHEMA_VERSION,
-      chatId: doc.chatId,
-      allowedUserIds: [...new Set(ids)],
-      orphanMs: orphan.value,
-      runTimeoutMs: run.value
-    }
-  };
-}
-function loadRemoteConfig(dir) {
-  const file = remoteConfigPath(dir);
-  const read = readConfigFile(file);
-  if (!read.ok) {
-    return {
-      ok: false,
-      reason: read.reason === "absent" ? `no remote-control config at ${file}; create it with chatId and allowedUserIds` : `remote-control config at ${file} cannot be read (${read.reason})`
-    };
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(read.text);
-  } catch {
-    return { ok: false, reason: `remote-control config at ${file} is not valid JSON` };
-  }
-  return parseRemoteConfig(parsed);
-}
-function saveRemoteConfig(config, dir) {
-  const checked = parseRemoteConfig(config);
-  if (!checked.ok) {
-    return checked;
-  }
-  ensureRemoteDir(dir);
-  writeOwnerOnlyFileAtomic(remoteConfigPath(dir), `${JSON.stringify(checked.value, null, 2)}
-`);
-  return checked;
-}
-function loadBotToken(dir) {
-  const file = botTokenPath(dir);
-  let mode;
-  try {
-    const stats = statSync17(file);
-    if (!stats.isFile()) {
-      return { ok: false, reason: `bot token path ${file} is not a regular file` };
-    }
-    mode = stats.mode & 511;
-  } catch {
-    return {
-      ok: false,
-      reason: `no bot token file at ${file}; put the token on one line in it and run: chmod 600 ${file}`
-    };
-  }
-  if (process.platform !== "win32" && (mode & 63) !== 0) {
-    return {
-      ok: false,
-      reason: `bot token file ${file} is accessible to other users (mode ${mode.toString(8)}); run: chmod 600 ${file}`
-    };
-  }
-  const read = readConfigFile(file);
-  if (!read.ok) {
-    return { ok: false, reason: `bot token file ${file} cannot be read (${read.reason})` };
-  }
-  const token = read.text.trim();
-  if (!TOKEN_SHAPE2.test(token)) {
-    return {
-      ok: false,
-      reason: `bot token file ${file} does not hold a bot token (expected <digits>:<secret> on a single line)`
-    };
-  }
-  return { ok: true, value: token };
-}
-function saveBotToken(token, dir) {
-  const trimmed = token.trim();
-  if (!TOKEN_SHAPE2.test(trimmed)) {
-    return { ok: false, reason: "that does not look like a bot token (expected <digits>:<secret>, as BotFather gives it)" };
-  }
-  const file = botTokenPath(dir);
-  try {
-    ensureRemoteDir(dir);
-    writeOwnerOnlyFileAtomic(file, `${trimmed}
-`);
-  } catch {
-    return { ok: false, reason: `could not write the bot token file at ${file}` };
-  }
-  return { ok: true, value: true };
-}
-function removeFile2(file) {
-  try {
-    unlinkSync6(file);
-    return true;
-  } catch (error) {
-    return error.code === "ENOENT";
-  }
-}
-function removeBotToken(dir) {
-  return removeFile2(botTokenPath(dir));
-}
-function removeRemoteConfig(dir) {
-  return removeFile2(remoteConfigPath(dir));
-}
-var REMOTE_CONFIG_SCHEMA_VERSION = 1, DEFAULT_ORPHAN_MS, DEFAULT_RUN_TIMEOUT_MS, MAX_TIMEOUT_MS3, CONFIG_KEYS2, TOKEN_SHAPE2;
-var init_config11 = __esm(() => {
-  init_config_dir();
-  init_paths4();
-  DEFAULT_ORPHAN_MS = 10 * 60000;
-  DEFAULT_RUN_TIMEOUT_MS = 30 * 60000;
-  MAX_TIMEOUT_MS3 = 7 * 24 * 60 * 60000;
-  CONFIG_KEYS2 = new Set(["schemaVersion", "chatId", "allowedUserIds", "orphanMs", "runTimeoutMs"]);
-  TOKEN_SHAPE2 = /^\d{5,}:[A-Za-z0-9_-]{20,}$/;
-});
-
 // src/remote/channels-client.ts
 function fileExists(file) {
   const read = readConfigFile(file);
@@ -116589,6 +116759,7 @@ async function loadChannelsSnapshot(client) {
       configured: telegram.state !== "not-connected" || local.tokenFile || local.configFile,
       machine,
       sessions: telegram.sessions,
+      ...telegram.rendering !== undefined ? { rendering: telegram.rendering } : {},
       ...telegram.reason !== undefined ? { reason: telegram.reason } : {}
     };
   }
@@ -116619,6 +116790,19 @@ function projectChannelsRow(snapshot, width) {
       return { text: fit2("off", width), role: "muted", action: "open" };
   }
 }
+function clock(at) {
+  return `${new Date(at).toISOString().slice(11, 19)} UTC`;
+}
+function renderingLines(rendering) {
+  if (rendering === undefined)
+    return [];
+  const last = rendering.lastFallback;
+  const step = last?.step === "rich-to-html" ? "rich to HTML" : "HTML to plain text";
+  return [
+    `Rendering: ${rendering.mode} (${RENDERING_MEANING2[rendering.mode]}). Change it in /settings.`,
+    last === undefined ? "Last fallback: none since keryx serve started." : `Last fallback: ${step} at ${clock(last.at)}: ${last.reason}`
+  ];
+}
 function channelsStatusLines(snapshot) {
   const machine = snapshot.machine === undefined ? [] : [`Machine: ${snapshot.machine}`];
   switch (snapshot.state) {
@@ -116642,6 +116826,7 @@ function channelsStatusLines(snapshot) {
         "Telegram: connected",
         ...machine,
         `Sessions in Telegram: ${snapshot.sessions ?? 0}`,
+        ...renderingLines(snapshot.rendering),
         "Test sends one message to the General topic. Disconnect deletes the topics and erases the token.",
         "Sessions join through /remote-control in each shell."
       ];
@@ -116650,6 +116835,7 @@ function channelsStatusLines(snapshot) {
         "Telegram: configured, but not running",
         ...machine,
         ...snapshot.reason === undefined ? [] : [`Why: ${snapshot.reason}`],
+        ...renderingLines(snapshot.rendering),
         "Retry starts it again from the saved token and config. Disconnect erases them. Test works once Telegram is running."
       ];
     case "serve-down":
@@ -117322,7 +117508,7 @@ function mountChannelsPanel(otui, renderer, parent, options) {
     }
   };
 }
-var CHANNELS_COMMAND = "/channels", CHANNELS_USAGE, CHANNELS_FOOTER, TOKEN_CHAR, TOKEN_MAX = 200, PAIRING_POLL_MS = 2000, swallow = (event) => {
+var CHANNELS_COMMAND = "/channels", CHANNELS_USAGE, RENDERING_MEANING2, CHANNELS_FOOTER, TOKEN_CHAR, TOKEN_MAX = 200, PAIRING_POLL_MS = 2000, swallow = (event) => {
   event.preventDefault?.();
   event.stopPropagation?.();
 }, CHANNELS_ROW_POLL_MS = 1e4;
@@ -117334,6 +117520,12 @@ var init_channels_surface = __esm(() => {
   init_theme_repaint();
   init_theme_text();
   CHANNELS_USAGE = `Usage: ${CHANNELS_COMMAND} [status]`;
+  RENDERING_MEANING2 = {
+    auto: "rich for a reply with a table, HTML otherwise",
+    rich: "every reply as a rich message",
+    html: "every reply as Telegram HTML",
+    plain: "every reply as plain text"
+  };
   CHANNELS_FOOTER = [
     { key: "c", label: "connect" },
     { key: "t", label: "test" },
@@ -117394,19 +117586,19 @@ function formatRemoteStatusLines(status) {
   lines.push(`Turn it off with ${REMOTE_CONTROL_COMMAND} off, or press o here. Rename: ${REMOTE_CONTROL_COMMAND} off, then ${REMOTE_CONTROL_COMMAND} <name>.`);
   return lines;
 }
-function clock(at) {
+function clock2(at) {
   return new Date(at).toISOString().slice(11, 19);
 }
 function formatRemoteEventLines(status) {
   if (status.events.length === 0)
     return ["No remote events yet."];
-  return [...status.events].reverse().slice(0, REMOTE_EVENT_LIMIT).map((event) => `${clock(event.at)}  ${event.kind.padEnd(8)} ${event.text}`);
+  return [...status.events].reverse().slice(0, REMOTE_EVENT_LIMIT).map((event) => `${clock2(event.at)}  ${event.kind.padEnd(8)} ${event.text}`);
 }
 function formatRemoteCommandLines(status) {
   const commands = status.events.filter((event) => event.kind === "command");
   if (commands.length === 0)
     return ["No remote commands yet."];
-  return [...commands].reverse().slice(0, REMOTE_EVENT_LIMIT).map((event) => `${clock(event.at)}  ${event.text}`);
+  return [...commands].reverse().slice(0, REMOTE_EVENT_LIMIT).map((event) => `${clock2(event.at)}  ${event.text}`);
 }
 function renderRemoteControlText(status) {
   return `${[...formatRemoteStatusLines(status), "", "Recent events:", ...formatRemoteEventLines(status)].join(`
@@ -117802,6 +117994,11 @@ var init_agent_commands = __esm(() => {
       description: "Connect, test or disconnect Telegram for this machine: /channels [status]",
       modes: AGENT_ONLY
     },
+    {
+      name: "/rendering",
+      description: "How Telegram replies are written: /rendering [auto|rich|html|plain]",
+      modes: AGENT_ONLY
+    },
     {
       name: "/product",
       description: "Intents closed in code that nobody looked back at, with their outcome criteria",
@@ -137858,6 +138055,9 @@ async function runSettingsCommand(command, handlers) {
       case "/external-agents":
         handlers.onSystem(await handlers.externalAgents(arg));
         return;
+      case "/rendering":
+        handlers.onSystem(handlers.rendering(arg));
+        return;
       case "/reasoning":
         handlers.reasoning(arg);
         return;
@@ -152857,6 +153057,7 @@ ${formatThemeList(getThemeId())}`);
       route: setRoutingEnabled,
       external: setExternalEnabled,
       externalAgents: (arg) => runExternalAgentsCommand(arg, sessionCwd),
+      rendering: (arg) => runRenderingCommand(arg),
       reasoning: runReasoningCommand,
       think: runThinkCommand,
       theme: runThemeCommand,
@@ -153949,6 +154150,11 @@ ${formatThemeList(getThemeId())}`);
           showEditGuard();
           return;
         }
+        if (isRenderingCommand(command.name)) {
+          const arg = line.trim().split(/\s+/).slice(1).join(" ");
+          io.onSystem?.(runRenderingCommand(arg));
+          return;
+        }
         if (isExternalAgentsCommand(command.name)) {
           const arg = line.trim().split(/\s+/).slice(1).join(" ");
           trackCommandWork(() => runExternalAgentsCommand(arg, opts.session?.cwd ?? process.cwd()).then((text) => io.onSystem?.(text)));
@@ -154788,6 +154994,7 @@ var init_tui_shell = __esm(() => {
   init_turn_guard();
   init_routing_classifier_source();
   init_external_command();
+  init_rendering_command();
   init_external_switch();
   init_external_providers();
   init_jev_client();
@@ -157363,6 +157570,8 @@ ${GUTTER}${turnSeparator()}
           agentIo.onSystem?.(readlineRemoteControlText(line));
         } else if (isChannelsCommand(command)) {
           agentIo.onSystem?.(readlineChannelsText(line, await loadChannelsSnapshot(new ChannelsClient)));
+        } else if (isRenderingCommand(command)) {
+          agentIo.onSystem?.(runRenderingCommand(rest));
         } else if (isSessionInfoCommand(command)) {
           const cwd = sessionCwd;
           const [workspaces, flows] = await Promise.all([
@@ -158485,6 +158694,7 @@ var init_shell = __esm(() => {
   init_statusbar();
   init_metaproject_state();
   init_live_render();
+  init_rendering_command();
   init_settings_model();
   init_settings_state();
   init_theme();
@@ -158565,6 +158775,7 @@ var init_shell = __esm(() => {
     "/reviews",
     "/remote-control",
     "/channels",
+    "/rendering",
     "/theme",
     "/settings",
     "/mode",
@@ -181413,6 +181624,25 @@ var init_command_registry = __esm(() => {
         "does not touch content already relayed to an agent, exported copies, or git history"
       ]
     },
+    {
+      module: "remote",
+      command: "remote format-sample",
+      summary: "Print the fixed sample reply (a table, lists, a rule) the way each Telegram rendering mode sends it. No network, no token.",
+      intent: [
+        "\u043A\u0430\u043A \u0432\u044B\u0433\u043B\u044F\u0434\u0438\u0442 \u043E\u0442\u0432\u0435\u0442 \u0432 \u0442\u0435\u043B\u0435\u0433\u0440\u0430\u043C\u0435",
+        "remote format-sample",
+        "preview telegram rendering",
+        "how are tables rendered in telegram",
+        "show the telegram sample reply"
+      ],
+      args: [
+        { name: "mode", type: "string", required: false, desc: "only this mode: auto, rich, html or plain" },
+        { name: "full", type: "bool", required: false, desc: "print the whole rich message instead of a count of its blocks" },
+        { name: "json", type: "bool", required: false, desc: "structured sample source and per-mode parts" }
+      ],
+      json: true,
+      read: true
+    },
     {
       module: "bus",
       command: "bus list",
@@ -192707,6 +192937,24 @@ function createHttpBotApi(options) {
       }
       return call("sendMessage", body);
     },
+    async sendRichMessage(params) {
+      const body = { chat_id: params.chatId, rich_message: params.richMessage };
+      if (params.messageThreadId !== undefined) {
+        body.message_thread_id = params.messageThreadId;
+      }
+      if (params.inlineKeyboard !== undefined) {
+        body.reply_markup = { inline_keyboard: params.inlineKeyboard };
+      }
+      return call("sendRichMessage", body);
+    },
+    async editRichMessage(params) {
+      await call("editMessageText", {
+        chat_id: params.chatId,
+        message_id: params.messageId,
+        rich_message: params.richMessage,
+        reply_markup: { inline_keyboard: params.inlineKeyboard ?? [] }
+      });
+    },
     async editMessageReplyMarkup(params) {
       await call("editMessageReplyMarkup", {
         chat_id: params.chatId,
@@ -192787,6 +193035,187 @@ var init_bot_api_http = __esm(() => {
   init_types11();
 });
 
+// src/remote/format-blocks.ts
+var HEADING2, BULLET, ORDERED, QUOTE, RULE, TASK, UNCHECKED_BOX = "\u2610", CHECKED_BOX = "\u2611", RULE_GLYPH = "\u2500", RULE_LENGTH = 12;
+var init_format_blocks = __esm(() => {
+  HEADING2 = /^ {0,3}#{1,6}[ \t]+(.*?)(?:[ \t]+#+)?[ \t]*$/;
+  BULLET = /^([ \t]*)[-*][ \t]+(.*)$/;
+  ORDERED = /^([ \t]*)(\d{1,9})([.)])[ \t]+(.*)$/;
+  QUOTE = /^ {0,3}>(?: (.*))?$/;
+  RULE = /^ {0,3}-{3,}[ \t]*$/;
+  TASK = /^\[([ xX])\](?:[ \t]+(.*))?$/;
+});
+
+// src/remote/format-table.ts
+function splitRow(line) {
+  const cells = [];
+  let current = "";
+  let sawPipe = false;
+  for (let index = 0;index < line.length; index += 1) {
+    const char = line[index];
+    if (char === "\\" && line[index + 1] === "|") {
+      current += "|";
+      index += 1;
+      continue;
+    }
+    if (char === "|") {
+      sawPipe = true;
+      cells.push(current);
+      current = "";
+      continue;
+    }
+    current += char;
+  }
+  if (!sawPipe) {
+    return;
+  }
+  cells.push(current);
+  if (cells[0]?.trim() === "") {
+    cells.shift();
+  }
+  if (cells.length > 0 && cells[cells.length - 1]?.trim() === "") {
+    cells.pop();
+  }
+  return cells.map((cell) => cell.trim());
+}
+function separatorAlign(line) {
+  const cells = splitRow(line);
+  if (cells === undefined || cells.length === 0) {
+    return;
+  }
+  const align = [];
+  for (const cell of cells) {
+    const match = SEPARATOR_CELL.exec(cell);
+    if (match === null) {
+      return;
+    }
+    align.push(match[1] !== undefined && match[2] !== undefined ? "center" : match[2] !== undefined ? "right" : "left");
+  }
+  return align;
+}
+function endsTable(line) {
+  return line.trim().length === 0 || !line.includes("|");
+}
+function fitRow(cells, width) {
+  const row = cells.slice(0, width);
+  while (row.length < width) {
+    row.push("");
+  }
+  return row;
+}
+function tableAt(lines, start) {
+  const headerLine = lines[start];
+  const separatorLine = lines[start + 1];
+  if (headerLine === undefined || separatorLine === undefined || endsTable(headerLine)) {
+    return;
+  }
+  const header = splitRow(headerLine);
+  const align = separatorAlign(separatorLine);
+  if (header === undefined || align === undefined || header.length !== align.length || header.length > MAX_TABLE_COLUMNS) {
+    return;
+  }
+  const rows = [];
+  let end = start + 2;
+  while (end < lines.length && !endsTable(lines[end])) {
+    const cells = splitRow(lines[end]);
+    if (cells === undefined) {
+      break;
+    }
+    rows.push(fitRow(cells, header.length));
+    end += 1;
+  }
+  return { table: { header, align, rows }, end };
+}
+function plainCell(text) {
+  return text.replace(/\[([^\]]*)\]\((https?:\/\/[^\s)]*)\)/g, (_all, label, url) => label.trim().length > 0 ? `${label} (${url})` : url).replace(/(\*\*|__|~~)(.+?)\1/g, "$2").replace(/`+([^`]+)`+/g, "$1").replace(/<br\s*\/?>/gi, " ").trim();
+}
+function columnWidths(table) {
+  return table.header.map((cell, column) => {
+    let widest = visualWidth(plainCell(cell));
+    for (const row of table.rows) {
+      widest = Math.max(widest, visualWidth(plainCell(row[column])));
+    }
+    return widest;
+  });
+}
+function pad4(text, width, align) {
+  const gap = Math.max(0, width - visualWidth(text));
+  if (align === "right") {
+    return `${" ".repeat(gap)}${text}`;
+  }
+  if (align === "center") {
+    const left = Math.floor(gap / 2);
+    return `${" ".repeat(left)}${text}${" ".repeat(gap - left)}`;
+  }
+  return `${text}${" ".repeat(gap)}`;
+}
+function renderTableRow(cells, widths, align) {
+  return cells.map((cell, column) => pad4(plainCell(cell), widths[column], align[column])).join(COLUMN_GAP).trimEnd();
+}
+function alignedCosts(table) {
+  const widths = columnWidths(table);
+  return { header: renderedRowCost(table.header, widths), rows: table.rows.map((row) => renderedRowCost(row, widths)) };
+}
+function tableLayout(table) {
+  const costs = alignedCosts(table);
+  return [costs.header, ...costs.rows].some((cost) => cost > MAX_TABLE_ROW_COST) ? "stacked" : "aligned";
+}
+function stackedRowLines(table, row) {
+  const lines = [];
+  row.forEach((cell, column) => {
+    const text = plainCell(cell);
+    if (text.length > 0) {
+      lines.push(`${plainCell(table.header[column])}: ${text}`);
+    }
+  });
+  return lines.length > 0 ? lines : ["(empty)"];
+}
+function renderStackedLines(table) {
+  if (table.rows.length === 0) {
+    return [table.header.map(plainCell).join(COLUMN_GAP).trim()];
+  }
+  return table.rows.flatMap((row, index) => index === 0 ? stackedRowLines(table, row) : ["", ...stackedRowLines(table, row)]);
+}
+function renderTableLines(table, widths) {
+  if (widths === undefined && tableLayout(table) === "stacked") {
+    return renderStackedLines(table);
+  }
+  const use = widths ?? columnWidths(table);
+  return [table.header, ...table.rows].map((row) => renderTableRow(row, use, table.align));
+}
+function renderedRowCost(cells, widths) {
+  let cost = 1;
+  cells.forEach((cell, column) => {
+    const text = plainCell(cell);
+    cost += text.length + Math.max(0, widths[column] - visualWidth(text));
+    if (column > 0) {
+      cost += COLUMN_GAP.length;
+    }
+  });
+  return cost;
+}
+function tableCosts(table) {
+  const aligned = alignedCosts(table);
+  if (tableLayout(table) === "aligned") {
+    return aligned;
+  }
+  return {
+    header: Math.min(aligned.header, MAX_TABLE_ROW_COST),
+    rows: table.rows.map((row, index) => {
+      let stacked = 1;
+      stackedRowLines(table, row).forEach((line) => {
+        stacked += line.length + 1;
+      });
+      return Math.max(stacked, Math.min(aligned.rows[index], MAX_TABLE_ROW_COST));
+    })
+  };
+}
+var MAX_TABLE_COLUMNS = 20, MAX_TABLE_ROW_COST = 1500, SEPARATOR_CELL, COLUMN_GAP = " \u2502 ";
+var init_format_table = __esm(() => {
+  init_md_blocks();
+  SEPARATOR_CELL = /^\s*(:)?-+(:)?\s*$/;
+});
+
 // src/remote/format.ts
 function fenceOpening(line) {
   const match = FENCE_LINE2.exec(line);
@@ -192834,13 +193263,40 @@ function cutAt(text, max) {
 }
 function toPieces(text, capacity) {
   const pieces = [];
+  const raws = text.split(/(?<=\n)/);
+  const bare = raws.map((raw) => raw.endsWith(`
+`) ? raw.slice(0, -1) : raw);
   let fence;
-  for (const raw of text.split(/(?<=\n)/)) {
-    const line = raw.endsWith(`
-`) ? raw.slice(0, -1) : raw;
+  for (let at = 0;at < raws.length; at += 1) {
+    const raw = raws[at];
+    const line = bare[at];
     const before = fence;
     if (fence === undefined) {
       fence = openingFence(line);
+      if (fence === undefined) {
+        const found = tableAt(bare, at);
+        if (found !== undefined) {
+          const costs = tableCosts(found.table);
+          const headerCost = costs.header;
+          const widest = Math.max(...costs.rows, 0);
+          if (headerCost + widest <= capacity) {
+            const run = { headerSource: `${raw}${raws[at + 1]}`, headerCost };
+            const rows = found.table.rows;
+            const leadEnd = at + 2 + (rows.length > 0 ? 1 : 0);
+            pieces.push({
+              text: raws.slice(at, leadEnd).join(""),
+              fence: undefined,
+              cost: headerCost + (costs.rows[0] ?? 0),
+              table: run
+            });
+            for (let row = leadEnd;row < found.end; row += 1) {
+              pieces.push({ text: raws[row], fence: undefined, cost: costs.rows[row - at - 2], table: run });
+            }
+            at = found.end - 1;
+            continue;
+          }
+        }
+      }
     } else if (closesFence(line, fence)) {
       fence = undefined;
     }
@@ -192848,24 +193304,33 @@ function toPieces(text, capacity) {
     let rest = raw;
     while (rest.length > room) {
       const cut = cutAt(rest, room);
-      pieces.push({ text: rest.slice(0, cut), fence: before ?? fence });
+      pieces.push({ text: rest.slice(0, cut), fence: before ?? fence, cost: cut });
       rest = rest.slice(cut);
     }
     if (rest.length > 0) {
-      pieces.push({ text: rest, fence });
+      const rule = before === undefined && fence === undefined && RULE.test(line);
+      pieces.push({ text: rest, fence, cost: rule ? Math.max(rest.length, RULE_LENGTH + (rest.endsWith(`
+`) ? 1 : 0)) : rest.length });
     }
   }
   return pieces;
 }
+function renderedLength(text) {
+  return toPieces(text.replace(/\r\n?/g, `
+`), Number.POSITIVE_INFINITY).reduce((sum, piece) => sum + piece.cost, 0);
+}
 function pack(text, capacity) {
   const parts = [];
   let current = "";
+  let used = 0;
   let hasContent = false;
   let open;
-  const finish = () => {
+  let lastTable;
+  const finish = (next) => {
     let body = current.trimEnd();
     if (!hasContent || body.length === 0) {
       current = "";
+      used = 0;
       hasContent = false;
       return;
     }
@@ -192876,6 +193341,11 @@ ${open.marker}`;
     parts.push(body);
     current = open === undefined ? "" : `${open.header}
 `;
+    used = open === undefined ? 0 : open.header.length + 1;
+    if (open === undefined && next?.table !== undefined && next.table === lastTable) {
+      current = next.table.headerSource;
+      used = next.table.headerCost;
+    }
     hasContent = false;
   };
   for (const piece of toPieces(text, capacity)) {
@@ -192883,15 +193353,17 @@ ${open.marker}`;
       continue;
     }
     const closing = piece.fence === undefined ? 0 : piece.fence.marker.length + 1;
-    if (hasContent && current.length + piece.text.length + closing > capacity) {
-      finish();
+    if (hasContent && used + piece.cost + closing > capacity) {
+      finish(piece);
       if (piece.text.trim().length === 0) {
         continue;
       }
     }
     current += piece.text;
+    used += piece.cost;
     hasContent = true;
     open = piece.fence;
+    lastTable = piece.table;
   }
   finish();
   return parts;
@@ -192905,7 +193377,7 @@ function formatReply(text, limit = TELEGRAM_MAX_TEXT) {
   if (text.trim().length === 0) {
     return [];
   }
-  if (text.length <= limit) {
+  if (renderedLength(text) <= limit) {
     return [text];
   }
   for (let digits = 1;digits <= 3; digits += 1) {
@@ -192926,10 +193398,101 @@ ${part}`);
 }
 var MIN_LIMIT = 64, MAX_FENCE_MARKER = 16, MAX_FENCE_INFO = 40, FENCE_LINE2;
 var init_format2 = __esm(() => {
+  init_format_blocks();
+  init_format_table();
   init_types11();
   FENCE_LINE2 = /^ {0,3}(`{3,}|~{3,})(.*)$/;
 });
 
+// src/remote/format-link.ts
+function parse(text) {
+  try {
+    const url = new URL(text);
+    return { host: normalise3(url.hostname), userinfo: url.username !== "" || url.password !== "" };
+  } catch {
+    const authority = /^[a-z][a-z0-9+.-]*:\/\/([^/?#]*)/i.exec(text)?.[1] ?? text.split(/[/?#]/, 1)[0] ?? "";
+    const at = authority.lastIndexOf("@");
+    const host = (at < 0 ? authority : authority.slice(at + 1)).replace(/:\d*$/, "");
+    return { host: normalise3(host), userinfo: at >= 0 };
+  }
+}
+function normalise3(host) {
+  return host.toLowerCase().replace(/\.$/, "").replace(/^www\./, "");
+}
+function bare(label) {
+  return label.replace(/^[\s*_~`]+|[\s*_~`]+$/g, "");
+}
+function looksLikeAddress(label) {
+  return SCHEME.test(label) || /^www\./i.test(label) || HOST_LIKE.test(label) && !FILE_EXTENSION.test(label);
+}
+function mismatchedHost(label, url) {
+  const text = bare(label);
+  if (!looksLikeAddress(text)) {
+    return;
+  }
+  const target = parse(url);
+  const shown = parse(SCHEME.test(text) ? text : `https://${text}`);
+  if (target.host.length === 0) {
+    return;
+  }
+  if (!target.userinfo && !shown.userinfo && shown.host === target.host) {
+    return;
+  }
+  const room = Math.max(1, url.length - 1);
+  return target.host.length > room ? `${target.host.slice(0, room - 1)}\u2026` : target.host;
+}
+function hostMarker(label, url) {
+  const host = mismatchedHost(label, url);
+  return host === undefined ? "" : ` (\u2192 ${host})`;
+}
+var SCHEME, HOST_LIKE, FILE_EXTENSION;
+var init_format_link = __esm(() => {
+  SCHEME = /^https?:\/\//i;
+  HOST_LIKE = /^[\p{L}\p{N}-]+(?:\.[\p{L}\p{N}-]+)*\.\p{L}{2,}(?::\d+)?(?:[/?#]\S*)?$/u;
+  FILE_EXTENSION = /\.(?:md|mdx|txt|json|jsonc|ya?ml|toml|lock|log|csv|tsv|xml|html?|css|scss|less|[cm]?[jt]sx?|py|rb|rs|go|java|kt|swift|sh|zsh|bash|sql|png|jpe?g|gif|svg|webp|pdf|zip|tgz|gz|ini|env|conf|cfg)(?:[?#]\S*)?$/i;
+});
+
+// src/remote/format-plain.ts
+function renderPlainText(part) {
+  if (!part.includes("|")) {
+    return part;
+  }
+  const lines = part.split(`
+`);
+  const bare = lines.map((entry) => entry.replace(/\r$/, ""));
+  const out = [];
+  let fence;
+  let changed = false;
+  let index = 0;
+  while (index < lines.length) {
+    const line = lines[index];
+    if (fence !== undefined) {
+      if (closesFence(line, fence)) {
+        fence = undefined;
+      }
+      out.push(line);
+      index += 1;
+      continue;
+    }
+    fence = fenceOpening(line);
+    const found = fence === undefined ? tableAt(bare, index) : undefined;
+    if (found === undefined) {
+      out.push(line);
+      index += 1;
+      continue;
+    }
+    out.push(...renderTableLines(found.table));
+    changed = true;
+    index = found.end;
+  }
+  return changed ? out.join(`
+`) : part;
+}
+var init_format_plain = __esm(() => {
+  init_format2();
+  init_format_table();
+});
+
 // src/remote/format-html.ts
 function escapeHtml2(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
@@ -193063,7 +193626,8 @@ function link(text, index, context) {
   if (!HTTP_URL.test(url)) {
     return;
   }
-  return { html: `<a href="${escapeAttribute(url)}">${renderInline2(label, { ...context, link: true })}</a>`, end };
+  const marker = escapeHtml2(hostMarker(label, url));
+  return { html: `<a href="${escapeAttribute(url)}">${renderInline2(label, { ...context, link: true })}</a>${marker}`, end };
 }
 function renderInline2(text, context) {
   let out = "";
@@ -193175,7 +193739,19 @@ function renderTelegramHtml(part) {
       }
       continue;
     }
+    const found = tableAt(lines, index);
+    if (found !== undefined) {
+      const text = escapeHtml2(renderTableLines(found.table).join(`
+`));
+      push(tableLayout(found.table) === "aligned" ? `<pre>${text}</pre>` : text, true);
+      index = found.end;
+      continue;
+    }
     index += 1;
+    if (RULE.test(line)) {
+      push(RULE_GLYPH.repeat(RULE_LENGTH), false);
+      continue;
+    }
     const heading = HEADING2.exec(line);
     if (heading !== null && heading[1].trim().length > 0) {
       push(`<b>${renderInline2(heading[1], { ...OUTSIDE, bold: true })}</b>`, false);
@@ -193183,6 +193759,13 @@ function renderTelegramHtml(part) {
     }
     const bullet = BULLET.exec(line);
     if (bullet !== null) {
+      const task = TASK.exec(bullet[2]);
+      if (task !== null) {
+        const box = task[1] === " " ? UNCHECKED_BOX : CHECKED_BOX;
+        const label = renderInline2(task[2] ?? "", OUTSIDE);
+        push(`${bullet[1]}${box}${label.length > 0 ? ` ${label}` : ""}`, false);
+        continue;
+      }
       push(`${bullet[1]}\u2022 ${renderInline2(bullet[2], OUTSIDE)}`, false);
       continue;
     }
@@ -193190,6 +193773,93 @@ function renderTelegramHtml(part) {
   }
   return out;
 }
+function unescapeEntities(text) {
+  return text.replace(/&(amp|lt|gt|quot|#\d{1,7}|#x[0-9a-f]{1,6});/gi, (_all, name) => {
+    switch (name.toLowerCase()) {
+      case "amp":
+        return "&";
+      case "lt":
+        return "<";
+      case "gt":
+        return ">";
+      case "quot":
+        return '"';
+      default:
+        return String.fromCodePoint(name[1] === "x" || name[1] === "X" ? Number.parseInt(name.slice(2), 16) : Number.parseInt(name.slice(1), 10));
+    }
+  });
+}
+function checkTelegramHtml(html) {
+  const stack = [];
+  let text = "";
+  let index = 0;
+  const fail = (reason) => ({ ok: false, reason: `can't parse entities: ${reason} at byte offset ${index}` });
+  while (index < html.length) {
+    const char = html[index];
+    if (char === "&") {
+      const entity = ENTITY.exec(html.slice(index, index + 12));
+      if (entity === null) {
+        return fail("unescaped &");
+      }
+      text += unescapeEntities(entity[0]);
+      index += entity[0].length;
+      continue;
+    }
+    if (char === ">") {
+      return fail("unescaped >");
+    }
+    if (char !== "<") {
+      text += char;
+      index += 1;
+      continue;
+    }
+    const match = TAG.exec(html.slice(index));
+    if (match === null) {
+      return fail("unsupported start tag");
+    }
+    const closing = match[1] === "/";
+    const name = match[2].toLowerCase();
+    const attributes = match[3].trim();
+    const top = stack[stack.length - 1];
+    if (closing) {
+      if (attributes.length > 0 || top === undefined || top.name !== name) {
+        return fail(`can't find start tag for </${name}>`);
+      }
+      stack.pop();
+      index += match[0].length;
+      continue;
+    }
+    const known = SIMPLE_TAGS.has(name) || ["a", "code", "pre", "span", "blockquote"].includes(name);
+    if (!known) {
+      return fail(`unsupported start tag "${name}"`);
+    }
+    if (stack.some((entry) => entry.name === "code") || top?.name === "pre" && name !== "code") {
+      return fail(`<${name}> inside code or pre`);
+    }
+    if (name === "code" || name === "pre") {
+      const holder = stack.find((entry) => entry.name !== "blockquote" && !(name === "code" && entry === top && entry.name === "pre"));
+      if (holder !== undefined) {
+        return fail(`<${name}> inside <${holder.name}>`);
+      }
+    }
+    if (name === "pre" && stack.some((entry) => entry.name !== "blockquote")) {
+      return fail("pre inside another entity");
+    }
+    if (name === "blockquote" && stack.some((entry) => entry.name === "blockquote") || name === "a" && stack.some((entry) => entry.name === "a")) {
+      return fail(`<${name}> nested in itself`);
+    }
+    const attributeOk = SIMPLE_TAGS.has(name) || name === "pre" ? attributes.length === 0 : name === "a" ? /^href="[^"<>]+"$/.test(attributes) : name === "code" ? attributes.length === 0 || /^class="language-[A-Za-z0-9_+#.-]+"$/.test(attributes) : name === "span" ? attributes === 'class="tg-spoiler"' : attributes.length === 0 || attributes === "expandable";
+    if (!attributeOk) {
+      return fail(`bad attributes on <${name}>`);
+    }
+    stack.push({ name });
+    index += match[0].length;
+  }
+  if (stack.length > 0) {
+    return fail(`can't find end tag for <${stack[stack.length - 1].name}>`);
+  }
+  return { ok: true, text };
+}
 function isEntityParseError(error) {
   return isBotApiError(error) && error.kind === "rejected" && error.status === 400 && /can't parse entities/i.test(error.message);
 }
@@ -193204,7 +193874,7 @@ async function sendHtml(api, params, onFallback) {
     try {
       onFallback?.(error);
     } catch {}
-    return api.sendMessage(plain);
+    return api.sendMessage({ ...plain, text: renderPlainText(plain.text) });
   }
 }
 async function editHtml(api, params, onFallback) {
@@ -193217,15 +193887,19 @@ async function editHtml(api, params, onFallback) {
     try {
       onFallback?.(error);
     } catch {}
-    await api.editMessageText(params);
+    await api.editMessageText({ ...params, text: renderPlainText(params.text) });
   }
 }
 function isNotModified(error) {
   return isBotApiError(error) && error.kind === "rejected" && /message is not modified/i.test(error.message);
 }
-var OUTSIDE, WORD, ALNUM, SPACE, SINGLE_OPEN_BAD, SINGLE_CLOSE_BAD, HTTP_URL, LANGUAGE, EXPANDABLE_QUOTE_LINES = 8, TAGS2, HEADING2, BULLET, QUOTE, SIMPLE_TAGS;
+var OUTSIDE, WORD, ALNUM, SPACE, SINGLE_OPEN_BAD, SINGLE_CLOSE_BAD, HTTP_URL, LANGUAGE, EXPANDABLE_QUOTE_LINES = 8, TAGS2, SIMPLE_TAGS, TAG, ENTITY;
 var init_format_html = __esm(() => {
   init_format2();
+  init_format_blocks();
+  init_format_link();
+  init_format_plain();
+  init_format_table();
   init_types11();
   OUTSIDE = { bold: false, italic: false, strike: false, link: false };
   WORD = /[\p{L}\p{N}_]/u;
@@ -193236,10 +193910,9 @@ var init_format_html = __esm(() => {
   HTTP_URL = /^https?:\/\/[^\s<>"'`]+$/i;
   LANGUAGE = /^[A-Za-z0-9_+#.-]{1,32}$/;
   TAGS2 = { bold: "b", italic: "i", strike: "s" };
-  HEADING2 = /^ {0,3}#{1,6}[ \t]+(.*?)(?:[ \t]+#+)?[ \t]*$/;
-  BULLET = /^([ \t]*)[-*][ \t]+(.*)$/;
-  QUOTE = /^ {0,3}>(?: (.*))?$/;
   SIMPLE_TAGS = new Set(["b", "strong", "i", "em", "u", "ins", "s", "strike", "del"]);
+  TAG = /^<(\/?)([a-z][a-z-]*)((?:\s+[a-z-]+(?:="[^"<>]*")?)*)\s*>/i;
+  ENTITY = /^&(?:amp|lt|gt|quot|#\d{1,7}|#x[0-9a-f]{1,6});/i;
 });
 
 // src/remote/durable-log.ts
@@ -193556,6 +194229,512 @@ var init_journal3 = __esm(() => {
   init_paths4();
 });
 
+// src/remote/rich-types.ts
+var RICH_LIMITS;
+var init_rich_types = __esm(() => {
+  RICH_LIMITS = {
+    characters: 32768,
+    blocks: 500,
+    nesting: 16,
+    tableColumns: 20
+  };
+});
+
+// src/remote/format-rich.ts
+function unescape(text) {
+  return text.replace(/&(amp|lt|gt|quot);/g, (_all, name) => ({ amp: "&", lt: "<", gt: ">", quot: '"' })[name]);
+}
+function collapse(children) {
+  const merged = [];
+  for (const child of children) {
+    const last = merged[merged.length - 1];
+    if (typeof child === "string" && typeof last === "string") {
+      merged[merged.length - 1] = last + child;
+    } else {
+      merged.push(child);
+    }
+  }
+  if (merged.length === 0) {
+    return "";
+  }
+  return merged.length === 1 ? merged[0] : merged;
+}
+function htmlToRichText(html) {
+  const root = { type: "bold", children: [] };
+  const stack = [root];
+  const token = /<(\/?)(b|i|s|code|a)(?: href="([^"]*)")?>|([^<]+)/g;
+  for (let match = token.exec(html);match !== null; match = token.exec(html)) {
+    const top = stack[stack.length - 1];
+    if (match[4] !== undefined) {
+      top.children.push(unescape(match[4]));
+    } else if (match[1] === "/") {
+      const closed = stack.pop();
+      const text = collapse(closed.children);
+      const node = closed.type === "url" ? { type: "url", text, url: closed.url } : { type: closed.type, text };
+      stack[stack.length - 1].children.push(node);
+    } else {
+      stack.push({ type: TAG_TYPES[match[2]], ...match[3] === undefined ? {} : { url: unescape(match[3]) }, children: [] });
+    }
+  }
+  return collapse(root.children);
+}
+function inline(text) {
+  return htmlToRichText(renderInline2(text, OUTSIDE));
+}
+function isEmpty(text) {
+  return text === "" || Array.isArray(text) && text.length === 0;
+}
+function indentOf2(whitespace) {
+  return whitespace.replace(/\t/g, "    ").length;
+}
+function listEntry(line) {
+  const bullet = BULLET.exec(line);
+  if (bullet !== null) {
+    const task = TASK.exec(bullet[2]);
+    return {
+      indent: indentOf2(bullet[1]),
+      ordered: false,
+      ...task === null ? {} : { checkbox: task[1] === " " ? "open" : "done" },
+      text: task === null ? bullet[2] : task[2] ?? ""
+    };
+  }
+  const ordered = ORDERED.exec(line);
+  if (ordered !== null) {
+    return { indent: indentOf2(ordered[1]), ordered: true, number: Number.parseInt(ordered[2], 10), text: ordered[4] };
+  }
+  return;
+}
+function listItem(entry) {
+  const text = inline(entry.text);
+  return {
+    blocks: [{ type: "paragraph", text: isEmpty(text) ? " " : text }],
+    ...entry.checkbox === undefined ? {} : { has_checkbox: true, ...entry.checkbox === "done" ? { is_checked: true } : {} },
+    ...entry.ordered ? { value: entry.number, type: "1" } : {}
+  };
+}
+function buildLists(entries) {
+  const root = [];
+  const stack = [];
+  for (const entry of entries) {
+    while (stack.length > 0 && stack[stack.length - 1].indent > entry.indent) {
+      stack.pop();
+    }
+    let top = stack[stack.length - 1];
+    let parent;
+    if (top !== undefined && top.indent === entry.indent && top.ordered !== entry.ordered) {
+      parent = top.parent;
+      stack.pop();
+      top = stack[stack.length - 1];
+    }
+    if (top === undefined || top.indent < entry.indent || parent !== undefined) {
+      const holder = parent ?? (top === undefined ? root : top.items[top.items.length - 1].blocks);
+      const frame = { indent: entry.indent, ordered: entry.ordered, items: [], parent: holder };
+      holder.push({ type: "list", items: frame.items });
+      stack.push(frame);
+      top = frame;
+    }
+    top.items.push(listItem(entry));
+  }
+  return root;
+}
+function countBlocks(blocks, depth) {
+  let count = 0;
+  let deepest = depth;
+  for (const block of blocks) {
+    count += 1;
+    if (block.type === "list") {
+      for (const item of block.items) {
+        count += 1;
+        const inner = countBlocks(item.blocks, depth + 2);
+        count += inner.count;
+        deepest = Math.max(deepest, inner.depth);
+      }
+    } else if (block.type === "blockquote") {
+      const inner = countBlocks(block.blocks, depth + 1);
+      count += inner.count;
+      deepest = Math.max(deepest, inner.depth);
+    } else if (block.type === "table") {
+      count += block.cells.length;
+    }
+  }
+  return { count, depth: deepest };
+}
+function containsTable(part) {
+  const lines = part.replace(/\r\n?/g, `
+`).split(`
+`);
+  let fence;
+  for (let index = 0;index < lines.length; index += 1) {
+    const line = lines[index];
+    if (fence !== undefined) {
+      if (closesFence(line, fence)) {
+        fence = undefined;
+      }
+      continue;
+    }
+    fence = fenceOpening(line);
+    if (fence === undefined && tableAt(lines, index) !== undefined) {
+      return true;
+    }
+  }
+  return false;
+}
+function tableBlock(table) {
+  const cell = (text, column, header) => {
+    const content = inline(text.replace(/<br\s*\/?>/gi, " ").trim());
+    return {
+      ...isEmpty(content) ? {} : { text: content },
+      ...header ? { is_header: true } : {},
+      align: table.align[column],
+      valign: "top"
+    };
+  };
+  return {
+    type: "table",
+    is_bordered: true,
+    cells: [table.header.map((text, column) => cell(text, column, true)), ...table.rows.map((row) => row.map((text, column) => cell(text, column, false)))]
+  };
+}
+function renderRichMessage(part) {
+  const lines = part.replace(/\r\n?/g, `
+`).split(`
+`);
+  const blocks = [];
+  let index = 0;
+  while (index < lines.length) {
+    const line = lines[index];
+    const fence = fenceOpening(line);
+    if (fence !== undefined) {
+      const body = [];
+      let cursor = index + 1;
+      while (cursor < lines.length && !closesFence(lines[cursor], fence)) {
+        body.push(lines[cursor]);
+        cursor += 1;
+      }
+      const closed = cursor < lines.length;
+      const code = body.join(`
+`);
+      if (code.trim().length === 0) {
+        for (const raw of lines.slice(index, closed ? cursor + 1 : cursor)) {
+          blocks.push({ type: "paragraph", text: raw });
+        }
+      } else {
+        const language = fence.info.split(/\s+/)[0];
+        blocks.push({ type: "pre", text: code, ...LANGUAGE2.test(language) ? { language } : {} });
+      }
+      index = closed ? cursor + 1 : cursor;
+      continue;
+    }
+    if (QUOTE.test(line)) {
+      const quoted = [];
+      const start = index;
+      while (index < lines.length) {
+        const next = QUOTE.exec(lines[index]);
+        if (next === null) {
+          break;
+        }
+        quoted.push(next[1] ?? "");
+        index += 1;
+      }
+      if (quoted.every((entry) => entry.trim().length === 0)) {
+        for (const raw of lines.slice(start, index)) {
+          blocks.push({ type: "paragraph", text: raw });
+        }
+      } else if (quoted.length >= EXPANDABLE_QUOTE_LINES2) {
+        const text = [];
+        quoted.forEach((entry, position) => {
+          if (position > 0) {
+            text.push(`
+`);
+          }
+          text.push(inline(entry));
+        });
+        blocks.push({ type: "expandable_blockquote", text });
+      } else {
+        blocks.push({
+          type: "blockquote",
+          blocks: quoted.flatMap((entry) => {
+            const text = inline(entry);
+            return isEmpty(text) ? [] : [{ type: "paragraph", text }];
+          })
+        });
+      }
+      continue;
+    }
+    const found = tableAt(lines, index);
+    if (found !== undefined) {
+      blocks.push(tableBlock(found.table));
+      index = found.end;
+      continue;
+    }
+    if (listEntry(line) !== undefined && !RULE.test(line)) {
+      const entries = [];
+      while (index < lines.length) {
+        const entry = listEntry(lines[index]);
+        if (entry === undefined || RULE.test(lines[index])) {
+          break;
+        }
+        entries.push(entry);
+        index += 1;
+      }
+      blocks.push(...buildLists(entries));
+      continue;
+    }
+    index += 1;
+    if (RULE.test(line)) {
+      blocks.push({ type: "divider" });
+      continue;
+    }
+    const heading = HEADING2.exec(line);
+    if (heading !== null && heading[1].trim().length > 0) {
+      const level = line.trimStart().match(/^#+/)[0].length;
+      blocks.push({ type: "heading", text: inline(heading[1]), size: Math.min(level + 1, 6) });
+      continue;
+    }
+    const text = inline(line);
+    if (!isEmpty(text) && line.trim().length > 0) {
+      blocks.push({ type: "paragraph", text });
+    }
+  }
+  const measured = countBlocks(blocks, 1);
+  if (blocks.length === 0) {
+    throw new RichRenderError("nothing to send as a rich message");
+  }
+  if (measured.count > RICH_LIMITS.blocks) {
+    throw new RichRenderError(`${measured.count} blocks, over the limit of ${RICH_LIMITS.blocks}`);
+  }
+  if (measured.depth > RICH_LIMITS.nesting) {
+    throw new RichRenderError(`${measured.depth} nesting levels, over the limit of ${RICH_LIMITS.nesting}`);
+  }
+  return { blocks };
+}
+var RichRenderError, LANGUAGE2, EXPANDABLE_QUOTE_LINES2 = 8, TAG_TYPES;
+var init_format_rich = __esm(() => {
+  init_format_blocks();
+  init_format2();
+  init_format_html();
+  init_format_table();
+  init_rich_types();
+  RichRenderError = class RichRenderError extends Error {
+    constructor(message) {
+      super(message);
+      this.name = "RichRenderError";
+    }
+  };
+  LANGUAGE2 = /^[A-Za-z0-9_+#.-]{1,32}$/;
+  TAG_TYPES = { b: "bold", i: "italic", s: "strikethrough", code: "code", a: "url" };
+});
+
+// src/remote/rendering.ts
+function capReason(reason) {
+  return reason.length > MAX_REASON_LENGTH2 ? `${reason.slice(0, MAX_REASON_LENGTH2 - 1)}\u2026` : reason;
+}
+
+class RenderingState {
+  now;
+  readMode;
+  last;
+  pausedUntil = 0;
+  pauseReason;
+  serverKey;
+  serverFailures = 0;
+  constructor(options = {}) {
+    this.now = options.now ?? Date.now;
+    this.readMode = options.mode ?? (() => DEFAULT_RENDER_MODE);
+  }
+  mode() {
+    try {
+      return this.readMode();
+    } catch {
+      return DEFAULT_RENDER_MODE;
+    }
+  }
+  lastFallback() {
+    return this.last;
+  }
+  record(step, reason) {
+    this.last = { step, reason: capReason(redactSensitiveText(reason)), at: this.now() };
+    return this.last;
+  }
+  pauseRich(reason) {
+    this.pausedUntil = this.now() + RICH_PAUSE_MS;
+    this.pauseReason = capReason(redactSensitiveText(reason));
+  }
+  richServerFailure(key) {
+    this.serverFailures = this.serverKey === key ? this.serverFailures + 1 : 1;
+    this.serverKey = key;
+    return this.serverFailures;
+  }
+  richServerReset() {
+    this.serverKey = undefined;
+    this.serverFailures = 0;
+  }
+  richPausedReason() {
+    if (this.pausedUntil > this.now()) {
+      return this.pauseReason ?? "rich messages are paused";
+    }
+    return;
+  }
+  snapshot() {
+    return {
+      mode: this.mode(),
+      ...this.last === undefined ? {} : { lastFallback: this.last },
+      ...this.pausedUntil > this.now() ? { richPausedUntil: this.pausedUntil } : {}
+    };
+  }
+}
+function firstStep(mode, text) {
+  if (mode === "auto") {
+    return containsTable(text) ? "rich" : "html";
+  }
+  return mode;
+}
+function descriptionOf(error) {
+  return error.message.replace(/^\w+:\s*(?:\d{3}\s*)?/, "");
+}
+function describe(error) {
+  if (!isBotApiError(error)) {
+    return capReason(redactSensitiveText(error instanceof Error ? error.message : String(error)));
+  }
+  const text = redactSensitiveText(descriptionOf(error));
+  const cut = text.search(/["\u201c\u00ab`]/);
+  const head = (cut < 0 ? text : text.slice(0, cut)).replace(/[\s:,(]+$/, "");
+  return capReason(error.status === undefined ? head : `${error.status} ${head}`);
+}
+function isRefusal(error) {
+  return isBotApiError(error) && error.kind === "rejected";
+}
+function isStanding(error) {
+  if (!isBotApiError(error) || error.kind !== "rejected") {
+    return false;
+  }
+  const text = descriptionOf(error);
+  if (error.status === 404 || error.status === 405) {
+    return MENTIONS_RICH_METHOD.test(text) || !MENTIONS_CHAT.test(text);
+  }
+  return error.status === 403 && MENTIONS_RICH_METHOD.test(text);
+}
+function isChatScoped(error) {
+  if (!isBotApiError(error) || error.kind !== "rejected" || isStanding(error)) {
+    return false;
+  }
+  const text = descriptionOf(error);
+  return !MENTIONS_RICH_METHOD.test(text) && (error.status === 403 || (error.status === 400 || error.status === 404) && MENTIONS_CHAT.test(text));
+}
+function fallTo(hooks, step, reason) {
+  const recorded = hooks.state.record(step, reason);
+  try {
+    hooks.onFallback?.(recorded);
+  } catch {}
+}
+async function sendRendered(api, params, hooks) {
+  const { parseMode: _ignored, ...plain } = params;
+  const step = firstStep(hooks.state.mode(), params.text);
+  if (step === "plain") {
+    return api.sendMessage({ ...plain, text: renderPlainText(params.text) });
+  }
+  if (step === "rich") {
+    const paused = hooks.state.richPausedReason();
+    if (paused !== undefined) {
+      fallTo(hooks, "rich-to-html", `rich messages paused: ${paused}`);
+    } else {
+      try {
+        if (api.sendRichMessage === undefined) {
+          throw new RichUnavailable(MISSING_METHOD);
+        }
+        const sent = await api.sendRichMessage({
+          chatId: params.chatId,
+          richMessage: renderRichMessage(params.text),
+          ...params.messageThreadId === undefined ? {} : { messageThreadId: params.messageThreadId },
+          ...params.inlineKeyboard === undefined ? {} : { inlineKeyboard: params.inlineKeyboard }
+        });
+        hooks.state.richServerReset();
+        return sent;
+      } catch (error) {
+        handleRichFailure(error, hooks, `send:${params.chatId}:${params.messageThreadId ?? ""}:${params.text}`);
+      }
+    }
+  }
+  return sendHtml(api, plain, (error) => fallTo(hooks, "html-to-plain", describe(error)));
+}
+async function editRendered(api, params, hooks) {
+  const step = firstStep(hooks.state.mode(), params.text);
+  if (step === "plain") {
+    await api.editMessageText({ ...params, text: renderPlainText(params.text) });
+    return;
+  }
+  if (step === "rich") {
+    const paused = hooks.state.richPausedReason();
+    if (paused !== undefined) {
+      fallTo(hooks, "rich-to-html", `rich messages paused: ${paused}`);
+    } else {
+      try {
+        if (api.editRichMessage === undefined) {
+          throw new RichUnavailable(MISSING_METHOD);
+        }
+        await api.editRichMessage({
+          chatId: params.chatId,
+          messageId: params.messageId,
+          richMessage: renderRichMessage(params.text),
+          ...params.inlineKeyboard === undefined ? {} : { inlineKeyboard: params.inlineKeyboard }
+        });
+        hooks.state.richServerReset();
+        return;
+      } catch (error) {
+        if (isNotModified(error)) {
+          throw error;
+        }
+        handleRichFailure(error, hooks, `edit:${params.chatId}:${params.messageId}:${params.text}`);
+      }
+    }
+  }
+  await editHtml(api, params, (error) => fallTo(hooks, "html-to-plain", describe(error)));
+}
+function handleRichFailure(error, hooks, key) {
+  if (error instanceof RichUnavailable) {
+    hooks.state.pauseRich(error.message);
+    fallTo(hooks, "rich-to-html", error.message);
+    return;
+  }
+  if (error instanceof RichRenderError) {
+    fallTo(hooks, "rich-to-html", describe(error));
+    return;
+  }
+  if (isBotApiError(error) && error.kind === "server") {
+    if (hooks.state.richServerFailure(key) < RICH_SERVER_ATTEMPTS) {
+      throw error;
+    }
+    hooks.state.richServerReset();
+    fallTo(hooks, "rich-to-html", `rich failed ${RICH_SERVER_ATTEMPTS} times: ${describe(error)}`);
+    return;
+  }
+  if (!isRefusal(error)) {
+    throw error;
+  }
+  if (isChatScoped(error)) {
+    return;
+  }
+  const reason = describe(error);
+  if (isStanding(error)) {
+    hooks.state.pauseRich(reason);
+  }
+  fallTo(hooks, "rich-to-html", reason);
+}
+var RICH_PAUSE_MS, RICH_SERVER_ATTEMPTS = 3, MAX_REASON_LENGTH2 = 200, MENTIONS_RICH_METHOD, MENTIONS_CHAT, MISSING_METHOD = "this Bot API client has no rich message method", RichUnavailable;
+var init_rendering = __esm(() => {
+  init_service2();
+  init_format_html();
+  init_format_rich();
+  init_format_plain();
+  init_rendering_mode();
+  init_types11();
+  RICH_PAUSE_MS = 10 * 60000;
+  MENTIONS_RICH_METHOD = /rich|method|unknown parameter|not supported|unsupported/i;
+  MENTIONS_CHAT = /chat|thread|topic|user|member|group|channel|blocked|kicked|deactivated|rights/i;
+  RichUnavailable = class RichUnavailable extends Error {
+  };
+});
+
 // src/remote/outbound-queue.ts
 import { randomUUID as randomUUID51 } from "crypto";
 import path363 from "path";
@@ -193582,6 +194761,7 @@ class OutboundQueue {
   log;
   onDrop;
   onFallback;
+  rendering;
   retryDelayMs;
   sentHooks = new Map;
   blockedUntil = 0;
@@ -193595,6 +194775,7 @@ class OutboundQueue {
     this.onFallback = options.onFallback ?? (() => {
       return;
     });
+    this.rendering = options.rendering ?? new RenderingState({ now: options.now });
     this.retryDelayMs = options.retryDelayMs ?? 5000;
     const directory = ensureRemoteDir(options.dir);
     this.log = new DurableLog({
@@ -193683,17 +194864,17 @@ class OutboundQueue {
         return { sent, dropped, remaining: this.log.size, retryInMs: wait, stoppedBy: "rate limited" };
       }
       try {
-        const result = await sendHtml(this.api, {
+        const result = await sendRendered(this.api, {
           chatId: entry.chatId,
           text: entry.text,
           ...entry.threadId === undefined ? {} : { messageThreadId: entry.threadId },
           ...entry.keyboard === undefined ? {} : { inlineKeyboard: entry.keyboard }
-        }, () => this.onFallback(entry));
+        }, { state: this.rendering, onFallback: (fallback) => this.onFallback(entry, fallback) });
         this.log.ack(entry.id);
         sent += 1;
         this.notifySent(entry, result.message_id);
       } catch (error) {
-        const description = describe(error);
+        const description = describe2(error);
         if (isBotApiError(error) && error.kind === "rate-limited") {
           const retryMs = Math.max(1, error.retryAfterSec ?? 1) * 1000;
           this.blockedUntil = this.now() + retryMs;
@@ -193710,7 +194891,7 @@ class OutboundQueue {
     }
   }
 }
-function describe(error) {
+function describe2(error) {
   return redactSensitiveText(error instanceof Error ? error.message : String(error));
 }
 var OUTBOUND_MAX_ENTRIES = 200;
@@ -193719,7 +194900,7 @@ var init_outbound_queue = __esm(() => {
   init_durable_log();
   init_paths4();
   init_format2();
-  init_format_html();
+  init_rendering();
   init_types11();
 });
 
@@ -193829,7 +195010,7 @@ class UpdatePoller {
           continue;
         }
         failures += 1;
-        this.set({ state: "running", reason: describe2(error) });
+        this.set({ state: "running", reason: describe3(error) });
         await this.sleep(this.backoffMs[Math.min(failures, this.backoffMs.length) - 1] ?? 1000, signal);
         continue;
       }
@@ -193849,13 +195030,13 @@ class UpdatePoller {
         }
       } catch (error) {
         failures += 1;
-        this.set({ state: "running", reason: describe2(error) });
+        this.set({ state: "running", reason: describe3(error) });
         await this.sleep(this.backoffMs[Math.min(failures, this.backoffMs.length) - 1] ?? 1000, signal);
       }
     }
   }
 }
-function describe2(error) {
+function describe3(error) {
   return redactSensitiveText(error instanceof Error ? error.message : String(error));
 }
 var POLLER_CONFLICT_REASON = "another getUpdates poller already owns this bot token (HTTP 409 Conflict); only one `keryx serve` may poll a token, so this one will not poll. Stop the other instance or use a different bot.", SHORT_POLL_PAUSE_MS = 1000;
@@ -193866,7 +195047,7 @@ var init_poller = __esm(() => {
 
 // src/remote/service-topics.ts
 import path364 from "path";
-function parse(value) {
+function parse2(value) {
   if (typeof value !== "object" || value === null)
     return;
   const raw = value;
@@ -193893,7 +195074,7 @@ class ServiceTopics {
       if (!Array.isArray(records))
         return;
       for (const candidate of records) {
-        const record = parse(candidate);
+        const record = parse2(candidate);
         if (record !== undefined)
           this.byName.set(nameKey(record.name), record);
       }
@@ -194077,6 +195258,7 @@ class RemoteHub {
   registry;
   inbound;
   outbound;
+  rendering;
   serviceTopics;
   droppedReasons = new Map;
   journal;
@@ -194115,15 +195297,23 @@ class RemoteHub {
     };
     this.registry = new SessionRegistry({ ...options.dir === undefined ? {} : { dir: options.dir }, now: this.now });
     this.inbound = new InboundQueues(options.dir === undefined ? {} : { dir: options.dir });
+    this.rendering = new RenderingState({
+      now: this.now,
+      mode: options.renderingMode ?? (() => {
+        const fresh = loadRemoteConfig(options.dir);
+        return (fresh.ok ? fresh.value.rendering : undefined) ?? options.config.rendering ?? DEFAULT_RENDER_MODE;
+      })
+    });
     this.outbound = new OutboundQueue({
       api: this.api,
+      rendering: this.rendering,
       ...options.dir === undefined ? {} : { dir: options.dir },
       now: this.now,
       onDrop: (entry, reason) => {
         this.droppedReasons.set(entry.id, reason);
         this.event("outbound-dropped", `${reason}${entry.threadId === undefined ? "" : ` (topic ${entry.threadId})`}`);
       },
-      onFallback: (entry) => this.event("format-fallback", `Telegram refused the formatting; sent as plain text${entry.threadId === undefined ? "" : ` (topic ${entry.threadId})`}`)
+      onFallback: (entry, fallback) => this.fallbackEvent(fallback, entry.threadId === undefined ? "" : ` (topic ${entry.threadId})`, "sent")
     });
     this.journal = new RejectedJournal({ ...options.dir === undefined ? {} : { dir: options.dir }, now: this.now });
     this.offset = new PollerState(options.dir === undefined ? {} : { dir: options.dir });
@@ -194264,7 +195454,13 @@ class RemoteHub {
     });
   }
   async sendGeneral(text) {
-    await sendHtml(this.api, { chatId: this.config.chatId, text }, () => this.event("format-fallback", "Telegram refused the formatting; sent as plain text (General)"));
+    await sendRendered(this.api, { chatId: this.config.chatId, text }, { state: this.rendering, onFallback: (fallback) => this.fallbackEvent(fallback, " (General)", "sent") });
+  }
+  renderingStatus() {
+    return this.rendering.snapshot();
+  }
+  fallbackEvent(fallback, where, verb) {
+    this.event("format-fallback", fallback.step === "html-to-plain" ? `Telegram refused the formatting; ${verb} as plain text${where}` : `Telegram refused the rich message (${fallback.reason}); ${verb} as HTML${where}`);
   }
   heartbeat(sessionId) {
     return this.serial(async () => {
@@ -194383,7 +195579,7 @@ class RemoteHub {
       return "gone";
     }
     try {
-      await editHtml(this.api, { chatId: record.chatId, messageId, text }, () => this.event("format-fallback", `Telegram refused the formatting; edited as plain text (topic ${record.threadId})`));
+      await editRendered(this.api, { chatId: record.chatId, messageId, text }, { state: this.rendering, onFallback: (fallback) => this.fallbackEvent(fallback, ` (topic ${record.threadId})`, "edited") });
       return "edited";
     } catch (error) {
       if (isNotModified(error)) {
@@ -194796,11 +195992,14 @@ var realTimers, MAX_EVENTS = 50, ANSWER_CALLBACK_TIMEOUT_MS = 5000;
 var init_hub = __esm(() => {
   init_service2();
   init_lease();
+  init_config11();
   init_format_html();
   init_inbound();
   init_journal3();
   init_naming();
   init_outbound_queue();
+  init_rendering();
+  init_rendering_mode();
   init_command_gateway();
   init_message_state();
   init_poller();
@@ -195815,10 +197014,10 @@ function newPairingCode() {
   }
   return code;
 }
-function describe3(error) {
+function describe4(error) {
   return redactSensitiveText(error instanceof Error ? error.message : String(error));
 }
-function normalise3(text) {
+function normalise4(text) {
   return text.toUpperCase().replace(/[^A-Z0-9]/g, "");
 }
 
@@ -195876,7 +197075,7 @@ class Pairing {
       if (isBotApiError(error) && error.kind === "rejected") {
         return { ok: false, kind: "rejected", reason: "Telegram does not accept this bot token; check it with BotFather and try again." };
       }
-      return { ok: false, kind: "unreachable", reason: `could not reach Telegram: ${describe3(error)}` };
+      return { ok: false, kind: "unreachable", reason: `could not reach Telegram: ${describe4(error)}` };
     }
     return { ok: true, pairing: new Pairing(options, bot) };
   }
@@ -196003,7 +197202,7 @@ class Pairing {
       return;
     }
     const sent = message.text.trim().replace(/^\/start(?:@\w+)?\s+/i, "");
-    if (this.code === undefined || normalise3(sent) !== this.code) {
+    if (this.code === undefined || normalise4(sent) !== this.code) {
       return;
     }
     this.userId = message.from.id;
@@ -196112,7 +197311,7 @@ class Pairing {
         problems.push("Give the bot the Manage Topics right in the group's administrator settings.");
       }
     } catch (error) {
-      problems.push(`could not inspect the group: ${describe3(error)}`);
+      problems.push(`could not inspect the group: ${describe4(error)}`);
     }
     this.expireIfDue();
     if (FINAL.has(this.state)) {
@@ -196137,7 +197336,7 @@ var init_pairing = __esm(() => {
 });
 
 // src/remote/channels.ts
-function describe4(error) {
+function describe5(error) {
   return redactSensitiveText(error instanceof Error ? error.message : String(error));
 }
 
@@ -196200,11 +197399,25 @@ class ChannelsController {
     }
     return { state: "not-connected" };
   }
+  rendering() {
+    const hub = this.host.hub();
+    if (hub !== undefined && typeof hub.renderingStatus === "function") {
+      return hub.renderingStatus();
+    }
+    const config = loadRemoteConfig(this.host.dir);
+    return config.ok ? { mode: config.value.rendering ?? DEFAULT_RENDER_MODE } : undefined;
+  }
   status() {
     const { state, reason } = this.state();
+    const rendering = this.rendering();
     return ok2({
       machine: this.host.machine,
-      telegram: { state, ...reason === undefined ? {} : { reason }, sessions: this.host.hub()?.list().length ?? 0 }
+      telegram: {
+        state,
+        ...reason === undefined ? {} : { reason },
+        sessions: this.host.hub()?.list().length ?? 0,
+        ...rendering === undefined ? {} : { rendering }
+      }
     });
   }
   async dropPairing() {
@@ -196300,7 +197513,7 @@ class ChannelsController {
     try {
       await hub.sendGeneral(`Keryx test message from ${this.host.machine}: Telegram is connected.`);
     } catch (error) {
-      return fail4(502, "send-failed", `Telegram did not accept the test message: ${describe4(error)}`);
+      return fail4(502, "send-failed", `Telegram did not accept the test message: ${describe5(error)}`);
     }
     return ok2({ delivered: true, machine: this.host.machine });
   }
@@ -196326,6 +197539,7 @@ var init_channels = __esm(() => {
   init_http_surface();
   init_pairing();
   init_paths4();
+  init_rendering_mode();
 });
 
 // src/remote/poll-lock.ts
@@ -203117,6 +204331,156 @@ var init_retention2 = __esm(() => {
   init_sweep();
 });
 
+// src/remote/rendering-sample.ts
+function describeBlocks(message) {
+  const counts = new Map;
+  const walk = (blocks) => {
+    for (const block of blocks) {
+      counts.set(block.type, (counts.get(block.type) ?? 0) + 1);
+      for (const item of block.items ?? []) {
+        walk(item.blocks ?? []);
+      }
+    }
+  };
+  walk(message.blocks);
+  return [...counts.entries()].map(([type, count]) => `${count} ${type}`).join(", ");
+}
+function htmlOrPlain(part) {
+  const html = renderTelegramHtml(part);
+  const checked = checkTelegramHtml(html);
+  return checked.ok ? { kind: "html", text: checked.text } : { kind: "plain", text: renderPlainText(part), note: `HTML refused locally (${checked.reason}); plain text` };
+}
+function renderSample(mode, reply = SAMPLE_REPLY) {
+  const pieces = formatReply(reply);
+  const parts = pieces.map((piece, position) => {
+    const base = { index: position + 1, total: pieces.length };
+    const step = firstStep(mode, piece);
+    if (step === "plain") {
+      return { ...base, kind: "plain", text: renderPlainText(piece) };
+    }
+    if (step === "rich") {
+      try {
+        const richMessage = renderRichMessage(piece);
+        return { ...base, kind: "rich", text: describeBlocks(richMessage), richMessage };
+      } catch (error) {
+        if (!(error instanceof RichRenderError)) {
+          throw error;
+        }
+        return { ...base, ...htmlOrPlain(piece), note: `not renderable as a rich message (${error.message}); HTML instead` };
+      }
+    }
+    return { ...base, ...htmlOrPlain(piece) };
+  });
+  return { mode, parts };
+}
+function renderAllSamples(reply = SAMPLE_REPLY) {
+  return RENDER_MODES.map((mode) => renderSample(mode, reply));
+}
+function formatSampleText(renderings, options = {}) {
+  const lines = ["Sample reply (source):", "", ...SAMPLE_REPLY.split(`
+`).map((line) => `  ${line}`), ""];
+  for (const rendering of renderings) {
+    lines.push(`=== ${MODE_HEADLINE[rendering.mode]} ===`);
+    for (const part of rendering.parts) {
+      lines.push(`--- part ${part.index}/${part.total}, sent as ${part.kind}${part.note === undefined ? "" : ` (${part.note})`} ---`);
+      if (part.kind === "rich" && options.full === true) {
+        lines.push(JSON.stringify(part.richMessage, null, 2));
+      } else if (part.kind === "rich") {
+        lines.push(`rich blocks: ${part.text}`);
+      } else {
+        lines.push(part.text);
+      }
+    }
+    lines.push("");
+  }
+  return `${lines.join(`
+`)}
+`;
+}
+var SAMPLE_REPLY, MODE_HEADLINE;
+var init_rendering_sample = __esm(() => {
+  init_format2();
+  init_format_html();
+  init_format_plain();
+  init_format_rich();
+  init_rendering();
+  init_rendering_mode();
+  SAMPLE_REPLY = [
+    "## Release check",
+    "",
+    "Everything below is **one reply**: a table, lists, a rule and some `code`.",
+    "",
+    "| Step | Result | Time |",
+    "|:-----|:------:|-----:|",
+    "| build | `ok` | 41s |",
+    "| unit tests | ok | 2m 08s |",
+    "| smoke | **failed** | 12s |",
+    "",
+    "1. Fix the smoke test",
+    "2. Re-run the release check",
+    "   - on the branch first",
+    "   - then on main",
+    "",
+    "- [x] changelog written",
+    "- [ ] tag pushed",
+    "",
+    "---",
+    "",
+    "> The tag is pushed by the operator, not by the agent."
+  ].join(`
+`);
+  MODE_HEADLINE = {
+    auto: "auto: rich where there is a table, otherwise HTML",
+    rich: "rich: every reply as a rich message",
+    html: "html: every reply as Telegram HTML",
+    plain: "plain: every reply as plain text"
+  };
+});
+
+// src/commands/remote.ts
+function remoteCommand(args) {
+  const [sub, ...rest] = args;
+  if (sub === undefined || sub === "--help" || sub === "-h" || sub === "help") {
+    console.log(REMOTE_USAGE);
+    return;
+  }
+  if (sub !== "format-sample") {
+    console.error(`keryx remote: unknown subcommand '${sub}'. Try \`keryx remote format-sample\`.`);
+    process.exitCode = 1;
+    return;
+  }
+  const wanted = optionValue(rest, "--mode");
+  if (wanted !== undefined && !isRenderMode(wanted)) {
+    console.error(`keryx remote format-sample: --mode must be ${RENDER_MODE_CHOICES}`);
+    process.exitCode = 1;
+    return;
+  }
+  const renderings = wanted === undefined ? renderAllSamples() : [renderSample(wanted)];
+  if (rest.includes("--json")) {
+    console.log(JSON.stringify({ sample: SAMPLE_REPLY, renderings }, null, 2));
+    return;
+  }
+  process.stdout.write(formatSampleText(renderings, { full: rest.includes("--full") }));
+}
+var REMOTE_USAGE;
+var init_remote = __esm(() => {
+  init_args();
+  init_rendering_sample();
+  init_rendering_mode();
+  REMOTE_USAGE = `keryx remote format-sample \u2014 show the sample reply in every Telegram rendering mode (no network)
+
+Usage:
+  keryx remote format-sample [--mode ${RENDER_MODES.join("|")}] [--full] [--json]
+
+--mode  Only that mode. Without it all four are printed.
+--full  Print the whole rich message (JSON) instead of a count of its blocks.
+--json  Machine-readable: the sample source and, per mode, each part with how it is sent.
+
+The mode in effect for a running session is set with \`/rendering\` in the shell, or the
+"Telegram rendering" row of \`/settings\`; \`/channels\` shows it together with the last fallback.
+`;
+});
+
 // src/commands/forgetting.ts
 async function forgettingCommand(args) {
   const command = args[0];
@@ -204904,7 +206268,7 @@ function buildHeader(entry, size) {
   chk.copy(header, 148);
   return { ok: true, value: header };
 }
-function pad4(buf) {
+function pad5(buf) {
   const rem = buf.length % BLOCK;
   if (rem === 0)
     return buf;
@@ -204939,7 +206303,7 @@ function buildBundleArchive(files, manifestBytes) {
       return header;
     chunks.push(header.value);
     if (entry.bytes && entry.bytes.length > 0) {
-      chunks.push(pad4(entry.bytes));
+      chunks.push(pad5(entry.bytes));
     }
   }
   chunks.push(Buffer.alloc(BLOCK * 2));
@@ -209141,6 +210505,9 @@ var VERSION3, CLI_ROUTES, MCP_KNOWN_SUBCOMMANDS, USAGE_BODY = `Usage:
   keryx retention sweep [--apply] [--target <id>]... [--max-age-days <n>] [--max-bytes <n>] [--json]
                                                Bound gdctx raw/artifacts logs and owner write-conflict
                                                sidecars; dry run by default, --apply removes
+  keryx remote format-sample [--mode auto|rich|html|plain] [--full] [--json]
+                                               Print the sample reply in each Telegram rendering mode
+                                               (tables, lists, rules); no network
   keryx forgetting trail [--limit <n>] [--json]
   keryx forgetting lookup "<ref-or-path>" [--layer <layer>] [--search] [--json]
                                                Read the deletion trail: what was removed, when, at
@@ -209238,6 +210605,7 @@ Commands:
   metrics   Provenance-aware execution observability: run records, baselines, benchmarks
   workspace Shared Agent Context: workspaces, FWK reads, propose/review (module sac)
   retention Bound stores that grow without bound (gdctx raw/artifacts, owner write-conflict sidecars)
+  remote    Telegram remote control: preview how replies are rendered, with no network
   forgetting Read the deletion trail \u2014 was this removed, or did it never exist?
   trigger   Fire one declared project trigger (git hook, cron line, CI job) \u2014 one pass, one exit code
   schedule  Scheduled agent tasks in the background: create (with confirmation), list, pause, resume, remove
@@ -209295,6 +210663,7 @@ var init_cli_registry = __esm(() => {
   init_external2();
   init_auth();
   init_retention2();
+  init_remote();
   init_forgetting();
   init_trigger();
   init_schedule2();
@@ -209363,6 +210732,7 @@ var init_cli_registry = __esm(() => {
     version: versionCommand,
     workspace: workspaceCommand,
     retention: retentionCommand,
+    remote: remoteCommand,
     forgetting: forgettingCommand,
     trigger: triggerCommand,
     schedule: scheduleCommand,