mirror of
https://github.com/usestrix/strix.git
synced 2026-08-25 20:32:38 +02:00
feat(safety): workspace-file reads, approval UX, and integration hardening
Engine + integration: - Reviewer inspection now surfaces the real frozen source of an already-frozen workspace script/dependency instead of an empty string, so workspace-resident scripts resolve without a needless human defer. - Guard effectful static tools via an explicit, documented set plus the SDK's per-tool needs_approval signal; give the exec/stdin wrappers the same idempotency guard as their sibling wrappers. - Centralize DEFAULT_SAFETY_MODE and share one resume safety-mode rule between the CLI and runner so the two cannot drift; type InspectionContext.runner, reuse RUNTIME_STATE_DIR_NAME, and drop a dead workdir parameter and a write-only field. TUI approval experience: - Approve All drops the run into dangerous mode: it approves the pending call and turns review off for the rest of the run, with a standing "review off" status flag. - The status row shows the owning agent as paused while it waits on a decision. - Redesigned prompt: a risk + tool header, a collapsible command/reason preview that expands (e) and scrolls, and no internal digest, agent, or request ids. Full Python (1138) and Go suites, ruff, and mypy strix/ pass. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.8
parent
41b7b4f392
commit
ccbd8c7b58
+80
-24
@@ -37,25 +37,60 @@ workspace persistence details.
|
||||
|
||||
The safety model may decide immediately or make exactly one `run_inspection`
|
||||
tool call. That call runs a Python standard-library analysis script in a
|
||||
separate networkless, read-only container over the frozen evidence. If the tool
|
||||
is used, the model's next response must be the final decision.
|
||||
separate networkless, read-only container over the frozen evidence. For an
|
||||
incomplete packet in the interactive TUI, the reviewer must use that call to
|
||||
pinpoint the missing evidence and determine what the available artifacts still
|
||||
establish. If the tool is used, the model's next response must be the final
|
||||
decision.
|
||||
|
||||
The review is bounded to at most two model turns and one optional inspection
|
||||
call. Timeouts, malformed decisions, a second tool call, incomplete evidence,
|
||||
and reviewer failures fail closed.
|
||||
That single call can request explicit files or trailing-slash directories under
|
||||
`/workspace`. Strix uses fixed read/list primitives to freeze bounded regular
|
||||
files, directory listings, bytes, and digests into the evidence bundle, skipping
|
||||
symlinks and special files, and returns bounded previews to the reviewer. The same call may
|
||||
run a networkless analysis script over the augmented read-only bundle. The
|
||||
reviewer never executes model-authored commands in the live workspace, and the
|
||||
collected files become part of final fingerprint revalidation.
|
||||
|
||||
In the interactive TUI, the reviewer can defer when complete evidence still
|
||||
leaves genuine ambiguity about whether an exact action is dangerous. Strix then
|
||||
pauses that tool call and asks the user to approve or deny it. Denial is selected
|
||||
by default, Escape denies, and the request waits until it is answered, the agent
|
||||
is stopped, or Strix exits. Approval applies only to the frozen call shown in
|
||||
the prompt; actions too large to display exactly must be split into smaller
|
||||
tool calls. Deterministic blocks, incomplete evidence, review errors, and
|
||||
Evidence acquisition gaps and reviewable uncertainty are distinct. Missing,
|
||||
unreadable, truncated, or unfrozen bytes are hard gaps and cannot support an
|
||||
automatic allow. When all relevant code and inputs are frozen but values such as
|
||||
a request destination or subprocess argument require correlation, the packet is
|
||||
`reviewable`; one successful inspection may resolve and allow it without asking
|
||||
the user. Only unresolved ambiguity is deferred.
|
||||
|
||||
The review is bounded to at most two model turns and one inspection call.
|
||||
Timeouts, malformed decisions, a second tool call, and reviewer failures fail
|
||||
closed.
|
||||
|
||||
In the interactive TUI, the reviewer can defer when the evidence still leaves
|
||||
genuine ambiguity about whether an exact action is dangerous. This includes an
|
||||
incomplete packet after the one inspection call has identified its unresolved
|
||||
gaps. Strix then pauses that tool call and asks the user to approve or deny it.
|
||||
The prompt shows the risk, the tool, and a preview of the command and reason;
|
||||
press `e` to expand the full command and reason and scroll them with the arrow
|
||||
keys. Denial is selected by default, Escape denies, and the request waits until
|
||||
it is answered, the agent is stopped, or Strix exits. Approval applies only to
|
||||
the frozen call shown in the prompt; actions too large to display exactly must
|
||||
be split into smaller tool calls. Deterministic blocks, review errors, and
|
||||
actions confidently judged dangerous cannot be overridden.
|
||||
|
||||
Non-interactive runs have no human approval channel. Ambiguity and
|
||||
low-confidence decisions continue to block, preserving fail-closed autonomous
|
||||
behavior.
|
||||
The prompt also offers **Approve All**, which approves the pending call and then
|
||||
turns review off for the rest of the run — every later action runs unreviewed,
|
||||
exactly as if the scan had started with `--dangerously-disable-safety`. A
|
||||
standing "review off" flag on the status row marks that the run is no longer
|
||||
being checked. Use it only when external containment already bounds the blast
|
||||
radius.
|
||||
|
||||
Approval prompts are scoped to their owning agent. The agent list marks the
|
||||
waiting owners with yellow indicators; select each agent to see and resolve its
|
||||
own prompt. Multiple agents can wait for independent approvals at the same time,
|
||||
and resolving one does not hide or block the others. You can continue navigating
|
||||
the agent list with the keyboard or mouse while approvals are pending, and
|
||||
returning to an owner reopens its prompt with Deny selected.
|
||||
|
||||
Non-interactive runs have no human approval channel. Ambiguity, incomplete
|
||||
evidence, and low-confidence decisions continue to block, preserving
|
||||
fail-closed autonomous behavior.
|
||||
|
||||
The reviewer judges an action by its effect, not by the technique it uses or by
|
||||
whether a hostname appears in target scope. A read-only injection probe (a boolean,
|
||||
@@ -85,9 +120,12 @@ reads: `tab` lists tabs, but `tab new <url>` navigates and `tab close` discards
|
||||
page state, so a grouped verb with a subcommand goes to review.
|
||||
|
||||
Commands that wrap another program (`sudo`, `timeout`, `xargs`, `nohup`, and
|
||||
similar) and interactive `write_stdin` payloads cannot be resolved to a single
|
||||
effective action before dispatch, so they are blocked. Issue the command as its
|
||||
own `exec_command` call.
|
||||
similar) cannot be resolved to a single effective action before dispatch. They
|
||||
fail closed in non-interactive runs; where the TUI can present a human decision,
|
||||
the reviewer first inspects and explains the unresolved action. Prefer issuing
|
||||
the underlying command as its own `exec_command` call. Interactive `write_stdin`
|
||||
payloads remain blocked because their effect depends on live process state and
|
||||
buffered input.
|
||||
|
||||
## Scripts
|
||||
|
||||
@@ -99,19 +137,37 @@ imported name is followed as a submodule as well as an attribute, so the whole
|
||||
local closure is inspected. Decisions bind to content hashes. Dynamic code
|
||||
execution, import-path mutation, unresolved generated commands, oversized
|
||||
dependency closures, entrypoints outside `/workspace`, and unsupported evidence
|
||||
block the action.
|
||||
make the packet incomplete. Headless runs block; interactive runs use the one
|
||||
inspection call before any human deferral.
|
||||
|
||||
Literal files read by Python through `open()`, `Path.read_text()`,
|
||||
`Path.read_bytes()`, or read-mode `Path.open()` are frozen as input artifacts,
|
||||
including simple string and `Path` assignments. Relative workdirs resolve below
|
||||
`/workspace`, matching actual sandbox execution. A resolvable script in a later
|
||||
compound-command segment is frozen too; create-and-execute chains remain
|
||||
blocked.
|
||||
|
||||
A command that runs code Strix cannot resolve to an inspectable script — an
|
||||
unrecognized interpreter, or an interpreter given no script — is blocked rather
|
||||
than reviewed against an empty evidence packet.
|
||||
unrecognized interpreter, or an interpreter given no script — is never allowed
|
||||
automatically. It is blocked headlessly or inspected and presented for an
|
||||
explicit TUI decision.
|
||||
|
||||
When a command reads a workspace data file — through input redirection
|
||||
(`while read … done < hosts.txt`) or a target-list flag (`ffuf -w words.txt`,
|
||||
`httpx -l hosts.txt`) — that file's contents are attached to the packet so the
|
||||
reviewer can assess the exact entries, queried hosts, or fuzz inputs instead of
|
||||
blocking because it cannot see them. Only workspace-resident files are read; an
|
||||
oversize file is attached truncated. Any workspace change while the action is
|
||||
under review or awaiting approval invalidates the decision.
|
||||
blocking because it cannot see them. Redirect parsing respects shell quoting,
|
||||
escaping, comments, heredocs, and process substitutions. Referenced files under
|
||||
`/workspace` are read. Missing, unreadable, outside-workspace, over-limit, or
|
||||
truncated inputs make the packet incomplete and follow the headless-block or
|
||||
interactive-review behavior above.
|
||||
|
||||
Evidence collection is serialized briefly to produce a consistent snapshot;
|
||||
model review and human waiting remain concurrent. If another agent changes the
|
||||
workspace during review, Strix refreshes and compares the actual evidence
|
||||
fingerprint. Unchanged evidence executes without interruption. Changed scripts,
|
||||
dependencies, inputs, or missing-file observations are automatically reviewed
|
||||
again, with a new approval only when the refreshed review still needs one.
|
||||
|
||||
Browser automation inside scripts is blocked in safety modes. Issue browser
|
||||
operations as individual raw `agent-browser` commands so each action can be
|
||||
|
||||
Reference in New Issue
Block a user