cascade-ai 0.16.0 → 0.17.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.
package/dist/index.d.cts CHANGED
@@ -2361,6 +2361,17 @@ declare class DashboardSocket {
2361
2361
  private setupHandlers;
2362
2362
  onSessionRate(callback: (sessionId: string, rating: 'good' | 'bad') => void): void;
2363
2363
  onSessionHalt(callback: (sessionId: string) => void): void;
2364
+ /**
2365
+ * Boardroom plan decisions from a connected client. The desktop shows a
2366
+ * plan-review modal on `plan:approval-required` and answers here; the
2367
+ * server routes the decision into the paused run via resolvePlanApproval.
2368
+ */
2369
+ onPlanDecision(callback: (data: {
2370
+ sessionId: string;
2371
+ approved: boolean;
2372
+ note?: string;
2373
+ editedPlan?: unknown;
2374
+ }) => void): void;
2364
2375
  onSessionSteer(callback: (message: string, sessionId?: string, nodeId?: string) => void): void;
2365
2376
  onConfigUpdate(callback: (data: {
2366
2377
  keys?: Record<string, string>;
@@ -2400,6 +2411,14 @@ declare class DashboardServer {
2400
2411
  * map is how that answer reaches the run that's blocked on it.
2401
2412
  */
2402
2413
  private pendingApprovals;
2414
+ /**
2415
+ * The orchestration decision trail ("why") of each session's most recent
2416
+ * run — captured when the run ends so the desktop's Why panel can show it
2417
+ * after the fact. Bounded: oldest entry evicted past 50 sessions.
2418
+ */
2419
+ private whyBySession;
2420
+ /** Cron scheduler for the Schedules UI — runs tasks while this server is up. */
2421
+ private scheduler;
2403
2422
  private port;
2404
2423
  private host;
2405
2424
  private workspacePath;
@@ -2440,6 +2459,12 @@ declare class DashboardServer {
2440
2459
  private persistRunStart;
2441
2460
  /** Record run end: the assistant reply (when there is one) and the runtime row's final status. */
2442
2461
  private persistRunEnd;
2462
+ /**
2463
+ * Capture the run's decision trail + router economics ("why") and broadcast
2464
+ * it so the desktop's Why panel updates live; kept per-session for the
2465
+ * GET /api/sessions/:id/why fallback (panel opened after the run).
2466
+ */
2467
+ private captureWhy;
2443
2468
  /**
2444
2469
  * Route steering text into running Cascade instances. Targets the given
2445
2470
  * session, or every active session when none is specified (the desktop
@@ -2457,6 +2482,13 @@ declare class DashboardServer {
2457
2482
  * timeout denies it.
2458
2483
  */
2459
2484
  private makeApprovalCallback;
2485
+ /**
2486
+ * Execute one scheduled task firing. Runs headless (like `cascade run -p`):
2487
+ * tool approvals are auto-granted since nobody may be watching when the cron
2488
+ * fires — the Schedules UI states this. Events broadcast to every connected
2489
+ * client so an open desktop sees the run appear live.
2490
+ */
2491
+ private runScheduledTask;
2460
2492
  /** Deny + clear any approvals still pending for a session (run end / abort). */
2461
2493
  private denyPendingApprovals;
2462
2494
  private persistRuntimeRow;
package/dist/index.d.ts CHANGED
@@ -2361,6 +2361,17 @@ declare class DashboardSocket {
2361
2361
  private setupHandlers;
2362
2362
  onSessionRate(callback: (sessionId: string, rating: 'good' | 'bad') => void): void;
2363
2363
  onSessionHalt(callback: (sessionId: string) => void): void;
2364
+ /**
2365
+ * Boardroom plan decisions from a connected client. The desktop shows a
2366
+ * plan-review modal on `plan:approval-required` and answers here; the
2367
+ * server routes the decision into the paused run via resolvePlanApproval.
2368
+ */
2369
+ onPlanDecision(callback: (data: {
2370
+ sessionId: string;
2371
+ approved: boolean;
2372
+ note?: string;
2373
+ editedPlan?: unknown;
2374
+ }) => void): void;
2364
2375
  onSessionSteer(callback: (message: string, sessionId?: string, nodeId?: string) => void): void;
2365
2376
  onConfigUpdate(callback: (data: {
2366
2377
  keys?: Record<string, string>;
@@ -2400,6 +2411,14 @@ declare class DashboardServer {
2400
2411
  * map is how that answer reaches the run that's blocked on it.
2401
2412
  */
2402
2413
  private pendingApprovals;
2414
+ /**
2415
+ * The orchestration decision trail ("why") of each session's most recent
2416
+ * run — captured when the run ends so the desktop's Why panel can show it
2417
+ * after the fact. Bounded: oldest entry evicted past 50 sessions.
2418
+ */
2419
+ private whyBySession;
2420
+ /** Cron scheduler for the Schedules UI — runs tasks while this server is up. */
2421
+ private scheduler;
2403
2422
  private port;
2404
2423
  private host;
2405
2424
  private workspacePath;
@@ -2440,6 +2459,12 @@ declare class DashboardServer {
2440
2459
  private persistRunStart;
2441
2460
  /** Record run end: the assistant reply (when there is one) and the runtime row's final status. */
2442
2461
  private persistRunEnd;
2462
+ /**
2463
+ * Capture the run's decision trail + router economics ("why") and broadcast
2464
+ * it so the desktop's Why panel updates live; kept per-session for the
2465
+ * GET /api/sessions/:id/why fallback (panel opened after the run).
2466
+ */
2467
+ private captureWhy;
2443
2468
  /**
2444
2469
  * Route steering text into running Cascade instances. Targets the given
2445
2470
  * session, or every active session when none is specified (the desktop
@@ -2457,6 +2482,13 @@ declare class DashboardServer {
2457
2482
  * timeout denies it.
2458
2483
  */
2459
2484
  private makeApprovalCallback;
2485
+ /**
2486
+ * Execute one scheduled task firing. Runs headless (like `cascade run -p`):
2487
+ * tool approvals are auto-granted since nobody may be watching when the cron
2488
+ * fires — the Schedules UI states this. Events broadcast to every connected
2489
+ * client so an open desktop sees the run appear live.
2490
+ */
2491
+ private runScheduledTask;
2460
2492
  /** Deny + clear any approvals still pending for a session (run end / abort). */
2461
2493
  private denyPendingApprovals;
2462
2494
  private persistRuntimeRow;