Update operations handling in accordance with revised interfaces, use generic interface as return type to be future proof.

Author: felixarntz

docs/ARCHITECTURE.md

@@ -826,26 +826,32 @@ direction LR
 
     namespace AiClientNamespace.Providers.Contracts {
         class AuthenticationInterface {
-            +authenticate(RequestInterface $request) void
+            +authenticate(Request $request) void
             +getJsonSchema() array< string, mixed >$
         }
         class HttpClientInterface {
-            +send(RequestInterface $request, array< string, mixed > $options) ResponseInterface
-            +request(string $method, string $uri, array< string, mixed > $options) ResponseInterface
+            +send(Request $request, array< string, mixed > $options) Response
+            +request(string $method, string $uri, array< string, mixed > $options) Response
         }
         class ModelMetadataDirectoryInterface {
             +listModelMetadata() ModelMetadata[]
             +hasModelMetadata(string $modelId) bool
             +getModelMetadata(string $modelId) ModelMetadata
         }
+        class ProviderAvailabilityInterface {
+            +isConfigured() bool
+        }
         class ProviderInterface {
             +metadata() ProviderMetadata$
             +model(string $modelId, ModelConfig|array< string, mixed > $modelConfig) ModelInterface$
             +availability() ProviderAvailabilityInterface$
             +modelMetadataDirectory() ModelMetadataDirectoryInterface$
         }
-        class ProviderAvailabilityInterface {
-            +isConfigured() bool
+        class ProviderOperationsHandlerInterface {
+            +getOperation(string $operationId) OperationInterface
+        }
+        class ProviderWithOperationsHandlerInterface {
+            +operationsHandler() ProviderOperationsHandlerInterface$
         }
     }
 
@@ -888,9 +894,6 @@ direction LR
         class WithEmbeddingOperationsInterface {
             +getOperation(string $operationId) EmbeddingOperation
         }
-        class WithGenerativeAiOperationsInterface {
-            +getOperation(string $operationId) GenerativeAiOperation
-        }
         class WithHttpClientInterface {
             +setHttpClient(HttpClientInterface $client) void
             +getHttpClient() HttpClientInterface
@@ -1050,7 +1053,8 @@ direction LR
     <<interface>> ModelInterface
     <<interface>> ProviderAvailabilityInterface
     <<interface>> ModelMetadataDirectoryInterface
-    <<interface>> WithGenerativeAiOperationsInterface
+    <<interface>> ProviderOperationsHandlerInterface
+    <<interface>> ProviderWithOperationsHandlerInterface
     <<interface>> WithEmbeddingOperationsInterface
     <<interface>> TextGenerationModelInterface
     <<interface>> ImageGenerationModelInterface
@@ -1074,6 +1078,7 @@ direction LR
     ProviderInterface "1" *-- "1" ProviderMetadata
     ProviderInterface "1" *-- "1" ProviderAvailabilityInterface
     ProviderInterface "1" *-- "1" ModelMetadataDirectoryInterface
+    ProviderWithOperationsHandlerInterface "1" *-- "1" ProviderOperationsHandlerInterface
     ModelInterface "1" *-- "1" ModelMetadata
     ModelInterface "1" *-- "1" ModelConfig
     ProviderModelsMetadata "1" o-- "1" ProviderMetadata

src/Providers/Contracts/ProviderOperationsHandlerInterface.php

@@ -5,7 +5,7 @@
 namespace WordPress\AiClient\Providers\Contracts;
 
 use InvalidArgumentException;
-use WordPress\AiClient\Operations\DTO\GenerativeAiOperation;
+use WordPress\AiClient\Operations\Contracts\OperationInterface;
 
 /**
  * Interface for handling provider-level operations.
@@ -24,8 +24,8 @@ interface ProviderOperationsHandlerInterface
      * @since n.e.x.t
      *
      * @param string $operationId Operation identifier.
-     * @return GenerativeAiOperation The operation.
+     * @return OperationInterface The operation.
      * @throws InvalidArgumentException If operation not found.
      */
-    public function getOperation(string $operationId): GenerativeAiOperation;
+    public function getOperation(string $operationId): OperationInterface;
 }