@llblab/pi-telegram 0.26.13 → 0.26.14

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.26.14: Reasoning Activity Throttle
+
+- `Reasoning Throttle`: Added a minimum interval between reasoning-block edits (`TELEGRAM_REASONING_MIN_INTERVAL_MS = 1_200`) so the first frame publishes immediately while later frames wait until both the interval and the 160-char delta threshold pass. The final `reasoning-end`/`agent-end` flush stays unconditional, and the 24-frame cap is unchanged. Impact: fast-token models with very large reasoning blocks no longer push an edit per character burst, so parallel threads stop saturating the bus and inbound Telegram messages arrive without multi-second delay.
+
 ## 0.26.13: Entrypoint Compression And BotFather Prerequisites
 
 - `Entrypoint Compression`: Moved low-level policy out of `index.ts` into owning domains: the deferred queue dispatch delay defaults in the queue domain, the delivery generation seed is built by the delivery domain, the `target-bindings` sync slice key and the default profile name resolve from their domains, and bus-runtime capability answers come from the thread capability state. Removed a redundant follower client timeout literal that duplicated the domain default. Impact: the composition root wires ports while constants, generations, and capability decisions stay with their owning domains.

package/lib/activity-verbosity.ts

@@ -24,6 +24,7 @@ export const TELEGRAM_ACTIVITY_MESSAGE_MAX_CHARS = 3_900;
 export const TELEGRAM_ACTIVITY_MESSAGE_MAX_TOOLS = 6;
 export const TELEGRAM_REASONING_MESSAGE_MAX_FRAMES = 24;
 export const TELEGRAM_REASONING_BUFFER_MAX_CHARS = 1_200;
+export const TELEGRAM_REASONING_MIN_INTERVAL_MS = 1_200;
 export const TELEGRAM_TOOL_UPDATE_MAX_ENTRIES = 4;
 
 interface ToolActivity {
@@ -291,6 +292,7 @@ export interface TelegramActivityVerbosityRuntime {
 export function createTelegramActivityVerbosityRuntime<TAuthority>(deps: {
   getActivityMode: () => "quiet" | "thinking" | "tools" | "verbose";
   refreshActivityMode?: () => Promise<void>;
+  getNowMs?: () => number;
   resolveTarget: (event: TelegramActivityEvent) => TelegramTarget | undefined;
   captureAuthority: () => TAuthority;
   isAuthorityActive: (authority: TAuthority) => boolean;
@@ -315,6 +317,7 @@ export function createTelegramActivityVerbosityRuntime<TAuthority>(deps: {
   let active = true;
   let generation = 0;
   let tail = Promise.resolve();
+  const getNowMs = deps.getNowMs ?? Date.now;
   let activityId: string | undefined;
   let authority: TAuthority | undefined;
   let target: TelegramTarget | undefined;
@@ -324,6 +327,7 @@ export function createTelegramActivityVerbosityRuntime<TAuthority>(deps: {
   let lastReasoningMessageChars = 0;
   let reasoningMessage: ReasoningMessage | undefined;
   let reasoningBlocked = false;
+  let lastReasoningPublishMs = 0;
   let toolMessage: ToolMessage | undefined;
   const tools = new Map<string, ToolActivity>();
   const toolOrder: string[] = [];
@@ -338,6 +342,7 @@ export function createTelegramActivityVerbosityRuntime<TAuthority>(deps: {
     lastReasoningMessageChars = 0;
     reasoningMessage = undefined;
     reasoningBlocked = false;
+    lastReasoningPublishMs = 0;
     toolMessage = undefined;
     tools.clear();
     toolOrder.length = 0;
@@ -412,6 +417,7 @@ export function createTelegramActivityVerbosityRuntime<TAuthority>(deps: {
       if (generation !== acceptedGeneration) return;
       reasoningMessageFrames += 1;
       lastReasoningMessageChars = reasoningChars;
+      lastReasoningPublishMs = getNowMs();
     } catch (error) {
       deps.recordFailure?.(
         canEdit ? "reasoning-edit" : "reasoning-send",
@@ -552,10 +558,11 @@ export function createTelegramActivityVerbosityRuntime<TAuthority>(deps: {
       reasoningBuffer = `${reasoningBuffer}${event.delta}`.slice(
         -TELEGRAM_REASONING_BUFFER_MAX_CHARS,
       );
-      if (
-        reasoningMessageFrames < TELEGRAM_REASONING_MESSAGE_MAX_FRAMES &&
+      if (reasoningMessageFrames < TELEGRAM_REASONING_MESSAGE_MAX_FRAMES &&
         (reasoningMessageFrames === 0 ||
-          reasoningChars - lastReasoningMessageChars >= 160)
+          (getNowMs() - lastReasoningPublishMs >=
+            TELEGRAM_REASONING_MIN_INTERVAL_MS &&
+            reasoningChars - lastReasoningMessageChars >= 160))
       ) {
         await publishReasoning(event, acceptedGeneration);
       }
@@ -580,6 +587,7 @@ export function createTelegramActivityVerbosityRuntime<TAuthority>(deps: {
       reasoningChars = 0;
       reasoningMessageFrames = 0;
       lastReasoningMessageChars = 0;
+      lastReasoningPublishMs = 0;
       reasoningMessage = undefined;
       reasoningBlocked = false;
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-telegram",
-  "version": "0.26.13",
+  "version": "0.26.14",
   "private": false,
   "publishConfig": {
     "access": "public"