fix: improve progress draft truncation

steipete · steipete · commit 77547226ce24 · 2026-05-17T08:13:39.000+01:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -13,6 +13,7 @@ Docs: https://docs.openclaw.ai
 ### Fixes
 
 - CLI/sessions: accept `openclaw sessions list` as an alias for `openclaw sessions`, matching other list-style commands. Fixes #81139. (#81163) Thanks @YB0y.
+- Channels/stream previews: widen compact progress draft lines and cut prose at word boundaries while preserving command/path suffixes, with `streaming.progress.maxLineChars` for channel-specific tuning.
 - CLI/plugins: have `openclaw plugins doctor` warn when a configured runtime needs a missing owner plugin, sharing the same install mapping as `openclaw doctor --fix`. Fixes #81326. (#81674) Thanks @Zavianx.
 - Agents/Codex: route OpenAI runs that resolve to `openai-codex` through the Codex provider and bootstrap OpenClaw's stored OAuth profile into the Codex harness when the harness owns transport, so `openai/*` model refs no longer fail with `No API key found for openai-codex` despite an existing Codex OAuth profile. (#82864) Thanks @ragesaq.
 - Agents/ACP: distinguish prompt-submitted and runtime-active child stalls from true interactive waits, including redacted proxy-env diagnostics for Codex ACP no-output runs. Fixes #44810.
diff --git a/docs/channels/discord.md b/docs/channels/discord.md
@@ -692,6 +692,7 @@ Default slash command settings:
         progress: {
           label: "auto",
           maxLines: 8,
+          maxLineChars: 120,
           toolProgress: true,
         },
       },
@@ -705,6 +706,7 @@ Default slash command settings:
     - Media, error, and explicit-reply finals cancel pending preview edits.
     - `streaming.preview.toolProgress` (default `true`) controls whether tool/progress updates reuse the preview message.
     - Tool/progress rows render as compact emoji + title + detail when available, for example `🛠️ Bash: run tests` or `🔎 Web Search: for "query"`.
+    - `streaming.progress.maxLineChars` controls the per-line progress preview budget. Prose is shortened on word boundaries; command and path details keep useful suffixes.
     - `streaming.preview.commandText` / `streaming.progress.commandText` controls command/exec detail in compact progress lines: `raw` (default) or `status` (tool label only).
 
     Hide raw command/exec text while keeping compact progress lines:
diff --git a/docs/concepts/progress-drafts.md b/docs/concepts/progress-drafts.md
@@ -222,8 +222,26 @@ Limit how many lines stay visible:
 Progress lines are compacted automatically to reduce chat-bubble reflow while the draft is edited.
 
 OpenClaw truncates long progress lines by default so repeated draft edits do not
-wrap differently on every update. The prefix stays readable, and long details
-such as paths or raw commands are shortened with an ellipsis.
+wrap differently on every update. The default per-line budget is 120 characters.
+Prose cuts at a word boundary, while long details such as paths or raw commands
+are shortened with a middle ellipsis so the suffix remains visible.
+
+Tune the per-line budget:
+
+```json5
+{
+  channels: {
+    discord: {
+      streaming: {
+        mode: "progress",
+        progress: {
+          maxLineChars: 160,
+        },
+      },
+    },
+  },
+}
+```
 
 Slack can render progress lines as structured Block Kit fields instead of a
 single text body:
diff --git a/docs/gateway/config-channels.md b/docs/gateway/config-channels.md
@@ -278,6 +278,7 @@ WhatsApp runs through the gateway's web channel (Baileys Web). It starts automat
         progress: {
           label: "auto",
           maxLines: 8,
+          maxLineChars: 120,
           toolProgress: true,
         },
       },
diff --git a/extensions/discord/src/config-ui-hints.ts b/extensions/discord/src/config-ui-hints.ts
@@ -81,6 +81,10 @@ export const discordChannelConfigUiHints = {
     label: "Discord Progress Max Lines",
     help: "Maximum number of compact progress lines to keep below the draft label (default: 8).",
   },
+  "streaming.progress.maxLineChars": {
+    label: "Discord Progress Max Line Chars",
+    help: "Maximum characters per compact progress line before truncation (default: 120). Prose cuts at word boundaries; commands and paths keep useful suffixes.",
+  },
   "streaming.progress.toolProgress": {
     label: "Discord Progress Tool Lines",
     help: "Show compact tool/progress lines in progress draft mode (default: true). Set false to keep only the label until final delivery.",
diff --git a/extensions/discord/src/monitor/message-handler.process.test.ts b/extensions/discord/src/monitor/message-handler.process.test.ts
@@ -2316,7 +2316,7 @@ describe("processDiscordMessage draft streaming", () => {
     await runProcessDiscordMessage(ctx);
 
     expect(draftStream.update).toHaveBeenCalledWith(
-      "Clawing...\n🩹 1 modified; extensions/discord/src/monitor/message-handler.draft-prev…",
+      "Clawing...\n🩹 1 modified; extensions/discord/src/monitor/message-handler.draft-preview.ts",
     );
     const updates = draftStream.update.mock.calls.map((call) => call[0]);
     expect(updates.join("\n")).not.toContain("Apply Patch");
diff --git a/extensions/matrix/src/config-schema.ts b/extensions/matrix/src/config-schema.ts
@@ -85,6 +85,7 @@ const matrixStreamingSchema = z
         label: z.union([z.string(), z.literal(false)]).optional(),
         labels: z.array(z.string()).optional(),
         maxLines: z.number().int().positive().optional(),
+        maxLineChars: z.number().int().positive().optional(),
         toolProgress: z.boolean().optional(),
       })
       .strict()
diff --git a/extensions/matrix/src/config-ui-hints.ts b/extensions/matrix/src/config-ui-hints.ts
@@ -41,6 +41,10 @@ export const matrixChannelConfigUiHints = {
     label: "Matrix Progress Max Lines",
     help: "Maximum number of compact progress lines to keep below the draft label (default: 8).",
   },
+  "streaming.progress.maxLineChars": {
+    label: "Matrix Progress Max Line Chars",
+    help: "Maximum characters per compact progress line before truncation (default: 120). Prose cuts at word boundaries; commands and paths keep useful suffixes.",
+  },
   "streaming.progress.toolProgress": {
     label: "Matrix Progress Tool Lines",
     help: "Show compact tool/progress lines in progress draft mode (default: true). Set false to keep only the label until final delivery.",
diff --git a/extensions/mattermost/src/config-schema-core.ts b/extensions/mattermost/src/config-schema-core.ts
@@ -84,6 +84,7 @@ const MattermostStreamingProgressSchema = z
     label: z.union([z.string(), z.literal(false)]).optional(),
     labels: z.array(z.string()).optional(),
     maxLines: z.number().int().positive().optional(),
+    maxLineChars: z.number().int().positive().optional(),
     toolProgress: z.boolean().optional(),
   })
   .strict();
diff --git a/extensions/mattermost/src/config-ui-hints.ts b/extensions/mattermost/src/config-ui-hints.ts
@@ -29,6 +29,10 @@ export const mattermostChannelConfigUiHints = {
     label: "Mattermost Progress Max Lines",
     help: "Maximum number of compact progress lines to keep below the draft label (default: 8).",
   },
+  "streaming.progress.maxLineChars": {
+    label: "Mattermost Progress Max Line Chars",
+    help: "Maximum characters per compact progress line before truncation (default: 120). Prose cuts at word boundaries; commands and paths keep useful suffixes.",
+  },
   "streaming.progress.toolProgress": {
     label: "Mattermost Progress Tool Lines",
     help: "Show compact tool/progress lines in progress draft mode (default: true). Set false to keep only the label until final delivery.",
diff --git a/extensions/msteams/src/config-ui-hints.ts b/extensions/msteams/src/config-ui-hints.ts
@@ -25,6 +25,10 @@ export const msTeamsChannelConfigUiHints = {
     label: "MS Teams Progress Max Lines",
     help: "Maximum number of compact progress lines to keep below the progress title (default: 8).",
   },
+  "streaming.progress.maxLineChars": {
+    label: "MS Teams Progress Max Line Chars",
+    help: "Maximum characters per compact progress line before truncation (default: 120). Prose cuts at word boundaries; commands and paths keep useful suffixes.",
+  },
   "streaming.progress.toolProgress": {
     label: "MS Teams Progress Tool Lines",
     help: "Show compact tool/progress lines in progress mode (default: true). Set false to keep only the title until final delivery.",
diff --git a/extensions/slack/src/config-ui-hints.ts b/extensions/slack/src/config-ui-hints.ts
@@ -153,6 +153,10 @@ export const slackChannelConfigUiHints = {
     label: "Slack Progress Max Lines",
     help: "Maximum number of compact progress lines to keep below the draft label (default: 8).",
   },
+  "streaming.progress.maxLineChars": {
+    label: "Slack Progress Max Line Chars",
+    help: "Maximum characters per compact progress line before truncation (default: 120). Prose cuts at word boundaries; commands and paths keep useful suffixes.",
+  },
   "streaming.progress.render": {
     label: "Slack Progress Renderer",
     help: 'Progress draft renderer: "text" uses one portable text body; "rich" renders structured Slack Block Kit fields with the same text fallback.',
diff --git a/extensions/slack/src/monitor/message-handler/dispatch.ts b/extensions/slack/src/monitor/message-handler/dispatch.ts
@@ -21,6 +21,7 @@ import {
   isChannelProgressDraftWorkToolName,
   mergeChannelProgressDraftLine,
   resolveChannelProgressDraftMaxLines,
+  resolveChannelProgressDraftMaxLineChars,
   resolveChannelProgressDraftLabel,
   resolveChannelProgressDraftRender,
   resolveChannelStreamingBlockEnabled,
@@ -1130,6 +1131,7 @@ export async function dispatchPreparedSlackMessage(prepared: PreparedSlackMessag
                 seed: progressSeed,
               }),
               lines: previewToolProgressLines,
+              maxLineChars: resolveChannelProgressDraftMaxLineChars(account.config),
             }),
           }
         : previewText,
diff --git a/extensions/slack/src/progress-blocks.test.ts b/extensions/slack/src/progress-blocks.test.ts
@@ -52,8 +52,9 @@ describe("buildSlackProgressDraftBlocks", () => {
     ]);
   });
 
-  it("compacts long rich details independently from the text fallback", () => {
+  it("uses the configured max line chars for rich progress details", () => {
     const blocks = buildSlackProgressDraftBlocks({
+      maxLineChars: 64,
       lines: [
         {
           kind: "tool",
@@ -69,7 +70,10 @@ describe("buildSlackProgressDraftBlocks", () => {
       type: "section",
       fields: [
         { type: "mrkdwn", text: "🛠️ *Exec*" },
-        { type: "mrkdwn", text: "run tests in /Users/ex…es/very/deep/path/example" },
+        {
+          type: "mrkdwn",
+          text: "run tests in /Users/example/P…aw/packages/very/deep/path/example",
+        },
       ],
     });
   });
diff --git a/extensions/slack/src/progress-blocks.ts b/extensions/slack/src/progress-blocks.ts
@@ -5,7 +5,7 @@ import { escapeSlackMrkdwn } from "./monitor/mrkdwn.js";
 import { truncateSlackText } from "./truncate.js";
 
 const SLACK_PROGRESS_FIELD_MAX = 1800;
-const SLACK_PROGRESS_DETAIL_MAX_CHARS = 48;
+const DEFAULT_SLACK_PROGRESS_DETAIL_MAX_CHARS = 120;
 
 function field(text: string) {
   return {
@@ -18,35 +18,43 @@ function lineTitle(line: ChannelProgressDraftLine): string {
   return `${line.icon ?? "•"} *${escapeSlackMrkdwn(line.label)}*`;
 }
 
-function compactDetail(value: string): string {
+function compactDetail(value: string, maxChars: number): string {
   const normalized = value.replace(/\s+/g, " ").trim();
   const chars = Array.from(normalized);
-  if (chars.length <= SLACK_PROGRESS_DETAIL_MAX_CHARS) {
+  if (chars.length <= maxChars) {
     return normalized;
   }
-  const keepStart = Math.ceil((SLACK_PROGRESS_DETAIL_MAX_CHARS - 1) * 0.45);
-  const keepEnd = SLACK_PROGRESS_DETAIL_MAX_CHARS - keepStart - 1;
+  if (maxChars <= 1) {
+    return "…";
+  }
+  const keepStart = Math.max(1, Math.ceil((maxChars - 1) * 0.45));
+  const keepEnd = Math.max(1, maxChars - keepStart - 1);
   return `${chars.slice(0, keepStart).join("").trimEnd()}…${chars
     .slice(-keepEnd)
     .join("")
     .trimStart()}`;
 }
 
-function lineDetail(line: ChannelProgressDraftLine): string {
+function lineDetail(line: ChannelProgressDraftLine, maxChars: number): string {
   const parts = [
     line.detail,
     line.status && !line.detail?.includes(line.status) ? line.status : undefined,
   ]
     .map((part) => part?.trim())
     .filter((part): part is string => Boolean(part));
-  return parts.length ? escapeSlackMrkdwn(compactDetail(parts.join(" · "))) : " ";
+  return parts.length ? escapeSlackMrkdwn(compactDetail(parts.join(" · "), maxChars)) : " ";
 }
 
 export function buildSlackProgressDraftBlocks(params: {
   label?: string;
   lines: readonly ChannelProgressDraftLine[];
+  maxLineChars?: number;
 }): (Block | KnownBlock)[] | undefined {
   const label = params.label?.trim();
+  const maxLineChars =
+    params.maxLineChars && params.maxLineChars > 0
+      ? Math.floor(params.maxLineChars)
+      : DEFAULT_SLACK_PROGRESS_DETAIL_MAX_CHARS;
   const renderedBlocks: (Block | KnownBlock)[] = [
     ...(label
       ? [
@@ -58,7 +66,7 @@ export function buildSlackProgressDraftBlocks(params: {
       : []),
     ...params.lines.map((line) => ({
       type: "section",
-      fields: [field(lineTitle(line)), field(lineDetail(line))],
+      fields: [field(lineTitle(line)), field(lineDetail(line, maxLineChars))],
     })),
   ].slice(-SLACK_MAX_BLOCKS);
   const blocks: (Block | KnownBlock)[] = renderedBlocks;
diff --git a/extensions/telegram/src/config-ui-hints.ts b/extensions/telegram/src/config-ui-hints.ts
@@ -89,6 +89,10 @@ export const telegramChannelConfigUiHints = {
     label: "Telegram Progress Max Lines",
     help: "Maximum number of compact progress lines to keep below the draft label (default: 8).",
   },
+  "streaming.progress.maxLineChars": {
+    label: "Telegram Progress Max Line Chars",
+    help: "Maximum characters per compact progress line before truncation (default: 120). Prose cuts at word boundaries; commands and paths keep useful suffixes.",
+  },
   "streaming.progress.toolProgress": {
     label: "Telegram Progress Tool Lines",
     help: "Show compact tool/progress lines in progress draft mode (default: true). Set false to keep only the label until final delivery.",
diff --git a/src/config/bundled-channel-config-metadata.generated.ts b/src/config/bundled-channel-config-metadata.generated.ts
diff --git a/src/config/types.base.ts b/src/config/types.base.ts
@@ -42,6 +42,8 @@ export type ChannelStreamingProgressConfig = {
   labels?: string[];
   /** Maximum number of progress lines to keep below the label. Default: 8. */
   maxLines?: number;
+  /** Maximum characters per compact progress line before truncation. Default: 120. */
+  maxLineChars?: number;
   /** Progress draft renderer. "text" is the portable fallback; "rich" lets supported channels use structured UI. */
   render?: "text" | "rich";
   /** Include compact tool/task progress in the draft. Default: true. */
diff --git a/src/config/zod-schema.providers-core.ts b/src/config/zod-schema.providers-core.ts
@@ -92,6 +92,7 @@ const ChannelStreamingProgressSchema = z
     label: z.union([z.string(), z.literal(false)]).optional(),
     labels: z.array(z.string()).optional(),
     maxLines: z.number().int().positive().optional(),
+    maxLineChars: z.number().int().positive().optional(),
     render: z.enum(["text", "rich"]).optional(),
     toolProgress: z.boolean().optional(),
     commandText: z.enum(["raw", "status"]).optional(),
diff --git a/src/plugin-sdk/channel-streaming.test.ts b/src/plugin-sdk/channel-streaming.test.ts
@@ -11,6 +11,7 @@ import {
   isPotentialTruncatedFinal,
   mergeChannelProgressDraftLine,
   resolveChannelPreviewStreamMode,
+  resolveChannelProgressDraftMaxLineChars,
   resolveChannelProgressDraftLabel,
   resolveChannelProgressDraftMaxLines,
   resolveChannelProgressDraftRender,
@@ -247,8 +248,11 @@ describe("channel-streaming", () => {
   });
 
   it("formats bounded progress draft text", () => {
-    const entry = { streaming: { progress: { label: "Shelling", maxLines: 2, render: "rich" } } };
+    const entry = {
+      streaming: { progress: { label: "Shelling", maxLines: 2, maxLineChars: 80, render: "rich" } },
+    };
     expect(resolveChannelProgressDraftMaxLines(entry)).toBe(2);
+    expect(resolveChannelProgressDraftMaxLineChars(entry)).toBe(80);
     expect(resolveChannelProgressDraftRender(entry)).toBe("rich");
     expect(
       formatChannelProgressDraftText({
@@ -288,7 +292,7 @@ describe("channel-streaming", () => {
         entry: { streaming: { progress: { label: false } } },
         lines: line ? [line] : [],
       }),
-    ).toBe("🩹 1 modified; extensions/discord/src/monitor/message-handler.draft-prev…");
+    ).toBe("🩹 1 modified; extensions/discord/src/monitor/message-handler.draft-preview.ts");
   });
 
   it("bounds progress draft line length to reduce edit reflow", () => {
@@ -298,7 +302,18 @@ describe("channel-streaming", () => {
         lines: ["x".repeat(160)],
         formatLine: (line) => `\`${line}\``,
       }),
-    ).toBe(`Shelling\n• \`${"x".repeat(71)}…\``);
+    ).toBe(`Shelling\n• \`${"x".repeat(119)}…\``);
+  });
+
+  it("honors configured progress draft line length and cuts prose on word boundaries", () => {
+    expect(
+      formatChannelProgressDraftText({
+        entry: { streaming: { progress: { label: "Shelling", maxLineChars: 64 } } },
+        lines: [
+          "I'm checking whether the generated video exists or if the generator bailed while writing output.",
+        ],
+      }),
+    ).toBe("Shelling\n• I'm checking whether the generated video exists or if the…");
   });
 
   it("keeps compacted raw progress lines from leaking unmatched markdown backticks", () => {
@@ -319,7 +334,9 @@ describe("channel-streaming", () => {
       lines: line ? [line] : [],
     });
 
-    expect(text).toBe("Shelling\n🛠️ run node script…th/that/keeps/going/and/going/index…");
+    expect(text).toBe(
+      "Shelling\n🛠️ run node script…enclaw/some/really/deep/path/that/keeps/going/and/going/index…",
+    );
     expect(text.match(/`/g) ?? []).toHaveLength(0);
   });
 
diff --git a/src/plugin-sdk/channel-streaming.ts b/src/plugin-sdk/channel-streaming.ts
