​

Streaming + découpage en morceaux

• Streaming par blocs (canaux) : émet des blocs terminés pendant que l’assistant écrit. Ce sont des messages de canal normaux (pas des deltas de jetons).
• Streaming d’aperçu (Telegram/Discord/Slack) : met à jour un message d’aperçu temporaire pendant la génération.

​

Streaming par blocs (messages de canal)

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 : événements de flux du modèle (peuvent être rares pour les modèles sans streaming).
• chunker : EmbeddedBlockChunker appliquant des limites min/max + la préférence de coupure.
• channel send : messages sortants réels (réponses par blocs).

• agents.defaults.blockStreamingDefault : "on"/"off" (désactivé par défaut).
• Surcharges de canal : *.blockStreaming (et variantes par compte) pour forcer "on"/"off" par canal.
• agents.defaults.blockStreamingBreak : "text_end" ou "message_end".
• agents.defaults.blockStreamingChunk : { minChars, maxChars, breakPreference? }.
• agents.defaults.blockStreamingCoalesce : { minChars?, maxChars?, idleMs? } (fusionne les blocs streamés avant l’envoi).
• Limite stricte du canal : *.textChunkLimit (par ex. channels.whatsapp.textChunkLimit).
• Mode de découpage du canal : *.chunkMode (length par défaut, newline coupe sur les lignes vides (limites de paragraphe) avant le découpage par longueur).
• Limite souple Discord : channels.discord.maxLinesPerMessage (17 par défaut) découpe les réponses longues pour éviter le rognage dans l’interface.

• text_end : diffuse les blocs dès que le chunker en émet ; vide le tampon à chaque text_end.
• message_end : attend que le message de l’assistant soit terminé, puis vide la sortie mise en tampon.

​

Algorithme de découpage en morceaux (limites basse/haute)

• Limite basse : n’émet rien tant que le tampon n’a pas atteint minChars (sauf si forcé).
• Limite haute : préfère des coupures avant maxChars ; si forcé, coupe à maxChars.
• Préférence de coupure : paragraph → newline → sentence → whitespace → coupure forcée.
• Blocs de code délimités : ne jamais couper à l’intérieur ; en cas de coupure forcée à maxChars, ferme puis rouvre le bloc pour conserver un Markdown valide.

​

Coalescence (fusion des blocs streamés)

• La coalescence attend des périodes d’inactivité (idleMs) avant de vider le tampon.
• Les tampons sont plafonnés par maxChars et seront vidés s’ils le dépassent.
• minChars empêche l’envoi de fragments minuscules tant qu’assez de texte ne s’est pas accumulé (le vidage final envoie toujours le texte restant).
• Le séparateur est dérivé de blockStreamingChunk.breakPreference (paragraph → \n\n, newline → \n, sentence → espace).
• Des surcharges par canal sont disponibles via *.blockStreamingCoalesce (y compris dans les configs par compte).
• La valeur par défaut de minChars pour la coalescence est portée à 1500 pour Signal/Slack/Discord sauf surcharge.

​

Rythme plus humain entre les blocs

• Config : agents.defaults.humanDelay (surcharge par agent via agents.list[].humanDelay).
• Modes : off (par défaut), natural (800–2500ms), custom (minMs/maxMs).
• S’applique uniquement aux réponses par blocs, pas aux réponses finales ni aux résumés d’outils.

​

« Stream les morceaux ou tout »

• Stream les morceaux : blockStreamingDefault: "on" + blockStreamingBreak: "text_end" (émet au fil de l’eau). Les canaux autres que Telegram ont aussi besoin de *.blockStreaming: true.
• Tout streamer à la fin : blockStreamingBreak: "message_end" (vide une fois, éventuellement en plusieurs morceaux si c’est très long).
• Aucun streaming par blocs : blockStreamingDefault: "off" (réponse finale uniquement).

​

Modes de streaming d’aperçu

• off : désactive le streaming d’aperçu.
• partial : aperçu unique remplacé par le texte le plus récent.
• block : mises à jour d’aperçu par étapes découpées/ajoutées.
• progress : aperçu d’avancement/statut pendant la génération, réponse finale à la fin.

​

Mappage par canal

• channels.slack.streaming.nativeTransport active/désactive les appels à l’API de streaming native de Slack lorsque channels.slack.streaming.mode="partial" (par défaut : true).
• Le streaming natif Slack et l’état des fils d’assistant Slack nécessitent une cible de fil de réponse ; les DM de niveau supérieur n’affichent pas cet aperçu de type fil.

• Telegram : streamMode + booléen streaming sont automatiquement migrés vers l’énumération streaming.
• Discord : streamMode + booléen streaming sont automatiquement migrés vers l’énumération streaming.
• Slack : streamMode migre automatiquement vers streaming.mode ; le booléen streaming migre automatiquement vers streaming.mode plus streaming.nativeTransport ; l’ancien nativeStreaming migre automatiquement vers streaming.nativeTransport.

​

Comportement à l’exécution

• Utilise les mises à jour d’aperçu sendMessage + editMessageText dans les DM et les groupes/sujets.
• Le streaming d’aperçu est ignoré lorsque le streaming par blocs Telegram est explicitement activé (pour éviter un double streaming).
• /reasoning stream peut écrire le raisonnement dans l’aperçu.

• Utilise l’envoi + la modification de messages d’aperçu.
• Le mode block utilise le découpage de brouillon (draftChunk).
• Le streaming d’aperçu est ignoré lorsque le streaming par blocs Discord est explicitement activé.

• partial peut utiliser le streaming natif de Slack (chat.startStream/append/stop) lorsqu’il est disponible.
• block utilise des aperçus de brouillon de style ajout.
• progress utilise un texte d’aperçu de statut, puis la réponse finale.

​

Lié

• Messages — cycle de vie et distribution des messages
• Retry — comportement de nouvelle tentative en cas d’échec de distribution
• Channels — prise en charge du streaming par canal