fix(TextProcessing): Add task type template param to IManager and registerTextProcessingProvider

otherwise we cannot use them reasonably

Signed-off-by: Marcel Klehr <mklehr@gmx.net>

Author: marcelklehr

lib/public/AppFramework/Bootstrap/IRegistrationContext.php

@@ -38,6 +38,7 @@
 use OCP\Files\Template\ICustomTemplateProvider;
 use OCP\IContainer;
 use OCP\TextProcessing\IProvider as ITextProcessingProvider;
+use OCP\TextProcessing\ITaskType;
 use OCP\TextToImage\IProvider as ITextToImageProvider;
 use OCP\Notification\INotifier;
 use OCP\Preview\IProviderV2;
@@ -226,7 +227,8 @@ public function registerSpeechToTextProvider(string $providerClass): void;
 	 * through the OCP\TextProcessing APIs
 	 *
 	 * @param string $providerClass
-	 * @psalm-param class-string<ITextProcessingProvider> $providerClass
+	 * @psalm-template T of ITaskType
+	 * @psalm-param class-string<ITextProcessingProvider<T>> $providerClass
 	 * @since 27.1.0
 	 */
 	public function registerTextProcessingProvider(string $providerClass): void;

lib/public/TextProcessing/IManager.php

@@ -56,7 +56,8 @@ public function getProviders(): array;
 	public function getAvailableTaskTypes(): array;
 
 	/**
-	 * @param Task $task The task to run
+	 * @psalm-template T of ITaskType
+	 * @param Task<T> $task The task to run
 	 * @throws PreConditionNotMetException If no or not the requested provider was registered but this method was still called
 	 * @throws TaskFailureException If running the task failed
 	 * @since 27.1.0
@@ -68,7 +69,8 @@ public function runTask(Task $task): string;
 	 * with the \OCP\LanguageModel\Events\TaskSuccessfulEvent
 	 * If inference fails a \OCP\LanguageModel\Events\TaskFailedEvent will be dispatched instead
 	 *
-	 * @param Task $task The task to schedule
+	 * @psalm-template T of ITaskType
+	 * @param Task<T> $task The task to schedule
 	 * @throws PreConditionNotMetException If no or not the requested provider was registered but this method was still called
 	 * @throws Exception storing the task in the database failed
 	 * @since 27.1.0
@@ -80,7 +82,8 @@ public function scheduleTask(Task $task) : void;
 	 * max execution time of this php process and run it synchronously if it does, if it doesn't fit (or the provider doesn't provide that information)
 	 * execution is deferred to a background job
 	 *
-	 * @param Task $task The task to schedule
+	 * @psalm-template T of ITaskType
+	 * @param Task<T> $task The task to schedule
 	 * @returns bool A boolean indicating whether the task was run synchronously (`true`) or offloaded to a background job (`false`)
 	 * @throws PreConditionNotMetException If no or not the requested provider was registered but this method was still called
 	 * @throws TaskFailureException If running the task failed
@@ -92,7 +95,8 @@ public function runOrScheduleTask(Task $task): bool;
 	/**
 	 * Delete a task that has been scheduled before
 	 *
-	 * @param Task $task The task to delete
+	 * @psalm-template T of ITaskType
+	 * @param Task<T> $task The task to delete
 	 * @since 27.1.0
 	 */
 	public function deleteTask(Task $task): void;