| Name | Type | Description |
|---|---|---|
provider* | str | Provider name (e.g., |
env_var* | str | None | Canonical env var the SDK reads, shown as helper text.
May be |
reason | str | None | Default: NoneOptional context, e.g.,
|
allow_empty_submit | bool | Default: False |
input_placeholder | str | None | Default: None |
submit_label | str | None | Default: None |
Modal that captures and persists an API key for one provider.
Dismissal values are members of AuthResult so callers in the recovery
path can distinguish "user just saved a key — retry the failed
operation" from "user just cleared their key — don't retry, that would
loop into the same error" from "user cancelled — leave state alone".
Whether pressing Enter on an empty key dismisses
with AuthResult.CANCELLED instead of showing a validation error.
Optional placeholder override for the key input.
Optional help-label override for the Enter action.
