src/
├── AiClient.php
├── MessageBuilder.php
├── PromptBuilder.php
|
├── Enums/
│   └── ...all of the non-provider enums
|
├── ProviderImplementations/
│   ├── Anthropic/
│   |   └── ...
│   ├── Google/
│   |   └── ...
│   └── OpenAI/
│       └── ...
|
├── Providers/
│   ├── Contracts/
│   |   └── ...all of the provider contracts
│   ├── Enums/
│   |   └── ...all of the provider enums
│   ├── Types/
│   |   └── ...all of the provider classes
|   └── Util/
│       └── ...provider utils
|
├── Types/
|   └── ...most of the classes and interfaces
|
└── Util/
    └── ...non-provider utils

src/
├── AiClient.php
|
├── Builders/
│   ├── MessageBuilder.php
│   └── PromptBuilder.php
│
├── Embeddings/
|   |
│   └── DTO/
│       └── Embedding.php
│
├── Files/
|   |
│   ├── Contracts/
│   |   └── File.php
|   |
│   └── DTO/
│       └── InlineFile.php
│       └── LocalFile.php
│       └── RemoteFile.php
|
├── ProviderImplementations/
│   ├── Anthropic/
│   |   └── ...
│   ├── Google/
│   |   └── ...
│   └── OpenAI/
│       └── ...
|
├── Messages/
|   |
│   └── DTO/
│   |   └── Message.php
│   |   └── MessagePart.php
|   |
│   └── Enums/
│       ├── MessageRole.php
│       └── MessagePartType.php
│
├── Operations/
|   |
│   ├── Contracts/
│   |   └── Operation.php
|   |
│   └── DTO/
│       └── EmbeddingOperation.php
│       └── GenerativeAiOperation.php
│
├── Providers/
│   ├── AiProviderRegistry.php
|   |
│   ├── Contracts/
│   |   ├── AiModelMetadataDirectory.php
│   |   ├── Authentication.php
│   |   ├── HttpClient.php
│   |   ├── AiProvider.php
│   |   └── AiProviderAvailability.php
|   |
│   ├── DTO/
│   |   ├── AiProviderMetadata.php
│   |   └── AiProviderModelsMetadata.php
|   |
│   ├── Enums/
│   |   ├── AiProviderType.php
│   |   └── ToolType.php
|   |
│   └── Models/
│       |
│       ├── Contracts/
│       |   ├── AiModel.php
│       |   ├── WithAuthentication.php
│       |   ├── WithEmbeddingOperations.php
│       |   ├── WithGenerativeAiOperations.php
│       |   └── WithHttpClient.php
│       |
│       ├── DTO/
│       |   ├── AiModelConfig.php
│       |   ├── AiModelMetadata.php
│       |   ├── AiModelRequirements.php
│       |   ├── AiRequiredOption.php
│       |   └── AiSupportedOption.php
│       |
│       ├── EmbeddingGeneration/
│       |   └── Contracts/
│       |       ├── AiEmbeddingGenerationModel.php
│       |       └── AiEmbeddingGenerationOperationModel.php
│       |
│       ├── Enums/
│       |   ├── AiCapability.php
│       |   ├── AiModality.php
│       |   ├── AiOption.php
│       |   ├── FinishReason.php
│       |   └── OperationState.php
│       |
│       ├── ImageGeneration/
│       |   └── Contracts/
│       |       ├── AiImageGenerationModel.php
│       |       └── AiImageGenerationOperationModel.php
│       |
│       ├── SpeechGeneration/
│       |   └── Contracts/
│       |       ├── AiSpeechGenerationModel.php
│       |       └── AiSpeechGenerationOperationModel.php
│       |
│       ├── TextGeneration/
│       |   └── Contracts/
│       |       ├── AiTextGenerationModel.php
│       |       └── AiTextGenerationOperationModel.php
│       |
│       └── TextToSpeechConversion/
│       |   └── Contracts/
│       |       ├── AiTextToSpeechConversionModel.php
│       |       └── AiTextToSpeechConversionOperationModel.php
|       |
|       └── Util/
|           └── AiCapabilitiesUtil.php
│
├── Results/
|   |
│   ├── Contracts/
│   |   └── Result.php
|   |
│   └── DTO/
│       ├── Candidate.php
│       ├── EmbeddingResult.php
│       ├── GenerativeAiResult.php
│       └── TokenUsage.php
|    
├── Tools/
|   |
│   └── DTO/
│       ├── FunctionCall.php
│       ├── FunctionDeclaration.php
│       ├── FunctionResponse.php
│       ├── Tool.php
│       └── WebSearch.php
│
└── Util/
    ├── MessageUtil.php
    ├── CandidatesUtil.php
    └── RequirementsUtil.php