Feature · Organization
Oversight
Review risks, failures and paused work with their evidence.
How it works
What it watches
Detectors run every minute where workers are enabled. They look for:
- Spend: a spike against the recent average, a budget that will run out today, and single calls that cost much more than usual;
- Loops: the same tool call again and again, repeated failures, review loops, stuck items and runs with no progress;
- Failures: high error rates, and items that reopen or fail verification again and again;
- Behaviour: actions outside a worker's history, bursts of outgoing messages, and writes into another department's work;
- Catastrophic attempts: critical-risk actions, the kill switch, and secrets the outgoing check blocked.
Severities and responses
Each finding is Info, Warning or Critical. By default:
- Info goes to the digest.
- Warning notifies you and asks the responsible manager.
- Critical pauses the worker or department and notifies you.
The Oversight page
Oversight shows findings, open findings by severity, spend by department and paused subtrees. Members can Acknowledge and Resolve a finding. Admins can suppress a finding for 1 hour, 1 day or 1 week, and resume a paused subtree.
Settings
The oversight.* settings hold the thresholds and responses. An owner or admin changes them in the organization settings list on Settings.
From the help article Oversight, checked against the product on .
What you can do
The operations this feature's screens call. Each one is POST /api/<name>, and the badge says who may call it.
VieweroversightSummaryOversight summary.
Types:
EmptyRequestreturnsOversightSummaryDto
ViewerlistFindingsLists findings.
Types:
ListFindingsRequestreturnsListResponse<FindingDto>
MemberacknowledgeFindingAcknowledges the finding.
Types:
FindingIdRequestreturnsFindingDto
MemberresolveFindingResolves the finding.
Types:
ResolveFindingRequestreturnsFindingDto
AdminsuppressFindingSuppresses the finding.
Types:
SuppressFindingRequestreturnsFindingDto
AdminresumeSubtreeResumes the subtree.
Types:
ResumeSubtreeRequestreturns{ pause: SubtreePauseDto; workersResumed: number; itemsWoken: number }
ViewerlistMembersLists members.
Types:
EmptyRequestreturnsListMembersResponse
Screens
What it records
The feature writes these events to the audit log, the permanent record of what happened.
- Oversight finding opened
- Oversight finding updated