tau-all-agent 0.1.6 → 0.3.0

package/README.md

@@ -23,6 +23,7 @@ pi install -l npm:tau-all-agent
 | `answer`            | `/answer`            | Extract and interactively answer agent questions.                                                                         |
 | `branch-term`       | `/branch`            | Open a new terminal on the current session's git branch.                                                                  |
 | `btw`               | `/btw`               | Run a one-off side request with read-only tools and no context persistence.                                               |
+| `caffeinate`        | —                    | Prevent system sleep while the agent runs.                                                                                |
 | `ghostty`           | —                    | Ghostty tab title enhancements while the agent is working, waiting, or idle.                                              |
 | `git-diff-stats`    | —                    | Status bar diff stats for local changes in the current repo.                                                              |
 | `git-pr-status`     | —                    | Status bar PR number and link for the current branch.                                                                     |
@@ -31,11 +32,12 @@ pi install -l npm:tau-all-agent
 | `loop`              | `/loop`              | Repeat a prompt until the agent signals success.                                                                          |
 | `memory`            | `/memory`            | Opt-in project-local memory for learning and continuity across sessions.                                                  |
 | `notify`            | —                    | Terminal notification when the agent is waiting for input.                                                                |
-| `openai-fast`       | `/fast`              | Toggle priority service tier for supported OpenAI models.                                                                 |
-| `openai-verbosity`  | `/verbosity`         | Set verbosity for supported OpenAI models.                                                                                |
+| `fast`              | `/fast`              | Toggle fast processing for compatible models.                                                                             |
+| `openai-verbosity`  | `/verbosity`         | Set verbosity for supported GPT models.                                                                                   |
 | `review`            | `/review`, `/triage` | Multi-focus review and PR feedback triage for PRs, branches, commits, and local changes, with integrated follow-up fixes. |
 | `sandbox`           | `/sandbox`           | OS-level sandboxing for bash commands with runtime overrides.                                                             |
-| `tool-display-mode` | `ctrl+o`             | Cycle tool output between Pi's default rendering, expanded output, and compact summaries.                                 |
+| `subagent`          | —                    | Delegate work to background Pi agents and follow up with them.                                                            |
+| `tool-display-mode` | `ctrl+o`             | Cycle tool output modes and combine background activity in the composer.                                                  |
 | `telegram`          | `/telegram`          | Interact with Pi via a Telegram bot and local daemon.                                                                     |
 | `usage`             | `/usage`             | Historical provider usage breakdown with all-provider history and live quota snapshots.                                   |
 | `websearch`         | —                    | Web search via Gemini, OpenAI, or Claude, leveraging Pi or browser session credentials.                                   |
@@ -43,17 +45,18 @@ pi install -l npm:tau-all-agent
 
 ## Skills
 
-| Skill               | Description                                                                        |
-| ------------------- | ---------------------------------------------------------------------------------- |
-| `browser-tools`     | Interactive browser automation via Chrome DevTools Protocol.                       |
-| `git-clean-history` | Reimplement a branch on a fresh branch off `main` with a clean commit history.     |
-| `git-commit`        | Tidy, focused commits with clear rationale in messages.                            |
-| `homeassistant-ops` | Operate a Home Assistant instance via REST/WebSocket APIs.                         |
-| `openscad`          | Create and render OpenSCAD 3D models, export STL.                                  |
-| `oracle`            | Second opinion from another LLM for debugging, refactors, design, or code reviews. |
-| `sentry`            | Fetch and analyze Sentry issues, events, transactions, and logs.                   |
-| `update-changelog`  | Update CHANGELOG.md following Keep a Changelog.                                    |
-| `web-design`        | Distinctive, production-ready web interfaces.                                      |
+| Skill                 | Description                                                                        |
+| --------------------- | ---------------------------------------------------------------------------------- |
+| `browser-tools`       | Interactive browser automation via Chrome DevTools Protocol.                       |
+| `git-clean-history`   | Reimplement a branch on a fresh branch off `main` with a clean commit history.     |
+| `git-commit`          | Tidy, focused commits with clear rationale in messages.                            |
+| `github-pull-request` | Create and steward pull requests through CI, review, and merge.                    |
+| `homeassistant-ops`   | Operate a Home Assistant instance via REST/WebSocket APIs.                         |
+| `openscad`            | Create and render OpenSCAD 3D models, export STL.                                  |
+| `oracle`              | Second opinion from another LLM for debugging, refactors, design, or code reviews. |
+| `sentry`              | Fetch and analyze Sentry issues, events, transactions, and logs.                   |
+| `update-changelog`    | Update CHANGELOG.md following Keep a Changelog.                                    |
+| `web-design`          | Distinctive, production-ready web interfaces.                                      |
 
 ## Themes
 

package/extensions/answer.ts

@@ -10,9 +10,14 @@
  * 4. Submits the compiled answers when done
  */
 
-import { complete } from "@earendil-works/pi-ai/compat";
 import type { Model, Api, UserMessage } from "@earendil-works/pi-ai";
-import { BorderedLoader, type ExtensionAPI, type Theme } from "@earendil-works/pi-coding-agent";
+import {
+  BorderedLoader,
+  type ExtensionAPI,
+  type KeybindingsManager,
+  type ModelRegistry,
+  type Theme,
+} from "@earendil-works/pi-coding-agent";
 import {
   type Component,
   Editor,
@@ -20,12 +25,13 @@ import {
   type Focusable,
   Key,
   matchesKey,
-  truncateToWidth,
   type TUI,
   visibleWidth,
   wrapTextWithAnsi,
 } from "@earendil-works/pi-tui";
 
+const MIN_QUESTIONNAIRE_WIDTH = 40;
+
 const SYSTEM_PROMPT = `You extract items that need user input from assistant text:
 
 - Direct questions
@@ -78,8 +84,8 @@ Example output:
   "questions": []
 }`;
 
-const OPENAI_FAST_MODEL_ID = "gpt-5.3-codex-spark";
-const ANTHROPIC_FAST_MODEL_ID = "claude-haiku-4-5";
+const OPENAI_FAST_MODEL_ID = "gpt-6-luna";
+const ANTHROPIC_FAST_MODEL_ID = "claude-haiku-5-5";
 
 // Structured output format for question extraction
 interface ExtractedQuestion {
@@ -91,25 +97,16 @@ interface ExtractionResult {
   questions: ExtractedQuestion[];
 }
 
-interface ModelRequestAuth {
+type ExtractionOutcome =
+  | { status: "success"; result: ExtractionResult }
+  | { status: "cancelled" }
+  | { status: "error"; message: string };
+
+interface ModelSelection {
   model: Model<Api>;
-  apiKey?: string;
-  headers?: Record<string, string>;
-  env?: Record<string, string>;
 }
 
-type ModelAuthLookup = {
-  find: (provider: string, modelId: string) => Model<Api> | undefined;
-  getApiKeyAndHeaders: (model: Model<Api>) => Promise<
-    | {
-        ok: true;
-        apiKey?: string;
-        headers?: Record<string, string>;
-        env?: Record<string, string>;
-      }
-    | { ok: false; error: string }
-  >;
-};
+type ModelLookup = Pick<ModelRegistry, "find" | "getApiKeyAndHeaders">;
 
 type ModelFamily = "openai" | "anthropic";
 
@@ -125,10 +122,10 @@ function detectModelFamily(provider: string): ModelFamily | null {
  */
 async function selectExtractionModel(
   currentModel: Model<Api>,
-  modelRegistry: ModelAuthLookup,
-): Promise<ModelRequestAuth | null> {
+  modelRegistry: ModelLookup,
+): Promise<ModelSelection | null> {
   const family = detectModelFamily(currentModel.provider);
-  if (!family) return resolveModelRequestAuth(modelRegistry, currentModel);
+  if (!family) return resolveModelSelection(modelRegistry, currentModel);
 
   const modelId = family === "openai" ? OPENAI_FAST_MODEL_ID : ANTHROPIC_FAST_MODEL_ID;
   const providerCandidates =
@@ -140,21 +137,21 @@ async function selectExtractionModel(
     const model = modelRegistry.find(provider, modelId);
     if (!model) continue;
 
-    const auth = await resolveModelRequestAuth(modelRegistry, model);
-    if (auth) {
-      return auth;
+    const selection = await resolveModelSelection(modelRegistry, model);
+    if (selection) {
+      return selection;
     }
   }
 
-  return resolveModelRequestAuth(modelRegistry, currentModel);
+  return resolveModelSelection(modelRegistry, currentModel);
 }
 
-async function resolveModelRequestAuth(
-  modelRegistry: ModelAuthLookup,
+async function resolveModelSelection(
+  modelRegistry: ModelLookup,
   model: Model<Api>,
-): Promise<ModelRequestAuth | null> {
+): Promise<ModelSelection | null> {
   const auth = await modelRegistry.getApiKeyAndHeaders(model);
-  return auth.ok ? { model, apiKey: auth.apiKey, headers: auth.headers, env: auth.env } : null;
+  return auth.ok ? { model } : null;
 }
 
 /**
@@ -171,11 +168,25 @@ function parseExtractionResult(text: string): ExtractionResult | null {
       jsonStr = jsonMatch[1].trim();
     }
 
-    const parsed = JSON.parse(jsonStr);
-    if (parsed && Array.isArray(parsed.questions)) {
-      return parsed as ExtractionResult;
+    const parsed: unknown = JSON.parse(jsonStr);
+    if (
+      !parsed ||
+      typeof parsed !== "object" ||
+      !("questions" in parsed) ||
+      !Array.isArray(parsed.questions) ||
+      !parsed.questions.every(
+        (question: unknown): question is ExtractedQuestion =>
+          question !== null &&
+          typeof question === "object" &&
+          "question" in question &&
+          typeof question.question === "string" &&
+          question.question.trim().length > 0 &&
+          (!("context" in question) || typeof question.context === "string"),
+      )
+    ) {
+      return null;
     }
-    return null;
+    return { questions: parsed.questions };
   } catch {
     return null;
   }
@@ -193,9 +204,15 @@ class QnAComponent implements Component, Focusable {
   private theme: Theme;
   private onDone: (result: string | null) => void;
   private showingConfirmation: boolean = false;
+  private questionOffset = 0;
+  private readingHeight = 0;
+  private maxQuestionOffset = 0;
+  private usable = false;
 
   // Cache
+  private renderWidth?: number;
   private cachedWidth?: number;
+  private cachedHeight?: number;
   private cachedLines?: string[];
 
   private _focused = false;
@@ -207,12 +224,14 @@ class QnAComponent implements Component, Focusable {
   set focused(value: boolean) {
     this._focused = value;
     this.editor.focused = value;
+    this.invalidate();
   }
 
   constructor(
     questions: ExtractedQuestion[],
     tui: TUI,
     theme: Theme,
+    private keybindings: KeybindingsManager,
     onDone: (result: string | null) => void,
   ) {
     this.questions = questions;
@@ -244,13 +263,14 @@ class QnAComponent implements Component, Focusable {
   }
 
   private saveCurrentAnswer(): void {
-    this.answers[this.currentIndex] = this.editor.getText();
+    this.answers[this.currentIndex] = this.editor.getExpandedText();
   }
 
   private navigateTo(index: number): void {
     if (index < 0 || index >= this.questions.length) return;
     this.saveCurrentAnswer();
     this.currentIndex = index;
+    this.questionOffset = 0;
     this.editor.setText(this.answers[index] || "");
     this.invalidate();
   }
@@ -283,21 +303,57 @@ class QnAComponent implements Component, Focusable {
 
   invalidate(): void {
     this.cachedWidth = undefined;
+    this.cachedHeight = undefined;
     this.cachedLines = undefined;
   }
 
   handleInput(data: string): void {
+    // Recheck current geometry before accepting input, including resize before repaint.
+    // Both dimensions reserve the one-cell margins from overlayOptions below.
+    this.render(
+      Math.min(this.renderWidth ?? this.tui.terminal.columns - 2, this.tui.terminal.columns - 2),
+    );
+    if (!this.usable) {
+      if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c"))) this.cancel();
+      return;
+    }
+
+    if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c"))) {
+      if (this.showingConfirmation) {
+        this.showingConfirmation = false;
+        this.invalidate();
+        this.tui.requestRender();
+      } else {
+        this.cancel();
+      }
+      return;
+    }
+
+    // Viewport navigation reads the question. Unmatched keys retain native editing behavior.
+    const scrollActions = [
+      ["tui.altScreen.pageUp", -this.readingHeight],
+      ["tui.altScreen.pageDown", this.readingHeight],
+      ["tui.altScreen.top", -Infinity],
+      ["tui.altScreen.bottom", Infinity],
+    ] as const;
+    for (const [action, delta] of scrollActions) {
+      if (!this.keybindings.matches(data, action)) continue;
+      this.questionOffset = Math.max(
+        0,
+        Math.min(this.maxQuestionOffset, this.questionOffset + delta),
+      );
+      this.invalidate();
+      this.tui.requestRender();
+      return;
+    }
+
     // Handle confirmation dialog
     if (this.showingConfirmation) {
       if (matchesKey(data, Key.enter) || data.toLowerCase() === "y") {
         this.submit();
         return;
       }
-      if (
-        matchesKey(data, Key.escape) ||
-        matchesKey(data, Key.ctrl("c")) ||
-        data.toLowerCase() === "n"
-      ) {
+      if (data.toLowerCase() === "n") {
         this.showingConfirmation = false;
         this.invalidate();
         this.tui.requestRender();
@@ -306,12 +362,6 @@ class QnAComponent implements Component, Focusable {
       return;
     }
 
-    // Global navigation and commands
-    if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl("c"))) {
-      this.cancel();
-      return;
-    }
-
     // Tab / Shift+Tab for navigation
     if (matchesKey(data, Key.tab)) {
       if (this.currentIndex < this.questions.length - 1) {
@@ -368,14 +418,48 @@ class QnAComponent implements Component, Focusable {
   }
 
   render(width: number): string[] {
-    if (this.cachedLines && this.cachedWidth === width) {
+    this.renderWidth = width;
+    const height = Math.max(1, this.tui.terminal.rows - 2);
+    if (this.cachedLines && this.cachedWidth === width && this.cachedHeight === height) {
+      this.usable = true;
       return this.cachedLines;
     }
 
     const theme = this.theme;
     const lines: string[] = [];
-    const boxWidth = Math.min(width - 4, 120); // Allow wider box
-    const contentWidth = boxWidth - 4; // 2 chars padding on each side
+    const boxWidth = Math.min(Math.max(MIN_QUESTIONNAIRE_WIDTH, width) - 4, 120);
+    const contentWidth = boxWidth - 4;
+    const editorLines = this.editor.render(contentWidth - 7);
+    const readingKeys = [
+      ...this.keybindings.getKeys("tui.altScreen.pageUp"),
+      ...this.keybindings.getKeys("tui.altScreen.pageDown"),
+      ...this.keybindings.getKeys("tui.altScreen.top"),
+      ...this.keybindings.getKeys("tui.altScreen.bottom"),
+    ].join("/");
+    const controls = this.showingConfirmation
+      ? `${theme.fg("warning", "Submit all answers?")} Enter/y confirm · Esc/n back`
+      : "Tab/Enter next · Shift+Tab prev · Shift+Enter newline · Esc cancel";
+    const footer = [
+      ...wrapTextWithAnsi(
+        theme.fg("dim", `Read question: ${readingKeys || "navigation keys unbound"}`),
+        contentWidth,
+      ),
+      ...wrapTextWithAnsi(controls, contentWidth),
+    ];
+    // Six frame rows (top/title/divider, editor spacer, footer divider, bottom),
+    // the full native editor and wrapped footer, plus at least one reading row.
+    const minimumHeight = 6 + editorLines.length + footer.length + 1;
+    this.usable = width >= MIN_QUESTIONNAIRE_WIDTH && height >= minimumHeight;
+    if (!this.usable) {
+      this.invalidate();
+      return wrapTextWithAnsi(
+        theme.fg(
+          "muted",
+          `Resize to ${MIN_QUESTIONNAIRE_WIDTH + 2}+ columns and more rows. Esc cancels.`,
+        ),
+        Math.max(1, width),
+      ).slice(0, height);
+    }
 
     // Helper to create horizontal lines (dim the whole thing at once)
     const horizontalLine = (count: number) => "─".repeat(count);
@@ -388,10 +472,6 @@ class QnAComponent implements Component, Focusable {
       return theme.fg("dim", "│") + paddedContent + " ".repeat(rightPad) + theme.fg("dim", "│");
     };
 
-    const emptyBoxLine = (): string => {
-      return theme.fg("dim", "│") + " ".repeat(boxWidth - 2) + theme.fg("dim", "│");
-    };
-
     const padToWidth = (line: string): string => {
       const len = visibleWidth(line);
       return line + " ".repeat(Math.max(0, width - len));
@@ -403,7 +483,14 @@ class QnAComponent implements Component, Focusable {
     lines.push(padToWidth(boxLine(title)));
     lines.push(padToWidth(theme.fg("dim", "├" + horizontalLine(boxWidth - 2) + "┤")));
 
-    // Progress indicator
+    // Start with the question even when only one reading row fits.
+    const q = this.questions[this.currentIndex];
+    const reading = wrapTextWithAnsi(`> ${q.question}`, contentWidth);
+    if (q.context) {
+      reading.push("", ...wrapTextWithAnsi(theme.fg("muted", q.context), contentWidth - 2));
+    }
+
+    // Progress belongs to the reading region so every indicator remains reachable.
     const progressParts: string[] = [];
     for (let i = 0; i < this.questions.length; i++) {
       const answered = (this.answers[i]?.trim() || "").length > 0;
@@ -416,59 +503,30 @@ class QnAComponent implements Component, Focusable {
         progressParts.push(theme.fg("dim", "○"));
       }
     }
-    lines.push(padToWidth(boxLine(progressParts.join(" "))));
-    lines.push(padToWidth(emptyBoxLine()));
-
-    // Current question
-    const q = this.questions[this.currentIndex];
-    const questionText = `> ${q.question}`;
-    const wrappedQuestion = wrapTextWithAnsi(questionText, contentWidth);
-    for (const line of wrappedQuestion) {
+    reading.push("", ...wrapTextWithAnsi(progressParts.join(" "), contentWidth));
+
+    this.readingHeight = height - minimumHeight + 1;
+    this.maxQuestionOffset = Math.max(0, reading.length - this.readingHeight);
+    this.questionOffset = Math.min(this.questionOffset, this.maxQuestionOffset);
+    for (const line of reading.slice(
+      this.questionOffset,
+      this.questionOffset + this.readingHeight,
+    )) {
       lines.push(padToWidth(boxLine(line)));
     }
+    lines.push(padToWidth(boxLine("")));
 
-    // Context if present
-    if (q.context) {
-      lines.push(padToWidth(emptyBoxLine()));
-      const contextText = theme.fg("muted", `${q.context}`);
-      const wrappedContext = wrapTextWithAnsi(contextText, contentWidth - 2);
-      for (const line of wrappedContext) {
-        lines.push(padToWidth(boxLine(line)));
-      }
+    // Keep the entire native editor, including its cursor and scrolling indicators.
+    for (let i = 0; i < editorLines.length; i++) {
+      lines.push(padToWidth(boxLine((i === 1 ? theme.bold("A: ") : "   ") + editorLines[i])));
     }
 
-    lines.push(padToWidth(emptyBoxLine()));
-
-    // Render the editor component (multi-line input) with padding
-    // Skip the first and last lines (editor's own border lines)
-    const answerPrefix = theme.bold("A: ");
-    const editorWidth = contentWidth - 4 - 3; // Extra padding + space for "A: "
-    const editorLines = this.editor.render(editorWidth);
-    for (let i = 1; i < editorLines.length - 1; i++) {
-      if (i === 1) {
-        // First content line gets the "A: " prefix
-        lines.push(padToWidth(boxLine(answerPrefix + editorLines[i])));
-      } else {
-        // Subsequent lines get padding to align with the first line
-        lines.push(padToWidth(boxLine("   " + editorLines[i])));
-      }
-    }
-
-    lines.push(padToWidth(emptyBoxLine()));
-
-    // Confirmation dialog or footer with controls
-    if (this.showingConfirmation) {
-      lines.push(padToWidth(theme.fg("dim", "├" + horizontalLine(boxWidth - 2) + "┤")));
-      const confirmMsg = `${theme.fg("warning", "Submit all answers?")} ${theme.fg("dim", "(Enter/y to confirm, Esc/n to cancel)")}`;
-      lines.push(padToWidth(boxLine(truncateToWidth(confirmMsg, contentWidth))));
-    } else {
-      lines.push(padToWidth(theme.fg("dim", "├" + horizontalLine(boxWidth - 2) + "┤")));
-      const controls = `${theme.fg("dim", "Tab/Enter")} next · ${theme.fg("dim", "Shift+Tab")} prev · ${theme.fg("dim", "Shift+Enter")} newline · ${theme.fg("dim", "Esc")} cancel`;
-      lines.push(padToWidth(boxLine(truncateToWidth(controls, contentWidth))));
-    }
+    lines.push(padToWidth(theme.fg("dim", "├" + horizontalLine(boxWidth - 2) + "┤")));
+    for (const line of footer) lines.push(padToWidth(boxLine(line)));
     lines.push(padToWidth(theme.fg("dim", "╰" + horizontalLine(boxWidth - 2) + "╯")));
 
     this.cachedWidth = width;
+    this.cachedHeight = height;
     this.cachedLines = lines;
     return lines;
   }
@@ -525,67 +583,86 @@ export default function (pi: ExtensionAPI) {
       }
 
       // Run extraction with loader UI
-      const extractionResult = await ctx.ui.custom<ExtractionResult | null>(
-        (tui, theme, _kb, done) => {
-          const loader = new BorderedLoader(
-            tui,
-            theme,
-            `Extracting questions using ${extractionSelection.model.id}...`,
+      const extraction = await ctx.ui.custom<ExtractionOutcome>((tui, theme, _kb, done) => {
+        const loader = new BorderedLoader(
+          tui,
+          theme,
+          `Extracting questions using ${extractionSelection.model.id}...`,
+        );
+        loader.onAbort = () => done({ status: "cancelled" });
+
+        const doExtract = async (): Promise<ExtractionOutcome> => {
+          const userMessage: UserMessage = {
+            role: "user",
+            content: [{ type: "text", text: lastAssistantText! }],
+            timestamp: Date.now(),
+          };
+
+          const response = await ctx.modelRegistry.complete(
+            extractionSelection.model,
+            { systemPrompt: SYSTEM_PROMPT, messages: [userMessage] },
+            { signal: loader.signal },
           );
-          loader.onAbort = () => done(null);
 
-          const doExtract = async () => {
-            const userMessage: UserMessage = {
-              role: "user",
-              content: [{ type: "text", text: lastAssistantText! }],
-              timestamp: Date.now(),
+          if (loader.signal.aborted || response.stopReason === "aborted") {
+            return { status: "cancelled" };
+          }
+          if (response.stopReason !== "stop") {
+            return {
+              status: "error",
+              message: response.errorMessage
+                ? `Question extraction failed: ${response.errorMessage}`
+                : `Question extraction did not complete (${response.stopReason})`,
             };
+          }
 
-            const response = await complete(
-              extractionSelection.model,
-              { systemPrompt: SYSTEM_PROMPT, messages: [userMessage] },
-              {
-                apiKey: extractionSelection.apiKey,
-                headers: extractionSelection.headers,
-                env: extractionSelection.env,
-                signal: loader.signal,
-              },
+          const responseText = response.content
+            .filter((c): c is { type: "text"; text: string } => c.type === "text")
+            .map((c) => c.text)
+            .join("\n");
+
+          const result = parseExtractionResult(responseText);
+          return result
+            ? { status: "success", result }
+            : { status: "error", message: "Question extraction returned an invalid response" };
+        };
+
+        doExtract()
+          .then(done)
+          .catch((error: unknown) => {
+            done(
+              loader.signal.aborted
+                ? { status: "cancelled" }
+                : {
+                    status: "error",
+                    message: `Question extraction failed: ${error instanceof Error ? error.message : String(error)}`,
+                  },
             );
+          });
 
-            if (response.stopReason === "aborted") {
-              return null;
-            }
-
-            const responseText = response.content
-              .filter((c): c is { type: "text"; text: string } => c.type === "text")
-              .map((c) => c.text)
-              .join("\n");
-
-            return parseExtractionResult(responseText);
-          };
-
-          doExtract()
-            .then(done)
-            .catch(() => done(null));
-
-          return loader;
-        },
-      );
+        return loader;
+      });
 
-      if (extractionResult === null) {
+      if (extraction.status === "cancelled") {
         ctx.ui.notify("Cancelled", "info");
         return;
       }
+      if (extraction.status === "error") {
+        ctx.ui.notify(extraction.message, "error");
+        return;
+      }
 
-      if (extractionResult.questions.length === 0) {
+      const { questions } = extraction.result;
+      if (questions.length === 0) {
         ctx.ui.notify("No questions found in the last message", "info");
         return;
       }
 
       // Show the Q&A component
-      const answersResult = await ctx.ui.custom<string | null>((tui, theme, _kb, done) => {
-        return new QnAComponent(extractionResult.questions, tui, theme, done);
-      });
+      const answersResult = await ctx.ui.custom<string | null>(
+        (tui, theme, kb, done) => new QnAComponent(questions, tui, theme, kb, done),
+        { overlay: true, overlayOptions: { width: "100%", maxHeight: "100%", margin: 1 } },
+      );
 
       if (answersResult === null) {
         ctx.ui.notify("Cancelled", "info");

package/extensions/branch-term/README.md

@@ -0,0 +1,7 @@
+# Branch terminals
+
+`/branch` forks the selected conversation without switching the current session. Inside tmux, `--branch-tmux-layout` chooses `window`, `split-right`, or `split-down`; a `/branch` argument overrides that setting.
+
+`--branch-term` takes precedence over tmux and accepts a Bash launcher template. Use unquoted `{cwd}` and `{session}` placeholders for path arguments. `{command}` supplies a single command-string argument, suitable for a launcher's command option or `bash -c`. Do not add shell quotes around placeholders; they are already quoted. If neither `{session}` nor `{command}` appears, the fork path is appended. The launcher runs in the session's working directory with the current environment.
+
+A failed launcher produces a recovery command. Reloading or closing the original Pi session stops observing launcher failures but does not close user-owned terminals.