pi-ui-extend 0.1.32 → 0.1.34

package/dist/app/session/session-history.js

@@ -2,7 +2,8 @@ import { isRecord } from "../guards.js";
 import { createId } from "../id.js";
 import { isOnlyHiddenMetadata } from "../../markdown-format.js";
 import { extractImageContents, renderContent, renderUserMessageContent, stringifyUnknown } from "../rendering/message-content.js";
-import { PIX_SESSION_ENTRY_ID_FIELD, PIX_SYSTEM_MESSAGE_CUSTOM_TYPE } from "./pix-system-message.js";
+import { THINKING_TOOL_NAME } from "../constants.js";
+import { PIX_SESSION_ENTRY_ID_FIELD, PIX_SYSTEM_MESSAGE_CUSTOM_TYPE, PIX_THINKING_LEVEL_FIELD } from "./pix-system-message.js";
 const HISTORICAL_SUBAGENTS_OBSERVATION = { showSnapshot: false };
 const DEFAULT_HISTORY_CHUNK_SIZE = 50;
 const DEFAULT_HISTORY_TAIL_MESSAGE_COUNT = 80;
@@ -178,6 +179,9 @@ function renderAssistantHistoryMessage(message, toolResults, options) {
     const content = message.content;
     if (!Array.isArray(content))
         return;
+    const messageThinkingLevel = typeof message[PIX_THINKING_LEVEL_FIELD] === "string"
+        ? message[PIX_THINKING_LEVEL_FIELD]
+        : undefined;
     let assistantText = "";
     let thinkingText = "";
     for (const block of content) {
@@ -186,7 +190,14 @@ function renderAssistantHistoryMessage(message, toolResults, options) {
         if (block.type === "toolCall") {
             // Flush accumulated text/thinking before tool call.
             if (thinkingText) {
-                options.addEntry({ id: createId("thinking"), kind: "thinking", text: thinkingText, expanded: false, status: "done" });
+                options.addEntry({
+                    id: createId("thinking"),
+                    kind: "thinking",
+                    text: thinkingText,
+                    expanded: options.toolDefaultExpanded(THINKING_TOOL_NAME),
+                    ...(messageThinkingLevel === undefined ? {} : { level: messageThinkingLevel }),
+                    status: "done",
+                });
                 thinkingText = "";
             }
             if (assistantText && !isOnlyHiddenMetadata(assistantText)) {
@@ -195,6 +206,7 @@ function renderAssistantHistoryMessage(message, toolResults, options) {
             assistantText = "";
             const toolCallId = String(block.id ?? createId("tool"));
             const result = toolResults.get(toolCallId);
+            const isPendingToolCall = result === undefined && message.stopReason !== "aborted" && message.stopReason !== "error";
             const toolName = result?.toolName ?? String(block.name ?? "unknown");
             const argsText = stringifyUnknown(block.arguments);
             const output = result ? renderContent(result.content) : "";
@@ -213,7 +225,7 @@ function renderAssistantHistoryMessage(message, toolResults, options) {
                 ...(result?.details === undefined ? {} : { details: result.details }),
                 expanded: options.toolDefaultExpanded(toolName),
                 isError: result?.isError ?? false,
-                status: "done",
+                status: isPendingToolCall ? "running" : "done",
             });
             options.setToolEntryId(toolCallId, entryId);
         }
@@ -226,7 +238,14 @@ function renderAssistantHistoryMessage(message, toolResults, options) {
     }
     // Flush remaining text.
     if (thinkingText) {
-        options.addEntry({ id: createId("thinking"), kind: "thinking", text: thinkingText, expanded: false, status: "done" });
+        options.addEntry({
+            id: createId("thinking"),
+            kind: "thinking",
+            text: thinkingText,
+            expanded: options.toolDefaultExpanded(THINKING_TOOL_NAME),
+            ...(messageThinkingLevel === undefined ? {} : { level: messageThinkingLevel }),
+            status: "done",
+        });
     }
     if (assistantText && !isOnlyHiddenMetadata(assistantText)) {
         options.addEntry({ id: createId("assistant"), kind: "assistant", text: assistantText });

package/dist/app/session/tabs-controller.d.ts

@@ -3,10 +3,12 @@ import type { BindCurrentSessionOptions } from "./session-lifecycle-controller.j
 import type { AppSessionEventControllerState } from "./session-event-controller.js";
 import type { InputEditorDraftState } from "../../input-editor.js";
 import type { AppBlinkController } from "../screen/blink-controller.js";
+import type { AppScrollState } from "../screen/scroll-controller.js";
 import type { AppOptions, Entry, SessionActivity, SessionTab, SubmittedUserMessage } from "../types.js";
 type TabSessionView = {
     entries: Entry[];
     eventState: AppSessionEventControllerState;
+    scrollState: AppScrollState;
 };
 export type TabInputState = InputEditorDraftState;
 export type AppTabsControllerHost = {
@@ -31,10 +33,13 @@ export type AppTabsControllerHost = {
     }): Promise<boolean>;
     captureSessionView?(): TabSessionView;
     restoreSessionView?(view: TabSessionView): void;
+    restoreScrollState?(state: AppScrollState): void;
     syncUserSessionEntryMetadata(): void;
     captureInputState(): TabInputState;
     restoreInputState(state: TabInputState): void;
     closeMenusForTabSwitch?(): void;
+    captureAutoUserMessages?(): readonly SubmittedUserMessage[];
+    restoreAutoUserMessages?(messages: readonly SubmittedUserMessage[]): void;
     captureDeferredUserMessages?(): readonly SubmittedUserMessage[];
     restoreDeferredUserMessages?(messages: readonly SubmittedUserMessage[]): void;
     addEntry(entry: Entry): void;
@@ -50,8 +55,10 @@ export declare class AppTabsController {
     private readonly runtimeRefreshTimersByTabId;
     private readonly historyReloadTimersByTabId;
     private readonly inputStatesByTabId;
+    private readonly autoUserMessagesByTabId;
     private readonly deferredUserMessagesByTabId;
     private readonly sessionViewsByTabId;
+    private readonly scrollStatesByTabId;
     private readonly tabIdsNeedingHistoryReload;
     private activeTabId;
     private pendingActiveTabId;
@@ -92,6 +99,7 @@ export declare class AppTabsController {
     private clearStartupTabPlaceholders;
     private storeActiveRuntime;
     private storeActiveSessionView;
+    private restoreStoredScrollState;
     private setRuntimeForTab;
     private deleteRuntimeForTab;
     private clearRuntimeSubscriptions;
@@ -116,7 +124,8 @@ export declare class AppTabsController {
     private replaceTabs;
     private removeTab;
     private restorePersistedInputStates;
-    private restorePersistedDeferredUserMessages;
+    private restorePersistedScrollStates;
+    private restorePersistedQueuedUserMessages;
     private ensureCurrentSessionTab;
     private tabFromSession;
     private updateTabFromSession;
@@ -136,6 +145,7 @@ export declare class AppTabsController {
     private refreshRestoredTabTitles;
     private loadTabs;
     private parsePersistedInputState;
+    private parsePersistedScrollState;
     private parsePersistedSubmittedUserMessages;
     private saveTabs;
     private filePath;

package/dist/app/session/tabs-controller.js

@@ -6,12 +6,12 @@ import { getAgentDir, } from "@earendil-works/pi-coding-agent";
 import { isRecord } from "../guards.js";
 import { createId } from "../id.js";
 import { tabPanelRows } from "../rendering/tab-line-renderer.js";
-const TAB_STATE_VERSION = 3;
+const TAB_STATE_VERSION = 4;
 const MAX_RESTORED_TABS = 8;
 const BACKGROUND_PREWARM_TAB_LIMIT = 2;
 const TAB_ATTENTION_BLINK_KEY = "tab-attention";
 const LOADING_TAB_TITLE_PATTERN = /^loading(?:…|\.\.\.)?$/iu;
-const DEFAULT_SESSION_TITLE_PATTERN = /^session [0-9a-f]{8}$/iu;
+const DEFAULT_SESSION_TITLE_PATTERN = /^(?:session )?[0-9a-f]{8}$/iu;
 const SESSION_TITLE_HEAD_SCAN_MAX_BYTES = 256 * 1024;
 const SESSION_TITLE_SCAN_MAX_BYTES = 2 * 1024 * 1024;
 export class AppTabsController {
@@ -23,8 +23,10 @@ export class AppTabsController {
     runtimeRefreshTimersByTabId = new Map();
     historyReloadTimersByTabId = new Map();
     inputStatesByTabId = new Map();
+    autoUserMessagesByTabId = new Map();
     deferredUserMessagesByTabId = new Map();
     sessionViewsByTabId = new Map();
+    scrollStatesByTabId = new Map();
     tabIdsNeedingHistoryReload = new Set();
     activeTabId;
     pendingActiveTabId;
@@ -195,7 +197,7 @@ export class AppTabsController {
                 : restoredTabs[0]?.sessionPath;
         this.replaceTabs(restoredTabs, desiredPath);
         this.restorePersistedInputStates(saved);
-        this.restorePersistedDeferredUserMessages(saved);
+        this.restorePersistedQueuedUserMessages(saved);
         const restoredSessionPaths = saved.tabs.map((tab) => tab.path);
         if (explicitSessionPath && currentPath)
             this.ensureCurrentSessionTab(runtime.session);
@@ -230,6 +232,7 @@ export class AppTabsController {
         this.clearStartupTabPlaceholders();
         if (this.activeTabId)
             this.restoreInputState(this.activeTabId);
+        this.restorePersistedScrollStates(saved);
         await this.saveTabs();
         this.scheduleProjectSessionRetention();
         this.scheduleTabPrewarm();
@@ -248,6 +251,7 @@ export class AppTabsController {
             return;
         this.cancelHistoryLoad();
         this.syncActiveTabFromRuntime();
+        this.storeActiveSessionView();
         this.storeActiveInputState();
         this.storeActiveDeferredUserMessages();
         const previousTabId = this.activeTabId;
@@ -347,6 +351,7 @@ export class AppTabsController {
             return true;
         }
         this.cancelHistoryLoad();
+        this.storeActiveSessionView();
         this.storeActiveInputState();
         this.storeActiveDeferredUserMessages();
         const previousTabId = this.activeTabId;
@@ -455,6 +460,7 @@ export class AppTabsController {
         }
         this.cancelHistoryLoad();
         this.syncActiveTabFromRuntime({ save: false });
+        this.storeActiveSessionView();
         this.storeActiveInputState();
         this.storeActiveDeferredUserMessages();
         const previousTabId = this.activeTabId;
@@ -670,6 +676,7 @@ export class AppTabsController {
             this.tabItems.splice(index, 1);
             this.deleteRuntimeForTab(tabId);
             this.inputStatesByTabId.delete(tabId);
+            this.autoUserMessagesByTabId.delete(tabId);
             this.deferredUserMessagesByTabId.delete(tabId);
             this.storeActiveInputState();
             this.storeActiveDeferredUserMessages();
@@ -697,6 +704,7 @@ export class AppTabsController {
         this.tabItems.splice(index, 1);
         this.deleteRuntimeForTab(tabId);
         this.inputStatesByTabId.delete(tabId);
+        this.autoUserMessagesByTabId.delete(tabId);
         this.deferredUserMessagesByTabId.delete(tabId);
         this.stopAttentionBlinkIfIdle();
         this.activeTabId = nextTab.id;
@@ -732,6 +740,7 @@ export class AppTabsController {
         this.updateTabFromSession(tab, runtime.session);
         this.setRuntimeForTab(tab.id, runtime);
         this.inputStatesByTabId.delete(tab.id);
+        this.autoUserMessagesByTabId.delete(tab.id);
         this.deferredUserMessagesByTabId.delete(tab.id);
         this.restoreInputState(tab.id);
         this.host.closeMenusForTabSwitch?.();
@@ -770,6 +779,7 @@ export class AppTabsController {
         });
         if (!completed || isCancelled())
             return;
+        this.restoreStoredScrollState(this.activeTabId);
         this.host.setSessionStatus(runtime.session);
         this.host.syncUserSessionEntryMetadata();
         this.host.setSessionActivity(this.sessionActivity(runtime.session));
@@ -824,7 +834,17 @@ export class AppTabsController {
     storeActiveSessionView() {
         if (!this.activeTabId || !this.host.captureSessionView)
             return;
-        this.sessionViewsByTabId.set(this.activeTabId, this.host.captureSessionView());
+        const view = this.host.captureSessionView();
+        this.sessionViewsByTabId.set(this.activeTabId, view);
+        this.scrollStatesByTabId.set(this.activeTabId, view.scrollState);
+    }
+    restoreStoredScrollState(tabId) {
+        if (!tabId || !this.host.restoreScrollState)
+            return;
+        const scrollState = this.scrollStatesByTabId.get(tabId);
+        if (!scrollState)
+            return;
+        this.host.restoreScrollState(scrollState);
     }
     setRuntimeForTab(tabId, runtime) {
         this.runtimesByTabId.set(tabId, runtime);
@@ -834,6 +854,7 @@ export class AppTabsController {
         this.runtimesByTabId.delete(tabId);
         this.runtimeLoadsByTabId.delete(tabId);
         this.sessionViewsByTabId.delete(tabId);
+        this.scrollStatesByTabId.delete(tabId);
         this.clearRuntimeRefreshTimers(tabId);
         this.clearHistoryReloadTimers(tabId);
         this.tabIdsNeedingHistoryReload.delete(tabId);
@@ -977,11 +998,18 @@ export class AppTabsController {
         });
     }
     storeActiveDeferredUserMessages() {
-        if (!this.activeTabId || !this.host.captureDeferredUserMessages)
+        if (!this.activeTabId)
             return;
-        const messages = this.host.captureDeferredUserMessages();
-        if (messages.length > 0) {
-            this.deferredUserMessagesByTabId.set(this.activeTabId, messages.map((message) => this.cloneSubmittedUserMessage(message)));
+        const autoMessages = this.host.captureAutoUserMessages?.() ?? [];
+        if (autoMessages.length > 0) {
+            this.autoUserMessagesByTabId.set(this.activeTabId, autoMessages.map((message) => this.cloneSubmittedUserMessage(message)));
+        }
+        else {
+            this.autoUserMessagesByTabId.delete(this.activeTabId);
+        }
+        const deferredMessages = this.host.captureDeferredUserMessages?.() ?? [];
+        if (deferredMessages.length > 0) {
+            this.deferredUserMessagesByTabId.set(this.activeTabId, deferredMessages.map((message) => this.cloneSubmittedUserMessage(message)));
         }
         else {
             this.deferredUserMessagesByTabId.delete(this.activeTabId);
@@ -994,6 +1022,7 @@ export class AppTabsController {
         return { text, cursor: text.length };
     }
     restoreDeferredUserMessages(tabId) {
+        this.host.restoreAutoUserMessages?.(this.autoUserMessagesByTabId.get(tabId) ?? []);
         this.host.restoreDeferredUserMessages?.(this.deferredUserMessagesByTabId.get(tabId) ?? []);
     }
     cloneSubmittedUserMessage(message) {
@@ -1050,8 +1079,10 @@ export class AppTabsController {
         this.runtimesByTabId.clear();
         this.clearRuntimeSubscriptions();
         this.inputStatesByTabId.clear();
+        this.autoUserMessagesByTabId.clear();
         this.deferredUserMessagesByTabId.clear();
         this.sessionViewsByTabId.clear();
+        this.scrollStatesByTabId.clear();
         const seen = new Set();
         for (const tab of tabs) {
             const sessionPath = tab.sessionPath ? resolve(tab.sessionPath) : undefined;
@@ -1081,6 +1112,7 @@ export class AppTabsController {
             this.tabItems.splice(index, 1);
         this.deleteRuntimeForTab(tabId);
         this.inputStatesByTabId.delete(tabId);
+        this.autoUserMessagesByTabId.delete(tabId);
         this.deferredUserMessagesByTabId.delete(tabId);
     }
     restorePersistedInputStates(saved) {
@@ -1099,20 +1131,44 @@ export class AppTabsController {
             this.inputStatesByTabId.set(tab.id, input);
         }
     }
-    restorePersistedDeferredUserMessages(saved) {
-        const messagesByPath = new Map();
+    restorePersistedScrollStates(saved) {
+        const scrollStatesByPath = new Map();
         for (const tab of saved.tabs) {
-            if (!tab.deferredUserMessages || tab.deferredUserMessages.length === 0)
+            if (!tab.scrollState)
                 continue;
-            messagesByPath.set(resolve(tab.path), tab.deferredUserMessages.map((message) => this.cloneSubmittedUserMessage(message)));
+            scrollStatesByPath.set(resolve(tab.path), tab.scrollState);
         }
         for (const tab of this.tabItems) {
             if (!tab.sessionPath)
                 continue;
-            const messages = messagesByPath.get(resolve(tab.sessionPath));
-            if (!messages || messages.length === 0)
+            const scrollState = scrollStatesByPath.get(resolve(tab.sessionPath));
+            if (!scrollState)
                 continue;
-            this.deferredUserMessagesByTabId.set(tab.id, messages);
+            this.scrollStatesByTabId.set(tab.id, scrollState);
+        }
+    }
+    restorePersistedQueuedUserMessages(saved) {
+        const autoMessagesByPath = new Map();
+        const deferredMessagesByPath = new Map();
+        for (const tab of saved.tabs) {
+            const sessionPath = resolve(tab.path);
+            if (tab.autoUserMessages && tab.autoUserMessages.length > 0) {
+                autoMessagesByPath.set(sessionPath, tab.autoUserMessages.map((message) => this.cloneSubmittedUserMessage(message)));
+            }
+            if (tab.deferredUserMessages && tab.deferredUserMessages.length > 0) {
+                deferredMessagesByPath.set(sessionPath, tab.deferredUserMessages.map((message) => this.cloneSubmittedUserMessage(message)));
+            }
+        }
+        for (const tab of this.tabItems) {
+            if (!tab.sessionPath)
+                continue;
+            const sessionPath = resolve(tab.sessionPath);
+            const autoMessages = autoMessagesByPath.get(sessionPath);
+            if (autoMessages && autoMessages.length > 0)
+                this.autoUserMessagesByTabId.set(tab.id, autoMessages);
+            const deferredMessages = deferredMessagesByPath.get(sessionPath);
+            if (deferredMessages && deferredMessages.length > 0)
+                this.deferredUserMessagesByTabId.set(tab.id, deferredMessages);
         }
     }
     ensureCurrentSessionTab(session) {
@@ -1157,7 +1213,7 @@ export class AppTabsController {
     }
     sessionTitleFromParts(sessionId, sessionName) {
         const name = sessionName?.trim();
-        return name && !LOADING_TAB_TITLE_PATTERN.test(name) ? name : `session ${sessionId.slice(0, 8)}`;
+        return name && !LOADING_TAB_TITLE_PATTERN.test(name) ? name : sessionId.slice(0, 8);
     }
     updatedSessionTitle(currentTitle, nextTitle, currentSessionPath, nextSessionPath, hasTitlePlaceholder) {
         if (!isDefaultSessionTitle(nextTitle))
@@ -1204,8 +1260,8 @@ export class AppTabsController {
         for (const tab of saved.tabs) {
             const sessionPath = resolve(tab.path);
             const hasDraftInput = (tab.input?.text.length ?? 0) > 0;
-            const hasDeferredQueue = (tab.deferredUserMessages?.length ?? 0) > 0;
-            if (seen.has(sessionPath) || (!existsSync(sessionPath) && !hasDraftInput && !hasDeferredQueue))
+            const hasQueuedMessages = (tab.autoUserMessages?.length ?? 0) > 0 || (tab.deferredUserMessages?.length ?? 0) > 0;
+            if (seen.has(sessionPath) || (!existsSync(sessionPath) && !hasDraftInput && !hasQueuedMessages))
                 continue;
             seen.add(sessionPath);
             const savedTitle = tab.title?.trim();
@@ -1227,7 +1283,7 @@ export class AppTabsController {
         const fileName = basename(sessionPath, extname(sessionPath));
         const sessionId = /^[0-9a-f]{8}/iu.exec(fileName)?.[0]?.toLowerCase()
             ?? createHash("sha256").update(sessionPath).digest("hex").slice(0, 8);
-        return `session ${sessionId}`;
+        return sessionId;
     }
     async loadSessionTitles(sessionPaths) {
         const uniquePaths = [...new Set(sessionPaths.map((sessionPath) => resolve(sessionPath)))].slice(0, MAX_RESTORED_TABS);
@@ -1267,23 +1323,27 @@ export class AppTabsController {
         try {
             const raw = await readFile(this.filePath(), "utf8");
             const parsed = JSON.parse(raw);
-            if (!isRecord(parsed) || (parsed.version !== 1 && parsed.version !== 2 && parsed.version !== TAB_STATE_VERSION) || !Array.isArray(parsed.tabs))
+            if (!isRecord(parsed) || (parsed.version !== 1 && parsed.version !== 2 && parsed.version !== 3 && parsed.version !== TAB_STATE_VERSION) || !Array.isArray(parsed.tabs))
                 return undefined;
             const tabs = [];
             for (const value of parsed.tabs) {
                 if (!isRecord(value) || typeof value.path !== "string")
                     continue;
                 const input = this.parsePersistedInputState(value.input);
+                const scrollState = this.parsePersistedScrollState(value.scrollState);
+                const autoUserMessages = this.parsePersistedSubmittedUserMessages(value.autoUserMessages);
                 const deferredUserMessages = this.parsePersistedSubmittedUserMessages(value.deferredUserMessages);
                 tabs.push({
                     path: value.path,
                     ...(typeof value.title === "string" ? { title: value.title } : {}),
                     ...(input ? { input } : {}),
+                    ...(scrollState ? { scrollState } : {}),
+                    ...(autoUserMessages.length > 0 ? { autoUserMessages } : {}),
                     ...(deferredUserMessages.length > 0 ? { deferredUserMessages } : {}),
                 });
             }
             return {
-                version: parsed.version === 1 ? 1 : parsed.version === 2 ? 2 : TAB_STATE_VERSION,
+                version: parsed.version === 1 ? 1 : parsed.version === 2 ? 2 : parsed.version === 3 ? 3 : TAB_STATE_VERSION,
                 cwd: typeof parsed.cwd === "string" ? parsed.cwd : this.host.options.cwd,
                 tabs,
                 ...(typeof parsed.activePath === "string" ? { activePath: parsed.activePath } : {}),
@@ -1306,6 +1366,18 @@ export class AppTabsController {
             : [];
         return { text: value.text, cursor, ...(attachments.length > 0 ? { attachments } : {}) };
     }
+    parsePersistedScrollState(value) {
+        if (!isRecord(value) || typeof value.scrollFromBottom !== "number" || !Number.isFinite(value.scrollFromBottom))
+            return undefined;
+        const scrollFromBottom = Math.max(0, Math.trunc(value.scrollFromBottom));
+        const detachedScrollStart = typeof value.detachedScrollStart === "number" && Number.isFinite(value.detachedScrollStart)
+            ? Math.max(0, Math.trunc(value.detachedScrollStart))
+            : undefined;
+        return {
+            scrollFromBottom,
+            ...(detachedScrollStart === undefined ? {} : { detachedScrollStart }),
+        };
+    }
     parsePersistedSubmittedUserMessages(value) {
         if (!Array.isArray(value))
             return [];
@@ -1341,6 +1413,11 @@ export class AppTabsController {
                     continue;
                 seen.add(sessionPath);
                 const persistedTab = { path: sessionPath, title: tab.title };
+                const scrollState = tab.id === this.activeTabId
+                    ? this.host.captureSessionView?.().scrollState
+                    : this.sessionViewsByTabId.get(tab.id)?.scrollState ?? this.scrollStatesByTabId.get(tab.id);
+                if (scrollState)
+                    persistedTab.scrollState = scrollState;
                 const input = this.inputStatesByTabId.get(tab.id);
                 if (input && (input.text.length > 0 || (input.attachments?.length ?? 0) > 0)) {
                     persistedTab.input = {
@@ -1349,6 +1426,10 @@ export class AppTabsController {
                         ...(input.attachments && input.attachments.length > 0 ? { attachments: input.attachments.map(clonePersistedAttachment) } : {}),
                     };
                 }
+                const autoUserMessages = this.autoUserMessagesByTabId.get(tab.id);
+                if (autoUserMessages && autoUserMessages.length > 0) {
+                    persistedTab.autoUserMessages = autoUserMessages.map((message) => this.cloneSubmittedUserMessage(message));
+                }
                 const deferredUserMessages = this.deferredUserMessagesByTabId.get(tab.id);
                 if (deferredUserMessages && deferredUserMessages.length > 0) {
                     persistedTab.deferredUserMessages = deferredUserMessages.map((message) => this.cloneSubmittedUserMessage(message));

package/dist/app/types.d.ts

@@ -12,7 +12,7 @@ export type SessionActivity = "idle" | "running" | "thinking";
 export type SessionTabStatus = "active" | "waiting";
 export type SessionTabAttention = "terminal-bell";
 export type QueuedMessageMode = "steering" | "follow-up";
-export type QueuedMessageSource = "sdk-steering" | "sdk-follow-up" | "deferred";
+export type QueuedMessageSource = "sdk-steering" | "sdk-follow-up" | "auto" | "deferred";
 export type SubmittedUserMessage = {
     id: string;
     promptText: string;
@@ -73,6 +73,7 @@ export type Entry = {
     text: string;
     expanded: boolean;
     status: "running" | "done";
+    level?: string;
 } | {
     id: string;
     kind: "tool";
@@ -265,6 +266,8 @@ export type StatusLineLayout = {
     inputBorderWidgetStartColumn?: number;
     modelUsageLabel?: string;
     contextBarLabel?: string;
+    quickScrollUpWidget?: StatusQuickScrollWidgetLayout;
+    quickScrollDownWidget?: StatusQuickScrollWidgetLayout;
     userJumpWidget?: StatusUserJumpWidgetLayout;
     draftQueueWidget?: StatusDraftQueueWidgetLayout;
     thinkingExpandWidget?: StatusThinkingExpandWidgetLayout;
@@ -273,6 +276,10 @@ export type StatusLineLayout = {
     promptEnhancerWidget?: StatusPromptEnhancerWidgetLayout;
     voiceWidget?: StatusVoiceWidgetLayout;
 };
+export type StatusQuickScrollWidgetLayout = {
+    startColumn: number;
+    endColumn: number;
+};
 export type StatusUserJumpWidgetLayout = {
     startColumn: number;
     endColumn: number;
@@ -587,6 +594,12 @@ export type StatusCompactToolsTarget = {
     startColumn: number;
     endColumn: number;
 };
+export type StatusQuickScrollTarget = {
+    row: number;
+    startColumn: number;
+    endColumn: number;
+    direction: "up" | "down";
+};
 export type ParsedSlashInput = {
     commandName: string;
     hasArguments: boolean;

package/dist/bundled-extensions/question/contract.d.ts

@@ -0,0 +1,25 @@
+import { Type } from "typebox";
+import type { NormalizedQuestion, QuestionToolInput } from "./types.js";
+export declare const CUSTOM_ANSWER_LABEL = "Something else\u2026";
+export declare const CUSTOM_ANSWER_SENTINEL_VALUE = "__question_custom_answer__";
+export declare const MIN_QUESTIONS = 1;
+export declare const MAX_QUESTIONS = 5;
+export declare const MIN_CHOICES = 2;
+export declare const MAX_CHOICES = 5;
+export declare const QUESTION_ID_PATTERN: RegExp;
+export declare const questionParameters: Type.TObject<{
+    questions: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        label: Type.TString;
+        prompt: Type.TString;
+        choices: Type.TArray<Type.TObject<{
+            value: Type.TString;
+            label: Type.TString;
+            description: Type.TOptional<Type.TString>;
+        }>>;
+    }>>;
+}>;
+export declare function normalizeQuestionInput(input: QuestionToolInput): NormalizedQuestion[];
+export declare function trimString(value: string, field: string): string;
+export declare function normalizeForUniqueness(value: string): string;
+export declare function throwInvalid(problem: string, repair: string): never;

package/dist/bundled-extensions/question/contract.js

@@ -0,0 +1,94 @@
+import { Type } from "typebox";
+export const CUSTOM_ANSWER_LABEL = "Something else…";
+export const CUSTOM_ANSWER_SENTINEL_VALUE = "__question_custom_answer__";
+export const MIN_QUESTIONS = 1;
+export const MAX_QUESTIONS = 5;
+export const MIN_CHOICES = 2;
+export const MAX_CHOICES = 5;
+export const QUESTION_ID_PATTERN = /^[a-z][a-z0-9_-]*$/;
+export const questionParameters = Type.Object({
+    questions: Type.Array(Type.Object({
+        id: Type.String({ description: "Unique stable question id." }),
+        label: Type.String({ description: "Short label for the question." }),
+        prompt: Type.String({ description: "Full question prompt to show the user." }),
+        choices: Type.Array(Type.Object({
+            value: Type.String({ description: "Value returned if this choice is selected." }),
+            label: Type.String({ description: "Display label for this choice." }),
+            description: Type.Optional(Type.String({ description: "Optional supporting text for this choice." })),
+        }), {
+            minItems: MIN_CHOICES,
+            maxItems: MAX_CHOICES,
+            description: "Two to five meaningful predefined choices.",
+        }),
+    }), {
+        minItems: MIN_QUESTIONS,
+        maxItems: MAX_QUESTIONS,
+        description: "One to five questions to ask the user.",
+    }),
+});
+export function normalizeQuestionInput(input) {
+    const questions = input.questions;
+    if (!Array.isArray(questions) || questions.length < MIN_QUESTIONS || questions.length > MAX_QUESTIONS) {
+        throwInvalid(`question requires ${MIN_QUESTIONS} to ${MAX_QUESTIONS} questions; received ${Array.isArray(questions) ? questions.length : "no"}.`, "Retry with a questions array containing one to five questions.");
+    }
+    const seenQuestionIds = new Set();
+    const seenQuestionLabels = new Set();
+    return questions.map((question, questionIndex) => {
+        const questionNumber = questionIndex + 1;
+        const id = trimString(question.id, `question ${questionNumber} id`);
+        const label = trimString(question.label, `question ${questionNumber} label`);
+        const prompt = trimString(question.prompt, `question ${questionNumber} prompt`);
+        if (!QUESTION_ID_PATTERN.test(id))
+            throwInvalid(`Question ${questionNumber} has invalid id "${id}". IDs must match ${QUESTION_ID_PATTERN.source}.`, "Retry with a stable id starting with a lowercase letter and containing only lowercase letters, numbers, underscores, or hyphens.");
+        if (seenQuestionIds.has(id))
+            throwInvalid(`Duplicate question id "${id}" makes question answers ambiguous.`, "Retry with a unique stable id for each question.");
+        seenQuestionIds.add(id);
+        const normalizedLabel = normalizeForUniqueness(label);
+        if (seenQuestionLabels.has(normalizedLabel))
+            throwInvalid(`Duplicate question label "${label}" makes question summaries ambiguous.`, "Retry with a unique short label for each question; labels are compared case-insensitively.");
+        seenQuestionLabels.add(normalizedLabel);
+        if (label.includes("\n") || label.includes("\r"))
+            throwInvalid(`Question ${questionNumber} label must be single-line.`, "Retry with a short single-line label and put longer text in the prompt.");
+        if (!Array.isArray(question.choices) || question.choices.length < MIN_CHOICES || question.choices.length > MAX_CHOICES) {
+            throwInvalid(`Question "${id}" requires ${MIN_CHOICES} to ${MAX_CHOICES} predefined Choices; received ${Array.isArray(question.choices) ? question.choices.length : "no"}.`, "Retry with two to five meaningful predefined Choices for each question.");
+        }
+        const seenChoiceValues = new Set();
+        const seenChoiceLabels = new Set();
+        return {
+            id,
+            label,
+            prompt,
+            choices: question.choices.map((choice, choiceIndex) => {
+                const choiceNumber = choiceIndex + 1;
+                const value = trimString(choice.value, `question "${id}" Choice ${choiceNumber} value`);
+                const choiceLabel = trimString(choice.label, `question "${id}" Choice ${choiceNumber} label`);
+                const description = choice.description === undefined ? undefined : choice.description.trim();
+                if (value === CUSTOM_ANSWER_SENTINEL_VALUE)
+                    throwInvalid(`Question "${id}" Choice ${choiceNumber} uses the reserved Custom Answer sentinel value "${CUSTOM_ANSWER_SENTINEL_VALUE}".`, "Retry with a different Choice value; ordinary values like other or custom are allowed.");
+                const normalizedValue = normalizeForUniqueness(value);
+                if (seenChoiceValues.has(normalizedValue))
+                    throwInvalid(`Question "${id}" has duplicate Choice value "${value}".`, "Retry with unique Choice values within each question; values are compared case-insensitively.");
+                seenChoiceValues.add(normalizedValue);
+                const normalizedChoiceLabel = normalizeForUniqueness(choiceLabel);
+                if (seenChoiceLabels.has(normalizedChoiceLabel))
+                    throwInvalid(`Question "${id}" has duplicate Choice label "${choiceLabel}".`, "Retry with unique visible Choice labels within each question; labels are compared case-insensitively.");
+                seenChoiceLabels.add(normalizedChoiceLabel);
+                if (normalizedChoiceLabel === normalizeForUniqueness(CUSTOM_ANSWER_LABEL))
+                    throwInvalid(`Question "${id}" Choice label "${choiceLabel}" collides with the implicit Custom Answer row label "${CUSTOM_ANSWER_LABEL}".`, "Retry with a different predefined Choice label; the Custom Answer row is added automatically.");
+                return description === undefined ? { value, label: choiceLabel } : { value, label: choiceLabel, description };
+            }),
+        };
+    });
+}
+export function trimString(value, field) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        throwInvalid(`${field} must not be empty after trimming.`, "Retry with non-empty text for every required question field.");
+    return trimmed;
+}
+export function normalizeForUniqueness(value) {
+    return value.toLocaleLowerCase();
+}
+export function throwInvalid(problem, repair) {
+    throw new Error(`Invalid question input: ${problem} ${repair}`);
+}

package/dist/bundled-extensions/question/index.d.ts

@@ -0,0 +1,7 @@
+interface ExtensionApiLike {
+    registerTool(tool: unknown): void;
+}
+export default function questionExtension(pi: ExtensionApiLike): void;
+export { questionParameters, normalizeQuestionInput } from "./contract.js";
+export { createCanceledQuestionResult, createFallbackPrompt, createQuestionToolResult, createSuccessfulQuestionResult, summarizeQuestionResult } from "./result.js";
+export type { QuestionResultDetails, QuestionToolInput } from "./types.js";

package/dist/bundled-extensions/question/index.js

@@ -0,0 +1,28 @@
+import { QUESTION_TOOL_DESCRIPTION } from "./tool-description.js";
+import { questionParameters, normalizeQuestionInput } from "./contract.js";
+import { renderQuestionCall, renderQuestionResult } from "./render.js";
+import { createCanceledQuestionResult, createQuestionToolResult, createSuccessfulQuestionResult } from "./result.js";
+import { runQuestionnaire } from "./tui.js";
+export default function questionExtension(pi) {
+    pi.registerTool({
+        ...QUESTION_TOOL_DESCRIPTION,
+        parameters: questionParameters,
+        renderCall(args, theme) {
+            return renderQuestionCall(args, theme);
+        },
+        renderResult(result, _options, theme, context) {
+            return renderQuestionResult(result, theme, context.args);
+        },
+        async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+            const questions = normalizeQuestionInput(params);
+            if (!ctx.hasUI)
+                return createQuestionToolResult(createCanceledQuestionResult("ui_unavailable", questions), questions);
+            const selections = await runQuestionnaire(questions, ctx);
+            if (selections === null)
+                return createQuestionToolResult(createCanceledQuestionResult("user_canceled"), questions);
+            return createQuestionToolResult(createSuccessfulQuestionResult(questions, selections), questions);
+        },
+    });
+}
+export { questionParameters, normalizeQuestionInput } from "./contract.js";
+export { createCanceledQuestionResult, createFallbackPrompt, createQuestionToolResult, createSuccessfulQuestionResult, summarizeQuestionResult } from "./result.js";