Sub-steps - Threadify Documentation

Sub-steps record smaller operations within a step. Add them before marking the parent step successful or failed.

When to Use

Complex operations - Break down multiple distinct actions within one step
Debugging visibility - Track intermediate progress for troubleshooting
Performance analysis - Identify bottlenecks within step execution

Example

Node.js
Go
Python

// Track granular operations within a step
const paymentStep = thread.step('payment_processed');

try {
  paymentStep.subStep('validate_card', { cardType: 'visa' }, 'success');
  paymentStep.subStep('check_fraud', { fraudScore: 0.15 }, 'success');
  paymentStep.subStep('authorize_payment', { authCode: 'AUTH-123' }, 'success');
  
  await paymentStep
    .addContext({ totalAmount: 299.99 })
    .success();
    
} catch (error) {
  paymentStep.subStep('error_handler', { error: error.message }, 'failed');
  await paymentStep.failed({ message: 'Payment failed' });
}

// Track granular operations within a step
paymentStep := thread.Step("payment_processed")

err := processPayment()
if err != nil {
    paymentStep.SubStep("error_handler", map[string]any{"error": err.Error()}, "failed")
    _, stepErr := paymentStep.Failed(ctx, map[string]any{"message": "Payment failed"})
    if stepErr != nil {
        log.Fatal(stepErr)
    }
    return
}

paymentStep.SubStep("validate_card", map[string]any{"cardType": "visa"}, "success")
paymentStep.SubStep("check_fraud", map[string]any{"fraudScore": 0.15}, "success")
paymentStep.SubStep("authorize_payment", map[string]any{"authCode": "AUTH-123"}, "success")

_, err = paymentStep.
    AddContext(map[string]any{"totalAmount": 299.99}).
    Success(ctx)
if err != nil {
    log.Fatal(err)
}

# Track granular operations within a step
payment_step = thread.step("payment_processed")

try:
    payment_step.sub_step("validate_card", {"cardType": "visa"}, "success")
    payment_step.sub_step("check_fraud", {"fraudScore": 0.15}, "success")
    payment_step.sub_step("authorize_payment", {"authCode": "AUTH-123"}, "success")

    await payment_step.add_context({"totalAmount": 299.99}).success()
except Exception as error:
    payment_step.sub_step("error_handler", {"error": str(error)}, "failed")
    await payment_step.failed({"message": "Payment failed"})

Properties

Parameter	Required	Default	Description
`name`	Yes	—	Sub-step identifier
`context`	No	Empty	Additional data
`status`	No	`success`	`success` or `failed`

Unlike steps, sub-steps are not contract-validated and do not emit notifications.