Connection interruptions
What keeps going, what waits and what happens on reconnect when the computer running your agents loses its connection mid-run.
A lost connection to Sculptured does not stop agents on a computer that is still running. The runner keeps their events and sends them when it reconnects. While the connection is down, the app shows the last known activity.
Sleep and shutdown are different: sleep pauses the agents, and a shutdown ends their processes. Keep the computer awake for uninterrupted work.
Identify the interruption
| Connection | If it drops | What you see |
|---|---|---|
| Your browser ↔ Sculptured | Only the page stops updating. Agents are not affected. | "reconnecting" in the status line. On a team page that never got its first update: "Live updates for … aren't arriving." |
| Your computer ↔ Sculptured | Agents keep running on the computer. Sculptured cannot see them for a while. | Agents show unknown. Status reads "reconnecting". |
| Sculptured itself restarts | The computer reconnects to the new server on its own. | A short "reconnecting", then agents return. |
What keeps going
sequenceDiagram
participant A as Agent
participant R as Runner on your computer
participant S as Sculptured
participant Y as You
A->>R: "request_input: Which colour?"
R->>S: "the agent's call"
S-->>Y: "question: needs you"
Note over R,S: "connection drops"
R->>R: "keeps the call, keeps recording events"
Y->>S: "answer: Green"
S->>S: "answer kept, question still open"
Note over R,S: "connection back"
R->>S: "replayed events, the call again"
S->>R: "the kept answer, once"
R->>A: "Green"
- Agents keep running. The runner on your computer, which you installed with the connect command, keeps supervising them. Nothing is stopped because the connection dropped.
- Events are kept. The runner records what agents do while offline and sends it when it reconnects. It keeps the latest 10,000 events. If more were lost, Status says "N events lost — history has a gap".
- Agents' calls wait. When an agent asks a question, reports findings or starts a helper, the runner keeps the call. It sends the call again on every new connection until it is answered. Sculptured acts on each call once, so a question is not asked twice.
- Questions stay open. You can answer while the computer is away. The answer is kept for six hours and reaches the agent when the computer returns. If Sculptured itself restarted, an open question is withdrawn, then asked again as a new one when the computer reconnects. See Questions and approvals.
What you see while it is away
- Agents that were running become stale: "Lost contact with host …; reconnecting…". Their cards show ∅ unknown, and their activity is the last one seen.
- The Run board says "N disconnected agents have unknown status."
- Status reads "reconnecting".
- In Runs on, the computer is listed as "(not connected)".
What you can still do
Start a team or send a message
Stop an agent or the team
Answer a question
Edit the design
When it comes back
The runner reconnects on its own. It checks the connection every 25 seconds, gives up on a silent one after 75 seconds, and retries every few seconds. On reconnect it tells Sculptured which agents are still alive.
| On reconnect | Result |
|---|---|
| The agent is still running | It returns to running. Its events since the drop arrive. |
| The agent was stopped while offline | It is stopped now. |
| The agent's process ended, for example after a reboot | It needs attention, with the reason. If the team is still set to run, the board asks "N agents stopped mid-work. Resume them where they left off?" with Resume, Start fresh and Leave stopped. Nothing relaunches until you answer. |
If live updates never arrive
If a team page stays on "Connecting to …" for 8 seconds, it says "Live updates for … aren't arriving." Sculptured keeps trying in the background. The agents are not affected. This is usually a dropped network connection, or a network that blocks live connections, such as some company proxies. Use Try again, or Open the Design board to keep working on the design.
If the computer was disconnected from your account
If you remove a computer from the Computers page, its runner stops with "This computer was disconnected from its Sculptured account." Copy a new connect command from Computers and run it on that computer. See Connect a computer.