@adonis-agora/durable 0.1.0

package/dist/src/stores/lucid.js

@@ -0,0 +1,342 @@
+import { attributeColumnFor, attributeOperand, normalizeAttributeRows, sqlComparator, } from '../search-attributes.js';
+import { checkpointToRow, rowToCheckpoint, rowToRun, runPatchToRow, runToRow, } from './lucid-mappers.js';
+import { DURABLE_TABLES, createDurableTables } from './lucid-schema.js';
+/**
+ * A production-grade, persistent `StateStore` backed by AdonisJS **Lucid** (Knex). Runs, checkpoints,
+ * timers, signal waiters, run attributes and recovery leases live in SQL, so durable state survives
+ * restarts and works across processes — the behavioral twin of core's `InMemoryStateStore`.
+ *
+ * Portable across SQLite / Postgres / MySQL: JSON payloads are stored as TEXT (serialized here) and
+ * all timestamps are epoch-ms integers, so there's no dependency on a dialect's native JSON/date type.
+ *
+ * Usually you don't construct this directly: `config/durable.ts` selects it via
+ * `stores.lucid({ ... })` and the provider builds it for you.
+ */
+export class LucidStateStore {
+    db;
+    connectionName;
+    constructor(db, options = {}) {
+        this.db = db;
+        this.connectionName = options.connectionName;
+    }
+    /** The base query client (or a named connection's), used unless an explicit tx client is passed. */
+    client() {
+        return this.connectionName ? this.db.connection(this.connectionName) : this.db.connection();
+    }
+    /** Idempotently provision the durable tables (called on boot when `autoSchema` is on). */
+    async ensureSchema() {
+        await createDurableTables(this.db);
+    }
+    // --- runs ---------------------------------------------------------------
+    async createRun(run) {
+        await this.db.transaction(async (trx) => {
+            await trx.table(DURABLE_TABLES.runs).insert(runToRow(run));
+            await this.reindexAttributes(trx, run.id, run.searchAttributes);
+        });
+    }
+    async updateRun(runId, patch) {
+        const row = runPatchToRow(patch);
+        await this.db.transaction(async (trx) => {
+            // Knex throws on an empty `.update({})`; skip the UPDATE when no mapped column changed.
+            if (Object.keys(row).length) {
+                await trx.from(DURABLE_TABLES.runs).where('id', runId).update(row);
+            }
+            if ('searchAttributes' in patch) {
+                await this.reindexAttributes(trx, runId, patch.searchAttributes);
+            }
+        });
+    }
+    async getRun(runId) {
+        const row = await this.client().from(DURABLE_TABLES.runs).where('id', runId).first();
+        return row ? rowToRun(row) : null;
+    }
+    async deleteRun(runId) {
+        // Child rows first, then the run — checkpoints, signal waiters, attribute rows — all in one
+        // transaction so a crash can't leave a half-deleted run. (Buffered signals are token-keyed,
+        // not run-scoped, so they are not swept here.)
+        await this.client().transaction(async (trx) => {
+            await trx.from(DURABLE_TABLES.checkpoints).where('run_id', runId).delete();
+            await trx.from(DURABLE_TABLES.signalWaiters).where('run_id', runId).delete();
+            await trx.from(DURABLE_TABLES.attributes).where('run_id', runId).delete();
+            await trx.from(DURABLE_TABLES.runs).where('id', runId).delete();
+        });
+    }
+    // --- checkpoints --------------------------------------------------------
+    async getCheckpoint(runId, seq) {
+        const row = await this.client()
+            .from(DURABLE_TABLES.checkpoints)
+            .where('run_id', runId)
+            .andWhere('seq', seq)
+            .first();
+        return row ? rowToCheckpoint(row) : null;
+    }
+    async saveCheckpoint(checkpoint) {
+        await this.upsertCheckpoint(this.client(), checkpoint);
+    }
+    /** Upsert a checkpoint keyed by `(run_id, seq)`, portable across dialects (read-then-write in a tx). */
+    async upsertCheckpoint(client, checkpoint) {
+        const row = checkpointToRow(checkpoint);
+        const run = () => client.transaction(async (trx) => {
+            const existing = await trx
+                .from(DURABLE_TABLES.checkpoints)
+                .where('run_id', row.run_id)
+                .andWhere('seq', row.seq)
+                .first();
+            if (existing) {
+                await trx
+                    .from(DURABLE_TABLES.checkpoints)
+                    .where('run_id', row.run_id)
+                    .andWhere('seq', row.seq)
+                    .update(row);
+            }
+            else {
+                await trx.table(DURABLE_TABLES.checkpoints).insert(row);
+            }
+        });
+        // If we're already inside a transaction client, reuse it (Lucid nests via savepoints); otherwise
+        // open one on the base client.
+        await run();
+    }
+    // --- recovery / dispatch queries ----------------------------------------
+    async listIncompleteRuns() {
+        const rows = await this.client().from(DURABLE_TABLES.runs).where('status', 'running');
+        return rows.map(rowToRun);
+    }
+    async listPendingRuns(limit) {
+        const rows = await this.client()
+            .from(DURABLE_TABLES.runs)
+            .where('status', 'pending')
+            .orderBy('created_at', 'asc') // FIFO dispatch
+            .orderBy('id', 'asc') // stable tiebreak, mirrors the in-memory store
+            .limit(limit);
+        return rows.map(rowToRun);
+    }
+    async listDueTimers(nowMs) {
+        const rows = await this.client()
+            .from(DURABLE_TABLES.runs)
+            .where('status', 'suspended')
+            .whereNotNull('wake_at')
+            .andWhere('wake_at', '<=', nowMs);
+        return rows.map(rowToRun);
+    }
+    // --- recovery lease (atomic) --------------------------------------------
+    async tryLockRun(runId, owner, leaseUntilMs, nowMs) {
+        // Atomic compare-and-set: acquire ONLY if currently unlocked or the lease has expired. The single
+        // conditional UPDATE is the concurrency guard — two instances racing can never both report `true`.
+        const affected = await this.client()
+            .from(DURABLE_TABLES.runs)
+            .where('id', runId)
+            .andWhere((q) => {
+            q.whereNull('locked_until').orWhere('locked_until', '<=', nowMs);
+        })
+            .update({ locked_by: owner, locked_until: leaseUntilMs });
+        return rowsAffected(affected) === 1;
+    }
+    async releaseRunLock(runId) {
+        await this.client()
+            .from(DURABLE_TABLES.runs)
+            .where('id', runId)
+            .update({ locked_by: null, locked_until: null });
+    }
+    async renewRunLock(runId, owner, leaseUntilMs) {
+        // Extend ONLY if `owner` still holds the lease — a dead worker's lease still expires & is reclaimed.
+        const affected = await this.client()
+            .from(DURABLE_TABLES.runs)
+            .where('id', runId)
+            .andWhere('locked_by', owner)
+            .update({ locked_until: leaseUntilMs });
+        return rowsAffected(affected) === 1;
+    }
+    // --- signal waiters -----------------------------------------------------
+    async putSignalWaiter(waiter) {
+        await this.client().transaction(async (trx) => {
+            const existing = await trx
+                .from(DURABLE_TABLES.signalWaiters)
+                .where('token', waiter.token)
+                .first();
+            if (existing) {
+                await trx
+                    .from(DURABLE_TABLES.signalWaiters)
+                    .where('token', waiter.token)
+                    .update({ run_id: waiter.runId, seq: waiter.seq });
+            }
+            else {
+                await trx
+                    .table(DURABLE_TABLES.signalWaiters)
+                    .insert({ token: waiter.token, run_id: waiter.runId, seq: waiter.seq });
+            }
+        });
+    }
+    async takeSignalWaiter(token) {
+        // Atomically take-and-remove: delete by token, returning the row only if WE deleted it. Done in a
+        // transaction so a concurrent take can't hand the same waiter to two callers.
+        return this.client().transaction(async (trx) => {
+            const row = await trx.from(DURABLE_TABLES.signalWaiters).where('token', token).first();
+            if (!row)
+                return null;
+            const deleted = await trx.from(DURABLE_TABLES.signalWaiters).where('token', token).delete();
+            if (rowsAffected(deleted) !== 1)
+                return null;
+            const r = row;
+            return { token: r.token, runId: r.run_id, seq: Number(r.seq) };
+        });
+    }
+    async listSignalWaiters(prefix) {
+        const rows = await this.client()
+            .from(DURABLE_TABLES.signalWaiters)
+            .where('token', 'like', `${prefix}%`);
+        return rows.map((r) => ({
+            token: r.token,
+            runId: r.run_id,
+            seq: Number(r.seq),
+        }));
+    }
+    // --- buffered signals (FIFO per token) ----------------------------------
+    async bufferSignal(token, payload) {
+        await this.client()
+            .table(DURABLE_TABLES.bufferedSignals)
+            .insert({ token, payload: payload === undefined ? null : JSON.stringify(payload) });
+    }
+    async takeBufferedSignal(token) {
+        return this.client().transaction(async (trx) => {
+            const row = await trx
+                .from(DURABLE_TABLES.bufferedSignals)
+                .where('token', token)
+                .orderBy('id', 'asc')
+                .first();
+            if (!row)
+                return null;
+            const r = row;
+            const deleted = await trx.from(DURABLE_TABLES.bufferedSignals).where('id', r.id).delete();
+            if (rowsAffected(deleted) !== 1)
+                return null;
+            return { payload: r.payload == null ? undefined : JSON.parse(r.payload) };
+        });
+    }
+    // --- transaction (exactly-once business write + checkpoint) -------------
+    async transaction(work) {
+        return this.client().transaction(async (trx) => work({
+            raw: trx,
+            saveCheckpoint: async (cp) => {
+                const row = checkpointToRow(cp);
+                const existing = await trx
+                    .from(DURABLE_TABLES.checkpoints)
+                    .where('run_id', row.run_id)
+                    .andWhere('seq', row.seq)
+                    .first();
+                if (existing) {
+                    await trx
+                        .from(DURABLE_TABLES.checkpoints)
+                        .where('run_id', row.run_id)
+                        .andWhere('seq', row.seq)
+                        .update(row);
+                }
+                else {
+                    await trx.table(DURABLE_TABLES.checkpoints).insert(row);
+                }
+            },
+        }));
+    }
+    // --- dashboard queries --------------------------------------------------
+    async listRuns(query) {
+        const q = this.client().from(DURABLE_TABLES.runs);
+        if (query.workflow)
+            q.where('workflow', query.workflow);
+        if (query.status)
+            q.where('status', query.status);
+        if (query.statuses) {
+            // `status IN (...)`; an empty set matches nothing (mirrors the in-memory store).
+            if (query.statuses.length)
+                q.whereIn('status', query.statuses);
+            else
+                q.whereRaw('1 = 0');
+        }
+        // `tags` is stored as a JSON array string; match the quoted token so `etl` doesn't match `etl-foo`.
+        if (query.tag)
+            q.where('tags', 'like', `%"${query.tag}"%`);
+        // Typed/range attribute predicates push DOWN into SQL via one EXISTS per filter against the
+        // normalized side-table — so the DB filters AND paginates, no full scan + in-process filter.
+        if (query.attributes?.length) {
+            for (const f of query.attributes)
+                this.applyAttributeExists(q, f);
+        }
+        q.orderBy('created_at', 'desc'); // newest first — recent runs on top in the dashboard
+        if (query.limit !== undefined)
+            q.limit(query.limit);
+        if (query.offset !== undefined)
+            q.offset(query.offset);
+        const rows = await q;
+        return rows.map(rowToRun);
+    }
+    /**
+     * Add one attribute predicate as a correlated EXISTS subquery on the side-table. `<>` (ne) also
+     * excludes runs where the attribute is absent (the missing-key-never-matches contract): EXISTS
+     * already requires the key row present, so EXISTS(... <> ...) is exactly ne-with-present. Numeric
+     * operands compare `num_value`, everything else `str_value`.
+     */
+    applyAttributeExists(q, f) {
+        const col = attributeColumnFor(f) === 'numValue' ? 'num_value' : 'str_value';
+        const cmp = sqlComparator(f.op);
+        const operand = attributeOperand(f);
+        q.whereExists((sub) => {
+            sub
+                .from(DURABLE_TABLES.attributes)
+                .whereRaw(`${DURABLE_TABLES.attributes}.run_id = ${DURABLE_TABLES.runs}.id`)
+                .andWhere(`${DURABLE_TABLES.attributes}.key`, f.key)
+                .andWhere(`${DURABLE_TABLES.attributes}.${col}`, cmp, operand);
+        });
+    }
+    async listCheckpoints(runId) {
+        const rows = await this.client()
+            .from(DURABLE_TABLES.checkpoints)
+            .where('run_id', runId)
+            .orderBy('seq', 'asc');
+        return rows.map(rowToCheckpoint);
+    }
+    async getLatestCheckpointByName(runId, name) {
+        const row = await this.client()
+            .from(DURABLE_TABLES.checkpoints)
+            .where('run_id', runId)
+            .andWhere('name', name)
+            .orderBy('seq', 'desc')
+            .first();
+        return row ? rowToCheckpoint(row) : undefined;
+    }
+    async listCheckpointsByNamePrefix(runId, prefixes) {
+        if (prefixes.length === 0)
+            return [];
+        const rows = await this.client()
+            .from(DURABLE_TABLES.checkpoints)
+            .where('run_id', runId)
+            .andWhere((q) => {
+            for (const p of prefixes)
+                q.orWhere('name', 'like', `${p}%`);
+        })
+            .orderBy('seq', 'asc');
+        return rows.map(rowToCheckpoint);
+    }
+    // --- internals ----------------------------------------------------------
+    /** Rewrite a run's normalized attribute rows: delete the old set, insert the current one. Mirrors
+     *  the in-memory store's reindex so the side-table always reflects the run's live searchAttributes. */
+    async reindexAttributes(client, runId, attributes) {
+        await client.from(DURABLE_TABLES.attributes).where('run_id', runId).delete();
+        const rows = normalizeAttributeRows(runId, attributes);
+        if (rows.length) {
+            await client.table(DURABLE_TABLES.attributes).multiInsert(rows.map((r) => ({
+                run_id: r.runId,
+                key: r.key,
+                str_value: r.strValue,
+                num_value: r.numValue,
+            })));
+        }
+    }
+}
+/** Knex `.update()` / `.delete()` return the affected row count as a number across dialects. */
+function rowsAffected(result) {
+    if (typeof result === 'number')
+        return result;
+    if (Array.isArray(result))
+        return result.length;
+    return 0;
+}
+//# sourceMappingURL=lucid.js.map

package/dist/src/stores/lucid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucid.js","sourceRoot":"","sources":["../../../src/stores/lucid.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGL,eAAe,EACf,eAAe,EACf,QAAQ,EACR,aAAa,EACb,QAAQ,GACT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAqBxE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,eAAe;IACT,EAAE,CAAW;IACb,cAAc,CAAqB;IAEpD,YAAY,EAAY,EAAE,UAAkC,EAAE;QAC5D,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC/C,CAAC;IAED,oGAAoG;IAC5F,MAAM;QACZ,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC;IAC9F,CAAC;IAED,0FAA0F;IAC1F,KAAK,CAAC,YAAY;QAChB,MAAM,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,SAAS,CAAC,GAAgB;QAC9B,MAAM,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACtC,MAAM,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,KAA2B;QACxD,MAAM,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACtC,wFAAwF;YACxF,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;gBAC5B,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrE,CAAC;YACD,IAAI,kBAAkB,IAAI,KAAK,EAAE,CAAC;gBAChC,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACnE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QACrF,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,4FAA4F;QAC5F,4FAA4F;QAC5F,+CAA+C;QAC/C,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5C,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YAC3E,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YAC7E,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YAC1E,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,aAAa,CAAC,KAAa,EAAE,GAAW;QAC5C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE;aAC5B,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;aAChC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC;aACtB,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC;aACpB,KAAK,EAAE,CAAC;QACX,OAAO,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,GAAoB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAA0B;QAC7C,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;IAED,wGAAwG;IAChG,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,UAA0B;QACvE,MAAM,GAAG,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,GAAG,EAAE,CACf,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC/B,MAAM,QAAQ,GAAG,MAAM,GAAG;iBACvB,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;iBAChC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC;iBAC3B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC;iBACxB,KAAK,EAAE,CAAC;YACX,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,GAAG;qBACN,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;qBAChC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC;qBAC3B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC;qBACxB,MAAM,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC,CAAC,CAAC;QACL,iGAAiG;QACjG,+BAA+B;QAC/B,MAAM,GAAG,EAAE,CAAC;IACd,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,kBAAkB;QACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACtF,OAAQ,IAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAa;QACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE;aAC7B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;aACzB,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC;aAC1B,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,gBAAgB;aAC7C,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,+CAA+C;aACpE,KAAK,CAAC,KAAK,CAAC,CAAC;QAChB,OAAQ,IAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAa;QAC/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE;aAC7B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;aACzB,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC;aAC5B,YAAY,CAAC,SAAS,CAAC;aACvB,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACpC,OAAQ,IAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,UAAU,CACd,KAAa,EACb,KAAa,EACb,YAAoB,EACpB,KAAa;QAEb,kGAAkG;QAClG,mGAAmG;QACnG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE;aACjC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;aACzB,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;aAClB,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YACd,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC,CAAC;aACD,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC;QAC5D,OAAO,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAAa;QAChC,MAAM,IAAI,CAAC,MAAM,EAAE;aAChB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;aACzB,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;aAClB,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,KAAa,EAAE,YAAoB;QACnE,qGAAqG;QACrG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE;aACjC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;aACzB,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;aAClB,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;aAC5B,MAAM,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1C,OAAO,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,eAAe,CAAC,MAAoB;QACxC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5C,MAAM,QAAQ,GAAG,MAAM,GAAG;iBACvB,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC;iBAClC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;iBAC5B,KAAK,EAAE,CAAC;YACX,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,GAAG;qBACN,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC;qBAClC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;qBAC5B,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG;qBACN,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC;qBACnC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,KAAa;QAClC,kGAAkG;QAClG,8EAA8E;QAC9E,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;YACvF,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;YAC5F,IAAI,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7C,MAAM,CAAC,GAAG,GAA8D,CAAC;YACzE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,MAAc;QACpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE;aAC7B,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC;aAClC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,CAAC;QACxC,OAAQ,IAAuE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1F,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,KAAK,EAAE,CAAC,CAAC,MAAM;YACf,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;SACnB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,OAAgB;QAChD,MAAM,IAAI,CAAC,MAAM,EAAE;aAChB,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC;aACrC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,KAAa;QACpC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC7C,MAAM,GAAG,GAAG,MAAM,GAAG;iBAClB,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC;iBACpC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;iBACrB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;iBACpB,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC;YACtB,MAAM,CAAC,GAAG,GAAsD,CAAC;YACjE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;YAC1F,IAAI,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAa,EAAE,CAAC;QACzF,CAAC,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,WAAW,CACf,IAGgB;QAEhB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAC7C,IAAI,CAAC;YACH,GAAG,EAAE,GAAG;YACR,cAAc,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;gBAC3B,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;gBAChC,MAAM,QAAQ,GAAG,MAAM,GAAG;qBACvB,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;qBAChC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC;qBAC3B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC;qBACxB,KAAK,EAAE,CAAC;gBACX,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,GAAG;yBACN,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;yBAChC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC;yBAC3B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC;yBACxB,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjB,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,2EAA2E;IAE3E,KAAK,CAAC,QAAQ,CAAC,KAAe;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAElD,IAAI,KAAK,CAAC,QAAQ;YAAE,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,KAAK,CAAC,MAAM;YAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,iFAAiF;YACjF,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM;gBAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;;gBAC1D,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,oGAAoG;QACpG,IAAI,KAAK,CAAC,GAAG;YAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAE3D,4FAA4F;QAC5F,6FAA6F;QAC7F,IAAI,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;YAC7B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU;gBAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,qDAAqD;QACtF,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEvD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC;QACrB,OAAQ,IAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;OAKG;IACK,oBAAoB,CAAC,CAAW,EAAE,CAAkB;QAC1D,MAAM,GAAG,GAAG,kBAAkB,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC;QAC7E,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAa,EAAE,EAAE;YAC9B,GAAG;iBACA,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC;iBAC/B,QAAQ,CAAC,GAAG,cAAc,CAAC,UAAU,aAAa,cAAc,CAAC,IAAI,KAAK,CAAC;iBAC3E,QAAQ,CAAC,GAAG,cAAc,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC;iBACnD,QAAQ,CAAC,GAAG,cAAc,CAAC,UAAU,IAAI,GAAG,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAa;QACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE;aAC7B,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;aAChC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC;aACtB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzB,OAAQ,IAAwB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,yBAAyB,CAC7B,KAAa,EACb,IAAY;QAEZ,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE;aAC5B,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;aAChC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC;aACtB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;aACtB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;aACtB,KAAK,EAAE,CAAC;QACX,OAAO,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,GAAoB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,2BAA2B,CAAC,KAAa,EAAE,QAAkB;QACjE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE;aAC7B,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC;aAChC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC;aACtB,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YACd,KAAK,MAAM,CAAC,IAAI,QAAQ;gBAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/D,CAAC,CAAC;aACD,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzB,OAAQ,IAAwB,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACxD,CAAC;IAED,2EAA2E;IAE3E;2GACuG;IAC/F,KAAK,CAAC,iBAAiB,CAC7B,MAAc,EACd,KAAa,EACb,UAA2C;QAE3C,MAAM,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7E,MAAM,IAAI,GAAG,sBAAsB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACvD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,WAAW,CACvD,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACf,MAAM,EAAE,CAAC,CAAC,KAAK;gBACf,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,SAAS,EAAE,CAAC,CAAC,QAAQ;gBACrB,SAAS,EAAE,CAAC,CAAC,QAAQ;aACtB,CAAC,CAAC,CACJ,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,gGAAgG;AAChG,SAAS,YAAY,CAAC,MAAe;IACnC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC;IAChD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/src/telescope/dashboard.d.ts

@@ -0,0 +1,15 @@
+import type { DashboardSpec } from './telescope-sdk.js';
+/** Options for the durable "Workflows" dashboard. */
+export interface DurableDashboardOptions {
+    /** URL template for deep-linking a run to the durable dashboard. Default `/durable/runs/{runId}`. */
+    runHref?: string;
+    /** Window (ms) bounding the "Stuck runs" table. Default 24h; pass `0` to show all. */
+    recentFailuresWindowMs?: number;
+}
+/**
+ * The "Workflows" health dashboard — a golden-signals layout (success rate / latency / backlog /
+ * throughput up top, then what-needs-attention, then trends). Pure data: panels bind to the
+ * `durable.*` data providers by name.
+ */
+export declare function durableDashboard(opts?: DurableDashboardOptions): DashboardSpec;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/src/telescope/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../../src/telescope/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,qDAAqD;AACrD,MAAM,WAAW,uBAAuB;IACtC,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,uBAA4B,GAAG,aAAa,CA0GlF"}

package/dist/src/telescope/dashboard.js

@@ -0,0 +1,113 @@
+/**
+ * The "Workflows" health dashboard — a golden-signals layout (success rate / latency / backlog /
+ * throughput up top, then what-needs-attention, then trends). Pure data: panels bind to the
+ * `durable.*` data providers by name.
+ */
+export function durableDashboard(opts = {}) {
+    const runHref = opts.runHref ?? '/durable/runs/{runId}';
+    const windowMs = opts.recentFailuresWindowMs ?? 24 * 60 * 60 * 1000;
+    return {
+        id: 'durable.workflows',
+        label: 'Workflows',
+        panels: [],
+        sections: [
+            {
+                title: 'Health',
+                cols: 4,
+                panels: [
+                    {
+                        kind: 'gauge',
+                        title: 'Success rate',
+                        data: { provider: 'durable.successRate' },
+                        max: 1,
+                        format: 'percent',
+                        thresholds: { warn: 0.98, bad: 0.95, direction: 'down-bad' },
+                    },
+                    {
+                        kind: 'stat',
+                        title: 'Duration p95',
+                        data: { provider: 'durable.duration', query: { metric: 'p95' } },
+                        format: 'duration',
+                        spark: false,
+                        thresholds: { warn: 2000, bad: 5000, direction: 'up-bad' },
+                    },
+                    {
+                        kind: 'stat',
+                        title: 'Backlog',
+                        data: { provider: 'durable.state', query: { status: 'pending' } },
+                        spark: false,
+                        thresholds: { warn: 50, bad: 200, direction: 'up-bad' },
+                    },
+                    {
+                        kind: 'stat',
+                        title: 'Throughput',
+                        data: { provider: 'durable.throughput' },
+                        format: 'rate',
+                        spark: true,
+                    },
+                ],
+            },
+            {
+                title: 'Needs attention',
+                cols: 3,
+                panels: [
+                    {
+                        kind: 'topN',
+                        title: 'Top failing workflows',
+                        data: { provider: 'durable.timeseries', query: { metric: 'topFailures' } },
+                        limit: 8,
+                    },
+                    {
+                        kind: 'table',
+                        title: 'Stuck runs',
+                        data: { provider: 'durable.recentFailures', query: { windowMs } },
+                        columns: [
+                            { key: 'updatedAt', label: 'Updated' },
+                            { key: 'workflow', label: 'Workflow' },
+                            { key: 'runId', label: 'Run', link: { href: runHref } },
+                            { key: 'error', label: 'Error' },
+                        ],
+                    },
+                    {
+                        kind: 'table',
+                        title: 'Starved worker groups',
+                        data: { provider: 'durable.workerHealth' },
+                        columns: [
+                            { key: 'group', label: 'Group' },
+                            { key: 'queued', label: 'Queued' },
+                            { key: 'liveWorkers', label: 'Workers' },
+                            { key: 'status', label: 'Status' },
+                        ],
+                    },
+                ],
+            },
+            {
+                title: 'Trends',
+                cols: 3,
+                panels: [
+                    {
+                        kind: 'timeseries',
+                        title: 'Runs over time',
+                        data: { provider: 'durable.runsOverTime' },
+                        series: ['done', 'failed'],
+                        style: 'stacked',
+                    },
+                    {
+                        kind: 'distribution',
+                        title: 'Duration distribution',
+                        data: { provider: 'durable.duration' },
+                        markers: ['p50', 'p95', 'p99'],
+                        format: 'duration',
+                    },
+                    {
+                        kind: 'breakdown',
+                        title: 'Runs by state',
+                        data: { provider: 'durable.stateBreakdown' },
+                        style: 'donut',
+                    },
+                ],
+            },
+        ],
+    };
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/src/telescope/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../../src/telescope/dashboard.ts"],"names":[],"mappings":"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"}

package/dist/src/telescope/data-providers.d.ts

@@ -0,0 +1,20 @@
+import type { DataProvider } from './telescope-sdk.js';
+/** A current-state count from the engine. `query.status` selects which (default 'dead'). */
+export declare function durableStateProvider(): DataProvider;
+/** Recent failed + dead runs as table rows (newest first), bounded by `query.windowMs` (default 24h). */
+export declare function durableRecentFailuresProvider(): DataProvider;
+/** Per-group worker health from the engine; `query.metric: 'starvedCount'` returns a stat. */
+export declare function durableWorkerHealthProvider(): DataProvider;
+/** Pie/donut segments: a count per status from the engine. */
+export declare function durableStateBreakdownProvider(): DataProvider;
+/** Rollups from captured run.* entries. `query.metric`: successRate | failed | total | topFailures. */
+export declare function durableTimeseriesProvider(): DataProvider;
+/** Duration percentiles + a ~8-bucket histogram, from `payload.durationMs` (or run.started pairing). */
+export declare function durableDurationProvider(): DataProvider;
+/** `done`/`failed` counts bucketed into `query.buckets ?? 24` equal time buckets. */
+export declare function durableRunsOverTimeProvider(): DataProvider;
+/** Success rate over `query.windowMs` (default 24h), with `delta` vs the prior window + an 8-pt spark. */
+export declare function durableSuccessRateProvider(): DataProvider;
+/** Completed runs per hour over `query.windowMs` (default 24h), with `delta` + an 8-pt spark. */
+export declare function durableThroughputProvider(): DataProvider;
+//# sourceMappingURL=data-providers.d.ts.map

package/dist/src/telescope/data-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-providers.d.ts","sourceRoot":"","sources":["../../../src/telescope/data-providers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAwC,MAAM,oBAAoB,CAAC;AAwE7F,4FAA4F;AAC5F,wBAAgB,oBAAoB,IAAI,YAAY,CAUnD;AAED,yGAAyG;AACzG,wBAAgB,6BAA6B,IAAI,YAAY,CAyB5D;AAED,8FAA8F;AAC9F,wBAAgB,2BAA2B,IAAI,YAAY,CAuB1D;AAKD,8DAA8D;AAC9D,wBAAgB,6BAA6B,IAAI,YAAY,CAkB5D;AAID,uGAAuG;AACvG,wBAAgB,yBAAyB,IAAI,YAAY,CAgCxD;AAED,wGAAwG;AACxG,wBAAgB,uBAAuB,IAAI,YAAY,CA+CtD;AAED,qFAAqF;AACrF,wBAAgB,2BAA2B,IAAI,YAAY,CA+B1D;AAED,0GAA0G;AAC1G,wBAAgB,0BAA0B,IAAI,YAAY,CAwBzD;AAED,iGAAiG;AACjG,wBAAgB,yBAAyB,IAAI,YAAY,CA6BxD"}