@happyvertical/smrt-jobs 0.51.39 → 0.53.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as SmrtJobEventCollection, B as isBackgroundEligibleMethod, C as DEFAULT_RETENTION_SWEEP_INTERVAL_MS, D as startRetentionSweeper, E as registerJobRetentionTasks, F as TenantJobCapExceededError, I as assertWithinTenantCreationCap, L as backgroundEligible, M as SmrtJobCollection, N as DEFAULT_TENANT_JOB_CAP, O as unregisterJobRetentionTasks, P as MAX_JOB_RETRIES, R as clampRetries, S as DEFAULT_JOB_RETENTION, T as JOB_EVENTS_RETENTION_TASK, V as markBackgroundEligible, _ as requestMcpTaskInput, a as isRunnerExecutionContext, b as redactErrorForPersistence, c as SmrtWorkerCollection, d as McpTaskNotFoundError, f as McpTaskStore, g as requestMcpTaskContinuation, h as getMcpTaskMarker, i as getActiveJobExecutionContext, j as SmrtJob, k as SmrtJobEvent, l as MCP_TASKS_EXTENSION, m as createMcpTaskResult, n as TaskRunner, o as DEFAULT_TASK_HEARTBEAT_INTERVAL_MS, p as McpTaskSuspendedError, r as createTaskRunner, s as SmrtWorker, t as JobTimeoutError, u as McpTaskCancelledError, v as taskFromJob, w as JOBS_RETENTION_TASK, x as redactErrorMessage, y as JobContextLogger, z as getBackgroundEligibleMethods } from "./chunks/runner-jgI4uv4n.js";
+import { A as SmrtJobEventCollection, B as isBackgroundEligibleMethod, C as DEFAULT_RETENTION_SWEEP_INTERVAL_MS, D as startRetentionSweeper, E as registerJobRetentionTasks, F as TenantJobCapExceededError, I as assertWithinTenantCreationCap, L as backgroundEligible, M as SmrtJobCollection, N as DEFAULT_TENANT_JOB_CAP, O as unregisterJobRetentionTasks, P as MAX_JOB_RETRIES, R as clampRetries, S as DEFAULT_JOB_RETENTION, T as JOB_EVENTS_RETENTION_TASK, V as markBackgroundEligible, _ as requestMcpTaskInput, a as isRunnerExecutionContext, b as redactErrorForPersistence, c as SmrtWorkerCollection, d as McpTaskNotFoundError, f as McpTaskStore, g as requestMcpTaskContinuation, h as getMcpTaskMarker, i as getActiveJobExecutionContext, j as SmrtJob, k as SmrtJobEvent, l as MCP_TASKS_EXTENSION, m as createMcpTaskResult, n as TaskRunner, o as DEFAULT_TASK_HEARTBEAT_INTERVAL_MS, p as McpTaskSuspendedError, r as createTaskRunner, s as SmrtWorker, t as JobTimeoutError, u as McpTaskCancelledError, v as taskFromJob, w as JOBS_RETENTION_TASK, x as redactErrorMessage, y as JobContextLogger, z as getBackgroundEligibleMethods } from "./chunks/runner-lBwPelRQ.js";
 import { c as unregisterLiveWorker, i as registerLiveWorker, n as isWorkerAlive, t as createWorkerKey } from "./chunks/worker-liveness-C1Gjnhax.js";
 import { ObjectRegistry, SmrtCollection, SmrtObject, detectEngine, field, smrt } from "@happyvertical/smrt-core";
 import { createLogger } from "@happyvertical/logger";

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-jobs",
-  "packageVersion": "0.51.39",
+  "packageVersion": "0.53.0",
   "objects": {
     "@happyvertical/smrt-jobs:ForgeDelivery": {
       "name": "forgedelivery",

package/dist/runner.js

@@ -1,2 +1,2 @@
-import { a as isRunnerExecutionContext, i as getActiveJobExecutionContext, n as TaskRunner, r as createTaskRunner, t as JobTimeoutError } from "./chunks/runner-jgI4uv4n.js";
+import { a as isRunnerExecutionContext, i as getActiveJobExecutionContext, n as TaskRunner, r as createTaskRunner, t as JobTimeoutError } from "./chunks/runner-lBwPelRQ.js";
 export { JobTimeoutError, TaskRunner, TaskRunner as default, createTaskRunner, getActiveJobExecutionContext, isRunnerExecutionContext };

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-jobs",
-  "packageVersion": "0.51.39",
+  "packageVersion": "0.53.0",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "b1a8df0c32ea887b4bea2e55c3b3a7a30f5cad9cf42e86d6a634077ea7a4ffdc",
-    "packageJson": "01ec77c084ead9c1476589b8d0c6bd1438700dc165ebf37af5978d6b00bea1b3",
+    "manifest": "49bff17e896241beec9ac61a3c84da1283c8b847e5d8a6a2575662248f534ae4",
+    "packageJson": "1929e9b9610946e39b936ce2e1de64ec9ff203de2d4f69ac9f5ddb56a7b0122c",
     "agents": "7870bffefb854829e1b4b14220a3bc02b9dc7f454256a57282b92bcf8da9ddcc"
   },
   "exports": [
@@ -35,7 +35,7 @@
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@types/node": "24.13.6",
-    "svelte": "^5.57.1",
+    "svelte": "^5.57.0",
     "svelte-check": "^4.7.6",
     "typescript": "6.0.3",
     "vite": "8.1.4",

package/dist/svelte/components/JobList.svelte

@@ -1,7 +1,22 @@
 <script lang="ts">
 /**
- * JobList - Display a filterable, sortable list of background jobs
+ * JobList - Display a filterable, sortable list of background jobs.
+ *
+ * Sorting follows the list-sort contract (`@happyvertical/smrt-ui/data`):
+ * every column header toggles its column ascending/descending (dates and
+ * counts start with the largest). Rows keep the order they are supplied in
+ * until the host passes `sort` or the person activates a header, so a host
+ * that already orders its jobs is not silently reordered. A parent that pages
+ * on the server passes `sort` + `onSortChange` and supplies rows already in
+ * that order.
  */
+import {
+  type ListSort,
+  type ListSortSpec,
+  SortableHeader,
+  sortListRows,
+  toggleListSort,
+} from '@happyvertical/smrt-ui/data';
 import { useI18n } from '@happyvertical/smrt-ui/i18n';
 import type { Snippet } from 'svelte';
 import { M } from '../i18n.js';
@@ -33,8 +48,32 @@ export interface Props {
   onCancel?: (job: JobData) => void;
   /** Empty state snippet */
   empty?: Snippet;
+  /**
+   * Current order. Omitted: rows render as supplied (headers show no sort)
+   * until a header is activated.
+   */
+  sort?: ListSort;
+  /**
+   * Called when a header is activated. When given, the parent owns the order
+   * (e.g. a server-sorted list) and `jobs` are rendered as supplied.
+   */
+  onSortChange?: (sort: ListSort) => void;
 }
 
+const JOB_LIST_SORT: ListSortSpec = {
+  columns: [
+    'status',
+    'queue',
+    'objectType',
+    'method',
+    { id: 'priority', firstDirection: 'desc' },
+    { id: 'attempts', firstDirection: 'desc' },
+    { id: 'createdAt', firstDirection: 'desc' },
+    { id: 'runAt', firstDirection: 'desc' },
+  ],
+  default: { columnId: 'createdAt', direction: 'desc' },
+};
+
 let {
   jobs = [],
   loading = false,
@@ -46,8 +85,34 @@ let {
   onRetry,
   onCancel,
   empty,
+  sort = $bindable<ListSort | undefined>(undefined),
+  onSortChange,
 }: Props = $props();
 
+function sortValue(job: JobData, columnId: string) {
+  const value = job[columnId as keyof JobData];
+  return value instanceof Date ||
+    typeof value === 'string' ||
+    typeof value === 'number'
+    ? value
+    : null;
+}
+
+const rows = $derived(
+  onSortChange || !sort ? jobs : sortListRows(jobs, sort, sortValue),
+);
+
+function handleSort(columnId: string) {
+  // With no sort yet, the clicked column starts at its first direction.
+  const next = toggleListSort(
+    sort ?? { columnId: '', direction: 'asc' },
+    columnId,
+    JOB_LIST_SORT,
+  );
+  if (onSortChange) onSortChange(next);
+  else sort = next;
+}
+
 // Handle row click
 function handleRowClick(job: JobData) {
   onJobClick?.(job);
@@ -103,6 +168,18 @@ function setIndeterminate(node: HTMLInputElement, value: boolean) {
     },
   };
 }
+
+// Sortable header columns (labels routed through i18n where keyed).
+const sortColumns = $derived([
+  { id: 'status', label: 'Status' },
+  { id: 'queue', label: 'Queue' },
+  { id: 'objectType', label: 'Object' },
+  { id: 'method', label: 'Method' },
+  { id: 'priority', label: 'Priority' },
+  { id: 'attempts', label: 'Attempts' },
+  { id: 'createdAt', label: 'Created' },
+  { id: 'runAt', label: t(M['jobs.job_list.run_at']) },
+]);
 </script>
 
 <div class="job-list-container">
@@ -121,14 +198,16 @@ function setIndeterminate(node: HTMLInputElement, value: boolean) {
             />
           </th>
         {/if}
-        <th class="job-list__cell">Status</th>
-        <th class="job-list__cell">Queue</th>
-        <th class="job-list__cell">Object</th>
-        <th class="job-list__cell">Method</th>
-        <th class="job-list__cell">Priority</th>
-        <th class="job-list__cell">Attempts</th>
-        <th class="job-list__cell">Created</th>
-        <th class="job-list__cell">{t(M['jobs.job_list.run_at'])}</th>
+        {#each sortColumns as column (column.id)}
+          <SortableHeader
+            class="job-list__cell job-list__cell--sortable"
+            columnId={column.id}
+            label={column.label}
+            {sort}
+            spec={JOB_LIST_SORT}
+            onSort={handleSort}
+          />
+        {/each}
         {#if showActions}
           <th class="job-list__cell">Actions</th>
         {/if}
@@ -158,7 +237,7 @@ function setIndeterminate(node: HTMLInputElement, value: boolean) {
           </td>
         </tr>
       {:else}
-        {#each jobs as job (job.id)}
+        {#each rows as job (job.id)}
           {@const isSelected = selected.has(job.id)}
           <tr
             class="job-list__row"
@@ -249,7 +328,9 @@ function setIndeterminate(node: HTMLInputElement, value: boolean) {
     background: var(--smrt-color-surface-container, #f3f4f6);
   }
 
-  .job-list__head th {
+  /* Sortable headers are SortableHeader's own <th>: :global, and their
+     control carries the padding. */
+  .job-list__head :global(th) {
     padding: var(--smrt-spacing-sm, 0.5rem) var(--smrt-spacing-md, 1rem);
     font-weight: var(--smrt-typography-weight-semibold, 600);
     text-align: left;
@@ -257,6 +338,12 @@ function setIndeterminate(node: HTMLInputElement, value: boolean) {
     border-bottom: 1px solid var(--smrt-color-outline-variant, #c4c6cf);
   }
 
+  .job-list__head :global(th.sortable-header) {
+    padding: 0;
+    --sortable-header-padding: var(--smrt-spacing-sm, 0.5rem)
+      var(--smrt-spacing-md, 1rem);
+  }
+
   .job-list__body tr {
     border-bottom: 1px solid var(--smrt-color-outline-variant, #c4c6cf);
     transition: background-color var(--smrt-duration-short2, 150ms) var(--smrt-easing-standard, ease);

package/dist/svelte/components/JobList.svelte.d.ts

@@ -1,3 +1,15 @@
+/**
+ * JobList - Display a filterable, sortable list of background jobs.
+ *
+ * Sorting follows the list-sort contract (`@happyvertical/smrt-ui/data`):
+ * every column header toggles its column ascending/descending (dates and
+ * counts start with the largest). Rows keep the order they are supplied in
+ * until the host passes `sort` or the person activates a header, so a host
+ * that already orders its jobs is not silently reordered. A parent that pages
+ * on the server passes `sort` + `onSortChange` and supplies rows already in
+ * that order.
+ */
+import { type ListSort } from '@happyvertical/smrt-ui/data';
 import type { Snippet } from 'svelte';
 import type { JobData } from './types.js';
 export interface Props {
@@ -21,8 +33,18 @@ export interface Props {
     onCancel?: (job: JobData) => void;
     /** Empty state snippet */
     empty?: Snippet;
+    /**
+     * Current order. Omitted: rows render as supplied (headers show no sort)
+     * until a header is activated.
+     */
+    sort?: ListSort;
+    /**
+     * Called when a header is activated. When given, the parent owns the order
+     * (e.g. a server-sorted list) and `jobs` are rendered as supplied.
+     */
+    onSortChange?: (sort: ListSort) => void;
 }
-declare const JobList: import("svelte").Component<Props, {}, "selected">;
+declare const JobList: import("svelte").Component<Props, {}, "sort" | "selected">;
 type JobList = ReturnType<typeof JobList>;
 export default JobList;
 //# sourceMappingURL=JobList.svelte.d.ts.map

package/dist/svelte/components/JobList.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JobList.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/JobList.svelte.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,YAAY,CAAC;AAI9D,MAAM,WAAW,KAAK;IACpB,sBAAsB;IACtB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sBAAsB;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACpD,mCAAmC;IACnC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,qCAAqC;IACrC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyLD,QAAA,MAAM,OAAO,mDAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}
+{"version":3,"file":"JobList.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/JobList.svelte.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,OAAO,EACL,KAAK,QAAQ,EAKd,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EAAE,OAAO,EAAsB,MAAM,YAAY,CAAC;AAI9D,MAAM,WAAW,KAAK;IACpB,sBAAsB;IACtB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sBAAsB;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACpD,mCAAmC;IACnC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,qCAAqC;IACrC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,0BAA0B;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;CACzC;AAyOD,QAAA,MAAM,OAAO,4DAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/svelte/components/__tests__/JobList.sort.test.js

@@ -0,0 +1,63 @@
+// @vitest-environment jsdom
+/**
+ * JobList ordering: rows keep the order they are supplied in until the host
+ * passes a `sort` or the person activates a header — adding header sorting
+ * must not silently reorder an existing host's list.
+ */
+import { render, screen, userEvent } from '@happyvertical/smrt-vitest/svelte';
+import { describe, expect, it } from 'vitest';
+import JobList from '../JobList.svelte';
+function job(id, createdAt, queue = 'default') {
+    return {
+        id,
+        queue,
+        objectType: 'Thing',
+        objectId: null,
+        method: 'run',
+        args: {},
+        status: 'pending',
+        priority: 0,
+        attempts: 0,
+        maxAttempts: 3,
+        timeout: 0,
+        timeoutBehavior: 'fail',
+        runAt: createdAt,
+        startedAt: null,
+        completedAt: null,
+        lastError: null,
+        resultPointer: null,
+        workerId: null,
+        createdAt,
+        updatedAt: createdAt,
+    };
+}
+// Supplied oldest first, as a host that orders by queue position might.
+const jobs = [
+    job('a', '2026-09-01T00:00:00Z', 'q-a'),
+    job('b', '2026-09-03T00:00:00Z', 'q-b'),
+    job('c', '2026-09-02T00:00:00Z', 'q-c'),
+];
+const queues = () => Array.from(document.querySelectorAll('.job-list__cell--queue')).map((cell) => cell.textContent?.trim());
+describe('JobList ordering', () => {
+    it('renders rows in the supplied order when no sort is given', () => {
+        render(JobList, { props: { jobs, showActions: false } });
+        expect(queues()).toEqual(['q-a', 'q-b', 'q-c']);
+    });
+    it('sorts when the host passes a sort', () => {
+        render(JobList, {
+            props: {
+                jobs,
+                showActions: false,
+                sort: { columnId: 'createdAt', direction: 'desc' },
+            },
+        });
+        expect(queues()).toEqual(['q-b', 'q-c', 'q-a']);
+    });
+    it('sorts once the person activates a header', async () => {
+        render(JobList, { props: { jobs, showActions: false } });
+        await userEvent.click(screen.getByRole('button', { name: /Queue/ }));
+        expect(queues()).toEqual(['q-a', 'q-b', 'q-c']);
+        await userEvent.click(screen.getByRole('button', { name: /Queue/ }));
+        expect(queues()).toEqual(['q-c', 'q-b', 'q-a']);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-jobs",
-  "version": "0.51.39",
+  "version": "0.53.0",
   "smrtJsdoc": "strict",
   "description": "Background job processing for SMRT objects with persistence and scheduling",
   "author": "HappyVertical",
@@ -43,7 +43,7 @@
     }
   },
   "peerDependencies": {
-    "svelte": "^5.57.1"
+    "svelte": "^5.57.0"
   },
   "peerDependenciesMeta": {
     "svelte": {
@@ -51,18 +51,18 @@
     }
   },
   "dependencies": {
-    "@happyvertical/jobs": "^0.96.0",
-    "@happyvertical/logger": "^0.96.0",
-    "@happyvertical/smrt-config": "0.51.39",
-    "@happyvertical/smrt-core": "0.51.39",
-    "@happyvertical/smrt-tenancy": "0.51.39",
-    "@happyvertical/smrt-types": "0.51.39",
-    "@happyvertical/smrt-ui": "0.51.39",
-    "@happyvertical/sql": "^0.96.0",
-    "@happyvertical/utils": "^0.96.0"
+    "@happyvertical/jobs": "^0.98.0",
+    "@happyvertical/logger": "^0.98.0",
+    "@happyvertical/smrt-config": "0.53.0",
+    "@happyvertical/smrt-core": "0.53.0",
+    "@happyvertical/smrt-tenancy": "0.53.0",
+    "@happyvertical/smrt-types": "0.53.0",
+    "@happyvertical/smrt-ui": "0.53.0",
+    "@happyvertical/sql": "^0.98.0",
+    "@happyvertical/utils": "^0.98.0"
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.51.39",
+    "@happyvertical/smrt-vitest": "0.53.0",
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@types/node": "24.13.6",