@herbertgao/pi-extensions 2026.9.12 → 2026.9.13

package/node_modules/@narumitw/pi-btw/src/menu.ts

@@ -15,9 +15,11 @@ import {
   validateBtwShortcutEdit,
 } from "./keybindings.js";
 import {
+  type BtwLayout,
   type BtwSettings,
   type BtwSettingsPatch,
   btwSettingsPath,
+  effectiveBtwLayout,
   effectiveFullscreenCopyOnSelect,
   effectiveRememberThinkingLevelChanges,
   parseBtwModelReference,
@@ -65,10 +67,17 @@ type BtwMenuAction =
   | "set-thinking"
   | "set-remember"
   | "set-fullscreen-copy"
+  | "set-layout"
   | "edit-shortcut"
   | "save-shortcut"
   | "reset-shortcut";
 const SAME_AS_MAIN_THREAD = "Same as main thread";
+const BTW_LAYOUT_LABELS: Record<BtwLayout, string> = {
+  fullscreen: "Fullscreen",
+  "left-pane": "Side thread left",
+  "right-pane": "Side thread right",
+};
+const BTW_LAYOUT_VALUES = Object.values(BTW_LAYOUT_LABELS);
 type BtwCustomOptions = Parameters<ExtensionCommandContext["ui"]["custom"]>[1];
 
 type BtwCustomFactory<T> = (
@@ -331,7 +340,7 @@ export async function showBtwCommandMenu(
         lines: [
           `Model: ${displayModelValue(state.settings)}`,
           `Thinking: ${displayThinkingSummary(state.settings)} · Remember changes: ${displayRememberSummary(state.settings)}`,
-          `Copy on select: ${effectiveFullscreenCopyOnSelect(state.settings) ? "On" : "Off"}`,
+          `Layout: ${BTW_LAYOUT_LABELS[effectiveBtwLayout(state.settings)]} · Copy on select: ${effectiveFullscreenCopyOnSelect(state.settings) ? "On" : "Off"}`,
         ],
         items: [
           {
@@ -359,7 +368,7 @@ export async function showBtwCommandMenu(
           {
             id: "settings",
             label: "Settings",
-            description: "Choose model, thinking, keybindings, and selection copying",
+            description: "Choose model, thinking, layout, keybindings, and selection copying",
             to: state.kind === "invalid" ? "invalid" : "settings",
           },
         ],
@@ -414,6 +423,14 @@ export async function showBtwCommandMenu(
             values: ["On", "Off"],
             action: "set-fullscreen-copy",
           },
+          {
+            id: "layout",
+            label: "Side-thread layout",
+            description: "Use the full workspace or place BTW beside the live, click-to-focus main thread.",
+            currentValue: BTW_LAYOUT_LABELS[effectiveBtwLayout(state.settings)],
+            values: BTW_LAYOUT_VALUES,
+            action: "set-layout",
+          },
           ...BTW_SHORTCUT_ACTIONS.map((action) => ({
             id: action,
             label: shortcutLabels[action],
@@ -555,6 +572,21 @@ export async function showBtwCommandMenu(
           return { kind: "rejected" };
         }
       },
+      "set-layout": async ({ value, signal }) => {
+        const layout = Object.entries(BTW_LAYOUT_LABELS).find(([, label]) => label === value)?.[0] as
+          | BtwLayout
+          | undefined;
+        if (!layout) return { kind: "rejected" };
+        try {
+          await updateSettings({ layout }, { settingsPath, signal });
+          if (signal.aborted) return { kind: "rejected" };
+          notifySafely(ctx, `Pi BTW layout: ${BTW_LAYOUT_LABELS[layout]}. Applies when BTW next opens.`, "info");
+          return { kind: "stay" };
+        } catch (error) {
+          if (!signal.aborted) notifySaveFailure(ctx, error);
+          return { kind: "rejected" };
+        }
+      },
     },
   });
 

package/node_modules/@narumitw/pi-btw/src/settings.ts

@@ -7,8 +7,14 @@ import { BTW_SHORTCUT_ACTIONS, type BtwKeybindingOverrides, normalizeBtwKey } fr
 import { BTW_THINKING_LEVELS, type BtwThinkingLevel } from "./side-thread.js";
 
 export const BTW_SETTINGS_FILE = "pi-btw.json";
+export const BTW_LAYOUTS = ["fullscreen", "left-pane", "right-pane"] as const;
+export type BtwLayout = (typeof BTW_LAYOUTS)[number];
+export const DEFAULT_BTW_LAYOUT: BtwLayout = "fullscreen";
 export const DEFAULT_FULLSCREEN_COPY_ON_SELECT = true;
 export const DEFAULT_REMEMBER_THINKING_LEVEL_CHANGES = true;
+export const DEFAULT_BTW_SIDE_PANE_RATIO = 0.5;
+export const MIN_BTW_SIDE_PANE_RATIO = 0.2;
+export const MAX_BTW_SIDE_PANE_RATIO = 0.8;
 const MAX_SETTINGS_BYTES = 64 * 1024;
 
 export interface BtwSettings {
@@ -17,6 +23,8 @@ export interface BtwSettings {
   thinkingLevel?: BtwThinkingLevel;
   rememberThinkingLevelChanges?: boolean;
   fullscreenCopyOnSelect?: boolean;
+  layout?: BtwLayout;
+  sidePaneRatio?: number;
 }
 
 export type BtwSettingsLoadResult =
@@ -30,6 +38,8 @@ export interface BtwSettingsPatch {
   thinkingLevel?: BtwThinkingLevel;
   rememberThinkingLevelChanges?: boolean;
   fullscreenCopyOnSelect?: boolean;
+  layout?: BtwLayout;
+  sidePaneRatio?: number;
 }
 
 export interface UpdateBtwSettingsOptions {
@@ -83,6 +93,16 @@ export function normalizeBtwSettings(value: unknown): BtwSettings | undefined {
     if (typeof copyOnSelect !== "boolean") return undefined;
     settings.fullscreenCopyOnSelect = copyOnSelect;
   }
+  if (Object.hasOwn(value, "layout")) {
+    const layout = Reflect.get(value, "layout");
+    if (!isBtwLayout(layout)) return undefined;
+    settings.layout = layout;
+  }
+  if (Object.hasOwn(value, "sidePaneRatio")) {
+    const sidePaneRatio = Reflect.get(value, "sidePaneRatio");
+    if (!isBtwSidePaneRatio(sidePaneRatio)) return undefined;
+    settings.sidePaneRatio = sidePaneRatio;
+  }
   return settings;
 }
 
@@ -93,6 +113,10 @@ export function parseBtwModelReference(reference: string): { provider: string; m
   return { provider: reference.slice(0, separator), modelId: reference.slice(separator + 1) };
 }
 
+export function effectiveBtwLayout(settings: BtwSettings): BtwLayout {
+  return settings.layout ?? DEFAULT_BTW_LAYOUT;
+}
+
 export function effectiveFullscreenCopyOnSelect(settings: BtwSettings): boolean {
   return settings.fullscreenCopyOnSelect ?? DEFAULT_FULLSCREEN_COPY_ON_SELECT;
 }
@@ -101,6 +125,10 @@ export function effectiveRememberThinkingLevelChanges(settings: BtwSettings): bo
   return settings.rememberThinkingLevelChanges ?? DEFAULT_REMEMBER_THINKING_LEVEL_CHANGES;
 }
 
+export function effectiveBtwSidePaneRatio(settings: BtwSettings): number {
+  return isBtwSidePaneRatio(settings.sidePaneRatio) ? settings.sidePaneRatio : DEFAULT_BTW_SIDE_PANE_RATIO;
+}
+
 export async function readBtwSettings(settingsPath = btwSettingsPath()): Promise<BtwSettingsLoadResult> {
   await awaitBtwSettingsWrites(settingsPath);
   return readBtwSettingsUncoordinated(settingsPath);
@@ -270,6 +298,14 @@ function applyBtwSettingsPatch(current: SettingsDocument, patch: BtwSettingsPatc
     if (patch.fullscreenCopyOnSelect === undefined) delete updated.fullscreenCopyOnSelect;
     else updated.fullscreenCopyOnSelect = patch.fullscreenCopyOnSelect;
   }
+  if (Object.hasOwn(patch, "layout")) {
+    if (patch.layout === undefined) delete updated.layout;
+    else updated.layout = patch.layout;
+  }
+  if (Object.hasOwn(patch, "sidePaneRatio")) {
+    if (patch.sidePaneRatio === undefined) delete updated.sidePaneRatio;
+    else updated.sidePaneRatio = patch.sidePaneRatio;
+  }
   return updated;
 }
 
@@ -281,6 +317,19 @@ function isBtwThinkingLevel(value: unknown): value is BtwThinkingLevel {
   return BTW_THINKING_LEVELS.includes(value as BtwThinkingLevel);
 }
 
+function isBtwLayout(value: unknown): value is BtwLayout {
+  return BTW_LAYOUTS.includes(value as BtwLayout);
+}
+
+function isBtwSidePaneRatio(value: unknown): value is number {
+  return (
+    typeof value === "number" &&
+    Number.isFinite(value) &&
+    value >= MIN_BTW_SIDE_PANE_RATIO &&
+    value <= MAX_BTW_SIDE_PANE_RATIO
+  );
+}
+
 function invalidSettingsError(settingsPath: string, reason: string): Error {
   return new Error(`pi-btw settings at ${settingsPath} are invalid: ${reason}`);
 }

package/node_modules/@narumitw/pi-btw/src/transcript-pager.ts

@@ -23,10 +23,10 @@ import {
   VStack,
   visibleWidth,
 } from "@earendil-works/pi-tui";
-import type { BtwFullscreenLayoutComponent } from "./fullscreen-ui.js";
 import { BtwPasteGuard, type BtwShortcuts, getBtwShortcuts } from "./keybindings.js";
 import type { BtwThinkingLevel, SideThreadTurn } from "./side-thread.js";
 import { sanitizeSingleLine } from "./text.js";
+import type { BtwFullscreenLayoutComponent } from "./workspace-layout.js";
 
 const TRANSCRIPT_CHROME_LINES = 2;
 const MAX_STEERING_DISPLAY_LINES = 3;
@@ -146,6 +146,10 @@ export class BtwTranscriptPager implements BtwFullscreenLayoutComponent, Focusab
     return this.layoutRoot;
   }
 
+  getPrimaryScrollView(): ScrollView {
+    return this.scrollView;
+  }
+
   render(width: number): string[] {
     if (width <= 0) return [];
     const safeWidth = Math.max(1, width);
@@ -397,6 +401,10 @@ export class BtwAnsweringView implements BtwFullscreenLayoutComponent, Focusable
     return this.layoutRoot;
   }
 
+  getPrimaryScrollView(): ScrollView {
+    return this.scrollView;
+  }
+
   render(width: number): string[] {
     if (width <= 0) return [];
     const safeWidth = Math.max(1, width);