cascade-ai 0.16.0 → 0.18.0

package/dist/index.d.cts

@@ -1090,6 +1090,14 @@ declare class WorldStateDB {
      * the raw linear log — this replaces replaying the whole log during planning.
      */
     getFormattedKnowledge(prompt?: string, limit?: number): string;
+    /**
+     * Delete one fact by its (normalized) entity + relation key. Returns whether
+     * a row was actually removed. Powers the desktop Knowledge tab's per-fact
+     * delete — users can prune what the planner remembers about their project.
+     */
+    deleteFact(entity: string, relation: string): boolean;
+    /** Delete every fact. Returns how many were removed. */
+    clearFacts(): number;
     exportKnowledge(): {
         facts: WorldFact[];
         worldLog: WorldStateEntry[];
@@ -2324,7 +2332,8 @@ declare class ConfigManager {
     private cascadeMd;
     private workspacePath;
     private globalDir;
-    constructor(workspacePath?: string);
+    /** `globalDirOverride` exists for tests — never point it at the real home dir there. */
+    constructor(workspacePath?: string, globalDirOverride?: string);
     load(): Promise<void>;
     getConfig(): CascadeConfig;
     getKeystore(): Keystore;
@@ -2361,6 +2370,17 @@ declare class DashboardSocket {
     private setupHandlers;
     onSessionRate(callback: (sessionId: string, rating: 'good' | 'bad') => void): void;
     onSessionHalt(callback: (sessionId: string) => void): void;
+    /**
+     * Boardroom plan decisions from a connected client. The desktop shows a
+     * plan-review modal on `plan:approval-required` and answers here; the
+     * server routes the decision into the paused run via resolvePlanApproval.
+     */
+    onPlanDecision(callback: (data: {
+        sessionId: string;
+        approved: boolean;
+        note?: string;
+        editedPlan?: unknown;
+    }) => void): void;
     onSessionSteer(callback: (message: string, sessionId?: string, nodeId?: string) => void): void;
     onConfigUpdate(callback: (data: {
         keys?: Record<string, string>;
@@ -2400,6 +2420,14 @@ declare class DashboardServer {
      * map is how that answer reaches the run that's blocked on it.
      */
     private pendingApprovals;
+    /**
+     * The orchestration decision trail ("why") of each session's most recent
+     * run — captured when the run ends so the desktop's Why panel can show it
+     * after the fact. Bounded: oldest entry evicted past 50 sessions.
+     */
+    private whyBySession;
+    /** Cron scheduler for the Schedules UI — runs tasks while this server is up. */
+    private scheduler;
     private port;
     private host;
     private workspacePath;
@@ -2440,6 +2468,12 @@ declare class DashboardServer {
     private persistRunStart;
     /** Record run end: the assistant reply (when there is one) and the runtime row's final status. */
     private persistRunEnd;
+    /**
+     * Capture the run's decision trail + router economics ("why") and broadcast
+     * it so the desktop's Why panel updates live; kept per-session for the
+     * GET /api/sessions/:id/why fallback (panel opened after the run).
+     */
+    private captureWhy;
     /**
      * Route steering text into running Cascade instances. Targets the given
      * session, or every active session when none is specified (the desktop
@@ -2457,6 +2491,13 @@ declare class DashboardServer {
      * timeout denies it.
      */
     private makeApprovalCallback;
+    /**
+     * Execute one scheduled task firing. Runs headless (like `cascade run -p`):
+     * tool approvals are auto-granted since nobody may be watching when the cron
+     * fires — the Schedules UI states this. Events broadcast to every connected
+     * client so an open desktop sees the run appear live.
+     */
+    private runScheduledTask;
     /** Deny + clear any approvals still pending for a session (run end / abort). */
     private denyPendingApprovals;
     private persistRuntimeRow;
@@ -2636,6 +2677,8 @@ declare const CASCADE_DASHBOARD_SECRET_FILE = ".cascade/dashboard-secret";
 declare const GLOBAL_CONFIG_DIR = ".cascade-ai";
 declare const GLOBAL_DB_FILE = "memory.db";
 declare const GLOBAL_KEYSTORE_FILE = "keystore.enc";
+/** Machine-global provider credentials (API keys, Azure deployments) — chmod 600. */
+declare const GLOBAL_CREDENTIALS_FILE = "credentials.json";
 declare const GLOBAL_RUNTIME_DB_FILE = "runtime.db";
 declare const DEFAULT_DASHBOARD_PORT = 4891;
 declare const DEFAULT_API_PORT = 4892;
@@ -2700,4 +2743,4 @@ declare class CascadeToolError extends Error {
 declare function preferIpv4Host(url: string | undefined): string | undefined;
 declare function nodeHttpFetch(input: string | URL | Request, init?: RequestInit, redirectCount?: number): Promise<Response>;
 
-export { AZURE_BASE_URL_TEMPLATE, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, type BenchmarksConfig, 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, type CascadeThemeName, 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, type LegacyThemeName, 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 PeerMessageEvent, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type PermissionTrailEntry, type PlanReviewConfig, 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, nodeHttpFetch, preferIpv4Host, runCascade, streamCascade };
+export { AZURE_BASE_URL_TEMPLATE, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, type BenchmarksConfig, 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, type CascadeThemeName, 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_CREDENTIALS_FILE, 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, type LegacyThemeName, 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 PeerMessageEvent, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type PermissionTrailEntry, type PlanReviewConfig, 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, nodeHttpFetch, preferIpv4Host, runCascade, streamCascade };

package/dist/index.d.ts

@@ -1090,6 +1090,14 @@ declare class WorldStateDB {
      * the raw linear log — this replaces replaying the whole log during planning.
      */
     getFormattedKnowledge(prompt?: string, limit?: number): string;
+    /**
+     * Delete one fact by its (normalized) entity + relation key. Returns whether
+     * a row was actually removed. Powers the desktop Knowledge tab's per-fact
+     * delete — users can prune what the planner remembers about their project.
+     */
+    deleteFact(entity: string, relation: string): boolean;
+    /** Delete every fact. Returns how many were removed. */
+    clearFacts(): number;
     exportKnowledge(): {
         facts: WorldFact[];
         worldLog: WorldStateEntry[];
@@ -2324,7 +2332,8 @@ declare class ConfigManager {
     private cascadeMd;
     private workspacePath;
     private globalDir;
-    constructor(workspacePath?: string);
+    /** `globalDirOverride` exists for tests — never point it at the real home dir there. */
+    constructor(workspacePath?: string, globalDirOverride?: string);
     load(): Promise<void>;
     getConfig(): CascadeConfig;
     getKeystore(): Keystore;
@@ -2361,6 +2370,17 @@ declare class DashboardSocket {
     private setupHandlers;
     onSessionRate(callback: (sessionId: string, rating: 'good' | 'bad') => void): void;
     onSessionHalt(callback: (sessionId: string) => void): void;
+    /**
+     * Boardroom plan decisions from a connected client. The desktop shows a
+     * plan-review modal on `plan:approval-required` and answers here; the
+     * server routes the decision into the paused run via resolvePlanApproval.
+     */
+    onPlanDecision(callback: (data: {
+        sessionId: string;
+        approved: boolean;
+        note?: string;
+        editedPlan?: unknown;
+    }) => void): void;
     onSessionSteer(callback: (message: string, sessionId?: string, nodeId?: string) => void): void;
     onConfigUpdate(callback: (data: {
         keys?: Record<string, string>;
@@ -2400,6 +2420,14 @@ declare class DashboardServer {
      * map is how that answer reaches the run that's blocked on it.
      */
     private pendingApprovals;
+    /**
+     * The orchestration decision trail ("why") of each session's most recent
+     * run — captured when the run ends so the desktop's Why panel can show it
+     * after the fact. Bounded: oldest entry evicted past 50 sessions.
+     */
+    private whyBySession;
+    /** Cron scheduler for the Schedules UI — runs tasks while this server is up. */
+    private scheduler;
     private port;
     private host;
     private workspacePath;
@@ -2440,6 +2468,12 @@ declare class DashboardServer {
     private persistRunStart;
     /** Record run end: the assistant reply (when there is one) and the runtime row's final status. */
     private persistRunEnd;
+    /**
+     * Capture the run's decision trail + router economics ("why") and broadcast
+     * it so the desktop's Why panel updates live; kept per-session for the
+     * GET /api/sessions/:id/why fallback (panel opened after the run).
+     */
+    private captureWhy;
     /**
      * Route steering text into running Cascade instances. Targets the given
      * session, or every active session when none is specified (the desktop
@@ -2457,6 +2491,13 @@ declare class DashboardServer {
      * timeout denies it.
      */
     private makeApprovalCallback;
+    /**
+     * Execute one scheduled task firing. Runs headless (like `cascade run -p`):
+     * tool approvals are auto-granted since nobody may be watching when the cron
+     * fires — the Schedules UI states this. Events broadcast to every connected
+     * client so an open desktop sees the run appear live.
+     */
+    private runScheduledTask;
     /** Deny + clear any approvals still pending for a session (run end / abort). */
     private denyPendingApprovals;
     private persistRuntimeRow;
@@ -2636,6 +2677,8 @@ declare const CASCADE_DASHBOARD_SECRET_FILE = ".cascade/dashboard-secret";
 declare const GLOBAL_CONFIG_DIR = ".cascade-ai";
 declare const GLOBAL_DB_FILE = "memory.db";
 declare const GLOBAL_KEYSTORE_FILE = "keystore.enc";
+/** Machine-global provider credentials (API keys, Azure deployments) — chmod 600. */
+declare const GLOBAL_CREDENTIALS_FILE = "credentials.json";
 declare const GLOBAL_RUNTIME_DB_FILE = "runtime.db";
 declare const DEFAULT_DASHBOARD_PORT = 4891;
 declare const DEFAULT_API_PORT = 4892;
@@ -2700,4 +2743,4 @@ declare class CascadeToolError extends Error {
 declare function preferIpv4Host(url: string | undefined): string | undefined;
 declare function nodeHttpFetch(input: string | URL | Request, init?: RequestInit, redirectCount?: number): Promise<Response>;
 
-export { AZURE_BASE_URL_TEMPLATE, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, type BenchmarksConfig, 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, type CascadeThemeName, 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, type LegacyThemeName, 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 PeerMessageEvent, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type PermissionTrailEntry, type PlanReviewConfig, 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, nodeHttpFetch, preferIpv4Host, runCascade, streamCascade };
+export { AZURE_BASE_URL_TEMPLATE, type ApprovalRequest, type ApprovalResponse, type AuditEntry, AuditLogger, type BenchmarksConfig, 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, type CascadeThemeName, 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_CREDENTIALS_FILE, 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, type LegacyThemeName, 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 PeerMessageEvent, type PeerSyncPayload, type PeerSyncType, type PermissionDecision, type PermissionDecisionPayload, type PermissionRequest, type PermissionTrailEntry, type PlanReviewConfig, 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, nodeHttpFetch, preferIpv4Host, runCascade, streamCascade };