@llblab/pi-telegram 0.48.0 → 0.48.1

package/AGENTS.md

@@ -92,7 +92,7 @@ Use the relevant local skill before non-trivial work in its domain. Keep skill o
 
 ### 4.4 Queue, Delivery, And User Surfaces
 
-- Queue lane/kind admission is explicit. Dispatch waits for active-turn, pending-dispatch, control, compaction, `ctx.isIdle()`, and Pi pending-message guards; a dispatched prompt stays queued until `agent_start` consumes it. Each prompt is one object with one active lane and no reserved return slot. Normal and Priority are separate FIFO lanes: crossing lanes removes it from the source and appends it at the destination tail, while Keep/Skip and same-category emoji changes preserve lane position. Complete reaction sets independently derive Priority from recognized positive emoji and Skip from recognized negative emoji; both may coexist, suppressed turns retain durable receipts while waiting, and Skip settles them only when the prompt reaches dispatch before dropping it without inference. Suppressed turns remain visible at a struck-through physical ordinal without contributing to executable queue counters, while graceful session shutdown discards all remaining queue authority before clearing memory.
+- Queue lane/kind admission is explicit. Dispatch waits for active-turn, pending-dispatch, control, compaction, `ctx.isIdle()`, and Pi pending-message guards; a dispatched prompt stays queued until `agent_start` consumes it. The terminal `+N` suffix is a yellow count of executable prompts still waiting, excludes the dispatched head immediately, and never counts current agent work from any source. Each prompt is one object with one active lane and no reserved return slot. Normal and Priority are separate FIFO lanes: crossing lanes removes it from the source and appends it at the destination tail, while Keep/Skip and same-category emoji changes preserve lane position. Complete reaction sets independently derive Priority from recognized positive emoji and Skip from recognized negative emoji; both may coexist, suppressed turns retain durable receipts while waiting, and Skip settles them only when the prompt reaches dispatch before dropping it without inference. Suppressed turns remain visible at a struck-through physical ordinal without contributing to executable queue counters, while graceful session shutdown discards all remaining queue authority before clearing memory.
 - `/stop`, `/abort`, `/next`, and `/continue` respectively reset+abort, abort while preserving queue, force the next turn, and enqueue a control-lane continuation. Abort-history folding applies only to Telegram-owned active turns.
 - Telegram extension side effects must not hold Pi's core lifecycle hostage after semantic completion. Preserve ordering in extension-owned background work, record failures, and fence target/profile/transport/session authority.
 - Complete assistant/guest model answers use Telegram-native Rich Markdown. Harness-owned menus, status, diagnostics, thinking, and tool evidence remain explicit HTML/plain or their documented native surface. Before Telegram preview or final delivery, strip every assistant-authored HTML comment regardless of Markdown position while keeping action activation top-level-only; a comment-only result sends no text message. Preserve literal code outside comments and structurally safe chunking; never split invalid markup.

package/CHANGELOG.md

@@ -4,6 +4,10 @@
 
 ## Unreleased
 
+## 0.48.1: Truthful terminal queue count hotfix
+
+- `Terminal queue status`: The yellow `+N` suffix now counts only executable prompts still waiting in the Telegram queue. The current agent run never contributes—whether it started from Telegram, the terminal, or autonomous continuation—and a dispatched Telegram prompt leaves the visible count before its run settles.
+
 ## 0.48.0: Unified activity and Thread display
 
 - `Unified activity`: The terminal keeps its stable `connected`, `leader`, or `follower` identity while work runs. Active work uses the same green Queue count as queued items, while Telegram typing projects every agent run—including local or autonomous work—into the assigned Thread and aggregate `All` target.

package/README.md

@@ -200,7 +200,7 @@ Messages sent while Pi is busy become queued turns. Queue controls let you inspe
 
 Queue policy:
 
-- One prompt is one queue object with exactly one current lane and one current position; it never reserves a shadow place in the other lane.
+- One prompt is one queue object with exactly one current lane and one current position; it never reserves a shadow place in the other lane. The terminal's yellow `+N` suffix counts only executable prompts still waiting, never the current run; a dispatched Telegram prompt stops contributing before that run settles.
 - Priority and Normal are separate FIFO lanes; Priority dispatches first.
 - Moving `Normal → Priority` removes the prompt from Normal and places it at the Priority tail. Moving `Priority → Normal` removes it from Priority and places it at the Normal tail; no former position is restored.
 - Keep/Skip never changes lane position. Skip preserves durable authority while waiting so Keep remains reversible, then settles that authority and drops the prompt without a model turn when dispatch reaches it. Skipped prompts stay visible at their physical queue position with a struck-through ordinal, but are excluded immediately from the executable queue count shown in both the Pi status bar and Telegram main menu. Graceful session shutdown discards all remaining queued authority, so a new session starts empty.

package/dist/lib/status.js

@@ -215,19 +215,13 @@ export function createTelegramBridgeStatusRuntime(deps) {
         getStatusBarState: (_ctx, error) => {
             const config = deps.getConfig();
             const queuedItems = deps.getQueuedItems();
-            const queuedItemCount = deps.getQueuedItemCount?.(queuedItems) ?? queuedItems.length;
-            const hasActiveTurn = deps.hasActiveTurn();
             const hasPendingDispatch = deps.hasDispatchPending();
+            const waitingItems = hasPendingDispatch ? queuedItems.slice(1) : queuedItems;
+            const queuedItemCount = deps.getQueuedItemCount?.(waitingItems) ?? waitingItems.length;
+            const hasActiveTurn = deps.hasActiveTurn();
             const hasPendingModelSwitch = deps.hasPendingModelSwitch();
             const activeToolExecutions = deps.getActiveToolExecutions();
             const compactionInProgress = deps.isCompactionInProgress();
-            const activeWorkCount = hasActiveTurn ||
-                hasPendingModelSwitch ||
-                activeToolExecutions > 0 ||
-                compactionInProgress ||
-                (hasPendingDispatch && queuedItemCount === 0)
-                ? 1
-                : 0;
             const localBus = deps.getLocalBus?.();
             return {
                 hasBotToken: config.botHasToken ?? Boolean(config.botToken),
@@ -251,9 +245,7 @@ export function createTelegramBridgeStatusRuntime(deps) {
                     activeToolExecutions,
                     queuedItems: queuedItemCount,
                 }),
-                queuedStatus: activeWorkCount + queuedItemCount > 0
-                    ? ` +${activeWorkCount + queuedItemCount}`
-                    : "",
+                queuedStatus: queuedItemCount > 0 ? ` +${queuedItemCount}` : "",
                 pollingStopReason: deps.getPollingState?.().stopReason,
                 error,
             };
@@ -414,7 +406,7 @@ function getTelegramStatusBarLabel(state) {
 export function buildTelegramStatusBarText(theme, state) {
     const label = theme.fg("accent", getTelegramStatusBarLabel(state));
     const queued = state.queuedStatus
-        ? theme.fg("success", state.queuedStatus)
+        ? theme.fg("warning", state.queuedStatus)
         : "";
     if (!state.hasBotToken)
         return `${label} ${theme.fg("muted", "not configured")}${queued}`;

package/dist/package.json

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

package/docs/architecture.md

@@ -452,7 +452,9 @@ Long-text split recovery remains conservative: only human text at or above the n
 
 ### Queue And Dispatch Safety
 
-The bridge keeps its own Telegram queue. Queue items have two explicit dimensions:
+The bridge keeps its own Telegram queue. The Pi status bar's yellow `+N` suffix projects only executable prompts still waiting: current agent work from Telegram, terminal, or autonomous sources never contributes, and the dispatched Telegram head is subtracted while it remains retained pending `agent_start` consumption.
+
+Queue items have two explicit dimensions:
 
 - `kind`: `prompt` or `control`.
 - `queueLane`: `control`, `priority`, or `default`.

package/lib/status.ts

@@ -705,20 +705,14 @@ export function createTelegramBridgeStatusRuntime<
     getStatusBarState: (_ctx, error) => {
       const config = deps.getConfig();
       const queuedItems = deps.getQueuedItems();
-      const queuedItemCount = deps.getQueuedItemCount?.(queuedItems) ?? queuedItems.length;
-      const hasActiveTurn = deps.hasActiveTurn();
       const hasPendingDispatch = deps.hasDispatchPending();
+      const waitingItems = hasPendingDispatch ? queuedItems.slice(1) : queuedItems;
+      const queuedItemCount =
+        deps.getQueuedItemCount?.(waitingItems) ?? waitingItems.length;
+      const hasActiveTurn = deps.hasActiveTurn();
       const hasPendingModelSwitch = deps.hasPendingModelSwitch();
       const activeToolExecutions = deps.getActiveToolExecutions();
       const compactionInProgress = deps.isCompactionInProgress();
-      const activeWorkCount =
-        hasActiveTurn ||
-        hasPendingModelSwitch ||
-        activeToolExecutions > 0 ||
-        compactionInProgress ||
-        (hasPendingDispatch && queuedItemCount === 0)
-          ? 1
-          : 0;
       const localBus = deps.getLocalBus?.();
       return {
         hasBotToken: config.botHasToken ?? Boolean(config.botToken),
@@ -743,10 +737,7 @@ export function createTelegramBridgeStatusRuntime<
           activeToolExecutions,
           queuedItems: queuedItemCount,
         }),
-        queuedStatus:
-          activeWorkCount + queuedItemCount > 0
-            ? ` +${activeWorkCount + queuedItemCount}`
-            : "",
+        queuedStatus: queuedItemCount > 0 ? ` +${queuedItemCount}` : "",
         pollingStopReason: deps.getPollingState?.().stopReason,
         error,
       };
@@ -935,7 +926,7 @@ export function buildTelegramStatusBarText(
 ): string {
   const label = theme.fg("accent", getTelegramStatusBarLabel(state));
   const queued = state.queuedStatus
-    ? theme.fg("success", state.queuedStatus)
+    ? theme.fg("warning", state.queuedStatus)
     : "";
   if (!state.hasBotToken)
     return `${label} ${theme.fg("muted", "not configured")}${queued}`;

package/package.json

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