← Return to field notes
ai / operator interface doctrine

An agent interface needs an abort button

Autonomy without state, approvals, interruption, and recovery is not power. It is a process that cannot be trusted.

field-note working created 2026-06-23 updated 2026-07-18 3 min 3 sections 0 figures
subscribe via RSS report a correction sec intro ~3 min left read 0%
opening contract field-note · working
problem
Agent interfaces that hide run state, approvals, changes, and safe interruption force the operator to choose between blind trust and constant log watching.
scope
A working interface contract for observable, interruptible agents; not a complete product specification.
environment
Local and remote coding or workflow agents with tools, approvals, memory, background runs, and recoverable state.

Assumptions

  • Runs have stable identities and explicit lifecycle states.
  • The runtime can expose changes and accept cancellation safely.

Limitations

  • The interaction model remains working doctrine and needs usability evidence across multiple agent runtimes.
Table of contents 3 sections
  1. 1 Expose state without requiring log watching
  2. 2 Build more than a chat surface
  3. 3 Make autonomy earn trust

Expose state without requiring log watching

An agent interface should expose state without forcing the operator to tail logs all day: what is running, what changed, what is blocked, what requires approval, and what can be interrupted without corrupting the work.

The runtime already knows most of this state, but interfaces flatten it into “thinking” or a stream of tokens. Lifecycle states need timestamps and ownership: queued, gathering context, executing a tool, waiting on a human gate, verifying, completed, failed, or cancelling. Background work needs durable completion notices reconciled against live state so a delayed notification cannot trigger a stale retry.

Build more than a chat surface

The control surface is not chat-only. It needs threads, run state, approvals, memory, diffs, stop controls, and a fast path back to the current objective.

Each approval should name the exact command or side effect, scope, affected resources, reversibility, and the state that will follow acceptance or rejection. The diff and verification results belong beside the approval rather than in a separate log hunt. A stop control must say whether it requests cooperative cancellation, kills an owned process, or leaves an external operation potentially ambiguous.

Make autonomy earn trust

Autonomy earns trust through inspectability. The moment a system cannot explain its state or accept an abort, the operator has lost the advantage.

The interface should optimize for exception handling, not celebratory demos. Healthy runs collapse into concise evidence. Stalled loops expose repeated actions and budget. Partial failure preserves artifacts and a resumable packet. Human input gates surface one concrete decision. This lets the operator supervise several durable workflows without becoming the scheduler, while keeping authority over destructive or externally visible actions.

evidence ledger 1 claim
  1. inferred
    Operator-control model

    Threads, run state, approvals, diffs, stop controls, and continuity form one inspectability boundary rather than independent features.

linked artifacts 0 attached

No public artifact is attached to this record. The limitation is explicit rather than replaced by a decorative link.