@gajae-code/coding-agent 0.7.10 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,63 @@
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-07-04
+
+### Added
+
+- Reduced default initial-context size by shipping only essential tools up front. `tools.discoveryMode` now defaults to `"all"` and the essential resident set grew to `read, bash, edit, write, search, find`; non-essential built-in tools are hidden behind `search_tool_bm25` and discovered on demand. The system prompt gained a `<tool-discovery>` block that documents the discovery tool and lists discoverable tools with one-line summaries, so the model knows what it can activate without carrying every tool schema. This drops a typical initial context from ~63K tokens (tool-schema dominated) to under 20K.
+
+- The `/model` preset landing now shows the session's current preset, model, and per-role assignments in the header, marks the active preset with `(current)`, and Enter now expands/collapses provider groups (right/left arrows still work).
+- MCP server definitions now accept an optional per-server `autoload` boolean that controls whether a configured server connects at session startup. The flag is threaded through the config schema, both parsers (the `mcp-json` discovery reader and the runtime-mcp config loader), an `autoloadOnly` load option on `discoverAndLoadMCPTools`, and a `setServerAutoload` config writer, establishing the config contract that the opt-in runtime and the autoload/connect management surfaces wire up in follow-up changes.
+- GJC no longer inherits MCP servers live from other hosts. The MCP capability registrations were removed from the Cursor, Gemini, OpenCode, and Windsurf discovery providers and the MCP-only VS Code discovery provider was deleted, so GJC MCP servers now come only from GJC's own config, plugin bundles, or an explicit import rather than being read live out of another host's configuration; rules, settings, and skills discovery are unchanged.
+
+- Added a `statusLine.maxRows` setting (Appearance → Status Line Rows). When it is greater than 1, status line segments that overflow a narrow terminal now wrap onto additional rows instead of being dropped; the default of 1 keeps the existing single-line, drop-on-overflow behavior. The Appearance preview reflects the wrapped layout.
+
+- The startup welcome screen now renders as a viewport-sized `GJC Forge` panel that reserves the bottom composer/HUD rows, keeps the prompt fixed, and folds What's New highlights into the splash instead of appending a separate changelog block.
+
+### Fixed
+
+- Escape now reliably cancels active context maintenance, handoff generation, retry backoff, and workflow ask dialogs even when transient UI focus or typed drafts would previously consume the key.
+- The session tree picker now keeps its selection index valid when it starts on an empty filter mode, receives navigation input, and then switches back to a populated filter.
+- The main composer now uses `PageUp` / `PageDown` to page the visible transcript viewport instead of duplicating prompt-history navigation; `Up` / `Down` and `Ctrl+R` remain the prompt-history paths, and autocomplete lists keep their own page navigation.
+- Shared the duplicated two-column dashboard renderer used by agent and extension dashboards, keeping narrow-width truncation behavior in one tested component.
+- Avoided duplicate line splitting when formatting `ast_grep` matches, reducing allocation in large structural-search result rendering.
+
+- Tab now queues prompt drafts immediately while the agent is streaming or compacting instead of opening/applying forced file autocomplete first.
+
+## [0.7.11] - 2026-07-03
+### Fixed
+
+- Coordinator MCP tmux prompt delivery now dismisses any focused TUI autocomplete menu after paste-buffer insertion and before `Enter`, so multiline delegated `/skill:*` prompts submit to the runtime and emit the expected prompt ack instead of selecting the highlighted skill completion and timing out.
+- The Python `gjc_rpc` client no longer tears down its reader loop on real server frames it had not modeled: OAuth `open_url` extension-UI requests emitted during `login`, `workflow_gate` frames carrying structured `{value, label, description}` options (the `next_workflow_gate()` queue path re-parsed them with a legacy strings-only parser), and `max`/`inherit` thinking levels returned by `get_state`/model info. `install_headless_ui` now answers interactive UI requests with `extension_ui_response` frames instead of misrouting them as `workflow_gate_response` commands, and `get_pending_workflow_gates()` is exposed as a typed method. Previously dropped payloads (`notice`, `thinking_level_changed`, `goal_updated`, `irc_message`, `subagent_steer_message` events; `agent_end.stopReason`/`telemetry`/`coverage`; `auto_retry_start.unbounded`; `auto_compaction_end.continuationSkipReason`; gate `required`) now parse into typed models, and the env-gated real-binary lane covers the new surface.
+- The session picker now keeps its selection index valid after an empty search result is navigated and then cleared, so Enter still resumes the first restored session instead of leaving the list with no selected row.
+
+## [0.7.11] - 2026-07-03
+
+### Fixed
+
+- Notification endpoints now emit the graceful `session_closed` frame on process teardown (native terminal-window close/SIGHUP, SIGTERM, fatal errors) via a postmortem cleanup, so the managed Telegram daemon deletes the session's forum topic instead of orphaning it when the session dies without a clean `/quit`.
+- Native Windows terminals now default `app.message.queue` to `Alt+Q` instead of `Alt+Enter`, avoiding the Windows Terminal fullscreen shortcut conflict (#1422).
+- Coordinator MCP tmux prompt delivery now submits with tmux `Enter` instead of `C-m`, while preserving runtime prompt-ack/`turn_start` as the delivery success gate (#1409).
+- The session-close resume hint now prints the `gjc --resume <id>` command on its own line so it can be selected and copied without the surrounding prose.
+- Coordinator MCP tmux prompt delivery now uses a paste buffer for prompt text before submitting with `Enter`, preserving multiline delegated `/skill:*` prompt separators that `send-keys -l` could flatten into an unstarted visible prompt (#1416).
+
+- `/retry` now resumes sessions left with an interrupted user/custom/tool-result tail after a crash or power loss, and recovers unresolved assistant tool-use tails instead of reporting "Nothing to retry".
+- Queued prompt shortcuts now keep working during auto context-full compaction: Tab/Alt+Enter queue text immediately, `/skill:*` entries replay through the skill invocation path after compaction, and Alt+Up restores only the newest queued prompt for editing instead of merging the full queue.
+- Skill prompt cards now size their collapsed arguments preview to the current terminal width instead of wrapping at a fixed narrow column.
+- `gjc update` now refreshes opted-in on-disk default workflow skill copies (written by `gjc setup defaults` under the agent dir) after a successful update, so they no longer stay stale relative to the embedded defaults; copies that were never installed are left absent.
+- `gjc migrate` skill imports now tolerate project or agent directories reached through macOS system symlinks such as `/var` while still rejecting symlinked destination skill directories, so local dry-run/live parity tests no longer fail on Darwin temp paths.
+- cmux workspace auto-renames now include a `GJC: ` prefix so renamed workspaces remain identifiable as GJC sessions.
+- The cmux workspace auto-rename is now ownership-guarded: GJC reads the current workspace title via `cmux workspace list` and only renames a workspace that still has its default title, so it no longer overwrites a user-pinned workspace name or thrash a shared workspace title across multiple sessions running under the same `CMUX_WORKSPACE_ID`. Opt out with `GJC_NO_CMUX_RENAME`.
+- `gjc --tmux --resume` now reaches the session picker/resume target instead of auto-attaching a same-branch managed tmux session before the inner resume resolver runs.
+- `gjc --tmux` now preserves a newly created managed tmux session when `attach-session` exits after the parent SSH/PTY closes but the tmux server still reports the session live, so closing a Windows Terminal tab no longer kills the Mac host session before reattach.
+- Managed `gjc --tmux` launches now size the inner tmux window to the caller terminal minus inherited tmux status lines, preventing the bottom of the GJC input from being clipped when the user's tmux status bar is visible.
+- Managed `gjc --tmux` launches no longer pin the initial window to `manual` sizing on native tmux. The pre-attach reassert used `resize-window`, which flips the window's `window-size` option to `manual` and stops `attach-session` from resizing the window to the real terminal; when the attaching terminal was larger than the capture-time size, tmux left a smaller-than-client window and painted the uncovered area with `·` fill. The window now stays on `window-size latest` so it tracks the attaching client (psmux keeps the explicit `resize-window` reassert).
+
+### Changed
+
+- `web_search` latency overhaul: provider hard timeouts are now class-based (pure search APIs 15s, LLM-mediated providers 120s, Kimi 35s aligned to its upstream 30s budget, replacing the uniform 300s ceiling; an explicitly configured `web_search.timeout` still overrides — the schema default no longer reinstalls 300s), DuckDuckGo is fired as a background hedge 3s into a slower primary so a failing primary falls back to an already-settled result, the Gemini 429/5xx retry-delay budget dropped from 5 minutes to 30 seconds, resolved provider chains are cached per AuthStorage for 60s keyed on the credential generation (availability probes skipped on repeat searches; login/logout invalidates immediately), and `WebSearchTool` prewarms the chain at construction. Measured: hung-primary fallback 301s → 15s, slow-failing-primary fallback ~7s → 6s, repeat chain resolution ~26ms → ~0.01ms.
+
 ## [0.7.10] - 2026-07-02
 ### Added
 
@@ -13,6 +70,7 @@
 
 - Deep Interview option-clarification prompts now stay out of the interview transcript and ambiguity recorder, so asking about displayed choices no longer persists as the round answer before the user selects an actual option.
 - `gjc daemon reload telegram` now spawns the replacement daemon with a stable owner pid so the new daemon does not exit immediately after the short-lived reload CLI process ends.
+- Ralplan role agents can now persist Planner/Architect/Critic artifacts through a sanctioned `GJC_RALPLAN_ARTIFACT` env handoff (`--artifact-env GJC_RALPLAN_ARTIFACT`), avoiding restricted-bash failures on markdown containing quotes, backslashes, shell-expansion characters, or command-substitution syntax.
 - Managed `gjc --tmux` launches now size the initial window correctly (#1376).
 - Coordinator tmux-delivered turns now submit correctly on Enter (#1372).
 - Generic long `retry-after` rate limits are now kept retryable instead of being treated as fatal (#1370).

package/README.md

@@ -4,7 +4,7 @@ Core implementation package for the `gjc` coding agent in the `gajae-code` monor
 
 For installation, setup, provider configuration, model roles, slash commands, and full CLI reference, see:
 - [Monorepo README (local)](../../README.md)
-- [Monorepo README (GitHub)](https://github.com/can1357/gajae-code#readme)
+- [Monorepo README (GitHub)](https://github.com/Yeachan-Heo/gajae-code#readme)
 
 Package-specific references:
 - [CHANGELOG](./CHANGELOG.md)
@@ -24,7 +24,7 @@ For simple local side effects that do not need a full extension, set the user-le
 gjc config set completion.notifyCommand 'cmux notify --title "$GJC_NOTIFICATION_TITLE" --body "$GJC_NOTIFICATION_BODY"'
 ```
 
-When GJC is running inside a cmux terminal (`CMUX_WORKSPACE_ID` is set), GJC also best-effort renames that cmux workspace to the current GJC session name whenever the session title is set or restored.
+When GJC runs inside a cmux terminal (`CMUX_WORKSPACE_ID` is set), GJC best-effort renames that cmux workspace to the current GJC session name (with a `GJC: ` prefix) — but only when the workspace still has its default title, so a name you pinned (or one set by a peer session sharing the workspace) is never overwritten. Opt out with `GJC_NO_CMUX_RENAME=1`.
 
 Windows Terminal may keep BEL (`[Console]::Write([char]7)`) silent depending on profile and system sound settings even when `notifications.terminalBell` is enabled. For an audible Windows completion beep, configure a user-level PowerShell command hook instead:
 

package/dist/types/capability/mcp.d.ts

@@ -7,6 +7,8 @@ export interface MCPServer {
     name: string;
     /** Whether this server is enabled (default: true) */
     enabled?: boolean;
+    /** Whether to connect automatically at session startup (default: true) */
+    autoload?: boolean;
     /** Connection timeout in milliseconds */
     timeout?: number;
     /** Command to run (for stdio transport) */

package/dist/types/config/keybindings.d.ts

@@ -10,6 +10,7 @@ interface AppKeybindings {
     "app.suspend": true;
     "app.thinking.cycle": true;
     "app.thinking.toggle": true;
+    "app.commandPalette.open": true;
     "app.model.cycleForward": true;
     "app.model.cycleBackward": true;
     "app.model.select": true;
@@ -45,6 +46,7 @@ declare module "@gajae-code/tui" {
     interface Keybindings extends AppKeybindings {
     }
 }
+export declare function defaultMessageQueueKeysForPlatform(platform?: NodeJS.Platform): KeyId;
 /**
  * All keybindings definitions: TUI + app-specific.
  */
@@ -201,12 +203,16 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: "ctrl+t";
         readonly description: "Toggle thinking mode";
     };
-    readonly "app.model.cycleForward": {
+    readonly "app.commandPalette.open": {
         readonly defaultKeys: "ctrl+p";
+        readonly description: "Open command palette";
+    };
+    readonly "app.model.cycleForward": {
+        readonly defaultKeys: "alt+n";
         readonly description: "Cycle to next model";
     };
     readonly "app.model.cycleBackward": {
-        readonly defaultKeys: "shift+ctrl+p";
+        readonly defaultKeys: "alt+shift+n";
         readonly description: "Cycle to previous model";
     };
     readonly "app.model.select": {
@@ -234,7 +240,7 @@ export declare const KEYBINDINGS: {
         readonly description: "Send follow-up message (no default; Ctrl+Enter submits)";
     };
     readonly "app.message.queue": {
-        readonly defaultKeys: "alt+enter";
+        readonly defaultKeys: KeyId;
         readonly description: "Queue message for next turn";
     };
     readonly "app.message.dequeue": {
@@ -254,8 +260,8 @@ export declare const KEYBINDINGS: {
         readonly description: "Copy prompt";
     };
     readonly "app.session.new": {
-        readonly defaultKeys: [];
-        readonly description: "Create new session";
+        readonly defaultKeys: "ctrl+n";
+        readonly description: "Start a new session";
     };
     readonly "app.session.tree": {
         readonly defaultKeys: [];

package/dist/types/config/settings-schema.d.ts

@@ -440,6 +440,28 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Use the session name color for the editor border and status line gap";
         };
     };
+    readonly "statusLine.maxRows": {
+        readonly type: "number";
+        readonly default: 1;
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly label: "Status Line Rows";
+            readonly description: "Maximum rows for the status line. When greater than 1, overflowing segments wrap onto additional rows instead of being dropped.";
+            readonly options: readonly [{
+                readonly value: "1";
+                readonly label: "1 row";
+                readonly description: "Single line; overflow is truncated (default)";
+            }, {
+                readonly value: "2";
+                readonly label: "2 rows";
+                readonly description: "Wrap overflow onto a second row";
+            }, {
+                readonly value: "3";
+                readonly label: "3 rows";
+                readonly description: "Wrap overflow across up to three rows";
+            }];
+        };
+    };
     readonly "tools.artifactSpillThreshold": {
         readonly type: "number";
         readonly default: 50;
@@ -2848,7 +2870,7 @@ export declare const SETTINGS_SCHEMA: {
     readonly "tools.discoveryMode": {
         readonly type: "enum";
         readonly values: readonly ["off", "all"];
-        readonly default: "off";
+        readonly default: "all";
         readonly ui: {
             readonly tab: "tools";
             readonly label: "Tool Discovery";
@@ -2861,7 +2883,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly ui: {
             readonly tab: "tools";
             readonly label: "Essential Tools Override";
-            readonly description: "Override the always-loaded built-in tools (default: read, bash, edit). Leave empty to use defaults.";
+            readonly description: "Override the always-loaded built-in tools (default: read, bash, edit, write, search, find). Leave empty to use defaults.";
         };
     };
     readonly "mcp.enableProjectConfig": {
@@ -3685,6 +3707,7 @@ export interface ExaSettings {
 export interface StatusLineSettings {
     preset: StatusLinePreset;
     separator: StatusLineSeparatorStyle;
+    maxRows: number;
     showHookStatus: boolean;
     showSkillHud: boolean;
     leftSegments: StatusLineSegmentId[];

package/dist/types/defaults/gjc-defaults.d.ts

@@ -27,6 +27,13 @@ export type DefaultGjcDefinition = DefaultGjcSkillDefinition | DefaultGjcSkillFr
 export interface InstallDefaultGjcDefinitionsOptions {
     check?: boolean;
     force?: boolean;
+    /**
+     * Only rewrite default definition files that already exist on disk but whose
+     * content differs from the embedded defaults. Files that are absent are left
+     * absent (status "missing"). Used by `gjc update` to refresh opted-in copies
+     * without materializing new on-disk copies for users who never installed them.
+     */
+    refreshOnly?: boolean;
     targetRoot?: string;
 }
 export type DefaultGjcDefinitionInstallFile = {

package/dist/types/discovery/cursor.d.ts

@@ -9,8 +9,11 @@
  * - Project: .cursor/ (cwd only)
  *
  * Capabilities:
- * - mcps: From mcp.json with mcpServers key
  * - rules: From rules/*.mdc files with MDC frontmatter (description, globs, alwaysApply)
  * - settings: From settings.json if present
+ *
+ * MCP servers are intentionally NOT inherited live from Cursor config: GJC owns
+ * MCP runtime execution. Use `gjc mcp import cursor` to copy definitions into
+ * GJC's own mcp.json instead.
  */
 export {};

package/dist/types/discovery/index.d.ts

@@ -28,7 +28,6 @@ import "./opencode";
 import "./github";
 import "./mcp-json";
 import "./ssh";
-import "./vscode";
 import "./windsurf";
 export { cacheStats, disableProvider, enableProvider, getAllCapabilitiesInfo, getAllProvidersInfo, getCapability, getCapabilityInfo, getDisabledProviders, getProviderInfo, initializeWithSettings, invalidate, isProviderEnabled, listCapabilities, loadCapability, reset, setDisabledProviders, } from "../capability";
 export type { ContextFile } from "../capability/context-file";

package/dist/types/discovery/windsurf.d.ts

@@ -6,8 +6,10 @@
  * - Project: .windsurf
  *
  * Supports:
- * - MCP servers from mcp_config.json
  * - Rules from .windsurf/rules/*.md and ~/.codeium/windsurf/memories/global_rules.md
  * - Legacy .windsurfrules file
+ *
+ * MCP servers are intentionally NOT inherited live from Windsurf config: GJC
+ * owns MCP runtime execution. Copy definitions into GJC's own mcp.json instead.
  */
 export {};

package/dist/types/gjc-runtime/launch-tmux.d.ts

@@ -22,6 +22,7 @@ export interface TmuxLaunchContext {
     tty?: TtyState;
     spawnSync?: TmuxSpawnSync;
     tmuxAvailable?: boolean;
+    tmuxStatusLines?: number;
     worktreeBranch?: string | null;
     currentBranch?: string | null;
     existingBranchSessionName?: string | null;
@@ -66,6 +67,8 @@ export interface TmuxLaunchPlan {
     project?: string | null;
     sessionId?: string | null;
     sessionStateFile?: string | null;
+    isPsmux: boolean;
+    platform: NodeJS.Platform;
 }
 export interface GjcTmuxProfileResult {
     skipped: boolean;

package/dist/types/gjc-runtime/ralplan-runtime.d.ts

@@ -10,8 +10,9 @@
  *    that lives in the bundled `/skill:ralplan` skill — but it accepts every documented flag so
  *    scripted users see a useful response and the active run is visible to the TUI.
  *
- * 2. **Artifact write**: `gjc ralplan --write --stage <type> --stage_n <N> --artifact
- *    <path-or-string> [--run-id <id>] [--session-id <id>] [--json]` persists Planner / Architect
+ * 2. **Artifact write**: `gjc ralplan --write --stage <type> --stage_n <N>
+ *    (--artifact <path-or-string> | --artifact-env GJC_RALPLAN_ARTIFACT)
+ *    [--run-id <id>] [--session-id <id>] [--json]` persists Planner / Architect
  *    / Critic / revision / post-interview / ADR / final markdown under `.gjc/plans/ralplan/<run-id>/`, maintains
  *    an `index.jsonl` audit log, copies `final` stages to `pending-approval.md`, and advances
  *    the HUD chip to reflect the latest persisted stage.

package/dist/types/gjc-runtime/restricted-role-agent-bash.d.ts

@@ -1,2 +1,3 @@
 export declare const GJC_RESTRICTED_ROLE_AGENT_BASH_ENV = "GJC_RESTRICTED_ROLE_AGENT_BASH";
+export declare const GJC_RALPLAN_ARTIFACT_ENV = "GJC_RALPLAN_ARTIFACT";
 export declare function isRestrictedRoleAgentBash(): boolean;

package/dist/types/gjc-runtime/session-state-sidecar.d.ts

@@ -1,5 +1,7 @@
+import { postmortem } from "@gajae-code/utils";
 export declare const GJC_COORDINATOR_SESSION_STATE_FILE_ENV = "GJC_COORDINATOR_SESSION_STATE_FILE";
 export declare const GJC_COORDINATOR_SESSION_ID_ENV = "GJC_COORDINATOR_SESSION_ID";
+export declare const GJC_COORDINATOR_SESSION_BRANCH_ENV = "GJC_COORDINATOR_SESSION_BRANCH";
 export type RuntimeState = "ready_for_input" | "running" | "needs_user_input" | "completed" | "errored";
 interface RuntimeStateEvent {
     type: string;
@@ -9,6 +11,7 @@ interface RuntimeStateContext {
     sessionId: string;
     cwd: string;
     sessionFile?: string | null;
+    branch?: string | null;
 }
 export type TerminalRuntimeStateStatus = {
     terminal: true;
@@ -24,4 +27,6 @@ export declare function readTerminalRuntimeStateMarker(input: {
     sessionFile?: string | null;
 }): Promise<TerminalRuntimeStateStatus>;
 export declare function persistCoordinatorRuntimeStateFromEvent(event: RuntimeStateEvent, context: RuntimeStateContext): Promise<void>;
+export declare function persistCoordinatorRuntimeStateFromPostmortem(reason: postmortem.Reason, context: RuntimeStateContext): void;
+export declare function registerCoordinatorRuntimeStateFinalizer(context: RuntimeStateContext): () => void;
 export {};

package/dist/types/gjc-runtime/state-writer.d.ts

@@ -67,6 +67,7 @@ export type GuardedWriteResult = {
     path: string;
     written: true;
     revision: number;
+    stamped: unknown;
 } | {
     path: string;
     written: false;

package/dist/types/modes/components/custom-editor.d.ts

@@ -1,6 +1,6 @@
 import { Editor, type KeyId } from "@gajae-code/tui";
 import { type AppKeybinding } from "../../config/keybindings";
-type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.message.followUp" | "app.message.queue" | "app.clipboard.pasteImage" | "app.clipboard.copyPrompt">;
+type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.thinking.cycle" | "app.commandPalette.open" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.message.followUp" | "app.message.queue" | "app.clipboard.pasteImage" | "app.clipboard.copyPrompt">;
 type PastePendingClearReason = "timeout" | "queue-limit";
 /**
  * Custom editor that handles configurable app-level shortcuts for coding-agent.
@@ -19,6 +19,7 @@ export declare class CustomEditor extends Editor {
     onClear?: () => void;
     onExit?: () => void;
     onCycleThinkingLevel?: () => void;
+    onOpenCommandPalette?: () => void;
     onCycleModelForward?: () => void;
     onCycleModelBackward?: () => void;
     onSelectModel?: () => void;
@@ -43,6 +44,10 @@ export declare class CustomEditor extends Editor {
     onQueue?: () => void;
     /** Called when Caps Lock is pressed. */
     onCapsLock?: () => void;
+    /** Called when PageUp/PageDown should scroll the transcript viewport instead of prompt history. */
+    onViewportPageScroll?: (direction: -1 | 1) => void;
+    /** Called before regular composer input should return the transcript viewport to the live bottom. */
+    onViewportFollowLive?: () => void;
     setActionKeys(action: ConfigurableEditorAction, keys: KeyId[]): void;
     /**
      * Register a custom key handler. Extensions use this for shortcuts.

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

@@ -28,6 +28,7 @@ export interface StatusLinePreviewSettings {
     segmentOptions?: StatusLineSegmentOptions;
     previewHighlightSegment?: StatusLineSegmentId;
     sessionAccent?: boolean;
+    maxRows?: number;
 }
 export interface SettingsCallbacks {
     /** Called when any setting value changes */

package/dist/types/modes/components/skill-message.d.ts

@@ -6,4 +6,5 @@ export declare class SkillMessageComponent extends Container {
     constructor(message: CustomMessage<SkillPromptDetails>);
     setExpanded(expanded: boolean): void;
     invalidate(): void;
+    render(width: number): string[];
 }

package/dist/types/modes/components/status-line.d.ts

@@ -36,6 +36,7 @@ export interface StatusLineSettings {
     showHookStatus?: boolean;
     showSkillHud?: boolean;
     sessionAccent?: boolean;
+    maxRows?: number;
 }
 export interface StatusLineComponentOptions {
     version?: string;
@@ -82,5 +83,12 @@ export declare class StatusLineComponent implements Component {
         content: string;
         width: number;
     };
+    /**
+     * Multi-row-aware content for the settings preview: the wrapped rows joined
+     * with newlines so a single `Text` renders them stacked. Honors the current
+     * `maxRows`; identical to the single status line when `maxRows` is 1 or when
+     * everything fits on one row.
+     */
+    getPreviewContent(width: number): string;
     render(width: number): string[];
 }

package/dist/types/modes/components/two-column-body.d.ts

@@ -0,0 +1,9 @@
+import { type Component } from "@gajae-code/tui";
+export declare class TwoColumnBody implements Component {
+    private readonly leftPane;
+    private readonly rightPane;
+    private readonly maxHeight;
+    constructor(leftPane: Component, rightPane: Component, maxHeight: number);
+    render(width: number): string[];
+    invalidate(): void;
+}

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

@@ -9,6 +9,12 @@ export interface LspServerInfo {
     fileTypes: string[];
 }
 export type WelcomeLogoMode = "unicode" | "square" | "ascii";
+export interface WelcomeComponentOptions {
+    getViewportRows?: () => number | undefined;
+    getReservedBottomRows?: (termWidth: number) => number;
+    changelogMarkdown?: string;
+    collapseChangelog?: boolean;
+}
 /**
  * GJC-native launch surface with compact command affordances, project
  * signals, and a claw/talon mark without copying another agent shell.
@@ -21,7 +27,8 @@ export declare class WelcomeComponent implements Component {
     private recentSessions;
     private lspServers;
     private readonly logoMode;
-    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], lspServers?: LspServerInfo[], logoMode?: WelcomeLogoMode);
+    private readonly options;
+    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], lspServers?: LspServerInfo[], logoMode?: WelcomeLogoMode, options?: WelcomeComponentOptions);
     invalidate(): void;
     /**
      * Play a one-shot intro that sweeps the gradient through every phase
@@ -29,6 +36,7 @@ export declare class WelcomeComponent implements Component {
      * subsequent calls reset and replay.
      */
     playIntro(requestRender: () => void): void;
+    dispose(): void;
     setModel(modelName: string, providerName: string): void;
     setRecentSessions(sessions: RecentSession[]): void;
     setLspServers(servers: LspServerInfo[]): void;

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

@@ -18,6 +18,7 @@ export declare class CommandController {
     handleUsageCommand(reports?: UsageReport[] | null): Promise<void>;
     handleChangelogCommand(showFull?: boolean): Promise<void>;
     handleHotkeysCommand(): void;
+    handleHelpCommand(): void;
     handleToolsCommand(): void;
     handleContextCommand(): void;
     handleMemoryCommand(text: string): Promise<void>;

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

@@ -1,4 +1,4 @@
-import type { AutocompleteProvider, SlashCommand } from "@gajae-code/tui";
+import { type AutocompleteProvider, type SlashCommand } from "@gajae-code/tui";
 import type { InteractiveModeContext } from "../../modes/types";
 export declare class InputController {
     #private;
@@ -14,6 +14,9 @@ export declare class InputController {
     handleFollowUp(): Promise<void>;
     /** Send editor text explicitly as a queued next-turn message. */
     handleQueueSubmit(): Promise<void>;
+    restoreLatestQueuedMessageToEditor(options?: {
+        currentText?: string;
+    }): number;
     restoreQueuedMessagesToEditor(options?: {
         abort?: boolean;
         currentText?: string;
@@ -27,6 +30,7 @@ export declare class InputController {
     handleCopyCurrentLine(): void;
     /** Copy current prompt text to system clipboard. */
     handleCopyPrompt(): void;
+    openCommandPalette(): void;
     cycleThinkingLevel(): void;
     cycleRoleModel(options?: {
         temporary?: boolean;

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

@@ -1,8 +1,16 @@
 import type { Component } from "@gajae-code/tui";
 import type { ModelProfileConfig } from "../../config/models-config-schema";
+import { type Settings } from "../../config/settings";
 import type { InteractiveModeContext, OAuthSelectorOptions } from "../../modes/types";
+import type { StatusLineSettings } from "../components/status-line";
 import type { JobsObserver } from "../jobs-observer";
 import type { SessionObserverRegistry } from "../session-observer-registry";
+/**
+ * Snapshot the persisted status-line settings that the status-line component
+ * cares about. Preview, cancel-restore, and commit paths all share this so the
+ * previewed row count (and every other field) can never drift out of sync.
+ */
+export declare function buildStatusLineSettings(settingsInstance: Settings): StatusLineSettings;
 export declare class SelectorController {
     #private;
     private ctx;

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

@@ -89,6 +89,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     retryLoader: Loader | undefined;
     autoCompactionEscapeHandler?: () => void;
     retryEscapeHandler?: () => void;
+    retryEscapePrimed: boolean;
     retryCountdownTimer?: NodeJS.Timeout;
     unsubscribe?: () => void;
     onInputCallback?: (input: SubmittedUserInput) => void;
@@ -184,6 +185,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleUsageCommand(reports?: UsageReport[] | null): Promise<void>;
     handleChangelogCommand(showFull?: boolean): Promise<void>;
     handleHotkeysCommand(): void;
+    handleHelpCommand(): void;
     handleToolsCommand(): void;
     handleContextCommand(): void;
     handleClearCommand(): Promise<void>;

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

@@ -14,6 +14,8 @@ interface PromptActionAutocompleteOptions {
     copyCurrentLine: () => void;
     copyPrompt: () => void;
     pasteImage: () => void;
+    newSession: () => void;
+    showHelp: () => void;
     scrollTmuxToPreviousUserInput: () => void;
     undo: (prefix: string) => void;
     moveCursorToMessageEnd: () => void;

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

@@ -641,6 +641,7 @@ export interface RpcJsonSchema {
     items?: RpcJsonSchema;
     minLength?: number;
     maxLength?: number;
+    pattern?: string;
     minItems?: number;
     maxItems?: number;
     uniqueItems?: boolean;

package/dist/types/modes/slash-command-visibility.d.ts

@@ -0,0 +1 @@
+export declare function shouldShowExtensionCommand(name: string, activeProvider: string | undefined): boolean;

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

@@ -94,6 +94,7 @@ export interface InteractiveModeContext {
     retryLoader: Loader | undefined;
     autoCompactionEscapeHandler?: () => void;
     retryEscapeHandler?: () => void;
+    retryEscapePrimed: boolean;
     retryCountdownTimer?: NodeJS.Timeout;
     unsubscribe?: () => void;
     onInputCallback?: (input: SubmittedUserInput) => void;
@@ -191,6 +192,7 @@ export interface InteractiveModeContext {
     handleUsageCommand(reports?: UsageReport[] | null): Promise<void>;
     handleChangelogCommand(showFull?: boolean): Promise<void>;
     handleHotkeysCommand(): void;
+    handleHelpCommand(): void;
     handleToolsCommand(): void;
     handleContextCommand(): void;
     handleDumpCommand(): void;

package/dist/types/runtime-mcp/config-writer.d.ts

@@ -69,6 +69,15 @@ export declare function getMCPServer(filePath: string, name: string): Promise<MC
  * List all server names in a config file.
  */
 export declare function listMCPServers(filePath: string): Promise<string[]>;
+/**
+ * Set a server's autoload flag (connect automatically at session startup).
+ *
+ * Autoload defaults to true, so turning it on removes the key to keep the
+ * config file free of redundant fields; turning it off writes `autoload: false`.
+ *
+ * @throws Error if the server doesn't exist
+ */
+export declare function setServerAutoload(filePath: string, name: string, autoload: boolean): Promise<void>;
 /**
  * Read the disabled servers list from a config file.
  */

package/dist/types/runtime-mcp/config.d.ts

@@ -13,6 +13,8 @@ export interface LoadMCPConfigsOptions {
     filterExa?: boolean;
     /** Whether to filter out browser MCP servers when builtin browser tool is enabled (default: false) */
     filterBrowser?: boolean;
+    /** Only include servers eligible for startup connection, i.e. autoload !== false (default: false) */
+    autoloadOnly?: boolean;
 }
 /** Result of loading MCP configs */
 export interface LoadMCPConfigsResult {

package/dist/types/runtime-mcp/loader.d.ts

@@ -28,6 +28,8 @@ export interface MCPToolsLoadOptions {
     filterExa?: boolean;
     /** Whether to filter out browser MCP servers when builtin browser tool is enabled (default: false) */
     filterBrowser?: boolean;
+    /** Only connect servers with autoload !== false (default: false) */
+    autoloadOnly?: boolean;
     /** SQLite storage for MCP tool cache (null disables cache) */
     cacheStorage?: AgentStorage | null;
     /** Auth storage used to resolve OAuth credentials before initial MCP connect */

package/dist/types/runtime-mcp/manager.d.ts

@@ -38,6 +38,8 @@ export interface MCPDiscoverOptions {
     filterExa?: boolean;
     /** Whether to filter out browser MCP servers when builtin browser tool is enabled (default: false) */
     filterBrowser?: boolean;
+    /** Only connect servers with autoload !== false (default: false) */
+    autoloadOnly?: boolean;
     /** Called when starting to connect to servers */
     onConnecting?: (serverNames: string[]) => void;
 }

package/dist/types/runtime-mcp/types.d.ts

@@ -45,6 +45,12 @@ export interface MCPAuthConfig {
 interface MCPServerConfigBase {
     /** Whether this server is enabled (default: true) */
     enabled?: boolean;
+    /**
+     * Whether to connect this server automatically at session startup (default: true).
+     * When false the server stays configured-but-disconnected until connected
+     * explicitly (e.g. `/mcp connect <name>`).
+     */
+    autoload?: boolean;
     /** Connection timeout in milliseconds (default: 30000) */
     timeout?: number;
     /** Authentication configuration (optional) */

package/dist/types/sdk.d.ts

@@ -47,7 +47,7 @@ export interface CreateAgentSessionOptions {
         requestedModel: Model;
         reason: string;
     };
-    /** Models available for cycling (Ctrl+P in interactive mode) */
+    /** Models available for cycling (Alt+N in interactive mode) */
     scopedModels?: ScopedModelSelection[];
     /** System prompt blocks. Array replaces default, function receives default blocks and returns final blocks. */
     systemPrompt?: string[] | ((defaultPrompt: string[]) => string[]);