@dudousxd/nestjs-durable-telescope 0.4.0 → 0.5.1

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,gEAA8C;AAC9C,2DAAyC;AACzC,gEAA8C"}
+{"version":3,"sources":["../src/durable-telescope.watcher.ts","../src/durable-telescope.extension.ts","../src/durable-dashboard.spec-data.ts","../src/durable-data-providers.ts"],"sourcesContent":["import { type EngineEvent, WorkflowEngine } from '@dudousxd/nestjs-durable-core';\nimport type { Watcher, WatcherContext } from '@dudousxd/nestjs-telescope';\nimport { type Span, SpanStatusCode, context, trace } from '@opentelemetry/api';\n\n/**\n * A Telescope watcher that turns durable-workflow lifecycle events into Telescope entries, so\n * runs and steps (including remote/Python steps) show up alongside the app's requests, queries\n * and jobs in the Telescope UI — under the **Workflows** tab.\n *\n * It also **trace-groups** a run: a root span is opened per run and every entry is recorded inside\n * that span's OTel context (step entries inside a child `step …` span). Telescope's trace-context\n * provider stamps each entry with the active span, so a whole workflow shows up as a single trace\n * on the Traces page — run → steps — with each entry carrying the run's `traceId`. When the host has\n * no OTel SDK the spans are no-ops and entries simply carry no trace (the prior behaviour).\n *\n * Add it to `TelescopeModule.forRoot({ watchers: [new DurableTelescopeWatcher()] })`. It resolves\n * the engine from the (global) durable providers and subscribes to its events.\n */\nexport class DurableTelescopeWatcher implements Watcher {\n  readonly type = 'durable';\n  /** Open root span per run, so step entries nest under it and share its traceId. */\n  private readonly roots = new Map<string, Span>();\n\n  register(ctx: WatcherContext): void {\n    const engine = ctx.moduleRef.get(WorkflowEngine, { strict: false });\n    const tracer = trace.getTracer('@dudousxd/nestjs-durable-telescope');\n\n    engine.subscribe((event) => {\n      const record = () =>\n        ctx.record({\n          type: this.type,\n          content: {\n            event: event.type,\n            workflow: event.workflow,\n            runId: event.runId,\n            seq: event.seq,\n            name: event.name,\n            kind: event.kind,\n            output: event.output,\n            error: event.error,\n            durationMs: event.durationMs,\n          },\n          tags: this.tags(event),\n        });\n\n      // Open the run's root span on first sight; later events nest under it.\n      if (event.type === 'run.started') {\n        this.roots.set(\n          event.runId,\n          tracer.startSpan(`workflow ${event.workflow ?? '?'}`, {\n            attributes: { 'durable.run_id': event.runId, 'durable.workflow': event.workflow },\n          }),\n        );\n      }\n      const root = this.roots.get(event.runId);\n      const base = root ? trace.setSpan(context.active(), root) : context.active();\n\n      // A step/signal/sleep event → give it its own child span so it's a distinct node in the\n      // trace; run-level events record directly on the root. Either way the active span at record\n      // time carries the run's traceId, so all entries group into one trace.\n      if (event.name != null && event.seq != null) {\n        const step = tracer.startSpan(\n          `step ${event.name}`,\n          {\n            attributes: {\n              'durable.run_id': event.runId,\n              'durable.step.seq': event.seq,\n              'durable.step.kind': event.kind,\n            },\n          },\n          base,\n        );\n        context.with(trace.setSpan(base, step), record);\n        step.end();\n      } else {\n        context.with(base, record);\n      }\n\n      // Close the run's root span when it leaves the running state.\n      if (event.type === 'run.completed' || event.type === 'run.suspended') {\n        root?.end();\n        this.roots.delete(event.runId);\n      } else if (event.type === 'run.failed') {\n        const message = event.error?.message;\n        root?.setStatus(\n          message !== undefined\n            ? { code: SpanStatusCode.ERROR, message }\n            : { code: SpanStatusCode.ERROR },\n        );\n        root?.end();\n        this.roots.delete(event.runId);\n      }\n    });\n  }\n\n  private tags(event: EngineEvent): string[] {\n    const tags = ['durable', event.type, `run:${event.runId}`];\n    if (event.workflow) tags.push(`workflow:${event.workflow}`);\n    if (event.kind) tags.push(`kind:${event.kind}`);\n    if (event.type === 'run.failed') tags.push('failed');\n    return tags;\n  }\n}\n","import { defineTelescopeExtension } from '@dudousxd/nestjs-telescope';\nimport { durableDashboard } from './durable-dashboard.spec-data';\nimport {\n  durableDurationProvider,\n  durableRecentFailuresProvider,\n  durableRunsOverTimeProvider,\n  durableStateBreakdownProvider,\n  durableStateProvider,\n  durableSuccessRateProvider,\n  durableThroughputProvider,\n  durableTimeseriesProvider,\n  durableWorkerHealthProvider,\n} from './durable-data-providers';\nimport { DurableTelescopeWatcher } from './durable-telescope.watcher';\n\n/** The first-class Telescope extension for nestjs-durable: watcher + Workflows dashboard. */\nexport function durableTelescopeExtension(\n  opts: { runHref?: string; recentFailuresWindowMs?: number } = {},\n) {\n  return defineTelescopeExtension({\n    name: 'durable',\n    watchers: () => [new DurableTelescopeWatcher()],\n    entryTypes: () => [{ id: 'durable', label: 'Workflows', dot: 'bg-amber-400' }],\n    dashboards: () => [durableDashboard(opts)],\n    dataProviders: () => [\n      durableStateProvider(),\n      durableTimeseriesProvider(),\n      durableRecentFailuresProvider(),\n      durableWorkerHealthProvider(),\n      durableDurationProvider(),\n      durableRunsOverTimeProvider(),\n      durableSuccessRateProvider(),\n      durableThroughputProvider(),\n      durableStateBreakdownProvider(),\n    ],\n  });\n}\n","import type { DashboardSpec } from '@dudousxd/nestjs-telescope';\n\n/**\n * The \"Workflows\" health dashboard — golden-signals sections layout.\n *\n * `runHref` is a URL template for deep-linking a run out to the durable dashboard\n * (e.g. '/durable/runs/{runId}'). `recentFailuresWindowMs` bounds the \"Stuck runs\"\n * table (default 24h) so a healthy system shows an empty table instead of\n * days-old failures; pass `0` to show all.\n */\nexport function durableDashboard(\n  opts: { runHref?: string; recentFailuresWindowMs?: number } = {},\n): DashboardSpec {\n  const runHref = opts.runHref ?? '/durable/runs/{runId}';\n  const windowMs = opts.recentFailuresWindowMs ?? 24 * 60 * 60 * 1000;\n  return {\n    id: 'durable.workflows',\n    label: 'Workflows',\n    panels: [],\n    sections: [\n      {\n        title: 'Health',\n        cols: 4,\n        panels: [\n          {\n            kind: 'gauge',\n            title: 'Success rate',\n            data: { provider: 'durable.successRate' },\n            max: 1,\n            format: 'percent',\n            thresholds: { warn: 0.98, bad: 0.95, direction: 'down-bad' },\n          },\n          {\n            kind: 'stat',\n            title: 'Duration p95',\n            data: { provider: 'durable.duration', query: { metric: 'p95' } },\n            format: 'duration',\n            spark: false,\n            thresholds: { warn: 2000, bad: 5000, direction: 'up-bad' },\n          },\n          {\n            kind: 'stat',\n            title: 'Backlog',\n            data: { provider: 'durable.state', query: { status: 'pending' } },\n            spark: false,\n            thresholds: { warn: 50, bad: 200, direction: 'up-bad' },\n          },\n          {\n            kind: 'stat',\n            title: 'Throughput',\n            data: { provider: 'durable.throughput' },\n            format: 'rate',\n            spark: true,\n          },\n        ],\n      },\n      {\n        title: 'Needs attention',\n        cols: 3,\n        panels: [\n          {\n            kind: 'topN',\n            title: 'Top failing workflows',\n            data: { provider: 'durable.timeseries', query: { metric: 'topFailures' } },\n            limit: 8,\n          },\n          {\n            kind: 'table',\n            title: 'Stuck runs',\n            data: { provider: 'durable.recentFailures', query: { windowMs } },\n            columns: [\n              { key: 'updatedAt', label: 'Updated' },\n              { key: 'workflow', label: 'Workflow' },\n              { key: 'runId', label: 'Run', link: { href: runHref } },\n              { key: 'error', label: 'Error' },\n            ],\n          },\n          {\n            kind: 'table',\n            title: 'Starved worker groups',\n            data: { provider: 'durable.workerHealth' },\n            columns: [\n              { key: 'group', label: 'Group' },\n              { key: 'queued', label: 'Queued' },\n              { key: 'liveWorkers', label: 'Workers' },\n              { key: 'status', label: 'Status' },\n            ],\n          },\n        ],\n      },\n      {\n        title: 'Trends',\n        cols: 3,\n        panels: [\n          {\n            kind: 'timeseries',\n            title: 'Runs over time',\n            data: { provider: 'durable.runsOverTime' },\n            series: ['done', 'failed'],\n            style: 'stacked',\n          },\n          {\n            kind: 'distribution',\n            title: 'Duration distribution',\n            data: { provider: 'durable.duration' },\n            markers: ['p50', 'p95', 'p99'],\n            format: 'duration',\n          },\n          {\n            kind: 'breakdown',\n            title: 'Runs by state',\n            data: { provider: 'durable.stateBreakdown' },\n            style: 'donut',\n          },\n        ],\n      },\n    ],\n  };\n}\n","import { STATE_STORE_CANONICAL, WorkflowEngine } from '@dudousxd/nestjs-durable-core';\nimport type { RunStatus, StateStore } from '@dudousxd/nestjs-durable-core';\nimport type { DataProvider, ExtensionContext } from '@dudousxd/nestjs-telescope';\nimport { TELESCOPE_STORAGE } from '@dudousxd/nestjs-telescope';\n\n// ─── Shared helpers ───────────────────────────────────────────────────────────\n\n/** Compute the p-th percentile of a SORTED array. */\nfunction percentile(sorted: number[], p: number): number {\n  if (sorted.length === 0) return 0;\n  const idx = Math.min(sorted.length - 1, Math.ceil((p / 100) * sorted.length) - 1);\n  return sorted[Math.max(0, idx)] ?? 0;\n}\n\ntype StorageEntry = { content?: unknown; createdAt?: Date };\n\n/** Fetch the durable entry page from TELESCOPE_STORAGE. */\nasync function fetchEntries(ctx: ExtensionContext): Promise<StorageEntry[]> {\n  const storage = ctx.moduleRef.get(TELESCOPE_STORAGE, { strict: false }) as {\n    get(q: { type?: string; limit?: number }): Promise<{ data: StorageEntry[] }>;\n  };\n  const page = await storage.get({ type: 'durable', limit: 5_000 });\n  return page.data;\n}\n\n/**\n * Split entries into current/previous equal-length windows.\n *  current:  (now - windowMs, now]\n *  previous: (now - 2*windowMs, now - windowMs]\n */\nfunction splitWindows(\n  entries: StorageEntry[],\n  windowMs: number,\n  now: number,\n): { current: StorageEntry[]; previous: StorageEntry[] } {\n  const start = now - windowMs;\n  const prevStart = start - windowMs;\n  return {\n    current: entries.filter((e) => {\n      const t = e.createdAt ? +new Date(e.createdAt) : 0;\n      return t > start && t <= now;\n    }),\n    previous: entries.filter((e) => {\n      const t = e.createdAt ? +new Date(e.createdAt) : 0;\n      return t > prevStart && t <= start;\n    }),\n  };\n}\n\n/** Compute success rate (completed / total) for a list of entries, returns 1 when no data. */\nfunction successRateOf(entries: StorageEntry[]): number {\n  let completed = 0;\n  let failed = 0;\n  for (const e of entries) {\n    const c = (e.content ?? {}) as { event?: string };\n    if (c.event === 'run.completed') completed += 1;\n    else if (c.event === 'run.failed') failed += 1;\n  }\n  const total = completed + failed;\n  return total === 0 ? 1 : completed / total;\n}\n\nconst STATE_CAP = 10_000;\n\n// ─── Existing providers ───────────────────────────────────────────────────────\n\n/** Source C: current-state gauge from the durable store. query.status selects which (default 'dead'). */\nexport function durableStateProvider(): DataProvider {\n  return {\n    name: 'durable.state',\n    async resolve(query, ctx: ExtensionContext) {\n      const store = ctx.moduleRef.get(STATE_STORE_CANONICAL, { strict: false }) as StateStore;\n      const status = (query?.status as RunStatus) ?? 'dead';\n      const runs = await store.listRuns({ status, limit: STATE_CAP });\n      return { value: runs.length };\n    },\n  };\n}\n\n/**\n * Source A: rollups from captured `durable` entries in Telescope's own storage.\n * Reads recent run.* lifecycle entries and aggregates. Bounded by Telescope's prune\n * window (by design — this is the \"history\" series, not the source of truth).\n */\nexport function durableTimeseriesProvider(): DataProvider {\n  return {\n    name: 'durable.timeseries',\n    async resolve(query, ctx: ExtensionContext) {\n      // TELESCOPE_STORAGE.get(query) → { data: Entry[]; nextCursor }. Entry = { content, createdAt, ... }.\n      const storage = ctx.moduleRef.get(TELESCOPE_STORAGE, { strict: false }) as {\n        get(q: { type?: string; limit?: number }): Promise<{\n          data: Array<{ content?: unknown; createdAt?: Date }>;\n        }>;\n      };\n      const limit = Math.min(5_000, Math.max(100, Number(query?.limit ?? 2_000)));\n      const page = await storage.get({ type: 'durable', limit });\n\n      let completed = 0;\n      let failed = 0;\n      const failByWorkflow = new Map<string, number>();\n      for (const e of page.data) {\n        const c = (e.content ?? {}) as { event?: string; workflow?: string };\n        if (c.event === 'run.completed') completed += 1;\n        else if (c.event === 'run.failed') {\n          failed += 1;\n          const wf = c.workflow ?? 'unknown';\n          failByWorkflow.set(wf, (failByWorkflow.get(wf) ?? 0) + 1);\n        }\n      }\n      const total = completed + failed;\n      const metric = (query?.metric as string) ?? 'successRate';\n      if (metric === 'successRate') return { value: total === 0 ? 1 : completed / total };\n      if (metric === 'failed') return { value: failed };\n      if (metric === 'total') return { value: total };\n      if (metric === 'topFailures') {\n        const items = [...failByWorkflow.entries()]\n          .map(([label, value]) => ({ label, value }))\n          .sort((a, b) => b.value - a.value);\n        return { items };\n      }\n      return { value: total };\n    },\n  };\n}\n\n/**\n * Source C: recent failed + dead runs as table rows (newest first), time-bounded.\n * Only failures updated within `query.windowMs` (default 24h) are returned, so a\n * healthy system shows an EMPTY table instead of surfacing days-old failures as if\n * they were a live incident. `windowMs: 0` disables the window (return all). Each\n * row carries a compact `updatedAt` stamp so recency is visible in the table.\n */\nexport function durableRecentFailuresProvider(): DataProvider {\n  return {\n    name: 'durable.recentFailures',\n    async resolve(query, ctx: ExtensionContext) {\n      const store = ctx.moduleRef.get(STATE_STORE_CANONICAL, { strict: false }) as StateStore;\n      const limit = Math.min(200, Math.max(10, Number(query?.limit ?? 50)));\n      const windowMs = query?.windowMs === undefined ? 24 * 60 * 60 * 1000 : Number(query.windowMs);\n      const cutoff = windowMs > 0 ? Date.now() - windowMs : 0;\n      const [failed, dead] = await Promise.all([\n        store.listRuns({ status: 'failed', limit }),\n        store.listRuns({ status: 'dead', limit }),\n      ]);\n      const rows = [...failed, ...dead]\n        .filter((r) => +new Date(r.updatedAt) >= cutoff)\n        .sort((a, b) => +new Date(b.updatedAt) - +new Date(a.updatedAt))\n        .slice(0, limit)\n        .map((r) => ({\n          // Compact UTC stamp (\"YYYY-MM-DD HH:mm Z\"); the generic table renderer\n          // prints column values as-is, so we format here.\n          updatedAt: `${new Date(r.updatedAt).toISOString().replace('T', ' ').slice(0, 16)}Z`,\n          workflow: r.workflow,\n          runId: r.id,\n          error: r.error?.message ?? '',\n        }));\n      return { rows };\n    },\n  };\n}\n\n/**\n * Source D: per-group worker health from the engine (`WorkflowEngine.workerHealth()` — queue depth\n * vs. live worker heartbeats). `query.metric: 'starvedCount'` returns the number of groups with work\n * queued and zero live workers (the \"alive but not consuming\" alert state) as a stat; otherwise a\n * table, starved groups sorted first. Empty when the transport can't report health (in-process).\n */\nexport function durableWorkerHealthProvider(): DataProvider {\n  return {\n    name: 'durable.workerHealth',\n    async resolve(query, ctx: ExtensionContext) {\n      const engine = ctx.moduleRef.get(WorkflowEngine, { strict: false }) as WorkflowEngine;\n      const health = await engine.workerHealth();\n      const isStarved = (g: { depth: number; liveWorkers: unknown[] }) =>\n        g.depth > 0 && g.liveWorkers.length === 0;\n      if ((query?.metric as string) === 'starvedCount') {\n        return { value: health.filter(isStarved).length };\n      }\n      const rows = health\n        .slice()\n        // Starved groups first, then deepest backlog — the rows that need attention rise to the top.\n        .sort((a, b) => Number(isStarved(b)) - Number(isStarved(a)) || b.depth - a.depth)\n        .map((g) => ({\n          group: g.group,\n          queued: g.depth,\n          liveWorkers: g.liveWorkers.length,\n          status: isStarved(g) ? 'STARVED' : 'ok',\n        }));\n      return { rows };\n    },\n  };\n}\n\n// ─── New golden-signals providers ────────────────────────────────────────────\n\n/**\n * Duration percentiles (p50/p95/p99) + a histogram of ~8 buckets.\n * Durations are read from `content.durationMs` on `run.completed`/`run.failed`; when absent,\n * computed by pairing a `run.started` and its corresponding `run.completed`/`run.failed` entry\n * by `runId` using their `createdAt` timestamps.\n *\n * With `query.metric === 'p50'|'p95'|'p99'` returns `{ value }` for use as a stat panel.\n */\nexport function durableDurationProvider(): DataProvider {\n  return {\n    name: 'durable.duration',\n    async resolve(query, ctx: ExtensionContext) {\n      const entries = await fetchEntries(ctx);\n\n      // Index run.started entries by runId for the pairing fallback.\n      const startedAt = new Map<string, number>();\n      for (const e of entries) {\n        const c = (e.content ?? {}) as { event?: string; runId?: string };\n        if (c.event === 'run.started' && c.runId && e.createdAt) {\n          startedAt.set(c.runId, +new Date(e.createdAt));\n        }\n      }\n\n      const durs: number[] = [];\n      for (const e of entries) {\n        const c = (e.content ?? {}) as { event?: string; runId?: string; durationMs?: number };\n        if (c.event === 'run.completed' || c.event === 'run.failed') {\n          if (typeof c.durationMs === 'number') {\n            durs.push(c.durationMs);\n          } else if (c.runId) {\n            const start = startedAt.get(c.runId);\n            const end = e.createdAt ? +new Date(e.createdAt) : undefined;\n            if (start !== undefined && end !== undefined && end >= start) {\n              durs.push(end - start);\n            }\n          }\n        }\n      }\n      durs.sort((a, b) => a - b);\n\n      const p50 = percentile(durs, 50);\n      const p95 = percentile(durs, 95);\n      const p99 = percentile(durs, 99);\n\n      // Stat shortcut: return a single value for use in stat panels.\n      const metric = (query as Record<string, unknown>)?.metric as string | undefined;\n      if (metric === 'p50') return { value: p50 };\n      if (metric === 'p95') return { value: p95 };\n      if (metric === 'p99') return { value: p99 };\n\n      // Build ~8 equal-width buckets between 0 and max.\n      const max = durs.at(-1) ?? 0;\n      const bucketCount = 8;\n      const size = Math.max(1, Math.ceil((max + 1) / bucketCount));\n      const buckets = Array.from({ length: bucketCount }, (_, i) => ({\n        label: `${Math.round((i * size) / 100) / 10}s`,\n        count: 0,\n      }));\n      for (const d of durs) {\n        const bi = Math.min(bucketCount - 1, Math.floor(d / size));\n        const bucket = buckets[bi];\n        if (bucket) bucket.count += 1;\n      }\n\n      return { buckets, p50, p95, p99 };\n    },\n  };\n}\n\n/**\n * Buckets `run.completed` (-> done) and `run.failed` (-> failed) entries by `createdAt` into\n * N=`query.buckets ?? 24` equal-width time buckets.  Returns `{ rows: Array<{ label; done; failed }> }`.\n */\nexport function durableRunsOverTimeProvider(): DataProvider {\n  return {\n    name: 'durable.runsOverTime',\n    async resolve(query, ctx: ExtensionContext) {\n      const entries = await fetchEntries(ctx);\n      const n = Number((query as Record<string, unknown>)?.buckets ?? 24);\n      const now = Date.now();\n\n      // Determine the time window from the oldest entry or default to 24h.\n      let minT = now;\n      for (const e of entries) {\n        if (e.createdAt) {\n          const t = +new Date(e.createdAt);\n          if (t < minT) minT = t;\n        }\n      }\n      const span = Math.max(now - minT, 1);\n      const bucketSize = span / n;\n\n      const rows: Array<{ label: string; done: number; failed: number }> = Array.from(\n        { length: n },\n        (_, i) => {\n          const bucketStart = new Date(minT + i * bucketSize);\n          const label = bucketStart.toISOString().slice(11, 16); // \"HH:mm\"\n          return { label, done: 0, failed: 0 };\n        },\n      );\n\n      for (const e of entries) {\n        const c = (e.content ?? {}) as { event?: string };\n        if (c.event !== 'run.completed' && c.event !== 'run.failed') continue;\n        const t = e.createdAt ? +new Date(e.createdAt) : 0;\n        const idx = Math.min(n - 1, Math.floor((t - minT) / bucketSize));\n        const row = rows[idx];\n        if (row) {\n          if (c.event === 'run.completed') row.done += 1;\n          else row.failed += 1;\n        }\n      }\n\n      return { rows };\n    },\n  };\n}\n\n/**\n * Success rate over the last `query.windowMs` (default 24h), with a `delta` vs. the previous\n * equal-length window and a `spark` array of per-sub-bucket success rates.\n */\nexport function durableSuccessRateProvider(): DataProvider {\n  return {\n    name: 'durable.successRate',\n    async resolve(query, ctx: ExtensionContext) {\n      const entries = await fetchEntries(ctx);\n      const windowMs = Number((query as Record<string, unknown>)?.windowMs ?? 24 * 60 * 60 * 1000);\n      const now = Date.now();\n      const { current, previous } = splitWindows(entries, windowMs, now);\n\n      const value = successRateOf(current);\n      const prevRate = successRateOf(previous);\n      const delta = previous.length > 0 ? value - prevRate : undefined;\n\n      // Spark: split the current window into 8 sub-buckets.\n      const sparkBuckets = 8;\n      const bucketSize = windowMs / sparkBuckets;\n      const sparkStart = now - windowMs;\n      const spark = Array.from({ length: sparkBuckets }, (_, i) => {\n        const bStart = sparkStart + i * bucketSize;\n        const bEnd = bStart + bucketSize;\n        const bEntries = current.filter((e) => {\n          const t = e.createdAt ? +new Date(e.createdAt) : 0;\n          return t > bStart && t <= bEnd;\n        });\n        return successRateOf(bEntries);\n      });\n\n      return { value, delta, spark };\n    },\n  };\n}\n\n/**\n * Completed runs per hour over the last `query.windowMs` (default 24h), with a `delta` vs. the\n * previous equal-length window and a `spark` array of per-sub-bucket throughput values.\n */\nexport function durableThroughputProvider(): DataProvider {\n  return {\n    name: 'durable.throughput',\n    async resolve(query, ctx: ExtensionContext) {\n      const entries = await fetchEntries(ctx);\n      const windowMs = Number((query as Record<string, unknown>)?.windowMs ?? 24 * 60 * 60 * 1000);\n      const now = Date.now();\n      const { current, previous } = splitWindows(entries, windowMs, now);\n\n      const countCompleted = (es: StorageEntry[]) =>\n        es.filter((e) => ((e.content ?? {}) as { event?: string }).event === 'run.completed')\n          .length;\n\n      const windowHours = windowMs / (60 * 60 * 1000);\n      const value = countCompleted(current) / windowHours;\n      const prevValue = countCompleted(previous) / windowHours;\n      const delta = previous.length > 0 ? value - prevValue : undefined;\n\n      // Spark: 8 sub-buckets of current window.\n      const sparkBuckets = 8;\n      const bucketSize = windowMs / sparkBuckets;\n      const bucketHours = bucketSize / (60 * 60 * 1000);\n      const sparkStart = now - windowMs;\n      const spark = Array.from({ length: sparkBuckets }, (_, i) => {\n        const bStart = sparkStart + i * bucketSize;\n        const bEnd = bStart + bucketSize;\n        const bEntries = current.filter((e) => {\n          const t = e.createdAt ? +new Date(e.createdAt) : 0;\n          return t > bStart && t <= bEnd;\n        });\n        return countCompleted(bEntries) / bucketHours;\n      });\n\n      return { value, delta, spark };\n    },\n  };\n}\n\n/** Color palette for the state breakdown pie segments. */\nconst STATE_BREAKDOWN_PALETTE = ['#34d399', '#fbbf24', '#f87171', '#38bdf8', '#a78bfa'];\nconst STATE_BREAKDOWN_STATUSES: RunStatus[] = ['running', 'pending', 'completed', 'failed', 'dead'];\n\n/**\n * Counts from `STATE_STORE.listRuns({ status })` for each of the 5 statuses and returns pie\n * segments with the standard palette: `{ segments: Array<{ label, value, color }> }`.\n */\nexport function durableStateBreakdownProvider(): DataProvider {\n  return {\n    name: 'durable.stateBreakdown',\n    async resolve(_query, ctx: ExtensionContext) {\n      const store = ctx.moduleRef.get(STATE_STORE_CANONICAL, { strict: false }) as StateStore;\n      const counts = await Promise.all(\n        STATE_BREAKDOWN_STATUSES.map((status) =>\n          store.listRuns({ status, limit: STATE_CAP }).then((runs) => runs.length),\n        ),\n      );\n      const segments = STATE_BREAKDOWN_STATUSES.map((label, i) => ({\n        label,\n        value: counts[i],\n        color: STATE_BREAKDOWN_PALETTE[i],\n      }));\n      return { segments };\n    },\n  };\n}\n\n// NOTE: durableRetryHotspotsProvider is NOT implemented.\n// StateStore only exposes `listCheckpoints(runId: string)` (per-run lookup), with no cross-run\n// query by step `attempts`. There is no API to enumerate all step checkpoints across runs without\n// first listing every run — which would be O(N*M) and impractical. Task 13 should omit that panel.\n"],"mappings":"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","names":["WorkflowEngine","SpanStatusCode","context","trace","DurableTelescopeWatcher","type","roots","Map","register","ctx","engine","moduleRef","get","WorkflowEngine","strict","tracer","trace","getTracer","subscribe","event","record","content","workflow","runId","seq","name","kind","output","error","durationMs","tags","set","startSpan","attributes","root","base","setSpan","context","active","step","with","end","delete","message","setStatus","undefined","code","SpanStatusCode","ERROR","push","defineTelescopeExtension","durableDashboard","opts","runHref","windowMs","recentFailuresWindowMs","id","label","panels","sections","title","cols","kind","data","provider","max","format","thresholds","warn","bad","direction","query","metric","spark","status","limit","columns","key","link","href","series","style","markers","STATE_STORE_CANONICAL","WorkflowEngine","TELESCOPE_STORAGE","percentile","sorted","p","length","idx","Math","min","ceil","max","fetchEntries","ctx","storage","moduleRef","get","TELESCOPE_STORAGE","strict","page","type","limit","data","splitWindows","entries","windowMs","now","start","prevStart","current","filter","e","t","createdAt","Date","previous","successRateOf","completed","failed","c","content","event","total","STATE_CAP","durableStateProvider","name","resolve","query","store","STATE_STORE_CANONICAL","status","runs","listRuns","value","durableTimeseriesProvider","Number","failByWorkflow","Map","wf","workflow","set","metric","items","map","label","sort","a","b","durableRecentFailuresProvider","undefined","cutoff","dead","Promise","all","rows","r","updatedAt","slice","toISOString","replace","runId","id","error","message","durableWorkerHealthProvider","engine","WorkflowEngine","health","workerHealth","isStarved","g","depth","liveWorkers","group","queued","durableDurationProvider","startedAt","durs","durationMs","push","end","p50","p95","p99","at","bucketCount","size","buckets","Array","from","_","i","round","count","d","bi","floor","bucket","durableRunsOverTimeProvider","n","minT","span","bucketSize","bucketStart","done","row","durableSuccessRateProvider","prevRate","delta","sparkBuckets","sparkStart","spark","bStart","bEnd","bEntries","durableThroughputProvider","countCompleted","es","windowHours","prevValue","bucketHours","STATE_BREAKDOWN_PALETTE","STATE_BREAKDOWN_STATUSES","durableStateBreakdownProvider","_query","counts","then","segments","color","durableTelescopeExtension","opts","defineTelescopeExtension","name","watchers","DurableTelescopeWatcher","entryTypes","id","label","dot","dashboards","durableDashboard","dataProviders","durableStateProvider","durableTimeseriesProvider","durableRecentFailuresProvider","durableWorkerHealthProvider","durableDurationProvider","durableRunsOverTimeProvider","durableSuccessRateProvider","durableThroughputProvider","durableStateBreakdownProvider"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-durable-telescope",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Telescope watcher for nestjs-durable — workflow runs and steps as Telescope entries",
   "license": "MIT",
   "author": "Davide Carvalho",
@@ -9,9 +9,9 @@
     "url": "https://github.com/DavideCarvalho/nestjs-durable.git",
     "directory": "packages/telescope"
   },
-  "type": "commonjs",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ],
@@ -22,14 +22,28 @@
     "@opentelemetry/api": "^1.0.0"
   },
   "devDependencies": {
-    "@dudousxd/nestjs-telescope": "1.8.0",
+    "@dudousxd/nestjs-telescope": "1.10.0",
     "@nestjs/core": "11.1.26",
     "@opentelemetry/api": "1.9.0",
     "typescript": "5.9.3",
-    "@dudousxd/nestjs-durable-core": "^0.23.0"
+    "tsup": "8.3.5",
+    "@dudousxd/nestjs-durable-core": "^0.32.1"
+  },
+  "module": "./dist/index.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "tsup",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   }
 }

package/dist/durable-dashboard.spec-data.d.ts

@@ -1,12 +0,0 @@
-import type { DashboardSpec } from '@dudousxd/nestjs-telescope';
-/**
- * The "Workflows" health dashboard. `runHref` is a URL template for deep-linking a run
- * out to the durable dashboard (e.g. '/durable/runs/{runId}'). `recentFailuresWindowMs`
- * bounds the "Recent failed runs" table (default 24h) so a healthy system shows an empty
- * table instead of days-old failures; pass `0` to show all.
- */
-export declare function durableDashboard(opts?: {
-    runHref?: string;
-    recentFailuresWindowMs?: number;
-}): DashboardSpec;
-//# sourceMappingURL=durable-dashboard.spec-data.d.ts.map

package/dist/durable-dashboard.spec-data.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"durable-dashboard.spec-data.d.ts","sourceRoot":"","sources":["../src/durable-dashboard.spec-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,aAAa,CA6Ef"}

package/dist/durable-dashboard.spec-data.js

@@ -1,88 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.durableDashboard = durableDashboard;
-/**
- * The "Workflows" health dashboard. `runHref` is a URL template for deep-linking a run
- * out to the durable dashboard (e.g. '/durable/runs/{runId}'). `recentFailuresWindowMs`
- * bounds the "Recent failed runs" table (default 24h) so a healthy system shows an empty
- * table instead of days-old failures; pass `0` to show all.
- */
-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: [
-            {
-                kind: 'stat',
-                title: 'Success rate',
-                data: { provider: 'durable.timeseries', query: { metric: 'successRate' } },
-                format: 'percent',
-                accent: 'text-emerald-400',
-            },
-            {
-                kind: 'stat',
-                title: 'Failed (window)',
-                data: { provider: 'durable.timeseries', query: { metric: 'failed' } },
-                accent: 'text-red-400',
-            },
-            {
-                kind: 'stat',
-                title: 'Dead now',
-                data: { provider: 'durable.state', query: { status: 'dead' } },
-                accent: 'text-red-400',
-            },
-            {
-                kind: 'stat',
-                title: 'Suspended now',
-                data: { provider: 'durable.state', query: { status: 'suspended' } },
-            },
-            {
-                kind: 'stat',
-                title: 'Running now',
-                data: { provider: 'durable.state', query: { status: 'running' } },
-            },
-            {
-                kind: 'stat',
-                title: 'Pending now',
-                data: { provider: 'durable.state', query: { status: 'pending' } },
-            },
-            {
-                kind: 'stat',
-                title: 'Starved groups',
-                data: { provider: 'durable.workerHealth', query: { metric: 'starvedCount' } },
-                accent: 'text-red-400',
-            },
-            {
-                kind: 'topN',
-                title: 'Top failing workflows',
-                data: { provider: 'durable.timeseries', query: { metric: 'topFailures' } },
-                limit: 10,
-            },
-            {
-                kind: 'table',
-                title: 'Worker groups (backlog vs. live workers)',
-                data: { provider: 'durable.workerHealth', query: {} },
-                columns: [
-                    { key: 'group', label: 'Group' },
-                    { key: 'queued', label: 'Queued' },
-                    { key: 'liveWorkers', label: 'Live workers' },
-                    { key: 'status', label: 'Status' },
-                ],
-            },
-            {
-                kind: 'table',
-                title: 'Recent failed runs (last 24h)',
-                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' },
-                ],
-            },
-        ],
-    };
-}
-//# sourceMappingURL=durable-dashboard.spec-data.js.map

package/dist/durable-dashboard.spec-data.js.map

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

package/dist/durable-data-providers.d.ts

@@ -1,25 +0,0 @@
-import type { DataProvider } from '@dudousxd/nestjs-telescope';
-/** Source C: current-state gauge from the durable store. query.status selects which (default 'dead'). */
-export declare function durableStateProvider(): DataProvider;
-/**
- * Source A: rollups from captured `durable` entries in Telescope's own storage.
- * Reads recent run.* lifecycle entries and aggregates. Bounded by Telescope's prune
- * window (by design — this is the "history" series, not the source of truth).
- */
-export declare function durableTimeseriesProvider(): DataProvider;
-/**
- * Source C: recent failed + dead runs as table rows (newest first), time-bounded.
- * Only failures updated within `query.windowMs` (default 24h) are returned, so a
- * healthy system shows an EMPTY table instead of surfacing days-old failures as if
- * they were a live incident. `windowMs: 0` disables the window (return all). Each
- * row carries a compact `updatedAt` stamp so recency is visible in the table.
- */
-export declare function durableRecentFailuresProvider(): DataProvider;
-/**
- * Source D: per-group worker health from the engine (`WorkflowEngine.workerHealth()` — queue depth
- * vs. live worker heartbeats). `query.metric: 'starvedCount'` returns the number of groups with work
- * queued and zero live workers (the "alive but not consuming" alert state) as a stat; otherwise a
- * table, starved groups sorted first. Empty when the transport can't report health (in-process).
- */
-export declare function durableWorkerHealthProvider(): DataProvider;
-//# sourceMappingURL=durable-data-providers.d.ts.map

package/dist/durable-data-providers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"durable-data-providers.d.ts","sourceRoot":"","sources":["../src/durable-data-providers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,4BAA4B,CAAC;AAKjF,yGAAyG;AACzG,wBAAgB,oBAAoB,IAAI,YAAY,CAUnD;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,YAAY,CAuCxD;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,IAAI,YAAY,CA2B5D;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,YAAY,CAwB1D"}

package/dist/durable-data-providers.js

@@ -1,131 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.durableStateProvider = durableStateProvider;
-exports.durableTimeseriesProvider = durableTimeseriesProvider;
-exports.durableRecentFailuresProvider = durableRecentFailuresProvider;
-exports.durableWorkerHealthProvider = durableWorkerHealthProvider;
-const nestjs_durable_core_1 = require("@dudousxd/nestjs-durable-core");
-const nestjs_telescope_1 = require("@dudousxd/nestjs-telescope");
-const STATE_CAP = 10_000;
-/** Source C: current-state gauge from the durable store. query.status selects which (default 'dead'). */
-function durableStateProvider() {
-    return {
-        name: 'durable.state',
-        async resolve(query, ctx) {
-            const store = ctx.moduleRef.get(nestjs_durable_core_1.STATE_STORE, { strict: false });
-            const status = query?.status ?? 'dead';
-            const runs = await store.listRuns({ status, limit: STATE_CAP });
-            return { value: runs.length };
-        },
-    };
-}
-/**
- * Source A: rollups from captured `durable` entries in Telescope's own storage.
- * Reads recent run.* lifecycle entries and aggregates. Bounded by Telescope's prune
- * window (by design — this is the "history" series, not the source of truth).
- */
-function durableTimeseriesProvider() {
-    return {
-        name: 'durable.timeseries',
-        async resolve(query, ctx) {
-            // TELESCOPE_STORAGE.get(query) → { data: Entry[]; nextCursor }. Entry = { content, createdAt, ... }.
-            const storage = ctx.moduleRef.get(nestjs_telescope_1.TELESCOPE_STORAGE, { strict: false });
-            const limit = Math.min(5_000, Math.max(100, Number(query?.limit ?? 2_000)));
-            const page = await storage.get({ type: 'durable', limit });
-            let completed = 0;
-            let failed = 0;
-            const failByWorkflow = new Map();
-            for (const e of page.data) {
-                const c = (e.content ?? {});
-                if (c.event === 'run.completed')
-                    completed += 1;
-                else if (c.event === 'run.failed') {
-                    failed += 1;
-                    const wf = c.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 };
-        },
-    };
-}
-/**
- * Source C: recent failed + dead runs as table rows (newest first), time-bounded.
- * Only failures updated within `query.windowMs` (default 24h) are returned, so a
- * healthy system shows an EMPTY table instead of surfacing days-old failures as if
- * they were a live incident. `windowMs: 0` disables the window (return all). Each
- * row carries a compact `updatedAt` stamp so recency is visible in the table.
- */
-function durableRecentFailuresProvider() {
-    return {
-        name: 'durable.recentFailures',
-        async resolve(query, ctx) {
-            const store = ctx.moduleRef.get(nestjs_durable_core_1.STATE_STORE, { strict: false });
-            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([
-                store.listRuns({ status: 'failed', limit }),
-                store.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) => ({
-                // Compact UTC stamp ("YYYY-MM-DD HH:mm Z"); the generic table renderer
-                // prints column values as-is, so we format here.
-                updatedAt: `${new Date(r.updatedAt).toISOString().replace('T', ' ').slice(0, 16)}Z`,
-                workflow: r.workflow,
-                runId: r.id,
-                error: r.error?.message ?? '',
-            }));
-            return { rows };
-        },
-    };
-}
-/**
- * Source D: per-group worker health from the engine (`WorkflowEngine.workerHealth()` — queue depth
- * vs. live worker heartbeats). `query.metric: 'starvedCount'` returns the number of groups with work
- * queued and zero live workers (the "alive but not consuming" alert state) as a stat; otherwise a
- * table, starved groups sorted first. Empty when the transport can't report health (in-process).
- */
-function durableWorkerHealthProvider() {
-    return {
-        name: 'durable.workerHealth',
-        async resolve(query, ctx) {
-            const engine = ctx.moduleRef.get(nestjs_durable_core_1.WorkflowEngine, { strict: false });
-            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()
-                // Starved groups first, then deepest backlog — the rows that need attention rise to the top.
-                .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 };
-        },
-    };
-}
-//# sourceMappingURL=durable-data-providers.js.map

package/dist/durable-data-providers.js.map

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

package/dist/durable-telescope.extension.d.ts

@@ -1,6 +0,0 @@
-/** The first-class Telescope extension for nestjs-durable: watcher + Workflows dashboard. */
-export declare function durableTelescopeExtension(opts?: {
-    runHref?: string;
-    recentFailuresWindowMs?: number;
-}): import("@dudousxd/nestjs-telescope").TelescopeExtension;
-//# sourceMappingURL=durable-telescope.extension.d.ts.map

package/dist/durable-telescope.extension.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"durable-telescope.extension.d.ts","sourceRoot":"","sources":["../src/durable-telescope.extension.ts"],"names":[],"mappings":"AAUA,6FAA6F;AAC7F,wBAAgB,yBAAyB,CACvC,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAAO,2DAcjE"}

package/dist/durable-telescope.extension.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.durableTelescopeExtension = durableTelescopeExtension;
-const nestjs_telescope_1 = require("@dudousxd/nestjs-telescope");
-const durable_dashboard_spec_data_1 = require("./durable-dashboard.spec-data");
-const durable_data_providers_1 = require("./durable-data-providers");
-const durable_telescope_watcher_1 = require("./durable-telescope.watcher");
-/** The first-class Telescope extension for nestjs-durable: watcher + Workflows dashboard. */
-function durableTelescopeExtension(opts = {}) {
-    return (0, nestjs_telescope_1.defineTelescopeExtension)({
-        name: 'durable',
-        watchers: () => [new durable_telescope_watcher_1.DurableTelescopeWatcher()],
-        entryTypes: () => [{ id: 'durable', label: 'Workflows', dot: 'bg-amber-400' }],
-        dashboards: () => [(0, durable_dashboard_spec_data_1.durableDashboard)(opts)],
-        dataProviders: () => [
-            (0, durable_data_providers_1.durableStateProvider)(),
-            (0, durable_data_providers_1.durableTimeseriesProvider)(),
-            (0, durable_data_providers_1.durableRecentFailuresProvider)(),
-            (0, durable_data_providers_1.durableWorkerHealthProvider)(),
-        ],
-    });
-}
-//# sourceMappingURL=durable-telescope.extension.js.map

package/dist/durable-telescope.extension.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"durable-telescope.extension.js","sourceRoot":"","sources":["../src/durable-telescope.extension.ts"],"names":[],"mappings":";;AAWA,8DAeC;AA1BD,iEAAsE;AACtE,+EAAiE;AACjE,qEAKkC;AAClC,2EAAsE;AAEtE,6FAA6F;AAC7F,SAAgB,yBAAyB,CACvC,OAA8D,EAAE;IAEhE,OAAO,IAAA,2CAAwB,EAAC;QAC9B,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,mDAAuB,EAAE,CAAC;QAC/C,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;QAC9E,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,IAAA,8CAAgB,EAAC,IAAI,CAAC,CAAC;QAC1C,aAAa,EAAE,GAAG,EAAE,CAAC;YACnB,IAAA,6CAAoB,GAAE;YACtB,IAAA,kDAAyB,GAAE;YAC3B,IAAA,sDAA6B,GAAE;YAC/B,IAAA,oDAA2B,GAAE;SAC9B;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/durable-telescope.watcher.d.ts

@@ -1,23 +0,0 @@
-import type { Watcher, WatcherContext } from '@dudousxd/nestjs-telescope';
-/**
- * A Telescope watcher that turns durable-workflow lifecycle events into Telescope entries, so
- * runs and steps (including remote/Python steps) show up alongside the app's requests, queries
- * and jobs in the Telescope UI — under the **Workflows** tab.
- *
- * It also **trace-groups** a run: a root span is opened per run and every entry is recorded inside
- * that span's OTel context (step entries inside a child `step …` span). Telescope's trace-context
- * provider stamps each entry with the active span, so a whole workflow shows up as a single trace
- * on the Traces page — run → steps — with each entry carrying the run's `traceId`. When the host has
- * no OTel SDK the spans are no-ops and entries simply carry no trace (the prior behaviour).
- *
- * Add it to `TelescopeModule.forRoot({ watchers: [new DurableTelescopeWatcher()] })`. It resolves
- * the engine from the (global) durable providers and subscribes to its events.
- */
-export declare class DurableTelescopeWatcher implements Watcher {
-    readonly type = "durable";
-    /** Open root span per run, so step entries nest under it and share its traceId. */
-    private readonly roots;
-    register(ctx: WatcherContext): void;
-    private tags;
-}
-//# sourceMappingURL=durable-telescope.watcher.d.ts.map

package/dist/durable-telescope.watcher.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"durable-telescope.watcher.d.ts","sourceRoot":"","sources":["../src/durable-telescope.watcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG1E;;;;;;;;;;;;;GAaG;AACH,qBAAa,uBAAwB,YAAW,OAAO;IACrD,QAAQ,CAAC,IAAI,aAAa;IAC1B,mFAAmF;IACnF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IAEjD,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAkEnC,OAAO,CAAC,IAAI;CAOb"}

package/dist/durable-telescope.watcher.js

@@ -1,91 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DurableTelescopeWatcher = void 0;
-const nestjs_durable_core_1 = require("@dudousxd/nestjs-durable-core");
-const api_1 = require("@opentelemetry/api");
-/**
- * A Telescope watcher that turns durable-workflow lifecycle events into Telescope entries, so
- * runs and steps (including remote/Python steps) show up alongside the app's requests, queries
- * and jobs in the Telescope UI — under the **Workflows** tab.
- *
- * It also **trace-groups** a run: a root span is opened per run and every entry is recorded inside
- * that span's OTel context (step entries inside a child `step …` span). Telescope's trace-context
- * provider stamps each entry with the active span, so a whole workflow shows up as a single trace
- * on the Traces page — run → steps — with each entry carrying the run's `traceId`. When the host has
- * no OTel SDK the spans are no-ops and entries simply carry no trace (the prior behaviour).
- *
- * Add it to `TelescopeModule.forRoot({ watchers: [new DurableTelescopeWatcher()] })`. It resolves
- * the engine from the (global) durable providers and subscribes to its events.
- */
-class DurableTelescopeWatcher {
-    type = 'durable';
-    /** Open root span per run, so step entries nest under it and share its traceId. */
-    roots = new Map();
-    register(ctx) {
-        const engine = ctx.moduleRef.get(nestjs_durable_core_1.WorkflowEngine, { strict: false });
-        const tracer = api_1.trace.getTracer('@dudousxd/nestjs-durable-telescope');
-        engine.subscribe((event) => {
-            const record = () => ctx.record({
-                type: this.type,
-                content: {
-                    event: event.type,
-                    workflow: event.workflow,
-                    runId: event.runId,
-                    seq: event.seq,
-                    name: event.name,
-                    kind: event.kind,
-                    output: event.output,
-                    error: event.error,
-                },
-                tags: this.tags(event),
-            });
-            // Open the run's root span on first sight; later events nest under it.
-            if (event.type === 'run.started') {
-                this.roots.set(event.runId, tracer.startSpan(`workflow ${event.workflow ?? '?'}`, {
-                    attributes: { 'durable.run_id': event.runId, 'durable.workflow': event.workflow },
-                }));
-            }
-            const root = this.roots.get(event.runId);
-            const base = root ? api_1.trace.setSpan(api_1.context.active(), root) : api_1.context.active();
-            // A step/signal/sleep event → give it its own child span so it's a distinct node in the
-            // trace; run-level events record directly on the root. Either way the active span at record
-            // time carries the run's traceId, so all entries group into one trace.
-            if (event.name != null && event.seq != null) {
-                const step = tracer.startSpan(`step ${event.name}`, {
-                    attributes: {
-                        'durable.run_id': event.runId,
-                        'durable.step.seq': event.seq,
-                        'durable.step.kind': event.kind,
-                    },
-                }, base);
-                api_1.context.with(api_1.trace.setSpan(base, step), record);
-                step.end();
-            }
-            else {
-                api_1.context.with(base, record);
-            }
-            // Close the run's root span when it leaves the running state.
-            if (event.type === 'run.completed' || event.type === 'run.suspended') {
-                root?.end();
-                this.roots.delete(event.runId);
-            }
-            else if (event.type === 'run.failed') {
-                root?.setStatus({ code: api_1.SpanStatusCode.ERROR, message: event.error?.message });
-                root?.end();
-                this.roots.delete(event.runId);
-            }
-        });
-    }
-    tags(event) {
-        const tags = ['durable', event.type, `run:${event.runId}`];
-        if (event.workflow)
-            tags.push(`workflow:${event.workflow}`);
-        if (event.kind)
-            tags.push(`kind:${event.kind}`);
-        if (event.type === 'run.failed')
-            tags.push('failed');
-        return tags;
-    }
-}
-exports.DurableTelescopeWatcher = DurableTelescopeWatcher;
-//# sourceMappingURL=durable-telescope.watcher.js.map

package/dist/durable-telescope.watcher.js.map

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

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC"}