Interface AiProvider

All Known Implementing Classes:
DisabledAiProvider
public interface AiProvider
SHAFT-owned contract implemented by optional AI providers.

  • Method Details

    • discoverModels

      default AiModelDiscovery discoverModels()
      Discovers provider models without exposing credentials or raw responses.
      Returns:
      safe discovery result

    • id

      String id()
      Returns the stable provider identifier used by pilot.ai.provider.
      Returns:
      provider identifier

    • capabilities

      AiCapabilities capabilities()
      Returns provider capabilities.
      Returns:
      provider capabilities

    • availability

      AiProviderAvailability availability()
      Checks local configuration without transmitting evidence.
      Returns:
      availability result

    • execute

      AiResponse execute(AiRequest request)
      Executes an already approved and redacted request.

      Implementations must honor AiRequest.timeout() and must not log request content, credentials, or raw provider responses.

      Parameters:
      request - approved and redacted request
      Returns:
      normalized response