Skip to main content

​
crewship routine waitpoints

Waitpoints are HITL pauses created by a routine wait step of kind: approval. A parked run resumes when a human approves or rejects the waitpoint, or ends when its timeout elapses.
The pipeline alias works in place of routine.

​
Subcommands

​
list

Human output columns are TOKEN RUN ID STEP KIND CREATED TIMEOUT PROMPT. The full token is shown because it is required by approve and reject; the run ID is shortened only in the human table. An empty pending list prints No pending waitpoints. in table mode and [] in JSON mode. --json is a deprecated alias for --format json; YAML and NDJSON are also supported.

​
show <token>

Prints token, run ID, step, kind, optional invoking crew, created/timeout timestamps, optional callback URL, and the full prompt. A missing, expired, or already-decided token returns a not-found error. If the server supplied a callback URL, the command also prints the unauthenticated external completion example; treat that URL as a secret. The server omits the callback URL for a waitpoint that declares a decision_form — a typed decision is made through approve/reject only — and --format json then carries the form and the inbox_item_id of the card that shows it.

​
approve and reject

Both commands accept --comment (default empty). The comment is forwarded to the parked run as the wait step’s output; rejection additionally carries the rejection signal. Human output is Approved waitpoint <short-token>. or Rejected waitpoint <short-token>. Decisions require authentication and a workspace and return the server’s Problem Details error for an invalid or already-resolved token. The decision is attributed to the person whose CLI token made it. An agent cannot decide a waitpoint: a call made with an agent’s internal token is refused (401 before the route; 403 with reason: waitpoint_decider_not_allowed from the resolve door if it ever got that far), the waitpoint stays pending, and the attempt is listed by crewship audit --action waitpoint.decision_refused. Full rule: Waitpoints → Who may decide.