@shipfox/client-workflows 5.0.0 → 6.0.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shipfox/client-workflows",
   "license": "MIT",
-  "version": "5.0.0",
+  "version": "6.0.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ShipfoxHQ/shipfox.git",
@@ -10,10 +10,6 @@
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "imports": {
-    "#*": "./dist/*",
-    "#test/*": "./test/*"
-  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -31,15 +27,15 @@
   "dependencies": {
     "@swc/helpers": "^0.5.17",
     "date-fns": "^4.1.0",
-    "@shipfox/api-definitions-dto": "6.0.0",
-    "@shipfox/api-workflows-dto": "8.0.0",
-    "@shipfox/client-api": "4.0.0",
-    "@shipfox/client-projects": "5.0.0",
-    "@shipfox/client-logs": "5.0.0",
-    "@shipfox/client-shell": "5.0.0",
-    "@shipfox/client-triggers": "5.0.0",
-    "@shipfox/client-ui": "4.0.0",
-    "@shipfox/react-ui": "0.3.5"
+    "@shipfox/api-definitions-dto": "9.0.1",
+    "@shipfox/api-workflows-dto": "9.0.1",
+    "@shipfox/client-api": "6.0.1",
+    "@shipfox/client-logs": "6.0.1",
+    "@shipfox/client-projects": "6.0.1",
+    "@shipfox/client-shell": "6.0.1",
+    "@shipfox/client-triggers": "6.0.1",
+    "@shipfox/client-ui": "6.0.1",
+    "@shipfox/react-ui": "0.3.6"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.101.0",
@@ -47,6 +43,9 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
+  "imports": {
+    "#*": "./dist/*"
+  },
   "scripts": {
     "build": "shipfox-swc",
     "check": "shipfox-biome-check",

package/src/components/workflow-run-list/types.ts

@@ -8,6 +8,9 @@ export interface WorkflowRunListProps {
   projectId: string;
   selectedWorkflowRunId?: string | undefined;
   className?: string | undefined;
+  search?: string;
+  statusFilter?: WorkflowRunListStatusFilter;
+  onFiltersChange?: (filters: {search?: string; status?: WorkflowRunListStatusFilter}) => void;
 }
 
 export type WorkflowRunListQuery = QueryLoadErrorQuery & {isPending: boolean};
@@ -19,4 +22,7 @@ export interface WorkflowRunListViewProps {
   projectId: string;
   selectedWorkflowRunId?: string | undefined;
   className?: string | undefined;
+  search?: string;
+  statusFilter?: WorkflowRunListStatusFilter;
+  onFiltersChange?: (filters: {search?: string; status?: WorkflowRunListStatusFilter}) => void;
 }

package/src/components/workflow-run-list/workflow-run-list-view.tsx

@@ -2,7 +2,7 @@ import {TimeTickerProvider} from '@shipfox/react-ui/time-ticker';
 import {cn} from '@shipfox/react-ui/utils';
 import {useState} from 'react';
 import {runMatchesSearch, runMatchesStatusFilter} from './run-display.js';
-import type {WorkflowRunListStatusFilter, WorkflowRunListViewProps} from './types.js';
+import type {WorkflowRunListViewProps} from './types.js';
 import {WorkflowRunListContent} from './workflow-run-list-content.js';
 import {WorkflowRunListHeader} from './workflow-run-list-header.js';
 
@@ -13,18 +13,26 @@ export function WorkflowRunListView({
   projectId,
   selectedWorkflowRunId,
   className,
+  search = '',
+  statusFilter = 'all',
+  onFiltersChange,
 }: WorkflowRunListViewProps) {
-  const [search, setSearch] = useState('');
-  const [statusFilter, setStatusFilter] = useState<WorkflowRunListStatusFilter>('all');
+  const [localSearch, setLocalSearch] = useState(search);
+  const [localStatusFilter, setLocalStatusFilter] = useState(statusFilter);
+  const currentSearch = onFiltersChange ? search : localSearch;
+  const currentStatusFilter = onFiltersChange ? statusFilter : localStatusFilter;
 
   const filteredRuns = runs.filter((run) => {
-    if (!runMatchesStatusFilter(run.status, statusFilter)) return false;
-    return runMatchesSearch(run, search);
+    if (!runMatchesStatusFilter(run.status, currentStatusFilter)) return false;
+    return runMatchesSearch(run, currentSearch);
   });
 
   function handleClearFilters() {
-    setSearch('');
-    setStatusFilter('all');
+    if (onFiltersChange) onFiltersChange({});
+    else {
+      setLocalSearch('');
+      setLocalStatusFilter('all');
+    }
   }
 
   return (
@@ -37,10 +45,18 @@ export function WorkflowRunListView({
         aria-label="Workflow runs"
       >
         <WorkflowRunListHeader
-          query={search}
-          onQueryChange={setSearch}
-          statusFilter={statusFilter}
-          onStatusFilterChange={setStatusFilter}
+          query={currentSearch}
+          onQueryChange={(next) => {
+            if (onFiltersChange)
+              onFiltersChange({...(next ? {search: next} : {}), status: currentStatusFilter});
+            else setLocalSearch(next);
+          }}
+          statusFilter={currentStatusFilter}
+          onStatusFilterChange={(next) => {
+            if (onFiltersChange)
+              onFiltersChange({...(currentSearch ? {search: currentSearch} : {}), status: next});
+            else setLocalStatusFilter(next);
+          }}
         />
         <WorkflowRunListContent
           query={query}

package/src/components/workflow-run-list/workflow-run-list.tsx

@@ -9,6 +9,9 @@ export function WorkflowRunList({
   projectId,
   selectedWorkflowRunId,
   className,
+  search = '',
+  statusFilter = 'all',
+  onFiltersChange,
 }: WorkflowRunListProps) {
   const query = useWorkflowRunsInfiniteQuery(projectId, {});
   const runs = useMemo<WorkflowRunListItem[]>(
@@ -24,6 +27,9 @@ export function WorkflowRunList({
       projectId={projectId}
       selectedWorkflowRunId={selectedWorkflowRunId}
       className={className}
+      search={search}
+      statusFilter={statusFilter}
+      {...(onFiltersChange ? {onFiltersChange} : {})}
     />
   );
 }

package/src/components/workflow-run-summary/workflow-run-attempt-switcher.test.tsx

@@ -1,6 +1,7 @@
 import {configureApiClient} from '@shipfox/client-api';
 import {screen, waitFor, within} from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
+import {toWorkflowRunAttempt} from '#hooks/api/workflow-run-mapper.js';
 import {workflowRunsQueryKeys} from '#hooks/api/workflow-runs.js';
 import {
   runAttemptsResponseDto,
@@ -145,12 +146,10 @@ describe('WorkflowRunAttemptSwitcher', () => {
     const {queryClient} = renderSwitcher({latestAttempt: 3});
     queryClient.setQueryData(
       workflowRunsQueryKeys.attempts(CURRENT_RUN_ID),
-      runAttemptsResponseDto({
-        attempts: [
-          workflowRunAttemptDto({id: ROOT_RUN_ID, attempt: 1}),
-          workflowRunAttemptDto({id: CURRENT_RUN_ID, attempt: 2}),
-        ],
-      }),
+      [
+        workflowRunAttemptDto({id: ROOT_RUN_ID, attempt: 1}),
+        workflowRunAttemptDto({id: CURRENT_RUN_ID, attempt: 2}),
+      ].map(toWorkflowRunAttempt),
     );
 
     await user.click(await screen.findByRole('button', {name: 'Switch attempt, currently 2 of 3'}));

package/src/components/workflow-run-summary/workflow-run-summary.tsx

@@ -1,4 +1,3 @@
-import type {WorkflowRunRerunModeDto} from '@shipfox/api-workflows-dto';
 import {TriggerSourceIcon} from '@shipfox/client-triggers';
 import {Badge} from '@shipfox/react-ui/badge';
 import {Button} from '@shipfox/react-ui/button';
@@ -20,6 +19,7 @@ import {
   type Job,
   WORKFLOW_RUN_STATUSES,
   type WorkflowRunDetail,
+  type WorkflowRunRerunMode,
 } from '#core/workflow-run.js';
 import {WorkflowRunDurationLabel} from '../workflow-run-duration-label.js';
 import {getWorkflowStatusVisual} from '../workflow-status/status-visuals.js';
@@ -43,7 +43,7 @@ export interface WorkflowRunSummaryProps {
   cancelling?: boolean | undefined;
   onCancel?: (() => void) | undefined;
   rerunPending?: boolean | undefined;
-  onRerun?: ((mode: WorkflowRunRerunModeDto) => void) | undefined;
+  onRerun?: ((mode: WorkflowRunRerunMode) => void) | undefined;
   latestAttempt?: number | undefined;
 }
 
@@ -207,7 +207,7 @@ function WorkflowRunActionSlot({
   cancelling: boolean;
   onCancel?: (() => void) | undefined;
   rerunPending: boolean;
-  onRerun?: ((mode: WorkflowRunRerunModeDto) => void) | undefined;
+  onRerun?: ((mode: WorkflowRunRerunMode) => void) | undefined;
 }) {
   if (action === 'none') return null;
 

package/src/components/workflow-run-view/job-card.tsx

@@ -1,4 +1,3 @@
-import {agentConfigIssueSchema, stepErrorReasonSchema} from '@shipfox/api-workflows-dto';
 import {TriggerSourceIcon} from '@shipfox/client-triggers';
 import {Badge} from '@shipfox/react-ui/badge';
 import {Button} from '@shipfox/react-ui/button';
@@ -12,9 +11,11 @@ import type {ReactNode} from 'react';
 import {Fragment, useId, useRef, useState} from 'react';
 import {getWorkflowStatusVisual} from '#components/workflow-status/status-visuals.js';
 import {
+  AGENT_CONFIG_ISSUES,
   type Job,
   type JobExecution,
   type JobExecutionTime,
+  STEP_ERROR_REASONS,
   type Step,
   type StepError,
   type StepSourceLocation,
@@ -404,25 +405,33 @@ function toSelectedAttemptError(
 ): StepError | null {
   if (error === null) return null;
 
-  const reason = stepErrorReasonSchema.safeParse(error.reason);
-  const agentConfigIssue = agentConfigIssueSchema.safeParse(
-    error.agentConfigIssue ?? error.agent_config_issue,
-  );
+  const rawReason = error.reason;
+  const parsedReason =
+    typeof rawReason === 'string' &&
+    STEP_ERROR_REASONS.has(rawReason as StepError['reason'] & string)
+      ? (rawReason as NonNullable<StepError['reason']>)
+      : undefined;
+  const rawAgentConfigIssue = error.agentConfigIssue ?? error.agent_config_issue;
+  const agentConfigIssue =
+    typeof rawAgentConfigIssue === 'string' &&
+    AGENT_CONFIG_ISSUES.has(rawAgentConfigIssue as NonNullable<StepError['agentConfigIssue']>)
+      ? (rawAgentConfigIssue as NonNullable<StepError['agentConfigIssue']>)
+      : undefined;
   const exitCode = error.exitCode ?? error.exit_code;
-  const parsedReason = reason.success
-    ? reason.data
-    : agentConfigIssue.success
+  const resolvedReason = parsedReason
+    ? parsedReason
+    : agentConfigIssue
       ? 'agent_config_invalid'
       : undefined;
 
-  if (parsedReason === undefined) return null;
+  if (resolvedReason === undefined) return null;
 
   return {
     message: typeof error.message === 'string' ? error.message : '',
     exitCode: exitCode === null || typeof exitCode === 'number' ? exitCode : null,
     signal: typeof error.signal === 'string' ? error.signal : undefined,
-    reason: parsedReason,
-    agentConfigIssue: agentConfigIssue.success ? agentConfigIssue.data : undefined,
+    reason: resolvedReason,
+    agentConfigIssue,
     category: step.type === 'setup' ? 'setup' : 'user',
   };
 }

package/src/components/workflow-run-view/workflow-run-view.test.tsx

@@ -122,7 +122,7 @@ describe('WorkflowRunView', () => {
                   listener_status: 'listening',
                   job_executions: [
                     workflowJobExecutionDto({
-                      id: 'execution-1',
+                      id: '77777777-7777-4777-8777-000000000001',
                       job_id: BUILD_JOB_ID,
                       sequence: 1,
                       status: 'succeeded',
@@ -152,7 +152,7 @@ describe('WorkflowRunView', () => {
                       ],
                     }),
                     workflowJobExecutionDto({
-                      id: 'execution-2',
+                      id: '77777777-7777-4777-8777-000000000002',
                       job_id: BUILD_JOB_ID,
                       sequence: 2,
                       status: 'failed',
@@ -427,7 +427,7 @@ describe('WorkflowRunView', () => {
                   status: 'succeeded',
                   job_executions: [
                     workflowJobExecutionDto({
-                      id: 'retry-execution',
+                      id: '77777777-7777-4777-8777-000000000003',
                       job_id: DEPLOY_JOB_ID,
                       sequence: 2,
                       name: 'retry',

package/src/components/workflow-run-view/workflow-run-view.tsx

@@ -1,4 +1,3 @@
-import type {WorkflowRunRerunModeDto} from '@shipfox/api-workflows-dto';
 import {ApiError} from '@shipfox/client-api';
 import {QueryLoadError} from '@shipfox/client-ui';
 import {RelativeTimeProvider} from '@shipfox/react-ui/relative-time';
@@ -9,6 +8,7 @@ import {
   type JobExecution,
   resolveJobExecution,
   type StepSourceLocation,
+  type WorkflowRunRerunMode,
 } from '#core/workflow-run.js';
 import {
   type WorkflowRunSelectionInput,
@@ -160,7 +160,7 @@ function RunViewContent({
   const highlightedLineRange =
     sourceFocus?.location ?? resolvedSelection?.step?.sourceLocation ?? null;
   const sourceSnapshot = runData.sourceSnapshot;
-  async function rerun(mode: WorkflowRunRerunModeDto) {
+  async function rerun(mode: WorkflowRunRerunMode) {
     try {
       const run = await rerunMutation.mutateAsync({workflowRunId: runData.id, mode});
       toast.success('Re-run started');

package/src/core/entities/job-execution.ts

@@ -1,11 +1,14 @@
-import type {
-  WorkflowExecutionEventDto,
-  WorkflowRunJobExecutionDetailDto,
-} from '@shipfox/api-workflows-dto';
 import {type Duration, intervalToDuration} from 'date-fns';
-import {type Step, toStep} from './step.js';
-
-export type JobExecutionStatus = WorkflowRunJobExecutionDetailDto['status'];
+import type {Step} from './step.js';
+
+export type JobExecutionStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled';
+export interface WorkflowExecutionEvent {
+  source: string;
+  event: string;
+  deliveryId: string;
+  receivedAt: string;
+  data: unknown;
+}
 export type JobExecutionTime =
   | {state: 'fixed'; elapsed: Duration}
   | {state: 'live'; fromIso: string};
@@ -20,7 +23,7 @@ interface JobExecutionFields {
   name: string;
   status: JobExecutionStatus;
   statusReason: string | null;
-  triggerEvents: WorkflowExecutionEventDto[];
+  triggerEvents: WorkflowExecutionEvent[];
   queuedAt: string | null;
   startedAt: string | null;
   finishedAt: string | null;
@@ -37,7 +40,7 @@ export class JobExecution {
   name!: string;
   status!: JobExecutionStatus;
   statusReason!: string | null;
-  triggerEvents!: WorkflowExecutionEventDto[];
+  triggerEvents!: WorkflowExecutionEvent[];
   queuedAt!: string | null;
   startedAt!: string | null;
   finishedAt!: string | null;
@@ -63,25 +66,6 @@ export class JobExecution {
   }
 }
 
-export function toJobExecution(dto: WorkflowRunJobExecutionDetailDto): JobExecution {
-  return new JobExecution({
-    id: dto.id,
-    jobId: dto.job_id,
-    sequence: dto.sequence,
-    name: dto.name,
-    status: dto.status,
-    statusReason: dto.status_reason,
-    triggerEvents: dto.trigger_events ?? [],
-    queuedAt: dto.queued_at ?? null,
-    startedAt: dto.started_at ?? null,
-    finishedAt: dto.finished_at ?? null,
-    timedOutAt: dto.timed_out_at ?? null,
-    createdAt: dto.created_at,
-    updatedAt: dto.updated_at,
-    steps: dto.steps.map(toStep),
-  });
-}
-
 export function jobExecutionQueueTimeFromTimestamps({
   queuedAt,
   startedAt,

package/src/core/entities/job.ts

@@ -1,23 +1,45 @@
-import type {
-  JobListeningDto,
-  JobModeDto,
-  JobStatusDto,
-  JobStatusReasonDto,
-  ListenerStatusDto,
-  ResolutionReasonDto,
-  WorkflowRunJobDetailDto,
-} from '@shipfox/api-workflows-dto';
-import {
-  type JobExecution,
-  type JobExecutionDisplayDuration,
-  toJobExecution,
-} from './job-execution.js';
-
-export type JobStatus = JobStatusDto;
-export type JobMode = JobModeDto;
-export type ListenerStatus = ListenerStatusDto;
-export type ResolutionReason = ResolutionReasonDto;
-export type JobStatusReason = JobStatusReasonDto;
+import type {JobExecution, JobExecutionDisplayDuration} from './job-execution.js';
+
+export type JobStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled' | 'skipped';
+export type JobMode = 'one_shot' | 'listening';
+export type ListenerStatus = 'inactive' | 'listening' | 'resolved';
+export type ResolutionReason = 'until' | 'timeout' | 'max_executions' | 'cancelled';
+export type JobStatusReason =
+  | 'dependency_not_completed'
+  | 'condition_false'
+  | 'default_gate_rejected'
+  | 'condition_rejected'
+  | 'condition_errored'
+  | 'user_cancelled'
+  | 'run_cancelled'
+  | 'timed_out'
+  | 'runner_lost'
+  | 'step_failed'
+  | 'unknown';
+export interface JobListening {
+  on: Array<{
+    source: string;
+    event: string;
+    inputs?: Record<string, unknown> | undefined;
+    filter?: string | undefined;
+  }>;
+  until: Array<{
+    source: string;
+    event: string;
+    inputs?: Record<string, unknown> | undefined;
+    filter?: string | undefined;
+  }> | null;
+  timeoutMs: number | null;
+  maxExecutions: number | null;
+  batch: {
+    debounceMs?: number | undefined;
+    maxSize?: number | undefined;
+    maxWaitMs?: number | undefined;
+  } | null;
+  onResolve: 'finish' | 'cancel';
+  executionTimeoutMs: number | null;
+  name: string | null;
+}
 
 export type JobDisplayDuration = JobExecutionDisplayDuration;
 
@@ -48,7 +70,7 @@ interface JobFields {
   status: JobStatus;
   statusReason: JobStatusReason | null;
   carriedOver: boolean;
-  listening: JobListeningDto | null;
+  listening: JobListening | null;
   listenerStatus: ListenerStatus;
   resolutionReason: ResolutionReason | null;
   dependencies: string[];
@@ -67,7 +89,7 @@ export class Job {
   status!: JobStatus;
   statusReason!: JobStatusReason | null;
   carriedOver!: boolean;
-  listening!: JobListeningDto | null;
+  listening!: JobListening | null;
   listenerStatus!: ListenerStatus;
   resolutionReason!: ResolutionReason | null;
   dependencies!: string[];
@@ -124,26 +146,3 @@ export function defaultJobExecution(job: Job): JobExecution | undefined {
     return jobExecution.sequence > latest.sequence ? jobExecution : latest;
   }, undefined);
 }
-
-export function toJob(dto: WorkflowRunJobDetailDto): Job {
-  const jobExecutions = dto.job_executions.map(toJobExecution);
-
-  return new Job({
-    id: dto.id,
-    runAttemptId: dto.run_attempt_id,
-    key: dto.key,
-    name: dto.name,
-    mode: dto.mode,
-    status: dto.status,
-    statusReason: dto.status_reason,
-    carriedOver: dto.carried_over,
-    listening: dto.listening,
-    listenerStatus: dto.listener_status,
-    resolutionReason: dto.resolution_reason,
-    dependencies: dto.dependencies,
-    position: dto.position,
-    createdAt: dto.created_at,
-    updatedAt: dto.updated_at,
-    jobExecutions,
-  });
-}

package/src/core/entities/step-attempt.ts

@@ -1,7 +1,14 @@
-import type {StepAttemptDto, StepGateResultDto} from '@shipfox/api-workflows-dto';
 import {type Duration, intervalToDuration} from 'date-fns';
 
-export type StepGateResult = StepGateResultDto;
+export type StepGateResult =
+  | {kind: 'none'}
+  | {kind: 'not_evaluated'}
+  | {kind: 'passed'; passed: true; source: string; exitCode: number | null}
+  | {kind: 'failed'; passed: false; source: string; exitCode: number | null}
+  | {kind: 'uncheckable'; passed: false; uncheckable: true; reason: string; exitCode: number | null}
+  | {kind: 'evaluation_error'; reason: string; exitCode: number | null}
+  | {kind: 'unknown'; data: Record<string, unknown>}
+  | null;
 export type StepAttemptDisplayDuration =
   | {state: 'fixed'; elapsed: Duration}
   | {state: 'live'; fromIso: string};
@@ -46,24 +53,6 @@ export class StepAttempt {
   }
 }
 
-export function toStepAttempt(dto: StepAttemptDto, jobExecutionId: string): StepAttempt {
-  return new StepAttempt({
-    id: dto.id,
-    stepId: dto.step_id,
-    jobExecutionId,
-    attempt: dto.attempt,
-    executionOrder: dto.execution_order,
-    status: dto.status,
-    exitCode: dto.exit_code ?? null,
-    output: dto.output ?? null,
-    error: dto.error ?? null,
-    gateResult: dto.gate_result ?? null,
-    restartFeedback: dto.restart_feedback ?? null,
-    startedAt: dto.started_at,
-    finishedAt: dto.finished_at ?? null,
-  });
-}
-
 export function stepAttemptDisplayDurationFromTimestamps({
   startedAt,
   finishedAt,

package/src/core/entities/step.ts

@@ -1,15 +1,42 @@
-import type {
-  AgentConfigIssueDto,
-  StepErrorCategoryDto,
-  StepErrorReasonDto,
-  StepSourceLocationDto,
-  WorkflowRunStepDetailDto,
-} from '@shipfox/api-workflows-dto';
-import {type StepAttempt, toStepAttempt} from './step-attempt.js';
+import type {StepAttempt} from './step-attempt.js';
 
-export type StepErrorReason = StepErrorReasonDto;
-export type AgentConfigIssue = AgentConfigIssueDto;
-export type StepErrorCategory = StepErrorCategoryDto;
+export type StepErrorReason =
+  | 'checkout_failed'
+  | 'checkout_auth_failed'
+  | 'checkout_unavailable'
+  | 'git_unavailable'
+  | 'workspace_prep_failed'
+  | 'setup_aborted'
+  | 'config_unresolvable'
+  | 'output_invalid'
+  | 'agent_config_invalid'
+  | 'agent_invocation_failed';
+export type AgentConfigIssue =
+  | 'step_config_invalid'
+  | 'provider_not_configured'
+  | 'provider_unsupported'
+  | 'model_unavailable'
+  | 'credentials_invalid';
+export type StepErrorCategory = 'setup' | 'user';
+export const STEP_ERROR_REASONS = new Set<StepErrorReason>([
+  'checkout_failed',
+  'checkout_auth_failed',
+  'checkout_unavailable',
+  'git_unavailable',
+  'workspace_prep_failed',
+  'setup_aborted',
+  'config_unresolvable',
+  'output_invalid',
+  'agent_config_invalid',
+  'agent_invocation_failed',
+]);
+export const AGENT_CONFIG_ISSUES = new Set<AgentConfigIssue>([
+  'step_config_invalid',
+  'provider_not_configured',
+  'provider_unsupported',
+  'model_unavailable',
+  'credentials_invalid',
+]);
 
 export interface StepSourceLocation {
   startLine: number;
@@ -48,58 +75,3 @@ export interface Step {
   updatedAt: string;
   attempts: StepAttempt[];
 }
-
-export function toStep(dto: WorkflowRunStepDetailDto): Step {
-  return {
-    id: dto.id,
-    jobExecutionId: dto.job_execution_id,
-    key: dto.key,
-    name: dto.name,
-    sourceLocation: dto.source_location ? toStepSourceLocation(dto.source_location) : null,
-    status: dto.status,
-    type: dto.type,
-    config: dto.config,
-    agentConfig: toAgentStepConfig(dto),
-    error: dto.error ? toStepError(dto.error) : null,
-    position: dto.position,
-    currentAttempt: dto.current_attempt,
-    createdAt: dto.created_at,
-    updatedAt: dto.updated_at,
-    attempts: dto.attempts.map((attempt) => toStepAttempt(attempt, dto.job_execution_id)),
-  };
-}
-
-function toStepSourceLocation(dto: StepSourceLocationDto): StepSourceLocation {
-  return {
-    startLine: dto.start_line,
-    endLine: dto.end_line,
-  };
-}
-
-function toStepError(dto: NonNullable<WorkflowRunStepDetailDto['error']>): StepError {
-  return {
-    message: dto.message,
-    exitCode: dto.exit_code ?? null,
-    signal: dto.signal,
-    reason: dto.reason,
-    agentConfigIssue: dto.agent_config_issue,
-    category: dto.category,
-  };
-}
-
-function toAgentStepConfig(dto: WorkflowRunStepDetailDto): AgentStepConfig | null {
-  if (dto.type !== 'agent') return null;
-
-  return {
-    provider: stringConfigValue(dto.config.provider),
-    model: stringConfigValue(dto.config.model),
-    thinking: stringConfigValue(dto.config.thinking),
-  };
-}
-
-function stringConfigValue(value: unknown): string | null {
-  if (typeof value !== 'string') return null;
-
-  const trimmedValue = value.trim();
-  return trimmedValue ? trimmedValue : null;
-}