@gajae-code/coding-agent 0.18.11 → 0.18.12

package/dist/types/config/config-hot-reload.d.ts

@@ -0,0 +1,39 @@
+export interface ConfigHotReloadPaths {
+    readonly configPath: string;
+    readonly modelsPath: string;
+}
+export interface ConfigHotReloadFileSnapshot {
+    readonly path: string;
+    readonly text: string | null;
+    readonly identity: string;
+}
+export interface ConfigHotReloadCandidate {
+    readonly revision: number;
+    readonly config: ConfigHotReloadFileSnapshot;
+    readonly models: ConfigHotReloadFileSnapshot;
+}
+export type ConfigHotReloadErrorOperation = "watch" | "read" | "validate" | "apply";
+/** A path-free diagnostic for watcher, snapshot, and callback failures. */
+export declare class ConfigHotReloadError extends Error {
+    readonly operation: ConfigHotReloadErrorOperation;
+    readonly code: string | undefined;
+    constructor(operation: ConfigHotReloadErrorOperation, code?: string);
+}
+export interface ConfigHotReloadWatcherOptions {
+    /** Validate the snapshots without mutating live state before a candidate may supersede queued work. */
+    readonly onValidate: (candidate: ConfigHotReloadCandidate) => void | Promise<void>;
+    /** Apply these text snapshots, not a second read of their paths, and honor abort before commit. */
+    readonly onCandidate: (candidate: ConfigHotReloadCandidate, signal: AbortSignal) => void | Promise<void>;
+    readonly onError: (error: ConfigHotReloadError) => void;
+}
+/** Watches resolved config and models files and delivers immutable source snapshots. */
+export declare class ConfigHotReloadWatcher {
+    #private;
+    constructor(options: ConfigHotReloadWatcherOptions);
+    /** Establishes the initial fingerprint baseline without emitting a candidate. */
+    start(paths: ConfigHotReloadPaths): Promise<void>;
+    /** Rebinds after session or configuration-root changes, fencing old work. */
+    rebind(paths: ConfigHotReloadPaths): Promise<void>;
+    /** Closes all watches and cancels or fences pending and in-flight callbacks. */
+    dispose(): void;
+}

package/dist/types/config/file-lock.d.ts

@@ -2,6 +2,8 @@ import type { NativeDirectoryTreeResult, NativeExactUnlinkResult } from "@gajae-
 import { renameDirectoryNoReplacePathAsync, renameNoReplacePathAsync } from "@gajae-code/natives";
 export interface FileLockOptions {
     staleMs?: number;
+    /** Age after which an ownerless removal transition may be adopted; defaults to `staleMs`. */
+    orphanTransitionAgeMs?: number;
     retries?: number;
     retryDelayMs?: number;
     signal?: AbortSignal;
@@ -42,6 +44,7 @@ export declare class FileLockAcquireError extends Error {
     constructor(filePath: string, lockPath: string, attempts: number, holder: string, reason?: FileLockAcquireReason, orphanPath?: string | undefined, removalFailure?: FileLockStaleRemovalFailure | undefined);
 }
 export declare function isFileLockAcquireTimeout(error: unknown): error is FileLockAcquireError;
+export declare const FILE_LOCK_ORPHAN_TRANSITION_ADOPTION_AGE_MS: number;
 /** Release retries cover transient handle denial and a competing exact-removal quarantine cleanup. */
 export declare const FILE_LOCK_RELEASE_RETRY_ATTEMPTS = 20;
 export declare const FILE_LOCK_RELEASE_RETRY_DELAY_MS = 25;
@@ -52,6 +55,10 @@ export declare const FileLockTestHooks: {
         renameNoReplacePathAsync: typeof renameNoReplacePathAsync;
         renameDirectoryNoReplacePathAsync: typeof renameDirectoryNoReplacePathAsync;
     };
+    stagingIdentityEvidence?: () => {
+        processIncarnation: string | null;
+        startTime: string | null;
+    };
     nativeQuarantineBindings?: () => NativeFileLockBindings;
     nativeExactRemovalProbe?: () => boolean | Promise<boolean>;
 };
@@ -177,7 +184,7 @@ export declare function acquireFileLock(filePath: string, options?: FileLockOpti
  * that fact through its own `lockHeld` path instead of acquiring it again.
  */
 export declare function withFileLock<T>(filePath: string, fn: () => Promise<T>, options?: FileLockOptions): Promise<T>;
-/** Strictly recognize the staging names emitted by tryAcquireLock. */
+/** Return a name-encoded staging PID for GC discovery. */
 export declare function fileLockStagingOwnerPid(name: string): number | null;
 export interface FileLockStagingResult {
     path: string;

package/dist/types/config/model-discovery-manager.d.ts

@@ -53,6 +53,8 @@ export declare class ModelDiscoveryManager<TProvider extends DiscoveryProvider>
     get providers(): readonly TProvider[];
     providerIds(): Set<string>;
     getState(provider: string): ProviderDiscoveryState | undefined;
+    /** Retain accepted discovery evidence for unchanged providers during a local reload. */
+    retainStatesFrom(source: ModelDiscoveryManager<TProvider>, providers: ReadonlySet<string>): void;
     invalidate(provider: string): void;
     loadCached(provider: TProvider, cacheDbPath?: string, expectedProvenance?: string): readonly Model<Api>[];
     beginRefresh(provider: string): DiscoveryRefreshToken;

package/dist/types/config/model-profile-activation.d.ts

@@ -1,6 +1,6 @@
 import { ThinkingLevel } from "@gajae-code/agent-core";
 import { type Api, type Model } from "@gajae-code/ai/core";
-import type { AgentSession, DefaultFallbackRuntimeState } from "../session/agent-session";
+import type { AgentSession, AgentSessionProfileInstalledOverrideState, DefaultFallbackRuntimeState } from "../session/agent-session";
 import { type ModelProfileDefinition } from "./model-profiles";
 export { resolveModelProfileName } from "./model-profile-contract";
 import { type GjcModelAssignmentTargetId, type ModelRegistry } from "./model-registry";
@@ -16,7 +16,16 @@ type ModelProfileActivationSession = Pick<AgentSession, "model" | "thinkingLevel
     setActiveModelProfile?: (name: string | undefined) => void;
     getActiveModelProfile?: () => string | undefined;
     /** Record which runtime override keys this activation installed (session-scoped). */
-    noteProfileInstalledOverrides?: (modelRoles: readonly string[], agentModelOverrides: readonly string[], preProfileModel: Model<Api> | undefined) => void;
+    noteProfileInstalledOverrides?: (modelRoles: readonly string[], agentModelOverrides: readonly string[], preProfileModel: Model<Api> | undefined, baseline?: {
+        modelRoles: Readonly<Record<string, ModelSelectorValue>>;
+        agentModelOverrides: Readonly<Record<string, ModelSelectorValue>>;
+    }, installed?: {
+        modelRoles: Readonly<Record<string, ModelSelectorValue>>;
+        agentModelOverrides: Readonly<Record<string, ModelSelectorValue>>;
+    }, manual?: {
+        modelRoles: readonly string[];
+        agentModelOverrides: readonly string[];
+    }) => void;
     /** Drop the recorded profile-installed override keys (e.g. after materialization). */
     clearProfileInstalledOverrides?: () => void;
     /** Current profile-installed override keys, for deriving the activation base. */
@@ -24,11 +33,15 @@ type ModelProfileActivationSession = Pick<AgentSession, "model" | "thinkingLevel
         modelRoles: readonly string[];
         agentModelOverrides: readonly string[];
     };
+    /** Profile-installed baselines, preserved when a refreshed profile drops an assignment. */
+    getProfileInstalledOverrideState?: () => AgentSessionProfileInstalledOverrideState;
+    restoreProfileInstalledOverrideState?: (state: AgentSessionProfileInstalledOverrideState) => void;
     /** Re-apply vendor-separated delegation (task tool + prompt) after the role layer changed. */
     syncEagerDelegation?: () => Promise<void>;
     getSessionDefaultModelSelector?: () => string | undefined;
     recordResumeDefaultModel?: (selector: string | undefined) => void;
     getUserCanonicalVariantSelection?: () => UserCanonicalVariantSelection;
+    getUserModelSelectionRevision?: () => number;
     seedDefaultFallbackResolution?: (activeIndex: number, skips: Array<{
         selector: string;
         reason: string;
@@ -36,7 +49,10 @@ type ModelProfileActivationSession = Pick<AgentSession, "model" | "thinkingLevel
     getDefaultFallbackRuntimeState?: () => DefaultFallbackRuntimeState;
     restoreDefaultFallbackRuntimeState?: (state: DefaultFallbackRuntimeState) => void;
     restoreModelSelectionForRollback?: AgentSession["restoreModelSelectionForRollback"];
-    modelRegistry?: Pick<ModelRegistry, "getSessionCanonicalVariant" | "restoreSessionCanonicalVariant" | "clearCanonicalVariant" | "getAvailable" | "lookupAliasExists" | "resolveModelByLookupAlias" | "authStorage" | "isCredentiallessProvider">;
+    prepareModelSelectionForProfileActivation?: AgentSession["prepareModelSelectionForProfileActivation"];
+    commitPreparedProfileModelSelection?: AgentSession["commitPreparedProfileModelSelection"];
+    finishPreparedProfileModelSelection?: AgentSession["finishPreparedProfileModelSelection"];
+    modelRegistry?: Pick<ModelRegistry, "getSessionCanonicalVariant" | "restoreSessionCanonicalVariant" | "clearCanonicalVariant" | "getAvailable" | "lookupAliasExists" | "resolveModelByLookupAlias" | "authStorage" | "isCredentiallessProvider"> & Partial<Pick<ModelRegistry, "seedCanonicalVariant">>;
     getConfiguredModelChainState?: (role: string) => ConfiguredModelChainState | undefined;
 };
 type ConfiguredModelChainState = {
@@ -45,18 +61,45 @@ type ConfiguredModelChainState = {
     identity?: string;
     explicitHead: boolean;
 };
+type PublishedModelProfileActivationState = {
+    model: Model<Api> | undefined;
+    thinkingLevel: ThinkingLevel | undefined;
+    modelRolesOverride: Readonly<Record<string, ModelSelectorValue>> | undefined;
+    agentModelOverridesOverride: Readonly<Record<string, ModelSelectorValue>> | undefined;
+    defaultChainState: ConfiguredModelChainState | undefined;
+    defaultFallbackRuntimeState: DefaultFallbackRuntimeState | undefined;
+    activeModelProfile: string | undefined;
+    profileInstalledOverrideState: AgentSessionProfileInstalledOverrideState | undefined;
+    sessionDefaultModel: string | undefined;
+    persistedModelRoles: Readonly<Record<string, ModelSelectorValue>> | undefined;
+    persistedAgentModelOverrides: Readonly<Record<string, ModelSelectorValue>> | undefined;
+    persistedDefaultProfile: string | undefined;
+    persistedDefaultThinkingLevel: Exclude<ThinkingLevel, "inherit"> | undefined;
+    defaultThinkingLevelOverride: Exclude<ThinkingLevel, "inherit"> | undefined;
+    defaultProfileOverride: string | undefined;
+};
 export interface PrepareModelProfileActivationOptions {
     session: ModelProfileActivationSession;
-    modelRegistry: Pick<ModelRegistry, "getModelProfile" | "getModelProfiles" | "getAvailableModelProfileNames" | "getApiKeyForProvider" | "getAll" | "resolveCanonicalModel" | "getCanonicalVariants" | "getCanonicalId" | "isSelectorCircuitOpen"> & Partial<Pick<ModelRegistry, "getAvailable" | "resolveModelByLookupAlias" | "lookupAliasExists" | "clearCanonicalVariant" | "seedCanonicalVariant" | "getSessionCanonicalVariant" | "restoreSessionCanonicalVariant" | "getConfiguredProviderIds" | "isKnownProvider">> & {
+    modelRegistry: Pick<ModelRegistry, "getModelProfile" | "getModelProfiles" | "getAvailableModelProfileNames" | "getApiKeyForProvider" | "getAll" | "resolveCanonicalModel" | "getCanonicalVariants" | "getCanonicalId" | "isSelectorCircuitOpen"> & Partial<Pick<ModelRegistry, "getAvailable" | "hasUsableAuthForProvider" | "isStagedReloadCandidate" | "resolveModelByLookupAlias" | "lookupAliasExists" | "clearCanonicalVariant" | "seedCanonicalVariant" | "getSessionCanonicalVariant" | "restoreSessionCanonicalVariant" | "getConfiguredProviderIds" | "getConfiguredModelBindings" | "isKnownProvider">> & {
         getError?: ModelRegistry["getError"];
         authStorage?: ModelRegistry["authStorage"];
     };
     settings: Pick<Settings, "get" | "getGlobal" | "getOverride">;
+    /** Live mutation target when `settings` is a validated staged view. */
+    settingsForApply?: Settings;
+    prepareSessionModelSelection?: boolean;
+    preserveManualOverrides?: boolean;
+    preserveCanonicalVariant?: boolean;
+    signal?: AbortSignal;
     profileName: string;
 }
 export interface ApplyModelProfileActivationOptions {
     persistDefault?: boolean;
     thinkingLevelOverride?: ThinkingLevel;
+    preserveDefaultModelSelection?: boolean;
+    preserveLiveModelSelection?: boolean;
+    deferRuntimePublication?: boolean;
+    signal?: AbortSignal;
     /** Cancels deferred activation if a newer user model selection exists. */
     isCurrent?: () => boolean;
 }
@@ -77,11 +120,16 @@ export interface PreparedModelProfileActivation {
     previousDefaultProfileOverride: string | undefined;
     previousPersistedDefaultProfile: string | undefined;
     previousPersistedDefaultThinkingLevel: Exclude<ThinkingLevel, "inherit"> | undefined;
-    previousDefaultThinkingLevelOverride: ThinkingLevel | undefined;
+    previousDefaultThinkingLevelOverride: Exclude<ThinkingLevel, "inherit"> | undefined;
     baseAgentModelOverrides: Record<string, ModelSelectorValue>;
     baseModelRoles: Record<string, ModelSelectorValue>;
     previousDefaultChain: readonly string[] | undefined;
     previousDefaultChainState: ConfiguredModelChainState | undefined;
+    previousProfileInstalledOverrideState: AgentSessionProfileInstalledOverrideState | undefined;
+    preparedDefaultModelSelection: Awaited<ReturnType<NonNullable<ModelProfileActivationSession["prepareModelSelectionForProfileActivation"]>>> | undefined;
+    defaultChainPublished: boolean;
+    defaultModelPublished: boolean;
+    publishedState: PublishedModelProfileActivationState | undefined;
     previousDefaultFallbackRuntimeState: DefaultFallbackRuntimeState | undefined;
     defaultModel: Model<Api> | undefined;
     defaultThinkingLevel: ThinkingLevel | undefined;
@@ -96,6 +144,8 @@ export interface PreparedModelProfileActivation {
     }>;
     modelRoles: Record<string, ModelSelectorValue>;
     agentModelOverrides: Record<string, ModelSelectorValue>;
+    manualModelRoleOverrides: ReadonlySet<string>;
+    manualAgentModelOverrides: ReadonlySet<string>;
     previousActiveModelProfile: string | undefined;
     /**
      * The session resume default ("provider/id") captured BEFORE activation —
@@ -253,7 +303,12 @@ export declare function resolveModelProfileDefaultChain(options: {
 }>;
 export declare function rewriteSelectorForProxy(selector: string, proxyProvider: string, proxyMode: ModelProfileProxyMode, allModels: Model<Api>[], directlyAuthenticated: ReadonlySet<string>, routableProviders: ReadonlySet<string>): string;
 export declare function prepareModelProfileActivation(options: PrepareModelProfileActivationOptions): Promise<PreparedModelProfileActivation>;
+/** Publish the prepared model selection and role layer without awaiting. */
+export declare function publishPreparedModelProfileActivation(prepared: PreparedModelProfileActivation, options?: Pick<ApplyModelProfileActivationOptions, "preserveDefaultModelSelection" | "preserveLiveModelSelection">): void;
+export declare function finishPreparedModelProfileActivation(prepared: PreparedModelProfileActivation): Promise<void>;
 export declare function applyPreparedModelProfileActivation(prepared: PreparedModelProfileActivation, options?: ApplyModelProfileActivationOptions): Promise<void>;
+/** Restore an applied activation when its enclosing settings/registry commit fails. */
+export declare function rollbackPreparedModelProfileActivation(prepared: PreparedModelProfileActivation, options?: ApplyModelProfileActivationOptions): Promise<void>;
 export interface MaterializeModelProfileForDeletionResult {
     modelRoles: Record<string, ModelSelectorValue>;
     agentModelOverrides: Record<string, ModelSelectorValue>;
@@ -269,6 +324,7 @@ export interface MaterializeModelProfileForDeletionResult {
     previousActiveModelProfile: string | undefined;
     previousDefaultChainState: ConfiguredModelChainState | undefined;
     previousDefaultFallbackRuntimeState: DefaultFallbackRuntimeState | undefined;
+    previousProfileInstalledOverrideState: AgentSessionProfileInstalledOverrideState | undefined;
     /**
      * Restores the session sticky canonical variant that was snapshotted before
      * materialization cleared it. Internal closure capturing the registry,
@@ -283,7 +339,7 @@ export declare function materializeModelProfileForDeletion(options: PrepareModel
 }): Promise<MaterializeModelProfileForDeletionResult>;
 export declare function restoreMaterializedModelProfileForDeletion(options: {
     settings: Pick<Settings, "clearOverride" | "flushOrThrow" | "override" | "set" | "unset">;
-    session: Pick<ModelProfileActivationSession, "setActiveModelProfile" | "setConfiguredModelChain" | "restoreDefaultFallbackRuntimeState">;
+    session: Pick<ModelProfileActivationSession, "setActiveModelProfile" | "setConfiguredModelChain" | "restoreDefaultFallbackRuntimeState" | "restoreProfileInstalledOverrideState">;
     snapshot: MaterializeModelProfileForDeletionResult;
 }): Promise<void>;
 export declare function activateModelProfile(options: PrepareModelProfileActivationOptions, applyOptions?: ApplyModelProfileActivationOptions): Promise<void>;

package/dist/types/config/model-registry.d.ts

@@ -5,15 +5,15 @@ import { type ActiveProviderDescriptor } from "../sdk/providers";
 import type { AuthStorage } from "../session/auth-storage";
 import type { ActiveSearchModelContext, WebSearchMode } from "../web/search/types";
 import { type BillingPath } from "./billing-path";
-import { ConfigError, ConfigFile } from "./config-file";
+import { ConfigError, ConfigFile, type LoadResult } from "./config-file";
 import { isAuthenticated, kNoAuth } from "./model-auth";
 import { type ConfiguredModelBindings } from "./model-bindings-applier";
 import { type ProviderDiscoveryState } from "./model-discovery-manager";
-import { type ModelPresetRegistryDependencies, type ModelPresetRegistryRefreshResult } from "./model-preset-registry";
+import { type AcceptedModelPresetRegistry, type ModelPresetRegistryDependencies, type ModelPresetRegistryRefreshResult } from "./model-preset-registry";
 export type { ProviderDiscoveryState, ProviderDiscoveryStatus } from "./model-discovery-manager";
 import { type CanonicalModelIndex, type CanonicalModelRecord, type CanonicalModelVariant, type ModelEquivalenceConfig } from "./model-equivalence";
 import { type ModelProfileDefinition } from "./model-profiles";
-import { GJC_MODEL_ASSIGNMENT_TARGET_IDS, type ModelProfileConfig } from "./models-config-schema";
+import { GJC_MODEL_ASSIGNMENT_TARGET_IDS, type ModelProfileConfig, type ModelsConfig } from "./models-config-schema";
 import { type EffectiveProviderAuth } from "./provider-selection-policy";
 import { type Settings } from "./settings";
 export type { BillingPath, BillingPathKind } from "./billing-path";
@@ -78,6 +78,7 @@ export declare const ModelsConfigFile: ConfigFile<{
             sendSessionHeaders?: boolean | undefined;
             supportsResponsesSessionAffinity?: boolean | undefined;
             supportsServiceTier?: boolean | undefined;
+            supportsUltrafastTier?: boolean | undefined;
             supportsMultipleSystemMessages?: boolean | undefined;
             supportsReasoningEffort?: boolean | undefined;
             reasoningEffortMap?: {
@@ -163,6 +164,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                 sendSessionHeaders?: boolean | undefined;
                 supportsResponsesSessionAffinity?: boolean | undefined;
                 supportsServiceTier?: boolean | undefined;
+                supportsUltrafastTier?: boolean | undefined;
                 supportsMultipleSystemMessages?: boolean | undefined;
                 supportsReasoningEffort?: boolean | undefined;
                 reasoningEffortMap?: {
@@ -212,6 +214,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                 extraBody?: Record<string, unknown> | undefined;
             } | undefined;
             cacheRetention?: "long" | "none" | "short" | undefined;
+            streamIdleTimeoutMs?: number | undefined;
         }[] | undefined;
         modelOverrides?: Record<string, {
             name?: string | undefined;
@@ -241,6 +244,7 @@ export declare const ModelsConfigFile: ConfigFile<{
                 sendSessionHeaders?: boolean | undefined;
                 supportsResponsesSessionAffinity?: boolean | undefined;
                 supportsServiceTier?: boolean | undefined;
+                supportsUltrafastTier?: boolean | undefined;
                 supportsMultipleSystemMessages?: boolean | undefined;
                 supportsReasoningEffort?: boolean | undefined;
                 reasoningEffortMap?: {
@@ -290,10 +294,12 @@ export declare const ModelsConfigFile: ConfigFile<{
                 extraBody?: Record<string, unknown> | undefined;
             } | undefined;
             cacheRetention?: "long" | "none" | "short" | undefined;
+            streamIdleTimeoutMs?: number | undefined;
         }> | undefined;
         disableStrictTools?: boolean | undefined;
         transport?: "pi-native" | undefined;
         cacheRetention?: "long" | "none" | "short" | undefined;
+        streamIdleTimeoutMs?: number | undefined;
         openaiCompat?: {
             baseUrl: string;
             apiKey?: string | undefined;
@@ -325,6 +331,7 @@ interface ProviderOverride {
     transport?: Model<Api>["transport"];
     requestTransform?: ModelRequestTransform;
     cacheRetention?: CacheRetention;
+    streamIdleTimeoutMs?: number;
     isOAuth?: boolean;
 }
 /**
@@ -359,7 +366,7 @@ export declare function registrySelectorResolvesToModel(selector: string, index:
  * See `xiaomi-tp-discovery-merge.test.ts` and the `refresh()` baseUrl-override
  * regression in `model-registry.test.ts`.
  */
-export declare function mergeDiscoveredModel<TApi extends Api>(model: Model<TApi>, existing: Model<Api> | undefined, providerOverride?: Pick<ProviderOverride, "baseUrl" | "headers" | "transport" | "requestTransform" | "cacheRetention">): Model<TApi>;
+export declare function mergeDiscoveredModel<TApi extends Api>(model: Model<TApi>, existing: Model<Api> | undefined, providerOverride?: Pick<ProviderOverride, "baseUrl" | "headers" | "transport" | "requestTransform" | "cacheRetention" | "streamIdleTimeoutMs">): Model<TApi>;
 export interface CanonicalModelQueryOptions {
     availableOnly?: boolean;
     candidates?: readonly Model<Api>[];
@@ -373,6 +380,25 @@ export interface CanonicalModelSelection {
     record: CanonicalModelRecord;
     model: Model<Api> | undefined;
 }
+export interface ModelsConfigReloadCandidate {
+    readonly valid: boolean;
+    readonly changed: boolean;
+    readonly diagnostics: {
+        readonly valid: boolean;
+        readonly errors: readonly unknown[];
+    };
+    readonly registry: ModelRegistry;
+    isCurrent(): boolean;
+    commit(): void;
+    rollback(): void;
+    finalize(): void;
+}
+interface ModelRegistryInternalOptions {
+    readonly configFile: ConfigFile<ModelsConfig>;
+    readonly configSource: LoadResult<ModelsConfig>;
+    readonly runtimeSource: ModelRegistry;
+    readonly acceptedPresets: AcceptedModelPresetRegistry;
+}
 /**
  * Model registry - loads and manages models, resolves API keys via AuthStorage.
  */
@@ -382,7 +408,15 @@ export declare class ModelRegistry {
     /**
      * @param authStorage - Auth storage for API key resolution
      */
-    constructor(authStorage: AuthStorage, modelsPath?: string, registrySettings?: Pick<Settings, "get" | "getGlobal"> & Partial<Pick<Settings, "commitAtomicBatchWithCurrent">>, modelPresetRegistryDependencies?: ModelPresetRegistryDependencies);
+    constructor(authStorage: AuthStorage, modelsPath?: string, registrySettings?: Pick<Settings, "get" | "getGlobal"> & Partial<Pick<Settings, "commitAtomicBatchWithCurrent">>, modelPresetRegistryDependencies?: ModelPresetRegistryDependencies, internalOptions?: ModelRegistryInternalOptions);
+    getModelsConfigPath(): string | undefined;
+    stageModelsConfigReload(snapshot: {
+        path: string;
+        text: string | null;
+        identity: string;
+    }, registrySettings?: Pick<Settings, "get" | "getGlobal">): Promise<ModelsConfigReloadCandidate>;
+    withConsumerLease<T>(body: () => T | Promise<T>, signal?: AbortSignal): Promise<T>;
+    acquirePublicationFence(signal?: AbortSignal): Promise<() => void>;
     dispose(): Promise<void>;
     onCatalogChanged(listener: () => void): () => void;
     /** Replace the read-only settings snapshot used by profile-scoped resolution. */
@@ -431,6 +465,19 @@ export declare class ModelRegistry {
     getAll(): Model<Api>[];
     /** Provider ids declared in models.yml, including override-only providers. */
     getConfiguredProviderIds(): readonly string[];
+    /** Configured API-key sources in models.yml precedence order, excluding absent environment values. */
+    getProviderConfigApiKeySources(provider: string): Array<{
+        kind: "environment";
+        name: string;
+        provider: string;
+    } | {
+        kind: "models-yml";
+        provider: string;
+    }>;
+    /** Environment variable name for a provider API key supplied by runtime setup. */
+    getProviderRuntimeApiKeyEnvName(provider: string): string | undefined;
+    /** Whether a runtime extension's provider API key is currently installed in AuthStorage. */
+    hasRuntimeProviderApiKey(provider: string): boolean;
     /**
      * Whether this registry can serve a provider id from any active source.
      *
@@ -608,6 +655,10 @@ export declare class ModelRegistry {
         preferredCredentialSelector?: AuthCredentialSelector;
         signal?: AbortSignal;
     }): Promise<string | undefined>;
+    /** Check credential availability without resolving keys or refreshing OAuth tokens. */
+    hasUsableAuthForProvider(provider: string, sessionId?: string): boolean;
+    /** @internal Whether this registry is an unpublished staged reload candidate. */
+    isStagedReloadCandidate(): boolean;
     /**
      * Check if a model is using OAuth credentials (subscription).
      */

package/dist/types/config/model-resolver.d.ts

@@ -164,6 +164,8 @@ export interface ModelChainResolutionOptions {
     canonicalSessionId?: string | null;
     credentialSessionId?: string;
     isCredentialUnavailable?: (provider: string) => boolean;
+    /** Read-only auth eligibility for staged profile preflight when no access token can be exposed. */
+    isProviderAuthAvailable?: (provider: string) => boolean;
     signal?: AbortSignal;
 }
 /**

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

@@ -5,6 +5,7 @@ export declare const ModelCompatSchema: z.ZodObject<{
     sendSessionHeaders: z.ZodOptional<z.ZodBoolean>;
     supportsResponsesSessionAffinity: z.ZodOptional<z.ZodBoolean>;
     supportsServiceTier: z.ZodOptional<z.ZodBoolean>;
+    supportsUltrafastTier: z.ZodOptional<z.ZodBoolean>;
     supportsMultipleSystemMessages: z.ZodOptional<z.ZodBoolean>;
     supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
     reasoningEffortMap: z.ZodOptional<z.ZodObject<{
@@ -76,6 +77,7 @@ export declare const OpenAICompatSchema: z.ZodObject<{
     sendSessionHeaders: z.ZodOptional<z.ZodBoolean>;
     supportsResponsesSessionAffinity: z.ZodOptional<z.ZodBoolean>;
     supportsServiceTier: z.ZodOptional<z.ZodBoolean>;
+    supportsUltrafastTier: z.ZodOptional<z.ZodBoolean>;
     supportsMultipleSystemMessages: z.ZodOptional<z.ZodBoolean>;
     supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
     reasoningEffortMap: z.ZodOptional<z.ZodObject<{
@@ -265,6 +267,7 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         sendSessionHeaders: z.ZodOptional<z.ZodBoolean>;
         supportsResponsesSessionAffinity: z.ZodOptional<z.ZodBoolean>;
         supportsServiceTier: z.ZodOptional<z.ZodBoolean>;
+        supportsUltrafastTier: z.ZodOptional<z.ZodBoolean>;
         supportsMultipleSystemMessages: z.ZodOptional<z.ZodBoolean>;
         supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
         reasoningEffortMap: z.ZodOptional<z.ZodObject<{
@@ -345,6 +348,7 @@ export declare const ModelOverrideSchema: z.ZodObject<{
         none: "none";
         short: "short";
     }>>;
+    streamIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export type ModelOverride = z.infer<typeof ModelOverrideSchema>;
 export declare const ProviderDiscoverySchema: z.ZodObject<{
@@ -397,6 +401,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
             sendSessionHeaders: z.ZodOptional<z.ZodBoolean>;
             supportsResponsesSessionAffinity: z.ZodOptional<z.ZodBoolean>;
             supportsServiceTier: z.ZodOptional<z.ZodBoolean>;
+            supportsUltrafastTier: z.ZodOptional<z.ZodBoolean>;
             supportsMultipleSystemMessages: z.ZodOptional<z.ZodBoolean>;
             supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
             reasoningEffortMap: z.ZodOptional<z.ZodObject<{
@@ -582,6 +587,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 sendSessionHeaders: z.ZodOptional<z.ZodBoolean>;
                 supportsResponsesSessionAffinity: z.ZodOptional<z.ZodBoolean>;
                 supportsServiceTier: z.ZodOptional<z.ZodBoolean>;
+                supportsUltrafastTier: z.ZodOptional<z.ZodBoolean>;
                 supportsMultipleSystemMessages: z.ZodOptional<z.ZodBoolean>;
                 supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
                 reasoningEffortMap: z.ZodOptional<z.ZodObject<{
@@ -662,6 +668,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 none: "none";
                 short: "short";
             }>>;
+            streamIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>>;
         modelOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             name: z.ZodOptional<z.ZodString>;
@@ -731,6 +738,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 sendSessionHeaders: z.ZodOptional<z.ZodBoolean>;
                 supportsResponsesSessionAffinity: z.ZodOptional<z.ZodBoolean>;
                 supportsServiceTier: z.ZodOptional<z.ZodBoolean>;
+                supportsUltrafastTier: z.ZodOptional<z.ZodBoolean>;
                 supportsMultipleSystemMessages: z.ZodOptional<z.ZodBoolean>;
                 supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
                 reasoningEffortMap: z.ZodOptional<z.ZodObject<{
@@ -811,6 +819,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
                 none: "none";
                 short: "short";
             }>>;
+            streamIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>>;
         disableStrictTools: z.ZodOptional<z.ZodBoolean>;
         transport: z.ZodOptional<z.ZodLiteral<"pi-native">>;
@@ -819,6 +828,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
             none: "none";
             short: "short";
         }>>;
+        streamIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
         openaiCompat: z.ZodOptional<z.ZodObject<{
             baseUrl: z.ZodString;
             apiKey: z.ZodOptional<z.ZodString>;

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

@@ -1,4 +1,5 @@
 import type { Effort } from "@gajae-code/ai/model-thinking";
+import { type CredentialPreferenceEntryValue } from "../session/startup-auth-config";
 import { type EditMode } from "../utils/edit-mode";
 import { type AutoroutingLocalIssue, type AutoroutingProvenance, type AutoroutingSetup, type AutoroutingTierMapInput } from "./autorouting-contract";
 import { type DurableModelProfileOwnership } from "./model-profile-ownership";
@@ -122,7 +123,11 @@ type RecordValueDef = {
     values: readonly string[];
 } | {
     type: "credential-selector";
+} | {
+    type: "credential-preference-list";
 };
+/** A provider's `auth.credentialPreferences` value: one account or a non-empty ordered list of entries. */
+export type CredentialPreferenceSettingValue = string | CredentialPreferenceEntryValue[];
 interface ConstrainedRecordValueDef {
     type: "autorouting-selector-value";
     pattern: string;
@@ -198,6 +203,13 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly "auth.credentialPreferences": {
+        readonly type: "record";
+        readonly default: Record<string, CredentialPreferenceSettingValue>;
+        readonly valueSchema: {
+            readonly type: "credential-preference-list";
+        };
+    };
     readonly "session.directoryMigration": {
         readonly type: "enum";
         readonly values: readonly ["copy-retain", "disabled"];
@@ -1565,12 +1577,12 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly serviceTier: {
         readonly type: "enum";
-        readonly values: readonly ["none", "auto", "default", "flex", "scale", "priority", "openai-only", "claude-only"];
+        readonly values: readonly ["none", "auto", "default", "flex", "scale", "priority", "ultrafast", "openai-only", "claude-only"];
         readonly default: "none";
         readonly ui: {
             readonly tab: "model";
             readonly label: "Service Tier";
-            readonly description: 'Processing priority hint (none = omit). OpenAI accepts the tier values directly; Anthropic realizes `priority` as `speed: "fast"` on supported Opus models. Scoped values target one family.';
+            readonly description: 'Processing priority hint (none = omit). OpenAI accepts the tier values directly; ultrafast is a 6x premium tier. Anthropic realizes `priority` as `speed: "fast"` on supported Opus models. Scoped values target one family.';
             readonly options: readonly [{
                 readonly value: "none";
                 readonly label: "None";
@@ -1591,6 +1603,10 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "scale";
                 readonly label: "Scale";
                 readonly description: "Scale Tier credits when available (OpenAI)";
+            }, {
+                readonly value: "ultrafast";
+                readonly label: "Ultrafast";
+                readonly description: "Ultrafast processing at a 6x premium (OpenAI)";
             }, {
                 readonly value: "priority";
                 readonly label: "Priority";
@@ -1608,7 +1624,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "task.serviceTier": {
         readonly type: "enum";
-        readonly values: readonly ["inherit", "none", "auto", "default", "flex", "scale", "priority", "openai-only", "claude-only"];
+        readonly values: readonly ["inherit", "none", "auto", "default", "flex", "scale", "priority", "ultrafast", "openai-only", "claude-only"];
         readonly default: "inherit";
         readonly ui: {
             readonly tab: "tasks";
@@ -1638,6 +1654,10 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "scale";
                 readonly label: "Scale";
                 readonly description: "Scale Tier credits when available (OpenAI)";
+            }, {
+                readonly value: "ultrafast";
+                readonly label: "Ultrafast";
+                readonly description: "Ultrafast processing at a 6x premium (OpenAI)";
             }, {
                 readonly value: "priority";
                 readonly label: "Priority";
@@ -3143,6 +3163,10 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "string";
         readonly default: undefined;
     };
+    readonly "shellMinimizer.settingsHash": {
+        readonly type: "string";
+        readonly default: undefined;
+    };
     readonly "shellMinimizer.only": {
         readonly type: "array";
         readonly default: string[];
@@ -3348,6 +3372,15 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the render_mermaid tool for Mermaid-to-ASCII rendering";
         };
     };
+    readonly "reportIssue.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Tool issue reporting";
+            readonly description: "Enable the report_issue tool: the model records tool behavior that contradicts the tool's description into the local ~/.gjc/tool-issues.db. Nothing is sent anywhere.";
+        };
+    };
     readonly "debug.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -4101,6 +4134,15 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "task.compactSubagentPanel": {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "tasks";
+            readonly label: "Compact Subagent Panel";
+            readonly description: "Collapse awaited subagents into one summary line (expand tool output to see each one) and refresh only when the summary changes";
+        };
+    };
     readonly "task.enableLsp": {
         readonly type: "boolean";
         readonly default: false;
@@ -4800,6 +4842,7 @@ export interface BashInterceptorRule {
 export interface ShellMinimizerSettings {
     enabled: boolean;
     settingsPath: string | undefined;
+    settingsHash: string | undefined;
     only: string[];
     except: string[];
     maxCaptureBytes: number;