@adonis-agora/durable 1.0.0-rc.19 → 1.0.0-rc.20

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @adonis-agora/durable
 
+## 1.0.0-rc.20
+
+### Major Changes
+
+- [#522](https://github.com/DavideCarvalho/adonis-agora-durable/pull/522) [`74d8fed`](https://github.com/DavideCarvalho/adonis-agora-durable/commit/74d8fed9ebf899abd568331d73471eafcba0a8a0) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Everything the durable console does is now an ace command, running the console's own handlers (same validation, tenant scope, redaction and audit). New: `durable:runs:show`, `durable:runs:fan`, `durable:runs:values`, `durable:runs:event`, `durable:runs:replay`, `durable:runs:redispatch`, `durable:runs:cancel`, `durable:runs:continue`, `durable:runs:signal`, `durable:runs:update`, `durable:runs:bulk`, `durable:tasks:complete`, `durable:tasks:fail`, `durable:schedules`, `durable:schedules:pause`, `durable:schedules:resume`, `durable:schedules:trigger`, `durable:workers`, `durable:health` and `durable:workflows:lifecycle`. Lists and shows take `--json`; every command takes `--tenant` when tenancy is on; cancel, redispatch, task fail and bulk ask for confirmation unless `--force` (and refuse without a terminal), bulk has `--dry-run`. Actions are recorded through the console's `audit` hook with the actor `cli:<os user>` and the method `CLI`.
+  
+  Breaking: `durable:retry` is renamed `durable:runs:retry` (no alias). `durable:runs` reads through the console's `GET /runs`: it takes the console's filters (`--status` and `--workflow` accept several values, plus `--tag`, `--namespace`, `--origin`, `--attr`, `--created-after`, `--created-before`) and pages with `--page` / `--size` instead of `--limit`; bare `--stale` now parses. `durable:lifecycle:republish --run` goes through the console's republish route, so an unsettled run is refused. New `engine.flushControl()` waits for schedule pauses to reach the control plane.
+
 ## 1.0.0-rc.19
 
 ### Patch Changes

package/dist/commands/health.d.ts

@@ -0,0 +1,12 @@
+import { DurableConsoleCommand } from '../src/commands/console_command.js';
+/**
+ * `node ace durable:health` — per worker group the queue backlog and live workers (`stalled` is a
+ * backlog with no worker), and how many runs are pending, dead or blocked: the same report as the
+ * `durable_get_health` developer tool. Exit code 1 when a group is stalled.
+ */
+export default class DurableHealth extends DurableConsoleCommand {
+    static commandName: string;
+    static description: string;
+    protected perform(): Promise<void>;
+}
+//# sourceMappingURL=health.d.ts.map

package/dist/commands/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../commands/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAe,MAAM,oCAAoC,CAAC;AAGxF;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,qBAAqB;IAC9D,OAAgB,WAAW,SAAoB;IAC/C,OAAgB,WAAW,SAAkE;IAE7F,UAAgB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA0BvC;CACF"}

package/dist/commands/health.js

@@ -0,0 +1,34 @@
+import { DurableConsoleCommand, renderTable } from '../src/commands/console_command.js';
+import { fleetHealth } from '../src/dashboard/handlers.js';
+/**
+ * `node ace durable:health` — per worker group the queue backlog and live workers (`stalled` is a
+ * backlog with no worker), and how many runs are pending, dead or blocked: the same report as the
+ * `durable_get_health` developer tool. Exit code 1 when a group is stalled.
+ */
+export default class DurableHealth extends DurableConsoleCommand {
+    static commandName = 'durable:health';
+    static description = 'Fleet health: backlog and live workers per group, run counts';
+    async perform() {
+        const report = await fleetHealth(await this.deps());
+        const stalled = report.groups.filter((g) => g.stalled);
+        if (stalled.length > 0)
+            this.exitCode = 1;
+        if (this.json)
+            return this.printJson(report);
+        this.logger.log(report.groups.length === 0
+            ? 'No worker groups.'
+            : renderTable(['GROUP', 'DEPTH', 'LIVE WORKERS', 'STALLED'], report.groups.map((g) => [
+                g.group,
+                String(g.depth),
+                String(g.liveWorkers),
+                g.stalled ? 'yes' : 'no',
+            ])));
+        if (report.runs) {
+            this.logger.log(`runs: ${report.runs.pending} pending, ${report.runs.dead} dead, ${report.runs.blocked} blocked`);
+        }
+        for (const g of stalled) {
+            this.logger.warning(`group ${g.group} is stalled: ${g.depth} queued, no live worker`);
+        }
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/commands/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../commands/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,qBAAqB;IAC9D,MAAM,CAAU,WAAW,GAAG,gBAAgB,CAAC;IAC/C,MAAM,CAAU,WAAW,GAAG,8DAA8D,CAAC;IAEnF,KAAK,CAAC,OAAO;QACrB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YACxB,CAAC,CAAC,mBAAmB;YACrB,CAAC,CAAC,WAAW,CACT,CAAC,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,EAC7C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACvB,CAAC,CAAC,KAAK;gBACP,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;gBACf,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;gBACrB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;aACzB,CAAC,CACH,CACN,CAAC;QACF,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,SAAS,MAAM,CAAC,IAAI,CAAC,OAAO,aAAa,MAAM,CAAC,IAAI,CAAC,IAAI,UAAU,MAAM,CAAC,IAAI,CAAC,OAAO,UAAU,CACjG,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,KAAK,yBAAyB,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;CACF"}

package/dist/commands/lifecycle_republish.d.ts

@@ -1,16 +1,15 @@
-import { BaseCommand } from '@adonisjs/core/ace';
-import type { CommandOptions } from '@adonisjs/core/types/ace';
+import { DurableConsoleCommand } from '../src/commands/console_command.js';
 /**
  * `node ace durable:lifecycle:republish --run <id>` or `--workflow <name> [--since] [--until]` — publish
- * settled runs' lifecycle events again (`engine.republishLifecycle`). Backfills a subscriber
- * registered after the runs settled, or retries one that failed; a subscriber run that already
- * exists is not started again. Subscribers this app cannot deliver to are marked owed, for the
- * lifecycle sweep of an instance that can.
+ * settled runs' lifecycle events again. `--run` goes through the console's
+ * `POST /runs/:id/republish-lifecycle`; `--workflow` through the same port's `republishLifecycle`.
+ * Backfills a subscriber registered after the runs settled, or retries one that failed; a subscriber
+ * run that already exists is not started again. Subscribers this app cannot deliver to are marked
+ * owed, for the lifecycle sweep of an instance that can.
  */
-export default class DurableLifecycleRepublish extends BaseCommand {
+export default class DurableLifecycleRepublish extends DurableConsoleCommand {
     static commandName: string;
     static description: string;
-    static options: CommandOptions;
     runId?: string;
     workflow?: string;
     since?: string;
@@ -18,6 +17,6 @@ export default class DurableLifecycleRepublish extends BaseCommand {
     kind?: string;
     limit?: number;
     subscriber?: string;
-    run(): Promise<void>;
+    protected perform(): Promise<void>;
 }
 //# sourceMappingURL=lifecycle_republish.d.ts.map

package/dist/commands/lifecycle_republish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle_republish.d.ts","sourceRoot":"","sources":["../../commands/lifecycle_republish.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,WAAW;IAChE,OAAgB,WAAW,SAAiC;IAC5D,OAAgB,WAAW,SAAkD;IAC7E,OAAgB,OAAO,EAAE,cAAc,CAAsB;IAGrD,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,UAAU,CAAC,EAAE,MAAM,CAAC;IAEb,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBlC;CACF"}
+{"version":3,"file":"lifecycle_republish.d.ts","sourceRoot":"","sources":["../../commands/lifecycle_republish.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAKvF;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,qBAAqB;IAC1E,OAAgB,WAAW,SAAiC;IAC5D,OAAgB,WAAW,SAAkD;IAGrE,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,UAAU,CAAC,EAAE,MAAM,CAAC;IAE5B,UAAgB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAgCvC;CACF"}

package/dist/commands/lifecycle_republish.js

@@ -4,21 +4,22 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { BaseCommand, flags } from '@adonisjs/core/ace';
+import { flags } from '@adonisjs/core/ace';
+import { CliRefusal, DurableConsoleCommand } from '../src/commands/console_command.js';
 import { renderRepublishResult, republishLifecycleTarget } from '../src/commands/runs.js';
-import { WorkflowEngine } from '../src/index.js';
+import { republishLifecycleRun } from '../src/dashboard/handlers.js';
 /**
  * `node ace durable:lifecycle:republish --run <id>` or `--workflow <name> [--since] [--until]` — publish
- * settled runs' lifecycle events again (`engine.republishLifecycle`). Backfills a subscriber
- * registered after the runs settled, or retries one that failed; a subscriber run that already
- * exists is not started again. Subscribers this app cannot deliver to are marked owed, for the
- * lifecycle sweep of an instance that can.
+ * settled runs' lifecycle events again. `--run` goes through the console's
+ * `POST /runs/:id/republish-lifecycle`; `--workflow` through the same port's `republishLifecycle`.
+ * Backfills a subscriber registered after the runs settled, or retries one that failed; a subscriber
+ * run that already exists is not started again. Subscribers this app cannot deliver to are marked
+ * owed, for the lifecycle sweep of an instance that can.
  */
-export default class DurableLifecycleRepublish extends BaseCommand {
+export default class DurableLifecycleRepublish extends DurableConsoleCommand {
     static commandName = 'durable:lifecycle:republish';
     static description = "Publish settled runs' lifecycle events again";
-    static options = { startApp: true };
-    async run() {
+    async perform() {
         const target = republishLifecycleTarget({
             run: this.runId,
             workflow: this.workflow,
@@ -28,16 +29,28 @@ export default class DurableLifecycleRepublish extends BaseCommand {
             limit: this.limit,
             subscriber: this.subscriber,
         });
-        if ('error' in target) {
-            this.logger.error(target.error);
-            this.exitCode = 1;
-            return;
+        if ('error' in target)
+            throw new CliRefusal(target.error);
+        const deps = await this.deps();
+        this.audit('runId' in target ? target.runId : `workflow ${target.workflow}`);
+        let result;
+        if ('runId' in target) {
+            ({ result } = await this.call(republishLifecycleRun, {
+                params: { id: target.runId },
+                body: target.subscriber ? { subscriber: target.subscriber } : {},
+            }, deps));
+        }
+        else {
+            if (!deps.engine.republishLifecycle) {
+                throw new CliRefusal('republish is unavailable on this topology');
+            }
+            result = await deps.engine.republishLifecycle(target);
         }
-        const engine = await this.app.container.make(WorkflowEngine);
-        const result = await engine.republishLifecycle(target);
-        this.logger.info(renderRepublishResult(result));
         if (result.failed.length > 0)
             this.exitCode = 1;
+        if (this.json)
+            return this.printJson({ result });
+        this.logger.info(renderRepublishResult(result));
     }
 }
 __decorate([

package/dist/commands/lifecycle_republish.js.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle_republish.js","sourceRoot":"","sources":["../../commands/lifecycle_republish.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,WAAW;IAChE,MAAM,CAAU,WAAW,GAAG,6BAA6B,CAAC;IAC5D,MAAM,CAAU,WAAW,GAAG,8CAA8C,CAAC;IAC7E,MAAM,CAAU,OAAO,GAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAuBpD,KAAK,CAAC,GAAG;QAChB,MAAM,MAAM,GAAG,wBAAwB,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,KAAK;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;QACH,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;QAChD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IAClD,CAAC;CACF;AAxCS;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;wDAC9C;AAGf;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC;2DAC1C;AAGlB;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,8DAA8D,EAAE,CAAC;wDACvE;AAGf;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+DAA+D,EAAE,CAAC;wDACxE;AAGf;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yDAAyD,EAAE,CAAC;uDACnE;AAGd;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,wDAAwD,EAAE,CAAC;wDACjE;AAGf;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gCAAgC,EAAE,CAAC;6DACpC"}
+{"version":3,"file":"lifecycle_republish.js","sourceRoot":"","sources":["../../commands/lifecycle_republish.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAGrE;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,OAAO,yBAA0B,SAAQ,qBAAqB;IAC1E,MAAM,CAAU,WAAW,GAAG,6BAA6B,CAAC;IAC5D,MAAM,CAAU,WAAW,GAAG,8CAA8C,CAAC;IAuBnE,KAAK,CAAC,OAAO;QACrB,MAAM,MAAM,GAAG,wBAAwB,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,KAAK;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;QACH,IAAI,OAAO,IAAI,MAAM;YAAE,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7E,IAAI,MAAgC,CAAC;QACrC,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACtB,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAC3B,qBAAqB,EACrB;gBACE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE;gBAC5B,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE;aACjE,EACD,IAAI,CACL,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBACpC,MAAM,IAAI,UAAU,CAAC,2CAA2C,CAAC,CAAC;YACpE,CAAC;YACD,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;CACF;AArDS;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC;wDAC9C;AAGf;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC;2DAC1C;AAGlB;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,8DAA8D,EAAE,CAAC;wDACvE;AAGf;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+DAA+D,EAAE,CAAC;wDACxE;AAGf;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yDAAyD,EAAE,CAAC;uDACnE;AAGd;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,wDAAwD,EAAE,CAAC;wDACjE;AAGf;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gCAAgC,EAAE,CAAC;6DACpC"}

package/dist/commands/main.d.ts

@@ -1,20 +1,39 @@
 import { ListLoader } from '@adonisjs/core/ace';
 import AgoraDoctor from './agora_doctor.js';
 import DurableWorker from './durable_worker.js';
+import DurableExport from './export_run.js';
+import DurableHealth from './health.js';
 import DurableLifecycleRepublish from './lifecycle_republish.js';
 import MakeWorkflow from './make_workflow.js';
-import DurableRetry from './retry.js';
 import DurableRuns from './runs.js';
+import DurableRunsBulk from './runs_bulk.js';
+import DurableRunsCancel from './runs_cancel.js';
+import DurableRunsContinue from './runs_continue.js';
+import DurableRunsEvent from './runs_event.js';
+import DurableRunsFan from './runs_fan.js';
+import DurableRunsRedispatch from './runs_redispatch.js';
+import DurableRunsReplay from './runs_replay.js';
+import DurableRunsRetry from './runs_retry.js';
+import DurableRunsShow from './runs_show.js';
+import DurableRunsSignal from './runs_signal.js';
+import DurableRunsValues from './runs_values.js';
+import DurableSchedules from './schedules.js';
+import DurableSchedulesPause from './schedules_pause.js';
+import DurableSchedulesTrigger from './schedules_trigger.js';
 import DurableWork from './work.js';
+import DurableWorkers from './workers.js';
 /**
  * The commands barrel for `@adonis-agora/durable`. Registered in an app's `adonisrc` via
  * `rcFile.addCommand('@adonis-agora/durable/commands')` (done by this package's `configure`). The ace
  * kernel imports this module and treats it as a commands loader: a {@link ListLoader} over the durable
- * commands (`durable:work`, `durable:worker`, `durable:runs`, `durable:retry`, `durable:export`, `durable:lifecycle:republish`, `make:workflow`, `agora:doctor`, `durable:doctor`)
- * provides their metadata and constructors.
+ * commands — the workers (`durable:work`, `durable:worker`), the operator commands that mirror the
+ * console (`durable:runs*`, `durable:tasks:*`, `durable:schedules*`, `durable:workers`,
+ * `durable:health`, `durable:workflows:lifecycle`, `durable:lifecycle:republish`), `durable:export`,
+ * `make:workflow`, `agora:doctor` and `durable:doctor`.
  */
-declare const loader: ListLoader<typeof AgoraDoctor | typeof DurableWorker | typeof DurableLifecycleRepublish | typeof MakeWorkflow | typeof DurableRetry | typeof DurableRuns | typeof DurableWork>;
+export declare const DURABLE_COMMANDS: (typeof AgoraDoctor | typeof DurableWorker | typeof DurableExport | typeof DurableHealth | typeof DurableLifecycleRepublish | typeof MakeWorkflow | typeof DurableRuns | typeof DurableRunsBulk | typeof DurableRunsCancel | typeof DurableRunsContinue | typeof DurableRunsEvent | typeof DurableRunsFan | typeof DurableRunsRedispatch | typeof DurableRunsReplay | typeof DurableRunsRetry | typeof DurableRunsShow | typeof DurableRunsSignal | typeof DurableRunsValues | typeof DurableSchedules | typeof DurableSchedulesPause | typeof DurableSchedulesTrigger | typeof DurableWork | typeof DurableWorkers)[];
+declare const loader: ListLoader<typeof AgoraDoctor | typeof DurableWorker | typeof DurableExport | typeof DurableHealth | typeof DurableLifecycleRepublish | typeof MakeWorkflow | typeof DurableRuns | typeof DurableRunsBulk | typeof DurableRunsCancel | typeof DurableRunsContinue | typeof DurableRunsEvent | typeof DurableRunsFan | typeof DurableRunsRedispatch | typeof DurableRunsReplay | typeof DurableRunsRetry | typeof DurableRunsShow | typeof DurableRunsSignal | typeof DurableRunsValues | typeof DurableSchedules | typeof DurableSchedulesPause | typeof DurableSchedulesTrigger | typeof DurableWork | typeof DurableWorkers>;
 export declare const getMetaData: () => Promise<import("@adonisjs/core/types/ace").CommandMetaData[]>;
-export declare const getCommand: (metaData: import("@adonisjs/core/types/ace").CommandMetaData) => Promise<typeof AgoraDoctor | typeof DurableWorker | typeof DurableLifecycleRepublish | typeof MakeWorkflow | typeof DurableRetry | typeof DurableRuns | typeof DurableWork | null>;
+export declare const getCommand: (metaData: import("@adonisjs/core/types/ace").CommandMetaData) => Promise<typeof AgoraDoctor | typeof DurableWorker | typeof DurableExport | typeof DurableHealth | typeof DurableLifecycleRepublish | typeof MakeWorkflow | typeof DurableRuns | typeof DurableRunsBulk | typeof DurableRunsCancel | typeof DurableRunsContinue | typeof DurableRunsEvent | typeof DurableRunsFan | typeof DurableRunsRedispatch | typeof DurableRunsReplay | typeof DurableRunsRetry | typeof DurableRunsShow | typeof DurableRunsSignal | typeof DurableRunsValues | typeof DurableSchedules | typeof DurableSchedulesPause | typeof DurableSchedulesTrigger | typeof DurableWork | typeof DurableWorkers | null>;
 export default loader;
 //# sourceMappingURL=main.d.ts.map

package/dist/commands/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAE5C,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAEhD,OAAO,yBAAyB,MAAM,0BAA0B,CAAC;AACjE,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,YAAY,MAAM,YAAY,CAAC;AACtC,OAAO,WAAW,MAAM,WAAW,CAAC;AACpC,OAAO,WAAW,MAAM,WAAW,CAAC;AAEpC;;;;;;GAMG;AACH,QAAA,MAAM,MAAM,gLAUV,CAAC;AAEH,eAAO,MAAM,WAAW,qEAAkC,CAAC;AAC3D,eAAO,MAAM,UAAU,sPAAiC,CAAC;eAE1C,MAAM"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAE5C,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAChD,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,aAAa,MAAM,aAAa,CAAC;AACxC,OAAO,yBAAyB,MAAM,0BAA0B,CAAC;AACjE,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,WAAW,MAAM,WAAW,CAAC;AACpC,OAAO,eAAe,MAAM,gBAAgB,CAAC;AAC7C,OAAO,iBAAiB,MAAM,kBAAkB,CAAC;AACjD,OAAO,mBAAmB,MAAM,oBAAoB,CAAC;AACrD,OAAO,gBAAgB,MAAM,iBAAiB,CAAC;AAC/C,OAAO,cAAc,MAAM,eAAe,CAAC;AAC3C,OAAO,qBAAqB,MAAM,sBAAsB,CAAC;AACzD,OAAO,iBAAiB,MAAM,kBAAkB,CAAC;AACjD,OAAO,gBAAgB,MAAM,iBAAiB,CAAC;AAC/C,OAAO,eAAe,MAAM,gBAAgB,CAAC;AAC7C,OAAO,iBAAiB,MAAM,kBAAkB,CAAC;AAEjD,OAAO,iBAAiB,MAAM,kBAAkB,CAAC;AACjD,OAAO,gBAAgB,MAAM,gBAAgB,CAAC;AAC9C,OAAO,qBAAqB,MAAM,sBAAsB,CAAC;AAEzD,OAAO,uBAAuB,MAAM,wBAAwB,CAAC;AAG7D,OAAO,WAAW,MAAM,WAAW,CAAC;AACpC,OAAO,cAAc,MAAM,cAAc,CAAC;AAG1C;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,wlBA8B5B,CAAC;AAEF,QAAA,MAAM,MAAM,gmBAAmC,CAAC;AAEhD,eAAO,MAAM,WAAW,qEAAkC,CAAC;AAC3D,eAAO,MAAM,UAAU,sqBAAiC,CAAC;eAE1C,MAAM"}

package/dist/commands/main.js

@@ -3,29 +3,72 @@ import AgoraDoctor from './agora_doctor.js';
 import DurableDoctor from './durable_doctor.js';
 import DurableWorker from './durable_worker.js';
 import DurableExport from './export_run.js';
+import DurableHealth from './health.js';
 import DurableLifecycleRepublish from './lifecycle_republish.js';
 import MakeWorkflow from './make_workflow.js';
-import DurableRetry from './retry.js';
 import DurableRuns from './runs.js';
+import DurableRunsBulk from './runs_bulk.js';
+import DurableRunsCancel from './runs_cancel.js';
+import DurableRunsContinue from './runs_continue.js';
+import DurableRunsEvent from './runs_event.js';
+import DurableRunsFan from './runs_fan.js';
+import DurableRunsRedispatch from './runs_redispatch.js';
+import DurableRunsReplay from './runs_replay.js';
+import DurableRunsRetry from './runs_retry.js';
+import DurableRunsShow from './runs_show.js';
+import DurableRunsSignal from './runs_signal.js';
+import DurableRunsUpdate from './runs_update.js';
+import DurableRunsValues from './runs_values.js';
+import DurableSchedules from './schedules.js';
+import DurableSchedulesPause from './schedules_pause.js';
+import DurableSchedulesResume from './schedules_resume.js';
+import DurableSchedulesTrigger from './schedules_trigger.js';
+import DurableTasksComplete from './tasks_complete.js';
+import DurableTasksFail from './tasks_fail.js';
 import DurableWork from './work.js';
+import DurableWorkers from './workers.js';
+import DurableWorkflowsLifecycle from './workflows_lifecycle.js';
 /**
  * The commands barrel for `@adonis-agora/durable`. Registered in an app's `adonisrc` via
  * `rcFile.addCommand('@adonis-agora/durable/commands')` (done by this package's `configure`). The ace
  * kernel imports this module and treats it as a commands loader: a {@link ListLoader} over the durable
- * commands (`durable:work`, `durable:worker`, `durable:runs`, `durable:retry`, `durable:export`, `durable:lifecycle:republish`, `make:workflow`, `agora:doctor`, `durable:doctor`)
- * provides their metadata and constructors.
+ * commands — the workers (`durable:work`, `durable:worker`), the operator commands that mirror the
+ * console (`durable:runs*`, `durable:tasks:*`, `durable:schedules*`, `durable:workers`,
+ * `durable:health`, `durable:workflows:lifecycle`, `durable:lifecycle:republish`), `durable:export`,
+ * `make:workflow`, `agora:doctor` and `durable:doctor`.
  */
-const loader = new ListLoader([
+export const DURABLE_COMMANDS = [
     DurableWork,
     DurableWorker,
     DurableRuns,
-    DurableRetry,
-    DurableExport,
+    DurableRunsShow,
+    DurableRunsFan,
+    DurableRunsValues,
+    DurableRunsEvent,
+    DurableRunsRetry,
+    DurableRunsReplay,
+    DurableRunsRedispatch,
+    DurableRunsCancel,
+    DurableRunsContinue,
+    DurableRunsSignal,
+    DurableRunsUpdate,
+    DurableRunsBulk,
+    DurableTasksComplete,
+    DurableTasksFail,
+    DurableSchedules,
+    DurableSchedulesPause,
+    DurableSchedulesResume,
+    DurableSchedulesTrigger,
+    DurableWorkers,
+    DurableHealth,
+    DurableWorkflowsLifecycle,
     DurableLifecycleRepublish,
+    DurableExport,
     MakeWorkflow,
     AgoraDoctor,
     DurableDoctor,
-]);
+];
+const loader = new ListLoader(DURABLE_COMMANDS);
 export const getMetaData = loader.getMetaData.bind(loader);
 export const getCommand = loader.getCommand.bind(loader);
 export default loader;

package/dist/commands/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAC5C,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAChD,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAChD,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,yBAAyB,MAAM,0BAA0B,CAAC;AACjE,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,YAAY,MAAM,YAAY,CAAC;AACtC,OAAO,WAAW,MAAM,WAAW,CAAC;AACpC,OAAO,WAAW,MAAM,WAAW,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC;IAC5B,WAAW;IACX,aAAa;IACb,WAAW;IACX,YAAY;IACZ,aAAa;IACb,yBAAyB;IACzB,YAAY;IACZ,WAAW;IACX,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAe,MAAM,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAC5C,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAChD,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAChD,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,aAAa,MAAM,aAAa,CAAC;AACxC,OAAO,yBAAyB,MAAM,0BAA0B,CAAC;AACjE,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,WAAW,MAAM,WAAW,CAAC;AACpC,OAAO,eAAe,MAAM,gBAAgB,CAAC;AAC7C,OAAO,iBAAiB,MAAM,kBAAkB,CAAC;AACjD,OAAO,mBAAmB,MAAM,oBAAoB,CAAC;AACrD,OAAO,gBAAgB,MAAM,iBAAiB,CAAC;AAC/C,OAAO,cAAc,MAAM,eAAe,CAAC;AAC3C,OAAO,qBAAqB,MAAM,sBAAsB,CAAC;AACzD,OAAO,iBAAiB,MAAM,kBAAkB,CAAC;AACjD,OAAO,gBAAgB,MAAM,iBAAiB,CAAC;AAC/C,OAAO,eAAe,MAAM,gBAAgB,CAAC;AAC7C,OAAO,iBAAiB,MAAM,kBAAkB,CAAC;AACjD,OAAO,iBAAiB,MAAM,kBAAkB,CAAC;AACjD,OAAO,iBAAiB,MAAM,kBAAkB,CAAC;AACjD,OAAO,gBAAgB,MAAM,gBAAgB,CAAC;AAC9C,OAAO,qBAAqB,MAAM,sBAAsB,CAAC;AACzD,OAAO,sBAAsB,MAAM,uBAAuB,CAAC;AAC3D,OAAO,uBAAuB,MAAM,wBAAwB,CAAC;AAC7D,OAAO,oBAAoB,MAAM,qBAAqB,CAAC;AACvD,OAAO,gBAAgB,MAAM,iBAAiB,CAAC;AAC/C,OAAO,WAAW,MAAM,WAAW,CAAC;AACpC,OAAO,cAAc,MAAM,cAAc,CAAC;AAC1C,OAAO,yBAAyB,MAAM,0BAA0B,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,WAAW;IACX,aAAa;IACb,WAAW;IACX,eAAe;IACf,cAAc;IACd,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,qBAAqB;IACrB,iBAAiB;IACjB,mBAAmB;IACnB,iBAAiB;IACjB,iBAAiB;IACjB,eAAe;IACf,oBAAoB;IACpB,gBAAgB;IAChB,gBAAgB;IAChB,qBAAqB;IACrB,sBAAsB;IACtB,uBAAuB;IACvB,cAAc;IACd,aAAa;IACb,yBAAyB;IACzB,yBAAyB;IACzB,aAAa;IACb,YAAY;IACZ,WAAW;IACX,aAAa;CACd,CAAC;AAEF,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,gBAAgB,CAAC,CAAC;AAEhD,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAe,MAAM,CAAC"}

package/dist/commands/runs.d.ts

@@ -1,23 +1,16 @@
-import { BaseCommand } from '@adonisjs/core/ace';
-import type { CommandOptions } from '@adonisjs/core/types/ace';
+import { RunFilterCommand } from '../src/commands/console_command.js';
 /**
- * `node ace durable:runs` — list recent workflow runs, optionally filtered by status and workflow.
- * Reads through the engine's read API (`engine.listRuns`/`engine.listCheckpoints`); for the listing to
- * show runs across processes the engine must be backed by a persistent store (config/durable.ts).
- *
- * Every row also carries liveness signals (UPDATED age, RECOVERY attempts, PENDING remote-step age) —
- * `suspended` alone can't tell a run mid-step apart from one whose dispatch was lost (see
- * `src/commands/runs.ts`'s module doc). `--stale` narrows the listing to exactly the runs that look
- * stranded by that signal.
+ * `node ace durable:runs` — list runs, newest first, through the console's `GET /runs` handler (same
+ * filters, paging, tenant scope and redaction). Every row carries liveness signals (UPDATED age,
+ * RECOVERY attempts, PENDING remote-step age); `--stale` narrows the page to the runs that look
+ * stranded by them.
  */
-export default class DurableRuns extends BaseCommand {
+export default class DurableRuns extends RunFilterCommand {
     static commandName: string;
     static description: string;
-    static options: CommandOptions;
-    status?: string;
-    workflow?: string;
-    limit: number;
+    page?: number;
+    size?: number;
     stale?: string;
-    run(): Promise<void>;
+    protected perform(): Promise<void>;
 }
 //# sourceMappingURL=runs.d.ts.map

package/dist/commands/runs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../commands/runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAS,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAY/D;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,WAAW,SAAkB;IAC7C,OAAgB,WAAW,SAAuC;IAClE,OAAgB,OAAO,EAAE,cAAc,CAAsB;IAKrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,KAAK,EAAE,MAAM,CAAC;IAQd,KAAK,CAAC,EAAE,MAAM,CAAC;IAER,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BlC;CACF"}
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../commands/runs.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAsBlF;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,gBAAgB;IACvD,OAAgB,WAAW,SAAkB;IAC7C,OAAgB,WAAW,SAA2D;IAG9E,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,IAAI,CAAC,EAAE,MAAM,CAAC;IAQd,KAAK,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAgB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAuDvC;CACF"}

package/dist/commands/runs.js

@@ -4,67 +4,78 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { BaseCommand, flags } from '@adonisjs/core/ace';
-import { attachLiveness, DEFAULT_STALE_MS, filterStale, listRuns, parseDurationMs, renderRunsTable, staleHint, } from '../src/commands/runs.js';
-import { WorkflowEngine } from '../src/index.js';
+import { flags } from '@adonisjs/core/ace';
+import { pageFooter, RunFilterCommand } from '../src/commands/console_command.js';
+import { attachLiveness, DEFAULT_STALE_MS, filterStale, parseDurationMs, renderRunsTable, staleHint, } from '../src/commands/runs.js';
+import { listRuns } from '../src/dashboard/handlers.js';
 /**
- * `node ace durable:runs` — list recent workflow runs, optionally filtered by status and workflow.
- * Reads through the engine's read API (`engine.listRuns`/`engine.listCheckpoints`); for the listing to
- * show runs across processes the engine must be backed by a persistent store (config/durable.ts).
- *
- * Every row also carries liveness signals (UPDATED age, RECOVERY attempts, PENDING remote-step age) —
- * `suspended` alone can't tell a run mid-step apart from one whose dispatch was lost (see
- * `src/commands/runs.ts`'s module doc). `--stale` narrows the listing to exactly the runs that look
- * stranded by that signal.
+ * `node ace durable:runs` — list runs, newest first, through the console's `GET /runs` handler (same
+ * filters, paging, tenant scope and redaction). Every row carries liveness signals (UPDATED age,
+ * RECOVERY attempts, PENDING remote-step age); `--stale` narrows the page to the runs that look
+ * stranded by them.
  */
-export default class DurableRuns extends BaseCommand {
+export default class DurableRuns extends RunFilterCommand {
     static commandName = 'durable:runs';
-    static description = 'List recent durable workflow runs';
-    static options = { startApp: true };
-    async run() {
-        const engine = await this.app.container.make(WorkflowEngine);
+    static description = 'List durable workflow runs (filters, paging, --stale)';
+    async perform() {
         const wantsStale = this.stale !== undefined;
-        const runs = await listRuns(engine, {
-            ...(this.status ? { status: this.status } : {}),
-            // No explicit --status: scope the query to running/suspended/cancelling, the only statuses a stranded
-            // dispatch can show up in, so a stale candidate isn't pushed out of the window by newer
-            // terminal runs.
-            ...(!this.status && wantsStale
-                ? { statuses: ['running', 'suspended', 'cancelling'] }
-                : {}),
-            ...(this.workflow ? { workflow: this.workflow } : {}),
-            limit: this.limit,
-        });
-        const liveRuns = await attachLiveness(engine, runs);
-        if (!wantsStale) {
-            this.logger.log(renderRunsTable(liveRuns));
+        const query = this.runFilter();
+        // No explicit --status: `--stale` reads the only statuses a stranded dispatch shows up in, so
+        // newer terminal runs don't push a stale candidate off the page.
+        if (wantsStale && !query.filter?.status) {
+            query.filter = { ...query.filter, status: ['running', 'suspended', 'cancelling'] };
+        }
+        const deps = await this.deps();
+        const body = await this.call(listRuns, {
+            query: {
+                ...query,
+                ...(this.page !== undefined ? { page: String(this.page) } : {}),
+                ...(this.size !== undefined ? { size: String(this.size) } : {}),
+            },
+        }, deps);
+        // The liveness columns read each in-flight run's checkpoints through the same port.
+        const runs = body.data.map((row) => ({ ...row, updatedAt: new Date(row.updatedAt) }));
+        const lister = {
+            listRuns: async () => runs,
+            listCheckpoints: (id) => deps.engine.listCheckpoints(id),
+        };
+        let live = await attachLiveness(lister, runs);
+        if (wantsStale) {
+            const threshold = this.stale === ''
+                ? DEFAULT_STALE_MS
+                : (parseDurationMs(this.stale ?? '') ?? DEFAULT_STALE_MS);
+            live = filterStale(live, threshold);
+        }
+        if (this.json) {
+            const kept = new Set(live.map((l) => l.run.id));
+            const liveness = new Map(live.map((l) => [l.run.id, l.stalePending]));
+            this.printJson({
+                data: body.data
+                    .filter((row) => kept.has(row.id))
+                    .map((row) => ({ ...row, pending: liveness.get(row.id) ?? null })),
+                meta: body.meta,
+            });
             return;
         }
-        const thresholdMs = this.stale === ''
-            ? DEFAULT_STALE_MS
-            : (parseDurationMs(this.stale ?? '') ?? DEFAULT_STALE_MS);
-        const stale = filterStale(liveRuns, thresholdMs);
-        this.logger.log(renderRunsTable(stale));
-        for (const { run } of stale)
-            this.logger.warning(staleHint(run.id));
+        this.logger.log(renderRunsTable(live));
+        if (live.length > 0 || body.meta.total > 0)
+            this.logger.log(pageFooter(body.meta));
+        if (wantsStale)
+            for (const { run } of live)
+                this.logger.warning(staleHint(run.id));
     }
 }
 __decorate([
-    flags.string({
-        description: 'Filter by status (pending|running|suspended|completed|failed|cancelled|dead)',
-    })
-], DurableRuns.prototype, "status", void 0);
-__decorate([
-    flags.string({ description: 'Filter by workflow name' })
-], DurableRuns.prototype, "workflow", void 0);
+    flags.number({ description: 'Page, 1-based (default 1)' })
+], DurableRuns.prototype, "page", void 0);
 __decorate([
-    flags.number({ description: 'Max runs to list', default: 50 })
-], DurableRuns.prototype, "limit", void 0);
+    flags.number({ description: 'Rows per page (default 50, at most 200)' })
+], DurableRuns.prototype, "size", void 0);
 __decorate([
     flags.string({
-        description: 'List only running/suspended runs whose oldest pending remote step exceeds this age — the ' +
-            '"probably stranded" view. Pass bare --stale for the default threshold (15m), or a duration ' +
-            'like --stale=1h / --stale=90s for a custom one.',
+        allowEmptyValue: true,
+        description: 'Only running/suspended/cancelling runs whose oldest pending remote step exceeds this age (the ' +
+            '"probably stranded" view). Bare --stale uses 15m; --stale=1h / --stale=90s set your own.',
     })
 ], DurableRuns.prototype, "stale", void 0);
 //# sourceMappingURL=runs.js.map

package/dist/commands/runs.js.map

@@ -1 +1 @@
-{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../commands/runs.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,eAAe,EACf,eAAe,EACf,SAAS,GACV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAkB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjE;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,MAAM,CAAU,WAAW,GAAG,cAAc,CAAC;IAC7C,MAAM,CAAU,WAAW,GAAG,mCAAmC,CAAC;IAClE,MAAM,CAAU,OAAO,GAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAqBpD,KAAK,CAAC,GAAG;QAChB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE;YAClC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,sGAAsG;YACtG,wFAAwF;YACxF,iBAAiB;YACjB,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,UAAU;gBAC5B,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAgB,EAAE;gBACrE,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAEpD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GACf,IAAI,CAAC,KAAK,KAAK,EAAE;YACf,CAAC,CAAC,gBAAgB;YAClB,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,gBAAgB,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,KAAK;YAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC;CACF;AA7CS;IAHP,KAAK,CAAC,MAAM,CAAC;QACZ,WAAW,EAAE,8EAA8E;KAC5F,CAAC;2CACsB;AAGhB;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;6CAC/B;AAGlB;IADP,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;0CACzC;AAQd;IANP,KAAK,CAAC,MAAM,CAAC;QACZ,WAAW,EACT,2FAA2F;YAC3F,6FAA6F;YAC7F,iDAAiD;KACpD,CAAC;0CACqB"}
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../commands/runs.ts"],"names":[],"mappings":"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"}

package/dist/commands/runs_bulk.d.ts

@@ -0,0 +1,17 @@
+import { RunFilterCommand } from '../src/commands/console_command.js';
+/**
+ * `node ace durable:runs:bulk <retry|cancel> [filters]` — retry or cancel every run matching the
+ * filters (at most 500), through the console's `POST /bulk/:action`. A run that cannot take the
+ * action is skipped. `--dry-run` lists what would be acted on; otherwise it asks first (`--force`
+ * skips).
+ */
+export default class DurableRunsBulk extends RunFilterCommand {
+    static commandName: string;
+    static description: string;
+    action: string;
+    compensate: boolean;
+    dryRun: boolean;
+    force: boolean;
+    protected perform(): Promise<void>;
+}
+//# sourceMappingURL=runs_bulk.d.ts.map

package/dist/commands/runs_bulk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs_bulk.d.ts","sourceRoot":"","sources":["../../commands/runs_bulk.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAQlF;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,gBAAgB;IAC3D,OAAgB,WAAW,SAAuB;IAClD,OAAgB,WAAW,SAA+D;IAGlF,MAAM,EAAE,MAAM,CAAC;IAGf,UAAU,EAAE,OAAO,CAAC;IAGpB,MAAM,EAAE,OAAO,CAAC;IAGhB,KAAK,EAAE,OAAO,CAAC;IAEvB,UAAgB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAsDvC;CACF"}