openclaw/src/config/markdown-tables.ts

import { getBundledChannelContractSurfaceEntries } from "../channels/plugins/contract-surfaces.js";
import { normalizeChannelId } from "../channels/plugins/index.js";
import { resolveAccountEntry } from "../routing/account-lookup.js";
import { normalizeAccountId } from "../routing/session-key.js";
import type { OpenClawConfig } from "./config.js";
import type { MarkdownTableMode } from "./types.base.js";

type MarkdownConfigEntry = {
  markdown?: {
    tables?: MarkdownTableMode;
  };
};

type MarkdownConfigSection = MarkdownConfigEntry & {
  accounts?: Record<string, MarkdownConfigEntry>;
};

type ChannelMarkdownTableSurface = {
  defaultMarkdownTableMode?: MarkdownTableMode;
};

function buildDefaultTableModes(): Map<string, MarkdownTableMode> {
  return new Map(
    getBundledChannelContractSurfaceEntries()
      .flatMap(({ pluginId, surface }) => {
        const defaultMarkdownTableMode = (surface as ChannelMarkdownTableSurface)
          .defaultMarkdownTableMode;
        return defaultMarkdownTableMode ? [[pluginId, defaultMarkdownTableMode] as const] : [];
      })
      .toSorted(([left], [right]) => left.localeCompare(right)),
  );
}

let cachedDefaultTableModes: Map<string, MarkdownTableMode> | null = null;

function getDefaultTableModes(): Map<string, MarkdownTableMode> {
  cachedDefaultTableModes ??= buildDefaultTableModes();
  return cachedDefaultTableModes;
}

export const DEFAULT_TABLE_MODES = getDefaultTableModes();

const isMarkdownTableMode = (value: unknown): value is MarkdownTableMode =>
  value === "off" || value === "bullets" || value === "code" || value === "block";

function resolveMarkdownModeFromSection(
  section: MarkdownConfigSection | undefined,
  accountId?: string | null,
): MarkdownTableMode | undefined {
  if (!section) {
    return undefined;
  }
  const normalizedAccountId = normalizeAccountId(accountId);
  const accounts = section.accounts;
  if (accounts && typeof accounts === "object") {
    const match = resolveAccountEntry(accounts, normalizedAccountId);
    const matchMode = match?.markdown?.tables;
    if (isMarkdownTableMode(matchMode)) {
      return matchMode;
    }
  }
  const sectionMode = section.markdown?.tables;
  return isMarkdownTableMode(sectionMode) ? sectionMode : undefined;
}

export function resolveMarkdownTableMode(params: {
  cfg?: Partial<OpenClawConfig>;
  channel?: string | null;
  accountId?: string | null;
}): MarkdownTableMode {
  const channel = normalizeChannelId(params.channel);
  const defaultMode = channel ? (DEFAULT_TABLE_MODES.get(channel) ?? "code") : "code";
  if (!channel || !params.cfg) {
    return defaultMode;
  }
  const channelsConfig = params.cfg.channels as Record<string, unknown> | undefined;
  const section = (channelsConfig?.[channel] ??
    (params.cfg as Record<string, unknown> | undefined)?.[channel]) as
    | MarkdownConfigSection
    | undefined;
  const resolved = resolveMarkdownModeFromSection(section, params.accountId) ?? defaultMode;
  // "block" stays schema-valid for the shared markdown seam, but this PR
  // keeps runtime delivery on safe text rendering until Slack send support lands.
  return resolved === "block" ? "code" : resolved;
}