dev_request_decision destructive
Raise a human decision and block until the operator resolves it (or it expires). Creates a DevDecision row, emits a DECISION_REQUIRED lifecycle log line, and polls the DB every 2s. Returns {decision_id, status, chosen_action, resolution_text}.
Parameters
prompt: string- The human-readable decision prompt.
kind: string- One of: "binary", "choice", "free_text". — enum:
binary, choice, free_text choices: array (optional)- List of {"label": str, "action": str} entries. Required for kind=binary/choice; empty list for kind=free_text.
context_artifact: string (optional)- Filesystem path rendered as a [view] link in the UI.
default_action: string (optional)- Applied on expiry. Must match one of choices[].action for binary/choice.
expires_in_sec: integer (optional)- Seconds until the decision auto-expires. Default 300. null = never. — default:
300 requesting_instance_id: string (optional)- Optional AgentInstance UUID when a PJ v4 agent raised the decision.