@llblab/pi-kit 0.33.1 → 0.34.1

package/node_modules/@llblab/pi-telegram/lib/routing.ts

@@ -916,6 +916,16 @@ export function createTelegramLiveRebindCoordinator(input: {
           }
         : undefined;
     },
+    /** Observe only an already-issued leader command; never prepares, relocates or executes input. */
+    observeCommandCompletion(): "unknown" | "released" | undefined {
+      if (!continuationIssued || !leader?.complete) return undefined;
+      if (!current()) return "unknown";
+      try { return observeCommandCompletion(); }
+      catch (error) {
+        input.recordRuntimeEvent?.("telegram", error, { phase: "live-rebind-command-observation" });
+        return "unknown";
+      }
+    },
     async advance(): Promise<"protected" | "unknown" | "released"> {
       if (advancing || !current()) return "protected";
       if (released) return "released";
@@ -1561,6 +1571,8 @@ export interface TelegramInboundRouteRuntimeDeps<
   /** Quiet period after the last cancelled input before one cleanup attempt; defaults to 0 ms. */
   temporaryThreadCleanupDelayMs?: number;
   /** Live-rebind cleanup attempt pacing; the bounded window ends in `not-issued`, never a time-based deletion. */
+  /** Bounded ACK observation inside the original chooser admission, independent from menu/reply delivery. */
+  liveRebindCommandCompletionTimeoutMs?: number;
   liveRebindCleanupSchedule?: {
     delaysMs: readonly number[];
     intervalMs: number;
@@ -1937,6 +1949,7 @@ export function createTelegramInboundRouteRuntime<
       extensionCommand?: Commands.ParsedTelegramCommand;
       extensionKind?: Commands.PreparedSelectedCommand["kind"];
       coordinator?: ReturnType<typeof createTelegramLiveRebindCoordinator>;
+      commandCompletionWaited?: true;
       isCurrent?: () => boolean;
     };
     /** The acknowledged tab presenting an All source; `sourceTarget` is this tab, not the original's location. */
@@ -4870,7 +4883,7 @@ export function createTelegramInboundRouteRuntime<
         Bus.isSameTelegramBusFollowerRegistration(live, follower!) &&
         [
           ...Bus.TELEGRAM_BUS_LIVE_REBIND_CAPABILITIES,
-          ...(heldSelected ? Bus.TELEGRAM_BUS_HELD_COMMAND_CAPABILITIES : []),
+          ...(heldSelected ? Bus.getTelegramBusHeldCommandCapabilities(heldSelected.name) : []),
         ].every((cap) => Bus.hasTelegramBusCapability(live.protocol, cap)) &&
         !!live.target &&
         live.target.chatId === binding.target.chatId &&
@@ -5642,6 +5655,7 @@ export function createTelegramInboundRouteRuntime<
     return {
       operationId: request.operationId,
       selectedCommandReference: () => coordinator?.selectedCommandReference(),
+      observeCommandCompletion: () => coordinator?.observeCommandCompletion(),
       async advance() {
         if (!coordinator) {
           if (!current() || !getRecipient()) return "protected";
@@ -9058,6 +9072,42 @@ export function createTelegramInboundRouteRuntime<
         if (!(await selectPendingDestination())) return true;
         const operationId = selection.coordinator.operationId;
         if (current()) outcome = await selection.coordinator.advance();
+        const completionTimeoutMs = deps.liveRebindCommandCompletionTimeoutMs ?? 0;
+        if (outcome === "unknown" && !selection.commandCompletionWaited && selection.record.owner?.kind === "leader" &&
+          (selection.helpCommand || selection.menuCommand || selection.abortCommand || selection.nextCommand || selection.stopCommand) &&
+          Number.isFinite(completionTimeoutMs) && completionTimeoutMs > 0 &&
+          selection.coordinator.observeCommandCompletion() !== undefined) {
+          selection.commandCompletionWaited = true;
+          const coordinator = selection.coordinator;
+          const signal = Updates.getTelegramUpdateExecutionFence(query)?.signal;
+          outcome = await new Promise<"unknown" | "released">((resolve) => {
+            let settled = false;
+            const subscriptions: (() => void)[] = [];
+            const finish = (result: "unknown" | "released") => {
+              if (settled) return;
+              settled = true;
+              clearTimeout(timer);
+              for (const unsubscribe of subscriptions) unsubscribe();
+              signal?.removeEventListener("abort", abort);
+              resolve(result);
+            };
+            const abort = () => finish("unknown");
+            const observe = () => {
+              if (settled) return;
+              if (!current()) { finish("unknown"); return; }
+              if (coordinator.observeCommandCompletion() === "released") finish("released");
+            };
+            const timer = setTimeout(abort, completionTimeoutMs);
+            timer.unref?.();
+            for (const message of selection.messages) {
+              const unsubscribe = Updates.subscribeTelegramDeferredSourceCompletion(message, observe);
+              if (unsubscribe) subscriptions.push(unsubscribe);
+            }
+            signal?.addEventListener("abort", abort, { once: true });
+            if (signal?.aborted || !current()) abort();
+            else if (coordinator.observeCommandCompletion() === "released") finish("released");
+          });
+        }
         // Cleanup readiness follows the canonical released row, not source disposal: a detached command ACK may
         // still be pending while every attempt samples current work afresh.
         const row =

package/node_modules/@llblab/pi-telegram/lib/status.ts

@@ -66,7 +66,7 @@ export function formatTelegramConnectionFailure(error: unknown): string {
 
 const TELEGRAM_STATUS_DEFAULT_PROFILE_NAME = "default";
 
-export type TelegramStatusQueueLane = "control" | "priority" | "default";
+export type TelegramStatusQueueLane = "control" | "steer" | "priority" | "default";
 
 export interface TelegramUsageStats {
   totalInput: number;
@@ -441,7 +441,6 @@ export interface TelegramBridgeStatusRuntimeDeps<
   hasPendingModelSwitch: () => boolean;
   getQueuedItems: () => TQueueItem[];
   getQueuedItemCount?: (items: TQueueItem[]) => number;
-  formatQueuedStatus: (items: TQueueItem[]) => string;
   getRecentRuntimeEvents: () => TelegramRuntimeEvent[];
   getRuntimeLockState?: () => string;
   getBusRole?: () => TelegramBridgeBusRole | undefined;
@@ -1200,9 +1199,7 @@ export function buildTelegramStatusBarText(
   state: TelegramStatusBarState,
 ): string {
   const label = theme.fg("accent", getTelegramStatusBarLabel(state));
-  const queued = state.queuedStatus
-    ? theme.fg("warning", state.queuedStatus)
-    : "";
+  const queued = state.queuedStatus ? theme.fg("warning", state.queuedStatus) : "";
   if (!state.hasBotToken)
     return `${label} ${theme.fg("muted", "not configured")}${queued}`;
   if (
@@ -1612,6 +1609,7 @@ function countTelegramQueueLanes(
 ): Record<TelegramStatusQueueLane, number> {
   const counts: Record<TelegramStatusQueueLane, number> = {
     control: 0,
+    steer: 0,
     priority: 0,
     default: 0,
   };
@@ -1626,10 +1624,11 @@ function buildTelegramBridgeCompactStatusLines(
     control: controlQueueCount,
     priority: priorityQueueCount,
     default: defaultQueueCount,
+    steer: steerQueueCount,
   } = countTelegramQueueLanes(state.queuedItems);
   const queueLine = `- queued turns: ${state.queuedItems.length}${
     state.queuedItems.length > 0
-      ? ` (control=${controlQueueCount}, priority=${priorityQueueCount}, default=${defaultQueueCount})`
+      ? ` (control=${controlQueueCount}${steerQueueCount > 0 ? `, steer=${steerQueueCount}` : ""}, priority=${priorityQueueCount}, default=${defaultQueueCount})`
       : ""
   }`;
   const executionState = state.pendingDispatch
@@ -1698,6 +1697,7 @@ function buildTelegramBridgeDiagnosticStatusLines(
     control: controlQueueCount,
     priority: priorityQueueCount,
     default: defaultQueueCount,
+    steer: steerQueueCount,
   } = countTelegramQueueLanes(state.queuedItems);
   return [
     "connection:",
@@ -1744,7 +1744,7 @@ function buildTelegramBridgeDiagnosticStatusLines(
     "",
     "queue:",
     `- queued turns: ${state.queuedItems.length}`,
-    `- lanes: control=${controlQueueCount}, priority=${priorityQueueCount}, default=${defaultQueueCount}`,
+    `- lanes: control=${controlQueueCount}${steerQueueCount > 0 ? `, steer=${steerQueueCount}` : ""}, priority=${priorityQueueCount}, default=${defaultQueueCount}`,
     ...buildTelegramBusFollowerLines(state),
     ...buildTelegramLocalBusLines(state, { verbose: true }),
     ...buildTelegramTopicTargetDiagnosticLines(state),

package/node_modules/@llblab/pi-telegram/lib/sync.ts

@@ -18,6 +18,7 @@ import {
   isSameTelegramProcessInstance,
   isTelegramTopicTargetStaleError,
   provisionOwnBusTopic,
+  resetTelegramConnectionProvisioning,
   type TelegramOwnTopicProvisionResult,
   type TelegramTopicTargetStore,
   type TelegramWorkspaceDisplayBinding,
@@ -826,6 +827,15 @@ export async function ensureTelegramLeaderThreadBinding(
     ...(deps.telegramProfile ? { telegramProfile: deps.telegramProfile } : {}),
   };
   const leaderProfileKey = getTelegramThreadOwnerKey(leaderOwner);
+  if (deps.forceFreshUnnamed) {
+    await resetTelegramConnectionProvisioning({
+      store: deps.topicTargetStore, owner: "leader", instanceId: deps.instanceId,
+      profileKey: leaderProfileKey, isCurrent: () => {
+        assertLeaderEpoch("connect-recovery");
+        return true;
+      }, recordEvent: deps.recordEvent,
+    });
+  }
   const legacyLeaderRecord =
     deps.topicTargetStore.getByProfileKey(leaderProfileKey);
   let capacityUnavailable = false;
@@ -836,6 +846,7 @@ export async function ensureTelegramLeaderThreadBinding(
         legacyLeaderRecord?.instanceId,
         {
           sessionId: deps.sessionId,
+          provisionProfileKey: leaderProfileKey,
           onCapacityUnavailable() {
             capacityUnavailable = true;
           },

package/node_modules/@llblab/pi-telegram/lib/threads.ts

@@ -783,6 +783,7 @@ export interface TelegramTopicTargetStore {
   ) => { slot?: string; threadName?: string } | undefined;
   listReservations: () => TelegramThreadReservation[];
   listPendingProvisions: () => TelegramThreadPendingProvision[];
+  resetPendingProvisionForConnect: (expected: TelegramThreadPendingProvision, isCurrent: () => boolean) => Promise<boolean>;
   listPendingCleanups: () => TelegramThreadCleanupIntent[];
   listSyncObservations: () => TelegramTopicSyncObservation[];
   reserveThread: (reservation: TelegramThreadReservation) => void;
@@ -902,6 +903,7 @@ export interface TelegramTopicTargetStore {
     options?: {
       existingBindingOnly?: boolean;
       sessionId?: string;
+      provisionProfileKey?: string;
       onCapacityUnavailable?: () => void;
     },
   ) => TelegramWorkspaceBindingIdentity | undefined;
@@ -4168,6 +4170,7 @@ export function createTelegramTopicTargetStore(
         }
     ),
     isCurrentPublication?: () => boolean,
+    resetProvisions?: readonly TelegramThreadPendingProvision[],
   ): Promise<boolean> => {
     const submittedPath = getPath(),
       submittedProfile = activeProfile();
@@ -4367,6 +4370,13 @@ export function createTelegramTopicTargetStore(
                   !!expectedRestore,
               ),
         );
+        if (resetProvisions) {
+          const recoveries = readProvisionRecoveries(path, true);
+          if (mutationRevision !== persistedRevision || resetProvisions.some(expected =>
+            expected.target || Object.hasOwn(recoveries, expected.id) ||
+            !isDeepStrictEqual(disk.pendingProvisions?.find(value => value.id === expected.id), expected)))
+            throw new Error("Telegram connection recovery provisioning evidence changed.");
+        }
         if (!isDeepStrictEqual(disk.workspaceRestore, expectedRestore))
           throw new Error(
             "Workspace Restore evidence changed before publication.",
@@ -4429,7 +4439,7 @@ export function createTelegramTopicTargetStore(
             }
           : {}),
         reservations: reservations.map((reservation) => ({ ...reservation })),
-        pendingProvisions: pendingProvisions.map((provision) => ({
+        pendingProvisions: pendingProvisions.filter(provision => !resetProvisions?.some(expected => expected.id === provision.id)).map((provision) => ({
           ...provision,
           ...(provision.target ? { target: { ...provision.target } } : {}),
         })),
@@ -4636,6 +4646,7 @@ export function createTelegramTopicTargetStore(
         loadedProfile = submittedProfile;
         loaded = true;
         observedWorkspaceSemantic = getTelegramStateSemanticSnapshot(wire);
+        if (resetProvisions) { pendingProvisions = file.pendingProvisions; mutationRevision += 1; }
         if (transition) {
           records = new Map(
             file.threads.map((record) => {
@@ -4808,6 +4819,10 @@ export function createTelegramTopicTargetStore(
       if (isCurrentPublication?.() === false) return false;
       loadedPath = path;
       loaded = true;
+      if (resetProvisions) {
+        if (mutationRevision !== persistedRevision) return false;
+        pendingProvisions = file.pendingProvisions;
+      }
       if (mutationRevision === persistedRevision) dirty = false;
       return true;
     });
@@ -6814,6 +6829,11 @@ export function createTelegramTopicTargetStore(
       current.status = "ambiguous";
       return true;
     },
+    resetPendingProvisionForConnect(expected, isCurrent) {
+      // Stage no in-memory deletion: refusal or a stale publication must keep its protective hold.
+      if (expected.target || !isCurrent()) return Promise.resolve(false);
+      return persistSnapshot(undefined, isCurrent, [structuredClone(expected)]);
+    },
     removePendingProvision(id) {
       const before = pendingProvisions.length;
       pendingProvisions = pendingProvisions.filter(
@@ -7608,8 +7628,14 @@ export function createTelegramTopicTargetStore(
         ) {
           return undefined;
         }
-        const retainedTarget = binding?.target ?? legacyRecord?.target;
-        const retainedSlot = binding?.slot ?? legacyRecord?.slot;
+        const ownedProvisions = pendingProvisions.filter(value =>
+          value.workspaceBindingKey === identity.bindingKey &&
+          (value.instanceId === instanceId || value.instanceId === effectivePreviousInstanceId ||
+            (options?.provisionProfileKey !== undefined && value.profileKey === options.provisionProfileKey)));
+        if (ownedProvisions.length > 1) return undefined;
+        const ownProvision = ownedProvisions[0];
+        const retainedTarget = ownProvision?.target ?? binding?.target ?? legacyRecord?.target;
+        const retainedSlot = ownProvision?.slot ?? binding?.slot ?? legacyRecord?.slot;
         const otherBindings = Array.from(workspaceBindings.values())
           .filter(
             (other) => other.bindingKey !== identity.bindingKey && other.slot,
@@ -7641,7 +7667,7 @@ export function createTelegramTopicTargetStore(
             )
             .map((reservation) => reservation.slot),
           ...pendingProvisions
-            .filter((provision) =>
+            .filter((provision) => provision !== ownProvision &&
               isPendingProvisionLiveOrTargeted(provision, nowMs),
             )
             .map((provision) => provision.slot),
@@ -9661,6 +9687,32 @@ export function createTelegramTopicTargetRenamer(
   };
 }
 
+/** Caller holds profile Workspace admission; only an explicit connect grants a fresh creation attempt. */
+export async function resetTelegramConnectionProvisioning(input: {
+  store: TelegramTopicTargetStore;
+  owner: TelegramThreadPendingProvision["owner"];
+  instanceId: string;
+  profileKey: string;
+  isCurrent: () => boolean;
+  recordEvent: (category: string, message: unknown, details?: Record<string, unknown>) => void;
+}): Promise<void> {
+  if (!input.isCurrent()) throw new Error("Telegram connection recovery authority changed.");
+  const removed: TelegramThreadPendingProvision[] = [];
+  for (const pending of input.store.listPendingProvisions()) {
+    if (pending.owner !== input.owner || pending.target ||
+        (pending.profileKey !== input.profileKey && pending.instanceId !== input.instanceId)) continue;
+    if (!input.isCurrent()) throw new Error("Telegram connection recovery authority changed.");
+    if (!await input.store.resetPendingProvisionForConnect(pending, input.isCurrent))
+      throw new Error("Telegram connection recovery lost publication authority.");
+    if (!input.isCurrent()) throw new Error("Telegram connection recovery authority changed.");
+    removed.push(pending);
+  }
+  if (removed.length === 0) return;
+  input.recordEvent("connection", "Explicit connect reset unfinished Thread creation; an unconfirmed Telegram Thread may remain.", {
+    phase: "connect-provision-reset", count: removed.length, owner: input.owner,
+  });
+}
+
 export function createTelegramTopicTargetProvisioner(
   deps: TelegramTopicTargetProvisionerDeps,
 ): (
@@ -9923,7 +9975,7 @@ export function createTelegramTopicTargetProvisioner(
         slot,
       );
     }
-    const pendingId = `provision:${request.instanceId}:${slot}:${nowMs}`;
+    const pendingId = `provision:${request.instanceId}:${slot}:${nowMs}:${randomUUID()}`;
     const pendingOwner =
       request.owner?.kind === "leader" ? "leader" : "manual-follower";
     assertLeaderEpoch("before-pending-intent");

package/node_modules/@llblab/pi-telegram/lib/updates.ts

@@ -108,17 +108,10 @@ export type TelegramReactionType =
 
 export const TELEGRAM_PRIORITY_REACTIONS = [
   { id: 10, name: "like", emoji: "👍" },
-  { id: 11, name: "lightning", emoji: "⚡" },
-  { id: 12, name: "heart", emoji: "❤" },
-  { id: 13, name: "dove", emoji: "🕊" },
-  { id: 14, name: "fire", emoji: "🔥" },
 ] as const;
+export const TELEGRAM_STEER_REACTIONS = [{ id: 14, name: "fire", emoji: "🔥" }] as const;
 export const TELEGRAM_REMOVAL_REACTIONS = [
   { id: 20, name: "dislike", emoji: "👎" },
-  { id: 21, name: "ghost", emoji: "👻" },
-  { id: 22, name: "broken-heart", emoji: "💔" },
-  { id: 23, name: "poop", emoji: "💩" },
-  { id: 24, name: "wastebasket", emoji: "🗑" },
 ] as const;
 export const TELEGRAM_PRIORITY_REACTION_EMOJIS =
   TELEGRAM_PRIORITY_REACTIONS.map((reaction) => reaction.emoji);
@@ -160,14 +153,10 @@ function getTelegramQueueReactionTransition(
 ): TelegramQueueReactionDisposition | undefined {
   const oldEmojis = collectTelegramReactionEmojis(oldReactions);
   const newEmojis = collectTelegramReactionEmojis(newReactions);
-  const oldPriorityEmoji = getTelegramReactionEmoji(
-    oldEmojis,
-    TELEGRAM_PRIORITY_REACTION_EMOJIS,
-  );
-  const newPriorityEmoji = getTelegramReactionEmoji(
-    newEmojis,
-    TELEGRAM_PRIORITY_REACTION_EMOJIS,
-  );
+  // Fire selects Steer; thumbs-up beneath it does not reorder the lane. Other emoji carry no queue intent.
+  const steerEmoji = TELEGRAM_STEER_REACTIONS[0].emoji;
+  const oldPriorityEmoji = oldEmojis.has(steerEmoji) ? steerEmoji : getTelegramReactionEmoji(oldEmojis, TELEGRAM_PRIORITY_REACTION_EMOJIS);
+  const newPriorityEmoji = newEmojis.has(steerEmoji) ? steerEmoji : getTelegramReactionEmoji(newEmojis, TELEGRAM_PRIORITY_REACTION_EMOJIS);
   const oldSuppressionEmoji = getTelegramReactionEmoji(
     oldEmojis,
     TELEGRAM_REMOVAL_REACTION_EMOJIS,
@@ -188,6 +177,7 @@ function getTelegramQueueReactionTransition(
   > = { kind: "reaction-transition" };
   if (oldPriorityEmoji !== newPriorityEmoji) {
     transition.priorityEmoji = newPriorityEmoji ?? null;
+    if (newPriorityEmoji === steerEmoji) transition.promptLane = "steer";
   }
   if (oldSuppressionEmoji !== newSuppressionEmoji) {
     transition.suppressionEmoji = newSuppressionEmoji ?? null;
@@ -551,6 +541,7 @@ interface TelegramUpdateAdmissionBinding {
   inspectSource?: () => TelegramDeferredSourceEvidence | undefined;
   inspectSourceSnapshot?: () => TelegramDeferredSourceSnapshot | undefined;
   inspectCompletion?: () => TelegramDeferredSourceEvidence | undefined;
+  subscribeCompletion?: (notify: () => void) => () => void;
   isSourceUnsettled?: () => boolean;
   prepareLiveInput?: (
     sourceUpdateIds: readonly number[],
@@ -619,6 +610,7 @@ export function bindTelegramUpdateAdmissionSource<
     | "inspectSource"
     | "inspectSourceSnapshot"
     | "inspectCompletion"
+    | "subscribeCompletion"
     | "isSourceUnsettled"
     | "acknowledgeTransferred"
     | "prepareLiveInput"
@@ -747,6 +739,15 @@ export function inspectTelegramDeferredSourceCompletion(
   return execution.isCurrent() && source ? { ...source } : undefined;
 }
 
+/** Warm ACK notification only; subscribers must independently recheck exact completion and recipient authority. */
+export function subscribeTelegramDeferredSourceCompletion(value: unknown, notify: () => void): (() => void) | undefined {
+  const execution = getTelegramUpdateExecutionFence(value);
+  if (execution?.isCurrent() !== true) return undefined;
+  return getTelegramUpdateAdmissionBinding(value)?.subscribeCompletion?.(() => {
+    if (execution.isCurrent()) notify();
+  });
+}
+
 /** Reuse only live bound deferred originals; raw IDs or cold/adopted input cannot mint this carrier. */
 export function prepareTelegramLiveDeferredInput(
   values: readonly unknown[],
@@ -8725,6 +8726,7 @@ function createTelegramUpdateSourceAdmissionHandle<
     let outcome: TelegramUpdateAdmissionOutcome | undefined;
     let completionAttempted = false;
     let completedSource: TelegramDeferredSourceCompletion | undefined;
+    const completionObservers = new Set<() => void>();
     const boundUpdate = bindTelegramUpdateExecutionFence(
       bindTelegramUpdateAdmissionSource(
         update,
@@ -8781,11 +8783,12 @@ function createTelegramUpdateSourceAdmissionHandle<
                 execution.isCurrent() &&
                 completion.isCurrent() &&
                 isDeepStrictEqual(completion.source, expectedSource)
-              )
-                completedSource = {
-                  ...completion,
-                  source: { ...expectedSource },
-                };
+              ) {
+                completedSource = { ...completion, source: { ...expectedSource } };
+                for (const notify of completionObservers) {
+                  try { notify(); } catch { /* Observation cannot invalidate an exact removal ACK. */ }
+                }
+              }
             })
             .catch((error) => {
               try {
@@ -8846,6 +8849,10 @@ function createTelegramUpdateSourceAdmissionHandle<
                   signal,
                 })
               : undefined,
+          subscribeCompletion: (notify) => {
+            completionObservers.add(notify);
+            return () => { completionObservers.delete(notify); };
+          },
           inspectCompletion: () =>
             execution.isCurrent() && completedSource?.isCurrent()
               ? { ...completedSource.source }
@@ -9322,6 +9329,7 @@ export function createTelegramQueueHandoffControlExecutionFactory<TContext>(
 
 export interface TelegramQueueHandoffCoordinatorInput<TContext> {
   item: TelegramQueueItem<TContext>;
+  steerSupported?: boolean;
   expectedOwner: TelegramUpdateJournalQueueOwner;
   recipientOwner: TelegramUpdateJournalQueueOwnerIdentity;
   handoffToken: string;
@@ -9377,6 +9385,7 @@ export async function coordinateTelegramQueueHandoff<TContext>(
   const handoff = createTelegramQueueHandoff({
     handoffToken: input.handoffToken,
     item: input.item,
+    steerSupported: input.steerSupported,
   });
   const receipt = handoff.payload.admissionReceipts[0];
   if (!receipt || handoff.payload.admissionReceipts.length !== 1) {
@@ -9553,6 +9562,8 @@ export function createTelegramQueueHandoffRecipientRuntime<TContext>(
 }
 
 export interface TelegramQueueHandoffReconcilerDeps<TContext> {
+  canHandoffSteerWithRecipient?: (recipient: TelegramBusFollowerView) => boolean;
+  hasPendingDispatch?: () => boolean;
   ownsDirect: () => boolean;
   isFollowerRegistered: () => boolean;
   isBusEnabled: () => boolean;
@@ -9591,6 +9602,8 @@ export interface TelegramQueueHandoffReconcilerDeps<TContext> {
 export interface TelegramQueueHandoffReconciliationRuntimeAssemblyDeps<
   TContext,
 > {
+  canHandoffSteerWithRecipient?: (recipient: TelegramBusFollowerView) => boolean;
+  hasPendingDispatch?: () => boolean;
   ownsDirect: () => boolean;
   isFollowerRegistered: () => boolean;
   isBusEnabled: () => boolean;
@@ -9630,6 +9643,8 @@ export function createTelegramQueueHandoffReconciliationRuntimeAssembly<
   deps: TelegramQueueHandoffReconciliationRuntimeAssemblyDeps<TContext>,
 ): (ctx: TContext) => Promise<void> {
   return createTelegramQueueHandoffReconciler({
+    canHandoffSteerWithRecipient: deps.canHandoffSteerWithRecipient,
+    hasPendingDispatch: deps.hasPendingDispatch,
     ownsDirect: deps.ownsDirect,
     isFollowerRegistered: deps.isFollowerRegistered,
     isBusEnabled: deps.isBusEnabled,
@@ -9706,6 +9721,8 @@ export function createTelegramQueueHandoffReconciler<TContext>(
       .filter((follower) => follower.instanceId !== deps.donorInstanceId);
     if (followers.length === 0) return;
     for (const item of [...deps.getQueuedItems()]) {
+      if ((deps.hasPendingDispatch?.() && deps.getQueuedItems()[0] === item) ||
+          (item.kind === "prompt" && (item.steerAttempted || item.steerPacketTail !== undefined || item.steerPacketSourceOrders !== undefined))) continue;
       const target = item.target;
       const recipient = target
         ? followers.find(
@@ -9715,6 +9732,8 @@ export function createTelegramQueueHandoffReconciler<TContext>(
           )
         : undefined;
       if (!recipient) continue;
+      const steerSupported = item.queueLane === "steer" && deps.canHandoffSteerWithRecipient?.(recipient) === true;
+      if (item.queueLane === "steer" && !steerSupported) continue;
       const receipt = item.admissionReceipts?.[0];
       if (!receipt || item.admissionReceipts?.length !== 1) continue;
       if (
@@ -9741,6 +9760,7 @@ export function createTelegramQueueHandoffReconciler<TContext>(
       const handoffToken = deps.createHandoffToken();
       const result = await coordinateTelegramQueueHandoff({
         item,
+        steerSupported,
         expectedOwner,
         recipientOwner: {
           instanceId: recipient.instanceId,
@@ -9751,6 +9771,9 @@ export function createTelegramQueueHandoffReconciler<TContext>(
         handoffToken,
         lifecycle,
         stageRemote: async ({ payload: sourcePayload }) => {
+          if (sourcePayload.queueLane === "steer" && deps.canHandoffSteerWithRecipient?.(recipient) !== true) {
+            throw new Error("Steer queue handoff capability changed before staging.");
+          }
           const payload = {
             ...sourcePayload,
             admissionReceipts: [

package/node_modules/@llblab/pi-telegram/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-kit",
-  "version": "0.33.1",
+  "version": "0.34.1",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -47,7 +47,7 @@
     "@llblab/pi-codex-usage": "0.13.0",
     "@llblab/pi-grow-loop": "0.9.0",
     "@llblab/pi-state-flow": "0.26.4",
-    "@llblab/pi-telegram": "0.55.1",
+    "@llblab/pi-telegram": "0.56.2",
     "@llblab/skills": "1.15.0"
   },
   "bundledDependencies": [