Closing Threads - Threadify Documentation

Closing a thread allows you to explicitly mark threads as completed or cancelled. Contract-based threads end automatically at terminal steps, while non-contract threads require manual ending.

Contract vs Non-Contract

Contract-based threads end automatically when a terminal step is reached. Non-contract threads require manual ending via complete() or cancel().

Manual completion is rejected for contract-based threads unless a terminal step has been reached.

Basic Usage

const thread = await threadify.start('Manual-Completion-Example'); // No contract

// Record some steps
await thread.step('process_order').success();
await thread.step('send_email').success();

// Manually end the thread
await thread.complete('All steps finished');
// OR
await thread.cancel('User cancelled order');

thread, _ := conn.Start(ctx, "Manual-Completion-Example", "") // No contract

// Record some steps
thread.Step("process_order").Success(ctx)
thread.Step("send_email").Success(ctx)

// Manually end the thread
thread.Complete(ctx, "All steps finished")
// OR
thread.Cancel(ctx, "User cancelled order")

thread = await connection.start("Manual-Completion-Example")  # No contract

# Record some steps
await thread.step("process_order").success()
await thread.step("send_email").success()

# Manually end the thread
await thread.complete("All steps finished")
# OR
await thread.close("User cancelled order")

Properties

JavaScript
Go
Python

Method	Description	Parameters
`complete(reason?)`	Mark thread as successfully completed	`reason` (string/object, optional)
`cancel(reason?)`	Mark thread as cancelled	`reason` (string/object, optional)

Method	Description	Parameters
`Complete(ctx, reason?)`	Mark thread as successfully completed	`ctx` (context.Context), `reason` (string, optional)
`Cancel(ctx, reason?)`	Mark thread as cancelled	`ctx` (context.Context), `reason` (string, optional)

Method	Description	Parameters
`complete(reason?)`	Mark thread as successfully completed	`reason` (string/dict, optional)
`close(reason?)`	Mark thread as cancelled	`reason` (string/dict, optional)

Notifications

When a thread ends, Threadify emits events:

thread.completed - Triggered when complete() is called or a terminal step is reached
thread.cancelled - Triggered when cancel() is called

Next Steps

Working with Contracts

Learn how contracts enforce terminal steps

Notifications

Subscribe to thread completion events