#[non_exhaustive]pub struct ApprovalSubject {
pub kind: String,
pub command: Option<String>,
pub workspace_root: Option<String>,
pub stages: Option<Vec<ApprovalStage>>,
pub tool_name: Option<String>,
pub path: Option<String>,
pub access: Option<String>,
pub host: Option<String>,
pub port: Option<u16>,
pub protocol: Option<String>,
pub target: Option<String>,
pub origin: Option<ApprovalOrigin>,
}Expand description
Open approval subject union. Unknown kinds are rendered generically and never auto-approved by clients.
Fields (Non-exhaustive)§
This struct is marked as non-exhaustive
Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.kind: StringOpen discriminator: shell | fileAccess | network | unixSocket | process | tool.
command: Option<String>The full raw shell command. Present when kind is shell.
workspace_root: Option<String>The canonical workspace root the shell command runs in, present on
shell subjects when the host knows it. Saved command-prefix rules
apply only within this root.
stages: Option<Vec<ApprovalStage>>The shell command split into stages that are approved separately (the
commands of a pipeline or command list), in order. Present on shell
subjects; it may be empty.
tool_name: Option<String>The tool asking for the action. Present for every kind except shell.
path: Option<String>For fileAccess, the path the tool asked to access, normalized by the
host (workspace-relative inside the workspace); for
unixSocket, the exact resolved socket path, sent unescaped, so escape
it before display.
access: Option<String>The access asked for: read or write for fileAccess, control for
process. Absent for other kinds.
host: Option<String>The network host the tool wants to reach. Present when kind is
network.
port: Option<u16>The network port, present only on network subjects that name one. A
session grant made from a subject without a port covers every port.
protocol: Option<String>The network protocol, for example https. Present only on network
subjects that name one.
target: Option<String>Display text naming the process the tool wants to control. Present when
kind is process.
origin: Option<ApprovalOrigin>What triggered the action (a shell command or a URL), for display only
and untrusted. It is not sent on shell subjects, and policy rules
never match on it.
Implementations§
Source§impl ApprovalSubject
The ApprovalSubject.kind wire words — one source for the session-view fold
that writes them and every client that inverts them.
impl ApprovalSubject
The ApprovalSubject.kind wire words — one source for the session-view fold
that writes them and every client that inverts them.
Sourcepub const KIND_SHELL: &'static str = "shell"
pub const KIND_SHELL: &'static str = "shell"
shell: run a shell command. See command, workspaceRoot and
stages.
Sourcepub const KIND_FILE_ACCESS: &'static str = "fileAccess"
pub const KIND_FILE_ACCESS: &'static str = "fileAccess"
fileAccess: a tool wants to read or write a path. This grants access
to the path; it is not a review of file contents. See path and
access.
Sourcepub const KIND_NETWORK: &'static str = "network"
pub const KIND_NETWORK: &'static str = "network"
network: a tool wants network access. See host, port and
protocol.
Sourcepub const KIND_UNIX_SOCKET: &'static str = "unixSocket"
pub const KIND_UNIX_SOCKET: &'static str = "unixSocket"
unixSocket: a command wants to connect to the local Unix socket at
path. Only one-time choices are offered, and no rule is ever saved.
Sourcepub const KIND_PROCESS: &'static str = "process"
pub const KIND_PROCESS: &'static str = "process"
process: a tool wants to control another process. See target and
access.
Sourcepub const KIND_TOOL: &'static str = "tool"
pub const KIND_TOOL: &'static str = "tool"
tool: any other tool action, such as an MCP tool call. Show it using
toolName and the request’s rawArgs.
Sourcepub const ACCESS_READ: &'static str = "read"
pub const ACCESS_READ: &'static str = "read"
read: read access to a fileAccess path.
Sourcepub const ACCESS_WRITE: &'static str = "write"
pub const ACCESS_WRITE: &'static str = "write"
write: write access to a fileAccess path. It does not include read
access.
Sourcepub const ACCESS_CONTROL: &'static str = "control"
pub const ACCESS_CONTROL: &'static str = "control"
control: control of a process target.