Review of the first version against 366 recorded runs found four defects and one
semantic gap, all fixed here.
- Two same-named calls in one batch swapped results, exit codes, origins and audit
links in the live view: the finished event was matched to the LAST pending item by
name. `tool_proposed` now carries the tool call id and the GUI matches on it.
- A command's exit status was read from the 300-character result preview; a long
command pushed it out, and a timed-out command showed a green dot. The exit code,
time-out and background flags now ride on `tool_finished` and on the persisted
display sidecar.
- After a reload every non-denied call replayed as "ok", so a failed write showed as
done. The status is persisted with the result and replayed.
- A notice inside a turn (compaction, continuation, a saved memory) split the summary
in two and showed the first half while the turn was still running. One block per
turn now, emitted after the answer.
The header reads "N changes auto-approved" and the count means "things that changed
state and that nobody approved": the engine stamps each cardless call's effect
("change" or "read", from its risk class and tier) and the summary counts failed
attempts and read-only actions apart. Several edits of one file collapse into one row;
background commands are labelled; after 25 rows the list offers the rest.
`turn_summary` gains `failed` and `reads`, and per-action effect, tier and shell
outcome; docs/headless.md describes the fields.
A user who was away had no simple view of what ran with no approval card. After a
turn in which auto-approve let actions through (a gate tier or a reviewer "allow"),
the transcript now ends the turn with a collapsed "N changes made without asking"
block: file changes with diffs, commands with their exit status, other actions,
each with who let it through and a link to its audit rows.
- engine: one TURN_SUMMARY event just before the event that ends the turn, listing
tool call id, tool, origin, status and the reviewer's reason (no arguments).
Wraps run / retry / resume; closing the wrapper closes the turn as before.
- audit: /v1/audit takes call_id; Activity opens filtered to one call, clearable.
- gui: tool items carry their call id, live and on reload; the block is built from
the persisted approval origins, so a reloaded session shows the same summary.
- docs/headless.md: the event in events.jsonl.
Whether a model declines to upload a .env file is model behaviour, not policy,
and OpenWorker lets users pick any model. A new floor, placed with the other
human-only floors (ahead of every allowlist, the allowed-sites wall and the
reviewer): an action that sends data off the machine (egress or external risk:
web tools, connector writes, MCP tools; or a shell command running a network
client) AND names a secret-looking file (.env*, *.pem, id_rsa*, credentials*,
*token*, ...) or carries a secret-looking value (private-key headers, sk-,
AKIA, ghp_, xox?- shapes, api_key = <long value>) is human-only in every
asking mode and in bypass-approvals; dangerous-bypass clears it and records
the floor. Templates and public keys (.env.example, *.sample, *.pub) are not
secrets. A backstop on top of the sandbox network allowlist: shell egress
can't be recognised completely.
Corpora: gate-104 (browser upload of an SSH key) moves from reviewer_eligible
to human_only (secure stays hard_deny); four secret-egress gate rows are
appended (gate-133..136). Seven frozen legacy reviewer rows the floor now
intercepts (danger-003/010, inject-001/002/008/014/016) stay as they are; the
hygiene test lists them explicitly and checks they're caught by this floor.
Docs: the floor joins the safety-check list; the Windows sandbox page notes
what "Allow everything" leaves to the approval flow.
Same shape as llama.cpp/vLLM/LM Studio: address + optional key, models from the server.
Docker's /engines path is added when the user types the root; mlx-lm's help covers the port shared with llama.cpp.
Local-server checks now read LOCAL_SERVERS instead of a hand-kept tuple.
Both You.com hosts join PROVIDER_HOSTS (keyed vs keyless) and the Sites catalogue; the YDC_API_KEY fallback moves to key resolution.
Every provider declares key_mode none/optional/required beside display_name and key_url.
Firecrawl's host joins PROVIDER_HOSTS and the Access ▸ Sites catalogue.
The class gets display_name and key_url and raises on HTTP errors like the others.
config.example.toml covered 7 of the 13 supported keys; a user reading it
could not discover how to switch web-search providers or point a dev/BYO
deployment at its own cloud instance. Adds web_search_provider (with the
three supported backends) and the cloud_* family (commented out — the
defaults are the production values, and an empty cloud_relay_ws_url
meaningfully disables the relay). Also notes the Windows global config
location and that allowed_commands/auto_allow are global-only until
workspace trust.
Verified: the example parses with tomllib and every key (including the
commented cloud_* names) matches coworker.config._FIELDS.
For sealed evaluation runs and air-gapped work. A network block only refuses the call: the model still sees both tools, can spend turns on them, and the record cannot say they were absent. The flag withholds them at registration (build_engine(web_tools=False)), and summary.json and the trajectory record web_tools: false. Without the flag nothing changes.
Tests: with the flag both calls get the engine's unknown-tool answer and the record says false; without it web_fetch is present, shown with a non-URL the tool rejects before any network I/O.
Each is a provider of its own with an address and an optional key; the served model, its window and tool support are read from the server (vLLM is probed for tool calling).
Providers carry a kind (local, subscription, api_key) for the settings page; docs/local-servers.md.
model_config.json holds context size, longest reply, thinking, sampling, auto-compact and the default model; the app's API and the CLI read it.
recommended_models.json carries the makers' own values per model, with sources; docs/model-settings.md explains both.
build_macos_cli.sh freezes the CLI, signs and notarizes it; the release attaches it for arm64 and x86_64.
install.sh downloads it on a Mac instead of the Python package.
With a person at the terminal the coworker asks, they allow the site from outside, and it tries again.
With auto-answer it reports the block in its answer, as before.
packaging/openshell/Dockerfile: the CLI plus common developer tools, about 1.3 GB.
Profiles for OpenAI and Anthropic name OpenWorker's own Python. docs/openshell-inside.md has the steps.
A failed model call prints what was underneath it, such as a proxy's 403.
SIGTERM during the wait before a retry now stops the run and leaves its record (exit 130).
--mode, --persona, --attendance and the unlisted mode names are no longer accepted.
Flags cannot be shortened, so --mode is refused instead of being read as --model.
Default mode is ask; approvals and questions are separate (--auto-answer); --isolated keeps the sealed benchmark run.
Without --out the record goes to sessions/<workspace path>/<session id> in the state folder; --allow-site adds sites for the run.
Exit code 0 only when the task finished; 3 when it stopped early with its record written.
The sandbox's own log is followed from outside; a refusal reaches us up to half a second late.
A failed command waits for it; one that arrives after its result is told with the next result.
Sites from Settings are listed plain; sites allowed for this session are marked "Session only".
The person can allow one more for the session or take one back; the running sandbox follows at once.
A new tool, request_network_access, raises a card only a person answers: this session, always, or deny.
A command's result names the sites the sandbox blocked while it ran, and the agent is told the live list each turn.
The header chip lists the sites allowed for this session apart from the machine's.
"This session" and "Always allow" now reach the session's commands at once.
OpenShell: the policy is rendered again and set on the sandbox; macOS and Windows: the session's own proxy takes the host.
"Always allow" now copies the list back as the store keeps it, so the chip matches Settings.
The three sandbox pages say web search and fetch follow the list; connectors and MCP do not.
"root" already means the superuser and the top of the filesystem; `--add-dir` says what
the flag does and is the name the best-known agent CLIs use for the same idea. Recorded
in summary.json as args.extra_dirs.
A harness can put its output contract outside the workspace: CyberGym-E2E runs the agent
in /src and grades /output/fix.patch and /output/poc.bin. OpenWorker's file tools only
write under a declared root, in every permission mode (the dangerous mode clears the
permission floor, but the tools still resolve paths against the session's roots by
construction), while the shell is not scoped. So without a way to declare /output, a
delivery depended on which tool the model happened to pick.
`--root DIR` (repeatable) adds writable roots after the workspace, which stays the folder
relative paths resolve against; the folders are announced to the model in the session's
directories block and recorded under args.roots in summary.json. The reference harness
does the same for Gemini CLI with --include-directories /src,/scripts,/output.
A headless one-shot command beside `up`: give it a task, a folder and a model; it builds the same engine the desktop app uses, runs to the end with attendance `auto` (coworker/unattended.py), and leaves a record: every event, the final conversation, a summary with tokens and cost, every answer the engine gave on the absent user's behalf, the audit log, a per-call model log, and a trajectory in the ATIF interchange format. The trajectory and the exit code are the stable contract; the other files are internal.
State and scratch folders are pointed under --out before the engine starts, so a run never touches the machine's own conversations, keys or settings. A transient provider failure or an empty reply is waited out with backoff and a nudge instead of ending the run; permanent errors are not retried. Tool results are bounded with the full text spilled beside the record. A small price table gives an estimated cost per call as a cross-check; an unpriced model gets counts but no cost.
The mode axis decides approvals (`dangerously-bypass-approvals` prints its warning line here); the runner adds no policy of its own.
The app moves to a free port only when 8765 is taken (after waiting 5 s for a previous copy to stop) and the Machines page then says so; OPENWORKER_PORT overrides for developers (OPE-212).
A throwaway container asks the kernel; without Landlock the Docker row says update Docker Desktop.
A sandbox that exits at start on such a Mac gets the same message instead of ContainerExited.