@sayknow-cli/coding-agent 0.4.7 → 0.5.0

package/dist/types/modes/components/btw-panel.d.ts

@@ -6,6 +6,7 @@ interface BtwPanelComponentOptions {
 export declare class BtwPanelComponent extends Container {
     #private;
     constructor(options: BtwPanelComponentOptions);
+    beginTurn(question: string): void;
     appendText(delta: string): void;
     setAnswer(text: string): void;
     markComplete(): void;

package/dist/types/modes/components/irc-sidebar.d.ts

@@ -2,12 +2,50 @@ import { type Component, type ViewportAnchorProvider, type ViewportAnchorRender
 import type { IrcObservationLedger } from "../irc-observation-ledger";
 export declare const IRC_SIDEBAR_WIDTH_RATIO = 0.3;
 export declare const IRC_SIDEBAR_MAX_RENDER_ROWS = 2048;
+export declare const __ircSidebarPerfCounters: {
+    enabled: boolean;
+    projectionMemoHits: number;
+    projectionMemoMisses: number;
+    recordsVisited: number;
+    sourceBytes: number;
+    rows: number;
+    styledCacheHits: number;
+    styledCacheMisses: number;
+    wrapCalls: number;
+    snapshot(): {
+        projectionMemoHits: number;
+        projectionMemoMisses: number;
+        recordsVisited: number;
+        sourceBytes: number;
+        rows: number;
+        styledCacheHits: number;
+        styledCacheMisses: number;
+        wrapCalls: number;
+    };
+    enable(): void;
+    disable(): void;
+    reset(): void;
+};
 /** Computes transcript/sidebar widths while preserving at least half the terminal for the transcript. */
 export declare function computeIrcSplitWidths(width: number): {
     leftWidth: number;
     separatorWidth: number;
     rightWidth: number;
 };
+type SemanticLine = Readonly<{
+    kind: "header" | "body" | "elision" | "blank";
+    text: string;
+    sender?: string;
+    recipient?: string;
+    time?: string;
+}>;
+export type IrcSidebarSemanticProjection = Readonly<{
+    token: string;
+    lines: readonly SemanticLine[];
+}>;
+/** The authoritative bounded, display-neutral IRC sidebar projection. */
+export declare function getIrcSidebarSemanticProjection(ledger: IrcObservationLedger, width: number): IrcSidebarSemanticProjection;
+export declare function getIrcSidebarSemanticToken(ledger: IrcObservationLedger, width: number): string;
 export interface IrcSidebarTheme {
     fg(color: "dim" | "accent", text: string): string;
     bold(text: string): string;
@@ -26,7 +64,10 @@ export declare class IrcSplitViewComponent implements ViewportAnchorProvider {
     get visible(): boolean;
     effectiveSidebarVisible(width?: number): boolean;
     setVisible(visible: boolean): void;
+    invalidateTheme(): void;
+    resetSource(): void;
     render(width: number): string[];
     renderWithViewportAnchors(width: number): ViewportAnchorRender;
     invalidate(): void;
 }
+export {};

package/dist/types/modes/components/queue-pane.d.ts

@@ -1,12 +1,20 @@
 import { Container } from "@sayknow-cli/tui";
 import type { QueuedMessageEditEntry } from "../../session/agent-session";
+type QueueSelectorAction = "tui.select.confirm" | "tui.select.cancel";
+type QueueSelectorNavigationAction = "tui.select.up" | "tui.select.down" | "tui.select.pageUp" | "tui.select.pageDown";
 export declare class QueuePaneComponent extends Container {
     #private;
     constructor(entries: QueuedMessageEditEntry[], options: {
         selectedIndex?: number;
+        formatKeyHint?: (key: string) => string;
+        formatSelectAction?: (action: QueueSelectorAction) => string;
+        matchesSelectAction?: (keyData: string, action: QueueSelectorAction) => boolean;
+        resolveSelectNavigation?: (keyData: string) => QueueSelectorNavigationAction | undefined;
+        onSelect: (entry: QueuedMessageEditEntry) => void;
         onDelete: (entry: QueuedMessageEditEntry, index: number) => void;
         onMove: (entry: QueuedMessageEditEntry, index: number, direction: "up" | "down") => void;
         onClose: () => void;
     });
     handleInput(keyData: string): void;
 }
+export {};

package/dist/types/modes/components/queued-message-selector.d.ts

@@ -1,11 +1,17 @@
 import { Container, SelectList } from "@sayknow-cli/tui";
 import type { QueuedMessageEditEntry } from "../../session/agent-session";
 type QueuedMessageMoveDirection = "up" | "down";
+type QueueSelectorAction = "tui.select.confirm" | "tui.select.cancel";
+type QueueSelectorNavigationAction = "tui.select.up" | "tui.select.down" | "tui.select.pageUp" | "tui.select.pageDown";
 export type { QueuedMessageMoveDirection };
 export declare class QueuedMessageSelectorComponent extends Container {
     #private;
     constructor(entries: QueuedMessageEditEntry[], onSelect: (entry: QueuedMessageEditEntry) => void, onDelete: (entry: QueuedMessageEditEntry, selectedIndex: number) => void, onMove: (entry: QueuedMessageEditEntry, selectedIndex: number, direction: QueuedMessageMoveDirection) => void, onCancel: () => void, options?: {
         selectedIndex?: number;
+        formatKeyHint?: (key: string) => string;
+        formatSelectAction?: (action: QueueSelectorAction) => string;
+        matchesSelectAction?: (keyData: string, action: QueueSelectorAction) => boolean;
+        resolveSelectNavigation?: (keyData: string) => QueueSelectorNavigationAction | undefined;
     });
     handleInput(keyData: string): void;
     getSelectList(): SelectList;

package/dist/types/modes/components/read-tool-group.d.ts

@@ -8,12 +8,11 @@ type ReadRenderArgs = {
     file_path?: string;
     sel?: string;
 };
-type ReadToolGroupOptions = {
-    showContentPreview?: boolean;
-};
 export declare class ReadToolGroupComponent extends Container implements ToolExecutionHandle {
     #private;
-    constructor(options?: ReadToolGroupOptions);
+    constructor(options?: {
+        showContentPreview?: boolean;
+    });
     updateArgs(args: ReadRenderArgs, toolCallId?: string): void;
     updateResult(result: {
         content: Array<{
@@ -32,5 +31,6 @@ export declare class ReadToolGroupComponent extends Container implements ToolExe
      */
     setManuallyExpanded(expanded: boolean): void;
     getComponent(): Component;
+    consumeVisibleTranscriptChange(): boolean;
 }
 export {};

package/dist/types/modes/components/runtime-mcp-add-wizard.d.ts

@@ -14,12 +14,13 @@ type Scope = "user" | "project";
  */
 export interface MCPAddWizardOAuthResult {
     credentialId: string;
+    tokenEndpoint: string;
     clientId?: string;
     clientSecret?: string;
 }
 export declare class MCPAddWizard extends Container {
     #private;
-    constructor(onComplete: (name: string, config: MCPServerConfig, scope: Scope) => void, onCancel: () => void, onOAuth?: (authUrl: string, tokenUrl: string, clientId: string, clientSecret: string, scopes: string) => Promise<MCPAddWizardOAuthResult>, onTestConnection?: (config: MCPServerConfig) => Promise<void>, onRender?: () => void, initialName?: string);
+    constructor(onComplete: (name: string, config: MCPServerConfig, scope: Scope) => void, onCancel: () => void, onOAuth?: (endpointUrl: string, authUrl: string, tokenUrl: string, clientId: string, clientSecret: string, scopes: string) => Promise<MCPAddWizardOAuthResult>, onTestConnection?: (config: MCPServerConfig) => Promise<void>, onRender?: () => void, initialName?: string);
     dispose(): void;
     handleInput(keyData: string): void;
 }

package/dist/types/modes/components/session-observer-overlay.d.ts

@@ -9,4 +9,8 @@ export declare class SessionObserverOverlayComponent extends TranscriptViewerOve
     refreshFromRegistry(): void;
     handleInput(keyData: string): void;
 }
+/**
+ * This deliberately remains the eager full-history projection. PR2 owns projection
+ * virtualization/incrementalization; source acquisition above only controls snapshot safety.
+ */
 export declare function entriesFromMessages(entries: readonly SessionMessageEntry[]): TranscriptViewerEntry[];

package/dist/types/modes/components/settings-selector.d.ts

@@ -58,6 +58,8 @@ export interface SettingsCallbacks {
     getStatusLinePreview?: (width?: number) => string;
     /** Called when plugins change */
     onPluginsChanged?: () => void;
+    /** Called when an interactive setting cannot be committed. */
+    onError?: (message: string) => void;
     /** Called when settings panel is closed */
     onCancel: () => void;
 }

package/dist/types/modes/components/tool-execution.d.ts

@@ -5,6 +5,8 @@ export interface ToolExecutionOptions {
     editFuzzyThreshold?: number;
     editAllowFuzzy?: boolean;
     hashlineAutoDropPureInsertDuplicates?: boolean;
+    /** Internal observer for visible asynchronous renderer mutations. */
+    onVisibleTranscriptMutation?: () => void;
 }
 export interface ToolExecutionHandle {
     updateArgs(args: any, toolCallId?: string): void;
@@ -29,6 +31,11 @@ export interface ToolExecutionHandle {
      * back to {@link setExpanded}.
      */
     setManuallyExpanded?(expanded: boolean): void;
+    /**
+     * Internal capability for dispatchers that need exact synchronous visible-output
+     * detection. Optional so existing structural handles remain source compatible.
+     */
+    consumeVisibleTranscriptChange?(): boolean;
 }
 /**
  * Component that renders a tool call with its result (updateable)
@@ -52,6 +59,7 @@ export declare class ToolExecutionComponent extends Container {
         details?: any;
         isError?: boolean;
     }, isPartial?: boolean, _toolCallId?: string): void;
+    consumeVisibleTranscriptChange(): boolean;
     /**
      * Stop spinner animation and cleanup resources.
      */

package/dist/types/modes/components/tool-status-header.d.ts

@@ -1,5 +1,5 @@
 import { type Component } from "@sayknow-cli/tui";
-import type { AppKeybinding, KeybindingsManager } from "../../config/keybindings";
+import { type AppKeybinding, type KeybindingsManager, type KeyDisplayContext } from "../../config/keybindings";
 import type { StatusLinePreset, StatusLineSegmentId, StatusLineSeparatorStyle } from "../../config/settings-schema";
 import type { AgentSession } from "../../session/agent-session";
 import { type SkillActiveEntry } from "../../skill-state/active-state";
@@ -38,6 +38,7 @@ export interface StatusLineSettings {
     previewHighlightSegment?: StatusLineSegmentId;
     showHookStatus?: boolean;
     showSkillHud?: boolean;
+    showActionHints?: boolean;
     sessionAccent?: boolean;
     maxRows?: number;
 }
@@ -46,6 +47,7 @@ export interface StatusLineComponentOptions {
     actionRegistry?: ActionRegistry<void>;
     getKeybindings?: () => KeybindingsManager;
     focusDomain?: FocusDomain;
+    keyDisplayContext?: KeyDisplayContext;
 }
 export interface StatusLineActionHint {
     id: AppKeybinding;
@@ -56,7 +58,7 @@ export interface StatusLineActionHint {
  * remains the authority for availability; KEYBINDINGS remains the authority for
  * whether an action has a binding and the active manager supplies overrides.
  */
-export declare function getAvailableActionHints(actionRegistry: ActionRegistry<void> | undefined, getKeybindings: (() => KeybindingsManager) | undefined, width: number, domain?: FocusDomain): StatusLineActionHint[];
+export declare function getAvailableActionHints(actionRegistry: ActionRegistry<void> | undefined, getKeybindings: (() => KeybindingsManager) | undefined, width: number, domain?: FocusDomain, keyDisplayContext?: KeyDisplayContext): StatusLineActionHint[];
 export declare class StatusLineComponent implements Component {
     #private;
     private readonly session;

package/dist/types/modes/components/welcome.d.ts

@@ -1,4 +1,5 @@
 import { type Component } from "@sayknow-cli/tui";
+import { type KeyDisplayContext } from "../../config/keybindings";
 export interface RecentSession {
     name: string;
     timeAgo: string;
@@ -13,8 +14,10 @@ export interface WelcomeComponentOptions {
     getViewportRows?: () => number | undefined;
     getReservedBottomRows?: (termWidth: number) => number;
     changelogMarkdown?: string;
+    rightGutterWidth?: number;
     collapseChangelog?: boolean;
     buildLabel?: string;
+    keyDisplayContext?: KeyDisplayContext;
 }
 /**
  * Sayknow-CLI launch surface: a blue-gradient SAYKNOW wordmark, compact
@@ -44,3 +47,5 @@ export declare class WelcomeComponent implements Component {
     setLspServers(servers: LspServerInfo[]): void;
     render(termWidth: number): string[];
 }
+/** Resolve the intro cadence without making tests mutate global process state. */
+export declare function resolveWelcomeIntroTickMs(platform?: NodeJS.Platform, tmux?: string | undefined): number;

package/dist/types/modes/controllers/btw-controller.d.ts

@@ -1,10 +1,15 @@
 import type { InteractiveModeContext } from "../types";
+type BtwFollowUpResult = "accepted" | "busy" | "closed" | "rejected";
 export declare class BtwController {
     #private;
     private readonly ctx;
     constructor(ctx: InteractiveModeContext);
     hasActiveRequest(): boolean;
+    hasOpenPanel(): boolean;
+    isTurnInFlight(): boolean;
     handleEscape(): boolean;
     dispose(): void;
     start(question: string): Promise<void>;
+    submitFollowUp(question: string): Promise<BtwFollowUpResult>;
 }
+export {};

package/dist/types/modes/controllers/command-controller.d.ts

@@ -1,8 +1,10 @@
 import { type CompactionOutcome } from "@sayknow-cli/agent-core/compaction";
 import { type ProviderDetails, type UsageReport } from "@sayknow-cli/ai";
+import type { KeybindingsManager } from "../../config/keybindings";
 import type { CompactOptions } from "../../extensibility/extensions/types";
 import { theme } from "../../modes/theme/theme";
 import type { InteractiveModeContext } from "../../modes/types";
+export declare function buildHelpMarkdown(keybindings: Pick<KeybindingsManager, "getAccessibleDisplayString">): string;
 export declare class CommandController {
     #private;
     private readonly ctx;

package/dist/types/modes/controllers/event-controller.d.ts

@@ -3,7 +3,10 @@ import type { InteractiveModeContext } from "../../modes/types";
 import type { AgentSessionEvent } from "../../session/agent-session";
 /** Test-only performance counters for advisory baseline tests. */
 export declare const __eventControllerPerfCounters: {
+    enabled: boolean;
     messageUpdateContentVisits: number;
+    enable(): void;
+    disable(): void;
     reset(): void;
 };
 export declare class EventController {

package/dist/types/modes/interactive-mode.d.ts

@@ -3,7 +3,7 @@ import type { CompactionOutcome } from "@sayknow-cli/agent-core/compaction";
 import type { AssistantMessage, ImageContent, Message, UsageReport } from "@sayknow-cli/ai";
 import type { Component, EditorTheme, SlashCommand } from "@sayknow-cli/tui";
 import { Container, Loader, Spacer, Text, TUI } from "@sayknow-cli/tui";
-import { KeybindingsManager } from "../config/keybindings";
+import { KeybindingsManager, type KeyDisplayContext } from "../config/keybindings";
 import { type Settings } from "../config/settings";
 import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
 import type { CompactOptions } from "../extensibility/extensions/types";
@@ -30,10 +30,16 @@ import { GoalModeController } from "./controllers/goal-mode-controller";
 import { PlanModeController } from "./controllers/plan-mode-controller";
 import { IrcObservationLedger } from "./irc-observation-ledger";
 import { OAuthManualInputManager } from "./oauth-manual-input";
+import { PromptSuggestionController } from "./prompt-suggestion-controller";
 import type { Theme } from "./theme/theme";
 import { type CompactionQueuedMessage, type ComposerSubmissionOptions, type InteractiveModeContext, type IrcArrivalSnapshot, type SubmittedUserInput, type TodoItem, type TodoPhase, type TranscriptRebuildPolicy } from "./types";
 import type { ParsedIrcMessage } from "./utils/irc-message";
+export declare function getDefaultComposerPlaceholder(context?: KeyDisplayContext, keybindings?: Pick<KeybindingsManager, "getDisplayString">): string;
 export declare const DEFAULT_COMPOSER_PLACEHOLDER: string;
+export declare function getComposerPlaceholder(keybindings: Pick<KeybindingsManager, "getDisplayString">, context: KeyDisplayContext, options: {
+    readonly busy: boolean;
+    readonly busyPromptMode: "steer" | "queue";
+}): string;
 export declare function getWelcomeTranscriptReservedRows(chatContainer: Container, width: number): number;
 export type WelcomeBannerSettingMode = "auto" | "unicode" | "square" | "ascii";
 export declare function resolveWelcomeLogoMode(mode: WelcomeBannerSettingMode, env?: Record<string, string | undefined>, platform?: NodeJS.Platform): WelcomeLogoMode;
@@ -50,6 +56,7 @@ export interface InteractiveModeOptions {
     /** Additional initial messages to queue */
     initialMessages?: string[];
 }
+export declare function selectShutdownDraft(editorText: string, hasActiveBtw: boolean): string;
 export declare class InteractiveMode implements InteractiveModeContext {
     #private;
     session: AgentSession;
@@ -114,12 +121,13 @@ export declare class InteractiveMode implements InteractiveModeContext {
     fileSlashCommands: Set<string>;
     skillCommands: Map<string, Skill>;
     oauthManualInput: OAuthManualInputManager;
+    promptSuggestion: PromptSuggestionController;
     readonly lspServers: LspStartupServerInfo[] | undefined;
     mcpManager?: import("../runtime-mcp").MCPManager;
     /** Direct controller capabilities for consumers that coordinate mode transitions. */
     get planModeController(): PlanModeController;
     get goalModeController(): GoalModeController;
-    constructor(session: AgentSession, version: string, changelogMarkdown?: string | undefined, setToolUIContext?: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers?: LspStartupServerInfo[] | undefined, mcpManager?: import("../runtime-mcp").MCPManager, eventBus?: EventBus);
+    constructor(session: AgentSession, version: string, changelogMarkdown?: string | undefined, setToolUIContext?: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers?: LspStartupServerInfo[] | undefined, mcpManager?: import("../runtime-mcp").MCPManager, eventBus?: EventBus, keyDisplayContext?: KeyDisplayContext);
     getCurrentSessionNotificationStatus(): NotificationSessionStatus | undefined;
     setCurrentSessionNotificationsEnabled(enabled: boolean): Promise<NotificationSessionReconcileResult | undefined>;
     init(): Promise<void>;
@@ -173,6 +181,8 @@ export declare class InteractiveMode implements InteractiveModeContext {
     }): Promise<void>;
     flushPendingBashComponents(): void;
     isKnownSlashCommand(text: string): boolean;
+    /** Advances the sticky-viewport source only for semantic transcript output. */
+    recordVisibleTranscriptMutation(): void;
     addMessageToChat(message: AgentMessage, options?: {
         populateHistory?: boolean;
     }): Component[];
@@ -261,6 +271,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleImagePaste(): Promise<boolean>;
     handleBtwCommand(question: string): Promise<void>;
     hasActiveBtw(): boolean;
+    handleBtwFollowUp(question: string): Promise<"accepted" | "busy" | "closed" | "rejected">;
     handleBtwEscape(): boolean;
     cycleThinkingLevel(): void;
     cycleRoleModel(options?: {

package/dist/types/modes/irc-observation-ledger.d.ts

@@ -1,5 +1,18 @@
 import type { ParsedIrcMessage } from "./utils/irc-message";
 type InlineMode = "persistent" | "ephemeral";
+export declare const IRC_OBSERVATION_LEDGER_MAX_RECORDS = 10000;
+export declare const IRC_OBSERVATION_LEDGER_MAX_RETAINED_UTF8_BYTES: number;
+export declare const IRC_OBSERVATION_LEDGER_MAX_SEEN_IDENTITIES = 100000;
+export declare const __ircLedgerPerfCounters: {
+    enabled: boolean;
+    epochAdvances: number;
+    snapshot(): {
+        epochAdvances: number;
+    };
+    enable(): void;
+    disable(): void;
+    reset(): void;
+};
 export type IrcObservationRecord = Readonly<ParsedIrcMessage & {
     mode: InlineMode;
     observedAt: number;
@@ -10,6 +23,7 @@ export type IrcObservationRecord = Readonly<ParsedIrcMessage & {
 /** Runtime-only IRC observations. This intentionally has no persistence layer. */
 export declare class IrcObservationLedger {
     #private;
+    get mutationEpoch(): number;
     /** Inline observations expire after 10 seconds; closed-panel observations persist inline. */
     observe(message: ParsedIrcMessage, panelVisibleAtObservation: boolean): IrcObservationRecord | undefined;
     getRecord(observationId: string): IrcObservationRecord | undefined;
@@ -17,6 +31,8 @@ export declare class IrcObservationLedger {
     getInlineProjection(now: number): readonly IrcObservationRecord[];
     /** Returns and clears IDs whose retained payload was released. */
     drainEvictedObservationIds(): readonly string[];
-    reset(): void;
+    reset(options?: {
+        retireCurrentSessionIdentities?: boolean;
+    }): void;
 }
 export {};

package/dist/types/modes/prompt-action-autocomplete.d.ts

@@ -22,10 +22,15 @@ interface PromptActionAutocompleteOptions {
     moveCursorToMessageStart: () => void;
     moveCursorToLineStart: () => void;
     moveCursorToLineEnd: () => void;
+    /**
+     * Ghost-text next-prompt prediction shown in the empty composer as a dim
+     * inline hint (Tab accepts it via the editor's onTab handler).
+     */
+    getPromptSuggestion?: () => string | null;
 }
 export declare class PromptActionAutocompleteProvider implements AutocompleteProvider {
     #private;
-    constructor(commands: SlashCommand[], basePath: string, actions: PromptActionDefinition[]);
+    constructor(commands: SlashCommand[], basePath: string, actions: PromptActionDefinition[], getPromptSuggestion?: () => string | null);
     getSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<{
         items: AutocompleteItem[];
         prefix: string;

package/dist/types/modes/prompt-suggestion-controller.d.ts

@@ -0,0 +1,35 @@
+import type { InteractiveModeContext } from "./types";
+/**
+ * Owns the ghost-text next-prompt prediction lifecycle for interactive mode.
+ *
+ * After each agent turn ends (and only when `promptSuggestions` is enabled
+ * and the composer is empty), a smol-model prediction of the user's next
+ * prompt is generated in the background. The result renders as dim ghost
+ * text in the empty composer via the autocomplete provider's inline hint;
+ * Tab accepts it, typing dismisses it, and a new turn clears it.
+ */
+export declare class PromptSuggestionController {
+    #private;
+    constructor(ctx: InteractiveModeContext);
+    /** Current suggestion to render as ghost text, or null. */
+    get current(): string | null;
+    /** Drop the current suggestion and invalidate any in-flight generation. */
+    clear(): void;
+    /** A new agent turn started; any pending suggestion is stale. */
+    onAgentStart(): void;
+    /**
+     * Editor content changed. A non-empty composer means the user is writing
+     * their own prompt: dismiss the suggestion and cancel pending generation.
+     */
+    notifyEditorChanged(text: string): void;
+    /**
+     * Agent turn ended; kick off background generation when the feature is
+     * enabled and the composer is idle and empty.
+     */
+    onAgentEnd(): void;
+    /**
+     * Tab handler for the composer: accept the suggestion when the composer
+     * is empty. Returns true when Tab was consumed.
+     */
+    tryAcceptOnTab(text: string): boolean;
+}

package/dist/types/modes/shared/agent-wire/workflow-gate-broker.d.ts

@@ -59,7 +59,7 @@ export interface AskSelectedAckRecoveryParticipant {
 }
 /** SDK-native surface for emitting a workflow gate and awaiting its answer. */
 export interface WorkflowGateEmitter {
-    isUnattended(): boolean;
+    supportsRemoteGateAnswers(): boolean;
     emitGate(input: OpenGateInput): Promise<unknown>;
     onGateEmitted?(listener: (gate: WorkflowGate) => void): () => void;
     resolveGate?(response: WorkflowGateResponse): Promise<WorkflowGateResolution>;
@@ -96,7 +96,7 @@ export interface WorkflowGateEmitter {
 export declare class BrokerWorkflowGateEmitter implements WorkflowGateEmitter {
     #private;
     constructor(runId: string, store: GateStore, emitterHooks?: Pick<BrokerHooks, "advance">);
-    isUnattended(): boolean;
+    supportsRemoteGateAnswers(): boolean;
     setRuntimeTurnProvider(provider: (() => string | undefined) | null): void;
     emitGate(input: OpenGateInput): Promise<unknown>;
     onGateEmitted(listener: (gate: WorkflowGate) => void): () => void;

package/dist/types/modes/types.d.ts

@@ -27,6 +27,7 @@ import type { ToolExecutionHandle } from "./components/tool-execution";
 import type { StatusLineComponent } from "./components/tool-status-header";
 import type { IrcObservationLedger } from "./irc-observation-ledger";
 import type { OAuthManualInputManager } from "./oauth-manual-input";
+import type { PromptSuggestionController } from "./prompt-suggestion-controller";
 import type { Theme } from "./theme/theme";
 import type { ParsedIrcMessage } from "./utils/irc-message";
 export type TranscriptRebuildPolicy = "replace-identity" | "reconcile-same-transcript";
@@ -133,6 +134,8 @@ export interface InteractiveModeContext {
     skillCommands: Map<string, Skill>;
     oauthManualInput: OAuthManualInputManager;
     todoPhases: TodoPhase[];
+    /** Ghost-text next-prompt prediction; absent in ACP/lightweight test contexts. */
+    promptSuggestion?: PromptSuggestionController;
     init(): Promise<void>;
     shutdown(): Promise<void>;
     checkShutdownRequested(): Promise<void>;
@@ -215,6 +218,8 @@ export interface InteractiveModeContext {
     getAssistantViewportAnchorId?(message: AssistantMessage): string;
     findLastAssistantMessage(): AssistantMessage | undefined;
     extractAssistantText(message: AssistantMessage): string;
+    /** Records one semantic visible-transcript mutation for the sticky viewport. */
+    recordVisibleTranscriptMutation?(): void;
     updateEditorTopBorder(): void;
     updateEditorBorderColor(): void;
     rebuildChatFromMessages(policy: TranscriptRebuildPolicy): void;
@@ -295,6 +300,7 @@ export interface InteractiveModeContext {
     handleBackgroundCommand(): void;
     handleImagePaste(): Promise<boolean>;
     handleBtwCommand(question: string): Promise<void>;
+    handleBtwFollowUp(question: string): Promise<"accepted" | "busy" | "closed" | "rejected">;
     hasActiveBtw(): boolean;
     handleBtwEscape(): boolean;
     cycleThinkingLevel(): void;

package/dist/types/modes/utils/hotkeys-markdown.d.ts

@@ -1,5 +1,6 @@
 import type { KeybindingsManager } from "../../config/keybindings";
 export interface HotkeysMarkdownBindings {
-    keybindings: Pick<KeybindingsManager, "getDisplayString">;
+    keybindings: Pick<KeybindingsManager, "formatAccessibleKeyHint" | "getAccessibleDisplayString">;
 }
+export declare function formatHotkeyMarkdownCode(label: string, escapeTablePipes?: boolean): string;
 export declare function buildHotkeysMarkdown(bindings: HotkeysMarkdownBindings): string;

package/dist/types/modes/utils/ui-helpers.d.ts

@@ -6,6 +6,22 @@ import { type SessionContext } from "../../session/session-manager";
 import { type ParsedIrcMessage } from "./irc-message";
 export type { TranscriptRebuildPolicy } from "../../modes/types";
 export declare function prepareTranscriptRebuild(ui: TUI, policy: TranscriptRebuildPolicy): void;
+export declare const RESUME_PROGRESS_COMMIT_TIMEOUT_MS = 250;
+export interface ResumeProgressLease {
+    readonly committed: Promise<boolean>;
+    clear(): void;
+}
+/**
+ * Mount a resume loader on the live status rail and wait for its render generation
+ * to commit before session I/O begins. The commit is advisory: a stopped or
+ * unavailable terminal resolves false and callers continue without blocking.
+ *
+ * Fail open (no-op lease, committed=false) when the status rail or UI lacks the
+ * child-mutation/render-commit surface required to mount progress. Headless and
+ * minimal controller contexts keep resume/migration semantics; full interactive
+ * TUI containers retain progress-before-switch.
+ */
+export declare function acquireResumeProgressLease(ctx: Pick<InteractiveModeContext, "ui" | "statusContainer">): ResumeProgressLease;
 interface RenderInitialMessagesOptions {
     preserveExistingChat?: boolean;
 }

package/dist/types/runtime/memory-domain.d.ts

@@ -0,0 +1,9 @@
+import type { MemoryGuardDomainSnapshot, MemoryGuardWorkerSample } from "./memory-guard-contract";
+export interface MemoryGuardDomainInput {
+    effectiveLimitBytes: number;
+    totalUsageBytes: number;
+    parentBytes: number;
+    parentReserveBytes: number;
+    workers: readonly MemoryGuardWorkerSample[];
+}
+export declare function computeMemoryGuardDomain(input: MemoryGuardDomainInput): MemoryGuardDomainSnapshot;

package/dist/types/runtime/memory-guard-contract.d.ts

@@ -0,0 +1,71 @@
+export interface MemoryGuardPolicy {
+    enabled: boolean;
+    checkIntervalMs: number;
+    gcThresholdRatio: number;
+    restartThresholdRatio: number;
+    restartThresholdWindowMs: number;
+    cooldownMs: number;
+    parentReserveBytes: number;
+    policyLimitBytes: number | null;
+}
+export interface MemoryGuardWorkerSample {
+    workerId: string;
+    bytes: number;
+    accepted?: boolean;
+}
+export interface MemoryGuardWorkerAccounting {
+    workerId: string;
+    bytes: number;
+    accepted: boolean;
+    allowanceBytes: number;
+    excessBytes: number;
+}
+export interface MemoryGuardDomainSnapshot {
+    effectiveLimitBytes: number;
+    totalUsageBytes: number;
+    parentBytes: number;
+    parentReserveBytes: number;
+    totalWorkerBytes: number;
+    acceptedWorkerCount: number;
+    unmanagedBytes: number;
+    headroomBytes: number;
+    workerBudgetBytes: number;
+    perWorkerAllowanceBytes: number;
+    hostExcessBytes: number;
+    workers: MemoryGuardWorkerAccounting[];
+}
+export interface MemoryGuardHostTarget {
+    kind: "host";
+    excessBytes: number;
+}
+export interface MemoryGuardWorkerTarget {
+    kind: "worker";
+    workerId: string;
+    excessBytes: number;
+}
+export type MemoryGuardActionTarget = MemoryGuardHostTarget | MemoryGuardWorkerTarget;
+export type MemoryGuardNoopReason = "memory_guard_action_noop_unmanaged_or_within_allowance" | "memory_guard_action_noop_unsupported";
+export type MemoryGuardDecision = {
+    kind: "execute";
+    target: MemoryGuardActionTarget;
+} | {
+    kind: "noop";
+    reason: MemoryGuardNoopReason;
+} | {
+    kind: "revalidated_out";
+    reason: "memory_guard_action_revalidated_out";
+};
+export interface MemoryGuardSchedulerState {
+    timerActive: boolean;
+    registrationCount: number;
+    inProgress: boolean;
+    generation: number;
+    pendingDeadline: number | null;
+    pendingOwner: {
+        generation: number;
+        token: number;
+    } | null;
+    deferredDeadline: number | null;
+    deferredGeneration: number | null;
+    activeGeneration: number | null;
+}