eventName
ShellEnv (canonical)
displayName
ShellEnv (canonical)
kind
canonical
direction
pre
blocking
true
family
shell-hook
payloadSchema
type
object
required
properties
session_id
requested_env
type
object
description
Environment variable map the agent intends to expose to the next tool subprocess.
cwd
description
Fires before the runtime materializes the environment for a shell tool
invocation. Subscribers can inject, redact, or veto env vars. Used to
enforce secret-handling policy + capability profiles. Native
equivalents: claude-code / opencode `ShellEnv`.