@shipfox/client-workflows 12.0.1 → 13.0.0

package/src/core/entities/job-status.test.ts

@@ -0,0 +1,104 @@
+import {deriveJobDisplayStatus, type JobDisplayStatus} from './job.js';
+import {deriveJobExecutionDisplayStatus, type JobExecutionStatus} from './job-execution.js';
+
+type DisplayStep = Parameters<typeof deriveJobExecutionDisplayStatus>[0]['steps'][number];
+
+function displayStep(status: string): DisplayStep {
+  return {status} as DisplayStep;
+}
+
+const EXECUTION_STATUSES = ['pending', 'running', 'succeeded', 'failed', 'cancelled'] as const;
+const TERMINAL_EXECUTION_STATUSES = ['succeeded', 'failed', 'cancelled'] as const;
+
+describe('deriveJobExecutionDisplayStatus', () => {
+  test.each(
+    EXECUTION_STATUSES,
+  )('%s without a running step displays Pending unless terminal', (status) => {
+    const displayStatus = deriveJobExecutionDisplayStatus({status, steps: []});
+
+    expect(displayStatus).toBe(
+      TERMINAL_EXECUTION_STATUSES.includes(status as (typeof TERMINAL_EXECUTION_STATUSES)[number])
+        ? status
+        : 'pending',
+    );
+  });
+
+  test.each([
+    'pending',
+    'running',
+  ] as const)('%s with a running step displays Running', (status) => {
+    expect(deriveJobExecutionDisplayStatus({status, steps: [displayStep('running')]})).toBe(
+      'running',
+    );
+  });
+
+  test.each(TERMINAL_EXECUTION_STATUSES)('%s wins over a running child step', (status) => {
+    expect(deriveJobExecutionDisplayStatus({status, steps: [displayStep('running')]})).toBe(status);
+  });
+});
+
+describe('deriveJobDisplayStatus', () => {
+  test('uses the execution activity for a one-shot job', () => {
+    const statuses: Array<[JobExecutionStatus, string[], JobDisplayStatus]> = [
+      ['pending', [], 'pending'],
+      ['pending', ['running'], 'running'],
+      ['running', [], 'pending'],
+      ['running', ['running'], 'running'],
+    ];
+
+    for (const [status, stepStatuses, expected] of statuses) {
+      expect(
+        deriveJobDisplayStatus({
+          mode: 'one_shot',
+          status: 'running',
+          listenerStatus: 'inactive',
+          jobExecutions: [
+            {
+              status,
+              steps: stepStatuses.map(displayStep),
+              sequence: 1,
+            },
+          ] as never,
+        }),
+      ).toBe(expected);
+    }
+  });
+
+  test.each([
+    'succeeded',
+    'failed',
+    'cancelled',
+    'skipped',
+  ] as const)('terminal job status %s wins over child activity', (status) => {
+    expect(
+      deriveJobDisplayStatus({
+        mode: 'one_shot',
+        status,
+        listenerStatus: 'inactive',
+        jobExecutions: [{status: 'running', steps: [{status: 'running'}], sequence: 1}] as never,
+      }),
+    ).toBe(status);
+  });
+
+  test('keeps an active listener as Listening without executions', () => {
+    expect(
+      deriveJobDisplayStatus({
+        mode: 'listening',
+        status: 'running',
+        listenerStatus: 'listening',
+        jobExecutions: [],
+      }),
+    ).toBe('listening');
+  });
+
+  test('uses the terminal job status when an active listener has resolved', () => {
+    expect(
+      deriveJobDisplayStatus({
+        mode: 'listening',
+        status: 'succeeded',
+        listenerStatus: 'listening',
+        jobExecutions: [],
+      }),
+    ).toBe('succeeded');
+  });
+});

package/src/core/entities/job.ts

@@ -1,6 +1,11 @@
-import type {JobExecution, JobExecutionDisplayDuration} from './job-execution.js';
+import {
+  deriveJobExecutionDisplayStatus,
+  type JobExecution,
+  type JobExecutionDisplayDuration,
+} from './job-execution.js';
 
 export type JobStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'skipped';
+export type JobDisplayStatus = JobStatus | 'listening';
 export type JobMode = 'one_shot' | 'listening';
 export type ListenerStatus = 'inactive' | 'listening' | 'resolved';
 export type ResolutionReason = 'until' | 'timeout' | 'max_executions' | 'cancelled';
@@ -103,7 +108,7 @@ export class Job {
   }
 
   get displayName(): string {
-    return this.name || this.key;
+    return this.name ?? this.key;
   }
 
   get displayDuration(): JobDisplayDuration | null {
@@ -123,6 +128,16 @@ export function isTerminalJobStatus(status: JobStatus): boolean {
   return TERMINAL_JOB_STATUS_SET.has(status);
 }
 
+export function deriveJobDisplayStatus(
+  job: Pick<Job, 'mode' | 'status' | 'listenerStatus' | 'jobExecutions'>,
+): JobDisplayStatus {
+  if (isTerminalJobStatus(job.status)) return job.status;
+  if (job.mode === 'listening' && job.listenerStatus === 'listening') return 'listening';
+
+  const execution = defaultJobExecution(job);
+  return execution ? deriveJobExecutionDisplayStatus(execution) : 'pending';
+}
+
 export function resolveJobExecution(
   job: Job,
   jobExecutionId: string | undefined,
@@ -135,7 +150,7 @@ export function resolveJobExecution(
   return defaultJobExecution(job);
 }
 
-export function defaultJobExecution(job: Job): JobExecution | undefined {
+export function defaultJobExecution(job: Pick<Job, 'jobExecutions'>): JobExecution | undefined {
   const runningExecution = job.jobExecutions.find(
     (jobExecution) => jobExecution.status === 'running',
   );

package/src/core/entities/workflow-run.ts

@@ -1,9 +1,10 @@
-import {type Job, WORKFLOW_JOB_STATUSES} from './job.js';
+import {type Job, type JobStatus, WORKFLOW_JOB_STATUSES} from './job.js';
 import type {WorkflowRunAttempt, WorkflowRunAttemptSummary} from './workflow-run-attempt.js';
 
 export type WorkflowRunStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled';
 export type WorkflowRunRerunMode = 'all' | 'failed';
 export type WorkflowStatus = WorkflowRunStatus | (typeof WORKFLOW_JOB_STATUSES)[number];
+export type WorkflowDisplayStatus = WorkflowStatus | 'listening';
 
 export const WORKFLOW_RUN_STATUSES = [
   'pending',
@@ -30,11 +31,51 @@ export interface WorkflowSourceSnapshot {
   format: 'yaml';
 }
 
+/**
+ * Provider-neutral trigger facts. Every field is nullable: only source-control triggers
+ * resolve a reference at all, and a payload can name a ref without naming an actor.
+ */
+export interface WorkflowRunTriggerReference {
+  repository: string | null;
+  ref: string | null;
+  commit: string | null;
+  actor: string | null;
+}
+
+/** One glyph in a run row's job status strip: enough to draw and label it, nothing more. */
+export interface WorkflowRunJobSummary {
+  id: string;
+  key: string;
+  name: string | null;
+  status: JobStatus;
+  position: number;
+}
+
+export interface WorkflowRunJobStatusCount {
+  status: JobStatus;
+  count: number;
+}
+
+/**
+ * A run's jobs as the list receives them: a bounded slice to draw, plus totals covering all
+ * of them.
+ *
+ * `preview` is capped by the API, so `preview.length` is not the job count and the strip
+ * reads `total` and `statusCounts` for anything it says rather than anything it draws.
+ */
+export interface WorkflowRunJobs {
+  preview: WorkflowRunJobSummary[];
+  statusCounts: WorkflowRunJobStatusCount[];
+  total: number;
+}
+
 export interface WorkflowRun {
   id: string;
   projectId: string;
   definitionId: string;
+  number: number | null;
   name: string;
+  workflowName: string;
   currentAttempt: number;
   triggerProvider: string | null;
   triggerSource: string;
@@ -42,20 +83,25 @@ export interface WorkflowRun {
   triggerDisplayLabel: string;
   triggerLabel: string;
   triggerPayload: Record<string, unknown>;
+  triggerReference: WorkflowRunTriggerReference | null;
   inputs: Record<string, unknown> | null;
   sourceSnapshot: WorkflowSourceSnapshot | null;
   createdAt: string;
   updatedAt: string;
-  shortId: string;
   isTemporary: boolean;
 }
 
-export interface WorkflowRunListItem extends WorkflowRun {
+/** A run as the API returns it outside the list: no job strip, because none was fetched. */
+export interface WorkflowRunRecord extends WorkflowRun {
   status: WorkflowRunStatus;
   latestAttempt: number;
   runAttempt: WorkflowRunAttemptSummary;
 }
 
+export interface WorkflowRunListItem extends WorkflowRunRecord {
+  jobs: WorkflowRunJobs;
+}
+
 export interface WorkflowRunDetail extends WorkflowRun {
   latestAttempt: number;
   runAttempt: WorkflowRunAttempt;
@@ -72,10 +118,6 @@ export interface ManualWorkflowLaunch {
   workflowRunId: string;
 }
 
-export function workflowRunShortId(id: string): string {
-  return id.length <= 8 ? id : id.slice(0, 8);
-}
-
 export function workflowRunTriggerLabel({
   triggerSource,
   triggerEvent,
@@ -96,6 +138,33 @@ export function workflowRunTriggerDisplayLabel({
   return triggerEvent || triggerSource;
 }
 
+const SHORT_COMMIT_LENGTH = 7;
+const PULL_REQUEST_REF_PATTERN = /^refs\/pull\/(\d+)\/head$/u;
+
+/**
+ * The ref as a person names it: `main` for a branch, `#42` for a pull request, the tag for a
+ * tag. An unrecognized ref is shown verbatim rather than hidden, since a ref nobody can read
+ * is still better evidence than a blank cell.
+ */
+export function workflowRunBranchLabel(run: Pick<WorkflowRun, 'triggerReference'>): string | null {
+  const ref = run.triggerReference?.ref;
+  if (!ref) return null;
+  const pullRequest = PULL_REQUEST_REF_PATTERN.exec(ref);
+  if (pullRequest) return `#${pullRequest[1]}`;
+  if (ref.startsWith('refs/heads/')) return ref.slice('refs/heads/'.length);
+  if (ref.startsWith('refs/tags/')) return ref.slice('refs/tags/'.length);
+  return ref;
+}
+
+export function workflowRunCommitLabel(run: Pick<WorkflowRun, 'triggerReference'>): string | null {
+  const commit = run.triggerReference?.commit;
+  return commit ? commit.slice(0, SHORT_COMMIT_LENGTH) : null;
+}
+
+export function workflowRunActor(run: Pick<WorkflowRun, 'triggerReference'>): string | null {
+  return run.triggerReference?.actor ?? null;
+}
+
 export function isWorkflowRunTerminal(status: WorkflowRunStatus): boolean {
   return TERMINAL_WORKFLOW_RUN_STATUS_SET.has(status);
 }

package/src/core/workflow-run.test.ts

@@ -6,6 +6,7 @@ import {
   toWorkflowRunListPage,
 } from '#hooks/api/workflow-run-mapper.js';
 import {
+  workflowJob,
   workflowJobDto,
   workflowJobExecutionDto,
   workflowRunAttemptDto,
@@ -18,7 +19,6 @@ import {
 import {
   isWorkflowRunTerminal,
   isWorkflowStatus,
-  workflowRunShortId,
   workflowRunTriggerDisplayLabel,
   workflowRunTriggerLabel,
 } from './workflow-run.js';
@@ -51,7 +51,9 @@ describe('workflow run model mapping', () => {
       id: '66666666-6666-4666-8666-666666666666',
       projectId: '44444444-4444-4444-8444-444444444444',
       definitionId: '55555555-5555-4555-8555-555555555555',
+      number: 1,
       name: 'deploy-web',
+      workflowName: 'deploy-web',
       currentAttempt: 3,
       triggerProvider: 'github',
       triggerSource: 'github_acme',
@@ -63,7 +65,6 @@ describe('workflow run model mapping', () => {
       sourceSnapshot: {format: 'yaml', content: 'jobs: {}'},
       createdAt: '2026-05-07T01:01:00.000Z',
       updatedAt: '2026-05-07T01:02:00.000Z',
-      shortId: '66666666',
       isTemporary: false,
     });
     expect(run).not.toHaveProperty('status');
@@ -91,7 +92,6 @@ describe('workflow run model mapping', () => {
       triggerLabel: '',
       inputs: null,
       sourceSnapshot: null,
-      shortId: 'temp-123',
       isTemporary: true,
     });
   });
@@ -299,6 +299,10 @@ describe('workflow run model mapping', () => {
               event: 'deployment_status',
               delivery_id: 'delivery-1',
               received_at: '2026-05-07T01:00:00.000Z',
+              project: {id: '44444444-4444-4444-8444-444444444444'},
+              repository: 'acme/api',
+              ref: 'refs/heads/main',
+              commit: 'a'.repeat(40),
               data: {state: 'success'},
             },
           ],
@@ -332,6 +336,10 @@ describe('workflow run model mapping', () => {
           event: 'deployment_status',
           deliveryId: 'delivery-1',
           receivedAt: '2026-05-07T01:00:00.000Z',
+          project: {id: '44444444-4444-4444-8444-444444444444'},
+          repository: 'acme/api',
+          ref: 'refs/heads/main',
+          commit: 'a'.repeat(40),
           data: {state: 'success'},
         },
       ],
@@ -376,6 +384,18 @@ describe('workflow run model mapping', () => {
     });
   });
 
+  test('exposes display names for jobs and job executions', () => {
+    const job = workflowJob({
+      name: 'Deploy',
+      key: 'deploy',
+      job_executions: [workflowJobExecutionDto({name: 'Deploy production'})],
+    });
+
+    expect(job.displayName).toBe('Deploy');
+    expect(job.jobExecutions[0]?.displayName).toBe('Deploy production');
+    expect(workflowJob({name: null, key: 'deploy-prod'}).displayName).toBe('deploy-prod');
+  });
+
   test('returns no job display duration when a job has multiple executions', () => {
     const job = workflowJobDto({
       job_executions: [
@@ -628,12 +648,7 @@ describe('workflow run helpers', () => {
     expect(neither).toBe('');
   });
 
-  test('formats short ids and classifies workflow statuses', () => {
-    const short = workflowRunShortId('abc123');
-    const long = workflowRunShortId('66666666-6666-4666-8666-666666666666');
-
-    expect(short).toBe('abc123');
-    expect(long).toBe('66666666');
+  test('classifies workflow statuses', () => {
     expect(isWorkflowRunTerminal('succeeded')).toBe(true);
     expect(isWorkflowRunTerminal('running')).toBe(false);
     expect(isWorkflowStatus('pending')).toBe(true);

package/src/core/workflow-run.ts

@@ -1,5 +1,6 @@
 export type {
   JobDisplayDuration,
+  JobDisplayStatus,
   JobListening,
   JobMode,
   JobStatus,
@@ -9,6 +10,7 @@ export type {
 } from './entities/job.js';
 export {
   defaultJobExecution,
+  deriveJobDisplayStatus,
   isTerminalJobStatus,
   Job,
   resolveJobExecution,
@@ -17,11 +19,16 @@ export {
 } from './entities/job.js';
 export type {
   JobExecutionDisplayDuration,
+  JobExecutionDisplayStatus,
   JobExecutionStatus,
   JobExecutionTime,
   WorkflowExecutionEvent,
 } from './entities/job-execution.js';
-export {JobExecution} from './entities/job-execution.js';
+export {
+  deriveJobExecutionDisplayStatus,
+  isTerminalJobExecutionStatus,
+  JobExecution,
+} from './entities/job-execution.js';
 export type {
   AgentConfigIssue,
   AgentStepConfig,
@@ -39,12 +46,18 @@ export type {
 export {StepAttempt} from './entities/step-attempt.js';
 export type {
   ManualWorkflowLaunch,
+  WorkflowDisplayStatus,
   WorkflowRun,
   WorkflowRunDetail,
+  WorkflowRunJobStatusCount,
+  WorkflowRunJobSummary,
+  WorkflowRunJobs,
   WorkflowRunListItem,
   WorkflowRunListPage,
+  WorkflowRunRecord,
   WorkflowRunRerunMode,
   WorkflowRunStatus,
+  WorkflowRunTriggerReference,
   WorkflowSourceSnapshot,
   WorkflowStatus,
 } from './entities/workflow-run.js';
@@ -53,7 +66,9 @@ export {
   isWorkflowStatus,
   TERMINAL_WORKFLOW_RUN_STATUSES,
   WORKFLOW_RUN_STATUSES,
-  workflowRunShortId,
+  workflowRunActor,
+  workflowRunBranchLabel,
+  workflowRunCommitLabel,
   workflowRunTriggerDisplayLabel,
   workflowRunTriggerLabel,
 } from './entities/workflow-run.js';

package/src/feature.ts

@@ -5,14 +5,14 @@ export const workflowsNavigation = [
     id: 'nav.runs',
     scope: 'project',
     label: 'Runs',
-    to: '/workspaces/$wid/projects/$pid/runs',
+    to: '/w/$workspaceSlug/p/$projectSlug/runs',
     order: 100,
   },
   {
     id: 'nav.workflows',
     scope: 'project',
     label: 'Workflows',
-    to: '/workspaces/$wid/projects/$pid/workflows',
+    to: '/w/$workspaceSlug/p/$projectSlug/workflows',
     order: 200,
   },
 ] as const satisfies readonly NavTabEntry[];
@@ -21,17 +21,17 @@ export const workflowsFeature = defineClientFeature({
   id: 'shipfox.workflows',
   routes: [
     {
-      path: '/workspaces/$wid/projects/$pid/workflows',
+      path: '/w/$workspaceSlug/p/$projectSlug/workflows',
       parent: 'projectLayout',
       impl: '@shipfox/client-workflows/routes/workflows',
     },
     {
-      path: '/workspaces/$wid/projects/$pid/runs',
+      path: '/w/$workspaceSlug/p/$projectSlug/runs',
       parent: 'projectLayout',
       impl: '@shipfox/client-workflows/routes/runs',
     },
     {
-      path: '/workspaces/$wid/projects/$pid/runs/$workflowRunId',
+      path: '/w/$workspaceSlug/p/$projectSlug/runs/$workflowRunId',
       parent: 'projectLayout',
       impl: '@shipfox/client-workflows/routes/run-detail',
     },

package/src/hooks/api/workflow-run-mapper.ts

@@ -7,6 +7,7 @@ import type {
   WorkflowRunDetailResponseDto,
   WorkflowRunJobDetailDto,
   WorkflowRunJobExecutionDetailDto,
+  WorkflowRunListItemDto,
   WorkflowRunListResponseDto,
   WorkflowRunResponseDto,
   WorkflowRunStepDetailDto,
@@ -25,7 +26,7 @@ import {
   type WorkflowRunDetail,
   type WorkflowRunListItem,
   type WorkflowRunListPage,
-  workflowRunShortId,
+  type WorkflowRunRecord,
   workflowRunTriggerDisplayLabel,
   workflowRunTriggerLabel,
 } from '#core/workflow-run.js';
@@ -35,7 +36,9 @@ export function toWorkflowRun(dto: WorkflowRunResponseDto): WorkflowRun {
     id: dto.id,
     projectId: dto.project_id,
     definitionId: dto.definition_id,
+    number: dto.number,
     name: dto.name,
+    workflowName: dto.workflow_name,
     currentAttempt: dto.current_attempt,
     triggerProvider: dto.trigger_provider,
     triggerSource: dto.trigger_source,
@@ -49,13 +52,13 @@ export function toWorkflowRun(dto: WorkflowRunResponseDto): WorkflowRun {
       triggerEvent: dto.trigger_event,
     }),
     triggerPayload: dto.trigger_payload,
+    triggerReference: dto.trigger_reference,
     inputs: dto.inputs ?? null,
     sourceSnapshot: dto.source_snapshot
       ? {content: dto.source_snapshot.content, format: dto.source_snapshot.format}
       : null,
     createdAt: dto.created_at,
     updatedAt: dto.updated_at,
-    shortId: workflowRunShortId(dto.id),
     isTemporary: dto.id.startsWith('temp-'),
   };
 }
@@ -73,7 +76,7 @@ export function toWorkflowRunAttempt(dto: WorkflowRunAttemptDto): WorkflowRunAtt
   });
 }
 
-export function toWorkflowRunListItem(dto: WorkflowRunResponseDto): WorkflowRunListItem {
+export function toWorkflowRunRecord(dto: WorkflowRunResponseDto): WorkflowRunRecord {
   return {
     ...toWorkflowRun(dto),
     status: dto.status,
@@ -89,6 +92,26 @@ export function toWorkflowRunListItem(dto: WorkflowRunResponseDto): WorkflowRunL
   };
 }
 
+export function toWorkflowRunListItem(dto: WorkflowRunListItemDto): WorkflowRunListItem {
+  const statusCounts = dto.job_status_counts.map(({status, count}) => ({status, count}));
+  return {
+    ...toWorkflowRunRecord(dto),
+    jobs: {
+      preview: dto.jobs.map((job) => ({
+        id: job.id,
+        key: job.key,
+        name: job.name,
+        status: job.status,
+        position: job.position,
+      })),
+      statusCounts,
+      // Derived rather than sent: the counts already cover every job, and a separate total
+      // would be a second source of truth that could disagree with them.
+      total: statusCounts.reduce((sum, entry) => sum + entry.count, 0),
+    },
+  };
+}
+
 export function toWorkflowRunListPage(dto: WorkflowRunListResponseDto): WorkflowRunListPage {
   return {
     runs: dto.runs.map(toWorkflowRunListItem),
@@ -220,6 +243,10 @@ function toWorkflowExecutionEvent(dto: WorkflowExecutionEventDto): WorkflowExecu
     event: dto.event,
     deliveryId: dto.delivery_id,
     receivedAt: dto.received_at,
+    project: dto.project,
+    repository: dto.repository,
+    ref: dto.ref,
+    commit: dto.commit,
     data: dto.data,
   };
 }

package/src/hooks/api/workflow-runs.test.tsx

@@ -240,6 +240,8 @@ describe('workflow run API hooks', () => {
       expect(cached?.pages[0]?.runs[0]).toMatchObject({
         projectId: PROJECT_ID,
         definitionId: DEFINITION_ID,
+        number: null,
+        workflowName: 'New run',
         status: 'pending',
         triggerSource: 'manual',
         triggerProvider: null,

package/src/hooks/api/workflow-runs.ts

@@ -29,13 +29,14 @@ import {
   type WorkflowRunDetail,
   type WorkflowRunListItem,
   type WorkflowRunListPage,
+  type WorkflowRunRecord,
   type WorkflowRunStatus,
 } from '#core/workflow-run.js';
 import {
   toWorkflowRunAttempt,
   toWorkflowRunDetail,
-  toWorkflowRunListItem,
   toWorkflowRunListPage,
+  toWorkflowRunRecord,
 } from './workflow-run-mapper.js';
 
 export interface WorkflowRunFilters {
@@ -250,8 +251,8 @@ async function cancelWorkflowRun({
   workflowRunId,
 }: {
   workflowRunId: string;
-}): Promise<WorkflowRunListItem> {
-  return toWorkflowRunListItem(
+}): Promise<WorkflowRunRecord> {
+  return toWorkflowRunRecord(
     await checkedApiRequest(workflowRunDtoSchema, `/workflows/runs/${workflowRunId}/cancel`, {
       method: 'POST',
     }),
@@ -264,8 +265,8 @@ export async function rerunWorkflowRun({
 }: {
   workflowRunId: string;
   mode: WorkflowRunRerunModeDto;
-}): Promise<WorkflowRunListItem> {
-  return toWorkflowRunListItem(
+}): Promise<WorkflowRunRecord> {
+  return toWorkflowRunRecord(
     await checkedApiRequest(workflowRunResponseSchema, `/workflows/runs/${workflowRunId}/rerun`, {
       method: 'POST',
       body: {mode} satisfies RerunWorkflowRunBodyDto,
@@ -338,7 +339,9 @@ function buildTempRun({
     id,
     projectId,
     definitionId,
+    number: null,
     name,
+    workflowName: name,
     status: 'pending',
     currentAttempt: 1,
     latestAttempt: 1,
@@ -348,12 +351,14 @@ function buildTempRun({
     triggerPayload: {source: 'manual', event: 'fire'},
     triggerDisplayLabel: 'fire',
     triggerLabel: 'manual · fire',
+    triggerReference: null,
     inputs: null,
     sourceSnapshot: null,
     createdAt,
     updatedAt: createdAt,
-    shortId: id.slice(0, 8),
     isTemporary: true,
+    // The optimistic row genuinely has no jobs yet: the server has not planned the graph.
+    jobs: {preview: [], statusCounts: [], total: 0},
     runAttempt: new WorkflowRunAttemptSummary({
       workflowRunId: id,
       attempt: 1,
@@ -568,7 +573,7 @@ export function workflowRunAttemptsQueryOptions({
 export function useCancelWorkflowRunMutation(run: WorkflowRun | undefined) {
   const queryClient = useQueryClient();
   return useMutation({
-    mutationFn: async (): Promise<WorkflowRunListItem> => {
+    mutationFn: async (): Promise<WorkflowRunRecord> => {
       if (!run) throw new Error('Workflow run is not loaded');
       return await cancelWorkflowRun({workflowRunId: run.id});
     },

package/src/index.ts

@@ -1,7 +1,9 @@
 export type {
   AgentConfigIssue,
   JobDisplayDuration,
+  JobDisplayStatus,
   JobExecutionDisplayDuration,
+  JobExecutionDisplayStatus,
   JobExecutionStatus,
   JobExecutionTime,
   JobStatus,
@@ -14,6 +16,7 @@ export type {
   StepErrorReason,
   StepGateResult,
   StepSourceLocation,
+  WorkflowDisplayStatus,
   WorkflowRun,
   WorkflowRunAttempt,
   WorkflowRunDetail,
@@ -23,13 +26,14 @@ export type {
   WorkflowStatus,
 } from '#core/workflow-run.js';
 export {
+  deriveJobDisplayStatus,
+  deriveJobExecutionDisplayStatus,
   isWorkflowRunTerminal,
   isWorkflowStatus,
   Job,
   JobExecution,
   TERMINAL_WORKFLOW_RUN_STATUSES,
   WORKFLOW_RUN_STATUSES,
-  workflowRunShortId,
   workflowRunTriggerLabel,
 } from '#core/workflow-run.js';
 export {
@@ -47,4 +51,5 @@ export {
   workflowRunsQueryKeys,
 } from './hooks/api/workflow-runs.js';
 export {ProjectWorkflowsPage} from './pages/project-workflows-page.js';
-export {WorkflowRunPage} from './pages/workflow-run-page.js';
+export {WorkflowRunDetailPage} from './pages/workflow-run-detail-page.js';
+export {WorkflowRunsPage} from './pages/workflow-run-list-page.js';