Module●Since v0.1
approval_mode
Approval-mode state shared by the Textual client and agent server.
Attributes
attributeattributeattributeattributeattribute
logger
APPROVAL_MODE_NAMESPACE: tuple[str, str]
Store namespace for per-thread approval-mode control records.
YOLO_ACKNOWLEDGEMENT_POLICY_VERSION: str
Version of the unrestricted-mode warning that must be acknowledged.
YOLO_WARNING_KEY: str
[warnings].suppress key that mutes the recurring "YOLO is active" toast.
Suppression is cosmetic: YOLO still requires an explicit acknowledgement to
enter (a modal in the TUI, a console prompt for --yolo), still honors the
startup.yolo_switcher setting, and still shows a persistent YOLO
status-bar indicator the whole time it is active. Because the acknowledgement
is once per policy version, that indicator is the only remaining in-session
signal for a returning user who has muted the toast.
AUTO_NOTICE_VERSION: str
Version of the first-run Auto mode education notice.
Bump this string whenever the notice copy changes materially enough that already-shown installs should see it again.
Functions
functionfunctionfunctionfunctionfunctionfunctionfunctionfunctionfunctionfunctionfunctionfunction
coerce_approval_mode
Return a validated mode, failing closed to manual.
next_approval_mode
Return the next Shift+Tab approval mode for the active session.
The cycle is Manual → Auto → YOLO → Manual when both Auto and the YOLO
switcher entry are available. Auto is omitted when auto_eligible is false
(for example a remote sandbox). YOLO is omitted when orgs/users disable
startup.yolo_switcher. Launching with --yolo still leaves unrestricted
mode when the switcher entry is disabled; Shift+Tab only exits YOLO then.
approval_mode_key
Return the store key for a thread's live approval mode.
approval_mode_payload
Return the stored approval-mode payload.
read_approval_mode_from_store
Read a live approval mode from the server-side LangGraph Store.
aread_approval_mode_from_store
Asynchronously read a live approval mode from a LangGraph Store.
The graph server supplies an async batched Store whose synchronous methods
reject calls from the event-loop thread. Prefer aget() for that runtime,
while retaining a synchronous fallback for lightweight local test stores.
awrite_approval_mode
Persist approval mode through an agent's remote store client.
yolo_acknowledgement_path
Return the installation-local acknowledgement file path.
has_yolo_acknowledgement
Return whether the current unrestricted-mode warning was accepted.
save_yolo_acknowledgement
Persist the current unrestricted-mode warning acknowledgement.
Merges into any existing approval state so first-run Auto notice fields are preserved. Concurrent saves are serialized with a cross-process lock.
has_auto_mode_notice
Return whether the current Auto first-enable notice was already shown.
The notice self-versions on auto_notice_version and deliberately does not
gate on the top-level version (unlike has_yolo_acknowledgement), so the
two records can evolve independently within one approval.json.
save_auto_mode_notice
Persist that the Auto first-enable notice was shown.
Merges into any existing approval state so YOLO acknowledgement fields are
preserved. Concurrent saves are serialized with a cross-process lock.
Callers should fail open when this returns False.