HITL sdk

HITL sdk is a TypeScript software development kit that provides a human-in-the-loop approval layer for AI workflows. It allows developers to pause automated workflows and suspend them for hours or days until a human provides approval through a single await call. The SDK is platform-agnostic and integrates with chat tools such as Slack, Microsoft Teams, Google Chat, Discord, and WhatsApp, as well as workflow engines including Vercel Workflow SDK, Inngest, Temporal, and Upstash Workflow. It supports multiple persistence backends such as PostgreSQL, SQLite, and Redis.

The SDK replaces custom polling, queueing, and retry logic with a unified code-based approach to human oversight. Instead of managing database rows, cron jobs, or webhook listeners, developers use a single waitForHuman call to handle the entire approval process. This eliminates the need for manual polling loops and custom retry mechanisms within the application code.

Developers can install the SDK using npm with the command npm i @hitl-sdk/hitl or by following the quick start guide on the website. The documentation provides a guide at https://hitl-sdk.dev/onboard.md to help users get started quickly. A simple workflow example is available to show how to draft an email and wait for human approval before sending it.

The SDK allows approval with editable fields, denial with a reason, and custom actions for any workflow pattern. Users can approve with editable fields like subject and body, or deny with a text area for the reason. Custom actions can be defined for patterns like review, expense report, production deploy, refund access, or request data.

The platform is designed to be agnostic across chat platforms, workflow engines, and persistence layers. This means it does not lock users into a specific technology stack or provider. The SDK can be integrated into any existing infrastructure without requiring changes to the underlying chat tool or database system.

The SDK simplifies the code by replacing polling, queues, and resume logic with a single await statement. It removes the need for manual sleep functions, database row checks, and expiration logic. The code example shows how a simple await replaces a complex while loop with database queries and sleep delays.

The SDK allows reminders or escalations at any time during the approval process. Developers can configure actions to notify users or escalate the request if it remains pending. The code snippet demonstrates how to build approval blocks with actions for approve, deny, and custom fields.

The SDK is written in TypeScript and is designed for developers working with AI workflows. It targets mission-critical applications where human oversight is required before automated actions are executed. The code examples use TypeScript syntax and demonstrate integration with common web development tools.

The SDK provides a unified approach to human-in-the-loop approval without requiring custom retry logic. It handles the entire lifecycle from drafting to approval or denial in a single function call. The code example shows how to define fields for subject and body with default values from the draft.

The SDK includes a waitForHuman function that accepts a message and actions object. The actions object can include approve with fields, deny with fields, or custom actions. The function returns a resolved object that can be checked to determine if the approval was granted or denied.

The official website of HITL sdk is hitl-sdk.dev.

HITL sdk has no reviews on Trustburn yet. Anyone who has used it can write the first review on its Trustburn page.