npm - cascade-ai - Versions diffs - 0.70.0 → 0.72.0 - Mend

cascade-ai 0.70.0 → 0.72.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (12) hide show

package/dist/index.d.cts CHANGED Viewed

@@ -136,7 +136,7 @@ declare class ResumeStore {
  */
 declare function summarizeCompleted(completed: readonly CompletedNode[], perNodeChars?: number): string;
-type ProviderType = 'anthropic' | 'openai' | 'gemini' | 'azure' | 'openai-compatible' | 'ollama' | 'github-models';
+type ProviderType = 'anthropic' | 'openai' | 'gemini' | 'azure' | 'openai-compatible' | 'ollama';
 interface ModelInfo {
     id: string;
     name: string;
@@ -1425,6 +1425,17 @@ declare class MemoryStore {
     }>;
     upsertCachedModel(model: ModelInfo): void;
     getCachedModels(provider?: ProviderType): ModelInfo[];
+    /**
+     * Deletes cached rows for a provider type that no longer exists in
+     * `ProviderType`, so it takes a raw string rather than the union.
+     *
+     * Needed because the cache outlives the code: the REPL's loadCache() only
+     * re-discovers when the cache is EMPTY or older than 24h, so rows left
+     * behind by a removed provider read as "cache populated" and suppress
+     * discovery for the providers that replaced it — `/model` then shows a
+     * configured provider with zero models until the rows age out.
+     */
+    purgeCachedModelsForRetiredProvider(providerType: string): number;
     clearModelCache(provider?: ProviderType): void;
     getCacheAge(): number;
     saveModelProfile(modelId: string, provider: ProviderType, specializations: string[]): void;
@@ -2031,15 +2042,6 @@ declare class CascadeRouter extends EventEmitter {
     private discoverOllamaModels;
     /** Returns true when at least one real model was discovered from the endpoint. */
     private discoverOpenAICompatibleModels;
-    /**
-     * Registers GitHub Models' real catalog ids via addDynamicModel so init()'s
-     * tier-fill loop can pick one. Registration alone does not create a bound
-     * BaseProvider instance (see ensureProvider) — the tier-fill loop's own
-     * ensureProvider call does that for whichever model it actually selects,
-     * which is why this runs BEFORE that loop rather than only in the
-     * background discoverProviderModels() refresh.
-     */
-    private discoverGitHubModelsCatalog;
     private ensureProvider;
     private getProvider;
     private createProvider;
@@ -2177,6 +2179,16 @@ declare class ToolRegistry extends EventEmitter {
     private plugins;
     constructor(config: ToolsConfig, workspaceRoot?: string);
     register(tool: BaseTool): void;
+    /**
+     * The directory every registered tool resolves relative paths against.
+     *
+     * Exposed so a caller that has to reason about a file a tool WROTE can look
+     * in the same place the tool wrote it. `process.cwd()` is not that place
+     * outside a plain CLI run: the hosted server's cwd is the app directory
+     * while the run's workspace is the tenant's scratch dir, and Electron's cwd
+     * is the app bundle rather than the user's chosen folder.
+     */
+    getWorkspaceRoot(): string;
     /**
      * Wait until a named tool is registered, resolving immediately if it already exists.
      * T3 workers can call this after encountering a missing-tool error to resume
@@ -3292,6 +3304,20 @@ declare class T3Worker extends BaseTier {
      */
     private coordinateFileIntents;
     private requiresArtifact;
+    /**
+     * Where a file a tool wrote actually lives.
+     *
+     * This used to be `process.cwd()`, which is only the workspace in a plain
+     * CLI run. The hosted server runs with cwd at the app directory while the
+     * run's workspace is the tenant's scratch dir, and Electron's cwd is the app
+     * bundle rather than the folder the user picked. So the tool wrote
+     * `<workspace>/report.docx`, verification stat'd `<cwd>/report.docx`, found
+     * nothing, and the worker looped and then threw WorkerStallError — surfacing
+     * as "no file was created" on a file that had in fact been created, followed
+     * by a failed node. Asking the registry is exact: it is the same root every
+     * registered tool was configured with (registry.registerDefaults).
+     */
+    private artifactRoot;
     private extractArtifactPaths;
     private verifyArtifacts;
     /**
@@ -3634,6 +3660,11 @@ interface CascadeMdContent {
     systemPrompt: string;
 }
+declare function hasUsableProvider(providers: Array<{
+    type: string;
+    apiKey?: string;
+    authToken?: string;
+}> | undefined): boolean;
 declare class ConfigManager {
     private config;
     private keystore;
@@ -3642,6 +3673,25 @@ declare class ConfigManager {
     private cascadeMd;
     private workspacePath;
     private globalDir;
+    /**
+     * What THIS load migrated out, if anything. Strictly per-load state: reset
+     * at the top of every `load()`, because two places read it as a statement
+     * about the load in progress — `injectEnvKeys()` asks whether an empty
+     * provider list was emptied by a retirement, and the end of `load()` warns
+     * and builds the user-facing notice from it. Left set, a second `load()` on
+     * the same instance (`startRepl()` does one after its setup wizard) would
+     * re-announce a migration that already happened and suppress the Ollama
+     * fallback for a list that is empty for some unrelated reason.
+     */
+    private retiredCleanup?;
+    /**
+     * Human-readable migration notice held for a UI to display. `console.warn`
+     * is not sufficient: the REPL clears the TTY immediately after load(), and
+     * the desktop emits from the main process where nothing is rendered.
+     */
+    private pendingRetiredNotice?;
+    /** Returns the pending migration notice once, then forgets it. */
+    takeRetiredNotice(): string | undefined;
     /** `globalDirOverride` exists for tests — never point it at the real home dir there. */
     constructor(workspacePath?: string, globalDirOverride?: string);
     load(): Promise<void>;
@@ -5026,9 +5076,6 @@ declare const DEFAULT_THEME: ThemeName;
 declare const OLLAMA_BASE_URL = "http://localhost:11434";
 declare const LM_STUDIO_BASE_URL = "http://localhost:1234";
 declare const AZURE_BASE_URL_TEMPLATE = "https://{resource}.openai.azure.com";
-declare const GITHUB_MODELS_INFERENCE_URL = "https://models.github.ai/inference";
-declare const GITHUB_MODELS_CATALOG_URL = "https://models.github.ai/catalog/models";
-declare const GITHUB_MODELS_API_VERSION = "2026-03-10";
 declare const TOOL_NAMES: {
     readonly SHELL: "shell";
     readonly FILE_READ: "file_read";
@@ -5264,6 +5311,13 @@ declare class CloudClient {
     logout(): Promise<void>;
 }
+interface RetiredProviderCleanup {
+    /** Retired `providers[]` types that were dropped, in first-seen order. */
+    removed: string[];
+    /** Tier keys (`t1`/`t2`/`t3`) whose pin named a retired provider and was cleared. */
+    clearedPins: string[];
+}
 /**
  * Bundle format version.
  *
@@ -5312,6 +5366,6 @@ interface SyncBundle {
 /** Pluck the portable subset of a config into a bundle (undefined fields omitted). */
 declare function gatherSyncBundle(config: CascadeConfig): SyncBundle;
 /** Merge a pulled bundle into a config, returning the updated config to persist. */
-declare function applySyncBundle(bundle: SyncBundle, config: CascadeConfig): CascadeConfig;
+declare function applySyncBundle(bundle: SyncBundle, config: CascadeConfig, cleanup?: RetiredProviderCleanup): CascadeConfig;
-export { AZURE_BASE_MODELS, AZURE_BASE_URL_TEMPLATE, type AcceptanceProbe, type AcceptanceResult, type AcceptanceVerdict, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, type BenchmarksConfig, type Block, type BudgetConfig, CASCADE_AUDIT_FILE, CASCADE_CONFIG_DIR, CASCADE_CONFIG_FILE, CASCADE_DASHBOARD_SECRET_FILE, CASCADE_DB_FILE, CASCADE_IGNORE_FILE, CASCADE_KEYSTORE_FILE, CASCADE_MD_FILE, CASCADE_VERSION, CHARS_PER_TOKEN, COMPLEXITY_T2_COUNT, Cascade, CascadeCancelledError, type CascadeConfig, type CascadeEvent, type CascadeEventType, CascadeIgnore, type CascadeMessage, CascadeRouter, type CascadeRunOptions, type CascadeRunResult, type CascadeThemeName, CascadeToolError, type ChartSeries, type ChartSpec, type Chunk, type ChunkOptions, CloudClient, type CloudConversation, type CloudMessage, type CloudSession, type CloudSessionStore, type CloudTurnInput, type CloudUser, type CodeChunkOptions, type CodeChunker, CodeSearchTool, type CompileTaskGraphOptions, type CompiledTaskGraph, type CompleteFn, type CompletedNode, ConfigManager, type ConversationMessage, type CurrentPageProvider, type CurrentPageSnapshot, CurrentPageTool, DEFAULT_API_PORT, DEFAULT_APPROVAL_REQUIRED, DEFAULT_AUTO_SUMMARIZE_AT, DEFAULT_CLOUD_URL, DEFAULT_CONTEXT_LIMIT, DEFAULT_DASHBOARD_PORT, DEFAULT_MAX_SESSION_MESSAGES, DEFAULT_RETENTION_DAYS, DEFAULT_THEME, DOCUMENT_MIME, type DashboardConfig, DashboardServer, DependencyScheduler, type DeviceStart, type DiscoveredMcpTool, type DistilledFact, type ChartKind as DocumentChartKind, type DocumentFormat, type Embedder, type EncryptedBlob, type EscalationDecision, type EscalationPayload, type ExtendedContextConfig, type FileManifest, FileMcpOAuthStore, GITHUB_MODELS_API_VERSION, GITHUB_MODELS_CATALOG_URL, GITHUB_MODELS_INFERENCE_URL, GLOBAL_CONFIG_DIR, GLOBAL_CREDENTIALS_FILE, GLOBAL_DB_FILE, GLOBAL_KEYSTORE_FILE, GLOBAL_RUNTIME_DB_FILE, GenerateDocumentTool, type GenerateOptions, type GenerateResult, type GraphFactSource, GraphRetriever, type GraphSearchOptions, GraphSearchTool, type HookDefinition, type HooksConfig, HooksRunner, type Identity, type ImageAttachment, type ImageByteLoader, type ImageInfo, type ImageRef, type InlineRun, Keystore, LLMReranker, LM_STUDIO_BASE_URL, type LegacyThemeName, type LoadedImage, MAX_PAGE_TEXT_CHARS, MCP_TOOL_PREFIX, MODELS, type ManifestDiff, McpClient, type McpDiscoveryResult, McpOAuthProvider, type McpOAuthState, type McpOAuthStore, type McpServerConfig$1 as McpServerConfig, type McpServerRename, type MemoryConfig, MemoryStore, type Message, type MessageContent, type MessagePayload, type MessageStatus, type MessageType, type ModelInfo, type ModelOverrides, type NativeProvider, OLLAMA_BASE_URL, OpenAICompatibleEmbedder, type OpenAIEmbedderOptions, PROVIDER_DISPLAY_NAMES, type PeerMessage, type PeerMessageEvent, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type PermissionTrailEntry, type PlanReviewConfig, type ProviderConfig, type ProviderType, RESUME_SCHEMA_VERSION, type RankedFact, type RefreshResult, type RenderOptions, type Reranker, type ResumeCheckpoint, type ResumeReason, ResumeStore, type ResumeStoreOptions, type RetrievalContext, type RetrievalMode, type RetrievalPlan, Retriever, type RetrieverSearchOptions, type RuntimeNode, type RuntimeNodeLog, type RuntimeRefreshPayload, type RuntimeScope, type RuntimeSession, type RuntimeSnapshotPayload, type ScheduledTask, type SchedulerExecutionMode, type SchedulerHooks, type SchedulerOptions, type SchedulerResult, type ScoredChunk, type SearchOptions, type Session, type SessionCheckpoint, type SessionMetadata, type SessionSubscriptionPayload, type Slide, SqliteVectorStore, type StatusUpdate, type StoredMessage, type StreamChunk, type SyncBundle, T1Administrator, type T1ToT2Assignment, T1_MODEL_PRIORITY, T2Manager, type T2Result, type T2ToT3Assignment, T2_MODEL_PRIORITY, type T3Result, type T3ResultPayload, type T3SubtaskSpec, T3Worker, T3_MODEL_PRIORITY, THEME_NAMES, TOOL_NAMES, type TaskComplexity, type TaskGraph, type TaskGraphInputNode, type TaskGraphIssue, type TaskGraphIssueCode, type TaskGraphNode, type TaskGraphNodeKind, TaskGraphValidationError, type TaskGraphValidationMode, TaskScheduler, Telemetry, type TelemetryConfig, type Theme, type ThemeColors, type ThemeName, type TierConfig, type TierLimits, type TierRole, type TierStatus, type TokenUsage, type ToolCall, type ToolDefinition, type ToolExecuteOptions, ToolRegistry, type ToolResult, type ToolsConfig, VISION_MODEL_PRIORITY, type VectorStore, type WebSearchConfig, type WebhookConfig, type WorkspaceConfig, type WorkspaceFileReader, WorkspaceIndex, type WorkspaceIndexOptions, applySyncBundle, azureModelForDeployment, beginMcpOAuth, buildDocumentTools, buildManifest, buildSessionTranscript, bytesToBase64, cagCharBudget, chartKind, chartToTableRows, chatCompleterFromProviders, chunkCode, chunkText, compileSectionGraph, compileSubtaskGraph, compileTaskGraph, completeMcpOAuth, connectMcpWithLoopbackOAuth, createCascade, decryptJSON as decryptSyncBlob, diffManifest, disambiguateMcpServerNames, discoverMcpAuthServer, discoverMcpTools, distillSessionFacts, embedderFromProviders, encryptJSON as encryptSyncBlob, evaluateAcceptance, extractCharts, failures, fileExt, fileOAuthProvider, gatherSyncBundle, hashContent, heuristicCodeChunker, inferAzureBaseModel, inlineRuns, isDocumentFormat, isMcpToolName, matchImageLine, mcpServerPrefix, mcpToolName, nodeHttpFetch, parseBlocks, parseChartSpec, parseDelimited, parseRankOrder, parseSlide, planRetrieval, preferIpv4Host, reciprocalRankFusion, refreshMcpToken, removeMcpServerDenials, renderDocument, renderDocx, renderPptx, renderXlsx, runCascade, sessionWorthRemembering, sniffImage, splitSlides, streamCascade, stripInline, summarizeCompleted, undecided, uniqueMcpServerName };
+export { AZURE_BASE_MODELS, AZURE_BASE_URL_TEMPLATE, type AcceptanceProbe, type AcceptanceResult, type AcceptanceVerdict, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, type BenchmarksConfig, type Block, type BudgetConfig, CASCADE_AUDIT_FILE, CASCADE_CONFIG_DIR, CASCADE_CONFIG_FILE, CASCADE_DASHBOARD_SECRET_FILE, CASCADE_DB_FILE, CASCADE_IGNORE_FILE, CASCADE_KEYSTORE_FILE, CASCADE_MD_FILE, CASCADE_VERSION, CHARS_PER_TOKEN, COMPLEXITY_T2_COUNT, Cascade, CascadeCancelledError, type CascadeConfig, type CascadeEvent, type CascadeEventType, CascadeIgnore, type CascadeMessage, CascadeRouter, type CascadeRunOptions, type CascadeRunResult, type CascadeThemeName, CascadeToolError, type ChartSeries, type ChartSpec, type Chunk, type ChunkOptions, CloudClient, type CloudConversation, type CloudMessage, type CloudSession, type CloudSessionStore, type CloudTurnInput, type CloudUser, type CodeChunkOptions, type CodeChunker, CodeSearchTool, type CompileTaskGraphOptions, type CompiledTaskGraph, type CompleteFn, type CompletedNode, ConfigManager, type ConversationMessage, type CurrentPageProvider, type CurrentPageSnapshot, CurrentPageTool, DEFAULT_API_PORT, DEFAULT_APPROVAL_REQUIRED, DEFAULT_AUTO_SUMMARIZE_AT, DEFAULT_CLOUD_URL, DEFAULT_CONTEXT_LIMIT, DEFAULT_DASHBOARD_PORT, DEFAULT_MAX_SESSION_MESSAGES, DEFAULT_RETENTION_DAYS, DEFAULT_THEME, DOCUMENT_MIME, type DashboardConfig, DashboardServer, DependencyScheduler, type DeviceStart, type DiscoveredMcpTool, type DistilledFact, type ChartKind as DocumentChartKind, type DocumentFormat, type Embedder, type EncryptedBlob, type EscalationDecision, type EscalationPayload, type ExtendedContextConfig, type FileManifest, FileMcpOAuthStore, GLOBAL_CONFIG_DIR, GLOBAL_CREDENTIALS_FILE, GLOBAL_DB_FILE, GLOBAL_KEYSTORE_FILE, GLOBAL_RUNTIME_DB_FILE, GenerateDocumentTool, type GenerateOptions, type GenerateResult, type GraphFactSource, GraphRetriever, type GraphSearchOptions, GraphSearchTool, type HookDefinition, type HooksConfig, HooksRunner, type Identity, type ImageAttachment, type ImageByteLoader, type ImageInfo, type ImageRef, type InlineRun, Keystore, LLMReranker, LM_STUDIO_BASE_URL, type LegacyThemeName, type LoadedImage, MAX_PAGE_TEXT_CHARS, MCP_TOOL_PREFIX, MODELS, type ManifestDiff, McpClient, type McpDiscoveryResult, McpOAuthProvider, type McpOAuthState, type McpOAuthStore, type McpServerConfig$1 as McpServerConfig, type McpServerRename, type MemoryConfig, MemoryStore, type Message, type MessageContent, type MessagePayload, type MessageStatus, type MessageType, type ModelInfo, type ModelOverrides, type NativeProvider, OLLAMA_BASE_URL, OpenAICompatibleEmbedder, type OpenAIEmbedderOptions, PROVIDER_DISPLAY_NAMES, type PeerMessage, type PeerMessageEvent, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type PermissionTrailEntry, type PlanReviewConfig, type ProviderConfig, type ProviderType, RESUME_SCHEMA_VERSION, type RankedFact, type RefreshResult, type RenderOptions, type Reranker, type ResumeCheckpoint, type ResumeReason, ResumeStore, type ResumeStoreOptions, type RetrievalContext, type RetrievalMode, type RetrievalPlan, Retriever, type RetrieverSearchOptions, type RuntimeNode, type RuntimeNodeLog, type RuntimeRefreshPayload, type RuntimeScope, type RuntimeSession, type RuntimeSnapshotPayload, type ScheduledTask, type SchedulerExecutionMode, type SchedulerHooks, type SchedulerOptions, type SchedulerResult, type ScoredChunk, type SearchOptions, type Session, type SessionCheckpoint, type SessionMetadata, type SessionSubscriptionPayload, type Slide, SqliteVectorStore, type StatusUpdate, type StoredMessage, type StreamChunk, type SyncBundle, T1Administrator, type T1ToT2Assignment, T1_MODEL_PRIORITY, T2Manager, type T2Result, type T2ToT3Assignment, T2_MODEL_PRIORITY, type T3Result, type T3ResultPayload, type T3SubtaskSpec, T3Worker, T3_MODEL_PRIORITY, THEME_NAMES, TOOL_NAMES, type TaskComplexity, type TaskGraph, type TaskGraphInputNode, type TaskGraphIssue, type TaskGraphIssueCode, type TaskGraphNode, type TaskGraphNodeKind, TaskGraphValidationError, type TaskGraphValidationMode, TaskScheduler, Telemetry, type TelemetryConfig, type Theme, type ThemeColors, type ThemeName, type TierConfig, type TierLimits, type TierRole, type TierStatus, type TokenUsage, type ToolCall, type ToolDefinition, type ToolExecuteOptions, ToolRegistry, type ToolResult, type ToolsConfig, VISION_MODEL_PRIORITY, type VectorStore, type WebSearchConfig, type WebhookConfig, type WorkspaceConfig, type WorkspaceFileReader, WorkspaceIndex, type WorkspaceIndexOptions, applySyncBundle, azureModelForDeployment, beginMcpOAuth, buildDocumentTools, buildManifest, buildSessionTranscript, bytesToBase64, cagCharBudget, chartKind, chartToTableRows, chatCompleterFromProviders, chunkCode, chunkText, compileSectionGraph, compileSubtaskGraph, compileTaskGraph, completeMcpOAuth, connectMcpWithLoopbackOAuth, createCascade, decryptJSON as decryptSyncBlob, diffManifest, disambiguateMcpServerNames, discoverMcpAuthServer, discoverMcpTools, distillSessionFacts, embedderFromProviders, encryptJSON as encryptSyncBlob, evaluateAcceptance, extractCharts, failures, fileExt, fileOAuthProvider, gatherSyncBundle, hasUsableProvider, hashContent, heuristicCodeChunker, inferAzureBaseModel, inlineRuns, isDocumentFormat, isMcpToolName, matchImageLine, mcpServerPrefix, mcpToolName, nodeHttpFetch, parseBlocks, parseChartSpec, parseDelimited, parseRankOrder, parseSlide, planRetrieval, preferIpv4Host, reciprocalRankFusion, refreshMcpToken, removeMcpServerDenials, renderDocument, renderDocx, renderPptx, renderXlsx, runCascade, sessionWorthRemembering, sniffImage, splitSlides, streamCascade, stripInline, summarizeCompleted, undecided, uniqueMcpServerName };

package/dist/index.d.ts CHANGED Viewed

@@ -136,7 +136,7 @@ declare class ResumeStore {
  */
 declare function summarizeCompleted(completed: readonly CompletedNode[], perNodeChars?: number): string;
-type ProviderType = 'anthropic' | 'openai' | 'gemini' | 'azure' | 'openai-compatible' | 'ollama' | 'github-models';
+type ProviderType = 'anthropic' | 'openai' | 'gemini' | 'azure' | 'openai-compatible' | 'ollama';
 interface ModelInfo {
     id: string;
     name: string;
@@ -1425,6 +1425,17 @@ declare class MemoryStore {
     }>;
     upsertCachedModel(model: ModelInfo): void;
     getCachedModels(provider?: ProviderType): ModelInfo[];
+    /**
+     * Deletes cached rows for a provider type that no longer exists in
+     * `ProviderType`, so it takes a raw string rather than the union.
+     *
+     * Needed because the cache outlives the code: the REPL's loadCache() only
+     * re-discovers when the cache is EMPTY or older than 24h, so rows left
+     * behind by a removed provider read as "cache populated" and suppress
+     * discovery for the providers that replaced it — `/model` then shows a
+     * configured provider with zero models until the rows age out.
+     */
+    purgeCachedModelsForRetiredProvider(providerType: string): number;
     clearModelCache(provider?: ProviderType): void;
     getCacheAge(): number;
     saveModelProfile(modelId: string, provider: ProviderType, specializations: string[]): void;
@@ -2031,15 +2042,6 @@ declare class CascadeRouter extends EventEmitter {
     private discoverOllamaModels;
     /** Returns true when at least one real model was discovered from the endpoint. */
     private discoverOpenAICompatibleModels;
-    /**
-     * Registers GitHub Models' real catalog ids via addDynamicModel so init()'s
-     * tier-fill loop can pick one. Registration alone does not create a bound
-     * BaseProvider instance (see ensureProvider) — the tier-fill loop's own
-     * ensureProvider call does that for whichever model it actually selects,
-     * which is why this runs BEFORE that loop rather than only in the
-     * background discoverProviderModels() refresh.
-     */
-    private discoverGitHubModelsCatalog;
     private ensureProvider;
     private getProvider;
     private createProvider;
@@ -2177,6 +2179,16 @@ declare class ToolRegistry extends EventEmitter {
     private plugins;
     constructor(config: ToolsConfig, workspaceRoot?: string);
     register(tool: BaseTool): void;
+    /**
+     * The directory every registered tool resolves relative paths against.
+     *
+     * Exposed so a caller that has to reason about a file a tool WROTE can look
+     * in the same place the tool wrote it. `process.cwd()` is not that place
+     * outside a plain CLI run: the hosted server's cwd is the app directory
+     * while the run's workspace is the tenant's scratch dir, and Electron's cwd
+     * is the app bundle rather than the user's chosen folder.
+     */
+    getWorkspaceRoot(): string;
     /**
      * Wait until a named tool is registered, resolving immediately if it already exists.
      * T3 workers can call this after encountering a missing-tool error to resume
@@ -3292,6 +3304,20 @@ declare class T3Worker extends BaseTier {
      */
     private coordinateFileIntents;
     private requiresArtifact;
+    /**
+     * Where a file a tool wrote actually lives.
+     *
+     * This used to be `process.cwd()`, which is only the workspace in a plain
+     * CLI run. The hosted server runs with cwd at the app directory while the
+     * run's workspace is the tenant's scratch dir, and Electron's cwd is the app
+     * bundle rather than the folder the user picked. So the tool wrote
+     * `<workspace>/report.docx`, verification stat'd `<cwd>/report.docx`, found
+     * nothing, and the worker looped and then threw WorkerStallError — surfacing
+     * as "no file was created" on a file that had in fact been created, followed
+     * by a failed node. Asking the registry is exact: it is the same root every
+     * registered tool was configured with (registry.registerDefaults).
+     */
+    private artifactRoot;
     private extractArtifactPaths;
     private verifyArtifacts;
     /**
@@ -3634,6 +3660,11 @@ interface CascadeMdContent {
     systemPrompt: string;
 }
+declare function hasUsableProvider(providers: Array<{
+    type: string;
+    apiKey?: string;
+    authToken?: string;
+}> | undefined): boolean;
 declare class ConfigManager {
     private config;
     private keystore;
@@ -3642,6 +3673,25 @@ declare class ConfigManager {
     private cascadeMd;
     private workspacePath;
     private globalDir;
+    /**
+     * What THIS load migrated out, if anything. Strictly per-load state: reset
+     * at the top of every `load()`, because two places read it as a statement
+     * about the load in progress — `injectEnvKeys()` asks whether an empty
+     * provider list was emptied by a retirement, and the end of `load()` warns
+     * and builds the user-facing notice from it. Left set, a second `load()` on
+     * the same instance (`startRepl()` does one after its setup wizard) would
+     * re-announce a migration that already happened and suppress the Ollama
+     * fallback for a list that is empty for some unrelated reason.
+     */
+    private retiredCleanup?;
+    /**
+     * Human-readable migration notice held for a UI to display. `console.warn`
+     * is not sufficient: the REPL clears the TTY immediately after load(), and
+     * the desktop emits from the main process where nothing is rendered.
+     */
+    private pendingRetiredNotice?;
+    /** Returns the pending migration notice once, then forgets it. */
+    takeRetiredNotice(): string | undefined;
     /** `globalDirOverride` exists for tests — never point it at the real home dir there. */
     constructor(workspacePath?: string, globalDirOverride?: string);
     load(): Promise<void>;
@@ -5026,9 +5076,6 @@ declare const DEFAULT_THEME: ThemeName;
 declare const OLLAMA_BASE_URL = "http://localhost:11434";
 declare const LM_STUDIO_BASE_URL = "http://localhost:1234";
 declare const AZURE_BASE_URL_TEMPLATE = "https://{resource}.openai.azure.com";
-declare const GITHUB_MODELS_INFERENCE_URL = "https://models.github.ai/inference";
-declare const GITHUB_MODELS_CATALOG_URL = "https://models.github.ai/catalog/models";
-declare const GITHUB_MODELS_API_VERSION = "2026-03-10";
 declare const TOOL_NAMES: {
     readonly SHELL: "shell";
     readonly FILE_READ: "file_read";
@@ -5264,6 +5311,13 @@ declare class CloudClient {
     logout(): Promise<void>;
 }
+interface RetiredProviderCleanup {
+    /** Retired `providers[]` types that were dropped, in first-seen order. */
+    removed: string[];
+    /** Tier keys (`t1`/`t2`/`t3`) whose pin named a retired provider and was cleared. */
+    clearedPins: string[];
+}
 /**
  * Bundle format version.
  *
@@ -5312,6 +5366,6 @@ interface SyncBundle {
 /** Pluck the portable subset of a config into a bundle (undefined fields omitted). */
 declare function gatherSyncBundle(config: CascadeConfig): SyncBundle;
 /** Merge a pulled bundle into a config, returning the updated config to persist. */
-declare function applySyncBundle(bundle: SyncBundle, config: CascadeConfig): CascadeConfig;
+declare function applySyncBundle(bundle: SyncBundle, config: CascadeConfig, cleanup?: RetiredProviderCleanup): CascadeConfig;
-export { AZURE_BASE_MODELS, AZURE_BASE_URL_TEMPLATE, type AcceptanceProbe, type AcceptanceResult, type AcceptanceVerdict, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, type BenchmarksConfig, type Block, type BudgetConfig, CASCADE_AUDIT_FILE, CASCADE_CONFIG_DIR, CASCADE_CONFIG_FILE, CASCADE_DASHBOARD_SECRET_FILE, CASCADE_DB_FILE, CASCADE_IGNORE_FILE, CASCADE_KEYSTORE_FILE, CASCADE_MD_FILE, CASCADE_VERSION, CHARS_PER_TOKEN, COMPLEXITY_T2_COUNT, Cascade, CascadeCancelledError, type CascadeConfig, type CascadeEvent, type CascadeEventType, CascadeIgnore, type CascadeMessage, CascadeRouter, type CascadeRunOptions, type CascadeRunResult, type CascadeThemeName, CascadeToolError, type ChartSeries, type ChartSpec, type Chunk, type ChunkOptions, CloudClient, type CloudConversation, type CloudMessage, type CloudSession, type CloudSessionStore, type CloudTurnInput, type CloudUser, type CodeChunkOptions, type CodeChunker, CodeSearchTool, type CompileTaskGraphOptions, type CompiledTaskGraph, type CompleteFn, type CompletedNode, ConfigManager, type ConversationMessage, type CurrentPageProvider, type CurrentPageSnapshot, CurrentPageTool, DEFAULT_API_PORT, DEFAULT_APPROVAL_REQUIRED, DEFAULT_AUTO_SUMMARIZE_AT, DEFAULT_CLOUD_URL, DEFAULT_CONTEXT_LIMIT, DEFAULT_DASHBOARD_PORT, DEFAULT_MAX_SESSION_MESSAGES, DEFAULT_RETENTION_DAYS, DEFAULT_THEME, DOCUMENT_MIME, type DashboardConfig, DashboardServer, DependencyScheduler, type DeviceStart, type DiscoveredMcpTool, type DistilledFact, type ChartKind as DocumentChartKind, type DocumentFormat, type Embedder, type EncryptedBlob, type EscalationDecision, type EscalationPayload, type ExtendedContextConfig, type FileManifest, FileMcpOAuthStore, GITHUB_MODELS_API_VERSION, GITHUB_MODELS_CATALOG_URL, GITHUB_MODELS_INFERENCE_URL, GLOBAL_CONFIG_DIR, GLOBAL_CREDENTIALS_FILE, GLOBAL_DB_FILE, GLOBAL_KEYSTORE_FILE, GLOBAL_RUNTIME_DB_FILE, GenerateDocumentTool, type GenerateOptions, type GenerateResult, type GraphFactSource, GraphRetriever, type GraphSearchOptions, GraphSearchTool, type HookDefinition, type HooksConfig, HooksRunner, type Identity, type ImageAttachment, type ImageByteLoader, type ImageInfo, type ImageRef, type InlineRun, Keystore, LLMReranker, LM_STUDIO_BASE_URL, type LegacyThemeName, type LoadedImage, MAX_PAGE_TEXT_CHARS, MCP_TOOL_PREFIX, MODELS, type ManifestDiff, McpClient, type McpDiscoveryResult, McpOAuthProvider, type McpOAuthState, type McpOAuthStore, type McpServerConfig$1 as McpServerConfig, type McpServerRename, type MemoryConfig, MemoryStore, type Message, type MessageContent, type MessagePayload, type MessageStatus, type MessageType, type ModelInfo, type ModelOverrides, type NativeProvider, OLLAMA_BASE_URL, OpenAICompatibleEmbedder, type OpenAIEmbedderOptions, PROVIDER_DISPLAY_NAMES, type PeerMessage, type PeerMessageEvent, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type PermissionTrailEntry, type PlanReviewConfig, type ProviderConfig, type ProviderType, RESUME_SCHEMA_VERSION, type RankedFact, type RefreshResult, type RenderOptions, type Reranker, type ResumeCheckpoint, type ResumeReason, ResumeStore, type ResumeStoreOptions, type RetrievalContext, type RetrievalMode, type RetrievalPlan, Retriever, type RetrieverSearchOptions, type RuntimeNode, type RuntimeNodeLog, type RuntimeRefreshPayload, type RuntimeScope, type RuntimeSession, type RuntimeSnapshotPayload, type ScheduledTask, type SchedulerExecutionMode, type SchedulerHooks, type SchedulerOptions, type SchedulerResult, type ScoredChunk, type SearchOptions, type Session, type SessionCheckpoint, type SessionMetadata, type SessionSubscriptionPayload, type Slide, SqliteVectorStore, type StatusUpdate, type StoredMessage, type StreamChunk, type SyncBundle, T1Administrator, type T1ToT2Assignment, T1_MODEL_PRIORITY, T2Manager, type T2Result, type T2ToT3Assignment, T2_MODEL_PRIORITY, type T3Result, type T3ResultPayload, type T3SubtaskSpec, T3Worker, T3_MODEL_PRIORITY, THEME_NAMES, TOOL_NAMES, type TaskComplexity, type TaskGraph, type TaskGraphInputNode, type TaskGraphIssue, type TaskGraphIssueCode, type TaskGraphNode, type TaskGraphNodeKind, TaskGraphValidationError, type TaskGraphValidationMode, TaskScheduler, Telemetry, type TelemetryConfig, type Theme, type ThemeColors, type ThemeName, type TierConfig, type TierLimits, type TierRole, type TierStatus, type TokenUsage, type ToolCall, type ToolDefinition, type ToolExecuteOptions, ToolRegistry, type ToolResult, type ToolsConfig, VISION_MODEL_PRIORITY, type VectorStore, type WebSearchConfig, type WebhookConfig, type WorkspaceConfig, type WorkspaceFileReader, WorkspaceIndex, type WorkspaceIndexOptions, applySyncBundle, azureModelForDeployment, beginMcpOAuth, buildDocumentTools, buildManifest, buildSessionTranscript, bytesToBase64, cagCharBudget, chartKind, chartToTableRows, chatCompleterFromProviders, chunkCode, chunkText, compileSectionGraph, compileSubtaskGraph, compileTaskGraph, completeMcpOAuth, connectMcpWithLoopbackOAuth, createCascade, decryptJSON as decryptSyncBlob, diffManifest, disambiguateMcpServerNames, discoverMcpAuthServer, discoverMcpTools, distillSessionFacts, embedderFromProviders, encryptJSON as encryptSyncBlob, evaluateAcceptance, extractCharts, failures, fileExt, fileOAuthProvider, gatherSyncBundle, hashContent, heuristicCodeChunker, inferAzureBaseModel, inlineRuns, isDocumentFormat, isMcpToolName, matchImageLine, mcpServerPrefix, mcpToolName, nodeHttpFetch, parseBlocks, parseChartSpec, parseDelimited, parseRankOrder, parseSlide, planRetrieval, preferIpv4Host, reciprocalRankFusion, refreshMcpToken, removeMcpServerDenials, renderDocument, renderDocx, renderPptx, renderXlsx, runCascade, sessionWorthRemembering, sniffImage, splitSlides, streamCascade, stripInline, summarizeCompleted, undecided, uniqueMcpServerName };
+export { AZURE_BASE_MODELS, AZURE_BASE_URL_TEMPLATE, type AcceptanceProbe, type AcceptanceResult, type AcceptanceVerdict, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, type BenchmarksConfig, type Block, type BudgetConfig, CASCADE_AUDIT_FILE, CASCADE_CONFIG_DIR, CASCADE_CONFIG_FILE, CASCADE_DASHBOARD_SECRET_FILE, CASCADE_DB_FILE, CASCADE_IGNORE_FILE, CASCADE_KEYSTORE_FILE, CASCADE_MD_FILE, CASCADE_VERSION, CHARS_PER_TOKEN, COMPLEXITY_T2_COUNT, Cascade, CascadeCancelledError, type CascadeConfig, type CascadeEvent, type CascadeEventType, CascadeIgnore, type CascadeMessage, CascadeRouter, type CascadeRunOptions, type CascadeRunResult, type CascadeThemeName, CascadeToolError, type ChartSeries, type ChartSpec, type Chunk, type ChunkOptions, CloudClient, type CloudConversation, type CloudMessage, type CloudSession, type CloudSessionStore, type CloudTurnInput, type CloudUser, type CodeChunkOptions, type CodeChunker, CodeSearchTool, type CompileTaskGraphOptions, type CompiledTaskGraph, type CompleteFn, type CompletedNode, ConfigManager, type ConversationMessage, type CurrentPageProvider, type CurrentPageSnapshot, CurrentPageTool, DEFAULT_API_PORT, DEFAULT_APPROVAL_REQUIRED, DEFAULT_AUTO_SUMMARIZE_AT, DEFAULT_CLOUD_URL, DEFAULT_CONTEXT_LIMIT, DEFAULT_DASHBOARD_PORT, DEFAULT_MAX_SESSION_MESSAGES, DEFAULT_RETENTION_DAYS, DEFAULT_THEME, DOCUMENT_MIME, type DashboardConfig, DashboardServer, DependencyScheduler, type DeviceStart, type DiscoveredMcpTool, type DistilledFact, type ChartKind as DocumentChartKind, type DocumentFormat, type Embedder, type EncryptedBlob, type EscalationDecision, type EscalationPayload, type ExtendedContextConfig, type FileManifest, FileMcpOAuthStore, GLOBAL_CONFIG_DIR, GLOBAL_CREDENTIALS_FILE, GLOBAL_DB_FILE, GLOBAL_KEYSTORE_FILE, GLOBAL_RUNTIME_DB_FILE, GenerateDocumentTool, type GenerateOptions, type GenerateResult, type GraphFactSource, GraphRetriever, type GraphSearchOptions, GraphSearchTool, type HookDefinition, type HooksConfig, HooksRunner, type Identity, type ImageAttachment, type ImageByteLoader, type ImageInfo, type ImageRef, type InlineRun, Keystore, LLMReranker, LM_STUDIO_BASE_URL, type LegacyThemeName, type LoadedImage, MAX_PAGE_TEXT_CHARS, MCP_TOOL_PREFIX, MODELS, type ManifestDiff, McpClient, type McpDiscoveryResult, McpOAuthProvider, type McpOAuthState, type McpOAuthStore, type McpServerConfig$1 as McpServerConfig, type McpServerRename, type MemoryConfig, MemoryStore, type Message, type MessageContent, type MessagePayload, type MessageStatus, type MessageType, type ModelInfo, type ModelOverrides, type NativeProvider, OLLAMA_BASE_URL, OpenAICompatibleEmbedder, type OpenAIEmbedderOptions, PROVIDER_DISPLAY_NAMES, type PeerMessage, type PeerMessageEvent, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type PermissionTrailEntry, type PlanReviewConfig, type ProviderConfig, type ProviderType, RESUME_SCHEMA_VERSION, type RankedFact, type RefreshResult, type RenderOptions, type Reranker, type ResumeCheckpoint, type ResumeReason, ResumeStore, type ResumeStoreOptions, type RetrievalContext, type RetrievalMode, type RetrievalPlan, Retriever, type RetrieverSearchOptions, type RuntimeNode, type RuntimeNodeLog, type RuntimeRefreshPayload, type RuntimeScope, type RuntimeSession, type RuntimeSnapshotPayload, type ScheduledTask, type SchedulerExecutionMode, type SchedulerHooks, type SchedulerOptions, type SchedulerResult, type ScoredChunk, type SearchOptions, type Session, type SessionCheckpoint, type SessionMetadata, type SessionSubscriptionPayload, type Slide, SqliteVectorStore, type StatusUpdate, type StoredMessage, type StreamChunk, type SyncBundle, T1Administrator, type T1ToT2Assignment, T1_MODEL_PRIORITY, T2Manager, type T2Result, type T2ToT3Assignment, T2_MODEL_PRIORITY, type T3Result, type T3ResultPayload, type T3SubtaskSpec, T3Worker, T3_MODEL_PRIORITY, THEME_NAMES, TOOL_NAMES, type TaskComplexity, type TaskGraph, type TaskGraphInputNode, type TaskGraphIssue, type TaskGraphIssueCode, type TaskGraphNode, type TaskGraphNodeKind, TaskGraphValidationError, type TaskGraphValidationMode, TaskScheduler, Telemetry, type TelemetryConfig, type Theme, type ThemeColors, type ThemeName, type TierConfig, type TierLimits, type TierRole, type TierStatus, type TokenUsage, type ToolCall, type ToolDefinition, type ToolExecuteOptions, ToolRegistry, type ToolResult, type ToolsConfig, VISION_MODEL_PRIORITY, type VectorStore, type WebSearchConfig, type WebhookConfig, type WorkspaceConfig, type WorkspaceFileReader, WorkspaceIndex, type WorkspaceIndexOptions, applySyncBundle, azureModelForDeployment, beginMcpOAuth, buildDocumentTools, buildManifest, buildSessionTranscript, bytesToBase64, cagCharBudget, chartKind, chartToTableRows, chatCompleterFromProviders, chunkCode, chunkText, compileSectionGraph, compileSubtaskGraph, compileTaskGraph, completeMcpOAuth, connectMcpWithLoopbackOAuth, createCascade, decryptJSON as decryptSyncBlob, diffManifest, disambiguateMcpServerNames, discoverMcpAuthServer, discoverMcpTools, distillSessionFacts, embedderFromProviders, encryptJSON as encryptSyncBlob, evaluateAcceptance, extractCharts, failures, fileExt, fileOAuthProvider, gatherSyncBundle, hasUsableProvider, hashContent, heuristicCodeChunker, inferAzureBaseModel, inlineRuns, isDocumentFormat, isMcpToolName, matchImageLine, mcpServerPrefix, mcpToolName, nodeHttpFetch, parseBlocks, parseChartSpec, parseDelimited, parseRankOrder, parseSlide, planRetrieval, preferIpv4Host, reciprocalRankFusion, refreshMcpToken, removeMcpServerDenials, renderDocument, renderDocx, renderPptx, renderXlsx, runCascade, sessionWorthRemembering, sniffImage, splitSlides, streamCascade, stripInline, summarizeCompleted, undecided, uniqueMcpServerName };