Interface ProviderPlugin

crates/openshell-providers/src/lib.rs:59–80

}

pub trait ProviderPlugin: Send + Sync {
    /// Canonical provider id (for example: "claude", "gitlab").
    fn id(&self) -> &'static str;

    /// Discover provider credentials and config from the local machine.
    fn discover_existing(&self) -> Result<Option<DiscoveredProvider>, ProviderError>;

    /// Return the known credential environment variable names for this provider type.
    ///
    /// Used by the TUI to label BYO key entry fields and to choose which
    /// env var name to store a manually-entered credential under.
    fn credential_env_vars(&self) -> &'static [&'static str] {
        &[]
    }

    /// Inject provider-specific environment variables into the sandbox env.
    ///
    /// Called during sandbox creation to project provider config (project IDs,
    /// regions, SDK flags) into env vars the sandbox process will inherit.
    /// Default is a no-op; GCP and Vertex providers override this.
    fn inject_env(&self, _provider: &Provider, _env: &mut HashMap<String, String>) {}
}

/// Blanket implementation of [`ProviderPlugin`] for [`ProviderDiscoverySpec`].
///