@antst/dashi 0.1.0-alpha.5

package/lib/state.js

@@ -0,0 +1,641 @@
+export function initialViewState(cwd, inline, root, cells = [], prompts = [], historyHasMore = false, attachments = []) {
+    return {
+        attachments, cells, composer: '', cwd, decisions: [], exitArmed: false, historyHasMore, inline,
+        newOutput: 0, prompts, rewindArmed: false, scrollOffset: 0,
+        sendMode: 'steer', toolMode: 'collapsed',
+        ...(root === undefined ? {} : { root }),
+    };
+}
+export const TURN_BELL_THRESHOLD_MS = 10_000;
+function redraw() {
+    return [{ type: 'redraw', force: false }];
+}
+function focusAfter(state, decisions) {
+    const next = decisions[0];
+    return { type: 'set-composer', text: next?.kind === 'question' ? next.custom : state.composer };
+}
+function removeHead(state, effect) {
+    const decisions = state.decisions.slice(1);
+    return [{ ...state, decisions }, [effect, focusAfter(state, decisions), ...redraw()]];
+}
+function moveCursor(decision, cursor) {
+    if (decision.kind === 'approval')
+        return { ...decision, cursor: Math.max(0, Math.min(2, cursor)) };
+    const question = decision.questions[decision.index];
+    if (question === undefined)
+        return decision;
+    return { ...decision, cursor: Math.max(0, Math.min(question.options.length, cursor)) };
+}
+function help() {
+    return {
+        kind: 'info',
+        title: 'Help',
+        lines: [
+            'Enter send · Ctrl+J newline · Ctrl+T steer/next turn',
+            'Esc interrupt · Ctrl+C clear/interrupt · Ctrl+C/D again within 2s to exit',
+            '/ and @ complete live · Tab insert · Shift+Tab permission · Ctrl+O cards',
+            '↑↓ prompt recall · Ctrl+R recall search · Ctrl+F transcript search',
+            'PageUp/PageDown scroll · Ctrl+Home/Ctrl+End ends · Esc Esc rewind/draft recall',
+            'Ctrl+B activity details for jobs and subagents',
+            '@ paths require DSH file-reference · Ctrl+V pastes an image · Backspace removes it',
+            'Ctrl+S stash · Ctrl+G editor · F1 help · Ctrl+L redraw · Ctrl+Z suspend',
+            '/new /clear /resume [--all] [NAME|UUID] /fork /rewind /rename /model /permission /agents /queue · launch -r/-c',
+            '/status /context /tasks /history /export /copy /exit',
+        ],
+    };
+}
+function moveOverlay(overlay, cursor, detailsCount = 0) {
+    if (overlay.kind === 'info' || overlay.kind === 'history')
+        return overlay;
+    const limit = overlay.kind === 'confirm' ? 1
+        : overlay.kind === 'details' ? Math.max(0, detailsCount - 1)
+            : Math.max(0, overlay.options.length - 1);
+    return { ...overlay, cursor: Math.max(0, Math.min(limit, cursor)) };
+}
+const PAGE_CELLS = 8;
+function matches(cells, query) {
+    const needle = query.trim().toLocaleLowerCase();
+    if (needle === '')
+        return [];
+    const found = [];
+    cells.forEach((cell, index) => {
+        const tool = cell.tool;
+        const haystack = [cell.text, cell.detail, tool?.title, tool?.body,
+            ...(tool?.diffs?.flatMap(diff => [diff.path, ...diff.lines]) ?? [])]
+            .filter((value) => value !== undefined).join('\n').toLocaleLowerCase();
+        if (haystack.includes(needle))
+            found.push(index);
+    });
+    return found;
+}
+function copyText(cell) {
+    const card = cell.tool;
+    if (card === undefined)
+        return cell.text;
+    const detail = card.diffs === undefined
+        ? card.body
+        : card.diffs.flatMap(diff => [diff.path, ...diff.lines]).join('\n');
+    return detail === undefined || detail === '' ? card.title : `${card.title}\n${detail}`;
+}
+function refreshSearch(search, cells) {
+    if (search === undefined)
+        return undefined;
+    const found = matches(cells, search.query);
+    return { ...search, cursor: Math.min(search.cursor, Math.max(0, found.length - 1)), matches: found };
+}
+function latestCompletedAssistant(cells) {
+    for (let index = cells.length - 1; index >= 0; index--) {
+        const cell = cells[index];
+        if (cell?.kind === 'assistant' && cell.pending !== true)
+            return cell;
+    }
+}
+export function reduce(state, action) {
+    const head = state.decisions[0];
+    switch (action.type) {
+        case 'attachment-added': {
+            const replace = action.source !== undefined && action.text !== undefined && state.composer === action.source;
+            return [{
+                    ...state, attachments: [...state.attachments, action.attachment],
+                    ...(replace ? { composer: action.text } : {}),
+                }, [...(replace ? [{ type: 'set-composer', text: action.text }] : []), ...redraw()]];
+        }
+        case 'attachment-remove': {
+            if (action.index < 0 || action.index >= state.attachments.length)
+                return [state, []];
+            return [{ ...state, attachments: state.attachments.filter((_item, index) => index !== action.index) }, redraw()];
+        }
+        case 'composer-changed': {
+            if (head?.kind === 'question') {
+                if (head.custom === action.text)
+                    return [state, []];
+                return [{ ...state, decisions: [{ ...head, custom: action.text }, ...state.decisions.slice(1)] }, redraw()];
+            }
+            if (state.search !== undefined) {
+                const found = matches(state.cells, action.text);
+                const cursor = found.length === 0 ? 0 : Math.min(state.search.cursor, found.length - 1);
+                const index = found[cursor];
+                return [{
+                        ...state,
+                        search: { ...state.search, cursor, matches: found, query: action.text },
+                        ...(index === undefined ? {} : state.search.scope === 'history'
+                            ? { overlay: { cursor: index, expanded: false, kind: 'history' } }
+                            : { scrollOffset: Math.max(0, state.cells.length - 1 - index) }),
+                    }, redraw()];
+            }
+            if (action.text === state.composer && !state.exitArmed && !state.rewindArmed)
+                return [state, []];
+            const next = {
+                ...state, composer: action.text, exitArmed: false, recall: undefined, rewindArmed: false,
+            };
+            if (action.completion === true)
+                return [next, [
+                        { type: 'complete', caret: action.caret ?? action.text.length, query: action.text }, ...redraw(),
+                    ]];
+            if (state.overlay?.kind === 'list' && state.overlay.purpose === 'completion') {
+                const { overlay: _overlay, ...withoutOverlay } = next;
+                return [withoutOverlay, redraw()];
+            }
+            return [next, redraw()];
+        }
+        case 'composer-set':
+            return [{ ...state, composer: action.text, exitArmed: false, rewindArmed: false }, [
+                    { type: 'set-composer', text: action.text, ...(action.cursor === undefined ? {} : { cursor: action.cursor }) }, ...redraw(),
+                ]];
+        case 'clipboard-paste':
+            return head === undefined && state.overlay === undefined && state.search === undefined
+                ? [state, [{ type: 'clipboard-image' }]] : [state, []];
+        case 'ctrl-c': {
+            if (state.root?.status === 'running')
+                return [state, [{ type: 'interrupt' }]];
+            if (state.composer !== '' || state.attachments.length > 0) {
+                return [{
+                        ...state, attachments: [], composer: '', exitArmed: false, recall: undefined, rewindArmed: false,
+                    }, [{ type: 'set-composer', text: '' }, ...redraw()]];
+            }
+            if (state.exitArmed)
+                return reduce(state, { type: 'exit' });
+            return [{ ...state, exitArmed: true, rewindArmed: false }, [{ type: 'exit-timer', armed: true }, ...redraw()]];
+        }
+        case 'ctrl-d':
+            if (state.composer !== '')
+                return [state, []];
+            if (state.root?.status !== 'idle' || state.attachments.length > 0)
+                return reduce(state, { type: 'exit' });
+            return reduce(state, { type: 'ctrl-c' });
+        case 'decision-cancel': {
+            if (head === undefined)
+                return [state, []];
+            return head.kind === 'approval'
+                ? removeHead(state, { type: 'settle-decision', id: head.id, answer: 'cancelled' })
+                : removeHead(state, { type: 'reject-decision', id: head.id, reason: 'withdrawn' });
+        }
+        case 'decision-enqueued': {
+            if (state.decisions.some(decision => decision.id === action.decision.id))
+                return [state, []];
+            const decisions = [...state.decisions, action.decision];
+            const effects = [
+                ...(state.root?.status === 'running' ? [{ type: 'bell' }] : []),
+                ...(head === undefined ? [focusAfter(state, decisions), ...redraw()] : redraw()),
+            ];
+            const { overlay: _overlay, search: _search, ...withoutOverlay } = state;
+            return [{ ...withoutOverlay, decisions, exitArmed: false, rewindArmed: false }, effects];
+        }
+        case 'decision-move': {
+            if (head === undefined)
+                return [state, []];
+            const next = moveCursor(head, head.cursor + action.offset);
+            return [{ ...state, decisions: [next, ...state.decisions.slice(1)] }, redraw()];
+        }
+        case 'decision-number': {
+            if (head === undefined || action.number < 1)
+                return [state, []];
+            const next = moveCursor(head, action.number - 1);
+            return [{ ...state, decisions: [next, ...state.decisions.slice(1)] }, redraw()];
+        }
+        case 'decision-toggle': {
+            if (head?.kind !== 'question')
+                return [state, []];
+            const question = head.questions[head.index];
+            const option = question?.options[head.cursor];
+            if (question?.multiSelect !== true || option === undefined)
+                return [state, []];
+            const selected = head.selected.includes(option.label)
+                ? head.selected.filter(label => label !== option.label)
+                : [...head.selected, option.label];
+            return [{ ...state, decisions: [{ ...head, selected }, ...state.decisions.slice(1)] }, redraw()];
+        }
+        case 'decision-submit': {
+            if (head === undefined)
+                return [state, []];
+            if (head.kind === 'approval') {
+                const answer = head.cursor === 0 ? 'allowed-once' : head.cursor === 1 ? 'rejected' : 'cancelled';
+                return removeHead(state, { type: 'settle-decision', id: head.id, answer });
+            }
+            const question = head.questions[head.index];
+            if (question === undefined)
+                return [state, []];
+            const custom = head.cursor === question.options.length ? head.custom.trim() : undefined;
+            if (custom !== undefined && custom === '')
+                return [state, []];
+            const option = question.options[head.cursor];
+            const selected = question.multiSelect
+                ? head.selected.length === 0 && option !== undefined ? [option.label] : head.selected
+                : option === undefined ? [] : [option.label];
+            const answer = { id: question.id, selected, ...(custom === undefined ? {} : { custom }) };
+            const answers = [...head.answers, answer];
+            if (head.index + 1 < head.questions.length) {
+                const next = { ...head, answers, cursor: 0, custom: '', index: head.index + 1, selected: [] };
+                return [{ ...state, decisions: [next, ...state.decisions.slice(1)] }, [{ type: 'set-composer', text: '' }, ...redraw()]];
+            }
+            return removeHead(state, { type: 'settle-decision', id: head.id, answer: { answers } });
+        }
+        case 'decision-withdrawn': {
+            const index = state.decisions.findIndex(decision => decision.id === action.id);
+            if (index === -1)
+                return [state, []];
+            const decisions = state.decisions.filter(decision => decision.id !== action.id);
+            const effects = [{ type: 'reject-decision', id: action.id, reason: 'withdrawn' }];
+            if (index === 0)
+                effects.push(focusAfter(state, decisions), ...redraw());
+            return [{ ...state, decisions }, effects];
+        }
+        case 'disarm-exit':
+            return state.exitArmed || state.rewindArmed
+                ? [{ ...state, exitArmed: false, rewindArmed: false }, [
+                        { type: 'exit-timer', armed: false }, ...redraw(),
+                    ]] : [state, []];
+        case 'escape':
+            if (head !== undefined)
+                return reduce(state, { type: 'decision-cancel' });
+            if (state.search !== undefined)
+                return reduce(state, { type: 'search-close' });
+            if (state.overlay !== undefined)
+                return reduce(state, { type: 'overlay-close' });
+            if (state.root?.status === 'running') {
+                return [{ ...state, rewindArmed: false }, [{ type: 'interrupt' }]];
+            }
+            if (state.root !== undefined) {
+                if (state.rewindArmed) {
+                    if (state.composer !== '')
+                        return [{
+                                ...state, attachments: [], composer: '', prompts: [...state.prompts, state.composer],
+                                recall: undefined, rewindArmed: false,
+                            }, [{ type: 'set-composer', text: '' }, ...redraw()]];
+                    return [{ ...state, rewindArmed: false }, [
+                            { type: 'activate-overlay', value: { kind: 'open-rewind' } }, ...redraw(),
+                        ]];
+                }
+                return [{ ...state, rewindArmed: true }, redraw()];
+            }
+            return [state, []];
+        case 'exit': {
+            const effects = state.decisions.map(decision => ({ type: 'reject-decision', id: decision.id, reason: 'terminal' }));
+            return [{ ...state, decisions: [] }, [...effects, { type: 'exit' }]];
+        }
+        case 'external-edit':
+            return head === undefined && state.overlay === undefined && state.search === undefined
+                ? [state, [{ type: 'external-edit', cwd: state.root?.cwd ?? state.cwd, text: state.composer }]]
+                : [state, []];
+        case 'help':
+            return head === undefined
+                ? [{ ...state, overlay: help(), search: undefined, exitArmed: false, rewindArmed: false }, [
+                        ...(state.search === undefined ? [] : [{ type: 'set-composer', text: state.composer }]),
+                        ...redraw(),
+                    ]]
+                : [state, []];
+        case 'history-copy': {
+            if (state.overlay?.kind !== 'history')
+                return [state, []];
+            const cell = state.cells[state.overlay.cursor];
+            return cell === undefined ? [state, []] : [state, [{ type: 'copy', text: copyText(cell) }]];
+        }
+        case 'history-move': {
+            if (state.overlay?.kind !== 'history' || state.cells.length === 0)
+                return [state, []];
+            const cursor = Math.max(0, Math.min(state.cells.length - 1, state.overlay.cursor + action.offset));
+            const load = cursor === 0 && action.offset < 0 && state.historyHasMore && state.root !== undefined
+                ? [{ type: 'load-history', rootId: state.root.id }] : [];
+            return [{ ...state, overlay: { ...state.overlay, cursor, expanded: false } }, [...load, ...redraw()]];
+        }
+        case 'history-page': {
+            if (state.root?.id !== action.rootId)
+                return [state, []];
+            const added = Math.max(0, action.cells.length - state.cells.length);
+            let overlay = state.overlay?.kind === 'history'
+                ? { ...state.overlay, cursor: Math.max(0, added - 1) }
+                : state.overlay;
+            const search = refreshSearch(state.search, action.cells);
+            if (search?.scope === 'history' && overlay?.kind === 'history') {
+                overlay = { ...overlay, cursor: search.matches[search.cursor] ?? overlay.cursor };
+            }
+            return [{
+                    ...state, cells: action.cells, historyHasMore: action.hasMore,
+                    scrollOffset: action.cells.length === 0 ? 0 : action.cells.length - 1,
+                    ...(overlay === undefined ? {} : { overlay }),
+                    ...(search === undefined ? {} : { search }),
+                }, redraw()];
+        }
+        case 'history-toggle':
+            return state.overlay?.kind !== 'history' ? [state, []] : [{
+                    ...state, overlay: { ...state.overlay, expanded: !state.overlay.expanded },
+                }, redraw()];
+        case 'open-history':
+            return head !== undefined ? [state, []] : [{
+                    ...state, overlay: {
+                        cursor: Math.max(0, state.cells.length - 1), expanded: false, kind: 'history',
+                    }, search: undefined, exitArmed: false, rewindArmed: false,
+                }, redraw()];
+        case 'open-details': {
+            if (head !== undefined || state.root === undefined)
+                return [state, []];
+            const count = (state.root.jobs?.length ?? 0) + (state.root.subagents?.length ?? 0);
+            return count === 0 ? [state, []] : [{
+                    ...state, overlay: { cursor: 0, expanded: false, kind: 'details' },
+                    search: undefined, exitArmed: false, rewindArmed: false,
+                }, redraw()];
+        }
+        case 'completion-ready': {
+            if (head !== undefined || state.composer !== action.query)
+                return [state, []];
+            if (action.options.length === 0) {
+                if (state.overlay?.kind !== 'list' || state.overlay.purpose !== 'completion')
+                    return [state, []];
+                const { overlay: _overlay, ...withoutOverlay } = state;
+                return [withoutOverlay, redraw()];
+            }
+            return [{ ...state, overlay: {
+                        cursor: 0, kind: 'list', options: action.options, purpose: 'completion', title: 'Complete',
+                    } }, redraw()];
+        }
+        case 'open-overlay':
+            return head === undefined
+                ? [{ ...state, overlay: action.overlay, exitArmed: false, rewindArmed: false }, redraw()]
+                : [state, []];
+        case 'overlay-close': {
+            if (state.overlay === undefined)
+                return [state, []];
+            const { overlay: _overlay, ...withoutOverlay } = state;
+            return [withoutOverlay, redraw()];
+        }
+        case 'overlay-move': {
+            if (state.overlay === undefined)
+                return [state, []];
+            const count = (state.root?.jobs?.length ?? 0) + (state.root?.subagents?.length ?? 0);
+            const overlay = moveOverlay(state.overlay, state.overlay.kind === 'info' ? 0 : state.overlay.cursor + action.offset, count);
+            return overlay === state.overlay ? [state, []] : [{ ...state, overlay }, redraw()];
+        }
+        case 'overlay-number': {
+            if (state.overlay === undefined || state.overlay.kind === 'info' || action.number < 1)
+                return [state, []];
+            const count = (state.root?.jobs?.length ?? 0) + (state.root?.subagents?.length ?? 0);
+            return [{ ...state, overlay: moveOverlay(state.overlay, action.number - 1, count) }, redraw()];
+        }
+        case 'overlay-submit': {
+            const overlay = state.overlay;
+            if (overlay === undefined)
+                return [state, []];
+            if (overlay.kind === 'history')
+                return reduce(state, { type: 'history-toggle' });
+            if (overlay.kind === 'info')
+                return reduce(state, { type: 'overlay-close' });
+            if (overlay.kind === 'details')
+                return [{
+                        ...state, overlay: { ...overlay, expanded: !overlay.expanded },
+                    }, redraw()];
+            if (overlay.kind === 'confirm') {
+                if (overlay.cursor !== 0)
+                    return reduce(state, { type: 'overlay-close' });
+                const { overlay: _overlay, ...withoutOverlay } = state;
+                return [withoutOverlay, [{ type: 'activate-overlay', value: overlay.value }, ...redraw()]];
+            }
+            const option = overlay.options[overlay.cursor];
+            if (option === undefined)
+                return [state, []];
+            if (option.value.kind === 'insert') {
+                const { overlay: _overlay, ...withoutOverlay } = state;
+                if (action.execute === true && option.submitOnEnter === true) {
+                    return reduce({ ...withoutOverlay, composer: option.value.text.trimEnd() }, { type: 'submit' });
+                }
+                return [{ ...withoutOverlay, composer: option.value.text, recall: undefined }, [
+                        { type: 'set-composer', text: option.value.text }, ...redraw(),
+                    ]];
+            }
+            if (option.value.kind === 'attach') {
+                const { overlay: _overlay, ...withoutOverlay } = state;
+                return [withoutOverlay, [{
+                            type: 'attach', path: option.value.path, source: option.value.source, text: option.value.text,
+                        }, ...redraw()]];
+            }
+            if (option.value.kind === 'permission' && option.danger === true) {
+                return [{ ...state, overlay: {
+                            acceptLabel: 'Enable',
+                            cursor: 1,
+                            detail: option.confirmDetail ?? ['This preset disables approval prompts.'],
+                            kind: 'confirm',
+                            title: `Enable ${option.label}?`,
+                            value: option.value,
+                        } }, redraw()];
+            }
+            const { overlay: _overlay, ...withoutOverlay } = state;
+            return [withoutOverlay, [{ type: 'activate-overlay', value: option.value }, ...redraw()]];
+        }
+        case 'redraw': return [state, [{ type: 'redraw', force: true }]];
+        case 'prompt-recorded':
+            return state.root?.id !== action.rootId
+                ? [state, []] : [{ ...state, prompts: [...state.prompts, action.text], recall: undefined }, []];
+        case 'recall-move': {
+            if (state.prompts.length === 0)
+                return [state, []];
+            const current = state.recall?.cursor ?? state.prompts.length;
+            const cursor = Math.max(0, Math.min(state.prompts.length, current + action.offset));
+            const draft = state.recall?.draft ?? state.composer;
+            const text = cursor === state.prompts.length ? draft : state.prompts[cursor];
+            if (text === undefined)
+                return [state, []];
+            return [{
+                    ...state, composer: text,
+                    ...(cursor === state.prompts.length ? { recall: undefined } : { recall: { cursor, draft } }),
+                }, [{ type: 'set-composer', text }, ...redraw()]];
+        }
+        case 'request-completion':
+            return head === undefined && state.overlay === undefined && state.composer !== ''
+                ? [state, [{ type: 'complete', caret: action.caret, query: state.composer }]] : [state, []];
+        case 'request-search':
+            return head === undefined && state.overlay === undefined && state.root !== undefined
+                && state.composer.trim() !== ''
+                ? [state, [{ type: 'search', query: state.composer, rootId: state.root.id }]] : [state, []];
+        case 'scroll': {
+            if (state.cells.length === 0)
+                return [state, []];
+            const limit = state.cells.length - 1;
+            const scrollOffset = action.direction === 'end' ? 0
+                : action.direction === 'home' ? limit
+                    : Math.max(0, Math.min(limit, state.scrollOffset
+                        + (action.direction === 'page-up' ? 1 : -1) * (action.lines ?? PAGE_CELLS)));
+            const load = state.root !== undefined && state.historyHasMore
+                && (action.direction === 'home' || action.direction === 'page-up' && scrollOffset === limit)
+                ? [{ type: 'load-history', rootId: state.root.id }] : [];
+            return [{
+                    ...state, scrollOffset,
+                    ...(scrollOffset === 0 ? { newOutput: 0 } : {}),
+                }, [...load, ...redraw()]];
+        }
+        case 'search-close': {
+            if (state.search === undefined)
+                return [state, []];
+            const { search: _search, ...withoutSearch } = state;
+            return [withoutSearch, [{ type: 'set-composer', text: state.composer }, ...redraw()]];
+        }
+        case 'search-move': {
+            const search = state.search;
+            if (search === undefined || search.matches.length === 0)
+                return [state, []];
+            const cursor = (search.cursor + action.offset + search.matches.length) % search.matches.length;
+            const index = search.matches[cursor];
+            if (index === undefined)
+                return [state, []];
+            return [{
+                    ...state, search: { ...search, cursor },
+                    ...(search.scope === 'history'
+                        ? { overlay: { cursor: index, expanded: false, kind: 'history' } }
+                        : { scrollOffset: Math.max(0, state.cells.length - 1 - index) }),
+                }, redraw()];
+        }
+        case 'search-open': {
+            if (head !== undefined || action.scope === 'history' && state.overlay?.kind !== 'history')
+                return [state, []];
+            const found = matches(state.cells, '');
+            const next = { ...state, search: { cursor: 0, matches: found, query: '', scope: action.scope } };
+            if (action.scope === 'history')
+                return [next, [{ type: 'set-composer', text: '' }, ...redraw()]];
+            const { overlay: _overlay, ...withoutOverlay } = next;
+            return [withoutOverlay, [{ type: 'set-composer', text: '' }, ...redraw()]];
+        }
+        case 'suspend': return [state, [{ type: 'suspend' }]];
+        case 'stash-toggle': {
+            const current = { attachments: state.attachments, composer: state.composer, cursor: action.cursor };
+            if (state.stash === undefined) {
+                if (current.composer === '' && current.attachments.length === 0)
+                    return [state, []];
+                return [{ ...state, attachments: [], composer: '', stash: current }, [
+                        { type: 'set-composer', text: '' }, ...redraw(),
+                    ]];
+            }
+            const restored = state.stash;
+            if (current.composer === '' && current.attachments.length === 0) {
+                const { stash: _stash, ...withoutStash } = state;
+                return [{ ...withoutStash, attachments: restored.attachments, composer: restored.composer }, [
+                        { type: 'set-composer', text: restored.composer, cursor: restored.cursor }, ...redraw(),
+                    ]];
+            }
+            return [{
+                    ...state, attachments: restored.attachments, composer: restored.composer, stash: current,
+                }, [{ type: 'set-composer', text: restored.composer, cursor: restored.cursor }, ...redraw()]];
+        }
+        case 'terminal-lost':
+            return state.decisions.length === 0 ? [state, []] : [
+                { ...state, decisions: [] },
+                state.decisions.map(decision => ({ type: 'reject-decision', id: decision.id, reason: 'terminal' })),
+            ];
+        case 'cycle-permission':
+            if (head !== undefined)
+                return [state, []];
+            if (state.overlay === undefined)
+                return [state, [{ type: 'cycle-permission' }]];
+            {
+                const { overlay: _overlay, ...withoutOverlay } = state;
+                return [withoutOverlay, [{ type: 'cycle-permission' }]];
+            }
+        case 'toggle-send-mode': {
+            if (state.root?.status !== 'running')
+                return [state, []];
+            const sendMode = state.sendMode === 'steer' ? 'next-turn' : 'steer';
+            return [{ ...state, sendMode }, redraw()];
+        }
+        case 'toggle-tool-mode': {
+            const toolMode = state.toolMode === 'collapsed' ? 'expanded' : state.toolMode === 'expanded' ? 'hidden' : 'collapsed';
+            return [{ ...state, toolMode }, redraw()];
+        }
+        case 'turn-ended':
+            return state.root?.id === action.rootId && action.durationMs >= TURN_BELL_THRESHOLD_MS
+                ? [state, [{ type: 'bell' }]] : [state, []];
+        case 'submit': {
+            if (head !== undefined)
+                return reduce(state, { type: 'decision-submit' });
+            if (state.root === undefined || state.composer === '' && state.attachments.length === 0)
+                return [state, []];
+            const mode = state.root.status === 'running' ? state.sendMode : 'next-turn';
+            return [{
+                    ...state, attachments: [], composer: '', exitArmed: false, recall: undefined, rewindArmed: false,
+                }, [
+                    { type: 'set-composer', text: '' }, {
+                        type: 'submit', attachments: state.attachments, text: state.composer, mode,
+                    }, ...redraw(),
+                ]];
+        }
+        case 'root-bound':
+            {
+                const { overlay: _overlay, ...withoutOverlay } = state;
+                return [{
+                        ...withoutOverlay, cells: action.cells, historyHasMore: action.hasMore,
+                        newOutput: 0, prompts: action.prompts, recall: undefined,
+                        rewindArmed: false, root: action.root, scrollOffset: 0, search: undefined,
+                    }, redraw()];
+            }
+        case 'root-cleared': {
+            if (state.root === undefined)
+                return [state, []];
+            const { root: _root, ...withoutRoot } = state;
+            return [{
+                    ...withoutRoot, historyHasMore: false, newOutput: 0, prompts: [],
+                    recall: undefined, rewindArmed: false, scrollOffset: 0, search: undefined,
+                }, redraw()];
+        }
+        case 'root-model':
+            if (state.root?.id !== action.rootId)
+                return [state, []];
+            {
+                const { effort: _effort, ...root } = state.root;
+                return [{ ...state, root: {
+                            ...root,
+                            model: action.model,
+                            provider: action.provider,
+                            ...(action.effort === undefined ? {} : { effort: action.effort }),
+                        } }, redraw()];
+            }
+        case 'root-presentation': {
+            if (state.root?.id !== action.rootId)
+                return [state, []];
+            const { contextPercent: _contextPercent, ...root } = state.root;
+            const contextPercent = action.contextPercent === null
+                ? undefined
+                : action.contextPercent ?? state.root.contextPercent;
+            return [{ ...state, root: {
+                        ...root,
+                        ...(action.jobs === undefined && state.root.jobs === undefined ? {} : { jobs: action.jobs ?? state.root.jobs }),
+                        ...(action.subagents === undefined && state.root.subagents === undefined
+                            ? {} : { subagents: action.subagents ?? state.root.subagents }),
+                        ...(contextPercent === undefined ? {} : { contextPercent }),
+                    } }, redraw()];
+        }
+        case 'root-status':
+            return state.root?.id !== action.rootId || state.root.status === action.status
+                ? [state, []] : [{ ...state, root: { ...state.root, status: action.status } }, redraw()];
+        case 'root-permission':
+            return state.root?.id !== action.rootId || state.root.permission === action.preset
+                ? [state, []] : [{ ...state, root: { ...state.root, permission: action.preset } }, redraw()];
+        case 'root-title':
+            return state.root?.id !== action.rootId || state.root.title === action.title
+                ? [state, []] : [{ ...state, root: { ...state.root, title: action.title } }, redraw()];
+        case 'runtime-error':
+            if (action.rootId !== undefined && state.root?.id !== action.rootId)
+                return [state, []];
+            return [{
+                    ...state, cells: [...state.cells, {
+                            key: `runtime-error:${state.cells.length}`, kind: 'error', text: action.message,
+                        }],
+                    ...(state.scrollOffset === 0 ? {} : {
+                        newOutput: state.newOutput + 1, scrollOffset: state.scrollOffset + 1,
+                    }),
+                }, redraw()];
+        case 'transcript-changed': {
+            if (action.rootId !== undefined && state.root?.id !== action.rootId)
+                return [state, []];
+            const added = Math.max(0, action.cells.length - state.cells.length);
+            const search = refreshSearch(state.search, action.cells);
+            return [{
+                    ...state, cells: action.cells,
+                    ...(action.hasMore === undefined ? {} : { historyHasMore: action.hasMore }),
+                    ...(search === undefined ? {} : { search }),
+                    ...(state.scrollOffset === 0 ? { newOutput: 0 } : {
+                        newOutput: state.newOutput + 1, scrollOffset: state.scrollOffset + added,
+                    }),
+                }, redraw()];
+        }
+        case 'copy-latest': {
+            const cell = latestCompletedAssistant(state.cells);
+            return cell === undefined ? [state, []] : [state, [{ type: 'copy', text: cell.text }]];
+        }
+    }
+}

package/lib/terminal-guard.d.ts

@@ -0,0 +1,14 @@
+import { type Terminal } from '@earendil-works/pi-tui';
+export interface TerminalSession {
+    drainInput(): Promise<void>;
+    render(force: boolean): void;
+    start(): void;
+    stop(preserveScreen: boolean): void;
+}
+export interface TerminalGuard {
+    dispose(): Promise<void>;
+    start(): void;
+    withCookedTerminal(operation: () => Promise<void>): Promise<void>;
+}
+export declare function createProcessTerminal(onWheel?: (lines: number) => void): Terminal;
+export declare function createTerminalGuard(session: TerminalSession): TerminalGuard;