@spec cancel_workflow(String.t(), String.t() | nil, keyword()) ::
  :ok | {:error, term()}

Cancels a running or pending workflow.

@spec execute_workflow(String.t(), Durable.Config.t()) ::
  {:ok, map()} | {:waiting, map()} | {:error, term()}

Executes a workflow by ID.

This is called internally by queue workers or directly for immediate execution.

@spec resume_workflow(String.t(), map(), keyword()) ::
  {:ok, String.t()} | {:error, term()}

Resumes a waiting workflow.

Options

• :inline - If true, execute synchronously instead of via queue (default: false)
• :durable - The Durable instance name (default: Durable)

@spec start_workflow(module(), map(), keyword()) ::
  {:ok, String.t()} | {:error, term()}

Starts a new workflow execution.

Options

• :workflow - The workflow name (optional, uses default if not specified)
• :queue - The queue to use (default: "default")
• :priority - Priority level (default: 0)
• :scheduled_at - Schedule for future execution
• :durable - The Durable instance name (default: Durable)

Returns

• {:ok, workflow_id} on success
• {:error, reason} on failure