@will-17173/telegram-cli 0.3.0 → 0.4.1

package/dist/presenters/ink/listen.js

@@ -5,15 +5,15 @@ import stringWidth from 'string-width';
 import { existsSync, mkdirSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname } from 'node:path';
-import { resolveAttachmentDestination } from '../../services/attachment-download.js';
+import { attachmentDownloadProgress, resolveAttachmentDestination, } from '../../services/attachment-download.js';
 import { ListenAlbumAggregator } from '../../services/listen-album-aggregator.js';
 import { AutoDownloadCoordinator } from '../../services/auto-download-coordinator.js';
 import { attachmentDownloadTarget, attachmentFileName, discoverListenAttachments, listenAttachmentKey } from '../../services/listen-attachment.js';
 import { buildListenMessage } from '../listen-message.js';
-import { applyMessageArrival, takeListenViewport } from './listen-scroll.js';
+import { applyMessageArrival, applyScroll, takeListenViewport } from './listen-scroll.js';
 import { decodeImagePreview } from './image-preview.js';
 import { ListenScrollbar, calculateScrollbar, listenContentWidth, useTransientScrollbar } from './listen-scrollbar.js';
-import { DISABLE_MOUSE_REPORTING, isMouseInput } from './mouse-scroll.js';
+import { DISABLE_MOUSE_REPORTING, ENABLE_MOUSE_REPORTING, isMouseInput, useMouseScroll, withAlternateScroll, } from './mouse-scroll.js';
 import { createListenReplyResolver } from '../../services/listen-reply-resolver.js';
 import { formatReplyContext } from '../../services/reply-context.js';
 import { executeListenReply, parseListenComposerInput } from '../../services/listen-composer-command.js';
@@ -25,9 +25,12 @@ import { useGroupCommand } from './use-group-command.js';
 import { executeGroupCommand } from '../../group-commands/executor.js';
 import { GroupWriteService } from '../../services/group-write-service.js';
 import { ADMIN_RIGHT_KEYS } from '../../services/group-write-service.js';
+import { WriteAccessPolicy } from '../../services/write-access-policy.js';
 import { GroupCommandConfirm } from './group-command-confirm.js';
 import { truncateCell } from './display-width.js';
+import { SecureInput } from './secure-input.js';
 const MESSAGE_SEPARATOR = '────────────────────────────────────────────';
+const OWNERSHIP_SHUTDOWN_GRACE_MS = 250;
 /** Maximum number of grouped messages retained by a long-running interactive listener. */
 export const LISTEN_HISTORY_LIMIT = 500;
 const LISTEN_IMAGE_PREVIEWS_ENABLED = false;
@@ -60,11 +63,14 @@ export const LISTEN_COMPOSER_THEME = {
     target: '#f0d38a',
     hint: '#9bdca8',
 };
-export function ListenComposer({ input, sendTargetLabel, terminalWidth, sending = false, hint = 'Enter to send · Ctrl+C to exit', }) {
+export function listenComposerCursorColor(visible) {
+    return visible ? LISTEN_COMPOSER_THEME.cursor : LISTEN_COMPOSER_THEME.background;
+}
+export function ListenComposer({ input, sendTargetLabel, terminalWidth, sending = false, hint = 'Enter to send · Ctrl+C to exit', cursorVisible = true, }) {
     const inputText = `› ${input}${sending ? ' (sending...)' : ''}`;
     const blankRow = ' '.repeat(Math.max(0, terminalWidth));
     const inputRowFill = ' '.repeat(Math.max(0, terminalWidth - stringWidth(inputText) - 1));
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { backgroundColor: LISTEN_COMPOSER_THEME.background, children: blankRow }), _jsxs(Text, { backgroundColor: LISTEN_COMPOSER_THEME.background, color: LISTEN_COMPOSER_THEME.foreground, children: [inputText, _jsx(Text, { backgroundColor: LISTEN_COMPOSER_THEME.cursor, children: " " }), inputRowFill] }), _jsx(Text, { backgroundColor: LISTEN_COMPOSER_THEME.background, children: blankRow }), _jsxs(Box, { justifyContent: "space-between", children: [_jsxs(Text, { color: LISTEN_COMPOSER_THEME.target, children: ["To: ", sendTargetLabel] }), _jsx(Text, { color: LISTEN_COMPOSER_THEME.hint, children: hint })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { backgroundColor: LISTEN_COMPOSER_THEME.background, children: blankRow }), _jsxs(Text, { backgroundColor: LISTEN_COMPOSER_THEME.background, color: LISTEN_COMPOSER_THEME.foreground, children: [inputText, _jsx(Text, { backgroundColor: listenComposerCursorColor(cursorVisible), children: " " }), inputRowFill] }), _jsx(Text, { backgroundColor: LISTEN_COMPOSER_THEME.background, children: blankRow }), _jsxs(Box, { justifyContent: "space-between", children: [_jsxs(Text, { color: LISTEN_COMPOSER_THEME.target, children: ["To: ", sendTargetLabel] }), _jsx(Text, { color: LISTEN_COMPOSER_THEME.hint, children: hint })] })] }));
 }
 export function ListenAttachmentLine({ label, selected, state }) {
     const action = state.status === 'idle'
@@ -196,16 +202,23 @@ export async function runInteractiveAutoDownloadLifecycle(options) {
         : null;
     options.onCoordinator?.(coordinator);
     let currentClient = null;
+    let closeCurrentClient = null;
     const abort = () => {
         coordinator?.stop();
-        void currentClient?.close().catch(() => undefined);
+        void closeCurrentClient?.();
     };
     options.signal.addEventListener('abort', abort);
     try {
         while (!options.signal.aborted) {
             options.onStatus?.('connecting');
             const client = options.createClient();
+            let closePromise;
+            const closeClient = () => {
+                closePromise ??= Promise.resolve().then(() => client.close()).catch(() => undefined);
+                return closePromise;
+            };
             currentClient = client;
+            closeCurrentClient = closeClient;
             options.onClient?.(client);
             coordinator?.setClient(client);
             let retry = false;
@@ -249,11 +262,13 @@ export async function runInteractiveAutoDownloadLifecycle(options) {
                 else {
                     coordinator?.stop();
                 }
-                await client.close().catch(() => undefined);
+                await closeClient();
                 if (options.signal.aborted)
                     await coordinator?.waitForActive();
                 if (currentClient === client)
                     currentClient = null;
+                if (closeCurrentClient === closeClient)
+                    closeCurrentClient = null;
                 options.onClient?.(null);
             }
             if (!retry)
@@ -376,8 +391,7 @@ export function calculateListenMessagePaneHeight(terminalHeight, hasNote, autoDo
     return Math.max(2, terminalHeight - reservedLines);
 }
 export async function runInteractiveListen(write, run) {
-    write(DISABLE_MOUSE_REPORTING);
-    return run();
+    return withAlternateScroll({ write, run });
 }
 export async function renderInteractiveListen(options) {
     await runInteractiveListen(process.stdout.write.bind(process.stdout), async () => {
@@ -385,7 +399,7 @@ export async function renderInteractiveListen(options) {
         await app.waitUntilExit();
     });
 }
-export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo, showMedia, autoDownload, showChatName, createClient, stopSignal, onRequestStop, createReplyResolver, }) {
+export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo, showMedia, autoDownload, showChatName, createClient, stopSignal, onRequestStop, createReplyResolver, shutdownRequests, }) {
     const { exit } = useApp();
     const { stdout } = useStdout();
     const terminalMetrics = useTerminalMetrics(stdout);
@@ -395,19 +409,23 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
     const [note, setNote] = useState('');
     const [sending, setSending] = useState(false);
     const [focus, setFocus] = useState('input');
-    const [selectedAttachmentIndex, setSelectedAttachmentIndex] = useState(0);
+    const [selectedAttachmentKey, setSelectedAttachmentKey] = useState(null);
     const [downloadStates, setDownloadStates] = useState({});
     const [scrollState, setScrollState] = useState({ offset: 0, unseenCount: 0 });
     const [sendTargetLabel, setSendTargetLabel] = useState(sendTo == null ? '' : buildSendTargetLabel(sendTo));
     const [knownGroup, setKnownGroup] = useState(undefined);
     const clientRef = useRef(null);
     const replyExecutionLockRef = useRef(false);
-    const inputGenerationRef = useRef(0);
+    const inputGenerationRef = useRef({});
     const commandSelectionRef = useRef(0);
     const knownGroupRef = useRef(undefined);
-    const groupLookupGenerationRef = useRef(0);
+    const groupLookupGenerationRef = useRef({});
+    const selectedAttachmentKeyRef = useRef(null);
+    const scrollOffsetRef = useRef(0);
+    selectedAttachmentKeyRef.current = selectedAttachmentKey;
+    scrollOffsetRef.current = scrollState.offset;
     useEffect(() => {
-        groupLookupGenerationRef.current++;
+        groupLookupGenerationRef.current = {};
         knownGroupRef.current = undefined;
         setKnownGroup(undefined);
     }, [sendTo]);
@@ -418,19 +436,25 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
         if (sendTo == null)
             return { ok: false, error: { code: 'ambiguous_chat', message: 'Select exactly one target chat with --send-to.' } };
         let knownGroup = knownGroupRef.current;
-        if (knownGroup == null) {
-            const lookup = ++groupLookupGenerationRef.current;
+        const refreshOwnershipCapability = request.key === 'admin transfer-owner'
+            && options?.confirmed === true
+            && options.ownershipPassword == null;
+        if (knownGroup == null || refreshOwnershipCapability) {
+            const lookup = {};
+            groupLookupGenerationRef.current = lookup;
             knownGroup = await client.groups.getGroup(sendTo);
-            if (lookup === groupLookupGenerationRef.current && clientRef.current === client) {
-                knownGroupRef.current = knownGroup;
-                setKnownGroup(knownGroup);
+            if (lookup !== groupLookupGenerationRef.current || clientRef.current !== client) {
+                return { ok: false, error: { code: 'connection_not_ready', message: 'Telegram connection changed during group verification.' } };
             }
+            knownGroupRef.current = knownGroup;
+            setKnownGroup(knownGroup);
         }
         return executeGroupCommand(request, {
             chat: sendTo,
             groups: new GroupWriteService(client.groups),
             confirmed: options?.confirmed ?? false,
             confirmationTitle: options?.confirmationTitle,
+            ownershipPassword: options?.ownershipPassword,
             knownGroup,
             connectionReady: true,
             targetAvailable: true,
@@ -440,7 +464,8 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
                 setKnownGroup(undefined);
                 if (request.key === 'chat delete' || request.key === 'chat leave')
                     return;
-                const lookup = ++groupLookupGenerationRef.current;
+                const lookup = {};
+                groupLookupGenerationRef.current = lookup;
                 try {
                     const refreshed = await client.groups.getGroup(sendTo);
                     if (lookup === groupLookupGenerationRef.current && clientRef.current === client) {
@@ -455,6 +480,8 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
             },
         });
     }, [sendTo]));
+    const irreversibleGroupWriteRef = useRef(false);
+    irreversibleGroupWriteRef.current = groupCommand.state.kind === 'executing' && groupCommand.state.irreversible === true;
     const terminalWidth = terminalMetrics.columns;
     const terminalHeight = terminalMetrics.rows;
     const previewColorDepth = interactiveListenPreviewColorDepth(terminalMetrics.colorDepth);
@@ -479,22 +506,83 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
     if (operationControllerRef.current == null)
         operationControllerRef.current = createInteractiveOperationController();
     const stoppingRef = useRef(false);
+    const lifecycleStopRef = useRef(null);
+    const deferredStopRef = useRef(false);
+    const shutdownRequestedRef = useRef(false);
+    const shutdownGraceTimerRef = useRef(null);
+    function requestOwnershipShutdown(source) {
+        if (deferredStopRef.current || shutdownRequestedRef.current) {
+            deferredStopRef.current = false;
+            shutdownRequestedRef.current = false;
+            if (shutdownGraceTimerRef.current)
+                clearTimeout(shutdownGraceTimerRef.current);
+            shutdownGraceTimerRef.current = null;
+            groupCommand.setState({ kind: 'error', message: 'Ownership transfer outcome is indeterminate after forced shutdown.' });
+            setTimeout(stopListening, 0);
+            return;
+        }
+        if (source === 'terminal') {
+            deferredStopRef.current = true;
+            setNote('Group write is already running; wait for its outcome.');
+            return;
+        }
+        shutdownRequestedRef.current = true;
+        setNote('Shutdown requested; waiting briefly for the ownership transfer outcome.');
+        shutdownGraceTimerRef.current = setTimeout(() => {
+            shutdownGraceTimerRef.current = null;
+            groupCommand.setState({
+                kind: 'error',
+                message: 'Ownership transfer outcome is indeterminate because shutdown grace expired.',
+            });
+            setTimeout(stopListening, 0);
+        }, OWNERSHIP_SHUTDOWN_GRACE_MS);
+    }
     const seenRef = useRef(new Set());
     const seenOrderRef = useRef([]);
-    const downloadableAttachments = collectDownloadableAttachments(visibleMessages);
-    const selectedAttachment = downloadableAttachments[selectedAttachmentIndex] ?? downloadableAttachments[0];
-    const { visible: scrollbarVisible } = useTransientScrollbar();
+    const downloadableAttachments = collectDownloadableAttachments(messages);
+    const visibleDownloadableAttachments = collectDownloadableAttachments(visibleMessages);
+    const selectedAttachment = downloadableAttachments.find((item) => item.key === selectedAttachmentKey);
+    const selectAttachment = (key) => {
+        selectedAttachmentKeyRef.current = key;
+        setSelectedAttachmentKey(key);
+    };
+    const { visible: scrollbarVisible, show: showScrollbar } = useTransientScrollbar();
     const scrollbarGeometry = calculateScrollbar({
         height: terminalHeight,
         total: messages.length,
         visible: visibleMessages.length,
         offset: scrollState.offset,
     });
+    const lastScrollDirectionRef = useRef('up');
+    const scrollMessages = useCallback((direction, amount = 1) => {
+        lastScrollDirectionRef.current = direction;
+        const step = Math.max(1, Math.floor(amount));
+        const maxOffset = Math.max(0, messages.length - 1);
+        scrollOffsetRef.current = direction === 'up'
+            ? Math.min(maxOffset, scrollOffsetRef.current + step)
+            : Math.max(0, scrollOffsetRef.current - step);
+        showScrollbar();
+        setScrollState((current) => applyScroll(current, direction, maxOffset, amount));
+    }, [messages.length, showScrollbar]);
+    const handleMouseScroll = useCallback((direction) => {
+        if (focus === 'attachments')
+            scrollMessages(direction);
+    }, [focus, scrollMessages]);
+    useMouseScroll(handleMouseScroll);
+    useEffect(() => {
+        if (focus !== 'attachments')
+            return;
+        stdout.write(ENABLE_MOUSE_REPORTING);
+        return () => {
+            stdout.write(DISABLE_MOUSE_REPORTING);
+        };
+    }, [focus, stdout]);
     useEffect(() => {
         const maxOffset = Math.max(0, messages.length - 1);
         setScrollState((current) => {
             const offset = Math.min(current.offset, maxOffset);
             const unseenCount = offset === 0 ? 0 : Math.min(current.unseenCount, messages.length);
+            scrollOffsetRef.current = offset;
             return offset === current.offset && unseenCount === current.unseenCount
                 ? current
                 : { offset, unseenCount };
@@ -505,18 +593,46 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
         setDownloadStates((current) => pruneAttachmentDownloadStates(current, validAttachmentKeys, pendingAttachmentKeysRef.current));
         for (const key of validAttachmentKeys)
             pendingAttachmentKeysRef.current.delete(key);
-        setSelectedAttachmentIndex((current) => Math.min(current, Math.max(0, downloadableAttachments.length - 1)));
+        const currentSelectedKey = selectedAttachmentKeyRef.current;
+        if (currentSelectedKey != null && !validAttachmentKeys.has(currentSelectedKey)) {
+            selectAttachment(downloadableAttachments[0]?.key ?? null);
+        }
         if (downloadableAttachments.length === 0)
             setFocus('input');
     }, [messages, downloadableAttachments.length]);
+    useEffect(() => {
+        if (focus !== 'attachments' || visibleDownloadableAttachments.length === 0)
+            return;
+        if (visibleDownloadableAttachments.some((item) => item.key === selectedAttachment?.key))
+            return;
+        const fallback = lastScrollDirectionRef.current === 'up'
+            ? visibleDownloadableAttachments.at(-1)
+            : visibleDownloadableAttachments[0];
+        const index = fallback == null
+            ? -1
+            : downloadableAttachments.findIndex((item) => item.key === fallback.key);
+        if (index >= 0)
+            selectAttachment(downloadableAttachments[index].key);
+    }, [focus, messagePaneHeight, messages, scrollState.offset, selectedAttachmentKey]);
     useInput((inputText, key) => {
         if (isMouseInput(inputText))
             return;
+        const modal = groupCommand.state;
+        if (modal.kind === 'executing' && modal.irreversible === true) {
+            if (key.ctrl && (inputText === 'c' || inputText === 'C' || inputText === '\u0003')) {
+                requestOwnershipShutdown('terminal');
+            }
+            else if (key.escape) {
+                setNote('Group write is already running; wait for its outcome.');
+            }
+            return;
+        }
         if (key.ctrl && (inputText === 'c' || inputText === 'C' || inputText === '\u0003')) {
             stopListening();
             return;
         }
-        const modal = groupCommand.state;
+        if (modal.kind === 'password')
+            return;
         if (modal.kind === 'confirm') {
             if (key.escape) {
                 closeGroupCommand();
@@ -556,7 +672,8 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
                 }
                 else {
                     const submittedTitle = modal.confirmText;
-                    const lookup = ++groupLookupGenerationRef.current;
+                    const lookup = {};
+                    groupLookupGenerationRef.current = lookup;
                     void client.groups.getGroup(sendTo).then((fresh) => {
                         if (lookup !== groupLookupGenerationRef.current || clientRef.current !== client)
                             return;
@@ -618,12 +735,17 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
             closeGroupCommand();
             return;
         }
+        if (replyExecutionLockRef.current) {
+            if (key.escape)
+                setNote('Reply is still sending; wait for its outcome.');
+            return;
+        }
+        if (key.pageUp || key.pageDown) {
+            scrollMessages(key.pageUp ? 'up' : 'down', Math.max(1, visibleMessages.length));
+            return;
+        }
         const slashMode = input.trimStart().startsWith('/');
         if (slashMode && key.escape) {
-            if (replyExecutionLockRef.current) {
-                inputGenerationRef.current++;
-                setSending(false);
-            }
             closeGroupCommand();
             return;
         }
@@ -642,7 +764,7 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
                 setNote(failure.error.message);
                 return;
             }
-            inputGenerationRef.current++;
+            inputGenerationRef.current = {};
             setInput(completeListenCommand(input, selected));
             commandSelectionRef.current = 0;
             groupCommand.setState({ kind: 'menu', selectedIndex: 0 });
@@ -653,9 +775,12 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
             if (focus === 'attachments') {
                 setFocus('input');
             }
-            else if (downloadableAttachments.length > 0) {
+            else if (visibleDownloadableAttachments.length > 0) {
+                const currentSelectedKey = selectedAttachmentKeyRef.current;
+                const nextSelection = visibleDownloadableAttachments.find((item) => item.key === currentSelectedKey)
+                    ?? visibleDownloadableAttachments[0];
                 setFocus('attachments');
-                setSelectedAttachmentIndex((current) => Math.min(current, downloadableAttachments.length - 1));
+                selectAttachment(nextSelection.key);
             }
             else {
                 setNote('no downloadable attachments');
@@ -668,20 +793,42 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
                 return;
             }
             if (key.upArrow || key.downArrow) {
-                const offset = key.upArrow ? -1 : 1;
-                setSelectedAttachmentIndex((current) => {
-                    const count = downloadableAttachments.length;
-                    return count === 0 ? 0 : (current + offset + count) % count;
-                });
+                const direction = key.upArrow ? 'up' : 'down';
+                const delta = direction === 'up' ? -1 : 1;
+                const currentIndex = downloadableAttachments.findIndex((item) => item.key === selectedAttachmentKeyRef.current);
+                const nextIndex = currentIndex + delta;
+                if (currentIndex < 0 || nextIndex < 0 || nextIndex >= downloadableAttachments.length)
+                    return;
+                const nextAttachment = downloadableAttachments[nextIndex];
+                selectAttachment(nextAttachment?.key ?? null);
+                const effectiveVisibleMessages = takeListenViewport(messages, messagePaneHeight, scrollOffsetRef.current);
+                if (nextAttachment != null && !effectiveVisibleMessages.some((message) => message.key === nextAttachment.message.key)) {
+                    const messageIndex = messages.findIndex((message) => message.key === nextAttachment.message.key);
+                    if (messageIndex >= 0) {
+                        const targetOffset = messages.length - 1 - messageIndex;
+                        scrollOffsetRef.current = targetOffset;
+                        showScrollbar();
+                        setScrollState((current) => {
+                            if (current.offset === targetOffset)
+                                return current;
+                            return applyScroll(current, targetOffset > current.offset ? 'up' : 'down', Math.max(0, messages.length - 1), Math.abs(targetOffset - current.offset));
+                        });
+                    }
+                }
                 return;
             }
-            if (key.return && selectedAttachment != null) {
-                const state = downloadStates[selectedAttachment.key] ?? { status: 'idle' };
+            const currentSelectedAttachment = downloadableAttachments.find((item) => item.key === selectedAttachmentKeyRef.current);
+            if (key.return && currentSelectedAttachment != null) {
+                const state = downloadStates[currentSelectedAttachment.key] ?? { status: 'idle' };
                 if (canManuallyDownload(state))
-                    void downloadAttachment(selectedAttachment);
+                    void downloadAttachment(currentSelectedAttachment);
             }
             return;
         }
+        if (key.upArrow || key.downArrow) {
+            scrollMessages(key.upArrow ? 'up' : 'down');
+            return;
+        }
         if (sending || groupCommand.state.kind === 'executing')
             return;
         if (key.return) {
@@ -699,7 +846,7 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
                 }
                 const parsed = parseSelectedListenCommand(input, match);
                 if (parsed.kind === 'complete') {
-                    inputGenerationRef.current++;
+                    inputGenerationRef.current = {};
                     setInput(parsed.input);
                     commandSelectionRef.current = 0;
                     groupCommand.setState({ kind: 'menu', selectedIndex: 0 });
@@ -721,6 +868,11 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
                         setNote('connection is not ready');
                         return;
                     }
+                    const access = new WriteAccessPolicy().check();
+                    if (!access.ok) {
+                        setNote(access.error.message);
+                        return;
+                    }
                     replyExecutionLockRef.current = true;
                     const ownedGeneration = inputGenerationRef.current;
                     const originalInput = input;
@@ -761,7 +913,7 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
             return;
         }
         if (key.backspace || key.delete) {
-            inputGenerationRef.current++;
+            inputGenerationRef.current = {};
             setInput((current) => current.slice(0, -1));
             return;
         }
@@ -769,7 +921,7 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
             return;
         }
         if (!key.ctrl && !key.meta && inputText.length > 0) {
-            inputGenerationRef.current++;
+            inputGenerationRef.current = {};
             setInput((current) => {
                 const next = current + inputText;
                 if (next.trimStart().startsWith('/')) {
@@ -784,14 +936,24 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
     useEffect(() => {
         const generation = operationControllerRef.current.beginGeneration();
         const isActive = generation.isActive;
+        const lifecycleStop = new AbortController();
+        lifecycleStopRef.current = lifecycleStop;
         if (stopSignal.aborted) {
             exit();
             return;
         }
         const stopFromSignal = () => {
+            if (stoppingRef.current)
+                return;
+            if (irreversibleGroupWriteRef.current) {
+                requestOwnershipShutdown('external');
+                return;
+            }
             stopListening();
         };
-        stopSignal.addEventListener('abort', stopFromSignal);
+        const unsubscribeShutdown = shutdownRequests?.subscribe(stopFromSignal);
+        if (shutdownRequests == null)
+            stopSignal.addEventListener('abort', stopFromSignal);
         const groupQueue = createInteractiveListenRuntime(dbPath, createReplyResolver ?? createListenReplyResolver, {
             isActive,
             onGroup: (group) => {
@@ -833,7 +995,7 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
             chats,
             persist,
             retrySeconds,
-            signal: stopSignal,
+            signal: lifecycleStop.signal,
             createClient,
             createCoordinator: () => autoDownloader,
             onCoordinator: (coordinator) => {
@@ -843,12 +1005,13 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
             onClient: (client) => {
                 if (!isActive())
                     return;
-                groupLookupGenerationRef.current++;
+                groupLookupGenerationRef.current = {};
                 knownGroupRef.current = undefined;
                 setKnownGroup(undefined);
                 clientRef.current = client;
                 if (client != null && sendTo != null) {
-                    const lookup = ++groupLookupGenerationRef.current;
+                    const lookup = {};
+                    groupLookupGenerationRef.current = lookup;
                     void client.groups.getGroup(sendTo).then((group) => {
                         if (isActive() && lookup === groupLookupGenerationRef.current && clientRef.current === client) {
                             knownGroupRef.current = group;
@@ -903,30 +1066,42 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
                     albumAggregator.flush();
             },
         }).finally(() => {
-            if (isActive() && !stopSignal.aborted) {
+            if (isActive() && !stopSignal.aborted && !stoppingRef.current) {
                 onRequestStop();
                 exit();
             }
         });
         return () => {
-            groupLookupGenerationRef.current += 1;
+            groupLookupGenerationRef.current = {};
             knownGroupRef.current = undefined;
-            stopSignal.removeEventListener('abort', stopFromSignal);
+            unsubscribeShutdown?.();
+            if (shutdownRequests == null)
+                stopSignal.removeEventListener('abort', stopFromSignal);
             albumAggregator.flush();
             generation.dispose();
             albumAggregator.dispose();
             void groupQueue.close();
             if (albumAggregatorRef.current === albumAggregator)
                 albumAggregatorRef.current = null;
-            void clientRef.current?.close().catch(() => undefined);
+            lifecycleStop.abort();
             clientRef.current = null;
             autoDownloader?.stop();
             void autoDownloader?.waitForActive();
             if (autoDownloaderRef.current === autoDownloader)
                 autoDownloaderRef.current = null;
+            if (lifecycleStopRef.current === lifecycleStop)
+                lifecycleStopRef.current = null;
+            if (shutdownGraceTimerRef.current)
+                clearTimeout(shutdownGraceTimerRef.current);
+            shutdownGraceTimerRef.current = null;
         };
-    }, [autoDownload, chats, createClient, createReplyResolver, dbPath, persist, retrySeconds, sendTo, showMedia, exit, stopSignal, onRequestStop]);
+    }, [autoDownload, chats, createClient, createReplyResolver, dbPath, persist, retrySeconds, sendTo, showMedia, exit, stopSignal, shutdownRequests, onRequestStop]);
     const sendMessage = async (text) => {
+        const access = new WriteAccessPolicy().check();
+        if (!access.ok) {
+            setNote(access.error.message);
+            return;
+        }
         const trimmed = text.trim();
         if (!trimmed)
             return;
@@ -997,7 +1172,7 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
                 onProgress: (downloaded, total) => {
                     if (!isCurrent())
                         return;
-                    const progress = Number.isFinite(total) && total > 0 ? Math.round(downloaded / total * 100) : null;
+                    const progress = attachmentDownloadProgress(downloaded, total);
                     setDownloadStates((current) => ({ ...current, [item.key]: { status: 'downloading', progress } }));
                 },
             });
@@ -1019,15 +1194,28 @@ export function InteractiveListen({ dbPath, chats, persist, retrySeconds, sendTo
             setTimeout(exit, 0);
         onRequestStop();
         autoDownloaderRef.current?.stop();
-        clientRef.current?.close().catch(() => undefined);
+        lifecycleStopRef.current?.abort();
     };
+    useEffect(() => {
+        if (groupCommand.state.kind !== 'result' && groupCommand.state.kind !== 'error')
+            return;
+        if (!deferredStopRef.current && !shutdownRequestedRef.current)
+            return;
+        deferredStopRef.current = false;
+        shutdownRequestedRef.current = false;
+        if (shutdownGraceTimerRef.current)
+            clearTimeout(shutdownGraceTimerRef.current);
+        shutdownGraceTimerRef.current = null;
+        const pending = setTimeout(stopListening, 0);
+        return () => clearTimeout(pending);
+    }, [groupCommand.state]);
     const permissionState = groupCommand.state.kind === 'select-permissions' ? groupCommand.state : null;
     return (_jsxs(Box, { flexDirection: "row", width: terminalWidth, height: terminalHeight, overflow: "hidden", children: [_jsxs(Box, { flexDirection: "column", width: contentWidth, height: terminalHeight, overflow: "hidden", children: [_jsx(ListenStatusArea, { status: status, unseenCount: scrollState.unseenCount, autoDownload: autoDownload }), note ? _jsx(Text, { dimColor: true, children: note }) : null, groupCommand.state.kind === 'result' ? _jsx(Box, { flexGrow: 1, flexDirection: "column", children: _jsx(GroupCommandResult, { state: groupCommand.state, width: contentWidth }) }) : _jsxs(Box, { flexGrow: 1, flexDirection: "column", children: [_jsx(GroupCommandResult, { state: groupCommand.state, width: contentWidth }), groupCommand.state.kind === 'confirm' && 'confirmation' in groupCommand.state.pending ? _jsx(GroupCommandConfirm, { confirmation: groupCommand.state.pending.confirmation, selectedIndex: groupCommand.state.selectedIndex, width: contentWidth }) : null, groupCommand.state.kind === 'confirm-title' && 'confirmation' in groupCommand.state.pending ? groupCommand.state.stage === 'confirm'
                                 ? _jsx(GroupCommandConfirm, { confirmation: groupCommand.state.pending.confirmation, selectedIndex: groupCommand.state.selectedIndex, width: contentWidth })
-                                : _jsxs(Box, { flexDirection: "column", width: contentWidth, children: [_jsx(Text, { color: "yellow", children: truncateCell('Type the exact title to permanently delete this chat:', contentWidth) }), _jsx(Text, { children: truncateCell(groupCommand.state.pending.confirmation.title ?? '', contentWidth) }), _jsx(Text, { color: "#8ecbff", children: truncateCell(`› ${groupCommand.state.confirmText}`, contentWidth) }), groupCommand.state.mismatch ? _jsx(Text, { color: "red", children: truncateCell('Title does not match exactly.', contentWidth) }) : null, _jsx(Text, { dimColor: true, children: truncateCell('Enter verify · Esc back', contentWidth) })] }) : null, permissionState ? _jsxs(Box, { flexDirection: "column", width: contentWidth, children: [_jsx(Text, { color: "#8ecbff", children: truncateCell('Administrator permissions', contentWidth) }), ADMIN_RIGHT_KEYS.map((right, index) => _jsx(Text, { color: index === permissionState.selectedIndex ? '#8ecbff' : undefined, children: truncateCell(`${index === permissionState.selectedIndex ? '› ' : '  '}[${permissionState.selected.includes(right) ? 'x' : ' '}] ${right}`, contentWidth) }, right)), permissionState.warning ? _jsx(Text, { color: "yellow", children: truncateCell(permissionState.warning, contentWidth) }) : null, _jsx(Text, { dimColor: true, children: truncateCell('↑/↓ select · Space toggle · Enter continue · Esc cancel', contentWidth) })] }) : null, _jsxs(Box, { marginTop: 1, flexDirection: "column", flexGrow: 1, overflow: "hidden", children: [messages.length === 0 ? _jsx(Text, { dimColor: true, children: "Waiting for new messages..." }) : null, visibleMessages.map((message) => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, wrap: "truncate-end", children: formatInteractiveListenHeader(message) }), message.replyContext == null ? null : _jsx(Text, { wrap: "truncate-end", children: formatReplyContext(message.replyContext) }), message.content == null ? null : _jsx(Text, { wrap: "truncate-end", children: message.content }), message.mediaSummary == null ? null : _jsx(Text, { wrap: "truncate-end", children: message.mediaSummary }), message.media.map((item, mediaIndex) => {
+                                : _jsxs(Box, { flexDirection: "column", width: contentWidth, children: [_jsx(Text, { color: "yellow", children: truncateCell('Type the exact title to permanently delete this chat:', contentWidth) }), _jsx(Text, { children: truncateCell(groupCommand.state.pending.confirmation.title ?? '', contentWidth) }), _jsx(Text, { color: "#8ecbff", children: truncateCell(`› ${groupCommand.state.confirmText}`, contentWidth) }), groupCommand.state.mismatch ? _jsx(Text, { color: "red", children: truncateCell('Title does not match exactly.', contentWidth) }) : null, _jsx(Text, { dimColor: true, children: truncateCell('Enter verify · Esc back', contentWidth) })] }) : null, groupCommand.state.kind === 'password' ? _jsx(SecureInput, { label: "Telegram 2FA password", onSubmit: (value) => { void groupCommand.runWithOwnershipPassword(value); }, onCancel: closeGroupCommand }) : null, permissionState ? _jsxs(Box, { flexDirection: "column", width: contentWidth, children: [_jsx(Text, { color: "#8ecbff", children: truncateCell('Administrator permissions', contentWidth) }), ADMIN_RIGHT_KEYS.map((right, index) => _jsx(Text, { color: index === permissionState.selectedIndex ? '#8ecbff' : undefined, children: truncateCell(`${index === permissionState.selectedIndex ? '› ' : '  '}[${permissionState.selected.includes(right) ? 'x' : ' '}] ${right}`, contentWidth) }, right)), permissionState.warning ? _jsx(Text, { color: "yellow", children: truncateCell(permissionState.warning, contentWidth) }) : null, _jsx(Text, { dimColor: true, children: truncateCell('↑/↓ select · Space toggle · Enter continue · Esc cancel', contentWidth) })] }) : null, _jsxs(Box, { marginTop: 1, flexDirection: "column", flexGrow: 1, overflow: "hidden", children: [messages.length === 0 ? _jsx(Text, { dimColor: true, children: "Waiting for new messages..." }) : null, visibleMessages.map((message) => (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, wrap: "truncate-end", children: formatInteractiveListenHeader(message) }), message.replyContext == null ? null : _jsx(Text, { wrap: "truncate-end", children: formatReplyContext(message.replyContext) }), message.content == null ? null : _jsx(Text, { wrap: "truncate-end", children: message.content }), message.mediaSummary == null ? null : _jsx(Text, { wrap: "truncate-end", children: message.mediaSummary }), message.media.map((item, mediaIndex) => {
                                                 const attachmentKey = attachmentDownloadKeyAt(message.media, mediaIndex);
                                                 return (_jsx(ListenAttachmentWithPreview, { label: item.label, downloadable: item.downloadable, selected: focus === 'attachments' && selectedAttachment?.key === attachmentKey, state: downloadStates[attachmentKey] ?? { status: 'idle' }, previewCells: item.previewCells }, attachmentKey));
-                                            }), _jsx(Text, { dimColor: true, children: MESSAGE_SEPARATOR })] }, message.key)))] })] }), groupCommand.state.kind !== 'result' ? _jsxs(Box, { flexDirection: "column", children: [sendTo == null ? _jsx(Text, { dimColor: true, children: "Set --send-to <chat> (or pass one chat to listen) before sending messages." }) : null, _jsxs(Box, { marginTop: 1, flexDirection: "column", flexShrink: 0, children: [input.trimStart().startsWith('/') && groupCommand.state.kind === 'menu' ? _jsx(ListenCommandMenu, { input: input, selectedIndex: groupCommand.state.selectedIndex, width: contentWidth, knownGroup: knownGroup }) : null, _jsx(ListenComposer, { input: input, sendTargetLabel: sendTo == null ? '(not selected)' : sendTargetLabel, terminalWidth: contentWidth, sending: sending, hint: focus === 'attachments' ? '↑/↓ select · Enter download · Tab input' : 'Enter send · /reply <id> ... · Tab attachments · Ctrl+C exit' })] })] }) : null] }), _jsx(ListenScrollbar, { height: terminalHeight, visible: scrollbarVisible, geometry: scrollbarGeometry })] }));
+                                            }), _jsx(Text, { dimColor: true, children: MESSAGE_SEPARATOR })] }, message.key)))] })] }), groupCommand.state.kind !== 'result' ? _jsxs(Box, { flexDirection: "column", children: [sendTo == null ? _jsx(Text, { dimColor: true, children: "Set --send-to <chat> (or pass one chat to listen) before sending messages." }) : null, _jsxs(Box, { marginTop: 1, flexDirection: "column", flexShrink: 0, children: [input.trimStart().startsWith('/') && groupCommand.state.kind === 'menu' ? _jsx(ListenCommandMenu, { input: input, selectedIndex: groupCommand.state.selectedIndex, width: contentWidth, knownGroup: knownGroup }) : null, _jsx(ListenComposer, { input: input, sendTargetLabel: sendTo == null ? '(not selected)' : sendTargetLabel, terminalWidth: contentWidth, sending: sending, cursorVisible: focus === 'input', hint: focus === 'attachments' ? 'Wheel · ↑/↓ select · Enter download · Tab input' : 'Wheel/↑/↓/PgUp/PgDn scroll · Drag select · Ctrl+C exit' })] })] }) : null] }), _jsx(ListenScrollbar, { height: terminalHeight, visible: scrollbarVisible, geometry: scrollbarGeometry })] }));
 }
 export class ListenMessageViewCache {
     entries = new Map();