]> source.dussan.org Git - nextcloud-server.git/commitdiff
Since 27.1.0
authorMarcel Klehr <mklehr@gmx.net>
Fri, 7 Jul 2023 11:46:03 +0000 (13:46 +0200)
committerMarcel Klehr <mklehr@gmx.net>
Wed, 9 Aug 2023 08:02:26 +0000 (10:02 +0200)
Signed-off-by: Marcel Klehr <mklehr@gmx.net>
(cherry picked from commit 069962d04fb51fd52f891297b9096dd7143eaa18)

16 files changed:
lib/public/AppFramework/Bootstrap/IRegistrationContext.php
lib/public/Common/Exception/NotFoundException.php
lib/public/LanguageModel/AbstractLanguageModelTask.php
lib/public/LanguageModel/Events/AbstractLanguageModelEvent.php
lib/public/LanguageModel/Events/TaskFailedEvent.php
lib/public/LanguageModel/Events/TaskSuccessfulEvent.php
lib/public/LanguageModel/FreePromptTask.php
lib/public/LanguageModel/HeadlineTask.php
lib/public/LanguageModel/IHeadlineProvider.php
lib/public/LanguageModel/ILanguageModelManager.php
lib/public/LanguageModel/ILanguageModelProvider.php
lib/public/LanguageModel/ILanguageModelTask.php
lib/public/LanguageModel/ISummaryProvider.php
lib/public/LanguageModel/ITopicsProvider.php
lib/public/LanguageModel/SummaryTask.php
lib/public/LanguageModel/TopicsTask.php

index a4b874b754517dd7ec671833e0b9cfd3e2dfdd34..66435d4593466d20d13d492d0bfcc9ff5a79dd0b 100644 (file)
@@ -226,7 +226,7 @@ interface IRegistrationContext {
         *
         * @param string $providerClass
         * @psalm-param class-string<ILanguageModelProvider> $providerClass
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function registerLanguageModelProvider(string $providerClass): void;
 
index a2cd4db86347bbab8c302d30eb7ad2e110fecf41..a30e1c42b8b5ed93f81f243516a1ec5b4c61448c 100644 (file)
@@ -27,13 +27,13 @@ namespace OCP\Common\Exception;
 /**
  * This is thrown whenever something was expected to exist but doesn't
  *
- * @since 28.0.0
+ * @since 27.1.0
  */
 class NotFoundException extends \Exception {
        /**
         * Constructor
         * @param string $msg the error message
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function __construct(string $msg) {
                parent::__construct($msg);
index 2b92e6f115d1d97faaa492a533f9f1bc796f36ca..91b81b9615b84a6d0689267033b523cb80a841ce 100644 (file)
@@ -46,7 +46,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
         * @param string $appId
         * @param string|null $userId
         * @param string $identifier An arbitrary identifier for this task. max length: 255 chars
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public function __construct(
                protected string $input,
@@ -58,13 +58,13 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
 
        /**
         * @return string
-        * @since 28.0.0
+        * @since 27.1.0
         */
        abstract public function getType(): string;
 
        /**
         * @return string|null
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public function getOutput(): ?string {
                return $this->output;
@@ -72,7 +72,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
 
        /**
         * @param string|null $output
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public function setOutput(?string $output): void {
                $this->output = $output;
@@ -80,7 +80,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
 
        /**
         * @psalm-return ILanguageModelTask::STATUS_*
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public function getStatus(): int {
                return $this->status;
@@ -88,7 +88,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
 
        /**
         * @psalm-param ILanguageModelTask::STATUS_* $status
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public function setStatus(int $status): void {
                $this->status = $status;
@@ -96,7 +96,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
 
        /**
         * @return int|null
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public function getId(): ?int {
                return $this->id;
@@ -104,7 +104,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
 
        /**
         * @param int|null $id
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public function setId(?int $id): void {
                $this->id = $id;
@@ -112,7 +112,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
 
        /**
         * @return string
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public function getInput(): string {
                return $this->input;
@@ -120,7 +120,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
 
        /**
         * @return string
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public function getAppId(): string {
                return $this->appId;
@@ -128,7 +128,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
 
        /**
         * @return string
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public function getIdentifier(): string {
                return $this->identifier;
@@ -136,7 +136,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
 
        /**
         * @return string|null
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public function getUserId(): ?string {
                return $this->userId;
@@ -144,7 +144,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
 
        /**
         * @return array
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function jsonSerialize() {
                return [
@@ -167,7 +167,7 @@ abstract class AbstractLanguageModelTask implements ILanguageModelTask {
         * @param string $identifier
         * @return ILanguageModelTask
         * @throws \InvalidArgumentException
-        * @since 28.0.0
+        * @since 27.1.0
         */
        final public static function factory(string $type, string $input, ?string $userId, string $appId, string $identifier = ''): ILanguageModelTask {
                if (!in_array($type, array_keys(self::TYPES))) {
index 218a448008187866b9dd1aa5378a5923941672d8..c8abc7373ebb036792933bc5923dce5b0cea502e 100644 (file)
@@ -29,11 +29,11 @@ use OCP\EventDispatcher\Event;
 use OCP\LanguageModel\ILanguageModelTask;
 
 /**
- * @since 28.0.0
+ * @since 27.1.0
  */
 abstract class AbstractLanguageModelEvent extends Event {
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function __construct(
                private ILanguageModelTask $task
@@ -43,7 +43,7 @@ abstract class AbstractLanguageModelEvent extends Event {
 
        /**
         * @return ILanguageModelTask
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getTask(): ILanguageModelTask {
                return $this->task;
index 2737e625e0dcdc1cb54a161ef451058d5b6cae30..f42203a6e48de5469b11d891dc0f85facbafb2c3 100644 (file)
@@ -5,13 +5,13 @@ namespace OCP\LanguageModel\Events;
 use OCP\LanguageModel\ILanguageModelTask;
 
 /**
- * @since 28.0.0
+ * @since 27.1.0
  */
 class TaskFailedEvent extends AbstractLanguageModelEvent {
        /**
         * @param ILanguageModelTask $task
         * @param string $errorMessage
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function __construct(
                ILanguageModelTask $task,
@@ -22,7 +22,7 @@ class TaskFailedEvent extends AbstractLanguageModelEvent {
 
        /**
         * @return string
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getErrorMessage(): string {
                return $this->errorMessage;
index ec8a8586a3ec17cd27a8869010e7b750d0617010..77a61ac5c6e0895e28dcf823a6afae73aea76edd 100644 (file)
@@ -5,12 +5,12 @@ namespace OCP\LanguageModel\Events;
 use OCP\LanguageModel\ILanguageModelTask;
 
 /**
- * @since 28.0.0
+ * @since 27.1.0
  */
 class TaskSuccessfulEvent extends AbstractLanguageModelEvent {
        /**
         * @param ILanguageModelTask $task
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function __construct(ILanguageModelTask $task) {
                parent::__construct($task);
index 3de215784ab70fb5a6d77187ca1a41041dac7187..560d6e7d1fbb866521f88895c0917cbf3a37aa5e 100644 (file)
@@ -26,18 +26,18 @@ declare(strict_types=1);
 namespace OCP\LanguageModel;
 
 /**
- * @since 28.0.0
+ * @since 27.1.0
  * @template-extends AbstractLanguageModelTask<ILanguageModelProvider>
  */
 final class FreePromptTask extends AbstractLanguageModelTask {
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public const TYPE = 'free_prompt';
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function visitProvider(ILanguageModelProvider $provider): string {
                return $provider->prompt($this->getInput());
@@ -45,7 +45,7 @@ final class FreePromptTask extends AbstractLanguageModelTask {
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function canUseProvider(ILanguageModelProvider $provider): bool {
                return true;
@@ -53,7 +53,7 @@ final class FreePromptTask extends AbstractLanguageModelTask {
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getType(): string {
                return self::TYPE;
index e66c8893d8301044194fc37944bb75d254f688ee..4c62b9722a992427204ff2db38ab032f0846fa35 100644 (file)
@@ -28,18 +28,18 @@ namespace OCP\LanguageModel;
 /**
  * This LanguageModel Task represents headline generation
  * which generates a headline for the passed text
- * @since 28.0.0
+ * @since 27.1.0
  * @template-extends AbstractLanguageModelTask<IHeadlineProvider>
  */
 final class HeadlineTask extends AbstractLanguageModelTask {
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public const TYPE = 'headline';
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function visitProvider(ILanguageModelProvider $provider): string {
                if (!$this->canUseProvider($provider)) {
@@ -50,7 +50,7 @@ final class HeadlineTask extends AbstractLanguageModelTask {
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function canUseProvider(ILanguageModelProvider $provider): bool {
                return $provider instanceof IHeadlineProvider;
@@ -58,7 +58,7 @@ final class HeadlineTask extends AbstractLanguageModelTask {
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getType(): string {
                return self::TYPE;
index d1fe7504fdfb7d3c02b5f25a4c22f85b0255a931..30185f4d4b3d97845f13c39547084e1558af902d 100644 (file)
@@ -31,13 +31,13 @@ use RuntimeException;
 /**
  * This LanguageModel Provider represents headline generation
  * which generates a headline for the passed text
- * @since 28.0.0
+ * @since 27.1.0
  */
 interface IHeadlineProvider extends ILanguageModelProvider {
        /**
         * @param string $text The text to find headline for
         * @returns string the headline
-        * @since 28.0.0
+        * @since 27.1.0
         * @throws RuntimeException If the text could not be transcribed
         */
        public function findHeadline(string $text): string;
index 32cc4b788bf39c5b409b4e601d52af84d1927109..0afc99b91ab6659c3bad4089aeae60af88c3c76b 100644 (file)
@@ -33,30 +33,30 @@ use RuntimeException;
 /**
  * API surface for apps interacting with and making use of LanguageModel providers
  * without known which providers are installed
- * @since 28.0.0
+ * @since 27.1.0
  */
 interface ILanguageModelManager {
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function hasProviders(): bool;
 
        /**
         * @return string[]
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getAvailableTaskClasses(): array;
 
        /**
         * @return string[]
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getAvailableTaskTypes(): array;
 
        /**
         * @throws PreConditionNotMetException If no or not the requested provider was registered but this method was still called
         * @throws RuntimeException If something else failed
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function runTask(ILanguageModelTask $task): string;
 
@@ -66,7 +66,7 @@ interface ILanguageModelManager {
         * If inference fails a \OCP\LanguageModel\Events\TaskFailedEvent will be dispatched instead
         *
         * @throws PreConditionNotMetException If no or not the requested provider was registered but this method was still called
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function scheduleTask(ILanguageModelTask $task) : void;
 
@@ -75,7 +75,7 @@ interface ILanguageModelManager {
         * @return ILanguageModelTask
         * @throws RuntimeException If the query failed
         * @throws NotFoundException If the task could not be found
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getTask(int $id): ILanguageModelTask;
 }
index b3e76ff4d820adabeb43f6da4b61b53b3f657f09..34e7eb6c4e59d4d0ac2d15df1a82c0834d565d18 100644 (file)
@@ -31,18 +31,18 @@ use RuntimeException;
 /**
  * This is the minimum interface that is implemented by apps that
  * implement a LanguageModel provider
- * @since 28.0.0
+ * @since 27.1.0
  */
 interface ILanguageModelProvider {
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getName(): string;
 
        /**
         * @param string $prompt The prompt to call the model with
         * @return string the output
-        * @since 28.0.0
+        * @since 27.1.0
         * @throws RuntimeException If the text could not be transcribed
         */
        public function prompt(string $prompt): string;
index b8f0f96695d72b9c2b4717d8e9e411cc7601bec7..0f552c8de54d8ab9f965fbf93b71e84715653f52 100644 (file)
@@ -26,33 +26,33 @@ declare(strict_types=1);
 namespace OCP\LanguageModel;
 
 /**
- * @since 28.0.0
+ * @since 27.1.0
  * @template T of ILanguageModelProvider
  */
 interface ILanguageModelTask extends \JsonSerializable {
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public const STATUS_FAILED = 4;
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public const STATUS_SUCCESSFUL = 3;
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public const STATUS_RUNNING = 2;
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public const STATUS_SCHEDULED = 1;
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public const STATUS_UNKNOWN = 0;
 
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public const TYPES = [
                FreePromptTask::TYPE => FreePromptTask::class,
@@ -65,7 +65,7 @@ interface ILanguageModelTask extends \JsonSerializable {
         * @psalm-param T $provider
         * @param ILanguageModelProvider $provider
         * @return string
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function visitProvider(ILanguageModelProvider $provider): string;
 
@@ -73,74 +73,74 @@ interface ILanguageModelTask extends \JsonSerializable {
         * @psalm-param T $provider
         * @param ILanguageModelProvider $provider
         * @return bool
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function canUseProvider(ILanguageModelProvider $provider): bool;
 
 
        /**
         * @return string
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getType(): string;
 
        /**
         * @return ILanguageModelTask::STATUS_*
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getStatus(): int;
 
        /**
         * @param ILanguageModelTask::STATUS_* $status
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function setStatus(int $status): void;
 
        /**
         * @param int|null $id
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function setId(?int $id): void;
 
        /**
         * @return int|null
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getId(): ?int;
 
        /**
         * @return string
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getInput(): string;
 
        /**
         * @param string|null $output
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function setOutput(?string $output): void;
 
        /**
         * @return null|string
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getOutput(): ?string;
 
        /**
         * @return string
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getAppId(): string;
 
        /**
         * @return string
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getIdentifier(): string;
 
        /**
         * @return string|null
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getUserId(): ?string;
 }
index 0b49258964dc51377d1c902d088072553aa849e2..c286e74eb19494144b1bb0283136ff8d2d6513d4 100644 (file)
@@ -31,13 +31,13 @@ use RuntimeException;
 /**
  * This LanguageModel Provider implements summarization
  * which sums up the passed text.
- * @since 28.0.0
+ * @since 27.1.0
  */
 interface ISummaryProvider extends ILanguageModelProvider {
        /**
         * @param string $text The text to summarize
         * @returns string the summary
-        * @since 28.0.0
+        * @since 27.1.0
         * @throws RuntimeException If the text could not be transcribed
         */
        public function summarize(string $text): string;
index a15cfba698fd4ad770929d5eb036e3ce27daa7a0..f061976a3ba431c2318019592ff32b34ed5c4978 100644 (file)
@@ -31,13 +31,13 @@ use RuntimeException;
 /**
  * This LanguageModel Provider implements topics synthesis
  * which outputs comma-separated topics for the passed text
- * @since 28.0.0
+ * @since 27.1.0
  */
 interface ITopicsProvider extends ILanguageModelProvider {
        /**
         * @param string $text The text to find topics for
         * @returns string the topics, comma separated
-        * @since 28.0.0
+        * @since 27.1.0
         * @throws RuntimeException If the text could not be transcribed
         */
        public function findTopics(string $text): string;
index 4504cdff7503cfb58426b3ce44864f9c510a7589..47864532ae309fb259af56663258cf4333adbdc3 100644 (file)
@@ -28,18 +28,18 @@ namespace OCP\LanguageModel;
 /**
  * This is an absctract LanguageModel Task represents summarization
  * which sums up the passed text.
- * @since 28.0.0
+ * @since 27.1.0
  * @template-extends AbstractLanguageModelTask<ISummaryProvider>
  */
 final class SummaryTask extends AbstractLanguageModelTask {
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public const TYPE = 'summarize';
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function visitProvider(ILanguageModelProvider $provider): string {
                if (!$this->canUseProvider($provider)) {
@@ -50,7 +50,7 @@ final class SummaryTask extends AbstractLanguageModelTask {
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function canUseProvider(ILanguageModelProvider $provider): bool {
                return $provider instanceof ISummaryProvider;
@@ -58,7 +58,7 @@ final class SummaryTask extends AbstractLanguageModelTask {
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getType(): string {
                return self::TYPE;
index ccf5d512a8a97e908ae909f68d334f159130a9dc..ab2c5916061c399c78d90982cb2dacaf5507d805 100644 (file)
@@ -28,18 +28,18 @@ namespace OCP\LanguageModel;
 /**
  * This LanguageModel Task represents topics synthesis
  * which outputs comma-separated topics for the passed text
- * @since 28.0.0
+ * @since 27.1.0
  * @template-extends AbstractLanguageModelTask<ITopicsProvider>
  */
 final class TopicsTask extends AbstractLanguageModelTask {
        /**
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public const TYPE = 'topics';
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function visitProvider(ILanguageModelProvider $provider): string {
                if (!$this->canUseProvider($provider)) {
@@ -50,7 +50,7 @@ final class TopicsTask extends AbstractLanguageModelTask {
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function canUseProvider(ILanguageModelProvider $provider): bool {
                return $provider instanceof ITopicsProvider;
@@ -58,7 +58,7 @@ final class TopicsTask extends AbstractLanguageModelTask {
 
        /**
         * @inheritDoc
-        * @since 28.0.0
+        * @since 27.1.0
         */
        public function getType(): string {
                return self::TYPE;