cascade-ai 0.50.0 → 0.52.0

package/dist/index.d.cts

@@ -196,6 +196,18 @@ interface ToolExecuteOptions {
     tierId: string;
     sessionId: string;
     requireApproval: boolean;
+    /**
+     * Cancels a long-running tool call. Media generation can take a minute or
+     * more, so a cancelled run must be able to stop one mid-flight rather than
+     * paying it out and discarding the result.
+     */
+    signal?: AbortSignal;
+    /**
+     * Progress notes from a long-running tool. Video generation polls for minutes;
+     * without a channel back, a working render is indistinguishable from a hang —
+     * which is the most likely reason someone kills one.
+     */
+    onProgress?: (note: string) => void;
     saveSnapshot?: (filePath: string, content: string) => Promise<void>;
     sendPeerSync?: (to: string, syncType: PeerSyncType, content: string | Record<string, unknown>) => void;
     getPeerMessages?: () => Array<{
@@ -586,6 +598,12 @@ interface ToolsConfig {
      * behavior). An empty array registers no tools at all.
      */
     enabledTools?: string[];
+    /**
+     * Tools to remove even when they would otherwise be registered. Reaches
+     * tools registered outside `enabledTools` (MCP, media generation), which is
+     * the only way to switch those off.
+     */
+    disabledTools?: string[];
 }
 interface HooksConfig {
     preToolUse?: HookDefinition[];
@@ -647,6 +665,11 @@ interface BudgetConfig {
     maxTokensPerRun?: number;
     /** Optional hard per-task cost ceiling (USD). */
     maxCostPerRunUsd?: number;
+    /**
+     * Consecutive systemic failures against one model before the run stops
+     * launching work certain to fail the same way. Default 3.
+     */
+    failureThreshold?: number;
     warnAtPct: number;
 }
 interface WorkspaceConfig {
@@ -977,6 +1000,20 @@ declare class ModelPerformanceTracker {
     costEfficiencyScore(model: ModelInfo, complexity: 1 | 2 | 3 | 4 | 5): number;
 }
 
+interface FeedbackCounts {
+    good: number;
+    bad: number;
+}
+/**
+ * Lookup of per-model feedback, keyed by model id.
+ *
+ * Deliberately just counts: no conversation text, no prompts, no timestamps.
+ * A routing prior needs to know that a model earned N good and M bad verdicts
+ * and nothing else, and storing more would put chat content in a second place
+ * with different retention rules for no gain.
+ */
+type FeedbackSource = (modelId: string) => FeedbackCounts | undefined;
+
 type TaskType = 'code' | 'analysis' | 'creative' | 'data' | 'mixed';
 /** Cascade Auto cost/quality trade-off bias. See CascadeConfig.autoBias. */
 type AutoBias = 'balanced' | 'quality' | 'cost';
@@ -992,10 +1029,18 @@ interface TaskProfile {
 }
 declare class TaskAnalyzer {
     private tracker?;
+    /** Per-model thumbs counts, when the host collects them. */
+    private feedback?;
     private bias;
     private lastProfile;
     private lastSelectedModels;
     constructor(tracker?: ModelPerformanceTracker, bias?: AutoBias);
+    /**
+     * Supply per-model rating counts. Optional by design: a host that collects no
+     * feedback (the CLI, a fresh install) scores exactly as it did before, since
+     * feedbackAdjustment returns 0 for an empty record.
+     */
+    setFeedbackSource(source: FeedbackSource): void;
     setTracker(tracker: ModelPerformanceTracker): void;
     /** Change the cost/quality bias at runtime (e.g. when config reloads). */
     setBias(bias: AutoBias): void;
@@ -1463,6 +1508,7 @@ declare class CascadeRouter extends EventEmitter {
     private tpmLimiter;
     private localQueue;
     private taskAnalyzer?;
+    private pendingFeedbackSource?;
     private worldStateDB?;
     private privacyPaths?;
     private guidanceQueue?;
@@ -1578,6 +1624,12 @@ declare class CascadeRouter extends EventEmitter {
      */
     getReferenceContextWindow(): number | undefined;
     /** Wire the Cascade Auto task analyzer used for per-subtask model routing. */
+    /**
+     * Feed per-model thumbs counts into Auto routing. Forwarded to the analyzer
+     * because that is where the public benchmark score is combined; the prior
+     * adjusts that number rather than sitting anywhere else in the pipeline.
+     */
+    setFeedbackSource(source: FeedbackSource): void;
     setTaskAnalyzer(analyzer: TaskAnalyzer): void;
     setWorldStateDB(db: WorldStateDB | undefined): void;
     getWorldStateDB(): WorldStateDB | undefined;
@@ -2142,6 +2194,24 @@ declare class T1Administrator extends BaseTier {
     private evaluatePermissionAtT1;
 }
 
+interface GeneratedAsset {
+    /** Raw bytes of the asset. */
+    data: Buffer;
+    mimeType: string;
+    /** Suggested filename, extension included. */
+    filename: string;
+    modelId: string;
+    provider: string;
+    /** Provider-side revision of the prompt, when it reports one (DALL·E does). */
+    revisedPrompt?: string;
+}
+
+/**
+ * Where finished bytes go. Returns a short human-readable locator (a path, a
+ * file id, a URL) that the tool reports back to the model.
+ */
+type AssetSink = (asset: GeneratedAsset) => Promise<string>;
+
 /** One entry in the per-run orchestration decision trail (see /why). */
 interface DecisionLogEntry {
     at: string;
@@ -2151,6 +2221,8 @@ interface DecisionLogEntry {
 declare class Cascade extends EventEmitter {
     private router;
     private toolRegistry;
+    private multimodal;
+    private mediaSink?;
     private mcpClient;
     private codeIndex?;
     private config;
@@ -2236,6 +2308,36 @@ declare class Cascade extends EventEmitter {
      * Idempotent init guard, so it works before the first run.
      */
     previewPlan(prompt: string): Promise<TaskPlan>;
+    /**
+     * Register image / speech / transcription tools for the modalities this
+     * config can actually serve.
+     *
+     * The sink writes bytes into the workspace, because that is what a desktop or
+     * CLI run wants and it keeps a generated asset indistinguishable from any
+     * other file the run produced. A host with different storage (the cloud
+     * server stores a file row) constructs the tools itself via buildMediaTools
+     * with its own sink.
+     */
+    /**
+     * Replace where generated media is written.
+     *
+     * The default sink writes into the workspace, which is what a desktop or CLI
+     * run wants. A host with different storage — the cloud server keeps a file
+     * row plus bytes under the tenant's directory — supplies its own here, and
+     * the media tools are rebuilt around it. Re-registering by name replaces the
+     * existing tools rather than duplicating them.
+     */
+    setMediaSink(sink: AssetSink): void;
+    private registerMediaTools;
+    /**
+     * Supply per-model thumbs-up/down counts so Auto routing can weigh how models
+     * have actually performed for this user, on top of public benchmarks.
+     *
+     * Optional everywhere: with no source, or an empty record, scoring is
+     * byte-identical to before. The adjustment is capped and sample-size shrunk —
+     * see core/router/feedback-prior.ts.
+     */
+    setFeedbackSource(source: FeedbackSource): void;
     /** True when a task stopped at the budget cap and can be resumed via /continue. */
     hasResumableRun(): boolean;
     /**

package/dist/index.d.ts

@@ -196,6 +196,18 @@ interface ToolExecuteOptions {
     tierId: string;
     sessionId: string;
     requireApproval: boolean;
+    /**
+     * Cancels a long-running tool call. Media generation can take a minute or
+     * more, so a cancelled run must be able to stop one mid-flight rather than
+     * paying it out and discarding the result.
+     */
+    signal?: AbortSignal;
+    /**
+     * Progress notes from a long-running tool. Video generation polls for minutes;
+     * without a channel back, a working render is indistinguishable from a hang —
+     * which is the most likely reason someone kills one.
+     */
+    onProgress?: (note: string) => void;
     saveSnapshot?: (filePath: string, content: string) => Promise<void>;
     sendPeerSync?: (to: string, syncType: PeerSyncType, content: string | Record<string, unknown>) => void;
     getPeerMessages?: () => Array<{
@@ -586,6 +598,12 @@ interface ToolsConfig {
      * behavior). An empty array registers no tools at all.
      */
     enabledTools?: string[];
+    /**
+     * Tools to remove even when they would otherwise be registered. Reaches
+     * tools registered outside `enabledTools` (MCP, media generation), which is
+     * the only way to switch those off.
+     */
+    disabledTools?: string[];
 }
 interface HooksConfig {
     preToolUse?: HookDefinition[];
@@ -647,6 +665,11 @@ interface BudgetConfig {
     maxTokensPerRun?: number;
     /** Optional hard per-task cost ceiling (USD). */
     maxCostPerRunUsd?: number;
+    /**
+     * Consecutive systemic failures against one model before the run stops
+     * launching work certain to fail the same way. Default 3.
+     */
+    failureThreshold?: number;
     warnAtPct: number;
 }
 interface WorkspaceConfig {
@@ -977,6 +1000,20 @@ declare class ModelPerformanceTracker {
     costEfficiencyScore(model: ModelInfo, complexity: 1 | 2 | 3 | 4 | 5): number;
 }
 
+interface FeedbackCounts {
+    good: number;
+    bad: number;
+}
+/**
+ * Lookup of per-model feedback, keyed by model id.
+ *
+ * Deliberately just counts: no conversation text, no prompts, no timestamps.
+ * A routing prior needs to know that a model earned N good and M bad verdicts
+ * and nothing else, and storing more would put chat content in a second place
+ * with different retention rules for no gain.
+ */
+type FeedbackSource = (modelId: string) => FeedbackCounts | undefined;
+
 type TaskType = 'code' | 'analysis' | 'creative' | 'data' | 'mixed';
 /** Cascade Auto cost/quality trade-off bias. See CascadeConfig.autoBias. */
 type AutoBias = 'balanced' | 'quality' | 'cost';
@@ -992,10 +1029,18 @@ interface TaskProfile {
 }
 declare class TaskAnalyzer {
     private tracker?;
+    /** Per-model thumbs counts, when the host collects them. */
+    private feedback?;
     private bias;
     private lastProfile;
     private lastSelectedModels;
     constructor(tracker?: ModelPerformanceTracker, bias?: AutoBias);
+    /**
+     * Supply per-model rating counts. Optional by design: a host that collects no
+     * feedback (the CLI, a fresh install) scores exactly as it did before, since
+     * feedbackAdjustment returns 0 for an empty record.
+     */
+    setFeedbackSource(source: FeedbackSource): void;
     setTracker(tracker: ModelPerformanceTracker): void;
     /** Change the cost/quality bias at runtime (e.g. when config reloads). */
     setBias(bias: AutoBias): void;
@@ -1463,6 +1508,7 @@ declare class CascadeRouter extends EventEmitter {
     private tpmLimiter;
     private localQueue;
     private taskAnalyzer?;
+    private pendingFeedbackSource?;
     private worldStateDB?;
     private privacyPaths?;
     private guidanceQueue?;
@@ -1578,6 +1624,12 @@ declare class CascadeRouter extends EventEmitter {
      */
     getReferenceContextWindow(): number | undefined;
     /** Wire the Cascade Auto task analyzer used for per-subtask model routing. */
+    /**
+     * Feed per-model thumbs counts into Auto routing. Forwarded to the analyzer
+     * because that is where the public benchmark score is combined; the prior
+     * adjusts that number rather than sitting anywhere else in the pipeline.
+     */
+    setFeedbackSource(source: FeedbackSource): void;
     setTaskAnalyzer(analyzer: TaskAnalyzer): void;
     setWorldStateDB(db: WorldStateDB | undefined): void;
     getWorldStateDB(): WorldStateDB | undefined;
@@ -2142,6 +2194,24 @@ declare class T1Administrator extends BaseTier {
     private evaluatePermissionAtT1;
 }
 
+interface GeneratedAsset {
+    /** Raw bytes of the asset. */
+    data: Buffer;
+    mimeType: string;
+    /** Suggested filename, extension included. */
+    filename: string;
+    modelId: string;
+    provider: string;
+    /** Provider-side revision of the prompt, when it reports one (DALL·E does). */
+    revisedPrompt?: string;
+}
+
+/**
+ * Where finished bytes go. Returns a short human-readable locator (a path, a
+ * file id, a URL) that the tool reports back to the model.
+ */
+type AssetSink = (asset: GeneratedAsset) => Promise<string>;
+
 /** One entry in the per-run orchestration decision trail (see /why). */
 interface DecisionLogEntry {
     at: string;
@@ -2151,6 +2221,8 @@ interface DecisionLogEntry {
 declare class Cascade extends EventEmitter {
     private router;
     private toolRegistry;
+    private multimodal;
+    private mediaSink?;
     private mcpClient;
     private codeIndex?;
     private config;
@@ -2236,6 +2308,36 @@ declare class Cascade extends EventEmitter {
      * Idempotent init guard, so it works before the first run.
      */
     previewPlan(prompt: string): Promise<TaskPlan>;
+    /**
+     * Register image / speech / transcription tools for the modalities this
+     * config can actually serve.
+     *
+     * The sink writes bytes into the workspace, because that is what a desktop or
+     * CLI run wants and it keeps a generated asset indistinguishable from any
+     * other file the run produced. A host with different storage (the cloud
+     * server stores a file row) constructs the tools itself via buildMediaTools
+     * with its own sink.
+     */
+    /**
+     * Replace where generated media is written.
+     *
+     * The default sink writes into the workspace, which is what a desktop or CLI
+     * run wants. A host with different storage — the cloud server keeps a file
+     * row plus bytes under the tenant's directory — supplies its own here, and
+     * the media tools are rebuilt around it. Re-registering by name replaces the
+     * existing tools rather than duplicating them.
+     */
+    setMediaSink(sink: AssetSink): void;
+    private registerMediaTools;
+    /**
+     * Supply per-model thumbs-up/down counts so Auto routing can weigh how models
+     * have actually performed for this user, on top of public benchmarks.
+     *
+     * Optional everywhere: with no source, or an empty record, scoring is
+     * byte-identical to before. The adjustment is capped and sample-size shrunk —
+     * see core/router/feedback-prior.ts.
+     */
+    setFeedbackSource(source: FeedbackSource): void;
     /** True when a task stopped at the budget cap and can be resumed via /continue. */
     hasResumableRun(): boolean;
     /**