Skip to content

Risk Scope

risk_scope describes what kind of boundary the proposed action touches. It lets policy, UI, runtime, and evidence use the same language for risk.

Scope types

Scope typeExamples
tool_callshell, browser, database, editor, network tool.
model_callexternal model, local model, long context, high-cost model.
artifact_exportreport, image, dataset, bundle, support package.
source_accessprivate docs, paid content, customer data, retrieval index.
credential_useAPI key, OAuth token, SSH key, browser session.
filesystemread, write, delete, move, bulk edit.
networkweb fetch, webhook, remote API, production endpoint.
remote_agentpeer agent, delegated worker, hosted runtime.
data_retentionmemory, logs, traces, evidence, cache.
redactiondisplay, export, training, support handoff.
human_actionsending email, submitting form, purchasing, publishing.

Risk level

Risk is not only about safety. It also covers reversibility, privacy, cost, compliance, trust boundary, operational blast radius, and user surprise.

LevelGuidance
lowUsually safe to auto-allow with audit.
mediumShould be visible and constrained.
highUsually needs approval, sandboxing, or a narrow grant.
criticalNeeds explicit authority, review, and strong evidence.
unknownTreat as blocked until facts improve.

Design note

Risk scope should be generated before a policy engine evaluates rules. This lets engines, UI, and evidence agree on the same risk classification even if they use different enforcement mechanisms.

Draft standard for portable agent policy decisions, approvals, permissions, risk, and audit traces.