AntigravityCliSdk.Options validates the SDK invocation contract before any
process is launched.
| Field | Type | Default | CLI mapping |
|---|---|---|---|
model | string or nil | core catalog default | Core model payload |
cli_command | string or nil | app config/PATH | Path to agy |
sandbox | boolean | false | --sandbox |
dangerously_skip_permissions | boolean | false | --dangerously-skip-permissions |
conversation | string or nil | nil | --conversation <id> |
continue | boolean | false | --continue |
add_dirs | list of strings | [] | repeatable --add-dir <path> |
print_timeout | string or nil | nil | --print-timeout <value> |
log_file | string or nil | app config or nil | --log-file <path> |
cwd | string or nil | nil | subprocess working directory |
timeout_ms | positive integer | 300_000 | idle wait between stream events |
run_deadline_ms | positive integer | 300_000 | non-rearming total run ceiling |
transport_headless_timeout_ms | positive integer | 5_000 | Core orphan-reap window |
completion_only | boolean | false | common intent; unsupported |
output_schema | term or nil | nil | common intent; unsupported |
api_key | string or nil | nil | ANTIGRAVITY_API_KEY in child env |
env | map | %{} | child env overlay |
execution_surface | struct/map/keyword | local | core execution placement |
governed_authority | struct/map/keyword or nil | nil | materialized command/cwd/env authority |
Library code reads application configuration through Application.get_env/3.
config/runtime.exs is responsible for translating OS environment variables
such as ANTIGRAVITY_CLI_PATH, ANTIGRAVITY_MODEL, and
ANTIGRAVITY_LOG_FILE into application config.
ArgBuilder always renders the prompt as ["--print", prompt] first, then
adds Antigravity-native flags. --add-dir is repeatable and is never
comma-delimited.
Unsupported common intents fail with a typed SDK error before CLI resolution.
Antigravity --sandbox and permission controls are not treated as proof of a
no-tool completion-only posture.