TypeScript SDK

npm install awaithumans
# or
pnpm add awaithumans
# or
yarn add awaithumans

import { awaitHuman } from "awaithumans";
import { z } from "zod";

const RefundPayload = z.object({
  amount_usd: z.number(),
  customer_id: z.string(),
});

const RefundDecision = z.object({
  approved: z.boolean(),
  notes: z.string().optional(),
});

const decision = await awaitHuman({
  task: "Approve refund?",
  payloadSchema: RefundPayload,
  payload: { amount_usd: 250, customer_id: "cus_demo" },
  responseSchema: RefundDecision,
  timeoutMs: 15 * 60 * 1000,
});

if (decision.approved) {
  // decision is typed as { approved: boolean, notes?: string }
}

import {
  awaitHuman,
  TaskTimeoutError,
  TaskCancelledError,
} from "awaithumans";

try {
  const decision = await awaitHuman({ ... });
} catch (e) {
  if (e instanceof TaskTimeoutError) { ... }
  else if (e instanceof TaskCancelledError) { ... }
  else throw e;
}

import { awaitHuman } from "awaithumans/temporal";       // workflow side
import { dispatchSignal } from "awaithumans/temporal";   // web server side

npm install @temporalio/workflow @temporalio/client

import { awaitHuman } from "awaithumans/langgraph";       // node side
import { driveHumanLoop } from "awaithumans/langgraph";   // driver side

npm install @langchain/langgraph

const Schema = z.object({ approved: z.boolean() });
type Decision = z.infer<typeof Schema>;

const decision: Decision = await awaitHuman({ ... responseSchema: Schema });
//    ^? { approved: boolean }