cascade-ai 0.17.0 → 0.19.0

package/dist/index.d.cts

@@ -188,6 +188,13 @@ interface T3SubtaskSpec {
     peerT3Ids: string[];
     dependsOn?: string[];
     executionMode?: 'parallel' | 'sequential';
+    /** Spec slice: the exact file paths this subtask creates or edits. */
+    files?: string[];
+    /** Objectively verifiable acceptance checks for the subtask's output. */
+    acceptance?: string[];
+    /** The ONLY background the worker needs — workers see nothing else, so the
+     * planner must make it self-sufficient (keeps worker context minimal). */
+    contextBrief?: string;
 }
 interface T2ToT3Assignment {
     subtaskId: string;
@@ -200,6 +207,10 @@ interface T2ToT3Assignment {
     sectionTitle?: string;
     dependsOn?: string[];
     executionMode?: 'parallel' | 'sequential';
+    /** Spec slice fields — see T3SubtaskSpec. */
+    files?: string[];
+    acceptance?: string[];
+    contextBrief?: string;
 }
 interface StatusUpdate {
     progressPct: number;
@@ -1090,6 +1101,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[];
@@ -1549,11 +1568,19 @@ declare abstract class BaseTier extends EventEmitter {
      * which would interleave, are not tagged.
      */
     protected isPresenter: boolean;
+    /**
+     * The model actually serving this tier (`provider:id`), once resolved —
+     * rides on every tier:status event so the desktop can show which model ran
+     * which node (Cockpit node panel / Why panel).
+     */
+    protected servingModel?: string;
     constructor(role: TierRole, id?: string, parentId?: string);
     /** Mark this tier as the run's presenter (root tier). */
     setPresenter(on?: boolean): void;
     getStatus(): TierStatus;
     protected setStatus(status: TierStatus, output?: string): void;
+    /** Record the model serving this tier; future status events carry it. */
+    protected setServingModel(model: string | undefined): void;
     protected setLabel(label: string): void;
     setSystemPromptOverride(prompt: string): void;
     setHierarchyContext(context: string): void;
@@ -1900,7 +1927,18 @@ declare class Cascade extends EventEmitter {
      * explicit multi-part structure, so ordinary single-file asks (handled as
      * Simple/Moderate) don't get over-escalated.
      */
+    /** Shared build/scale signals for the complexity floors below. */
+    private buildSignals;
+    /**
+     * A build prompt with REAL scale: multiple system-level deliverables, or a
+     * deliverable plus explicitly multi-part phrasing. Only these floor to the
+     * full T1→T2→T3 hierarchy — "create a todo app" is a build prompt too, but
+     * flooring every small build to Complex was the #1 token bomb (3-5 managers
+     * × workers for a task one worker handles).
+     */
     private looksClearlyComplex;
+    /** A small single-deliverable build — real work, but one manager's worth. */
+    private looksLikeModerateBuild;
     private static globCache;
     private countWorkspaceFiles;
     private determineComplexity;
@@ -2324,7 +2362,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;
@@ -2668,6 +2707,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;
@@ -2732,4 +2773,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

@@ -188,6 +188,13 @@ interface T3SubtaskSpec {
     peerT3Ids: string[];
     dependsOn?: string[];
     executionMode?: 'parallel' | 'sequential';
+    /** Spec slice: the exact file paths this subtask creates or edits. */
+    files?: string[];
+    /** Objectively verifiable acceptance checks for the subtask's output. */
+    acceptance?: string[];
+    /** The ONLY background the worker needs — workers see nothing else, so the
+     * planner must make it self-sufficient (keeps worker context minimal). */
+    contextBrief?: string;
 }
 interface T2ToT3Assignment {
     subtaskId: string;
@@ -200,6 +207,10 @@ interface T2ToT3Assignment {
     sectionTitle?: string;
     dependsOn?: string[];
     executionMode?: 'parallel' | 'sequential';
+    /** Spec slice fields — see T3SubtaskSpec. */
+    files?: string[];
+    acceptance?: string[];
+    contextBrief?: string;
 }
 interface StatusUpdate {
     progressPct: number;
@@ -1090,6 +1101,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[];
@@ -1549,11 +1568,19 @@ declare abstract class BaseTier extends EventEmitter {
      * which would interleave, are not tagged.
      */
     protected isPresenter: boolean;
+    /**
+     * The model actually serving this tier (`provider:id`), once resolved —
+     * rides on every tier:status event so the desktop can show which model ran
+     * which node (Cockpit node panel / Why panel).
+     */
+    protected servingModel?: string;
     constructor(role: TierRole, id?: string, parentId?: string);
     /** Mark this tier as the run's presenter (root tier). */
     setPresenter(on?: boolean): void;
     getStatus(): TierStatus;
     protected setStatus(status: TierStatus, output?: string): void;
+    /** Record the model serving this tier; future status events carry it. */
+    protected setServingModel(model: string | undefined): void;
     protected setLabel(label: string): void;
     setSystemPromptOverride(prompt: string): void;
     setHierarchyContext(context: string): void;
@@ -1900,7 +1927,18 @@ declare class Cascade extends EventEmitter {
      * explicit multi-part structure, so ordinary single-file asks (handled as
      * Simple/Moderate) don't get over-escalated.
      */
+    /** Shared build/scale signals for the complexity floors below. */
+    private buildSignals;
+    /**
+     * A build prompt with REAL scale: multiple system-level deliverables, or a
+     * deliverable plus explicitly multi-part phrasing. Only these floor to the
+     * full T1→T2→T3 hierarchy — "create a todo app" is a build prompt too, but
+     * flooring every small build to Complex was the #1 token bomb (3-5 managers
+     * × workers for a task one worker handles).
+     */
     private looksClearlyComplex;
+    /** A small single-deliverable build — real work, but one manager's worth. */
+    private looksLikeModerateBuild;
     private static globCache;
     private countWorkspaceFiles;
     private determineComplexity;
@@ -2324,7 +2362,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;
@@ -2668,6 +2707,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;
@@ -2732,4 +2773,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 };