fix(discord): cap lines per message

docs/concepts/streaming.md

@@ -36,6 +36,7 @@ Legend:
 - `agent.blockStreamingBreak`: `"text_end"` or `"message_end"`.
 - `agent.blockStreamingChunk`: `{ minChars, maxChars, breakPreference? }`.
 - Provider hard cap: `*.textChunkLimit` (e.g., `whatsapp.textChunkLimit`).
+- Discord soft cap: `discord.maxLinesPerMessage` (default 17) splits tall replies to avoid UI clipping.
 
 **Boundary semantics:**
 - `text_end`: stream blocks as soon as chunker emits; flush on each `text_end`.

docs/gateway/configuration.md

@@ -689,6 +689,8 @@ Multi-account support lives under `discord.accounts` (see the multi-account sect
       }
     },
     historyLimit: 20,                       // include last N guild messages as context
+    textChunkLimit: 2000,                   // optional outbound text chunk size (chars)
+    maxLinesPerMessage: 17,                 // soft max lines per message (Discord UI clipping)
     retry: {                                // outbound retry policy
       attempts: 3,
       minDelayMs: 500,
@@ -706,6 +708,7 @@ Reaction notification modes:
 - `own`: reactions on the bot's own messages (default).
 - `all`: all reactions on all messages.
 - `allowlist`: reactions from `guilds.<id>.users` on all messages (empty list disables).
+Outbound text is chunked by `discord.textChunkLimit` (default 2000). Discord clients can clip very tall messages, so `discord.maxLinesPerMessage` (default 17) splits long multi-line replies even when under 2000 chars.
 Retry policy defaults and behavior are documented in [Retry policy](/concepts/retry).
 
 ### `slack` (socket mode)

docs/providers/discord.md

@@ -156,7 +156,7 @@ Notes:
 
 ## Capabilities & limits
 - DMs and guild text channels (threads are treated as separate channels; voice not supported).
-- Typing indicators sent best-effort; message chunking honors Discord’s 2k character limit.
+- Typing indicators sent best-effort; message chunking uses `discord.textChunkLimit` (default 2000) and splits tall replies by line count (`discord.maxLinesPerMessage`, default 17).
 - File uploads supported up to the configured `discord.mediaMaxMb` (default 8 MB).
 - Mention-gated guild replies by default to avoid noisy bots.
 - Reply context is injected when a message references another message (quoted content + ids).
@@ -244,6 +244,8 @@ Ack reactions are controlled globally via `messages.ackReaction` +
 - `guilds.<id>.channels`: channel rules (keys are channel slugs or ids).
 - `guilds.<id>.requireMention`: per-guild mention requirement (overridable per channel).
 - `guilds.<id>.reactionNotifications`: reaction system event mode (`off`, `own`, `all`, `allowlist`).
+- `textChunkLimit`: outbound text chunk size (chars). Default: 2000.
+- `maxLinesPerMessage`: soft max line count per message. Default: 17.
 - `mediaMaxMb`: clamp inbound media saved to disk.
 - `historyLimit`: number of recent guild messages to include as context when replying to a mention (default 20, `0` disables).
 - `retry`: retry policy for outbound Discord API calls (attempts, minDelayMs, maxDelayMs, jitter).

docs/providers/imessage.md

@@ -77,6 +77,10 @@ Groups:
 - Optional attachment ingestion via `imessage.includeAttachments`.
 - Media cap via `imessage.mediaMaxMb`.
 
+## Limits
+- Outbound text is chunked to `imessage.textChunkLimit` (default 4000).
+- Media uploads are capped by `imessage.mediaMaxMb` (default 16).
+
 ## Addressing / delivery targets
 Prefer `chat_id` for stable routing:
 - `chat_id:123` (preferred)

docs/providers/signal.md

@@ -60,8 +60,9 @@ Groups:
 - Replies always route back to the same number or group.
 
 ## Media + limits
+- Outbound text is chunked to `signal.textChunkLimit` (default 4000).
 - Attachments supported (base64 fetched from `signal-cli`).
-- Default cap: `signal.mediaMaxMb`.
+- Default media cap: `signal.mediaMaxMb` (default 8).
 - Use `signal.ignoreAttachments` to skip downloading media.
 
 ## Delivery targets (CLI/cron)

docs/providers/slack.md

@@ -196,6 +196,10 @@ Tokens can also be supplied via env vars:
 Ack reactions are controlled globally via `messages.ackReaction` +
 `messages.ackReactionScope`.
 
+## Limits
+- Outbound text is chunked to `slack.textChunkLimit` (default 4000).
+- Media uploads are capped by `slack.mediaMaxMb` (default 20).
+
 ## Reply threading
 Slack supports optional threaded replies via tags:
 - `[[reply_to_current]]` — reply to the triggering message.

docs/providers/telegram.md

@@ -47,6 +47,10 @@ Multi-account support: use `telegram.accounts` with per-account tokens and optio
 - Raw HTML from models is escaped to avoid Telegram parse errors.
 - If Telegram rejects the HTML payload, Clawdbot retries the same message as plain text.
 
+## Limits
+- Outbound text is chunked to `telegram.textChunkLimit` (default 4000).
+- Media downloads/uploads are capped by `telegram.mediaMaxMb` (default 5).
+
 ## Group activation modes
 
 By default, the bot only responds to mentions in groups (`@botname` or patterns in `routing.groupChat.mentionPatterns`). To change this behavior:

docs/providers/whatsapp.md

@@ -126,9 +126,13 @@ Recommended for personal numbers:
 - Reaction removal semantics: see [/tools/reactions](/tools/reactions).
 - Tool gating: `whatsapp.actions.reactions` (default: enabled).
 
+## Limits
+- Outbound text is chunked to `whatsapp.textChunkLimit` (default 4000).
+- Media items are capped by `agent.mediaMaxMb` (default 5 MB).
+
 ## Outbound send (text + media)
 - Uses active web listener; error if gateway not running.
-- Text chunking: 4k max per message.
+- Text chunking: 4k max per message (configurable via `whatsapp.textChunkLimit`).
 - Media:
   - Image/video/audio/document supported.
   - Audio sent as PTT; `audio/ogg` => `audio/ogg; codecs=opus`.