[Summary view] [Print] [Text view]

   1  <?php
   2  
   3  declare (strict_types=1);
   4  namespace WordPress\AiClient\Providers\Contracts;
   5  
   6  use WordPress\AiClient\Common\Exception\InvalidArgumentException;
   7  use WordPress\AiClient\Operations\Contracts\OperationInterface;
   8  /**
   9   * Interface for handling provider-level operations.
  10   *
  11   * Provides methods to retrieve and manage long-running operations
  12   * across all models within a provider. Operations are tracked at the
  13   * provider level rather than per-model.
  14   *
  15   * @since 0.1.0
  16   */
  17  interface ProviderOperationsHandlerInterface
  18  {
  19      /**
  20       * Gets an operation by ID.
  21       *
  22       * @since 0.1.0
  23       *
  24       * @param string $operationId Operation identifier.
  25       * @return OperationInterface The operation.
  26       * @throws InvalidArgumentException If operation not found.
  27       */
  28      public function getOperation(string $operationId): OperationInterface;
  29  }