@gajae-code/coding-agent 0.7.10 → 0.7.11

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 ## [Unreleased]
 
+## [0.7.11] - 2026-07-03
+### Fixed
+
+- 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 +37,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

@@ -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/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/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/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/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;

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/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

@@ -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/interactive-mode.d.ts

@@ -184,6 +184,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/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

@@ -191,6 +191,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/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[]);

package/dist/types/session/agent-session.d.ts

@@ -159,7 +159,7 @@ export interface AgentSessionConfig {
     agent: Agent;
     sessionManager: SessionManager;
     settings: Settings;
-    /** Models to cycle through with Ctrl+P (from --models flag) */
+    /** Models to cycle through with Alt+N (from --models flag) */
     scopedModels?: ScopedModelSelection[];
     /** Initial session thinking selector. */
     thinkingLevel?: ThinkingLevel;
@@ -671,7 +671,7 @@ export declare class AgentSession {
         followUp: readonly string[];
     };
     /**
-     * Pop the last queued message (steering first, then follow-up).
+     * Pop the newest queued message across steering and follow-up queues.
      * Used by dequeue keybinding to restore messages to editor one at a time.
      * Returns the popped entry's `.text`; the tag (if any) dies with the
      * record — no orphan state can outlive the queue entry.
@@ -905,9 +905,12 @@ export declare class AgentSession {
      */
     setAutoRetryEnabled(enabled: boolean): void;
     /**
-     * Manually retry the last failed assistant turn.
-     * Removes the error message from agent state and re-attempts with a fresh retry budget.
-     * @returns true if retry was initiated, false if no failed turn to retry or agent is busy
+     * Manually retry the last failed assistant turn, or resume an interrupted tail
+     * left by a non-graceful process exit after the user/custom/tool-result message
+     * was persisted but before the agent emitted a terminal assistant response.
+     * Removes failed/aborted/unresolved tool-use assistant tails before
+     * re-attempting with a fresh retry budget.
+     * @returns true if retry/resume was initiated, false if no retryable tail exists or agent is busy
      */
     retry(): Promise<boolean>;
     /**

package/dist/types/slash-commands/types.d.ts

@@ -17,6 +17,8 @@ export interface BuiltinSlashCommand {
     subcommands?: SubcommandDef[];
     /** Static inline hint when command takes a simple argument (no subcommands). */
     inlineHint?: string;
+    /** Higher values sort earlier in TUI slash-command autocomplete. */
+    priority?: number;
 }
 /** Parsed slash-command text after stripping the leading "/". */
 export interface ParsedSlashCommand {

package/dist/types/utils/cmux-workspace.d.ts

@@ -2,6 +2,13 @@ export interface CmuxWorkspaceRenameCommand {
     command: string;
     args: string[];
 }
+/** Current ownership state of a cmux workspace, read back from `cmux workspace list`. */
+export interface CmuxWorkspaceOwnership {
+    /** cmux marks a workspace `has_custom_title` once an explicit title is set (by the user or by GJC). */
+    hasCustomTitle: boolean;
+    /** The workspace's current display title. */
+    title: string;
+}
 export interface CmuxWorkspaceRenameProcess {
     exited: Promise<number>;
     kill(): void;
@@ -17,7 +24,29 @@ export interface CmuxWorkspaceTitleSyncOptions {
         stdout: "ignore";
         stderr: "ignore";
     }) => CmuxWorkspaceRenameProcess;
+    /** Reads the current ownership state of `workspaceId`. Injectable for tests. */
+    readOwnership?: (cmuxCommand: string, workspaceId: string, env: NodeJS.ProcessEnv) => Promise<CmuxWorkspaceOwnership | null>;
 }
 export declare function sanitizeCmuxWorkspaceTitle(title: string | undefined): string | undefined;
+export declare function formatCmuxWorkspaceTitle(title: string | undefined): string | undefined;
 export declare function buildCmuxWorkspaceRenameCommand(sessionName: string | undefined, env?: NodeJS.ProcessEnv): CmuxWorkspaceRenameCommand | null;
-export declare function syncCmuxWorkspaceTitle(sessionName: string | undefined, options?: CmuxWorkspaceTitleSyncOptions): void;
+/** Parse `cmux workspace list --json --id-format both` output and return the
+ * ownership state of the workspace matching `workspaceId` (by UUID `id` or `ref`). */
+export declare function parseCmuxWorkspaceOwnership(jsonText: string, workspaceId: string): CmuxWorkspaceOwnership | null;
+/** Only rename when GJC owns the name:
+ * - unknown ownership (read failed) → skip (fail safe, never clobber)
+ * - already the desired title → skip (no-op)
+ * - workspace still on its default title → rename
+ * - any custom title (user- or peer-set) → skip
+ * This makes GJC name a fresh workspace once and then leave it alone, so it
+ * never overwrites a user-pinned name and multiple sessions sharing one
+ * CMUX_WORKSPACE_ID do not thrash the workspace title. */
+export declare function shouldRenameCmuxWorkspace(ownership: CmuxWorkspaceOwnership | null, desiredTitle: string): boolean;
+/**
+ * Best-effort sync of the containing cmux workspace title to the current GJC
+ * session name. Ownership-guarded: GJC reads the current workspace title and
+ * only renames a workspace that still has its default title, so it never
+ * overwrites a name the user pinned or a name a peer session (sharing the same
+ * CMUX_WORKSPACE_ID) set. Opt out with GJC_NO_CMUX_RENAME.
+ */
+export declare function syncCmuxWorkspaceTitle(sessionName: string | undefined, options?: CmuxWorkspaceTitleSyncOptions): Promise<void>;

package/dist/types/web/search/index.d.ts

@@ -44,6 +44,8 @@ export type SearchToolParams = z.infer<typeof webSearchSchema>;
 export interface SearchQueryParams extends SearchToolParams {
     provider?: SearchProviderId | "auto";
 }
+/** Override the hedge delay (tests). Non-finite/non-positive resets to default. */
+export declare function setDdgHedgeDelayMs(ms: number | undefined): void;
 /**
  * Execute a web search query for CLI/testing workflows.
  *
@@ -111,6 +113,6 @@ export declare class WebSearchTool implements AgentTool<typeof webSearchSchema,
 export declare const webSearchCustomTool: CustomTool<typeof webSearchSchema, SearchRenderDetails>;
 export declare function getSearchTools(): CustomTool<any, any>[];
 export { getConfiguredSearchProviderPreference, getSearchProvider, setPreferredSearchProvider, setSearchFallbackProviders, } from "./provider";
-export { setSearchHardTimeoutMs } from "./providers/utils";
+export { applyConfiguredSearchTimeout, setSearchHardTimeoutMs } from "./providers/utils";
 export type { SearchProviderId as SearchProvider, SearchResponse } from "./types";
 export { isConfigurableSearchProviderId, isSearchProviderPreference } from "./types";

package/dist/types/web/search/provider.d.ts

@@ -6,8 +6,17 @@ export { SearchProvider } from "./providers/base";
 export declare function getSearchProviderLabel(id: SearchProviderId): string;
 export declare function getSearchProvider(id: SearchProviderId): Promise<SearchProvider>;
 export declare const SEARCH_PROVIDER_ORDER: SearchProviderId[];
+/** Drop every cached resolved chain (settings changed, tests). */
+export declare function clearResolvedChainCache(): void;
 export declare function setPreferredSearchProvider(provider: SearchProviderId | "auto"): void;
 export declare function setSearchFallbackProviders(ids: readonly string[]): void;
+/**
+ * Fire-and-forget warm-up: resolve the provider chain once so the provider
+ * modules are imported and the chain cache is primed before the first
+ * user-visible search. Errors are intentionally swallowed — prewarming must
+ * never surface a failure the real search path would handle itself.
+ */
+export declare function prewarmSearchProviders(options: ResolveProviderChainOptions): void;
 export interface SearchProviderPreferenceSource {
     get(path: "providers.webSearch" | "web_search.provider"): SearchProviderId | "auto";
     has(path: "providers.webSearch" | "web_search.provider"): boolean;

package/dist/types/web/search/providers/utils.d.ts

@@ -15,27 +15,53 @@ import { SearchProviderError, type SearchProviderId, type SearchSource } from ".
  */
 export declare function findCredential(storage: AgentStorage | null | undefined, envKey: string | null | undefined, ...storageProviders: string[]): string | null;
 /**
- * Default hard ceiling for a single web-search round-trip. 300s tolerates
- * legitimate slow LLM-mediated responses (anthropic web_search_20250305,
- * perplexity, gemini, OpenAI code backend) while still guaranteeing the session unfreezes
- * if Bun's `AbortSignal` fails to propagate on Windows.
- *
- * Pure search APIs (brave, exa, jina, tavily, searxng, synthetic, zai)
- * settle far faster in practice; reusing the same ceiling keeps the wiring
- * uniform without compromising correctness.
+ * Legacy hard ceiling for a single web-search round-trip, retained as the
+ * fallback for call sites that do not declare a timeout class. 300s tolerates
+ * pathological cases while still guaranteeing the session unfreezes if Bun's
+ * `AbortSignal` fails to propagate on Windows.
  */
 export declare const SEARCH_HARD_TIMEOUT_MS = 300000;
+/**
+ * Hard ceiling for pure search APIs (brave, exa, jina, tavily, kagi,
+ * parallel, searxng, synthetic, zai, duckduckgo). These settle in ~1-3s in
+ * practice; a hung TCP/TLS connection should fall through to the next
+ * provider in seconds, not minutes. Kimi is the exception: it declares an
+ * explicit ceiling aligned with its upstream 30s request budget.
+ */
+export declare const SEARCH_API_TIMEOUT_MS = 15000;
+/**
+ * Hard ceiling for LLM-mediated search providers (anthropic, codex, gemini,
+ * perplexity, xai, openai-compatible). These legitimately take tens of
+ * seconds because a model performs the search and synthesizes an answer.
+ */
+export declare const SEARCH_LLM_TIMEOUT_MS = 120000;
+/** Timeout class a provider declares for its outbound round-trips. */
+export type SearchTimeoutClass = "api" | "llm";
 /**
  * Override the hard timeout applied to every web-search round-trip.
  *
  * @param ms - Hard timeout in milliseconds. Non-finite or non-positive
- *   values reset the timeout to {@link SEARCH_HARD_TIMEOUT_MS}.
+ *   values clear the override so per-class defaults apply.
  */
 export declare function setSearchHardTimeoutMs(ms: number | undefined): void;
+/** Structural settings source for {@link applyConfiguredSearchTimeout}. */
+export interface SearchTimeoutSettingSource {
+    get(path: "web_search.timeout"): unknown;
+    has(path: "web_search.timeout"): boolean;
+}
+/**
+ * Install the `web_search.timeout` override from settings — but only when the
+ * user explicitly configured it. The settings schema ships a default value
+ * (300), and consuming that default via `get()` alone would reinstall a
+ * uniform 300s ceiling on every session, silently disabling the per-class
+ * timeout defaults. `has()` distinguishes loaded/overridden settings from
+ * schema defaults; unset clears any previous override so class defaults apply.
+ */
+export declare function applyConfiguredSearchTimeout(settings: SearchTimeoutSettingSource): void;
 /**
  * Compose a caller-supplied {@link AbortSignal} with a hard timeout so an
- * outbound `fetch()` is guaranteed to settle within `ms` even when the
- * runtime fails to propagate cancellation to the underlying transport.
+ * outbound `fetch()` is guaranteed to settle even when the runtime fails to
+ * propagate cancellation to the underlying transport.
  *
  * Bun's WinHTTP backend on Windows is known to ignore `AbortSignal` once a
  * TCP/TLS connection stalls (oven-sh/bun#15275, oven-sh/bun#18536); without
@@ -43,9 +69,12 @@ export declare function setSearchHardTimeoutMs(ms: number | undefined): void;
  * because the user's Esc is never delivered to the native layer.
  *
  * @param signal - Caller cancellation signal, if any.
- * @param ms - Hard timeout in milliseconds. Defaults to the configured value.
+ * @param msOrClass - Explicit timeout in milliseconds, or a
+ *   {@link SearchTimeoutClass} resolved to its class default. Omitted falls
+ *   back to the legacy {@link SEARCH_HARD_TIMEOUT_MS} ceiling. A user-set
+ *   `web_search.timeout` overrides class defaults (but not explicit ms).
  */
-export declare function withHardTimeout(signal: AbortSignal | undefined, ms?: number): AbortSignal;
+export declare function withHardTimeout(signal: AbortSignal | undefined, msOrClass?: number | SearchTimeoutClass): AbortSignal;
 /**
  * Map a provider's raw source list to the unified SearchSource shape,
  * clamped to the requested result count and annotated with ageSeconds.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@gajae-code/coding-agent",
-	"version": "0.7.10",
+	"version": "0.7.11",
 	"description": "Gajae Code CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://gaebal-gajae.dev",
 	"author": "Yeachan-Heo",
@@ -52,12 +52,12 @@
 		"@agentclientprotocol/sdk": "0.21.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@gajae-code/stats": "0.7.10",
-		"@gajae-code/agent-core": "0.7.10",
-		"@gajae-code/ai": "0.7.10",
-		"@gajae-code/natives": "0.7.10",
-		"@gajae-code/tui": "0.7.10",
-		"@gajae-code/utils": "0.7.10",
+		"@gajae-code/stats": "0.7.11",
+		"@gajae-code/agent-core": "0.7.11",
+		"@gajae-code/ai": "0.7.11",
+		"@gajae-code/natives": "0.7.11",
+		"@gajae-code/tui": "0.7.11",
+		"@gajae-code/utils": "0.7.11",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/src/cli/update-cli.ts

@@ -10,6 +10,7 @@ import { pipeline } from "node:stream/promises";
 import { $which, APP_NAME, isEnoent, VERSION } from "@gajae-code/utils";
 import { $ } from "bun";
 import chalk from "chalk";
+import { installDefaultGjcDefinitions } from "../defaults/gjc-defaults";
 import { theme } from "../modes/theme/theme";
 
 const RELEASE_REPO = "Yeachan-Heo/gajae-code";
@@ -628,6 +629,29 @@ export async function runUpdateCommand(opts: { force: boolean; check: boolean })
 		console.error(chalk.red(`Update failed: ${err}`));
 		process.exit(1);
 	}
+
+	await refreshInstalledDefaultSkills();
+}
+
+/**
+ * Refresh opted-in on-disk default workflow skill copies after a successful
+ * update. The four default skills ship embedded in the binary, so most users
+ * need nothing here. But users who ran `gjc setup defaults` have on-disk copies
+ * under the agent dir that shadow the embedded defaults; those would otherwise
+ * go stale after an update. Only rewrite files that already exist and differ —
+ * never materialize new copies for users who never opted in.
+ */
+async function refreshInstalledDefaultSkills(): Promise<void> {
+	try {
+		const result = await installDefaultGjcDefinitions({ refreshOnly: true });
+		if (result.written > 0) {
+			console.log(
+				chalk.dim(`Refreshed ${result.written} local default workflow skill file(s) at ${result.targetRoot}`),
+			);
+		}
+	} catch (err) {
+		console.error(chalk.yellow(`Warning: failed to refresh local default workflow skills: ${err}`));
+	}
 }
 
 /**

package/src/cli/web-search-cli.ts

@@ -16,7 +16,7 @@ import {
 	type SearchQueryParams,
 } from "../web/search/index";
 import { SEARCH_PROVIDER_ORDER, setPreferredSearchProvider, setSearchFallbackProviders } from "../web/search/provider";
-import { setSearchHardTimeoutMs } from "../web/search/providers/utils";
+import { applyConfiguredSearchTimeout } from "../web/search/providers/utils";
 import { renderSearchResult } from "../web/search/render";
 import type { SearchProviderId } from "../web/search/types";
 
@@ -181,10 +181,7 @@ export async function runSearchCommand(cmd: SearchCommandArgs): Promise<void> {
 			configuredFallback.filter(value => typeof value === "string" && isConfigurableSearchProviderId(value)),
 		);
 	}
-	const configuredTimeout = settings.get("web_search.timeout");
-	if (typeof configuredTimeout === "number" && Number.isFinite(configuredTimeout) && configuredTimeout > 0) {
-		setSearchHardTimeoutMs(configuredTimeout * 1000);
-	}
+	applyConfiguredSearchTimeout(settings);
 
 	const params: SearchQueryParams = {
 		query: cmd.query,

package/src/cli.ts

@@ -141,7 +141,7 @@ class RootHelpCommand extends Command {
 		resume: Flags.string({ char: "r", description: "Resume a session (by ID prefix, path, or picker if omitted)" }),
 		"session-dir": Flags.string({ description: "Directory for session storage and lookup" }),
 		"no-session": Flags.boolean({ description: "Don't save session (ephemeral)" }),
-		models: Flags.string({ description: "Comma-separated model patterns for Ctrl+P cycling" }),
+		models: Flags.string({ description: "Comma-separated model patterns for Alt+N cycling" }),
 		"no-tools": Flags.boolean({ description: "Disable all built-in tools" }),
 		"no-lsp": Flags.boolean({ description: "Disable LSP tools, formatting, and diagnostics" }),
 		"no-pty": Flags.boolean({ description: "Disable PTY-based interactive bash execution" }),

package/src/commands/launch.ts

@@ -119,7 +119,7 @@ export default class Index extends Command {
 			description: "Don't save session (ephemeral)",
 		}),
 		models: Flags.string({
-			description: "Comma-separated model patterns for Ctrl+P cycling",
+			description: "Comma-separated model patterns for Alt+N cycling",
 		}),
 		"no-tools": Flags.boolean({
 			description: "Disable all built-in tools",

package/src/commands/ralplan.ts

@@ -8,6 +8,7 @@ export default class Ralplan extends Command {
 		'$ gjc ralplan "<task description>"',
 		'$ gjc ralplan --interactive --deliberate "<task description>"',
 		'$ gjc ralplan --write --stage planner --stage_n 1 --artifact "<markdown or path>"',
+		"$ gjc ralplan --write --stage critic --stage_n 1 --artifact-env GJC_RALPLAN_ARTIFACT",
 	];
 
 	async run(): Promise<void> {