Skip to content

Interface: HumanDecisionRequest<TRequest, TResponse> ​

Defined in: ports/human-decision-request.ts:12

Structured request payload delivered to a bidirectional HumanAdapter when awaiting a human decision.

Carries the run and request identifiers, target human role identifier, typed request brief, Zod validation schema for the human's response, optional keep-alive heartbeat interval, and cancellation signal.

Type Parameters ​

Type ParameterDefault typeDescription
TRequestunknownRequest brief payload type presented to the human.
TResponseunknownValidated response payload type returned by the human.

Properties ​

PropertyModifierTypeDescriptionDefined in
humanIdreadonlystringIdentifier of the P.human role targeted by this decision request.ports/human-decision-request.ts:18
keepAliveSeconds?readonlynumberOptional heartbeat interval in seconds before yielding the concurrency slot.ports/human-decision-request.ts:24
payloadreadonlyTRequestStructured decision brief payload presented to the human operator.ports/human-decision-request.ts:20
requestIdreadonlystringDeterministic request identifier for idempotency and cancellation tracking.ports/human-decision-request.ts:16
responseSchemareadonlyZodType<TResponse>Zod schema used to validate and parse the human operator's response.ports/human-decision-request.ts:22
runIdreadonlystringUnique identifier of the enclosing harness run.ports/human-decision-request.ts:14
signal?readonlyAbortSignalOptional abort signal triggered if the decision request is cancelled or superseded.ports/human-decision-request.ts:26

Released under the MIT License.