@adonis-agora/durable 0.1.0

package/dist/src/telescope/data-providers.js

@@ -0,0 +1,322 @@
+import { WorkflowEngine } from '../index.js';
+/**
+ * The durable "Workflows" dashboard data providers. Two sources:
+ *  - ENGINE-backed (state / recentFailures / workerHealth / stateBreakdown): query the live
+ *    `WorkflowEngine` read API (resolved from the container), so they reflect the source of truth.
+ *  - ENTRY-backed (timeseries / duration / runsOverTime / successRate / throughput): aggregate the
+ *    `agora:durable:*` lifecycle events the generic diagnostics watcher captured into Telescope
+ *    (recorded as `type: 'diagnostic'`, `tag: 'lib:durable'`), so they are the rolling history.
+ *
+ * No durable-specific watcher is needed: the `@adonis-agora/durable` provider already bridges engine events
+ * onto the diagnostics bus, and Telescope's generic watcher records them.
+ */
+const STATE_CAP = 10_000;
+/** Resolve the live durable engine from the host container. */
+function engineOf(ctx) {
+    return ctx.container.make(WorkflowEngine);
+}
+/** Fetch captured `agora:durable:*` lifecycle entries from Telescope storage (newest-first). */
+async function fetchEntries(ctx, limit = 5_000) {
+    return ctx.store.list({ type: 'diagnostic', tag: 'lib:durable', limit });
+}
+const contentOf = (e) => (e.content ?? {});
+/** Compute the p-th percentile of a SORTED array. */
+function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return 0;
+    const idx = Math.min(sorted.length - 1, Math.ceil((p / 100) * sorted.length) - 1);
+    return sorted[Math.max(0, idx)] ?? 0;
+}
+/** Split entries into current `(now-window, now]` and previous `(now-2window, now-window]` windows. */
+function splitWindows(entries, windowMs, now) {
+    const start = now - windowMs;
+    const prevStart = start - windowMs;
+    const at = (e) => (e.createdAt ? +new Date(e.createdAt) : 0);
+    return {
+        current: entries.filter((e) => at(e) > start && at(e) <= now),
+        previous: entries.filter((e) => at(e) > prevStart && at(e) <= start),
+    };
+}
+/** Success rate (completed / (completed+failed)) for a list of entries; 1 when no data. */
+function successRateOf(entries) {
+    let completed = 0;
+    let failed = 0;
+    for (const e of entries) {
+        const event = contentOf(e).event;
+        if (event === 'run.completed')
+            completed += 1;
+        else if (event === 'run.failed')
+            failed += 1;
+    }
+    const total = completed + failed;
+    return total === 0 ? 1 : completed / total;
+}
+// ─── engine-backed ──────────────────────────────────────────────────────────
+/** A current-state count from the engine. `query.status` selects which (default 'dead'). */
+export function durableStateProvider() {
+    return {
+        name: 'durable.state',
+        async resolve(query, ctx) {
+            const engine = await engineOf(ctx);
+            const status = query?.status ?? 'dead';
+            const runs = await engine.listRuns({ status, limit: STATE_CAP });
+            return { value: runs.length };
+        },
+    };
+}
+/** Recent failed + dead runs as table rows (newest first), bounded by `query.windowMs` (default 24h). */
+export function durableRecentFailuresProvider() {
+    return {
+        name: 'durable.recentFailures',
+        async resolve(query, ctx) {
+            const engine = await engineOf(ctx);
+            const limit = Math.min(200, Math.max(10, Number(query?.limit ?? 50)));
+            const windowMs = query?.windowMs === undefined ? 24 * 60 * 60 * 1000 : Number(query.windowMs);
+            const cutoff = windowMs > 0 ? Date.now() - windowMs : 0;
+            const [failed, dead] = await Promise.all([
+                engine.listRuns({ status: 'failed', limit }),
+                engine.listRuns({ status: 'dead', limit }),
+            ]);
+            const rows = [...failed, ...dead]
+                .filter((r) => +new Date(r.updatedAt) >= cutoff)
+                .sort((a, b) => +new Date(b.updatedAt) - +new Date(a.updatedAt))
+                .slice(0, limit)
+                .map((r) => ({
+                updatedAt: `${new Date(r.updatedAt).toISOString().replace('T', ' ').slice(0, 16)}Z`,
+                workflow: r.workflow,
+                runId: r.id,
+                error: r.error?.message ?? '',
+            }));
+            return { rows };
+        },
+    };
+}
+/** Per-group worker health from the engine; `query.metric: 'starvedCount'` returns a stat. */
+export function durableWorkerHealthProvider() {
+    return {
+        name: 'durable.workerHealth',
+        async resolve(query, ctx) {
+            const engine = await engineOf(ctx);
+            const health = await engine.workerHealth();
+            const isStarved = (g) => g.depth > 0 && g.liveWorkers.length === 0;
+            if (query?.metric === 'starvedCount') {
+                return { value: health.filter(isStarved).length };
+            }
+            const rows = health
+                .slice()
+                .sort((a, b) => Number(isStarved(b)) - Number(isStarved(a)) || b.depth - a.depth)
+                .map((g) => ({
+                group: g.group,
+                queued: g.depth,
+                liveWorkers: g.liveWorkers.length,
+                status: isStarved(g) ? 'STARVED' : 'ok',
+            }));
+            return { rows };
+        },
+    };
+}
+const STATE_BREAKDOWN_PALETTE = ['#34d399', '#fbbf24', '#f87171', '#38bdf8', '#a78bfa'];
+const STATE_BREAKDOWN_STATUSES = ['running', 'pending', 'completed', 'failed', 'dead'];
+/** Pie/donut segments: a count per status from the engine. */
+export function durableStateBreakdownProvider() {
+    return {
+        name: 'durable.stateBreakdown',
+        async resolve(_query, ctx) {
+            const engine = await engineOf(ctx);
+            const counts = await Promise.all(STATE_BREAKDOWN_STATUSES.map((status) => engine.listRuns({ status, limit: STATE_CAP }).then((runs) => runs.length)));
+            const segments = STATE_BREAKDOWN_STATUSES.map((label, i) => ({
+                label,
+                value: counts[i],
+                color: STATE_BREAKDOWN_PALETTE[i],
+            }));
+            return { segments };
+        },
+    };
+}
+// ─── entry-backed (captured diagnostics history) ──────────────────────────────
+/** Rollups from captured run.* entries. `query.metric`: successRate | failed | total | topFailures. */
+export function durableTimeseriesProvider() {
+    return {
+        name: 'durable.timeseries',
+        async resolve(query, ctx) {
+            const limit = Math.min(5_000, Math.max(100, Number(query?.limit ?? 2_000)));
+            const entries = await fetchEntries(ctx, limit);
+            let completed = 0;
+            let failed = 0;
+            const failByWorkflow = new Map();
+            for (const e of entries) {
+                const c = contentOf(e);
+                if (c.event === 'run.completed')
+                    completed += 1;
+                else if (c.event === 'run.failed') {
+                    failed += 1;
+                    const wf = c.payload?.workflow ?? 'unknown';
+                    failByWorkflow.set(wf, (failByWorkflow.get(wf) ?? 0) + 1);
+                }
+            }
+            const total = completed + failed;
+            const metric = query?.metric ?? 'successRate';
+            if (metric === 'successRate')
+                return { value: total === 0 ? 1 : completed / total };
+            if (metric === 'failed')
+                return { value: failed };
+            if (metric === 'total')
+                return { value: total };
+            if (metric === 'topFailures') {
+                const items = [...failByWorkflow.entries()]
+                    .map(([label, value]) => ({ label, value }))
+                    .sort((a, b) => b.value - a.value);
+                return { items };
+            }
+            return { value: total };
+        },
+    };
+}
+/** Duration percentiles + a ~8-bucket histogram, from `payload.durationMs` (or run.started pairing). */
+export function durableDurationProvider() {
+    return {
+        name: 'durable.duration',
+        async resolve(query, ctx) {
+            const entries = await fetchEntries(ctx);
+            const startedAt = new Map();
+            for (const e of entries) {
+                const c = contentOf(e);
+                if (c.event === 'run.started' && c.payload?.runId && e.createdAt) {
+                    startedAt.set(c.payload.runId, +new Date(e.createdAt));
+                }
+            }
+            const durs = [];
+            for (const e of entries) {
+                const c = contentOf(e);
+                if (c.event === 'run.completed' || c.event === 'run.failed') {
+                    if (typeof c.payload?.durationMs === 'number') {
+                        durs.push(c.payload.durationMs);
+                    }
+                    else if (c.payload?.runId) {
+                        const start = startedAt.get(c.payload.runId);
+                        const end = e.createdAt ? +new Date(e.createdAt) : undefined;
+                        if (start !== undefined && end !== undefined && end >= start)
+                            durs.push(end - start);
+                    }
+                }
+            }
+            durs.sort((a, b) => a - b);
+            const p50 = percentile(durs, 50);
+            const p95 = percentile(durs, 95);
+            const p99 = percentile(durs, 99);
+            const metric = query?.metric;
+            if (metric === 'p50')
+                return { value: p50 };
+            if (metric === 'p95')
+                return { value: p95 };
+            if (metric === 'p99')
+                return { value: p99 };
+            const max = durs.at(-1) ?? 0;
+            const bucketCount = 8;
+            const size = Math.max(1, Math.ceil((max + 1) / bucketCount));
+            const buckets = Array.from({ length: bucketCount }, (_, i) => ({
+                label: `${Math.round((i * size) / 100) / 10}s`,
+                count: 0,
+            }));
+            for (const d of durs) {
+                const bucket = buckets[Math.min(bucketCount - 1, Math.floor(d / size))];
+                if (bucket)
+                    bucket.count += 1;
+            }
+            return { buckets, p50, p95, p99 };
+        },
+    };
+}
+/** `done`/`failed` counts bucketed into `query.buckets ?? 24` equal time buckets. */
+export function durableRunsOverTimeProvider() {
+    return {
+        name: 'durable.runsOverTime',
+        async resolve(query, ctx) {
+            const entries = await fetchEntries(ctx);
+            const n = Math.max(1, Number(query?.buckets ?? 24));
+            const now = Date.now();
+            let minT = now;
+            for (const e of entries) {
+                if (e.createdAt)
+                    minT = Math.min(minT, +new Date(e.createdAt));
+            }
+            const span = Math.max(now - minT, 1);
+            const bucketSize = span / n;
+            const rows = Array.from({ length: n }, (_, i) => ({
+                label: new Date(minT + i * bucketSize).toISOString().slice(11, 16),
+                done: 0,
+                failed: 0,
+            }));
+            for (const e of entries) {
+                const event = contentOf(e).event;
+                if (event !== 'run.completed' && event !== 'run.failed')
+                    continue;
+                const t = e.createdAt ? +new Date(e.createdAt) : 0;
+                const row = rows[Math.min(n - 1, Math.floor((t - minT) / bucketSize))];
+                if (row) {
+                    if (event === 'run.completed')
+                        row.done += 1;
+                    else
+                        row.failed += 1;
+                }
+            }
+            return { rows };
+        },
+    };
+}
+/** Success rate over `query.windowMs` (default 24h), with `delta` vs the prior window + an 8-pt spark. */
+export function durableSuccessRateProvider() {
+    return {
+        name: 'durable.successRate',
+        async resolve(query, ctx) {
+            const entries = await fetchEntries(ctx);
+            const windowMs = Number(query?.windowMs ?? 24 * 60 * 60 * 1000);
+            const now = Date.now();
+            const { current, previous } = splitWindows(entries, windowMs, now);
+            const value = successRateOf(current);
+            const delta = previous.length > 0 ? value - successRateOf(previous) : undefined;
+            const sparkBuckets = 8;
+            const bucketSize = windowMs / sparkBuckets;
+            const sparkStart = now - windowMs;
+            const spark = Array.from({ length: sparkBuckets }, (_, i) => {
+                const bStart = sparkStart + i * bucketSize;
+                const bEntries = current.filter((e) => {
+                    const t = e.createdAt ? +new Date(e.createdAt) : 0;
+                    return t > bStart && t <= bStart + bucketSize;
+                });
+                return successRateOf(bEntries);
+            });
+            return delta === undefined ? { value, spark } : { value, delta, spark };
+        },
+    };
+}
+/** Completed runs per hour over `query.windowMs` (default 24h), with `delta` + an 8-pt spark. */
+export function durableThroughputProvider() {
+    return {
+        name: 'durable.throughput',
+        async resolve(query, ctx) {
+            const entries = await fetchEntries(ctx);
+            const windowMs = Number(query?.windowMs ?? 24 * 60 * 60 * 1000);
+            const now = Date.now();
+            const { current, previous } = splitWindows(entries, windowMs, now);
+            const countCompleted = (es) => es.filter((e) => contentOf(e).event === 'run.completed').length;
+            const windowHours = windowMs / (60 * 60 * 1000);
+            const value = countCompleted(current) / windowHours;
+            const delta = previous.length > 0 ? value - countCompleted(previous) / windowHours : undefined;
+            const sparkBuckets = 8;
+            const bucketSize = windowMs / sparkBuckets;
+            const bucketHours = bucketSize / (60 * 60 * 1000);
+            const sparkStart = now - windowMs;
+            const spark = Array.from({ length: sparkBuckets }, (_, i) => {
+                const bStart = sparkStart + i * bucketSize;
+                const bEntries = current.filter((e) => {
+                    const t = e.createdAt ? +new Date(e.createdAt) : 0;
+                    return t > bStart && t <= bStart + bucketSize;
+                });
+                return countCompleted(bEntries) / bucketHours;
+            });
+            return delta === undefined ? { value, spark } : { value, delta, spark };
+        },
+    };
+}
+//# sourceMappingURL=data-providers.js.map

package/dist/src/telescope/data-providers.js.map

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

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

@@ -0,0 +1,22 @@
+import { type DurableDashboardOptions } from './dashboard.js';
+import type { TelescopeExtension } from './telescope-sdk.js';
+/**
+ * The first-class `@adonis-agora/telescope` extension for `@adonis-agora/durable`: a "Workflows" health dashboard
+ * (golden signals) plus the data providers it binds to. Wire it into `config/telescope.ts`:
+ *
+ * ```ts
+ * import { defineConfig } from '@adonis-agora/telescope'
+ * import { durableTelescopeExtension } from '@adonis-agora/durable/telescope'
+ *
+ * export default defineConfig({ extensions: [durableTelescopeExtension()] })
+ * ```
+ *
+ * No watcher is contributed — the `@adonis-agora/durable` provider already bridges engine events onto the
+ * diagnostics bus, and Telescope's generic diagnostics watcher records them; the entry-backed
+ * providers read those `tag: 'lib:durable'` entries, the rest query the live engine.
+ *
+ * The returned object structurally satisfies `@adonis-agora/telescope`'s `TelescopeExtension` (it is not
+ * imported — see `telescope-sdk.ts` for why).
+ */
+export declare function durableTelescopeExtension(opts?: DurableDashboardOptions): TelescopeExtension;
+//# sourceMappingURL=extension.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/telescope/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAoB,MAAM,gBAAgB,CAAC;AAYhF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,uBAA4B,GAAG,kBAAkB,CAgBhG"}

package/dist/src/telescope/extension.js

@@ -0,0 +1,38 @@
+import { durableDashboard } from './dashboard.js';
+import { durableDurationProvider, durableRecentFailuresProvider, durableRunsOverTimeProvider, durableStateBreakdownProvider, durableStateProvider, durableSuccessRateProvider, durableThroughputProvider, durableTimeseriesProvider, durableWorkerHealthProvider, } from './data-providers.js';
+/**
+ * The first-class `@adonis-agora/telescope` extension for `@adonis-agora/durable`: a "Workflows" health dashboard
+ * (golden signals) plus the data providers it binds to. Wire it into `config/telescope.ts`:
+ *
+ * ```ts
+ * import { defineConfig } from '@adonis-agora/telescope'
+ * import { durableTelescopeExtension } from '@adonis-agora/durable/telescope'
+ *
+ * export default defineConfig({ extensions: [durableTelescopeExtension()] })
+ * ```
+ *
+ * No watcher is contributed — the `@adonis-agora/durable` provider already bridges engine events onto the
+ * diagnostics bus, and Telescope's generic diagnostics watcher records them; the entry-backed
+ * providers read those `tag: 'lib:durable'` entries, the rest query the live engine.
+ *
+ * The returned object structurally satisfies `@adonis-agora/telescope`'s `TelescopeExtension` (it is not
+ * imported — see `telescope-sdk.ts` for why).
+ */
+export function durableTelescopeExtension(opts = {}) {
+    return {
+        name: 'durable',
+        dashboards: () => [durableDashboard(opts)],
+        dataProviders: () => [
+            durableStateProvider(),
+            durableTimeseriesProvider(),
+            durableRecentFailuresProvider(),
+            durableWorkerHealthProvider(),
+            durableDurationProvider(),
+            durableRunsOverTimeProvider(),
+            durableSuccessRateProvider(),
+            durableThroughputProvider(),
+            durableStateBreakdownProvider(),
+        ],
+    };
+}
+//# sourceMappingURL=extension.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../src/telescope/extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAG7B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgC,EAAE;IAC1E,OAAO;QACL,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC1C,aAAa,EAAE,GAAG,EAAE,CAAC;YACnB,oBAAoB,EAAE;YACtB,yBAAyB,EAAE;YAC3B,6BAA6B,EAAE;YAC/B,2BAA2B,EAAE;YAC7B,uBAAuB,EAAE;YACzB,2BAA2B,EAAE;YAC7B,0BAA0B,EAAE;YAC5B,yBAAyB,EAAE;YAC3B,6BAA6B,EAAE;SAChC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+export { type DurableDashboardOptions, durableDashboard } from './dashboard.js';
+export { durableTelescopeExtension } from './extension.js';
+export { durableDurationProvider, durableRecentFailuresProvider, durableRunsOverTimeProvider, durableStateBreakdownProvider, durableStateProvider, durableSuccessRateProvider, durableThroughputProvider, durableTimeseriesProvider, durableWorkerHealthProvider, } from './data-providers.js';
+export type { ContainerLike, DataProvider, ExtensionContext, TelescopeExtension, TelescopeStoreLike, } from './telescope-sdk.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telescope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC"}

package/dist/src/telescope/index.js

@@ -0,0 +1,4 @@
+export { durableDashboard } from './dashboard.js';
+export { durableTelescopeExtension } from './extension.js';
+export { durableDurationProvider, durableRecentFailuresProvider, durableRunsOverTimeProvider, durableStateBreakdownProvider, durableStateProvider, durableSuccessRateProvider, durableThroughputProvider, durableTimeseriesProvider, durableWorkerHealthProvider, } from './data-providers.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telescope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC"}

package/dist/src/telescope/telescope-sdk.d.ts

@@ -0,0 +1,123 @@
+/**
+ * A local, structural mirror of the `@adonis-agora/telescope` extension SDK contract.
+ *
+ * We deliberately do NOT import `@adonis-agora/telescope` — it lives in a separate repo, so a workspace
+ * dependency would not resolve (the same cross-repo decoupling `@adonis-agora/telescope` itself uses to read
+ * `@adonis-agora/diagnostics` without importing it). Instead we declare the same shapes here; the exported
+ * extension object structurally satisfies `@adonis-agora/telescope`'s `TelescopeExtension` when an app wires
+ * it into `config/telescope.ts` (where both packages are installed). Keep these in lockstep with
+ * `@adonis-agora/telescope`'s `extension/types.ts`.
+ */
+/** The slice of a telescope entry the data providers read. */
+export interface TelescopeEntryLike {
+    content?: unknown;
+    createdAt?: Date;
+}
+/** The slice of the telescope store the data providers read (a subset of `TelescopeStore`). */
+export interface TelescopeStoreLike {
+    list(query?: {
+        type?: string;
+        tag?: string;
+        limit?: number;
+    }): Promise<TelescopeEntryLike[]>;
+}
+/** The slice of the AdonisJS container an extension uses to resolve host services. */
+export interface ContainerLike {
+    make<T>(token: unknown): Promise<T>;
+}
+/** Read-only context handed to every extension hook (mirror of `@adonis-agora/telescope`'s). */
+export interface ExtensionContext {
+    readonly store: TelescopeStoreLike;
+    readonly container: ContainerLike;
+    readonly config: unknown;
+}
+export interface ExtensionEntryType {
+    id: string;
+    label: string;
+    dot: string;
+}
+export interface PanelThresholds {
+    warn: number;
+    bad: number;
+    direction: 'up-bad' | 'down-bad';
+}
+export interface DashboardSection {
+    title?: string;
+    cols?: 2 | 3 | 4;
+    panels: Panel[];
+}
+export interface DashboardSpec {
+    id: string;
+    label: string;
+    navGroup?: string;
+    panels: Panel[];
+    sections?: DashboardSection[];
+}
+export interface DataBinding {
+    provider: string;
+    query?: Record<string, unknown>;
+}
+export interface LinkSpec {
+    href: string;
+    external?: boolean;
+}
+export interface Column {
+    key: string;
+    label: string;
+    link?: LinkSpec;
+}
+export type Panel = {
+    kind: 'stat';
+    title: string;
+    data: DataBinding;
+    format?: 'number' | 'percent' | 'duration' | 'rate';
+    accent?: string;
+    spark?: boolean;
+    thresholds?: PanelThresholds;
+} | {
+    kind: 'timeseries';
+    title: string;
+    data: DataBinding;
+    series: string[];
+    style?: 'area' | 'stacked';
+} | {
+    kind: 'topN';
+    title: string;
+    data: DataBinding;
+    limit?: number;
+} | {
+    kind: 'table';
+    title: string;
+    data: DataBinding;
+    columns: Column[];
+} | {
+    kind: 'distribution';
+    title: string;
+    data: DataBinding;
+    markers?: Array<'p50' | 'p95' | 'p99'>;
+    format?: 'duration' | 'number';
+} | {
+    kind: 'gauge';
+    title: string;
+    data: DataBinding;
+    min?: number;
+    max?: number;
+    format?: 'number' | 'percent' | 'duration' | 'rate';
+    thresholds?: PanelThresholds;
+} | {
+    kind: 'breakdown';
+    title: string;
+    data: DataBinding;
+    style?: 'donut' | 'bar';
+};
+export interface DataProvider {
+    name: string;
+    resolve(query: Record<string, unknown> | undefined, ctx: ExtensionContext): Promise<unknown>;
+}
+export interface TelescopeExtension {
+    name: string;
+    entryTypes?(ctx: ExtensionContext): ExtensionEntryType[];
+    dashboards?(ctx: ExtensionContext): DashboardSpec[];
+    dataProviders?(ctx: ExtensionContext): DataProvider[];
+}
+//# sourceMappingURL=telescope-sdk.d.ts.map

package/dist/src/telescope/telescope-sdk.d.ts.map

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

package/dist/src/telescope/telescope-sdk.js

@@ -0,0 +1,12 @@
+/**
+ * A local, structural mirror of the `@adonis-agora/telescope` extension SDK contract.
+ *
+ * We deliberately do NOT import `@adonis-agora/telescope` — it lives in a separate repo, so a workspace
+ * dependency would not resolve (the same cross-repo decoupling `@adonis-agora/telescope` itself uses to read
+ * `@adonis-agora/diagnostics` without importing it). Instead we declare the same shapes here; the exported
+ * extension object structurally satisfies `@adonis-agora/telescope`'s `TelescopeExtension` when an app wires
+ * it into `config/telescope.ts` (where both packages are installed). Keep these in lockstep with
+ * `@adonis-agora/telescope`'s `extension/types.ts`.
+ */
+export {};
+//# sourceMappingURL=telescope-sdk.js.map

package/dist/src/telescope/telescope-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telescope-sdk.js","sourceRoot":"","sources":["../../../src/telescope/telescope-sdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/src/test-helpers.d.ts

@@ -0,0 +1,11 @@
+import type { StartOptions, WorkflowEngine } from './engine.js';
+import type { RunResult } from './interfaces.js';
+import type { WorkflowRef } from './workflow-ref.js';
+/**
+ * Test helper: enqueue a run and wait for it to settle (terminal or suspended). `engine.start` now
+ * only enqueues (dispatch model), so this restores the old synchronous-result shape for assertions —
+ * `const r = await startRun(engine, wf, input, id)`. Not for production use; production pairs `start`
+ * with `waitForRun` (or a worker) explicitly.
+ */
+export declare function startRun(engine: WorkflowEngine, workflow: WorkflowRef, input: unknown, runId: string, opts?: StartOptions): Promise<RunResult>;
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/src/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/test-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,YAAY,GAClB,OAAO,CAAC,SAAS,CAAC,CAIpB"}

package/dist/src/test-helpers.js

@@ -0,0 +1,12 @@
+/**
+ * Test helper: enqueue a run and wait for it to settle (terminal or suspended). `engine.start` now
+ * only enqueues (dispatch model), so this restores the old synchronous-result shape for assertions —
+ * `const r = await startRun(engine, wf, input, id)`. Not for production use; production pairs `start`
+ * with `waitForRun` (or a worker) explicitly.
+ */
+export function startRun(engine, workflow, input, runId, opts) {
+    // `start` is overloaded per ref kind (class | string); a `WorkflowRef` union fits neither overload,
+    // and this is a thin test helper, so resolve to the string overload (engine handles both at runtime).
+    return engine.start(workflow, input, runId, opts).then(() => engine.waitForRun(runId));
+}
+//# sourceMappingURL=test-helpers.js.map

package/dist/src/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../src/test-helpers.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAsB,EACtB,QAAqB,EACrB,KAAc,EACd,KAAa,EACb,IAAmB;IAEnB,oGAAoG;IACpG,sGAAsG;IACtG,OAAO,MAAM,CAAC,KAAK,CAAC,QAAkB,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;AACnG,CAAC"}