tempest-express-sdk 0.29.0 → 0.30.0

package/dist/index.cjs

@@ -8673,6 +8673,7 @@ var TaskManager = class {
   broker;
   queue;
   handlers = /* @__PURE__ */ new Map();
+  metadata = /* @__PURE__ */ new Map();
   unsubscribe = null;
   /**
    * @param options - Broker and queue name.
@@ -8686,9 +8687,32 @@ var TaskManager = class {
    *
    * @param name - The task name.
    * @param handler - The handler invoked with the task payload.
+   * @param options - Description and declared schedule, surfaced by
+   *   {@link TaskManager.inventory} and by the admin panel's tasks page.
    */
-  register(name, handler) {
+  register(name, handler, options = {}) {
     this.handlers.set(name, handler);
+    this.metadata.set(name, options);
+  }
+  /**
+   * Return what this process would run, ordered by name.
+   *
+   * This is the **declared** side of background work — the handlers this
+   * process knows about — not queue state. A broker's pending depth is not
+   * something the manager can see, and a screen that implied otherwise would
+   * be worse than one that says nothing.
+   *
+   * @returns One entry per registered task.
+   */
+  inventory() {
+    return [...this.handlers.keys()].sort((left, right) => left.localeCompare(right)).map((name) => {
+      const meta = this.metadata.get(name) ?? {};
+      return {
+        name,
+        description: meta.description ?? null,
+        schedule: meta.schedule ?? null
+      };
+    });
   }
   /**
    * Enqueue a task by name.
@@ -8722,6 +8746,180 @@ var TaskManager = class {
     this.unsubscribe = null;
   }
 };
+var JobStatus = {
+  /** Written, not started. */
+  QUEUED: "queued",
+  /** A worker picked it up. */
+  RUNNING: "running",
+  /** Finished cleanly. */
+  SUCCEEDED: "succeeded",
+  /** Finished with an error. */
+  FAILED: "failed",
+  /** An operator stopped it before it finished. */
+  CANCELLED: "cancelled"
+};
+var TERMINAL = [
+  JobStatus.SUCCEEDED,
+  JobStatus.FAILED,
+  JobStatus.CANCELLED
+];
+var BaseJobModel = class extends BaseModel {
+  /** The task name this run belongs to. */
+  name = tempestDbJs.column.varchar(128).notNull();
+  /** Lifecycle state — a {@link JobStatus} value. */
+  status = tempestDbJs.column.varchar(16).notNull().default(JobStatus.QUEUED);
+  /** The payload the run was started with. */
+  payload = tempestDbJs.column.json();
+  /** Whatever the run produced, for an operator to read afterwards. */
+  result = tempestDbJs.column.json();
+  /** The failure message, when the run failed. */
+  error = tempestDbJs.column.text();
+  /** How many times the run has been attempted. */
+  attempts = tempestDbJs.column.integer().notNull().default(0);
+  /** When a worker picked it up. */
+  startedAt = tempestDbJs.column.datetime();
+  /** When it reached a terminal state. */
+  finishedAt = tempestDbJs.column.datetime();
+};
+var JobStore = class {
+  /**
+   * @param model - The concrete {@link BaseJobModel} subclass.
+   * @param session - The session rows are written on.
+   */
+  constructor(model, session) {
+    this.model = model;
+    this.repository = new tempestDbJs.BaseRepository(model, session);
+  }
+  model;
+  repository;
+  /**
+   * Record a job about to run.
+   *
+   * @param name - The task name.
+   * @param payload - The payload the run was started with.
+   * @returns The created row.
+   */
+  async enqueue(name, payload = {}) {
+    return await this.repository.create({
+      name,
+      status: JobStatus.QUEUED,
+      payload,
+      result: null,
+      error: null,
+      attempts: 0,
+      startedAt: null,
+      finishedAt: null
+    });
+  }
+  /**
+   * Mark a job as picked up, counting the attempt.
+   *
+   * @param id - The job id.
+   * @param attempt - Which attempt this is. Default `1`.
+   * @returns How many rows changed.
+   */
+  async start(id, attempt = 1) {
+    return await this.repository.update(
+      { id },
+      {
+        status: JobStatus.RUNNING,
+        startedAt: /* @__PURE__ */ new Date(),
+        attempts: attempt
+      }
+    );
+  }
+  /**
+   * Mark a job as finished cleanly.
+   *
+   * @param id - The job id.
+   * @param result - Whatever the run produced.
+   * @returns How many rows changed.
+   */
+  async succeed(id, result = {}) {
+    return await this.repository.update(
+      { id },
+      {
+        status: JobStatus.SUCCEEDED,
+        result,
+        error: null,
+        finishedAt: /* @__PURE__ */ new Date()
+      }
+    );
+  }
+  /**
+   * Mark a job as failed.
+   *
+   * @param id - The job id.
+   * @param error - The failure, as an `Error` or a message.
+   * @returns How many rows changed.
+   */
+  async fail(id, error) {
+    return await this.repository.update(
+      { id },
+      {
+        status: JobStatus.FAILED,
+        error: error instanceof Error ? error.message : String(error),
+        finishedAt: /* @__PURE__ */ new Date()
+      }
+    );
+  }
+  /**
+   * Ask a job to stop.
+   *
+   * A job already in a terminal state is left alone and reported as not
+   * cancelled, so an operator clicking cancel on a run that just finished sees
+   * the truth rather than a row rewritten under them.
+   *
+   * @param id - The job id.
+   * @returns Whether the row moved to `cancelled`.
+   */
+  async cancel(id) {
+    const row = await this.repository.getByIdOrNull(id);
+    if (row === null || TERMINAL.includes(String(row.status))) return false;
+    const changed = await this.repository.update(
+      { id },
+      {
+        status: JobStatus.CANCELLED,
+        finishedAt: /* @__PURE__ */ new Date()
+      }
+    );
+    return changed > 0;
+  }
+  /**
+   * Read one job row.
+   *
+   * @param id - The job id.
+   * @returns The row, or `null`.
+   */
+  async get(id) {
+    return await this.repository.getByIdOrNull(id);
+  }
+  /**
+   * Read a page of jobs, newest first.
+   *
+   * @param filter - Page, size and optional `name` / `status` filters.
+   * @returns The page plus its metadata.
+   */
+  async list(filter = {}) {
+    const filters = {};
+    if (filter.name !== void 0 && filter.name !== "") filters.name = filter.name;
+    if (filter.status !== void 0) filters.status = filter.status;
+    const result = await this.repository.paginate({
+      page: filter.page ?? 1,
+      pageSize: filter.pageSize ?? 25,
+      orderBy: "createdAt",
+      ascending: false,
+      ...Object.keys(filters).length === 0 ? {} : { filters }
+    });
+    return {
+      items: result.items,
+      total: result.total,
+      page: result.page,
+      pageSize: result.pageSize,
+      pages: result.pages
+    };
+  }
+};
 
 // src/flags/backends.ts
 function coerceFlag(value) {
@@ -9794,8 +9992,8 @@ function humanizeField(name) {
 function adminColumns(model) {
   return tempestDbJs.columnsOf(model);
 }
-function widgetForColumn(column6) {
-  const { kind, meta } = column6.type;
+function widgetForColumn(column7) {
+  const { kind, meta } = column7.type;
   const plain = (widget) => ({
     widget,
     step: null,
@@ -9839,11 +10037,11 @@ function widgetForColumn(column6) {
       return plain("text");
   }
 }
-function isColumnOptional(column6) {
-  return !column6.flags.notNull || column6.flags.hasDefault || column6.flags.primaryKey;
+function isColumnOptional(column7) {
+  return !column7.flags.notNull || column7.flags.hasDefault || column7.flags.primaryKey;
 }
-function filterForColumn(column6) {
-  const { kind, meta } = column6.type;
+function filterForColumn(column7) {
+  const { kind, meta } = column7.type;
   if (kind === "boolean") {
     return {
       kind: "select",
@@ -9867,11 +10065,11 @@ function filterForColumn(column6) {
   }
   return { kind: "text", options: [] };
 }
-function foreignKeyTable(column6) {
-  return column6.reference?.table ?? null;
+function foreignKeyTable(column7) {
+  return column7.reference?.table ?? null;
 }
-function isSearchableColumn(column6) {
-  const { kind } = column6.type;
+function isSearchableColumn(column7) {
+  const { kind } = column7.type;
   return kind === "varchar" || kind === "text" || kind === "char";
 }
 
@@ -10153,8 +10351,8 @@ function formatFieldValue(widget, value) {
   }
   return String(value);
 }
-function literalDefault(column6) {
-  const fallback = column6.defaultValue;
+function literalDefault(column7) {
+  const fallback = column7.defaultValue;
   if (fallback === null || fallback.kind !== "literal") return void 0;
   return fallback.value;
 }
@@ -10167,19 +10365,19 @@ function buildFormFields(admin, options = {}) {
   const autocompleteLabels = options.autocompleteLabels ?? {};
   const uploads = new Set(admin.uploadFields);
   return admin.editableFieldNames().flatMap((name) => {
-    const column6 = columns[name];
-    if (column6 === void 0) return [];
+    const column7 = columns[name];
+    if (column7 === void 0) return [];
     const related = foreignKeys[name];
     const autocompleteUrl = autocompleteUrls[name];
-    const spec = uploads.has(name) ? { widget: "file", step: null, options: [] } : autocompleteUrl !== void 0 ? { widget: "autocomplete", step: null, options: [] } : related === void 0 ? widgetForColumn(column6) : { widget: "select", step: null, options: related };
-    const raw = name in values ? values[name] : literalDefault(column6);
+    const spec = uploads.has(name) ? { widget: "file", step: null, options: [] } : autocompleteUrl !== void 0 ? { widget: "autocomplete", step: null, options: [] } : related === void 0 ? widgetForColumn(column7) : { widget: "select", step: null, options: related };
+    const raw = name in values ? values[name] : literalDefault(column7);
     return [
       {
         name,
         label: humanizeField(name),
         widget: spec.widget,
         value: spec.widget === "checkbox" ? "" : formatFieldValue(spec.widget, raw),
-        required: !isColumnOptional(column6),
+        required: !isColumnOptional(column7),
         checked: spec.widget === "checkbox" && toBoolean(raw),
         step: spec.step,
         options: spec.options,
@@ -10196,8 +10394,8 @@ function toBoolean(value) {
   if (typeof value !== "string") return false;
   return ["true", "on", "yes", "1"].includes(value.trim().toLowerCase());
 }
-function coerceValue(column6, widget, raw) {
-  const { kind, meta } = column6.type;
+function coerceValue(column7, widget, raw) {
+  const { kind, meta } = column7.type;
   switch (widget) {
     case "number": {
       const parsed = Number(raw);
@@ -10241,10 +10439,10 @@ function parseFormBody(admin, body, options = {}) {
   const only = options.only === void 0 ? null : new Set(options.only);
   for (const name of admin.editableFieldNames()) {
     if (only !== null && !only.has(name)) continue;
-    const column6 = columns[name];
-    if (column6 === void 0) continue;
+    const column7 = columns[name];
+    if (column7 === void 0) continue;
     if (uploads.has(name)) continue;
-    const { widget } = widgetForColumn(column6);
+    const { widget } = widgetForColumn(column7);
     if (widget === "checkbox") {
       data[name] = toBoolean(body[name]);
       continue;
@@ -10252,16 +10450,16 @@ function parseFormBody(admin, body, options = {}) {
     const submitted = body[name];
     const raw = typeof submitted === "string" ? submitted.trim() : "";
     if (raw === "") {
-      if (!isColumnOptional(column6)) {
+      if (!isColumnOptional(column7)) {
         errors[name] = "This field is required.";
         continue;
       }
-      if (column6.flags.hasDefault && !(name in body)) continue;
+      if (column7.flags.hasDefault && !(name in body)) continue;
       data[name] = null;
       continue;
     }
     try {
-      data[name] = coerceValue(column6, widget, raw);
+      data[name] = coerceValue(column7, widget, raw);
     } catch (error) {
       errors[name] = error instanceof Error ? error.message : "Invalid value.";
     }
@@ -10279,9 +10477,9 @@ function foreignKeyFields(admin) {
   const columns = adminColumns(admin.model);
   const out = {};
   for (const name of admin.editableFieldNames()) {
-    const column6 = columns[name];
-    if (column6 === void 0) continue;
-    const table = foreignKeyTable(column6);
+    const column7 = columns[name];
+    if (column7 === void 0) continue;
+    const table = foreignKeyTable(column7);
     if (table !== null) out[name] = table;
   }
   return out;
@@ -10667,7 +10865,14 @@ var AdminSite = class {
 };
 
 // src/admin/styles.ts
-var ADMIN_CSS = `:root {
+var ADMIN_CSS_EXTRA = `
+.tempest-log-badge--succeeded { background: #dcfce7; color: #166534; }
+.tempest-log-badge--failed { background: #fee2e2; color: #991b1b; }
+.tempest-log-badge--running { background: #dbeafe; color: #1e40af; }
+.tempest-log-badge--queued { background: #f1f5f9; color: #475569; }
+.tempest-log-badge--cancelled { background: #fef3c7; color: #92400e; }
+`;
+var ADMIN_CSS_BASE = `:root {
   --tempest-bg: #0f172a;
   --tempest-bg-soft: #1e293b;
   --tempest-bg-row: #f8fafc;
@@ -12226,6 +12431,7 @@ a.tempest-admin-list__new:hover {
   }
 }
 `;
+var ADMIN_CSS = `${ADMIN_CSS_BASE}${ADMIN_CSS_EXTRA}`;
 
 // src/admin/theme.ts
 var FORBIDDEN_CHARS = ["<", ">", "{", "}", '"'];
@@ -12486,11 +12692,11 @@ function renderFilter(filter) {
 function renderListPage(context, view) {
   const bulk = view.bulkActions.length > 0 && context.session !== null;
   const checkColumn = bulk ? 1 : 0;
-  const headers = view.columns.map((column6) => {
-    const state = view.sort[column6];
-    if (state === void 0) return `<th>${escapeHtml(column6)}</th>`;
+  const headers = view.columns.map((column7) => {
+    const state = view.sort[column7];
+    if (state === void 0) return `<th>${escapeHtml(column7)}</th>`;
     const arrow = state.active ? state.ascending ? "\u25B2" : "\u25BC" : "\u2195";
-    return `<th><a class="tempest-sort${state.active ? " tempest-sort--active" : ""}" href="${escapeHtml(state.url)}"><span>${escapeHtml(column6)}</span><span class="tempest-sort__arrow" aria-hidden="true">${arrow}</span></a></th>`;
+    return `<th><a class="tempest-sort${state.active ? " tempest-sort--active" : ""}" href="${escapeHtml(state.url)}"><span>${escapeHtml(column7)}</span><span class="tempest-sort__arrow" aria-hidden="true">${arrow}</span></a></th>`;
   }).join("");
   const rows = view.rows.length > 0 ? view.rows.map((row) => {
     const check = bulk ? `<td class="tempest-admin-list__check"><input type="checkbox" name="ids" value="${escapeHtml(row.identity)}" data-row-check aria-label="Select row"></td>` : "";
@@ -12631,7 +12837,7 @@ function renderInline(inline, csrfToken, error) {
     if (inline.rows.length === 0) {
       return `<section class="tempest-admin-inline">${heading}<p><em>No related records.</em></p></section>`;
     }
-    const head2 = `<tr>${inline.columns.map((column6) => `<th>${escapeHtml(column6)}</th>`).join("")}<th></th></tr>`;
+    const head2 = `<tr>${inline.columns.map((column7) => `<th>${escapeHtml(column7)}</th>`).join("")}<th></th></tr>`;
     const body = inline.rows.map(
       (row) => `<tr>${row.cells.map((cell) => `<td>${escapeHtml(cell)}</td>`).join("")}<td>${row.url === null ? "" : `<a href="${escapeHtml(row.url)}">View</a>`}</td></tr>`
     ).join("");
@@ -12646,7 +12852,7 @@ function renderInline(inline, csrfToken, error) {
       ${more}
     </section>`;
   }
-  const head = `<tr>${inline.columns.map((column6) => `<th>${escapeHtml(column6)}</th>`).join("")}${inline.canDelete ? "<th>Delete</th>" : ""}</tr>`;
+  const head = `<tr>${inline.columns.map((column7) => `<th>${escapeHtml(column7)}</th>`).join("")}${inline.canDelete ? "<th>Delete</th>" : ""}</tr>`;
   const renderRow = (row, isNew) => `<tr${isNew ? ' class="tempest-admin-inline__new"' : ""}>${row.fields.map((field) => `<td>${renderInlineCell(field)}</td>`).join("")}${inline.canDelete ? `<td class="tempest-admin-inline__del">${isNew ? "" : `<input type="checkbox" name="row.${escapeHtml(row.key)}.__delete" value="true">`}</td>` : ""}</tr>`;
   const rows = inline.rows.map((row) => renderRow(row, false)).join("");
   const blank = inline.newRow === null ? "" : renderRow(inline.newRow, true);
@@ -12817,12 +13023,86 @@ function renderLogsPage(context, view) {
 </section>`;
   return renderLayout(context, `Logs \xB7 ${context.site.title}`, body);
 }
+function renderTasksPage(context, view) {
+  const declared = view.inventory === null ? "" : `<section class="tempest-admin-tasks__declared">
+    <h2>Declared</h2>
+    ${view.inventory.length === 0 ? "<p><em>No tasks registered in this process.</em></p>" : `<div class="tempest-admin-table-wrap"><table class="tempest-admin-list__table">
+      <thead><tr><th>Task</th><th>Schedule</th><th>Description</th></tr></thead>
+      <tbody>${view.inventory.map(
+    (entry) => `<tr><td>${escapeHtml(entry.name)}</td><td>${escapeHtml(entry.schedule)}</td><td>${escapeHtml(entry.description)}</td></tr>`
+  ).join("")}</tbody>
+    </table></div>`}
+  </section>`;
+  const runs = view.runs === null ? "" : `<section class="tempest-admin-tasks__runs">
+    <h2>Runs</h2>
+    <div class="tempest-admin-list__toolbar">
+      <form method="get" class="tempest-admin-list__filters">
+        <label><span>Status</span><select name="status">${view.runs.statuses.map(
+    (status) => `<option value="${escapeHtml(status.value)}"${status.selected ? " selected" : ""}>${escapeHtml(status.label)}</option>`
+  ).join("")}</select></label>
+        <input type="search" name="task" value="${escapeHtml(view.runs.nameQuery)}" placeholder="Task name\u2026" aria-label="Task name">
+        <button type="submit">Apply</button>
+      </form>
+    </div>
+    <div class="tempest-admin-table-wrap"><table class="tempest-admin-list__table">
+      <thead><tr><th>Task</th><th>Status</th><th>Started</th><th>Finished</th><th>Attempts</th><th></th></tr></thead>
+      <tbody>${view.runs.rows.length === 0 ? '<tr><td colspan="6">No runs recorded yet.</td></tr>' : view.runs.rows.map(
+    (row) => `<tr>
+          <td>${escapeHtml(row.name)}</td>
+          <td><span class="tempest-log-badge tempest-log-badge--${escapeHtml(row.status)}">${escapeHtml(row.status)}</span></td>
+          <td>${escapeHtml(row.startedAt)}</td>
+          <td>${escapeHtml(row.finishedAt)}</td>
+          <td>${escapeHtml(row.attempts)}</td>
+          <td><a href="${escapeHtml(row.url)}">View</a></td>
+        </tr>`
+  ).join("")}</tbody>
+    </table></div>
+    ${view.runs.pages > 1 ? `<nav class="tempest-admin-list__pagination" aria-label="Pagination">
+      ${view.runs.prevUrl !== null ? `<a href="${escapeHtml(view.runs.prevUrl)}">\u2190 Prev</a>` : ""}
+      <span>Page ${escapeHtml(view.runs.page)} of ${escapeHtml(view.runs.pages)}</span>
+      ${view.runs.nextUrl !== null ? `<a href="${escapeHtml(view.runs.nextUrl)}">Next \u2192</a>` : ""}
+    </nav>` : ""}
+  </section>`;
+  const body = `<section class="tempest-admin-tasks">
+  <header class="tempest-admin-list__header">
+    <h1>Tasks</h1>
+    <p>What this process declares, and what its workers recorded.</p>
+  </header>
+  ${declared}
+  ${runs}
+  <p class="tempest-admin-form__hint">Live queue depth is not shown: a broker does not expose it, and a number that looked like one would be worse than none.</p>
+</section>`;
+  return renderLayout(context, `Tasks \xB7 ${context.site.title}`, body);
+}
+function renderTaskDetailPage(context, view) {
+  if (context.session === null) throw new Error("The task detail requires a session");
+  const block = (label, content) => content === null ? "" : `<h2>${escapeHtml(label)}</h2><pre class="tempest-admin-detail__json">${escapeHtml(content)}</pre>`;
+  const body = `<section class="tempest-admin-detail">
+  <header class="tempest-admin-detail__header">
+    <h1>${escapeHtml(view.name)} \xB7 <span class="tempest-log-badge tempest-log-badge--${escapeHtml(view.status)}">${escapeHtml(view.status)}</span></h1>
+    <div class="tempest-admin-detail__actions">
+      <a href="${escapeHtml(view.backUrl)}">\u2190 Back to tasks</a>
+      ${view.cancelUrl !== null ? `<form method="post" action="${escapeHtml(view.cancelUrl)}" class="tempest-admin-detail__delete" onsubmit="return confirm('Ask this run to stop?');">
+        <input type="hidden" name="csrf_token" value="${escapeHtml(context.session.csrfToken)}">
+        <button type="submit" class="tempest-admin-btn--danger">Cancel</button>
+      </form>` : ""}
+    </div>
+  </header>
+  <dl class="tempest-admin-detail__fields">${view.fields.map(
+    (field) => `<dt>${escapeHtml(field.label)}</dt><dd>${field.value === "" ? "<em>\u2014</em>" : escapeHtml(field.value)}</dd>`
+  ).join("")}</dl>
+  ${view.error === null ? "" : `<p class="tempest-admin-form__error">${escapeHtml(view.error)}</p>`}
+  ${block("Payload", view.payload)}
+  ${block("Result", view.result)}
+</section>`;
+  return renderLayout(context, `${view.name} \xB7 ${context.site.title}`, body);
+}
 function renderSqlPage(context, view) {
   if (context.session === null) throw new Error("The SQL console requires a session");
   const result = view.rowCount === null ? "" : `<p class="tempest-admin-form__hint">${escapeHtml(view.rowCount)} row${view.rowCount === 1 ? "" : "s"}${view.durationMs === null ? "" : ` in ${escapeHtml(view.durationMs)} ms`}${view.truncated ? " (truncated by the row cap)" : ""}.</p>
       <div class="tempest-admin-table-wrap">
         <table class="tempest-admin-list__table">
-          <thead><tr>${view.columns.map((column6) => `<th>${escapeHtml(column6)}</th>`).join("")}</tr></thead>
+          <thead><tr>${view.columns.map((column7) => `<th>${escapeHtml(column7)}</th>`).join("")}</tr></thead>
           <tbody>${view.rows.map(
     (row) => `<tr>${row.map((cell) => `<td>${escapeHtml(cell)}</td>`).join("")}</tr>`
   ).join("")}</tbody>
@@ -12992,6 +13272,15 @@ function makeLogsRouter(options) {
   return router;
 }
 var logger2 = new JSONLogger("tempest_express_sdk.admin.router");
+var JOB_STATUSES = [
+  "queued",
+  "running",
+  "succeeded",
+  "failed",
+  "cancelled"
+];
+var TERMINAL_JOB_STATUSES = ["succeeded", "failed", "cancelled"];
+var TASK_PAGE_SIZE = 25;
 var LOG_SOURCES = ["all", "debug", "info", "warning", "error", "500"];
 var LOG_PAGE_SIZE = 50;
 var LOG_EXPORT_MAX = 500;
@@ -13033,6 +13322,9 @@ function makeAdminRouter(site, options) {
   if (options.sqlConsole !== void 0) {
     systemNav.push({ label: "SQL console", url: `${prefix}/sql` });
   }
+  if (options.tasks !== void 0) {
+    systemNav.push({ label: "Tasks", url: `${prefix}/tasks` });
+  }
   const maxUploadBytes = options.maxUploadBytes ?? 10 * 1024 * 1024;
   const sessions = new AdminSessionStore({
     secret: options.secretKey,
@@ -13437,7 +13729,7 @@ function makeAdminRouter(site, options) {
           error: null,
           columns,
           rows: window.map(
-            (row) => columns.map((column6) => formatCellValue(row[column6]))
+            (row) => columns.map((column7) => formatCellValue(row[column7]))
           ),
           rowCount: rows.length,
           truncated: rows.length > window.length,
@@ -13446,6 +13738,115 @@ function makeAdminRouter(site, options) {
       })
     );
   }
+  if (options.tasks !== void 0) {
+    const tasks = options.tasks;
+    router.get(
+      `${prefix}/tasks`,
+      guarded(async (req, res) => {
+        const state = await authenticate(req, res);
+        if (state === null) return;
+        const inventory = tasks.manager === void 0 ? null : tasks.manager.inventory().map((entry) => ({
+          name: entry.name,
+          description: entry.description ?? "",
+          schedule: entry.schedule ?? "\u2014"
+        }));
+        let runs = null;
+        if (tasks.jobs !== void 0) {
+          const store = tasks.jobs(state.dbSession);
+          const page2 = Math.max(1, Number.parseInt(queryString(req.query.page), 10) || 1);
+          const status = queryString(req.query.status);
+          const name = queryString(req.query.task);
+          const result = await store.list({
+            page: page2,
+            pageSize: TASK_PAGE_SIZE,
+            ...name === "" ? {} : { name },
+            ...JOB_STATUSES.includes(status) ? { status } : {}
+          });
+          const pageUrl = (target) => `?${buildQuery({ status, task: name, page: target })}`;
+          runs = {
+            rows: result.items.map((row) => ({
+              id: String(row.id),
+              name: String(row.name ?? ""),
+              status: String(row.status ?? ""),
+              startedAt: formatCellValue(row.startedAt),
+              finishedAt: formatCellValue(row.finishedAt),
+              attempts: formatCellValue(row.attempts),
+              url: `${prefix}/tasks/${String(row.id)}`
+            })),
+            total: result.total,
+            page: result.page,
+            pages: result.pages,
+            prevUrl: result.page > 1 ? pageUrl(result.page - 1) : null,
+            nextUrl: result.page < result.pages ? pageUrl(result.page + 1) : null,
+            statuses: ["", ...JOB_STATUSES].map((value) => ({
+              value,
+              label: value === "" ? "\u2014 any \u2014" : humanizeField(value),
+              selected: value === status
+            })),
+            nameQuery: name
+          };
+        }
+        html(
+          res,
+          renderTasksPage(context(req, state.session, state.visible), {
+            inventory,
+            runs
+          })
+        );
+      })
+    );
+    if (tasks.jobs !== void 0) {
+      const jobs = tasks.jobs;
+      router.get(
+        `${prefix}/tasks/:id`,
+        guarded(async (req, res) => {
+          const state = await authenticate(req, res);
+          if (state === null) return;
+          const row = await jobs(state.dbSession).get(String(req.params.id));
+          if (row === null) {
+            html(res, renderNotFound(context(req, state.session, state.visible)), 404);
+            return;
+          }
+          const status = String(row.status ?? "");
+          html(
+            res,
+            renderTaskDetailPage(context(req, state.session, state.visible), {
+              id: String(row.id),
+              name: String(row.name ?? ""),
+              status,
+              fields: [
+                { label: "Created At", value: formatCellValue(row.createdAt) },
+                { label: "Started At", value: formatCellValue(row.startedAt) },
+                { label: "Finished At", value: formatCellValue(row.finishedAt) },
+                { label: "Attempts", value: formatCellValue(row.attempts) }
+              ],
+              payload: jsonBlock(row.payload),
+              result: jsonBlock(row.result),
+              error: typeof row.error === "string" && row.error !== "" ? row.error : null,
+              backUrl: `${prefix}/tasks`,
+              cancelUrl: TERMINAL_JOB_STATUSES.includes(status) ? null : `${prefix}/tasks/${String(row.id)}/cancel`
+            })
+          );
+        })
+      );
+      router.post(
+        `${prefix}/tasks/:id/cancel`,
+        guarded(async (req, res) => {
+          const state = await authenticate(req, res);
+          if (state === null) return;
+          if (!checkCsrf(req, res, state)) return;
+          const id = String(req.params.id);
+          const cancelled = await jobs(state.dbSession).cancel(id);
+          res.redirect(
+            `${prefix}/tasks/${id}?${buildQuery({
+              flash: cancelled ? "The run was asked to stop." : "That run had already finished.",
+              level: cancelled ? "success" : "warning"
+            })}`
+          );
+        })
+      );
+    }
+  }
   router.get(
     `${prefix}/m/:slug`,
     guarded(async (req, res) => {
@@ -13756,8 +14157,8 @@ function makeAdminRouter(site, options) {
         res.status(404).json({ options: [] });
         return;
       }
-      const column6 = adminColumns(admin.model)[field];
-      const table = column6 === void 0 ? null : foreignKeyTable(column6);
+      const column7 = adminColumns(admin.model)[field];
+      const table = column7 === void 0 ? null : foreignKeyTable(column7);
       const referenced = table === null ? null : site.get(table);
       if (referenced === null) {
         res.json({ options: [] });
@@ -14066,7 +14467,7 @@ function makeAdminRouter(site, options) {
           formAction: "",
           rows: visible.map((child) => ({
             key: String(child[childAdmin?.identityField ?? "id"]),
-            cells: columns.map((column6) => formatCellValue(child[column6])),
+            cells: columns.map((column7) => formatCellValue(child[column7])),
             fields: [],
             url: childAdmin === null ? null : `${prefix}/m/${inline.slug}/${String(child[childAdmin.identityField])}`
           })),
@@ -14198,8 +14599,8 @@ function makeAdminRouter(site, options) {
     for (const field of admin.uploadFields) {
       const file = files.find((candidate) => candidate.field === field);
       if (file === void 0) {
-        const column6 = columns[field];
-        if (creating && column6 !== void 0 && !isColumnOptional(column6)) {
+        const column7 = columns[field];
+        if (creating && column7 !== void 0 && !isColumnOptional(column7)) {
           errors[field] = "This field is required.";
         }
         continue;
@@ -14231,14 +14632,14 @@ function makeAdminRouter(site, options) {
     });
     const displayed = admin.listDisplayNames();
     const sort = {};
-    for (const column6 of displayed) {
-      if (!(column6 in columns)) continue;
-      const active = (query.sortColumn ?? admin.orderKey) === column6;
+    for (const column7 of displayed) {
+      if (!(column7 in columns)) continue;
+      const active = (query.sortColumn ?? admin.orderKey) === column7;
       const nextAscending = active ? !query.ascending : true;
-      sort[column6] = {
+      sort[column7] = {
         url: `?${buildQuery({
           ...query.baseQuery,
-          sort: column6,
+          sort: column7,
           dir: nextAscending ? "asc" : "desc"
         })}`,
         active,
@@ -14259,7 +14660,7 @@ function makeAdminRouter(site, options) {
         const identity = String(row[admin.identityField]);
         return {
           identity,
-          cells: displayed.map((column6) => formatCellValue(row[column6])),
+          cells: displayed.map((column7) => formatCellValue(row[column7])),
           url: `${prefix}/m/${admin.slug()}/${identity}`
         };
       }),
@@ -14305,9 +14706,9 @@ function makeAdminRouter(site, options) {
     }
     const filterViews = [];
     for (const field of admin.listFilter) {
-      const column6 = columns[field];
-      if (column6 === void 0) continue;
-      const spec = filterForColumn(column6);
+      const column7 = columns[field];
+      if (column7 === void 0) continue;
+      const spec = filterForColumn(column7);
       if (spec.kind === "daterange") {
         const from = queryString(req.query[`filter_${field}_from`]);
         const to = queryString(req.query[`filter_${field}_to`]);
@@ -14326,12 +14727,12 @@ function makeAdminRouter(site, options) {
         });
         continue;
       }
-      const related = await relatedOptions(column6, dbSession);
+      const related = await relatedOptions(column7, dbSession);
       const options2 = related ?? spec.options;
       const value = queryString(req.query[`filter_${field}`]);
       if (value !== "") {
         conditions.push({
-          [field]: column6.type.kind === "boolean" ? value === "true" : value
+          [field]: column7.type.kind === "boolean" ? value === "true" : value
         });
       }
       filterViews.push({
@@ -14349,8 +14750,8 @@ function makeAdminRouter(site, options) {
       });
     }
     const searchable = admin.searchFields.filter((field) => {
-      const column6 = columns[field];
-      return column6 !== void 0 && isSearchableColumn(column6);
+      const column7 = columns[field];
+      return column7 !== void 0 && isSearchableColumn(column7);
     });
     if (search !== "" && searchable.length > 0) {
       conditions.push(
@@ -14383,8 +14784,8 @@ function makeAdminRouter(site, options) {
       lens: lens?.slug ?? ""
     };
   }
-  async function relatedOptions(column6, dbSession) {
-    const table = foreignKeyTable(column6);
+  async function relatedOptions(column7, dbSession) {
+    const table = foreignKeyTable(column7);
     if (table === null) return null;
     const referenced = site.get(table);
     if (referenced === null) return null;
@@ -14399,9 +14800,9 @@ function makeAdminRouter(site, options) {
     const options2 = {};
     for (const field of Object.keys(foreignKeyFields(admin))) {
       if (admin.autocompleteFields.includes(field)) continue;
-      const column6 = columns[field];
-      if (column6 === void 0) continue;
-      const related = await relatedOptions(column6, dbSession);
+      const column7 = columns[field];
+      if (column7 === void 0) continue;
+      const related = await relatedOptions(column7, dbSession);
       if (related !== null) options2[field] = related;
     }
     return options2;
@@ -14420,8 +14821,8 @@ function makeAdminRouter(site, options) {
     for (const field of admin.autocompleteFields) {
       const value = row[field];
       if (value === null || value === void 0 || value === "") continue;
-      const column6 = columns[field];
-      const table = column6 === void 0 ? null : foreignKeyTable(column6);
+      const column7 = columns[field];
+      const table = column7 === void 0 ? null : foreignKeyTable(column7);
       const referenced = table === null ? null : site.get(table);
       if (referenced === null) continue;
       const related = await referenced.repository(dbSession).first({ [referenced.identityField]: value });
@@ -14460,6 +14861,11 @@ function inlineFieldNames(childAdmin, inline) {
 function inlineFields(childAdmin, names, key, values, errors) {
   return buildFormFields(childAdmin, { values, errors }).filter((field) => names.includes(field.name)).map((field) => ({ ...field, name: `row.${key}.${field.name}` }));
 }
+function jsonBlock(value) {
+  if (value === null || value === void 0) return null;
+  if (typeof value === "object" && Object.keys(value).length === 0) return null;
+  return JSON.stringify(value, null, 2);
+}
 async function audit(hook, entry) {
   if (hook === void 0) return;
   try {
@@ -14623,7 +15029,7 @@ function csvField(value) {
 function toCsv(columns, rows) {
   const lines = [columns.map(csvField).join(",")];
   for (const row of rows) {
-    lines.push(columns.map((column6) => csvField(exportValue(row[column6]))).join(","));
+    lines.push(columns.map((column7) => csvField(exportValue(row[column7]))).join(","));
   }
   return `${lines.join("\r\n")}\r
 `;
@@ -14631,7 +15037,7 @@ function toCsv(columns, rows) {
 function toJson(columns, rows) {
   return JSON.stringify(
     rows.map(
-      (row) => Object.fromEntries(columns.map((column6) => [column6, exportValue(row[column6])]))
+      (row) => Object.fromEntries(columns.map((column7) => [column7, exportValue(row[column7])]))
     ),
     null,
     2
@@ -16588,7 +16994,7 @@ async function withTestDatabase(models, fn) {
 }
 
 // src/version.ts
-var VERSION = "0.29.0";
+var VERSION = "0.30.0";
 
 Object.defineProperty(exports, "OpenAPIRegistry", {
   enumerable: true,
@@ -16754,6 +17160,7 @@ exports.AttemptThrottle = AttemptThrottle;
 exports.AuditAction = AuditAction;
 exports.BaseAuditLogModel = BaseAuditLogModel;
 exports.BaseController = BaseController;
+exports.BaseJobModel = BaseJobModel;
 exports.BaseModel = BaseModel;
 exports.BaseOAuthClient = BaseOAuthClient;
 exports.BaseOutboxModel = BaseOutboxModel;
@@ -16789,6 +17196,8 @@ exports.IDEMPOTENCY_HEADER = IDEMPOTENCY_HEADER;
 exports.InvalidTokenException = InvalidTokenException;
 exports.JSONLogger = JSONLogger;
 exports.JWTUtils = JWTUtils;
+exports.JobStatus = JobStatus;
+exports.JobStore = JobStore;
 exports.LEVEL_LOG_FILES = LEVEL_LOG_FILES;
 exports.LocalUploadStorage = LocalUploadStorage;
 exports.MemoryBroker = MemoryBroker;
@@ -17017,6 +17426,8 @@ exports.renderLogsPage = renderLogsPage;
 exports.renderMfaPage = renderMfaPage;
 exports.renderPasswordResetFormPage = renderPasswordResetFormPage;
 exports.renderSqlPage = renderSqlPage;
+exports.renderTaskDetailPage = renderTaskDetailPage;
+exports.renderTasksPage = renderTasksPage;
 exports.requestIdMiddleware = requestIdMiddleware;
 exports.requestTracingMiddleware = requestTracingMiddleware;
 exports.requireRoles = requireRoles;