@gotong/inbox
v0.1.0
Published
Gotong member task inbox — file-first InboxStore + HumanInboxParticipant broker that turns a workflow's human-in-the-loop step into a parked Task a person resolves from /me.
Downloads
8
Readme
@gotong/inbox
Member task inbox — the file-first half of Gotong's human-in-the-loop (HITL) workflow steps.
A workflow step (or any agent) dispatches a Task to the gotong.human/v1
capability with a HumanTaskPayload. The HumanInboxParticipant broker
records an InboxItem and suspends the task (Phase 11 suspend/resume). The
assigned member sees the item in their /me inbox, submits an InboxDecision,
and the task resumes with that decision as its output — at which point the
parent workflow (Phase 15 revision-bound, so no drift across re-publishes)
continues.
This package is pure data + the InboxStore contract + the broker. The host
(@gotong/host) wires the two-step resume (HostInboxService); the web layer
exposes /me/inbox over a duck-typed InboxSurface with no runtime dep on
this package.
Exports
HUMAN_CAPABILITY,HUMAN_INBOX_PARTICIPANT_ID,NEVER_RESUME_AT— protocol constantsInboxItem,InboxDecision,HumanTaskPayload,InboxKind,InboxStore,InboxError— typesFileInboxStore— default file-first backend (<spaceRoot>/inbox/<itemId>.json)HumanInboxParticipant— the broker (added in M2)
Layout
.gotong/
inbox/
<itemId>.json # one item per file, atomic tmp+renameDrop the directory → drop the inbox. Copy it → hand it off.
