​

البثّ + التجزئة

• بثّ الكتل (القنوات): إرسال كتل مكتملة مع كتابة المساعد. هذه رسائل قناة عادية (وليست دلتا رموز).
• بثّ شبيه بالرموز (Telegram فقط): تحديث فقاعة مسودة بنص جزئي أثناء التوليد؛ ويتم إرسال الرسالة النهائية في النهاية.

​

بثّ الكتل (رسائل القنوات)

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: أحداث بثّ النموذج (قد تكون متباعدة في النماذج غير الداعمة للبثّ).
• chunker: EmbeddedBlockChunker مع تطبيق الحدود الدنيا/العليا + تفضيل موضع الفصل.
• channel send: الرسائل الصادرة الفعلية (ردود الكتل).

• agents.defaults.blockStreamingDefault: "on"/"off" (معطّل افتراضيًا).
• تجاوزات القناة: *.blockStreaming (ومثيلاتها لكل حساب) لفرض "on"/"off" لكل قناة.
• agents.defaults.blockStreamingBreak: "text_end" أو "message_end".
• agents.defaults.blockStreamingChunk: { minChars, maxChars, breakPreference? }.
• agents.defaults.blockStreamingCoalesce: { minChars?, maxChars?, idleMs? } (دمج الكتل المبثوثة قبل الإرسال).
• الحدّ الصارم للقناة: *.textChunkLimit (مثل channels.whatsapp.textChunkLimit).
• وضع تجزئة القناة: *.chunkMode (الافتراضي length، وnewline يفصل عند الأسطر الفارغة «حدود الفقرات» قبل التجزئة حسب الطول).
• الحدّ اللين لـ Discord: channels.discord.maxLinesPerMessage (الافتراضي 17) يقسّم الردود الطويلة لتجنّب اقتطاع الواجهة.

• text_end: بثّ الكتل فور أن يُصدر المُجزِّئ مقطعًا؛ التفريغ عند كل text_end.
• message_end: الانتظار حتى تنتهي رسالة المساعد، ثم تفريغ المخرجات المخزّنة.

​

خوارزمية القطع (حدود منخفضة/مرتفعة)

• الحدّ الأدنى: لا تُصدر مقطعًا حتى يصل المخزن إلى >= minChars (إلا إذا فُرض الإصدار).
• الحدّ الأعلى: تفضيل الفصل قبل maxChars؛ وإذا فُرض، فالفصل عند maxChars.
• تفضيل موضع الفصل: paragraph → newline → sentence → whitespace → فصل قاسٍ.
• أسوار الشيفرة: لا يتم الفصل داخل الأسوار مطلقًا؛ وعند الاضطرار عند maxChars، يتم إغلاق السور ثم إعادة فتحه للحفاظ على صحة Markdown.

​

الدمج (دمج الكتل المبثوثة)

• ينتظر الدمج فجوات خمول (idleMs) قبل التفريغ.
• تُقيَّد المخازن بـ maxChars وسيتم تفريغها إذا تجاوزته.
• يمنع minChars إرسال الشذرات الصغيرة حتى يتراكم نص كافٍ (والتفريغ النهائي يرسل دائمًا النص المتبقي).
• يُشتقّ رابط الدمج من blockStreamingChunk.breakPreference (paragraph → \n\n، newline → \n، sentence → مسافة).
• تتوفر تجاوزات القناة عبر *.blockStreamingCoalesce (بما في ذلك تهيئات لكل حساب).
• القيمة الافتراضية لدمج minChars تُرفع إلى 1500 في Signal/Slack/Discord ما لم يتم تجاوزها.

​

إيقاع شبيه بالبشر بين الكتل

• التهيئة: agents.defaults.humanDelay (التجاوز لكل وكيل عبر agents.list[].humanDelay).
• الأوضاع: off (افتراضي)، natural (800–2500 مللي ثانية)، custom (minMs/maxMs).
• ينطبق فقط على ردود الكتل، وليس الردود النهائية أو ملخصات الأدوات.

​

«بثّ المقاطع أم كل شيء»

• بثّ المقاطع: blockStreamingDefault: "on" + blockStreamingBreak: "text_end" (الإصدار أثناء التوليد). تحتاج القنوات غير Telegram أيضًا إلى *.blockStreaming: true.
• بثّ كل شيء في النهاية: blockStreamingBreak: "message_end" (تفريغ واحد، وربما عدة مقاطع إذا كان الطول كبيرًا جدًا).
• بدون بثّ كتل: blockStreamingDefault: "off" (الرد النهائي فقط).

​

بثّ مسودة Telegram (شبيه بالرموز)

• يستخدم Bot API sendMessage (لأول تحديث) + editMessageText (للتحديثات اللاحقة).
• channels.telegram.streamMode: "partial" | "block" | "off".
  • partial: تحديثات المسودة بأحدث نص بثّ.
  • block: تحديثات المسودة على شكل كتل مُجزّأة (قواعد المُجزِّئ نفسها).
  • off: بدون بثّ مسودة.
• تهيئة تجزئة المسودة (فقط لـ streamMode: "block"): channels.telegram.draftChunk (الافتراضيات: minChars: 200، maxChars: 800).
• بث المعاينة منفصل عن بث الكتل.
• عند تمكين بث كتل Telegram صراحةً، يتم تخطي بث المعاينة لتجنب البث المزدوج.
• يتم تطبيق النتائج النصية فقط عبر تعديل رسالة المعاينة في مكانها.
• الرد النهائي يظل رسالة عادية.
• يقوم /reasoning stream بكتابة الاستدلال داخل فقاعة المسودة (Telegram فقط).

Telegram (private + topics)
  └─ sendMessageDraft (draft bubble)
       ├─ streamMode=partial → update latest text
       └─ streamMode=block   → chunker updates draft
  └─ final reply → normal message

• preview message: رسالة Telegram مؤقتة يتم تحديثها أثناء التوليد.
• final edit: تعديل في نفس رسالة المعاينة (نص فقط).