@llblab/pi-telegram 0.54.3 → 0.55.0

package/dist/lib/queue.d.ts

@@ -726,7 +726,7 @@ export interface TelegramDispatchRuntimeDeps<TContext = unknown> {
     executeControlItem: (item: Extract<TelegramQueueDispatchAction<TContext>, {
         kind: "control";
     }>["item"]) => void;
-    onPromptDispatchStart: (chatId: number) => void;
+    onPromptDispatchStart: (chatId: number, target?: TelegramQueueTarget) => void;
     commitPromptDispatch?: (item: Extract<TelegramQueueDispatchAction<TContext>, {
         kind: "prompt";
     }>["item"]) => boolean;
@@ -745,7 +745,7 @@ export interface TelegramQueueDispatchControllerDeps<TContext = unknown> extends
     isDispatchGenerationActive?: (generation: number) => boolean;
     updateStatus: (ctx: TContext, error?: string) => void;
     sendTextReply: TelegramControlRuntimeDeps<TContext>["sendTextReply"];
-    onPromptDispatchStart: (ctx: TContext, chatId: number) => void;
+    onPromptDispatchStart: (ctx: TContext, chatId: number, target?: TelegramQueueTarget) => void;
     commitPromptDispatch?: (item: Extract<TelegramQueueDispatchAction<TContext>, {
         kind: "prompt";
     }>["item"], ctx: TContext) => boolean;

package/dist/lib/queue.js

@@ -1957,7 +1957,7 @@ export function executeTelegramQueueDispatchPlan(plan, deps) {
         deps.executeControlItem(plan.item);
         return;
     }
-    deps.onPromptDispatchStart(plan.item.chatId);
+    deps.onPromptDispatchStart(plan.item.chatId, plan.item.target);
     try {
         if (deps.commitPromptDispatch && !deps.commitPromptDispatch(plan.item)) {
             throw new Error("Telegram prompt dispatch could not be committed durably.");
@@ -2188,8 +2188,8 @@ export function createTelegramQueueDispatchController(deps) {
                             },
                         });
                     },
-                    onPromptDispatchStart: (chatId) => {
-                        deps.onPromptDispatchStart(ctx, chatId);
+                    onPromptDispatchStart: (chatId, target) => {
+                        deps.onPromptDispatchStart(ctx, chatId, target);
                     },
                     commitPromptDispatch: deps.commitPromptDispatch
                         ? (item) => deps.commitPromptDispatch(item, ctx)

package/dist/lib/routing.d.ts

@@ -57,7 +57,10 @@ export type TelegramLiveRebindCleanupIssue = {
     cleanup: ThreadReconciler.TelegramLiveRebindCleanupOutcome;
     recorded: boolean;
 };
-/** Default live-rebind cleanup pacing: quick early attempts, then minutely, within a 15-minute window. */
+/**
+ * Default live-rebind cleanup pacing: quick early attempts, then minutely, within a 15-minute window. The first
+ * delay is not cosmetic: a leader's detached command reply still needs the released, cleanup-free row.
+ */
 export declare const TELEGRAM_LIVE_REBIND_CLEANUP_SCHEDULE: Readonly<{
     delaysMs: readonly number[];
     intervalMs: 60000;
@@ -69,7 +72,7 @@ type TelegramLiveRebindSelectedCommandReference = {
     preparedSource: Bus.TelegramBusPreparedCommandSource;
     selectedCommand: Bus.TelegramBusSelectedCommandInput;
 };
-/** One warm live attempt with exact post-release peer donor settlement; no startup recovery, Restore ACK or cleanup. */
+/** One warm live attempt with independent leader input/cleanup grants and exact peer donor settlement; no startup recovery or legacy Restore ACK. */
 export declare function createTelegramLiveRebindCoordinator(input: {
     request: Threads.TelegramWorkspaceRestoreRequest;
     /** Captures caller source/reference, admission, profile, transport and Pi lifetime. */
@@ -100,6 +103,10 @@ export declare function createTelegramLiveRebindCoordinator(input: {
         /** Explicit staged singleton command branch; absence preserves ordinary live input behavior. */
         selectedCommand?: Bus.TelegramBusSelectedCommandInput;
     };
+    /** Existing profile admission spans the applied recipient, fresh cleanup decision and one native input grant. */
+    cleanupBeforeRelease?(intent: Threads.TelegramWorkspaceLiveRebindIntent, isCurrent: () => boolean): Promise<boolean>;
+    /** Restore moves the tab to its new owner: once applied, show that owner's title (best-effort, never blocking). */
+    retitle?: (isCurrent: () => boolean) => Promise<void>;
     recordRuntimeEvent?: (category: string, error: unknown, details: Record<string, unknown>) => void;
 }): {
     /** Correlation only; a later cleanup attempt rereads and revalidates the canonical row itself. */
@@ -199,6 +206,7 @@ export interface TelegramInboundRouteRuntimeDeps<TMessage extends TelegramRouted
     hasWorkspaceRestoreAuthority?: () => boolean;
     /** Exact live root authority; capability advertisement alone cannot replace owned profile/session/recipient fences. */
     hasWorkspaceLiveRebindAuthority?: () => boolean;
+    canUsePreDispatchRebind?: (recipient?: Threads.TelegramWorkspaceRestoreRecipient) => boolean;
     /** Strict complete namespace plus exact current/historical references; only an empty result clears journal protection. */
     inspectTemporaryThreadSources?: (target: Queue.TelegramQueueTarget, requiredJournalBindingKeys: readonly string[], ownInputs?: readonly Threads.TelegramTemporaryThreadInput[]) => readonly number[] | undefined;
     /** Quiet period after the last cancelled input before one cleanup attempt; defaults to 1000 ms. */
@@ -346,6 +354,10 @@ export declare function createTelegramInboundRouteRuntime<TUpdate extends Update
     /** Commands-owned registry port for dormant scoped recipient assembly, not ordinary update replay. */
     prepareHeldCommand: ReturnType<typeof Commands.createTelegramCommandHandlerTargetRuntime<TMessage, TContext>>["prepareHeldCommand"];
     canPrepareHeldCommand: ReturnType<typeof Commands.createTelegramCommandHandlerTargetRuntime<TMessage, TContext>>["canPrepareHeldCommand"];
+    /** Agent-settled hint: wakes waiting leader cleanup retries early; every readiness gate is still sampled fresh. */
+    onSessionSettled(ctx: TContext): void;
+    /** Lifetime-fenced hint from drained publication/activity/delivery/API owners; never a cleanup grant. */
+    onDeliverySettled(ctx: TContext): void;
     /** Fresh body-free recipient observation only; never reconstructs an attempt or grants cleanup. */
     observeLiveRebindLeaderWork(intent: Threads.TelegramWorkspaceLiveRebindIntent, ctx: TContext): Promise<Bus.TelegramBusLiveRebindWorkObservation | undefined>;
     /** Fresh non-destructive candidate only; no retained idle, cleanup action or deletion grant. */