chore: deprecate old AI APIs

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

lib/public/SpeechToText/Events/AbstractTranscriptionEvent.php

@@ -13,6 +13,7 @@ use OCP\Files\File;
 
 /**
  * @since 27.0.0
+ * @deprecated 30.0.0
  */
 abstract class AbstractTranscriptionEvent extends Event {
 	/**

lib/public/SpeechToText/Events/TranscriptionFailedEvent.php

@@ -15,6 +15,7 @@ use OCP\Files\File;
 /**
  * This Event is emitted if a transcription of a media file using a Speech-To-Text provider failed
  * @since 27.0.0
+ * @deprecated 30.0.0
  */
 class TranscriptionFailedEvent extends AbstractTranscriptionEvent {
 	/**

lib/public/SpeechToText/Events/TranscriptionSuccessfulEvent.php

@@ -15,6 +15,7 @@ use OCP\Files\File;
 /**
  * This Event is emitted when a transcription of a media file happened successfully
  * @since 27.0.0
+ * @deprecated 30.0.0
  */
 class TranscriptionSuccessfulEvent extends AbstractTranscriptionEvent {
 	/**

lib/public/SpeechToText/ISpeechToTextManager.php

@@ -17,6 +17,7 @@ use RuntimeException;
 
 /**
  * @since 27.0.0
+ * @deprecated 30.0.0
  */
 interface ISpeechToTextManager {
 	/**

lib/public/SpeechToText/ISpeechToTextProvider.php

@@ -15,6 +15,7 @@ use RuntimeException;
 
 /**
  * @since 27.0.0
+ * @deprecated 30.0.0
  */
 interface ISpeechToTextProvider {
 	/**

lib/public/SpeechToText/ISpeechToTextProviderWithId.php

@@ -8,6 +8,7 @@ namespace OCP\SpeechToText;
 
 /**
  * @since 28.0.0
+ * @deprecated 30.0.0
  */
 interface ISpeechToTextProviderWithId extends ISpeechToTextProvider {
 

lib/public/SpeechToText/ISpeechToTextProviderWithUserId.php

@@ -12,6 +12,7 @@ namespace OCP\SpeechToText;
 
 /**
  * @since 29.0.0
+ * @deprecated 30.0.0
  */
 interface ISpeechToTextProviderWithUserId extends ISpeechToTextProvider {
 	/**

lib/public/TextProcessing/Events/AbstractTextProcessingEvent.php

@@ -13,6 +13,7 @@ use OCP\TextProcessing\Task;
 
 /**
  * @since 27.1.0
+ * @deprecated 30.0.0
  */
 abstract class AbstractTextProcessingEvent extends Event {
 	/**

lib/public/TextProcessing/Events/TaskFailedEvent.php

@@ -10,6 +10,7 @@ use OCP\TextProcessing\Task;
 
 /**
  * @since 27.1.0
+ * @deprecated 30.0.0
  */
 class TaskFailedEvent extends AbstractTextProcessingEvent {
 	/**

lib/public/TextProcessing/Events/TaskSuccessfulEvent.php

@@ -8,6 +8,7 @@ namespace OCP\TextProcessing\Events;
 
 /**
  * @since 27.1.0
+ * @deprecated 30.0.0
  */
 class TaskSuccessfulEvent extends AbstractTextProcessingEvent {
 }

lib/public/TextProcessing/Exception/TaskFailureException.php

@@ -9,6 +9,7 @@ namespace OCP\TextProcessing\Exception;
 /**
  * Exception thrown when a task failed
  * @since 28.0.0
+ * @deprecated 30.0.0
  */
 class TaskFailureException extends \RuntimeException {
 }

lib/public/TextProcessing/FreePromptTaskType.php

@@ -15,6 +15,7 @@ use OCP\L10N\IFactory;
 /**
  * This is the text processing task type for free prompting
  * @since 27.1.0
+ * @deprecated 30.0.0
  */
 class FreePromptTaskType implements ITaskType {
 	private IL10N $l;

lib/public/TextProcessing/HeadlineTaskType.php

@@ -15,6 +15,7 @@ use OCP\L10N\IFactory;
 /**
  * This is the text processing task type for creating headline
  * @since 27.1.0
+ * @deprecated 30.0.0
  */
 class HeadlineTaskType implements ITaskType {
 	private IL10N $l;

lib/public/TextProcessing/IManager.php

@@ -20,6 +20,7 @@ use RuntimeException;
  * API surface for apps interacting with and making use of LanguageModel providers
  * without known which providers are installed
  * @since 27.1.0
+ * @deprecated 30.0.0
  */
 interface IManager {
 	/**

lib/public/TextProcessing/IProvider.php

@@ -17,6 +17,7 @@ use RuntimeException;
  * implement a text processing provider
  * @psalm-template-covariant  T of ITaskType
  * @since 27.1.0
+ * @deprecated 30.0.0
  */
 interface IProvider {
 	/**

lib/public/TextProcessing/IProviderWithExpectedRuntime.php

@@ -15,6 +15,7 @@ namespace OCP\TextProcessing;
  * @since 28.0.0
  * @template T of ITaskType
  * @template-extends IProvider<T>
+ * @deprecated 30.0.0
  */
 interface IProviderWithExpectedRuntime extends IProvider {
 	/**

lib/public/TextProcessing/IProviderWithId.php

@@ -13,6 +13,7 @@ namespace OCP\TextProcessing;
  * @since 28.0.0
  * @extends IProvider<T>
  * @template T of ITaskType
+ * @deprecated 30.0.0
  */
 interface IProviderWithId extends IProvider {
 	/**

lib/public/TextProcessing/IProviderWithUserId.php

@@ -15,6 +15,7 @@ namespace OCP\TextProcessing;
  * @since 28.0.0
  * @template T of ITaskType
  * @template-extends IProvider<T>
+ * @deprecated 30.0.0
  */
 interface IProviderWithUserId extends IProvider {
 	/**

lib/public/TextProcessing/ITaskType.php

@@ -13,6 +13,7 @@ namespace OCP\TextProcessing;
  * This is a task type interface that is implemented by text processing
  * task types
  * @since 27.1.0
+ * @deprecated 30.0.0
  */
 interface ITaskType {
 	/**

lib/public/TextProcessing/SummaryTaskType.php

@@ -15,6 +15,7 @@ use OCP\L10N\IFactory;
 /**
  * This is the text processing task type for summaries
  * @since 27.1.0
+ * @deprecated 30.0.0
  */
 class SummaryTaskType implements ITaskType {
 	private IL10N $l;

lib/public/TextProcessing/Task.php

@@ -13,6 +13,7 @@ namespace OCP\TextProcessing;
  * This is a text processing task
  * @since 27.1.0
  * @psalm-template-covariant T of ITaskType
+ * @deprecated 30.0.0
  */
 final class Task implements \JsonSerializable {
 	protected ?int $id = null;

lib/public/TextProcessing/TopicsTaskType.php

@@ -15,6 +15,7 @@ use OCP\L10N\IFactory;
 /**
  * This is the text processing task type for topics extraction
  * @since 27.1.0
+ * @deprecated 30.0.0
  */
 class TopicsTaskType implements ITaskType {
 	private IL10N $l;

lib/public/TextToImage/Events/AbstractTextToImageEvent.php

@@ -14,6 +14,7 @@ use OCP\TextToImage\Task;
 
 /**
  * @since 28.0.0
+ * @deprecated 30.0.0
  */
 abstract class AbstractTextToImageEvent extends Event {
 	/**

lib/public/TextToImage/Events/TaskFailedEvent.php

@@ -13,6 +13,7 @@ use OCP\TextToImage\Task;
 
 /**
  * @since 28.0.0
+ * @deprecated 30.0.0
  */
 class TaskFailedEvent extends AbstractTextToImageEvent {
 	/**

lib/public/TextToImage/Events/TaskSuccessfulEvent.php

@@ -11,6 +11,7 @@ namespace OCP\TextToImage\Events;
 
 /**
  * @since 28.0.0
+ * @deprecated 30.0.0
  */
 class TaskSuccessfulEvent extends AbstractTextToImageEvent {
 }

lib/public/TextToImage/Exception/TaskFailureException.php

@@ -9,6 +9,7 @@ namespace OCP\TextToImage\Exception;
 
 /**
  * @since 28.0.0
+ * @deprecated 30.0.0
  */
 class TaskFailureException extends TextToImageException {
 }

lib/public/TextToImage/Exception/TaskNotFoundException.php

@@ -9,6 +9,7 @@ namespace OCP\TextToImage\Exception;
 
 /**
  * @since 28.0.0
+ * @deprecated 30.0.0
  */
 class TaskNotFoundException extends TextToImageException {
 }

lib/public/TextToImage/Exception/TextToImageException.php

@@ -9,6 +9,7 @@ namespace OCP\TextToImage\Exception;
 
 /**
  * @since 28.0.0
+ * @deprecated 30.0.0
  */
 class TextToImageException extends \Exception {
 }

lib/public/TextToImage/IManager.php

@@ -20,6 +20,7 @@ use RuntimeException;
  * API surface for apps interacting with and making use of TextToImage providers
  * without knowing which providers are installed
  * @since 28.0.0
+ * @deprecated 30.0.0
  */
 interface IManager {
 	/**

lib/public/TextToImage/IProvider.php

@@ -15,6 +15,7 @@ use RuntimeException;
  * This is the interface that is implemented by apps that
  * implement a text to image provider
  * @since 28.0.0
+ * @deprecated 30.0.0
  */
 interface IProvider {
 	/**

lib/public/TextToImage/IProviderWithUserId.php

@@ -9,6 +9,7 @@ namespace OCP\TextToImage;
 
 /**
  * @since 29.0.0
+ * @deprecated 30.0.0
  */
 interface IProviderWithUserId extends IProvider {
 	/**

lib/public/TextToImage/Task.php

@@ -20,6 +20,7 @@ use OCP\Image;
  * This is a text to image task
  *
  * @since 28.0.0
+ * @deprecated 30.0.0
  */
 final class Task implements \JsonSerializable {
 	protected ?int $id = null;

lib/public/Translation/CouldNotTranslateException.php

@@ -11,6 +11,7 @@ namespace OCP\Translation;
 
 /**
  * @since 27.0.0
+ * @deprecated 30.0.0
  */
 class CouldNotTranslateException extends \RuntimeException {
 	/**

lib/public/Translation/IDetectLanguageProvider.php

@@ -12,6 +12,7 @@ namespace OCP\Translation;
 
 /**
  * @since 26.0.0
+ * @deprecated 30.0.0
  */
 interface IDetectLanguageProvider {
 	/**

lib/public/Translation/ITranslationManager.php

@@ -15,6 +15,7 @@ use OCP\PreConditionNotMetException;
 
 /**
  * @since 26.0.0
+ * @deprecated 30.0.0
  */
 interface ITranslationManager {
 	/**

lib/public/Translation/ITranslationProvider.php

@@ -14,6 +14,7 @@ use RuntimeException;
 
 /**
  * @since 26.0.0
+ * @deprecated 30.0.0
  */
 interface ITranslationProvider {
 	/**

lib/public/Translation/ITranslationProviderWithId.php

@@ -12,6 +12,7 @@ namespace OCP\Translation;
 
 /**
  * @since 29.0.0
+ * @deprecated 30.0.0
  */
 interface ITranslationProviderWithId extends ITranslationProvider {
 	/**

lib/public/Translation/ITranslationProviderWithUserId.php

@@ -12,6 +12,7 @@ namespace OCP\Translation;
 
 /**
  * @since 29.0.0
+ * @deprecated 30.0.0
  */
 interface ITranslationProviderWithUserId extends ITranslationProvider {
 	/**

lib/public/Translation/LanguageTuple.php

@@ -14,6 +14,7 @@ use JsonSerializable;
 
 /**
  * @since 26.0.0
+ * @deprecated 30.0.0
  */
 class LanguageTuple implements JsonSerializable {
 	/**