@llblab/pi-telegram 0.55.1 → 0.56.1

package/dist/lib/status.js

@@ -605,9 +605,7 @@ function getTelegramStatusBarLabel(state) {
 }
 export function buildTelegramStatusBarText(theme, state) {
     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 (state.pollingStopReason === "persistent-conflict" &&
@@ -949,6 +947,7 @@ function buildTelegramInboundWorkerDiagnosticLines(worker) {
 function countTelegramQueueLanes(items) {
     const counts = {
         control: 0,
+        steer: 0,
         priority: 0,
         default: 0,
     };
@@ -957,9 +956,9 @@ function countTelegramQueueLanes(items) {
     return counts;
 }
 function buildTelegramBridgeCompactStatusLines(state) {
-    const { control: controlQueueCount, priority: priorityQueueCount, default: defaultQueueCount, } = countTelegramQueueLanes(state.queuedItems);
+    const { 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
         ? "pending dispatch"
@@ -1017,7 +1016,7 @@ export function buildTelegramBridgeStatusLines(state, options = {}) {
     return buildTelegramBridgeCompactStatusLines(state);
 }
 function buildTelegramBridgeDiagnosticStatusLines(state) {
-    const { control: controlQueueCount, priority: priorityQueueCount, default: defaultQueueCount, } = countTelegramQueueLanes(state.queuedItems);
+    const { control: controlQueueCount, priority: priorityQueueCount, default: defaultQueueCount, steer: steerQueueCount, } = countTelegramQueueLanes(state.queuedItems);
     return [
         "connection:",
         `- bot: ${formatTelegramBridgeBotStatus(state)}`,
@@ -1063,7 +1062,7 @@ function buildTelegramBridgeDiagnosticStatusLines(state) {
         "",
         "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/dist/lib/sync.js

@@ -6,7 +6,7 @@
 import { getTelegramTargetKey } from "./target.js";
 import { getTelegramApiErrorRequestTarget, isTelegramStaleTargetHttpError, } from "./telegram-api.js";
 import * as ThreadReconciler from "./thread-reconciler.js";
-import { commitTelegramWorkspaceProvisionBinding, createTelegramCleanupTargetProtection, getTelegramTargetFromApiBody, getTelegramThreadOwnerKey, isSameTelegramProcessInstance, isTelegramTopicTargetStaleError, provisionOwnBusTopic, } from "./threads.js";
+import { commitTelegramWorkspaceProvisionBinding, createTelegramCleanupTargetProtection, getTelegramTargetFromApiBody, getTelegramThreadOwnerKey, isSameTelegramProcessInstance, isTelegramTopicTargetStaleError, provisionOwnBusTopic, resetTelegramConnectionProvisioning, } from "./threads.js";
 import { createTelegramWorkspaceAdmissionOperationId, runWithTelegramWorkspaceAdmissionsAsync, } from "./workspace-admission.js";
 import { normalizeTelegramWorkspacePath } from "./workspace-identity.js";
 import { TelegramWorkspaceSlotUnavailableError } from "./workspace-slots.js";
@@ -463,11 +463,21 @@ export async function ensureTelegramLeaderThreadBinding(deps) {
         ...(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;
     const workspaceIdentity = normalizedLeaderCwd
         ? deps.topicTargetStore.claimWorkspaceIdentity(normalizedLeaderCwd, deps.instanceId, legacyLeaderRecord?.instanceId, {
             sessionId: deps.sessionId,
+            provisionProfileKey: leaderProfileKey,
             onCapacityUnavailable() {
                 capacityUnavailable = true;
             },

package/dist/lib/threads.d.ts

@@ -495,6 +495,7 @@ export interface TelegramTopicTargetStore {
     } | undefined;
     listReservations: () => TelegramThreadReservation[];
     listPendingProvisions: () => TelegramThreadPendingProvision[];
+    resetPendingProvisionForConnect: (expected: TelegramThreadPendingProvision, isCurrent: () => boolean) => Promise<boolean>;
     listPendingCleanups: () => TelegramThreadCleanupIntent[];
     listSyncObservations: () => TelegramTopicSyncObservation[];
     reserveThread: (reservation: TelegramThreadReservation) => void;
@@ -559,6 +560,7 @@ export interface TelegramTopicTargetStore {
     claimWorkspaceIdentity: (cwd: string, instanceId: string, previousInstanceId?: string, options?: {
         existingBindingOnly?: boolean;
         sessionId?: string;
+        provisionProfileKey?: string;
         onCapacityUnavailable?: () => void;
     }) => TelegramWorkspaceBindingIdentity | undefined;
     releaseWorkspaceClaim: (instanceId: string) => boolean;
@@ -957,4 +959,13 @@ export declare function getTelegramTargetFromApiBody(body: unknown): (TelegramTa
 export declare function isTelegramTopicTargetStaleError(error: unknown): boolean;
 export declare function isTelegramTopicModeUnavailableError(error: unknown): boolean;
 export declare function createTelegramTopicTargetRenamer(deps: TelegramTopicTargetRenamerDeps): (request: TelegramTopicTargetRenameRequest) => Promise<TelegramTopicTargetRecord | undefined>;
+/** Caller holds profile Workspace admission; only an explicit connect grants a fresh creation attempt. */
+export declare 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>;
 export declare function createTelegramTopicTargetProvisioner(deps: TelegramTopicTargetProvisionerDeps): (request: TelegramTopicTargetProvisionRequest) => Promise<TelegramTopicTargetProvisionResult>;

package/dist/lib/threads.js

@@ -2304,7 +2304,7 @@ export function createTelegramTopicTargetStore(options) {
         }
         return false;
     };
-    const persistSnapshot = (transition, isCurrentPublication) => {
+    const persistSnapshot = (transition, isCurrentPublication, resetProvisions) => {
         const submittedPath = getPath(), submittedProfile = activeProfile();
         const publishWorkspace = workspaceIO?.capturePublication();
         const persist = persistQueue.then(async () => {
@@ -2437,6 +2437,12 @@ export function createTelegramTopicTargetStore(options) {
                     : readStoreSnapshot(path, transition?.kind === "relocate" ||
                         transition?.kind === "live-rebind" ||
                         !!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.");
                 if (!manualNameMatches(disk) ||
@@ -2471,7 +2477,7 @@ export function createTelegramTopicTargetStore(options) {
                     }
                     : {}),
                 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 } } : {}),
                 })),
@@ -2626,6 +2632,10 @@ export function createTelegramTopicTargetStore(options) {
                 loadedProfile = submittedProfile;
                 loaded = true;
                 observedWorkspaceSemantic = getTelegramStateSemanticSnapshot(wire);
+                if (resetProvisions) {
+                    pendingProvisions = file.pendingProvisions;
+                    mutationRevision += 1;
+                }
                 if (transition) {
                     records = new Map(file.threads.map((record) => {
                         const normalized = normalizeRecord(record);
@@ -2765,6 +2775,11 @@ export function createTelegramTopicTargetStore(options) {
                 return false;
             loadedPath = path;
             loaded = true;
+            if (resetProvisions) {
+                if (mutationRevision !== persistedRevision)
+                    return false;
+                pendingProvisions = file.pendingProvisions;
+            }
             if (mutationRevision === persistedRevision)
                 dirty = false;
             return true;
@@ -4209,6 +4224,12 @@ export function createTelegramTopicTargetStore(options) {
             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((provision) => provision.id !== id);
@@ -4865,8 +4886,14 @@ export function createTelegramTopicTargetStore(options) {
                     liveRecord.instanceId !== effectivePreviousInstanceId) {
                     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)
                     .map((other) => ({
@@ -4886,7 +4913,8 @@ export function createTelegramTopicTargetStore(options) {
                         reservation.expiresAtMs > nowMs)
                         .map((reservation) => reservation.slot),
                     ...pendingProvisions
-                        .filter((provision) => isPendingProvisionLiveOrTargeted(provision, nowMs))
+                        .filter((provision) => provision !== ownProvision &&
+                        isPendingProvisionLiveOrTargeted(provision, nowMs))
                         .map((provision) => provision.slot),
                     ...externalReservedSlots,
                 ]
@@ -6349,6 +6377,29 @@ export function createTelegramTopicTargetRenamer(deps) {
         return renamed;
     };
 }
+/** Caller holds profile Workspace admission; only an explicit connect grants a fresh creation attempt. */
+export async function resetTelegramConnectionProvisioning(input) {
+    if (!input.isCurrent())
+        throw new Error("Telegram connection recovery authority changed.");
+    const removed = [];
+    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) {
     const getNowMs = deps.getNowMs ?? (() => 0);
     const getRandom = deps.getRandom;
@@ -6554,7 +6605,7 @@ export function createTelegramTopicTargetProvisioner(deps) {
             }
             displayTitle = buildTelegramTopicName({ ...request, threadName: projectedTitle }, "{threadName}", 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");
         const pendingBase = {

package/dist/lib/updates.d.ts

@@ -22,10 +22,6 @@ export declare const TELEGRAM_PRIORITY_REACTIONS: readonly [{
     readonly id: 10;
     readonly name: "like";
     readonly emoji: "👍";
-}, {
-    readonly id: 11;
-    readonly name: "lightning";
-    readonly emoji: "⚡";
 }, {
     readonly id: 12;
     readonly name: "heart";
@@ -34,7 +30,8 @@ export declare const TELEGRAM_PRIORITY_REACTIONS: readonly [{
     readonly id: 13;
     readonly name: "dove";
     readonly emoji: "🕊";
-}, {
+}];
+export declare const TELEGRAM_STEER_REACTIONS: readonly [{
     readonly id: 14;
     readonly name: "fire";
     readonly emoji: "🔥";
@@ -60,7 +57,7 @@ export declare const TELEGRAM_REMOVAL_REACTIONS: readonly [{
     readonly name: "wastebasket";
     readonly emoji: "🗑";
 }];
-export declare const TELEGRAM_PRIORITY_REACTION_EMOJIS: ("👍" | "⚡" | "❤" | "🕊" | "🔥")[];
+export declare const TELEGRAM_PRIORITY_REACTION_EMOJIS: ("👍" | "❤" | "🕊")[];
 export declare const TELEGRAM_REMOVAL_REACTION_EMOJIS: ("👎" | "👻" | "💔" | "💩" | "🗑")[];
 export interface TelegramUpdateDeletion {
     deleted_business_messages?: {
@@ -230,6 +227,7 @@ interface TelegramUpdateAdmissionBinding {
     inspectSource?: () => TelegramDeferredSourceEvidence | undefined;
     inspectSourceSnapshot?: () => TelegramDeferredSourceSnapshot | undefined;
     inspectCompletion?: () => TelegramDeferredSourceEvidence | undefined;
+    subscribeCompletion?: (notify: () => void) => () => void;
     isSourceUnsettled?: () => boolean;
     prepareLiveInput?: (sourceUpdateIds: readonly number[], isCurrent: () => boolean, onTransferred?: () => void) => TelegramLiveDeferredInputPreparation | undefined;
     /** Internal notification after the worker's exact donor-removal ACK; never issues completion itself. */
@@ -245,7 +243,7 @@ interface TelegramUpdateAdmissionBinding {
 export type TelegramQueueAdmissionReceiptLike = TelegramQueueAdmissionReceipt;
 export declare function bindTelegramUpdateAdmissionSource<TUpdate extends TelegramUpdateFlow & {
     update_id: number;
-}>(update: TUpdate, report: TelegramUpdateAdmissionBinding["report"], controls?: Pick<TelegramUpdateAdmissionBinding, "abandon" | "armRoutingInput" | "getRoutingInput" | "acquireRouting" | "inspectSource" | "inspectSourceSnapshot" | "inspectCompletion" | "isSourceUnsettled" | "acknowledgeTransferred" | "prepareLiveInput" | "prepareQueueAdmission" | "prepareSourceCompletion" | "supportsAbandonment" | "inspectAbandoning" | "inspectHistorical" | "isHistorical" | "isHistoricalReviewHeld">): TUpdate;
+}>(update: TUpdate, report: TelegramUpdateAdmissionBinding["report"], controls?: Pick<TelegramUpdateAdmissionBinding, "abandon" | "armRoutingInput" | "getRoutingInput" | "acquireRouting" | "inspectSource" | "inspectSourceSnapshot" | "inspectCompletion" | "subscribeCompletion" | "isSourceUnsettled" | "acknowledgeTransferred" | "prepareLiveInput" | "prepareQueueAdmission" | "prepareSourceCompletion" | "supportsAbandonment" | "inspectAbandoning" | "inspectHistorical" | "isHistorical" | "isHistoricalReviewHeld">): TUpdate;
 /**
  * Conservative read-only census: any retained entry naming this Thread, in any nested Telegram object or state,
  * is unresolved custody, except a lone button tap, which carries no input (the in-flight Cancel itself).
@@ -265,6 +263,8 @@ export declare function inspectTelegramDeferredSource(value: unknown): TelegramD
 export declare function inspectTelegramDeferredSourceSnapshot(value: unknown): TelegramDeferredSourceSnapshot | undefined;
 /** Exact warm removal ACK only; reporting, source absence and a replaced worker cannot supply it. */
 export declare function inspectTelegramDeferredSourceCompletion(value: unknown): TelegramDeferredSourceEvidence | undefined;
+/** Warm ACK notification only; subscribers must independently recheck exact completion and recipient authority. */
+export declare function subscribeTelegramDeferredSourceCompletion(value: unknown, notify: () => void): (() => void) | undefined;
 /** Reuse only live bound deferred originals; raw IDs or cold/adopted input cannot mint this carrier. */
 export declare function prepareTelegramLiveDeferredInput(values: readonly unknown[], isCurrent: () => boolean): TelegramLiveDeferredInputPreparation | undefined;
 /** A route-owned pre-disposition acceptance publisher; wraps only this carrier, never the shared worker binding. */
@@ -1319,6 +1319,7 @@ export interface TelegramQueueHandoffControlExecutionDeps<TContext> {
 export declare function createTelegramQueueHandoffControlExecutionFactory<TContext>(deps: TelegramQueueHandoffControlExecutionDeps<TContext>): (payload: TelegramControlQueueHandoffPayload) => PendingTelegramControlItem<TContext>["execute"];
 export interface TelegramQueueHandoffCoordinatorInput<TContext> {
     item: TelegramQueueItem<TContext>;
+    steerSupported?: boolean;
     expectedOwner: TelegramUpdateJournalQueueOwner;
     recipientOwner: TelegramUpdateJournalQueueOwnerIdentity;
     handoffToken: string;
@@ -1358,6 +1359,8 @@ export declare function createTelegramQueueHandoffRecipientRuntime<TContext>(dep
     kind: "leader.offerQueueHandoff";
 }>, ctx: TContext) => Promise<TelegramQueueHandoffStageResult>;
 export interface TelegramQueueHandoffReconcilerDeps<TContext> {
+    canHandoffSteerWithRecipient?: (recipient: TelegramBusFollowerView) => boolean;
+    hasPendingDispatch?: () => boolean;
     ownsDirect: () => boolean;
     isFollowerRegistered: () => boolean;
     isBusEnabled: () => boolean;
@@ -1382,6 +1385,8 @@ export interface TelegramQueueHandoffReconcilerDeps<TContext> {
     recordFailure?: (error: unknown, details: Record<string, unknown>) => void;
 }
 export interface TelegramQueueHandoffReconciliationRuntimeAssemblyDeps<TContext> {
+    canHandoffSteerWithRecipient?: (recipient: TelegramBusFollowerView) => boolean;
+    hasPendingDispatch?: () => boolean;
     ownsDirect: () => boolean;
     isFollowerRegistered: () => boolean;
     isBusEnabled: () => boolean;

package/dist/lib/updates.js

@@ -14,11 +14,10 @@ import { createTelegramPrivateTarget, createTelegramThreadTarget, } from "./targ
 import { isWireRecord as isTelegramUpdateAdmissionRecord, isNonEmptyWireString as isTelegramUpdateAdmissionString, } from "./wire.js";
 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: "🔥" },
 ];
+export const TELEGRAM_STEER_REACTIONS = [{ id: 14, name: "fire", emoji: "🔥" }];
 export const TELEGRAM_REMOVAL_REACTIONS = [
     { id: 20, name: "dislike", emoji: "👎" },
     { id: 21, name: "ghost", emoji: "👻" },
@@ -47,8 +46,10 @@ function getTelegramReactionEmoji(emojis, candidates) {
 function getTelegramQueueReactionTransition(oldReactions, newReactions) {
     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 is effective Steer intent; weaker positive aliases under it do not reorder the lane.
+    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);
     const newSuppressionEmoji = getTelegramReactionEmoji(newEmojis, TELEGRAM_REMOVAL_REACTION_EMOJIS);
     if (oldPriorityEmoji === newPriorityEmoji &&
@@ -58,6 +59,8 @@ function getTelegramQueueReactionTransition(oldReactions, newReactions) {
     const transition = { kind: "reaction-transition" };
     if (oldPriorityEmoji !== newPriorityEmoji) {
         transition.priorityEmoji = newPriorityEmoji ?? null;
+        if (newPriorityEmoji === steerEmoji)
+            transition.promptLane = "steer";
     }
     if (oldSuppressionEmoji !== newSuppressionEmoji) {
         transition.suppressionEmoji = newSuppressionEmoji ?? null;
@@ -252,6 +255,16 @@ export function inspectTelegramDeferredSourceCompletion(value) {
     const source = getTelegramUpdateAdmissionBinding(value)?.inspectCompletion?.();
     return execution.isCurrent() && source ? { ...source } : undefined;
 }
+/** Warm ACK notification only; subscribers must independently recheck exact completion and recipient authority. */
+export function subscribeTelegramDeferredSourceCompletion(value, notify) {
+    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, isCurrent) {
     const carriers = [...values], first = carriers[0], execution = getTelegramUpdateExecutionFence(first);
@@ -5152,6 +5165,7 @@ function createTelegramUpdateSourceAdmissionHandle(deps, capture) {
         let outcome;
         let completionAttempted = false;
         let completedSource;
+        const completionObservers = new Set();
         const boundUpdate = bindTelegramUpdateExecutionFence(bindTelegramUpdateAdmissionSource(update, (next) => {
             if (!execution.isCurrent())
                 return;
@@ -5196,11 +5210,15 @@ function createTelegramUpdateSourceAdmissionHandle(deps, capture) {
                     completion &&
                     execution.isCurrent() &&
                     completion.isCurrent() &&
-                    isDeepStrictEqual(completion.source, expectedSource))
-                    completedSource = {
-                        ...completion,
-                        source: { ...expectedSource },
-                    };
+                    isDeepStrictEqual(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 {
@@ -5257,6 +5275,10 @@ function createTelegramUpdateSourceAdmissionHandle(deps, capture) {
                     signal,
                 })
                 : undefined,
+            subscribeCompletion: (notify) => {
+                completionObservers.add(notify);
+                return () => { completionObservers.delete(notify); };
+            },
             inspectCompletion: () => execution.isCurrent() && completedSource?.isCurrent()
                 ? { ...completedSource.source }
                 : undefined,
@@ -5533,6 +5555,7 @@ export async function coordinateTelegramQueueHandoff(input) {
     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) {
@@ -5670,6 +5693,8 @@ export function createTelegramQueueHandoffRecipientRuntime(deps) {
 /** Own queue-handoff projections over journals, admission, IPC, and live queue state. */
 export function createTelegramQueueHandoffReconciliationRuntimeAssembly(deps) {
     return createTelegramQueueHandoffReconciler({
+        canHandoffSteerWithRecipient: deps.canHandoffSteerWithRecipient,
+        hasPendingDispatch: deps.hasPendingDispatch,
         ownsDirect: deps.ownsDirect,
         isFollowerRegistered: deps.isFollowerRegistered,
         isBusEnabled: deps.isBusEnabled,
@@ -5738,6 +5763,9 @@ export function createTelegramQueueHandoffReconciler(deps) {
         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((candidate) => candidate.target?.chatId === target.chatId &&
@@ -5745,6 +5773,9 @@ export function createTelegramQueueHandoffReconciler(deps) {
                 : 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;
@@ -5768,6 +5799,7 @@ export function createTelegramQueueHandoffReconciler(deps) {
             const handoffToken = deps.createHandoffToken();
             const result = await coordinateTelegramQueueHandoff({
                 item,
+                steerSupported,
                 expectedOwner,
                 recipientOwner: {
                     instanceId: recipient.instanceId,
@@ -5778,6 +5810,9 @@ export function createTelegramQueueHandoffReconciler(deps) {
                 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/dist/package.json

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

package/docs/README.md

@@ -8,7 +8,7 @@ Living index of project documentation in `/docs`.
 
 ## Documents
 
-- [architecture.md](./architecture.md) — Overview of the Telegram bridge runtime, optional profile isolation, queueing model and Priority/Normal plus Keep/Skip reaction policy, native Rich Markdown delivery, UI/compat rendering, and interactive controls
+- [architecture.md](./architecture.md) — Overview of the Telegram bridge runtime, optional profile isolation, queueing model and Normal/Priority/Steer plus Keep/Skip reaction policy, native Rich Markdown delivery, UI/compat rendering, and interactive controls
 - [public-api.md](./public-api.md) — Stable public API map: package entrypoints, commands, config, assistant markup, extension APIs, smoke examples, and compatibility boundaries
 - [delivery.md](./delivery.md) — Target-aware companion delivery contract for operational views, logical message handles, target scopes, lifecycle fencing, and leader/follower transport
 - [activity.md](./activity.md) — Normalized Pi lifecycle API for extension-owned reasoning, intermediate prose, tool activity, source identity, delivery contexts, and consumer policy examples