Workflow Errors

These errors surface from the workflow runtime when a multi-step DAG fails to validate or complete. All inherit from InternalMcpError (not safe to surface verbatim to clients — the runtime maps them to a generic JSON-RPC error before sending).

Reference

Class	Inherits	When
`WorkflowStepNotFoundError`	`InternalMcpError`	A step alias was referenced before it completed
`WorkflowTimeoutError`	`InternalMcpError`	The whole workflow exceeded its `timeoutMs`
`WorkflowDagValidationError`	`InternalMcpError`	The declared DAG had a cycle, missing dependency, or bad ref
`WorkflowJobTimeoutError`	`InternalMcpError`	An individual job step exceeded its `timeoutMs`

Usage

import {
  WorkflowStepNotFoundError,
  WorkflowTimeoutError,
  WorkflowDagValidationError,
  WorkflowJobTimeoutError,
} from '@frontmcp/sdk';

// Inside a workflow runtime extension
if (!completed.has(alias)) {
  throw new WorkflowStepNotFoundError(alias);
}

Workflows — declare multi-step workflows
Jobs — long-running jobs invoked by workflow steps
Errors Overview

Task Errors

Decorators

API

Errors

Reference

Usage

​Reference

​Usage

​Related

Reference

Usage

Related