@mrciphersmith/keryx 0.2.115 → 0.2.117

package/dist/cli.js

@@ -50252,7 +50252,7 @@ import path47 from "path";
 // package.json
 var package_default = {
   name: "@mrciphersmith/keryx",
-  version: "0.2.115",
+  version: "0.2.117",
   description: "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
   private: false,
   publishConfig: {
@@ -82502,8 +82502,6 @@ function realSpawner() {
       env,
       detached: true
     });
-    let dataCb;
-    let exitCb;
     let netClosed = false;
     const closeNetOnce = async () => {
       if (netClosed)
@@ -82511,43 +82509,81 @@ function realSpawner() {
       netClosed = true;
       await netClose();
     };
-    const outDecoder = new TextDecoder;
-    const errDecoder = new TextDecoder;
-    const pump = async (stream, kind, decoder) => {
-      if (stream === undefined)
-        return;
-      const reader = stream.getReader();
-      try {
-        for (;; ) {
-          const chunk = await reader.read();
-          if (chunk.done)
-            break;
-          if (chunk.value !== undefined)
-            dataCb?.(decoder.decode(chunk.value, { stream: true }), kind);
-        }
-      } catch {} finally {
-        reader.releaseLock();
-      }
-    };
-    Promise.all([pump(proc.stdout, "stdout", outDecoder), pump(proc.stderr, "stderr", errDecoder)]);
-    proc.exited.then(async (exitCode) => {
-      exitCb?.({ exitCode });
-      await closeNetOnce();
-    });
-    return {
-      pid: proc.pid,
-      onOutput: (cb) => {
-        dataCb = cb;
-      },
-      onExit: (cb) => {
-        exitCb = cb;
-      },
+    return superviseSpawnedProcess(proc, {
       kill: (signal) => {
         try {
           process.kill(-proc.pid, signal);
         } catch {}
+      },
+      afterExit: closeNetOnce
+    });
+  };
+}
+var EXIT_OUTPUT_DRAIN_MS = 2000;
+function superviseSpawnedProcess(proc, opts) {
+  const drainMs = opts.drainMs ?? EXIT_OUTPUT_DRAIN_MS;
+  let dataCb;
+  let exitCb;
+  const pendingChunks = [];
+  let pendingExit;
+  const emitData = (chunk, stream) => {
+    if (dataCb === undefined)
+      pendingChunks.push({ chunk, stream });
+    else
+      dataCb(chunk, stream);
+  };
+  const outDecoder = new TextDecoder;
+  const errDecoder = new TextDecoder;
+  const pump = async (stream, kind, decoder) => {
+    if (stream === undefined)
+      return;
+    const reader = stream.getReader();
+    try {
+      for (;; ) {
+        const chunk = await reader.read();
+        if (chunk.done)
+          break;
+        if (chunk.value !== undefined)
+          emitData(decoder.decode(chunk.value, { stream: true }), kind);
       }
-    };
+    } catch {} finally {
+      reader.releaseLock();
+    }
+  };
+  const drained = Promise.all([
+    pump(proc.stdout, "stdout", outDecoder),
+    pump(proc.stderr, "stderr", errDecoder)
+  ]);
+  proc.exited.then(async (exitCode) => {
+    let timer;
+    await Promise.race([
+      drained,
+      new Promise((resolve) => {
+        timer = setTimeout(resolve, drainMs);
+        timer.unref?.();
+      })
+    ]);
+    if (timer !== undefined)
+      clearTimeout(timer);
+    if (exitCb === undefined)
+      pendingExit = { exitCode };
+    else
+      exitCb({ exitCode });
+    await opts.afterExit?.();
+  });
+  return {
+    pid: proc.pid,
+    onOutput: (cb) => {
+      dataCb = cb;
+      for (const { chunk, stream } of pendingChunks.splice(0))
+        cb(chunk, stream);
+    },
+    onExit: (cb) => {
+      exitCb = cb;
+      if (pendingExit !== undefined)
+        cb(pendingExit);
+    },
+    kill: opts.kill
   };
 }
 function createJobRegistry(options) {
@@ -88889,7 +88925,6 @@ function createBlockNavController(options) {
   const schedule = options.schedule ?? ((run) => void setTimeout(run, 0));
   const onChange = options.onChange ?? (() => {});
   let focusOwner = "composer";
-  let savedScrollTop = 0;
   const active = () => focusOwner === "blocks";
   const paint = (id) => {
     const state = registry.get(id);
@@ -88977,7 +89012,6 @@ function createBlockNavController(options) {
     }
     focusOwner = "blocks";
     registry.focus(target.id);
-    savedScrollTop = scroll.scrollTop;
     scroll.stickyScroll = false;
     blurComposer();
     paintAll();
@@ -88990,8 +89024,12 @@ function createBlockNavController(options) {
     }
     focusOwner = "composer";
     paintAll();
-    scroll.scrollTop = savedScrollTop;
-    scroll.stickyScroll = true;
+    if (typeof scroll.scrollHeight === "number" && typeof scroll.height === "number") {
+      const atBottom = scroll.scrollTop >= scroll.scrollHeight - scroll.height - 3;
+      scroll.stickyScroll = atBottom;
+    } else {
+      scroll.stickyScroll = true;
+    }
     focusComposer();
     onChange();
   };
@@ -89073,7 +89111,7 @@ function onKeypress(r, handler) {
 }
 var BACKDROP_ID = "modal-backdrop";
 var PANEL_ID = "modal-panel";
-var BACKDROP_ALPHA = 0.85;
+var BACKDROP_ALPHA = 1;
 function backdropFillColor(otui) {
   const color = otui.RGBA.fromHex(getTheme().bg);
   color.a = BACKDROP_ALPHA;
@@ -89084,13 +89122,23 @@ var MODAL_PANEL_CHROME_X = 4;
 var MODAL_PANEL_MIN_WIDTH = 72;
 var MODAL_PANEL_MIN_HEIGHT = 18;
 var MODAL_PANEL_SIZE_RATIO = 0.95;
+var MODAL_PANEL_MAX_HEIGHT_RATIO = 0.85;
 var MODAL_CHROME_ROWS = 5;
 var MODAL_PANEL_WIDTH = MODAL_PANEL_MIN_WIDTH;
 var MODAL_PANEL_HEIGHT = MODAL_PANEL_MIN_HEIGHT;
 var MODAL_PANEL_INNER_WIDTH = MODAL_PANEL_MIN_WIDTH - MODAL_PANEL_CHROME_X;
-function resolveModalPanelSize(cols, rows) {
+function resolveModalPanelSize(cols, rows, contentRows) {
+  const width = Math.max(MODAL_PANEL_MIN_WIDTH, Math.round(cols * MODAL_PANEL_SIZE_RATIO));
+  if (contentRows !== undefined) {
+    const maxHeight = Math.max(6, Math.round(rows * MODAL_PANEL_MAX_HEIGHT_RATIO));
+    const needed = Math.max(6, contentRows + MODAL_CHROME_ROWS);
+    return {
+      width,
+      height: Math.min(maxHeight, needed)
+    };
+  }
   return {
-    width: Math.max(MODAL_PANEL_MIN_WIDTH, Math.round(cols * MODAL_PANEL_SIZE_RATIO)),
+    width,
     height: Math.max(MODAL_PANEL_MIN_HEIGHT, Math.round(rows * MODAL_PANEL_SIZE_RATIO))
   };
 }
@@ -89098,6 +89146,19 @@ function modalBodyRows(panelHeight) {
   return Math.max(1, panelHeight - MODAL_CHROME_ROWS);
 }
 var CLOSE_HINT = "[x] esc";
+var UNMEASURED_SIDEBAR_WIDTH = 30;
+function resolveModalAvailableWidth(chrome) {
+  const rWidth = chrome.renderer.width;
+  const mainWidth = chrome.main?.width ?? 0;
+  if (mainWidth > 0) {
+    return Math.min(rWidth, mainWidth);
+  }
+  if (chrome.sidebar !== undefined) {
+    const sidebarWidth = chrome.sidebar.width > 0 ? chrome.sidebar.width : UNMEASURED_SIDEBAR_WIDTH;
+    return Math.max(20, rWidth - sidebarWidth);
+  }
+  return rWidth;
+}
 function resolveModalInnerWidth(availableWidth) {
   return Math.max(20, availableWidth - MODAL_PANEL_CHROME_X);
 }
@@ -89181,9 +89242,11 @@ function mountTab(state, input, tabId) {
   unmountActiveTab(state);
   state.active = tabId;
   paintTabs(state);
-  const size = resolveModalPanelSize(state.chrome.renderer.width, state.chrome.renderer.height);
+  const availWidth = resolveModalAvailableWidth(state.chrome);
+  const size = resolveModalPanelSize(availWidth, state.chrome.renderer.height, input.contentRows);
+  const panelWidth = Math.min(availWidth, size.width);
   const cleanup = input.renderTab(tabId, state.body, {
-    width: resolveModalInnerWidth(size.width),
+    width: resolveModalInnerWidth(panelWidth),
     height: modalBodyRows(size.height)
   });
   state.tabCleanup = typeof cleanup === "function" ? cleanup : undefined;
@@ -89305,7 +89368,8 @@ function ensureHost(otui, chrome) {
   panel.add(scroll);
   panel.add(footer);
   backdrop.add(panel);
-  r.root.add(backdrop);
+  const mountTarget = chrome.main ?? r.root;
+  mountTarget.add(backdrop);
   const state = {
     otui,
     chrome,
@@ -89425,8 +89489,9 @@ function openModal(otui, chrome, input) {
     return;
   }
   const state = ensureHost(otui, chrome);
-  const size = resolveModalPanelSize(chrome.renderer.width, chrome.renderer.height);
-  state.panel.width = size.width;
+  const availWidth = resolveModalAvailableWidth(chrome);
+  const size = resolveModalPanelSize(availWidth, chrome.renderer.height, input.contentRows);
+  state.panel.width = Math.min(availWidth, size.width);
   state.panel.height = size.height;
   if (state.open) {
     unmountActiveTab(state);
@@ -89448,7 +89513,10 @@ function openModal(otui, chrome, input) {
   paintHeader(state, input.title);
   paintFooter(state, input.footer);
   mountTab(state, input, resolveInitialTab(input.tabs, input.initialTab));
-  state.tabStrip.focus();
+  const focused = chrome.renderer.currentFocusedRenderable;
+  if (focused === null || !containsNode(state.scroll, focused)) {
+    state.tabStrip.focus();
+  }
   return makeHandle(state, generation);
 }
 
@@ -90760,6 +90828,10 @@ var REVIEW_FOOTER = [
   { key: "\u2191/\u2193", label: "scroll" },
   { key: "esc", label: "close" }
 ];
+var REVIEW_EMPTY_FOOTER = [
+  { key: "\u2190/\u2192", label: "tabs" },
+  { key: "esc", label: "close" }
+];
 function isReviewCommand(line) {
   const token = line.trim().split(/\s+/)[0] ?? "";
   return token === REVIEW_COMMAND;
@@ -91061,6 +91133,7 @@ function presentReview(openModal, otui, chrome, options) {
       paintSelection();
     });
   };
+  const isCompactEmpty = items.length === 0;
   const handle = openModal(otui, chrome, {
     title: REVIEW_COMMAND,
     tabs: [
@@ -91068,7 +91141,8 @@ function presentReview(openModal, otui, chrome, options) {
       { id: "detail", label: "Detail" }
     ],
     initialTab: "list",
-    footer: REVIEW_FOOTER,
+    footer: isCompactEmpty ? REVIEW_EMPTY_FOOTER : REVIEW_FOOTER,
+    ...isCompactEmpty ? { contentRows: 3 } : {},
     onArrowKeys: (key, direction) => {
       if (items[selected]?.type === "proposal" && status.kind !== "running" && status.kind !== "done" && handle?.activeTab() === "detail") {
         focusedAction = direction === "left" ? "accept" : "decline";
@@ -92740,14 +92814,36 @@ function describeUnavailableCommand(line, mode) {
   return `${command.name} is only available in ${where} \u2014 this is ${mode} mode. ` + `Type /help for the commands available here.
 `;
 }
-function renderCommandHelp(mode, only) {
+function renderCommandHelp(mode, only, maxColumns) {
   const allow = only === undefined ? undefined : new Set(only);
   const options = commandsForMode(mode).filter((c) => allow === undefined || allow.has(c.name));
   const width = options.reduce((w, c) => Math.max(w, c.name.length), 0);
-  return ["Commands:", ...options.map((c) => `  ${c.name.padEnd(width)}  ${c.description}`)].join(`
+  const descColumn = width + 4;
+  const wrapBudget = maxColumns !== undefined && maxColumns - descColumn >= MIN_HELP_WRAP_COLUMNS ? maxColumns - descColumn : undefined;
+  const rows = options.flatMap((c) => {
+    const lines = c.description.split(`
+`).flatMap((line) => wrapBudget === undefined ? [line] : wrapWords(line, wrapBudget));
+    return lines.map((line, i) => (i === 0 ? `  ${c.name.padEnd(width)}  ${line}` : `${" ".repeat(descColumn)}${line}`).trimEnd());
+  });
+  return ["Commands:", ...rows].join(`
 `) + `
 `;
 }
+var MIN_HELP_WRAP_COLUMNS = 10;
+function wrapWords(line, budget) {
+  const out = [];
+  let cur = "";
+  for (const word of line.split(/\s+/).filter(Boolean)) {
+    if (cur.length > 0 && cur.length + 1 + word.length > budget) {
+      out.push(cur);
+      cur = word;
+    } else {
+      cur = cur.length > 0 ? `${cur} ${word}` : word;
+    }
+  }
+  out.push(cur);
+  return out;
+}
 
 // src/tui/theme-picker.ts
 function isThemeCommand(line) {
@@ -95100,6 +95196,10 @@ async function createShellChrome(otui, renderer, opts) {
   syncComposerHeight();
   const submitHandlers = new Set;
   const emitSubmit = (line) => {
+    if (line.length > 0) {
+      scroll.scrollTop = scroll.scrollHeight;
+      scroll.stickyScroll = true;
+    }
     for (const handler of [...submitHandlers]) {
       handler(line);
     }
@@ -98524,7 +98624,12 @@ function pickProviderStep(otui, r, detected) {
     });
   });
 }
-function selectProviderModelInTui(otui, r, detected, options = {}) {
+function isModalChrome(target) {
+  return target !== null && typeof target === "object" && "renderer" in target && "focusComposer" in target;
+}
+function selectProviderModelInTui(otui, rOrChrome, detected, options = {}) {
+  const chrome = isModalChrome(rOrChrome) ? rOrChrome : undefined;
+  const r = chrome !== undefined ? chrome.renderer : rOrChrome;
   return new Promise((resolve) => {
     if (detected.length === 0) {
       resolve(undefined);
@@ -98657,7 +98762,9 @@ function selectProviderModelInTui(otui, r, detected, options = {}) {
             models = await modelsForPicker(selectedProvider, modelDeps);
           }
         }
-        const model = await pickModelInTui(otui, r, models.models, modelPickerNotice(label, models));
+        const model = await pickModelInTui(otui, chrome ?? r, models.models, modelPickerNotice(label, models), {
+          escLabel: "back"
+        });
         if (model === undefined) {
           continue;
         }
@@ -98671,49 +98778,120 @@ function adaptiveSelectHeight(count, available, per = 1) {
   const min = Math.max(1, Math.floor(available / 4));
   return Math.min(available, Math.max(min, count * per));
 }
-function pickModelInTui(otui, r, models, notice) {
+function pickModelInTui(otui, rOrChrome, models, notice, options = {}) {
+  const chrome = isModalChrome(rOrChrome) ? rOrChrome : undefined;
+  const r = chrome !== undefined ? chrome.renderer : rOrChrome;
+  const showNotice = models.length === 0 && notice !== undefined;
+  const noticeText = () => new otui.TextRenderable(r, { id: "mp-notice", content: otui.t`${otui.red("\u2717")} ${notice ?? ""}` });
+  const listSpec = {
+    idPrefix: "mp",
+    items: models,
+    toOption: (m) => ({ name: m, description: "" }),
+    matches: (m, q) => m.toLowerCase().includes(q),
+    emptyLabel: notice ?? "(no models found)",
+    filterHint: (filter, shown, total) => `filter: ${filter}  (${shown}/${total})`,
+    showDescription: false
+  };
+  const fixedRows = 1 + (showNotice ? 1 : 0);
+  if (chrome !== undefined) {
+    return new Promise((resolve) => {
+      let chosen;
+      const handle = openModal(otui, chrome, {
+        title: "Select a model",
+        tabs: [{ id: "models", label: "Models" }],
+        footer: [
+          { key: "\u2191/\u2193", label: "select" },
+          { key: "Enter", label: "confirm" },
+          { key: "esc", label: options.escLabel ?? "close" }
+        ],
+        contentRows: fixedRows + Math.max(1, models.length),
+        renderTab: (_tabId, body, ctx) => {
+          const parent = body;
+          if (showNotice) {
+            parent.add(noticeText());
+          }
+          const list = mountFilterList(otui, r, parent, {
+            ...listSpec,
+            idleHint: "type to filter by name",
+            width: "100%",
+            height: adaptiveSelectHeight(models.length, Math.max(1, ctx.height - fixedRows)),
+            onPick: (m) => {
+              chosen = m;
+              handle?.close();
+            }
+          });
+          return onKeypress4(r, list.onKey);
+        },
+        onClose: () => resolve(chosen)
+      });
+      if (handle === undefined) {
+        resolve(undefined);
+      }
+    });
+  }
   return new Promise((resolve) => {
-    const all = models;
-    const NO_MODELS = notice ?? "(no models found)";
     const box = overlayBox(otui, r, "model-picker");
     r.root.add(box);
     box.add(new otui.TextRenderable(r, { id: "mp-title", content: otui.t`${otui.bold("Select a model")}` }));
-    if (all.length === 0 && notice !== undefined) {
-      box.add(new otui.TextRenderable(r, { id: "mp-notice", content: otui.t`${otui.red("\u2717")} ${notice}` }));
+    if (showNotice) {
+      box.add(noticeText());
     }
-    const filterLine = new otui.TextRenderable(r, { id: "mp-filter", content: otui.t`${otui.dim("type to filter \xB7 \u2191/\u2193 Enter \xB7 Esc to go back")}` });
-    box.add(filterLine);
-    const NO_MATCH = "(no match)";
     const rHeight = r.height;
     const available = typeof rHeight === "number" && rHeight > 0 ? Math.max(4, rHeight - 4) : 16;
-    const height = adaptiveSelectHeight(all.length, available);
-    const sel = new otui.SelectRenderable(r, {
-      id: "mp-sel",
+    let unsub = () => {};
+    const finish = (m) => {
+      unsub();
+      r.root.remove(box);
+      resolve(m);
+    };
+    const list = mountFilterList(otui, r, box, {
+      ...listSpec,
+      idleHint: "type to filter \xB7 \u2191/\u2193 Enter \xB7 Esc to go back",
       width: 72,
-      showDescription: false,
-      height,
-      showScrollIndicator: true,
-      wrapSelection: true,
-      options: (all.length > 0 ? all : [NO_MODELS]).map((m) => ({ name: m, description: "" })),
-      selectedTextColor: "#ffd166"
+      height: adaptiveSelectHeight(models.length, available),
+      onPick: finish
     });
-    box.add(sel);
-    sel.focus();
-    let filter = "";
-    const apply = () => {
-      const q = filter.trim().toLowerCase();
-      const matches = q.length > 0 ? all.filter((m) => m.toLowerCase().includes(q)) : all;
-      sel.options = matches.length > 0 ? matches.map((m) => ({ name: m, description: "" })) : [{ name: NO_MATCH, description: "" }];
-      filterLine.content = otui.t`${otui.dim(q.length > 0 ? `filter: ${filter}  (${matches.length}/${all.length})` : "type to filter \xB7 \u2191/\u2193 Enter \xB7 Esc to go back")}`;
-    };
-    const onKey = (key) => {
+    unsub = onKeypress4(r, (key) => {
       if (key.name === "escape") {
-        cleanup();
-        resolve(undefined);
+        finish(undefined);
         key.preventDefault();
         key.stopPropagation();
         return;
       }
+      list.onKey(key);
+    });
+  });
+}
+function mountFilterList(otui, r, parent, spec) {
+  const filterLine = new otui.TextRenderable(r, { id: `${spec.idPrefix}-filter`, content: "" });
+  parent.add(filterLine);
+  const sel = new otui.SelectRenderable(r, {
+    id: `${spec.idPrefix}-sel`,
+    width: spec.width,
+    showDescription: spec.showDescription,
+    height: spec.height,
+    showScrollIndicator: true,
+    wrapSelection: true,
+    options: [],
+    selectedTextColor: "#ffd166"
+  });
+  parent.add(sel);
+  sel.focus();
+  let filter = "";
+  let shown = spec.items;
+  const apply = () => {
+    const q = filter.trim().toLowerCase();
+    shown = q.length > 0 ? spec.items.filter((item) => spec.matches(item, q)) : spec.items;
+    sel.options = shown.length > 0 ? shown.map(spec.toOption) : [{ name: spec.items.length === 0 ? spec.emptyLabel : "(no match)", description: "" }];
+    sel.selectedIndex = 0;
+    filterLine.content = otui.t`${otui.dim(q.length > 0 ? spec.filterHint(filter, shown.length, spec.items.length) : spec.idleHint)}`;
+  };
+  apply();
+  sel.on(otui.SelectRenderableEvents.ITEM_SELECTED, () => {
+    spec.onPick(shown[sel.getSelectedIndex()]);
+  });
+  return {
+    onKey: (key) => {
       if (key.name === "backspace") {
         filter = filter.slice(0, -1);
         apply();
@@ -98728,113 +98906,95 @@ function pickModelInTui(otui, r, models, notice) {
         key.preventDefault();
         key.stopPropagation();
       }
-    };
-    const unsub = onKeypress4(r, onKey);
-    const cleanup = () => {
-      unsub();
-      r.root.remove(box);
-    };
-    sel.on(otui.SelectRenderableEvents.ITEM_SELECTED, () => {
-      const chosen = sel.getSelectedOption();
-      cleanup();
-      resolve(chosen === null || chosen.name === NO_MATCH || chosen.name === NO_MODELS ? undefined : chosen.name);
-    });
-  });
+    }
+  };
 }
 function formatSessionDate(iso) {
   const short = iso.trim().replace("T", " ");
   return short.length >= 16 ? short.slice(0, 16) : short;
 }
-function pickSessionInTui(otui, r, sessions) {
-  return new Promise((resolve) => {
-    const all = sessions.map((s) => {
-      const created = formatSessionDate(s.createdAt);
-      const updated = formatSessionDate(s.updatedAt);
-      const short = shortSessionId(s.id);
-      const title = s.title.length > 52 ? `${s.title.slice(0, 49)}\u2026` : s.title;
-      return {
-        value: s.id,
-        label: `${short} \xB7 ${title}`,
-        description: `${s.projectPath} \xB7 created ${created} \xB7 updated ${updated}`,
-        search: `${s.id} ${short} ${s.projectPath} ${s.title} ${created} ${updated}`.toLowerCase()
-      };
+function pickSessionInTui(otui, rOrChrome, sessions) {
+  const chrome = isModalChrome(rOrChrome) ? rOrChrome : undefined;
+  const r = chrome !== undefined ? chrome.renderer : rOrChrome;
+  const all = sessions.map((s) => {
+    const created = formatSessionDate(s.createdAt);
+    const updated = formatSessionDate(s.updatedAt);
+    const short = shortSessionId(s.id);
+    const title = s.title.length > 52 ? `${s.title.slice(0, 49)}\u2026` : s.title;
+    return {
+      value: s.id,
+      label: `${short} \xB7 ${title}`,
+      description: `${s.projectPath} \xB7 created ${created} \xB7 updated ${updated}`,
+      search: `${s.id} ${short} ${s.projectPath} ${s.title} ${created} ${updated}`.toLowerCase()
+    };
+  });
+  const listSpec = {
+    idPrefix: "sp",
+    items: all,
+    toOption: (row) => ({ name: row.label, description: row.description }),
+    matches: (row, q) => row.search.includes(q),
+    emptyLabel: "(no match)",
+    filterHint: (filter, shown) => `filter: ${filter}  (${shown})`,
+    showDescription: true
+  };
+  const ROWS_PER_SESSION = 2;
+  if (chrome !== undefined) {
+    return new Promise((resolve) => {
+      let chosen;
+      const handle = openModal(otui, chrome, {
+        title: "Session Switcher",
+        tabs: [{ id: "sessions", label: "Sessions" }],
+        footer: [
+          { key: "\u2191/\u2193", label: "select" },
+          { key: "Enter", label: "open" },
+          { key: "esc", label: "cancel" }
+        ],
+        contentRows: 1 + Math.max(1, all.length) * ROWS_PER_SESSION,
+        renderTab: (_tabId, body, ctx) => {
+          const list = mountFilterList(otui, r, body, {
+            ...listSpec,
+            idleHint: "type to filter by id, title, project, created, updated",
+            width: "100%",
+            height: adaptiveSelectHeight(all.length, Math.max(1, ctx.height - 1), ROWS_PER_SESSION),
+            onPick: (row) => {
+              chosen = row?.value;
+              handle?.close();
+            }
+          });
+          return onKeypress4(r, list.onKey);
+        },
+        onClose: () => resolve(chosen)
+      });
+      if (handle === undefined) {
+        resolve(undefined);
+      }
     });
+  }
+  return new Promise((resolve) => {
     const box = overlayBox(otui, r, "session-picker");
     r.root.add(box);
     box.add(new otui.TextRenderable(r, { id: "sp-title", content: otui.t`${otui.bold("Open session")} ${otui.dim("\u2191/\u2193 Enter \xB7 Esc to cancel")}` }));
-    const filterLine = new otui.TextRenderable(r, {
-      id: "sp-filter",
-      content: otui.t`${otui.dim("type to filter by id, title, project, created, updated")}`
-    });
-    box.add(filterLine);
-    const NO_MATCH = "(no match)";
-    const sel = new otui.SelectRenderable(r, {
-      id: "sp-sel",
+    let unsub = () => {};
+    const finish = (row) => {
+      unsub();
+      r.root.remove(box);
+      resolve(row?.value);
+    };
+    const list = mountFilterList(otui, r, box, {
+      ...listSpec,
+      idleHint: "type to filter \xB7 \u2191/\u2193 Enter \xB7 Esc to cancel",
       width: "100%",
-      showDescription: true,
       height: 14,
-      showScrollIndicator: true,
-      wrapSelection: true,
-      options: [],
-      selectedTextColor: "#ffd166"
+      onPick: finish
     });
-    box.add(sel);
-    sel.focus();
-    let filter = "";
-    let matches = all;
-    const apply = () => {
-      const q = filter.trim().toLowerCase();
-      matches = q.length > 0 ? all.filter((row) => row.search.includes(q)) : all;
-      const items = matches.length > 0 ? matches : [
-        {
-          value: "",
-          label: NO_MATCH,
-          description: "",
-          search: ""
-        }
-      ];
-      sel.options = items.map((row) => ({ name: row.label, description: row.description, value: row.value }));
-      filterLine.content = otui.t`${otui.dim(q.length > 0 ? `filter: ${filter}  (${matches.length})` : "type to filter \xB7 \u2191/\u2193 Enter \xB7 Esc to cancel")}`;
-      sel.selectedIndex = 0;
-    };
-    apply();
-    const onKey = (key) => {
+    unsub = onKeypress4(r, (key) => {
       if (key.name === "escape") {
-        cleanup();
-        resolve(undefined);
-        key.preventDefault();
-        key.stopPropagation();
-        return;
-      }
-      if (key.name === "backspace") {
-        filter = filter.slice(0, -1);
-        apply();
+        finish(undefined);
         key.preventDefault();
         key.stopPropagation();
         return;
       }
-      const ch = key.sequence;
-      if (!key.ctrl && !key.meta && typeof ch === "string" && ch.length === 1 && ch >= " ") {
-        filter += ch;
-        apply();
-        key.preventDefault();
-        key.stopPropagation();
-      }
-    };
-    const unsub = onKeypress4(r, onKey);
-    const cleanup = () => {
-      unsub();
-      r.root.remove(box);
-    };
-    sel.on(otui.SelectRenderableEvents.ITEM_SELECTED, () => {
-      const chosen = sel.getSelectedOption();
-      cleanup();
-      if (chosen === null || chosen.value === "" || chosen.name === NO_MATCH) {
-        resolve(undefined);
-        return;
-      }
-      const matched = matches.find((row) => row.value === chosen.value);
-      resolve(matched?.value);
+      list.onKey(key);
     });
   });
 }
@@ -99554,7 +99714,12 @@ async function launchTuiAgentShell(opts) {
       return chosen;
     };
     setAskUserHost(askUserInteractive);
-    const helpText = () => renderCommandHelp("agent");
+    const TRANSCRIPT_CHROME_COLS = 4;
+    const HELP_MIN_COLS = 40;
+    const helpText = () => {
+      const mainWidth = chrome.main.width > 0 ? chrome.main.width : r.width - SIDEBAR_WIDTH;
+      return renderCommandHelp("agent", undefined, Math.max(HELP_MIN_COLS, mainWidth - TRANSCRIPT_CHROME_COLS));
+    };
     const sessionCwd = opts.session?.cwd ?? process.cwd();
     let permissionMode = opts.initialPermissionMode ?? getProjectPermissionMode(sessionCwd) ?? DEFAULT_PERMISSION_MODE;
     io.permissionMode = () => permissionMode;
@@ -99601,7 +99766,7 @@ async function launchTuiAgentShell(opts) {
         return;
       }
       chrome.hideMenu();
-      const pickId = await chrome.withOverlay(() => pickSessionInTui(otui, r, rows));
+      const pickId = await chrome.withOverlay(() => pickSessionInTui(otui, chrome, rows));
       input.focus();
       if (pickId === undefined) {
         return;
@@ -100931,7 +101096,7 @@ Usage: /reasoning <${REASONING_EFFORT_LEVELS.join("|")}>
             const prov = detected.find((d) => d.name === currentSel.provider);
             const models = prov !== undefined ? await modelsForPicker(prov) : undefined;
             const notice = prov === undefined || models === undefined ? undefined : modelPickerNotice(prov.label ?? prov.name, models);
-            const chosen = await chrome.withOverlay(() => pickModelInTui(otui, r, models?.models ?? [], notice));
+            const chosen = await chrome.withOverlay(() => pickModelInTui(otui, chrome, models?.models ?? [], notice));
             if (chosen !== undefined) {
               await switchTo(currentSel.baseUrl === undefined ? { provider: currentSel.provider, model: chosen } : { provider: currentSel.provider, model: chosen, baseUrl: currentSel.baseUrl });
               try {
@@ -100968,7 +101133,7 @@ Usage: /reasoning <${REASONING_EFFORT_LEVELS.join("|")}>
         if (command.name === "/connect" || command.name === "/provider") {
           (async () => {
             const detected = opts.redetect !== undefined ? await opts.redetect() : opts.detected;
-            const ns = await chrome.withOverlay(() => command.name === "/connect" ? selectProviderModelInTui(otui, r, detected, { onlyConnected: true, env: process.env }) : selectProviderModelInTui(otui, r, detected));
+            const ns = await chrome.withOverlay(() => command.name === "/connect" ? selectProviderModelInTui(otui, chrome, detected, { onlyConnected: true, env: process.env }) : selectProviderModelInTui(otui, chrome, detected));
             if (ns !== undefined) {
               await switchTo(ns);
             } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrciphersmith/keryx",
-  "version": "0.2.115",
+  "version": "0.2.117",
   "description": "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
   "private": false,
   "publishConfig": {