shortcutxl 0.3.76 → 0.3.78

package/dist/shell/status/update-check-scheduler.d.ts

@@ -0,0 +1,30 @@
+export declare const UPDATE_CHECK_INTERVAL_MS: number;
+interface UpdateCheckSchedulerOptions<T> {
+    check: () => Promise<T>;
+    onResult: (result: T) => void;
+    intervalMs?: number;
+}
+interface UpdateCheckSchedulerDeps {
+    now?: () => number;
+    setTimer?: typeof setTimeout;
+    clearTimer?: typeof clearTimeout;
+}
+/** Schedules one coalesced asynchronous update check at most once per interval. */
+export declare class UpdateCheckScheduler<T> {
+    private readonly options;
+    private readonly intervalMs;
+    private readonly now;
+    private readonly setTimer;
+    private readonly clearTimer;
+    private timer;
+    private inFlight;
+    private nextCheckAt;
+    private stopped;
+    constructor(options: UpdateCheckSchedulerOptions<T>, deps?: UpdateCheckSchedulerDeps);
+    start(lastCheckedAt?: string): void;
+    stop(): void;
+    private schedule;
+    private runCheck;
+}
+export {};
+//# sourceMappingURL=update-check-scheduler.d.ts.map

package/dist/shell/status/update-check-scheduler.js

@@ -0,0 +1,71 @@
+export const UPDATE_CHECK_INTERVAL_MS = 12 * 60 * 60 * 1000;
+/** Schedules one coalesced asynchronous update check at most once per interval. */
+export class UpdateCheckScheduler {
+    options;
+    intervalMs;
+    now;
+    setTimer;
+    clearTimer;
+    timer;
+    inFlight;
+    nextCheckAt = Number.POSITIVE_INFINITY;
+    stopped = true;
+    constructor(options, deps = {}) {
+        this.options = options;
+        this.intervalMs = options.intervalMs ?? UPDATE_CHECK_INTERVAL_MS;
+        this.now = deps.now ?? Date.now;
+        this.setTimer = deps.setTimer ?? setTimeout;
+        this.clearTimer = deps.clearTimer ?? clearTimeout;
+    }
+    start(lastCheckedAt) {
+        this.stopped = false;
+        const lastCheckedAtMs = lastCheckedAt ? Date.parse(lastCheckedAt) : Number.NaN;
+        const delayMs = Number.isFinite(lastCheckedAtMs)
+            ? Math.min(this.intervalMs, Math.max(0, lastCheckedAtMs + this.intervalMs - this.now()))
+            : 0;
+        this.schedule(delayMs);
+    }
+    stop() {
+        this.stopped = true;
+        if (this.timer) {
+            this.clearTimer(this.timer);
+            this.timer = undefined;
+        }
+    }
+    schedule(delayMs) {
+        if (this.stopped)
+            return;
+        if (this.timer)
+            this.clearTimer(this.timer);
+        this.nextCheckAt = this.now() + delayMs;
+        this.timer = this.setTimer(() => {
+            this.timer = undefined;
+            this.runCheck();
+        }, delayMs);
+        this.timer.unref?.();
+    }
+    runCheck() {
+        if (this.stopped || this.inFlight)
+            return;
+        if (this.timer) {
+            this.clearTimer(this.timer);
+            this.timer = undefined;
+        }
+        this.nextCheckAt = this.now() + this.intervalMs;
+        const task = Promise.resolve()
+            .then(() => this.options.check())
+            .then((result) => {
+            if (!this.stopped)
+                this.options.onResult(result);
+        })
+            .catch(() => { })
+            .finally(() => {
+            if (this.inFlight !== task)
+                return;
+            this.inFlight = undefined;
+            this.schedule(Math.max(0, this.nextCheckAt - this.now()));
+        });
+        this.inFlight = task;
+    }
+}
+//# sourceMappingURL=update-check-scheduler.js.map

package/dist/shell/status/update-reminder-controller.d.ts

@@ -0,0 +1,22 @@
+import { Container } from '../../tui/index.js';
+import { type InteractiveAvailableUpdate } from './update-reminder.js';
+interface UpdateReminderControllerOptions {
+    initialUpdate?: InteractiveAvailableUpdate;
+    lastCheckedAt?: string;
+    checkForUpdate?: () => Promise<InteractiveAvailableUpdate | undefined>;
+    onChange: () => void;
+}
+/** Owns the live update state, reminder component, and non-blocking refresh schedule. */
+export declare class UpdateReminderController {
+    private readonly options;
+    readonly container: Container;
+    private update;
+    private readonly scheduler;
+    constructor(options: UpdateReminderControllerOptions);
+    start(): void;
+    stop(): void;
+    private setUpdate;
+    private render;
+}
+export {};
+//# sourceMappingURL=update-reminder-controller.d.ts.map

package/dist/shell/status/update-reminder-controller.js

@@ -0,0 +1,40 @@
+import { Container, Text } from '../../tui/index.js';
+import { theme } from '../theme/runtime.js';
+import { UpdateCheckScheduler } from './update-check-scheduler.js';
+import { formatUpdateReminder } from './update-reminder.js';
+/** Owns the live update state, reminder component, and non-blocking refresh schedule. */
+export class UpdateReminderController {
+    options;
+    container = new Container();
+    update;
+    scheduler;
+    constructor(options) {
+        this.options = options;
+        this.update = options.initialUpdate;
+        this.render();
+        this.scheduler = options.checkForUpdate
+            ? new UpdateCheckScheduler({
+                check: options.checkForUpdate,
+                onResult: (update) => this.setUpdate(update)
+            })
+            : null;
+    }
+    start() {
+        this.scheduler?.start(this.options.lastCheckedAt);
+    }
+    stop() {
+        this.scheduler?.stop();
+    }
+    setUpdate(update) {
+        this.update = update;
+        this.render();
+        this.options.onChange();
+    }
+    render() {
+        this.container.clear();
+        if (!this.update)
+            return;
+        this.container.addChild(new Text(theme.fg('accent', formatUpdateReminder(this.update)), 1, 0));
+    }
+}
+//# sourceMappingURL=update-reminder-controller.js.map

package/dist/shell/status/update-reminder.d.ts

@@ -0,0 +1,6 @@
+export interface InteractiveAvailableUpdate {
+    currentVersion: string;
+    latestVersion: string;
+}
+export declare function formatUpdateReminder(update: InteractiveAvailableUpdate): string;
+//# sourceMappingURL=update-reminder.d.ts.map

package/dist/shell/status/update-reminder.js

@@ -0,0 +1,4 @@
+export function formatUpdateReminder(update) {
+    return `Update available: ${update.currentVersion} → ${update.latestVersion}. Restart ShortcutXL and choose Update now.`;
+}
+//# sourceMappingURL=update-reminder.js.map

package/dist/shell/theme/dark.json

@@ -77,8 +77,7 @@
     "thinkingHigh": "#34d058",
     "thinkingXhigh": "brandGreen",
 
-    "bashMode": "#ff6eb4",
-    "chatMode": "#5bc0de"
+    "bashMode": "#ff6eb4"
   },
   "export": {
     "pageBg": "#18181b",

package/dist/shell/theme/light.json

@@ -77,8 +77,7 @@
     "thinkingHigh": "#088a43",
     "thinkingXhigh": "#059033",
 
-    "bashMode": "#d6336c",
-    "chatMode": "#0088aa"
+    "bashMode": "#d6336c"
   },
   "export": {
     "pageBg": "#fafafa",

package/dist/shell/theme/runtime.d.ts

@@ -1,4 +1,4 @@
-export type ThemeColor = 'accent' | 'border' | 'borderAccent' | 'borderMuted' | 'success' | 'error' | 'errorDim' | 'warning' | 'muted' | 'dim' | 'text' | 'thinkingText' | 'userMessageText' | 'customMessageText' | 'customMessageLabel' | 'toolTitle' | 'toolOutput' | 'mdHeading' | 'mdLink' | 'mdLinkUrl' | 'mdCode' | 'mdCodeBlock' | 'mdCodeBlockBorder' | 'mdQuote' | 'mdQuoteBorder' | 'mdHr' | 'mdListBullet' | 'toolDiffAdded' | 'toolDiffRemoved' | 'toolDiffContext' | 'syntaxComment' | 'syntaxKeyword' | 'syntaxFunction' | 'syntaxVariable' | 'syntaxString' | 'syntaxNumber' | 'syntaxType' | 'syntaxOperator' | 'syntaxPunctuation' | 'thinkingOff' | 'thinkingMinimal' | 'thinkingLow' | 'thinkingMedium' | 'thinkingHigh' | 'thinkingXhigh' | 'bashMode' | 'chatMode';
+export type ThemeColor = 'accent' | 'border' | 'borderAccent' | 'borderMuted' | 'success' | 'error' | 'errorDim' | 'warning' | 'muted' | 'dim' | 'text' | 'thinkingText' | 'userMessageText' | 'customMessageText' | 'customMessageLabel' | 'toolTitle' | 'toolOutput' | 'mdHeading' | 'mdLink' | 'mdLinkUrl' | 'mdCode' | 'mdCodeBlock' | 'mdCodeBlockBorder' | 'mdQuote' | 'mdQuoteBorder' | 'mdHr' | 'mdListBullet' | 'toolDiffAdded' | 'toolDiffRemoved' | 'toolDiffContext' | 'syntaxComment' | 'syntaxKeyword' | 'syntaxFunction' | 'syntaxVariable' | 'syntaxString' | 'syntaxNumber' | 'syntaxType' | 'syntaxOperator' | 'syntaxPunctuation' | 'thinkingOff' | 'thinkingMinimal' | 'thinkingLow' | 'thinkingMedium' | 'thinkingHigh' | 'thinkingXhigh' | 'bashMode';
 export type ThemeBg = 'selectedBg' | 'userMessageBg' | 'customMessageBg' | 'toolPendingBg' | 'toolSuccessBg' | 'toolErrorBg';
 type ColorMode = 'truecolor' | '256color';
 export declare class Theme {
@@ -21,9 +21,8 @@ export declare class Theme {
     getFgAnsi(color: ThemeColor): string;
     getBgAnsi(color: ThemeBg): string;
     getColorMode(): ColorMode;
-    getThinkingBorderColor(level: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'): (str: string) => string;
+    getThinkingBorderColor(level: 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max'): (str: string) => string;
     getBashModeBorderColor(): (str: string) => string;
-    getChatModeBorderColor(): (str: string) => string;
 }
 export declare function getAvailableThemes(): string[];
 export declare function loadThemeFromPath(themePath: string, mode?: ColorMode): Theme;

package/dist/shell/theme/runtime.js

@@ -74,9 +74,7 @@ const ThemeJsonSchema = Type.Object({
         thinkingHigh: ColorValueSchema,
         thinkingXhigh: ColorValueSchema,
         // Bash Mode (1 color)
-        bashMode: ColorValueSchema,
-        // Chat Mode (1 color — collab chat prefix)
-        chatMode: ColorValueSchema
+        bashMode: ColorValueSchema
     }),
     export: Type.Optional(Type.Object({
         pageBg: Type.Optional(ColorValueSchema),
@@ -321,6 +319,7 @@ export class Theme {
             case 'high':
                 return (str) => this.fg('thinkingHigh', str);
             case 'xhigh':
+            case 'max':
                 return (str) => this.fg('thinkingXhigh', str);
             default:
                 return (str) => this.fg('thinkingOff', str);
@@ -329,9 +328,6 @@ export class Theme {
     getBashModeBorderColor() {
         return (str) => this.fg('bashMode', str);
     }
-    getChatModeBorderColor() {
-        return (str) => this.fg('chatMode', str);
-    }
 }
 // ============================================================================
 // Theme Loading

package/dist/shell/theme/theme-schema.json

@@ -85,8 +85,7 @@
         "thinkingMedium",
         "thinkingHigh",
         "thinkingXhigh",
-        "bashMode",
-        "chatMode"
+        "bashMode"
       ],
       "properties": {
         "accent": {
@@ -292,10 +291,6 @@
         "bashMode": {
           "$ref": "#/$defs/colorValue",
           "description": "Editor border color in bash mode"
-        },
-        "chatMode": {
-          "$ref": "#/$defs/colorValue",
-          "description": "Editor border color and text color in collab chat mode"
         }
       },
       "additionalProperties": false

package/dist/shortcut-model-catalog.d.ts

@@ -1,7 +1,12 @@
-import type { Api, Model } from './ai/types.js';
-export type ShortcutModelDefinition = Pick<Model<Api>, 'id' | 'name' | 'reasoning' | 'input' | 'cost' | 'contextWindow' | 'maxTokens' | 'compat'>;
+import type { Api, KnownApi, Model, ReasoningLevel } from './ai/types.js';
+export type ShortcutModelDefinition = Pick<Model<Api>, 'capabilities' | 'compat' | 'contextWindow' | 'cost' | 'id' | 'input' | 'maxTokens' | 'name' | 'reasoning'> & {
+    /** Provider-native protocol exposed by api-v2 for this model. */
+    readonly protocol: KnownApi;
+};
 export declare const DEFAULT_SHORTCUT_MODEL_ID: "gpt-5.6-sol";
 export declare function createShortcutPublicModelDefinitions(): ShortcutModelDefinition[];
 export declare function createShortcutHostedModelDefinitions(): ShortcutModelDefinition[];
 export declare function createShortcutModelDefinitions(): ShortcutModelDefinition[];
+export declare function resolveShortcutModelProtocol(modelId: string): KnownApi | undefined;
+export declare function resolveShortcutModelDefaultReasoningLevel(modelId: string): ReasoningLevel | undefined;
 //# sourceMappingURL=shortcut-model-catalog.d.ts.map

package/dist/shortcut-model-catalog.js

@@ -8,7 +8,16 @@ const SHORTCUT_PUBLIC_MODEL_DEFINITIONS = [
         input: ['text', 'image'],
         cost: { input: 10, output: 50, cacheRead: 1, cacheWrite: 12.5 },
         contextWindow: 1_000_000,
-        maxTokens: 128000
+        maxTokens: 128000,
+        capabilities: {
+            reasoning: {
+                control: 'adaptive-effort',
+                defaultLevel: 'high',
+                levels: ['low', 'medium', 'high', 'xhigh', 'max'],
+                supportsOff: false
+            }
+        },
+        protocol: 'anthropic-messages'
     },
     {
         id: SHORTCUT_MODEL_ID.ClaudeOpus5,
@@ -17,7 +26,16 @@ const SHORTCUT_PUBLIC_MODEL_DEFINITIONS = [
         input: ['text', 'image'],
         cost: { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
         contextWindow: 1_000_000,
-        maxTokens: 128000
+        maxTokens: 128000,
+        capabilities: {
+            reasoning: {
+                control: 'adaptive-effort',
+                defaultLevel: 'high',
+                levels: ['low', 'medium', 'high', 'xhigh', 'max'],
+                supportsOff: true
+            }
+        },
+        protocol: 'anthropic-messages'
     },
     {
         id: SHORTCUT_MODEL_ID.ClaudeOpus48,
@@ -26,7 +44,16 @@ const SHORTCUT_PUBLIC_MODEL_DEFINITIONS = [
         input: ['text', 'image'],
         cost: { input: 5, output: 25, cacheRead: 0.5, cacheWrite: 6.25 },
         contextWindow: 1_000_000,
-        maxTokens: 128000
+        maxTokens: 128000,
+        capabilities: {
+            reasoning: {
+                control: 'adaptive-effort',
+                defaultLevel: 'high',
+                levels: ['low', 'medium', 'high', 'xhigh', 'max'],
+                supportsOff: true
+            }
+        },
+        protocol: 'anthropic-messages'
     },
     {
         id: SHORTCUT_OPENAI_MODEL_ID,
@@ -35,7 +62,16 @@ const SHORTCUT_PUBLIC_MODEL_DEFINITIONS = [
         input: ['text', 'image'],
         cost: { input: 5, output: 30, cacheRead: 0.5, cacheWrite: 6.25 },
         contextWindow: 1_000_000,
-        maxTokens: 128000
+        maxTokens: 128000,
+        capabilities: {
+            reasoning: {
+                control: 'effort',
+                defaultLevel: 'medium',
+                levels: ['low', 'medium', 'high', 'xhigh', 'max'],
+                supportsOff: true
+            }
+        },
+        protocol: 'openai-responses'
     },
     {
         id: SHORTCUT_MODEL_ID.Grok45,
@@ -45,6 +81,15 @@ const SHORTCUT_PUBLIC_MODEL_DEFINITIONS = [
         cost: { input: 2, output: 6, cacheRead: 0.5, cacheWrite: 0 },
         contextWindow: 500_000,
         maxTokens: 128000,
+        capabilities: {
+            reasoning: {
+                control: 'effort',
+                defaultLevel: 'high',
+                levels: ['low', 'medium', 'high'],
+                supportsOff: false
+            }
+        },
+        protocol: 'openai-completions',
         compat: {
             supportsStore: false,
             supportsDeveloperRole: false,
@@ -59,7 +104,20 @@ const SHORTCUT_PUBLIC_MODEL_DEFINITIONS = [
         input: ['text'],
         cost: { input: 1.4, output: 4.4, cacheRead: 0.14, cacheWrite: 1.4 },
         contextWindow: 1_040_000,
-        maxTokens: 128000
+        maxTokens: 128000,
+        capabilities: {
+            reasoning: {
+                control: 'effort',
+                defaultLevel: 'high',
+                levels: ['high', 'max'],
+                supportsOff: true
+            }
+        },
+        protocol: 'openai-completions',
+        compat: {
+            supportsDeveloperRole: false,
+            supportsReasoningEffort: true
+        }
     },
     // Vision/extraction models the proxy routes to for llm_analysis, take_screenshot,
     // tool summaries, and durable memory. Registered so the api-v2 proxy client's
@@ -72,7 +130,16 @@ const SHORTCUT_PUBLIC_MODEL_DEFINITIONS = [
         input: ['text', 'image'],
         cost: { input: 0.5, output: 3, cacheRead: 0.05, cacheWrite: 0 },
         contextWindow: 1_048_576,
-        maxTokens: 65536
+        maxTokens: 65536,
+        capabilities: {
+            reasoning: {
+                control: 'thinking-level',
+                defaultLevel: 'minimal',
+                levels: ['minimal', 'low', 'medium', 'high'],
+                supportsOff: false
+            }
+        },
+        protocol: 'google-vertex'
     },
     {
         id: SHORTCUT_MODEL_ID.Gemini35FlashLite,
@@ -81,7 +148,16 @@ const SHORTCUT_PUBLIC_MODEL_DEFINITIONS = [
         input: ['text', 'image'],
         cost: { input: 0.3, output: 2.5, cacheRead: 0.03, cacheWrite: 0 },
         contextWindow: 1_048_576,
-        maxTokens: 65536
+        maxTokens: 65536,
+        capabilities: {
+            reasoning: {
+                control: 'thinking-level',
+                defaultLevel: 'minimal',
+                levels: ['minimal', 'low', 'medium', 'high'],
+                supportsOff: false
+            }
+        },
+        protocol: 'google-vertex'
     },
     {
         id: SHORTCUT_MODEL_ID.Gemini36Flash,
@@ -90,7 +166,16 @@ const SHORTCUT_PUBLIC_MODEL_DEFINITIONS = [
         input: ['text', 'image'],
         cost: { input: 1.5, output: 7.5, cacheRead: 0.15, cacheWrite: 0 },
         contextWindow: 1_048_576,
-        maxTokens: 65536
+        maxTokens: 65536,
+        capabilities: {
+            reasoning: {
+                control: 'thinking-level',
+                defaultLevel: 'medium',
+                levels: ['minimal', 'low', 'medium', 'high'],
+                supportsOff: false
+            }
+        },
+        protocol: 'google-vertex'
     },
     {
         id: SHORTCUT_MODEL_ID.ClaudeHaiku45,
@@ -99,7 +184,16 @@ const SHORTCUT_PUBLIC_MODEL_DEFINITIONS = [
         input: ['text', 'image'],
         cost: { input: 1, output: 5, cacheRead: 0.1, cacheWrite: 1.25 },
         contextWindow: 200_000,
-        maxTokens: 64000
+        maxTokens: 64000,
+        capabilities: {
+            reasoning: {
+                control: 'budget',
+                defaultLevel: 'minimal',
+                levels: ['minimal', 'low', 'medium', 'high'],
+                supportsOff: true
+            }
+        },
+        protocol: 'anthropic-messages'
     }
 ];
 const SHORTCUT_HOSTED_MODEL_DEFINITIONS = [
@@ -110,7 +204,11 @@ const SHORTCUT_HOSTED_MODEL_DEFINITIONS = [
         input: ['text'],
         cost: { input: 0.195, output: 1.56, cacheRead: 0.0195, cacheWrite: 0 },
         contextWindow: HOSTED_CONTEXT_WINDOW_TOKENS,
-        maxTokens: HOSTED_MAX_NEW_TOKENS
+        maxTokens: HOSTED_MAX_NEW_TOKENS,
+        protocol: 'openai-completions',
+        compat: {
+            supportsDeveloperRole: false
+        }
     }
 ];
 function cloneShortcutModelDefinition(model) {
@@ -118,6 +216,21 @@ function cloneShortcutModelDefinition(model) {
         ...model,
         input: [...model.input],
         cost: { ...model.cost },
+        ...(model.capabilities
+            ? {
+                capabilities: {
+                    ...model.capabilities,
+                    ...(model.capabilities.reasoning
+                        ? {
+                            reasoning: {
+                                ...model.capabilities.reasoning,
+                                levels: [...model.capabilities.reasoning.levels]
+                            }
+                        }
+                        : {})
+                }
+            }
+            : {}),
         ...(model.compat ? { compat: { ...model.compat } } : {})
     };
 }
@@ -130,4 +243,15 @@ export function createShortcutHostedModelDefinitions() {
 export function createShortcutModelDefinitions() {
     return [...createShortcutPublicModelDefinitions(), ...createShortcutHostedModelDefinitions()];
 }
+export function resolveShortcutModelProtocol(modelId) {
+    const normalized = modelId.trim().toLowerCase();
+    return [...SHORTCUT_PUBLIC_MODEL_DEFINITIONS, ...SHORTCUT_HOSTED_MODEL_DEFINITIONS].find((model) => model.id.toLowerCase() === normalized)?.protocol;
+}
+export function resolveShortcutModelDefaultReasoningLevel(modelId) {
+    const normalized = modelId.trim().toLowerCase();
+    const model = [...SHORTCUT_PUBLIC_MODEL_DEFINITIONS, ...SHORTCUT_HOSTED_MODEL_DEFINITIONS].find((candidate) => candidate.id.toLowerCase() === normalized);
+    if (!model?.reasoning)
+        return model ? 'off' : undefined;
+    return model.capabilities?.reasoning?.defaultLevel;
+}
 //# sourceMappingURL=shortcut-model-catalog.js.map

package/dist/startup/update-manager.d.ts

@@ -1,8 +1,8 @@
 /**
  * Startup-owned runtime package update detection and cache state.
  *
- * Reads a small local cache immediately, optionally refreshes it in the
- * background, and returns the update state for this run.
+ * Reads a small local cache for startup and exposes an explicit asynchronous
+ * refresh for the live shell.
  */
 interface UpdateCacheFile {
     latestVersion: string;
@@ -31,12 +31,12 @@ export interface ResolveUpdateOptions {
     packageName?: string;
     registryUrl?: string;
 }
-interface ResolveUpdateDeps {
+interface RefreshUpdateDeps {
     fetchLatestVersion?: (registryUrl: string) => Promise<string | undefined>;
-    scheduleBackgroundTask?: (task: () => Promise<void>) => void;
 }
-export declare function resolveStartupUpdateStatus(options?: ResolveUpdateOptions, deps?: ResolveUpdateDeps): Promise<UpdateStatus>;
-export declare function shouldRefreshUpdateCache(cache: UpdateCacheFile | undefined, now: Date, ttlMs?: number): boolean;
+export declare function resolveStartupUpdateStatus(options?: ResolveUpdateOptions): Promise<UpdateStatus>;
+/** Refresh the registry-backed cache without blocking startup or session changes. */
+export declare function refreshUpdateStatus(options?: ResolveUpdateOptions, deps?: RefreshUpdateDeps): Promise<UpdateStatus>;
 export declare function getUpdateStatusFromCache(cache: UpdateCacheFile | undefined, options: {
     currentVersion: string;
     packageName?: string;

package/dist/startup/update-manager.js

@@ -1,56 +1,47 @@
 /**
  * Startup-owned runtime package update detection and cache state.
  *
- * Reads a small local cache immediately, optionally refreshes it in the
- * background, and returns the update state for this run.
+ * Reads a small local cache for startup and exposes an explicit asynchronous
+ * refresh for the live shell.
  */
 import { mkdirSync, readFileSync, writeFileSync } from 'fs';
 import { dirname } from 'path';
 import { getUpdateCachePath, getUpdateCommand, getUpdateInstruction, NPM_PACKAGE_NAME, NPM_REGISTRY_URL, VERSION } from '../config.js';
-const UPDATE_CACHE_TTL_MS = 20 * 60 * 60 * 1000;
-export async function resolveStartupUpdateStatus(options = {}, deps = {}) {
+export async function resolveStartupUpdateStatus(options = {}) {
     const cachePath = options.cachePath ?? getUpdateCachePath();
     const currentVersion = options.currentVersion ?? VERSION;
     const packageName = options.packageName ?? NPM_PACKAGE_NAME;
-    const registryUrl = options.registryUrl ?? NPM_REGISTRY_URL;
-    const now = options.now ?? new Date();
     if (options.skipCheck) {
         return { kind: 'none', currentVersion };
     }
     const cache = readUpdateCache(cachePath);
-    // Cold-start users migrated from the old live-check flow do not have an
-    // update cache yet. Do one bounded foreground fetch so the first launch
-    // after the rollout can still show the update prompt immediately.
-    if (!options.offline && !cache) {
-        const refreshed = await fetchAndPersistUpdateCache({ cachePath, registryUrl, now }, { fetchLatestVersion: deps.fetchLatestVersion });
-        return getUpdateStatusFromCache(refreshed, {
-            currentVersion,
-            packageName
-        });
-    }
-    if (!options.offline && shouldRefreshUpdateCache(cache, now)) {
-        const scheduleBackgroundTask = deps.scheduleBackgroundTask ??
-            ((task) => {
-                void task().catch(() => { });
-            });
-        scheduleBackgroundTask(async () => {
-            await refreshUpdateCache({ cachePath, registryUrl, now }, { fetchLatestVersion: deps.fetchLatestVersion });
-        });
-    }
     return getUpdateStatusFromCache(cache, {
         currentVersion,
         packageName
     });
 }
-export function shouldRefreshUpdateCache(cache, now, ttlMs = UPDATE_CACHE_TTL_MS) {
-    if (!cache) {
-        return true;
+/** Refresh the registry-backed cache without blocking startup or session changes. */
+export async function refreshUpdateStatus(options = {}, deps = {}) {
+    const cachePath = options.cachePath ?? getUpdateCachePath();
+    const currentVersion = options.currentVersion ?? VERSION;
+    const packageName = options.packageName ?? NPM_PACKAGE_NAME;
+    const registryUrl = options.registryUrl ?? NPM_REGISTRY_URL;
+    const now = options.now ?? new Date();
+    const cache = readUpdateCache(cachePath);
+    if (options.skipCheck || options.offline) {
+        return getUpdateStatusFromCache(cache, { currentVersion, packageName });
     }
-    const lastCheckedAtMs = Date.parse(cache.lastCheckedAt);
-    if (!Number.isFinite(lastCheckedAtMs)) {
-        return true;
+    let refreshed;
+    try {
+        refreshed = await fetchAndPersistUpdateCache({ cachePath, registryUrl, now }, { fetchLatestVersion: deps.fetchLatestVersion });
     }
-    return now.getTime() - lastCheckedAtMs >= ttlMs;
+    catch {
+        // Keep the last known cache. The live scheduler will retry on its next interval.
+    }
+    return getUpdateStatusFromCache(refreshed ?? cache, {
+        currentVersion,
+        packageName
+    });
 }
 export function getUpdateStatusFromCache(cache, options) {
     const noUpdate = {
@@ -74,12 +65,6 @@ export function getUpdateStatusFromCache(cache, options) {
         lastCheckedAt: cache.lastCheckedAt
     };
 }
-async function refreshUpdateCache(options, deps = {}) {
-    const nextCache = await fetchAndPersistUpdateCache(options, deps);
-    if (!nextCache) {
-        return;
-    }
-}
 async function fetchAndPersistUpdateCache(options, deps = {}) {
     const fetchLatestVersion = deps.fetchLatestVersion ?? fetchLatestVersionFromRegistry;
     const latestVersion = await fetchLatestVersion(options.registryUrl);

package/dist/startup/update-prompt.d.ts

@@ -1,6 +1,7 @@
 import type { AvailableUpdate, UpdateStatus } from './update-manager.js';
 export type StartupUpdatePromptOutcome = {
     kind: 'continue';
+    updateStatus?: UpdateStatus;
 } | {
     kind: 'run-update';
     update: AvailableUpdate;

package/dist/startup/update-prompt.js

@@ -2,14 +2,14 @@ import chalk from 'chalk';
 import { emitKeypressEvents } from 'readline';
 export async function runStartupUpdatePromptIfNeeded(updateStatus, deps = {}) {
     if (deps.suppress || updateStatus.kind !== 'available' || !updateStatus.command) {
-        return { kind: 'continue' };
+        return { kind: 'continue', updateStatus };
     }
     const write = deps.write ?? ((text) => process.stdout.write(text));
     const promptSelection = deps.promptSelection ?? promptSelectionInteractive;
     const selection = await promptSelection(updateStatus, write);
     return selection === 'update-now'
         ? { kind: 'run-update', update: updateStatus }
-        : { kind: 'continue' };
+        : { kind: 'continue', updateStatus };
 }
 export function renderStartupUpdatePrompt(update, selected = 'update-now') {
     const optionRow = (option, label) => {