Sculptured docs

Questions and approvals

What happens when an agent asks you something, how long it waits, and what it does if nobody answers.

When an agent needs a decision, Sculptured shows needs you and opens a question card. A restricted Claude agent can also request permission to run a tool. Answer on the card before its deadline; if the deadline passes first, the timeout behavior applies.

sequenceDiagram
  participant A as Agent
  participant S as Sculptured
  participant Y as You
  A->>S: "request_input: Which colour?"
  S->>S: "record question, agent needs you"
  S-->>Y: "Answer button, Needs You"
  alt you answer in time
    Y->>S: answer
    S->>A: "your answer"
  else nobody answers in time
    S->>A: "decide yourself, then record_decision"
    A->>S: "record_decision: what it chose and why"
  end

Where questions come from

SourceWhat it is
Agent question (request_input)The agent asks a question and may offer choices and a short header. The card shows whether it accepts a choice, free text or both.
The CLI's own questionA question Claude Code or Codex raises through its own prompt.
Tool approval (approve)Only for a Claude agent set to Restricted: "Allow Bash to run?", with the tool's input.

The tools agents use are listed in Agent tools.

Where you see them

Answer opens the agent. Its questions show at the top of its conversation, and the first one takes the focus.

An agent can say how urgent its question is. Urgent ones come first in Needs you, marked Urgent, says the agent; ones it calls low come last. This is the agent's own word, not Sculptured's judgment. A question nobody answers still times out, and the agent decides for itself.

Answer in the app

Each question is a card above the agent's conversation. It shows what the agent asked, word for word, and when it stops waiting.

A question card above the Planner agent's conversation, with its two choices as buttons and a box for your own answer

What to look for: the choices as buttons, **Send answer** for your own words, and the time the agent decides on its own.
The agent askedWhat the card offers
A question with choicesOne button per choice. If it also takes your own words, a box and Send answer.
A question in its own wordsA box for your answer and Send answer.
To run a tool (Restricted agents)The tool, its input under Tool input, and Sculptured's reading of what it would do, such as "deletes files". Then Allow or Deny.

How answers are delivered

Your answer is recorded first and then sent to the agent. The log reads question raised, then answered, then the agent's reply.

When nobody answers

Each question waits 10 minutes by default. A team can set a timeout from 1 to 1440 minutes. An unanswered question lets the agent decide; an unanswered tool approval is allowed automatically.

An agent question times out
The agent is told: "No operator answer within 10m. Proceed with your best judgment and state the decision you made." It is asked to call record_decision with what it chose and why. That decision is recorded as agent-reported. If the agent says nothing, the decision's source stays unknown.
A tool approval times out
An approval nobody answers in time is allowed, and the decision is recorded. You can still choose Deny now on its card afterwards. Approvals are a way to watch a restricted agent, not a guarantee that a tool never runs. Keep work you must not risk away from agents nobody is watching.
You answer after the timeout
A late answer is not lost. It reaches the agent once, as an instruction that overrides the decision it made on its own.

When a question is withdrawn

A question is marked withdrawn when its waiting call can no longer receive an answer. The card records the reason:

After a Sculptured restart, the agent's computer sends the waiting call again when it reconnects, so the question can appear again as a new one.

When the computer is offline

Sculptured can record your answer while the agent's computer is offline. Delivery waits for the connection to return:

  1. The question stays open. You can still answer it.
  2. Your answer is kept.
  3. When the computer reconnects, the agent's waiting call is sent again and gets your answer. It is answered once, not asked twice.

Answers are kept for six hours for a computer that comes back. See When the computer drops off.

Workflow decisions

Teams with a workflow can include a stage where a person decides. Those items wait under Work evidence on the Run board, in Waiting for you. Each shows the stage's prompt, the latest evidence and one button per outcome. You can add an optional note. Each step in an item's history is labelled agent-reported, verified check, person's decision or Sculptured. See Workflows.

Next steps