cascade-ai 0.2.2 → 0.2.12

package/dist/index.d.cts

@@ -84,6 +84,12 @@ interface ToolDefinition {
     description: string;
     inputSchema: Record<string, unknown>;
 }
+interface WebSearchConfig {
+    searxngUrl?: string;
+    braveApiKey?: string;
+    tavilyApiKey?: string;
+    maxResults?: number;
+}
 interface Message {
     id: string;
     role: 'user' | 'assistant' | 'error' | 'system';
@@ -141,6 +147,7 @@ interface T1ToT2Assignment {
     constraints: string[];
     t3Subtasks: T3SubtaskSpec[];
     executionMode?: 'parallel' | 'sequential';
+    dependsOn?: string[];
     peerT2Ids?: string[];
 }
 interface T3SubtaskSpec {
@@ -346,6 +353,8 @@ interface ToolsConfig {
      * approval before they are spawned.
      */
     mcpTrusted?: string[];
+    /** Web search backends — at least one should be configured for best results */
+    webSearch?: WebSearchConfig;
 }
 interface HooksConfig {
     preToolUse?: HookDefinition[];
@@ -512,6 +521,19 @@ interface CascadeRunOptions {
         approved: boolean;
         always: boolean;
     }>;
+    /**
+     * An optional `AbortSignal` to cancel the run mid-execution.
+     * When aborted, all tiers (T1 → T2 → T3) stop at the next safe checkpoint
+     * and a `run:cancelled` event is emitted on the Cascade instance.
+     * The `run()` call resolves (not rejects) with a partial result.
+     *
+     * @example
+     * const controller = new AbortController();
+     * cascade.run({ prompt: '...', signal: controller.signal });
+     * // later:
+     * controller.abort();
+     */
+    signal?: AbortSignal;
 }
 interface CascadeRunResult {
     output: string;
@@ -698,7 +720,14 @@ interface McpClientOptions {
     approvalCallback?: McpApprovalCallback;
 }
 declare class McpClient {
+    private static activeProcessPids;
+    /**
+     * Forcefully kills all known MCP child processes.
+     * Call this from global process exit handlers to prevent zombie processes.
+     */
+    static killAllProcesses(): void;
     private clients;
+    private transports;
     private tools;
     private trustedServers;
     private approvalCallback;
@@ -709,6 +738,7 @@ declare class McpClient {
     callTool(serverName: string, toolName: string, input: Record<string, unknown>): Promise<string>;
     getToolDefinitions(): ToolDefinition[];
     getConnectedServers(): string[];
+    getActivePids(): number[];
     isConnected(serverName: string): boolean;
 }
 
@@ -772,6 +802,10 @@ declare class ToolRegistry {
 declare class MemoryStore {
     private db;
     constructor(dbPath: string);
+    private writeQueue;
+    private isProcessingQueue;
+    private processQueue;
+    private enqueueWrite;
     createSession(session: Session): void;
     updateSession(id: string, updates: Partial<Session>): void;
     getSession(id: string): Session | null;
@@ -881,6 +915,8 @@ declare abstract class BaseTier extends EventEmitter {
     protected label: string;
     protected systemPromptOverride: string;
     protected hierarchyContext: string;
+    /** Propagated AbortSignal — set by the tier's `execute()` before work begins. */
+    protected signal?: AbortSignal;
     constructor(role: TierRole, id?: string, parentId?: string);
     getStatus(): TierStatus;
     protected setStatus(status: TierStatus): void;
@@ -890,6 +926,12 @@ declare abstract class BaseTier extends EventEmitter {
     protected sendStatusUpdate(update: StatusUpdate): void;
     protected buildMessage(type: CascadeMessage['type'], to: string, payload: Record<string, unknown>): CascadeMessage;
     protected log(message: string, data?: unknown): void;
+    /**
+     * Throws `CascadeCancelledError` if the run's `AbortSignal` has fired.
+     * Call this at safe checkpoints (before LLM calls, between T3 dispatches)
+     * to provide a fast, clean cancellation path.
+     */
+    protected throwIfCancelled(): void;
 }
 
 type T2Evaluator = (req: PermissionRequest) => Promise<PermissionDecision | null>;
@@ -968,17 +1010,22 @@ declare class T1Administrator extends BaseTier {
      */
     setPermissionEscalator(escalator: PermissionEscalator): void;
     setToolCreator(creator: ToolCreator): void;
-    execute(userPrompt: string, images?: ImageAttachment[], systemContext?: string): Promise<{
+    execute(userPrompt: string, images?: ImageAttachment[], systemContext?: string, signal?: AbortSignal): Promise<{
         output: string;
         t2Results: T2Result[];
         taskId: string;
         complexity: TaskComplexity;
     }>;
     getEscalations(): EscalationPayload[];
+    private reviewT2Outputs;
     private analyzeImages;
     private decomposeTask;
     private validatePlan;
     private dispatchT2Managers;
+    /**
+     * Runs T2 managers respecting dependsOn declarations using Kahn's algorithm.
+     */
+    private runT2sWithDependencies;
     private compileFinalOutput;
     /**
      * T1-level permission evaluator.
@@ -1104,7 +1151,7 @@ declare class T2Manager extends BaseTier {
     shareCompletedOutput(sectionId: string, output: string): void;
     private extractKeywords;
     receivePeerSync(fromId: string, content: unknown): void;
-    execute(assignment: T1ToT2Assignment, taskId: string): Promise<T2Result>;
+    execute(assignment: T1ToT2Assignment, taskId: string, signal?: AbortSignal): Promise<T2Result>;
     private decomposeSection;
     private executeSubtasks;
     /**
@@ -1158,7 +1205,7 @@ declare class T3Worker extends BaseTier {
     setToolCreator(creator: ToolCreator): void;
     constructor(router: CascadeRouter, toolRegistry: ToolRegistry, parentId: string);
     setStore(store: MemoryStore, sessionId: string): void;
-    execute(assignment: T2ToT3Assignment, taskId: string): Promise<T3Result>;
+    execute(assignment: T2ToT3Assignment, taskId: string, signal?: AbortSignal): Promise<T3Result>;
     sendToPeer(toId: string, content: unknown): void;
     requestFromPeer(peerId: string, subtaskId: string): Promise<string>;
     syncWithPeers(barrierName: string): Promise<void>;
@@ -1534,7 +1581,7 @@ declare class Telemetry {
     shutdown(): Promise<void>;
 }
 
-declare const CASCADE_VERSION = "0.2.2";
+declare const CASCADE_VERSION = "0.2.12";
 declare const CASCADE_CONFIG_DIR = ".cascade";
 declare const CASCADE_MD_FILE = "CASCADE.md";
 declare const CASCADE_IGNORE_FILE = ".cascadeignore";
@@ -1578,8 +1625,28 @@ declare const TOOL_NAMES: {
     readonly PDF_CREATE: "pdf_create";
     readonly RUN_CODE: "run_code";
     readonly PEER_MESSAGE: "peer_message";
+    readonly WEB_SEARCH: "web_search";
 };
 declare const DEFAULT_APPROVAL_REQUIRED: string[];
 declare const PROVIDER_DISPLAY_NAMES: Record<ProviderType, string>;
 
-export { AZURE_BASE_URL_TEMPLATE, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, 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, COMPLEXITY_T2_COUNT, Cascade, type CascadeConfig, type CascadeEvent, type CascadeEventType, CascadeIgnore, type CascadeMessage, CascadeRouter, type CascadeRunOptions, type CascadeRunResult, ConfigManager, type ConversationMessage, DEFAULT_API_PORT, DEFAULT_APPROVAL_REQUIRED, DEFAULT_AUTO_SUMMARIZE_AT, DEFAULT_CONTEXT_LIMIT, DEFAULT_DASHBOARD_PORT, DEFAULT_MAX_SESSION_MESSAGES, DEFAULT_RETENTION_DAYS, DEFAULT_THEME, type DashboardConfig, DashboardServer, type EscalationPayload, GLOBAL_CONFIG_DIR, GLOBAL_DB_FILE, GLOBAL_KEYSTORE_FILE, GLOBAL_RUNTIME_DB_FILE, type GenerateOptions, type GenerateResult, type HookDefinition, type HooksConfig, HooksRunner, type Identity, type ImageAttachment, Keystore, LM_STUDIO_BASE_URL, MODELS, McpClient, type McpServerConfig$1 as McpServerConfig, type MemoryConfig, MemoryStore, type Message, type MessageContent, type MessagePayload, type MessageStatus, type MessageType, type ModelInfo, type ModelOverrides, OLLAMA_BASE_URL, PROVIDER_DISPLAY_NAMES, type PeerMessage, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type ProviderConfig, type ProviderType, type RuntimeNode, type RuntimeNodeLog, type RuntimeRefreshPayload, type RuntimeScope, type RuntimeSession, type RuntimeSnapshotPayload, type ScheduledTask, type Session, type SessionCheckpoint, type SessionMetadata, type SessionSubscriptionPayload, type StatusUpdate, type StoredMessage, type StreamChunk, 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, 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 WebhookConfig, type WorkspaceConfig, createCascade, runCascade, streamCascade };
+/**
+ * Thrown when a Cascade run is aborted via `AbortSignal`.
+ * Caught at the `Cascade.run()` boundary — does NOT propagate as an
+ * unhandled rejection. Callers receive a partial result instead.
+ */
+declare class CascadeCancelledError extends Error {
+    constructor(reason?: string);
+}
+/**
+ * A retryable error that carries a `.userMessage` for display.
+ */
+declare class CascadeToolError extends Error {
+    /** A friendly message to show the user / T3 */
+    readonly userMessage: string;
+    /** Whether this error class is retryable by default */
+    readonly retryable: boolean;
+    constructor(userMessage: string, cause?: unknown, retryable?: boolean);
+}
+
+export { AZURE_BASE_URL_TEMPLATE, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, 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, COMPLEXITY_T2_COUNT, Cascade, CascadeCancelledError, type CascadeConfig, type CascadeEvent, type CascadeEventType, CascadeIgnore, type CascadeMessage, CascadeRouter, type CascadeRunOptions, type CascadeRunResult, CascadeToolError, ConfigManager, type ConversationMessage, DEFAULT_API_PORT, DEFAULT_APPROVAL_REQUIRED, DEFAULT_AUTO_SUMMARIZE_AT, DEFAULT_CONTEXT_LIMIT, DEFAULT_DASHBOARD_PORT, DEFAULT_MAX_SESSION_MESSAGES, DEFAULT_RETENTION_DAYS, DEFAULT_THEME, type DashboardConfig, DashboardServer, type EscalationPayload, GLOBAL_CONFIG_DIR, GLOBAL_DB_FILE, GLOBAL_KEYSTORE_FILE, GLOBAL_RUNTIME_DB_FILE, type GenerateOptions, type GenerateResult, type HookDefinition, type HooksConfig, HooksRunner, type Identity, type ImageAttachment, Keystore, LM_STUDIO_BASE_URL, MODELS, McpClient, type McpServerConfig$1 as McpServerConfig, type MemoryConfig, MemoryStore, type Message, type MessageContent, type MessagePayload, type MessageStatus, type MessageType, type ModelInfo, type ModelOverrides, OLLAMA_BASE_URL, PROVIDER_DISPLAY_NAMES, type PeerMessage, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type ProviderConfig, type ProviderType, type RuntimeNode, type RuntimeNodeLog, type RuntimeRefreshPayload, type RuntimeScope, type RuntimeSession, type RuntimeSnapshotPayload, type ScheduledTask, type Session, type SessionCheckpoint, type SessionMetadata, type SessionSubscriptionPayload, type StatusUpdate, type StoredMessage, type StreamChunk, 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, 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 WebSearchConfig, type WebhookConfig, type WorkspaceConfig, createCascade, runCascade, streamCascade };

package/dist/index.d.ts

@@ -84,6 +84,12 @@ interface ToolDefinition {
     description: string;
     inputSchema: Record<string, unknown>;
 }
+interface WebSearchConfig {
+    searxngUrl?: string;
+    braveApiKey?: string;
+    tavilyApiKey?: string;
+    maxResults?: number;
+}
 interface Message {
     id: string;
     role: 'user' | 'assistant' | 'error' | 'system';
@@ -141,6 +147,7 @@ interface T1ToT2Assignment {
     constraints: string[];
     t3Subtasks: T3SubtaskSpec[];
     executionMode?: 'parallel' | 'sequential';
+    dependsOn?: string[];
     peerT2Ids?: string[];
 }
 interface T3SubtaskSpec {
@@ -346,6 +353,8 @@ interface ToolsConfig {
      * approval before they are spawned.
      */
     mcpTrusted?: string[];
+    /** Web search backends — at least one should be configured for best results */
+    webSearch?: WebSearchConfig;
 }
 interface HooksConfig {
     preToolUse?: HookDefinition[];
@@ -512,6 +521,19 @@ interface CascadeRunOptions {
         approved: boolean;
         always: boolean;
     }>;
+    /**
+     * An optional `AbortSignal` to cancel the run mid-execution.
+     * When aborted, all tiers (T1 → T2 → T3) stop at the next safe checkpoint
+     * and a `run:cancelled` event is emitted on the Cascade instance.
+     * The `run()` call resolves (not rejects) with a partial result.
+     *
+     * @example
+     * const controller = new AbortController();
+     * cascade.run({ prompt: '...', signal: controller.signal });
+     * // later:
+     * controller.abort();
+     */
+    signal?: AbortSignal;
 }
 interface CascadeRunResult {
     output: string;
@@ -698,7 +720,14 @@ interface McpClientOptions {
     approvalCallback?: McpApprovalCallback;
 }
 declare class McpClient {
+    private static activeProcessPids;
+    /**
+     * Forcefully kills all known MCP child processes.
+     * Call this from global process exit handlers to prevent zombie processes.
+     */
+    static killAllProcesses(): void;
     private clients;
+    private transports;
     private tools;
     private trustedServers;
     private approvalCallback;
@@ -709,6 +738,7 @@ declare class McpClient {
     callTool(serverName: string, toolName: string, input: Record<string, unknown>): Promise<string>;
     getToolDefinitions(): ToolDefinition[];
     getConnectedServers(): string[];
+    getActivePids(): number[];
     isConnected(serverName: string): boolean;
 }
 
@@ -772,6 +802,10 @@ declare class ToolRegistry {
 declare class MemoryStore {
     private db;
     constructor(dbPath: string);
+    private writeQueue;
+    private isProcessingQueue;
+    private processQueue;
+    private enqueueWrite;
     createSession(session: Session): void;
     updateSession(id: string, updates: Partial<Session>): void;
     getSession(id: string): Session | null;
@@ -881,6 +915,8 @@ declare abstract class BaseTier extends EventEmitter {
     protected label: string;
     protected systemPromptOverride: string;
     protected hierarchyContext: string;
+    /** Propagated AbortSignal — set by the tier's `execute()` before work begins. */
+    protected signal?: AbortSignal;
     constructor(role: TierRole, id?: string, parentId?: string);
     getStatus(): TierStatus;
     protected setStatus(status: TierStatus): void;
@@ -890,6 +926,12 @@ declare abstract class BaseTier extends EventEmitter {
     protected sendStatusUpdate(update: StatusUpdate): void;
     protected buildMessage(type: CascadeMessage['type'], to: string, payload: Record<string, unknown>): CascadeMessage;
     protected log(message: string, data?: unknown): void;
+    /**
+     * Throws `CascadeCancelledError` if the run's `AbortSignal` has fired.
+     * Call this at safe checkpoints (before LLM calls, between T3 dispatches)
+     * to provide a fast, clean cancellation path.
+     */
+    protected throwIfCancelled(): void;
 }
 
 type T2Evaluator = (req: PermissionRequest) => Promise<PermissionDecision | null>;
@@ -968,17 +1010,22 @@ declare class T1Administrator extends BaseTier {
      */
     setPermissionEscalator(escalator: PermissionEscalator): void;
     setToolCreator(creator: ToolCreator): void;
-    execute(userPrompt: string, images?: ImageAttachment[], systemContext?: string): Promise<{
+    execute(userPrompt: string, images?: ImageAttachment[], systemContext?: string, signal?: AbortSignal): Promise<{
         output: string;
         t2Results: T2Result[];
         taskId: string;
         complexity: TaskComplexity;
     }>;
     getEscalations(): EscalationPayload[];
+    private reviewT2Outputs;
     private analyzeImages;
     private decomposeTask;
     private validatePlan;
     private dispatchT2Managers;
+    /**
+     * Runs T2 managers respecting dependsOn declarations using Kahn's algorithm.
+     */
+    private runT2sWithDependencies;
     private compileFinalOutput;
     /**
      * T1-level permission evaluator.
@@ -1104,7 +1151,7 @@ declare class T2Manager extends BaseTier {
     shareCompletedOutput(sectionId: string, output: string): void;
     private extractKeywords;
     receivePeerSync(fromId: string, content: unknown): void;
-    execute(assignment: T1ToT2Assignment, taskId: string): Promise<T2Result>;
+    execute(assignment: T1ToT2Assignment, taskId: string, signal?: AbortSignal): Promise<T2Result>;
     private decomposeSection;
     private executeSubtasks;
     /**
@@ -1158,7 +1205,7 @@ declare class T3Worker extends BaseTier {
     setToolCreator(creator: ToolCreator): void;
     constructor(router: CascadeRouter, toolRegistry: ToolRegistry, parentId: string);
     setStore(store: MemoryStore, sessionId: string): void;
-    execute(assignment: T2ToT3Assignment, taskId: string): Promise<T3Result>;
+    execute(assignment: T2ToT3Assignment, taskId: string, signal?: AbortSignal): Promise<T3Result>;
     sendToPeer(toId: string, content: unknown): void;
     requestFromPeer(peerId: string, subtaskId: string): Promise<string>;
     syncWithPeers(barrierName: string): Promise<void>;
@@ -1534,7 +1581,7 @@ declare class Telemetry {
     shutdown(): Promise<void>;
 }
 
-declare const CASCADE_VERSION = "0.2.2";
+declare const CASCADE_VERSION = "0.2.12";
 declare const CASCADE_CONFIG_DIR = ".cascade";
 declare const CASCADE_MD_FILE = "CASCADE.md";
 declare const CASCADE_IGNORE_FILE = ".cascadeignore";
@@ -1578,8 +1625,28 @@ declare const TOOL_NAMES: {
     readonly PDF_CREATE: "pdf_create";
     readonly RUN_CODE: "run_code";
     readonly PEER_MESSAGE: "peer_message";
+    readonly WEB_SEARCH: "web_search";
 };
 declare const DEFAULT_APPROVAL_REQUIRED: string[];
 declare const PROVIDER_DISPLAY_NAMES: Record<ProviderType, string>;
 
-export { AZURE_BASE_URL_TEMPLATE, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, 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, COMPLEXITY_T2_COUNT, Cascade, type CascadeConfig, type CascadeEvent, type CascadeEventType, CascadeIgnore, type CascadeMessage, CascadeRouter, type CascadeRunOptions, type CascadeRunResult, ConfigManager, type ConversationMessage, DEFAULT_API_PORT, DEFAULT_APPROVAL_REQUIRED, DEFAULT_AUTO_SUMMARIZE_AT, DEFAULT_CONTEXT_LIMIT, DEFAULT_DASHBOARD_PORT, DEFAULT_MAX_SESSION_MESSAGES, DEFAULT_RETENTION_DAYS, DEFAULT_THEME, type DashboardConfig, DashboardServer, type EscalationPayload, GLOBAL_CONFIG_DIR, GLOBAL_DB_FILE, GLOBAL_KEYSTORE_FILE, GLOBAL_RUNTIME_DB_FILE, type GenerateOptions, type GenerateResult, type HookDefinition, type HooksConfig, HooksRunner, type Identity, type ImageAttachment, Keystore, LM_STUDIO_BASE_URL, MODELS, McpClient, type McpServerConfig$1 as McpServerConfig, type MemoryConfig, MemoryStore, type Message, type MessageContent, type MessagePayload, type MessageStatus, type MessageType, type ModelInfo, type ModelOverrides, OLLAMA_BASE_URL, PROVIDER_DISPLAY_NAMES, type PeerMessage, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type ProviderConfig, type ProviderType, type RuntimeNode, type RuntimeNodeLog, type RuntimeRefreshPayload, type RuntimeScope, type RuntimeSession, type RuntimeSnapshotPayload, type ScheduledTask, type Session, type SessionCheckpoint, type SessionMetadata, type SessionSubscriptionPayload, type StatusUpdate, type StoredMessage, type StreamChunk, 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, 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 WebhookConfig, type WorkspaceConfig, createCascade, runCascade, streamCascade };
+/**
+ * Thrown when a Cascade run is aborted via `AbortSignal`.
+ * Caught at the `Cascade.run()` boundary — does NOT propagate as an
+ * unhandled rejection. Callers receive a partial result instead.
+ */
+declare class CascadeCancelledError extends Error {
+    constructor(reason?: string);
+}
+/**
+ * A retryable error that carries a `.userMessage` for display.
+ */
+declare class CascadeToolError extends Error {
+    /** A friendly message to show the user / T3 */
+    readonly userMessage: string;
+    /** Whether this error class is retryable by default */
+    readonly retryable: boolean;
+    constructor(userMessage: string, cause?: unknown, retryable?: boolean);
+}
+
+export { AZURE_BASE_URL_TEMPLATE, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, 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, COMPLEXITY_T2_COUNT, Cascade, CascadeCancelledError, type CascadeConfig, type CascadeEvent, type CascadeEventType, CascadeIgnore, type CascadeMessage, CascadeRouter, type CascadeRunOptions, type CascadeRunResult, CascadeToolError, ConfigManager, type ConversationMessage, DEFAULT_API_PORT, DEFAULT_APPROVAL_REQUIRED, DEFAULT_AUTO_SUMMARIZE_AT, DEFAULT_CONTEXT_LIMIT, DEFAULT_DASHBOARD_PORT, DEFAULT_MAX_SESSION_MESSAGES, DEFAULT_RETENTION_DAYS, DEFAULT_THEME, type DashboardConfig, DashboardServer, type EscalationPayload, GLOBAL_CONFIG_DIR, GLOBAL_DB_FILE, GLOBAL_KEYSTORE_FILE, GLOBAL_RUNTIME_DB_FILE, type GenerateOptions, type GenerateResult, type HookDefinition, type HooksConfig, HooksRunner, type Identity, type ImageAttachment, Keystore, LM_STUDIO_BASE_URL, MODELS, McpClient, type McpServerConfig$1 as McpServerConfig, type MemoryConfig, MemoryStore, type Message, type MessageContent, type MessagePayload, type MessageStatus, type MessageType, type ModelInfo, type ModelOverrides, OLLAMA_BASE_URL, PROVIDER_DISPLAY_NAMES, type PeerMessage, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type ProviderConfig, type ProviderType, type RuntimeNode, type RuntimeNodeLog, type RuntimeRefreshPayload, type RuntimeScope, type RuntimeSession, type RuntimeSnapshotPayload, type ScheduledTask, type Session, type SessionCheckpoint, type SessionMetadata, type SessionSubscriptionPayload, type StatusUpdate, type StoredMessage, type StreamChunk, 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, 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 WebSearchConfig, type WebhookConfig, type WorkspaceConfig, createCascade, runCascade, streamCascade };