@rse/ase 2.0.1 → 2.0.3

package/dst/ase-statusline.js

@@ -14,10 +14,11 @@ import { Config, sessionState } from "./ase-config-core.js";
 import { configSchema } from "./ase-config-schema.js";
 import { parseScope, userStateDir, projectIdOf } from "./ase-config-scope.js";
 import { readStdin, writeStdout } from "./ase-lib-stdio.js";
+import { parseTool } from "./ase-setup-common.js";
 import pkg from "../package.json" with { type: "json" };
 /*  forced-color chalk instance: stdout is a pipe under Anthropic Claude Code CLI,
     so chalk auto-detection would yield level 0; force level 1 to keep
-    emitting ANSI sequences as the original implementation did  */
+    emitting ANSI sequences  */
 const c = new Chalk({ level: 1 });
 /*  set of valid <color>...</color> markup names (chalk basic foreground colors plus "default")  */
 const COLORS = new Set([
@@ -25,10 +26,9 @@ const COLORS = new Set([
 ]);
 /*  custom argument parser for Commander: non-negative integer  */
 const parseInteger = (name) => (value) => {
-    const n = Number.parseInt(value, 10);
-    if (!Number.isFinite(n) || n < 0)
+    if (!/^\d+$/.test(value))
         throw new InvalidArgumentError(`${name} must be a non-negative integer`);
-    return n;
+    return Number.parseInt(value, 10);
 };
 /*  detect terminal column width via /dev/tty (stdout is a pipe under Anthropic Claude Code CLI)  */
 const detectTermWidth = () => {
@@ -39,7 +39,7 @@ const detectTermWidth = () => {
         const out = execFileSync("tput", ["cols"], { stdio: [tty, "pipe", "ignore"] });
         width = Number.parseInt(out.toString("utf8").trim(), 10) || 0;
     }
-    catch (_e) {
+    catch {
         /*  no controlling terminal  */
     }
     finally {
@@ -47,7 +47,7 @@ const detectTermWidth = () => {
             try {
                 fs.closeSync(tty);
             }
-            catch (_e) {
+            catch {
                 /*  best-effort  */
             }
         }
@@ -141,12 +141,12 @@ const probeGit = (cwd) => {
             if (mDel !== null)
                 removed = Number.parseInt(mDel[1], 10);
         }
-        catch (_e) {
+        catch {
             /*  no HEAD yet or git failure; leave counts at 0  */
         }
         return { branch, untracked, added, removed };
     }
-    catch (_e) {
+    catch {
         return { branch: "", untracked: 0, added: 0, removed: 0 };
     }
 };
@@ -157,7 +157,7 @@ const probeMemory = () => {
         const free = os.freemem();
         return { used: total - free, total };
     }
-    catch (_e) {
+    catch {
         return { used: 0, total: 0 };
     }
 };
@@ -197,7 +197,7 @@ const fetchCodexLimits = async () => {
     try {
         cache = (JSON.parse(fs.readFileSync(cacheFile, "utf8")) ?? {});
     }
-    catch (_e) {
+    catch {
         /*  no (valid) cache yet  */
     }
     if (typeof cache.time === "number" && Math.abs(Date.now() - cache.time) < CODEX_USAGE_TTL)
@@ -205,7 +205,8 @@ const fetchCodexLimits = async () => {
     /*  query the usage endpoint (keeping the stale result on any failure)  */
     let limits = cache.limits;
     try {
-        const home = process.env.CODEX_HOME ?? path.join(os.homedir(), ".codex");
+        const dir = process.env.CODEX_HOME ?? "";
+        const home = dir !== "" ? dir : path.join(os.homedir(), ".codex");
         const auth = JSON.parse(fs.readFileSync(path.join(home, "auth.json"), "utf8"));
         const token = auth?.tokens?.access_token;
         if (typeof token === "string" && token !== "") {
@@ -233,7 +234,7 @@ const fetchCodexLimits = async () => {
             }
         }
     }
-    catch (_e) {
+    catch {
         /*  credential unreadable or endpoint unreachable  */
     }
     /*  update the cache  */
@@ -241,23 +242,166 @@ const fetchCodexLimits = async () => {
         fs.mkdirSync(path.dirname(cacheFile), { recursive: true });
         fs.writeFileSync(cacheFile, JSON.stringify({ time: Date.now(), limits }) + "\n", "utf8");
     }
-    catch (_e) {
+    catch {
         /*  best-effort  */
     }
     return limits;
 };
+/*  create the identifier to renderer map: each callback fetches its own information
+    directly from data (or via the lazy probes for shared values)  */
+const createRenderers = (ctx) => {
+    const { data, tool, limits, emit, prefix, getSession, getCfg, getModel, getGit, getMem } = ctx;
+    /*  render a configuration value (if non-empty) with its icon and label  */
+    const cfgValue = (key, icon, label) => () => {
+        const value = getCfg()[key];
+        if (value !== "")
+            emit(`${prefix(icon, label)}${c.bold(value)}`);
+    };
+    return {
+        /*  ==== SCOPE ====  */
+        u: () => {
+            const user = process.env.USER ?? process.env.LOGNAME ?? "unknown";
+            emit(`${prefix("※", "user")}${c.bold(user)}`);
+        },
+        p: () => {
+            const id = projectIdOf(data.workspace?.current_dir ?? "");
+            emit(`${prefix("⚑", "project")}${c.bold(id)}`);
+        },
+        T: cfgValue("taskId", "◉", "task"),
+        s: () => emit(`${prefix("⏻", "session")}${c.bold(getSession())}`),
+        /*  ==== MODEL ====  */
+        m: () => {
+            const { name } = getModel();
+            emit(`${prefix("⚙", "model")}${c.bold(name)}`);
+        },
+        e: () => {
+            const { effort } = getModel();
+            emit(`${prefix("⚒", "effort")}${c.bold(effort !== "" ? effort : "unknown")}`);
+        },
+        t: () => {
+            const thinking = data.thinking?.enabled === true ? "yes" : "no";
+            emit(`${prefix("⚛", "thinking")}${c.bold(thinking)}`);
+        },
+        /*  ==== OUTPUT ====  */
+        O: () => {
+            const styleName = data.output_style?.name ?? "";
+            if (styleName !== "")
+                emit(`${prefix("≡", "style")}${c.bold(styleName)}`);
+        },
+        P: cfgValue("persona", "☯", "persona"),
+        h: cfgValue("guidance", "▶", "guidance"),
+        B: cfgValue("boxing", "▢", "boxing"),
+        L: cfgValue("lifecycle", "⟳", "lifecycle"),
+        /*  ==== CONTEXT ====  */
+        c: () => {
+            const pct = Math.min(100, Math.max(0, Math.floor(data.context_window?.used_percentage ?? 0)));
+            const barSize = 20;
+            const filled = Math.round(pct / 100 * barSize);
+            const bar = "█".repeat(filled) + "░".repeat(barSize - filled);
+            emit(`${prefix("◔", "context")}${bar} ${pct}%`);
+        },
+        C: () => {
+            /*  probe the live-context fields first and fall back to the
+                cumulative ones, so each harness contributes its own view:
+                GitHub Copilot CLI reports the live window separately (its
+                "total_*" are session sums), whereas Anthropic Claude Code CLI
+                folds it into "total_input_tokens". Output tokens stay out --
+                "used_percentage" is input-side only.  */
+            const cw = data.context_window;
+            const pct = cw?.used_percentage ?? 0;
+            const tokensCur = cw?.current_context_tokens ??
+                cw?.last_call_input_tokens ?? cw?.total_input_tokens ?? 0;
+            const tokensLim = cw?.displayed_context_limit ?? cw?.context_window_size ??
+                (pct > 0 && tokensCur > 0 ? Math.round(tokensCur * 100 / pct) : 0);
+            if (tokensLim > 0)
+                emit(`${prefix("◆", "tokens")}${c.bold(formatTokens(tokensCur) + "/" + formatTokens(tokensLim))}`);
+        },
+        /*  ==== RATE LIMITS ====  */
+        S: () => {
+            const pct5h = limits?.five_hour?.used_percentage;
+            const s = pct5h !== undefined ? `${pct5h.toFixed(1)}%` : "-";
+            emit(`${prefix("⏲", "5h-usage")}${c.bold(s)}`);
+        },
+        D: () => {
+            const until5h = limits?.five_hour?.resets_at;
+            const s = formatTimeUntil(until5h);
+            emit(`${prefix("⏱", "5h-resets")}${c.bold(s !== "" ? s : "-")}`);
+        },
+        W: () => {
+            const pctWk = limits?.seven_day?.used_percentage;
+            const s = pctWk !== undefined ? `${pctWk.toFixed(1)}%` : "-";
+            emit(`${prefix("⏲", "7d-usage")}${c.bold(s)}`);
+        },
+        Q: () => {
+            const untilWk = limits?.seven_day?.resets_at;
+            const s = formatTimeUntil(untilWk);
+            emit(`${prefix("⏱", "7d-resets")}${c.bold(s !== "" ? s : "-")}`);
+        },
+        /*  ==== COSTS ====  */
+        H: () => {
+            const sessDurMs = data.cost?.total_duration_ms ?? 0;
+            if (sessDurMs > 0)
+                emit(`${prefix("⏱", "elapsed")}${c.bold(formatHoursMinutes(sessDurMs))}`);
+        },
+        X: () => {
+            const sessCost = data.cost?.total_cost_usd;
+            if (sessCost !== undefined)
+                emit(`${prefix("$", "cost")}${c.bold(formatCostUsd(sessCost))}`);
+        },
+        /*  ==== VERSION CONTROL ====  */
+        a: () => {
+            const linesAdded = data.cost?.total_lines_added ?? 0;
+            emit(`${prefix("⊕", "added")}${c.bold(String(linesAdded))}`);
+        },
+        r: () => {
+            const linesRemoved = data.cost?.total_lines_removed ?? 0;
+            emit(`${prefix("⊖", "removed")}${c.bold(String(linesRemoved))}`);
+        },
+        b: () => {
+            const g = getGit();
+            const label = g.branch !== "" ? g.branch : "no git";
+            emit(`${prefix("⎇", "branch")}${c.bold(label)}`);
+        },
+        g: () => {
+            const g = getGit();
+            if (g.branch !== "")
+                emit(`${prefix("±", "changed")}${c.bold(`+${g.added}/-${g.removed}`)}`);
+        },
+        G: () => {
+            const g = getGit();
+            if (g.branch !== "")
+                emit(`${prefix("⁈", "untracked")}${c.bold(String(g.untracked))}`);
+        },
+        d: () => {
+            const cwd = data.workspace?.current_dir ?? "";
+            if (cwd !== "")
+                emit(`${prefix("▶", "cwd")}${c.bold(cwd)}`);
+        },
+        /*  ==== RESOURCES ====  */
+        M: () => {
+            const m = getMem();
+            if (m.total > 0)
+                emit(`${prefix("⛁", "mem")}${c.bold(`${formatBytes(m.used)}/${formatBytes(m.total)}`)}`);
+        },
+        /*  ==== VERSIONS ====  */
+        V: () => {
+            const toolVersion = data.version ?? "";
+            const aseVersion = pkg.version ?? "";
+            let version = "";
+            if (toolVersion !== "")
+                version += `${tool}/${toolVersion}`;
+            if (aseVersion !== "")
+                version += `${version !== "" ? " " : ""}ase/${aseVersion}`;
+            emit(`${prefix("⎈", "version")}${c.bold(version)}`);
+        }
+    };
+};
 /*  command-line handling  */
 export default class StatuslineCommand {
     log;
     constructor(log) {
         this.log = log;
     }
-    /*  parse and validate the --tool option  */
-    parseTool(value) {
-        if (value !== "claude" && value !== "copilot" && value !== "codex")
-            throw new InvalidArgumentError(`invalid --tool value: "${value}" (expected "claude", "copilot", or "codex")`);
-        return value;
-    }
     /*  register commands  */
     register(program) {
         /*  default for --tool derived from ASE_TOOL environment variable
@@ -280,7 +424,7 @@ export default class StatuslineCommand {
             "(default: single line \"%m %e %t\")")
             .action(async (lines, opts) => {
             /*  validate target tool  */
-            const tool = this.parseTool(opts.tool);
+            const tool = parseTool(opts.tool);
             /*  OpenAI Codex CLI has no scriptable custom statusline
                 mechanism, so reject the request explicitly  */
             if (tool === "codex")
@@ -361,7 +505,7 @@ export default class StatuslineCommand {
                     boxing = get("project.boxing", boxing);
                     lifecycle = get("project.task.lifecycle", lifecycle);
                 }
-                catch (_e) {
+                catch {
                     /*  cascade unavailable; keep env-var fallbacks  */
                 }
                 try {
@@ -369,7 +513,7 @@ export default class StatuslineCommand {
                     state.read("lenient");
                     taskId = String(state.get("task") ?? "").trim() || taskId;
                 }
-                catch (_e) {
+                catch {
                     /*  session state unavailable; keep env-var fallback  */
                 }
                 return { taskId, persona, guidance, boxing, lifecycle };
@@ -392,152 +536,8 @@ export default class StatuslineCommand {
                 && /^gpt-.+/i.test(getModel().name)
                 && tmpl.some((line) => /%[SDWQ]/.test(line)))
                 limits = await fetchCodexLimits();
-            /*  render a configuration value (if non-empty) with its icon and label  */
-            const cfgValue = (key, icon, label) => () => {
-                const value = getCfg()[key];
-                if (value !== "")
-                    emit(`${prefix(icon, label)}${c.bold(value)}`);
-            };
-            /*  identifier to renderer map: each callback fetches its own information
-                directly from data (or via the lazy helpers above for shared values)  */
-            const renderers = {
-                /*  ==== SCOPE ====  */
-                u: () => {
-                    const user = process.env.USER ?? process.env.LOGNAME ?? "unknown";
-                    emit(`${prefix("※", "user")}${c.bold(user)}`);
-                },
-                p: () => {
-                    const id = projectIdOf(data.workspace?.current_dir ?? "");
-                    emit(`${prefix("⚑", "project")}${c.bold(id)}`);
-                },
-                T: cfgValue("taskId", "◉", "task"),
-                s: () => emit(`${prefix("⏻", "session")}${c.bold(getSession())}`),
-                /*  ==== MODEL ====  */
-                m: () => {
-                    const { name } = getModel();
-                    emit(`${prefix("⚙", "model")}${c.bold(name)}`);
-                },
-                e: () => {
-                    const { effort } = getModel();
-                    emit(`${prefix("⚒", "effort")}${c.bold(effort !== "" ? effort : "unknown")}`);
-                },
-                t: () => {
-                    const thinking = data.thinking?.enabled === true ? "yes" : "no";
-                    emit(`${prefix("⚛", "thinking")}${c.bold(thinking)}`);
-                },
-                /*  ==== OUTPUT ====  */
-                O: () => {
-                    const styleName = data.output_style?.name ?? "";
-                    if (styleName !== "")
-                        emit(`${prefix("≡", "style")}${c.bold(styleName)}`);
-                },
-                P: cfgValue("persona", "☯", "persona"),
-                h: cfgValue("guidance", "▶", "guidance"),
-                B: cfgValue("boxing", "▢", "boxing"),
-                L: cfgValue("lifecycle", "⟳", "lifecycle"),
-                /*  ==== CONTEXT ====  */
-                c: () => {
-                    const pct = Math.min(100, Math.max(0, Math.floor(data.context_window?.used_percentage ?? 0)));
-                    const barSize = 20;
-                    const filled = Math.round(pct / 100 * barSize);
-                    const bar = "█".repeat(filled) + "░".repeat(barSize - filled);
-                    emit(`${prefix("◔", "context")}${bar} ${pct}%`);
-                },
-                C: () => {
-                    /*  probe the live-context fields first and fall back to the
-                        cumulative ones, so each harness contributes its own view:
-                        GitHub Copilot CLI reports the live window separately (its
-                        "total_*" are session sums), whereas Anthropic Claude Code CLI
-                        folds it into "total_input_tokens". Output tokens stay out --
-                        "used_percentage" is input-side only.  */
-                    const cw = data.context_window;
-                    const pct = cw?.used_percentage ?? 0;
-                    const tokensCur = cw?.current_context_tokens ??
-                        cw?.last_call_input_tokens ?? cw?.total_input_tokens ?? 0;
-                    const tokensLim = cw?.displayed_context_limit ?? cw?.context_window_size ??
-                        (pct > 0 && tokensCur > 0 ? Math.round(tokensCur * 100 / pct) : 0);
-                    if (tokensLim > 0)
-                        emit(`${prefix("◆", "tokens")}${c.bold(formatTokens(tokensCur) + "/" + formatTokens(tokensLim))}`);
-                },
-                /*  ==== RATE LIMITS ====  */
-                S: () => {
-                    const pct5h = limits?.five_hour?.used_percentage;
-                    const s = pct5h !== undefined ? `${pct5h.toFixed(1)}%` : "-";
-                    emit(`${prefix("⏲", "5h-usage")}${c.bold(s)}`);
-                },
-                D: () => {
-                    const until5h = limits?.five_hour?.resets_at;
-                    const s = formatTimeUntil(until5h);
-                    emit(`${prefix("⏱", "5h-resets")}${c.bold(s !== "" ? s : "-")}`);
-                },
-                W: () => {
-                    const pctWk = limits?.seven_day?.used_percentage;
-                    const s = pctWk !== undefined ? `${pctWk.toFixed(1)}%` : "-";
-                    emit(`${prefix("⏲", "7d-usage")}${c.bold(s)}`);
-                },
-                Q: () => {
-                    const untilWk = limits?.seven_day?.resets_at;
-                    const s = formatTimeUntil(untilWk);
-                    emit(`${prefix("⏱", "7d-resets")}${c.bold(s !== "" ? s : "-")}`);
-                },
-                /*  ==== COSTS ====  */
-                H: () => {
-                    const sessDurMs = data.cost?.total_duration_ms ?? 0;
-                    if (sessDurMs > 0)
-                        emit(`${prefix("⏱", "elapsed")}${c.bold(formatHoursMinutes(sessDurMs))}`);
-                },
-                X: () => {
-                    const sessCost = data.cost?.total_cost_usd;
-                    if (sessCost !== undefined)
-                        emit(`${prefix("$", "cost")}${c.bold(formatCostUsd(sessCost))}`);
-                },
-                /*  ==== VERSION CONTROL ====  */
-                a: () => {
-                    const linesAdded = data.cost?.total_lines_added ?? 0;
-                    emit(`${prefix("⊕", "added")}${c.bold(String(linesAdded))}`);
-                },
-                r: () => {
-                    const linesRemoved = data.cost?.total_lines_removed ?? 0;
-                    emit(`${prefix("⊖", "removed")}${c.bold(String(linesRemoved))}`);
-                },
-                b: () => {
-                    const g = getGit();
-                    const label = g.branch !== "" ? g.branch : "no git";
-                    emit(`${prefix("⎇", "branch")}${c.bold(label)}`);
-                },
-                g: () => {
-                    const g = getGit();
-                    if (g.branch !== "")
-                        emit(`${prefix("±", "changed")}${c.bold(`+${g.added}/-${g.removed}`)}`);
-                },
-                G: () => {
-                    const g = getGit();
-                    if (g.branch !== "")
-                        emit(`${prefix("⁈", "untracked")}${c.bold(String(g.untracked))}`);
-                },
-                d: () => {
-                    const cwd = data.workspace?.current_dir ?? "";
-                    if (cwd !== "")
-                        emit(`${prefix("▶", "cwd")}${c.bold(cwd)}`);
-                },
-                /*  ==== RESOURCES ====  */
-                M: () => {
-                    const m = getMem();
-                    if (m.total > 0)
-                        emit(`${prefix("⛁", "mem")}${c.bold(`${formatBytes(m.used)}/${formatBytes(m.total)}`)}`);
-                },
-                /*  ==== VERSIONS ====  */
-                V: () => {
-                    const toolVersion = data.version ?? "";
-                    const aseVersion = pkg.version ?? "";
-                    let version = "";
-                    if (toolVersion !== "")
-                        version += `${tool}/${toolVersion}`;
-                    if (aseVersion !== "")
-                        version += `${version !== "" ? " " : ""}ase/${aseVersion}`;
-                    emit(`${prefix("⎈", "version")}${c.bold(version)}`);
-                }
-            };
+            /*  identifier to renderer map (see "createRenderers")  */
+            const renderers = createRenderers({ data, tool, limits, emit, prefix, getSession, getCfg, getModel, getGit, getMem });
             /*  walk each template line and render  */
             const closeSpan = () => {
                 span = null;
@@ -579,8 +579,8 @@ export default class StatuslineCommand {
             if (opts.padding > 0) {
                 const pad = " ".repeat(opts.padding);
                 out = out.split("\n").map((line) => line !== "" ? `${pad}${line}${pad}` : line).join("\n");
-                /*  for Copilot, prefix with a zero-width non-breaking space
-                    to prevent the first line to be unindented  */
+                /*  for Copilot, prefix with a zero-width space
+                    to prevent the first line from being unindented  */
                 if (tool === "copilot")
                     out = "\u200B" + out;
             }

package/dst/ase-task-board-core.js

@@ -187,7 +187,7 @@ export class BoardState {
             state[surface][flag] = !state[surface][flag];
         });
     }
-    /*  set the shown view (lanes, graph, stats, or agents)  */
+    /*  set the shown view (lanes, graph, stats, agents, or flow)  */
     static setView(surface, view) {
         return BoardState.update((state) => {
             state[surface].view = view;

package/dst/ase-task-board-flow.js

@@ -133,12 +133,13 @@ const cardName = (card) => card.agents.length > 1 ? `${card.name} ×${card.agent
 /*  remove control characters from a text of the agent relay  */
 const clean = (text) => text.replace(/\p{Cc}/gu, "");
 /*  draw a cell-unit layout of the agent graph onto a character grid, returning per cell the
-    character and a tone for coloring (like the task graph): the state nodes in tone "done" (or "sel"), the
-    agent cards in tone "active" (busy), "idle" (waiting), or "sel" (selected, with a heavy border, like
-    a selected state), with the name of
-    the agent inverse on their first line, followed by their field lines (with the tone suffix
-    "-title" on the labels, "-value" on their bold values, and the busy task ids inverse), and the given pulse glyph (else a filled
-    circle) of a busy card, resp. an empty circle of a waiting one, in the right part of their top border  */
+    character and a tone for coloring (like the task graph): the state nodes in tone "done"
+    (or "sel"), the agent cards in tone "active" (busy), "idle" (waiting), or "sel" (selected,
+    with a heavy border, like a selected state), with the name of the agent inverse on their
+    first line, followed by their field lines (with the tone suffix "-title" on the labels,
+    "-value" on their bold values, and the busy task ids inverse), and the given pulse glyph
+    (else a filled circle) of a busy card, resp. an empty circle of a waiting one, in the
+    right part of their top border  */
 export const drawFlowText = (flow, layout, selected, pulse = "", beat = () => false) => {
     const g = textGrid(layout);
     const { W, H, chars, tones } = g;

package/dst/ase-task-board-graph.js

@@ -20,10 +20,11 @@ export const units = {
 /*  the id prefix of the compound node of a group (task ids never contain a colon)  */
 const GROUP = "group:";
 /*  the label lines of a node (in cell units only) of a given box width: the
-    task id (behind "≡", and of an epic also behind "♛") and title, cut onto a single line, or with titles shown, wrapped
-    onto at most three lines, with a placeholder column glued in front of
-    the task id to reserve the extra column of its inverse rendering (plus two for
-    the "≡", and two more for the "♛" of an epic), and the arrow in front of the title replaced by a placeholder
+    task id (behind "≡", and of an epic also behind "♛") and title, cut onto a
+    single line, or with titles shown, wrapped onto at most three lines, with a
+    placeholder column glued in front of the task id to reserve the extra column
+    of its inverse rendering (plus two for the "≡", and two more for the "♛" of
+    an epic), and the arrow in front of the title replaced by a placeholder
     column glued to the title  */
 export const nodeLines = (board, id, titles, width) => {
     const card = board.cards.get(id);

package/dst/ase-task-board-tui-control.js

@@ -281,14 +281,13 @@ export const handleMouse = (ctx, btn, mx, my) => {
             setDialog({ id: hit, tab: 0, first: 0, scrolls: {} });
     }
 };
-/*  handle a key press onto the deletion confirmation, the transfer popup, the assign
-    popup, the prompt popup, or the filter field (outside of the read dialog)  */
-const handlePopupKey = (ctx, input, key) => {
-    const { dialog, setFilter, typing, setTyping, setNotice, confirm, setConfirm, transfer, setTransfer, transferList, remove, transferTo, assign, setAssign, assignTo, prompt, setPrompt, cancelPrompt, submitPrompt } = ctx;
+/*  handle a key press onto the prompt popup  */
+const handlePromptKey = (ctx, prompt, input, key) => {
+    const { setPrompt, cancelPrompt, submitPrompt } = ctx;
     /*  operate the prompt popup: TAB resp. Shift+TAB switch the focus to the next resp.
         previous field (the request name of a request by prompt, the prompt unless ignored, and
         the request and cancel buttons), and ESC cancels in every field  */
-    if (prompt !== null && (key.tab || key.escape)) {
+    if (key.tab || key.escape) {
         if (key.escape)
             cancelPrompt();
         else {
@@ -301,7 +300,7 @@ const handlePopupKey = (ctx, input, key) => {
     }
     /*  press the focused button of the prompt popup: RETURN (or SPACE) presses it,
         and the left/right arrows switch between the request and cancel buttons  */
-    if (prompt !== null && (prompt.focus === "request" || prompt.focus === "cancel")) {
+    if (prompt.focus === "request" || prompt.focus === "cancel") {
         if ((key.return || input === " ") && prompt.focus === "request")
             submitPrompt();
         else if (key.return || input === " ")
@@ -310,17 +309,7 @@ const handlePopupKey = (ctx, input, key) => {
             setPrompt({ ...prompt, focus: prompt.focus === "request" ? "cancel" : "request" });
         return;
     }
-    /*  type the prompt of an edit request: RETURN requests the edit, Shift+RETURN
-        (under the kitty keyboard protocol only), Alt+RETURN (under the kitty keyboard
-        protocol, or where the terminal sends it as ESC+RETURN, e.g. with "Option as Meta"
-        on macOS), and Ctrl+J (in every terminal, as a plain linefeed without the kitty
-        keyboard protocol) insert a newline,
-        the left/right arrows move the cursor by one character, HOME/END move it
-        to the start/end, BACKSPACE removes the character before the cursor, DELETE
-        removes the character at the cursor, and all other input (also pasted text,
-        with its newlines kept and its other control characters turned into spaces)
-        is inserted at the cursor  */
-    if (prompt !== null && prompt.request !== null && prompt.focus === "name") {
+    if (prompt.request !== null && prompt.focus === "name") {
         /*  type the request name of a request by prompt: RETURN switches to the prompt (resp. to
             the request button if the prompt is ignored), the
             up/down arrows cycle through the suggested request names of the drop-down (matching
@@ -342,36 +331,53 @@ const handlePopupKey = (ctx, input, key) => {
             name(request.name + input.toLowerCase());
         return;
     }
-    if (prompt !== null) {
-        const chars = [...prompt.text];
-        const pos = Math.max(0, Math.min(prompt.pos, chars.length));
-        const insert = (text) => {
-            const ins = [...text];
-            chars.splice(pos, 0, ...ins);
-            setPrompt({ ...prompt, text: chars.join(""), pos: pos + ins.length });
-        };
-        if ((key.return && (key.shift || key.meta)) || (key.ctrl && input === "j"))
-            insert("\n");
-        else if (key.return)
-            submitPrompt();
-        else if (key.leftArrow || key.rightArrow)
-            setPrompt({ ...prompt, pos: Math.max(0, Math.min(chars.length, pos + (key.leftArrow ? -1 : 1))) });
-        else if (key.home || key.end)
-            setPrompt({ ...prompt, pos: key.home ? 0 : chars.length });
-        else if (key.backspace) {
-            if (pos > 0) {
-                chars.splice(pos - 1, 1);
-                setPrompt({ ...prompt, text: chars.join(""), pos: pos - 1 });
-            }
+    /*  type the prompt of an edit request: RETURN requests the edit, Shift+RETURN
+        (under the kitty keyboard protocol only), Alt+RETURN (under the kitty keyboard
+        protocol, or where the terminal sends it as ESC+RETURN, e.g. with "Option as Meta"
+        on macOS), and Ctrl+J (in every terminal, as a plain linefeed without the kitty
+        keyboard protocol) insert a newline,
+        the left/right arrows move the cursor by one character, HOME/END move it
+        to the start/end, BACKSPACE removes the character before the cursor, DELETE
+        removes the character at the cursor, and all other input (also pasted text,
+        with its newlines kept and its other control characters turned into spaces)
+        is inserted at the cursor  */
+    const chars = [...prompt.text];
+    const pos = Math.max(0, Math.min(prompt.pos, chars.length));
+    const insert = (text) => {
+        const ins = [...text];
+        chars.splice(pos, 0, ...ins);
+        setPrompt({ ...prompt, text: chars.join(""), pos: pos + ins.length });
+    };
+    if ((key.return && (key.shift || key.meta)) || (key.ctrl && input === "j"))
+        insert("\n");
+    else if (key.return)
+        submitPrompt();
+    else if (key.leftArrow || key.rightArrow)
+        setPrompt({ ...prompt, pos: Math.max(0, Math.min(chars.length, pos + (key.leftArrow ? -1 : 1))) });
+    else if (key.home || key.end)
+        setPrompt({ ...prompt, pos: key.home ? 0 : chars.length });
+    else if (key.backspace) {
+        if (pos > 0) {
+            chars.splice(pos - 1, 1);
+            setPrompt({ ...prompt, text: chars.join(""), pos: pos - 1 });
         }
-        else if (key.delete) {
-            if (pos < chars.length) {
-                chars.splice(pos, 1);
-                setPrompt({ ...prompt, text: chars.join(""), pos });
-            }
+    }
+    else if (key.delete) {
+        if (pos < chars.length) {
+            chars.splice(pos, 1);
+            setPrompt({ ...prompt, text: chars.join(""), pos });
         }
-        else if (!key.ctrl && !key.meta && input !== "")
-            insert(input.replace(/\r\n?/g, "\n").replace(/[^\P{Cc}\n]/gu, " "));
+    }
+    else if (!key.ctrl && !key.meta && input !== "")
+        insert(input.replace(/\r\n?/g, "\n").replace(/[^\P{Cc}\n]/gu, " "));
+};
+/*  handle a key press onto the deletion confirmation, the transfer popup, the assign
+    popup, the prompt popup, or the filter field (outside of the read dialog)  */
+const handlePopupKey = (ctx, input, key) => {
+    const { dialog, setFilter, typing, setTyping, setNotice, confirm, setConfirm, transfer, setTransfer, transferList, remove, transferTo, assign, setAssign, assignTo, prompt } = ctx;
+    /*  operate the prompt popup  */
+    if (prompt !== null) {
+        handlePromptKey(ctx, prompt, input, key);
         return;
     }
     /*  answer the confirmation of a task deletion: "y" deletes, ESC cancels, the