​

Streaming + chunking

• Block streaming (channels): emit completed blocks as the assistant writes. These are normal channel messages (not token deltas).
• Preview streaming (Telegram/Discord/Slack): update a temporary preview message while generating.

​

Block streaming (channel messages)

Model output
  └─ text_delta/events
       ├─ (blockStreamingBreak=text_end)
       │    └─ chunker emits blocks as buffer grows
       └─ (blockStreamingBreak=message_end)
            └─ chunker flushes at message_end
                   └─ channel send (block replies)

• text_delta/events: model stream events (may be sparse for non-streaming models).
• chunker: EmbeddedBlockChunker applying min/max bounds + break preference.
• channel send: actual outbound messages (block replies).

• agents.defaults.blockStreamingDefault: "on"/"off" (default off).
• Channel overrides: *.blockStreaming (and per-account variants) to force "on"/"off" per channel.
• agents.defaults.blockStreamingBreak: "text_end" or "message_end".
• agents.defaults.blockStreamingChunk: { minChars, maxChars, breakPreference? }.
• agents.defaults.blockStreamingCoalesce: { minChars?, maxChars?, idleMs? } (merge streamed blocks before send).
• Channel hard cap: *.textChunkLimit (e.g., channels.whatsapp.textChunkLimit).
• Channel chunk mode: *.chunkMode (length default, newline splits on blank lines (paragraph boundaries) before length chunking).
• Discord soft cap: channels.discord.maxLinesPerMessage (default 17) splits tall replies to avoid UI clipping.

• text_end: stream blocks as soon as chunker emits; flush on each text_end.
• message_end: wait until assistant message finishes, then flush buffered output.

​

Chunking algorithm (low/high bounds)

• Low bound: don’t emit until buffer >= minChars (unless forced).
• High bound: prefer splits before maxChars; if forced, split at maxChars.
• Break preference: paragraph → newline → sentence → whitespace → hard break.
• Code fences: never split inside fences; when forced at maxChars, close + reopen the fence to keep Markdown valid.

​

Coalescing (merge streamed blocks)

• Coalescing waits for idle gaps (idleMs) before flushing.
• Buffers are capped by maxChars and will flush if they exceed it.
• minChars prevents tiny fragments from sending until enough text accumulates (final flush always sends remaining text).
• Joiner is derived from blockStreamingChunk.breakPreference (paragraph → \n\n, newline → \n, sentence → space).
• Channel overrides are available via *.blockStreamingCoalesce (including per-account configs).
• Default coalesce minChars is bumped to 1500 for Signal/Slack/Discord unless overridden.

​

Human-like pacing between blocks

• Config: agents.defaults.humanDelay (override per agent via agents.list[].humanDelay).
• Modes: off (default), natural (800–2500ms), custom (minMs/maxMs).
• Applies only to block replies, not final replies or tool summaries.

​

”Stream chunks or everything”

• Stream chunks: blockStreamingDefault: "on" + blockStreamingBreak: "text_end" (emit as you go). Non-Telegram channels also need *.blockStreaming: true.
• Stream everything at end: blockStreamingBreak: "message_end" (flush once, possibly multiple chunks if very long).
• No block streaming: blockStreamingDefault: "off" (only final reply).

​

Preview streaming modes

• off: disable preview streaming.
• partial: single preview that is replaced with latest text.
• block: preview updates in chunked/appended steps.
• progress: progress/status preview during generation, final answer at completion.

​

Channel mapping

• channels.slack.nativeStreaming toggles Slack native streaming API calls when streaming=partial (default: true).

• Telegram: streamMode + boolean streaming auto-migrate to streaming enum.
• Discord: streamMode + boolean streaming auto-migrate to streaming enum.
• Slack: streamMode auto-migrates to streaming enum; boolean streaming auto-migrates to nativeStreaming.

​

Runtime behavior

• Uses sendMessage + editMessageText preview updates across DMs and group/topics.
• Preview streaming is skipped when Telegram block streaming is explicitly enabled (to avoid double-streaming).
• /reasoning stream can write reasoning to preview.

• Uses send + edit preview messages.
• block mode uses draft chunking (draftChunk).
• Preview streaming is skipped when Discord block streaming is explicitly enabled.

• partial can use Slack native streaming (chat.startStream/append/stop) when available.
• block uses append-style draft previews.
• progress uses status preview text, then final answer.