chore(openapi): add AI analysis endpoints and scopes (#2054)

Adds the AI analysis endpoints of #2044 to the OpenAPI document and the
clients, so a provisioner can start and read an analysis Task with
generated code.

- `AccessScope` in `Devolutions.Gateway.Utils` and in both clients gains
`gateway.tasks.recording-ai-analysis.start` and
`gateway.tasks.recording-ai-analysis.read`.
- `gateway-api.yaml`, `doc/index.adoc`, the .NET client and the TS
Angular client gain `PUT` and `GET
/jet/tasks/recording-ai-analysis/{task_id}` (in `TasksApi` /
`TasksService`) and their models: the request (`AiAnalysisRequest`,
`AiProvider`), the Task (`AiAnalysisTask`, `TaskState`,
`AiAnalysisParams`), its running, succeeded and failed payloads
(`AiAnalysisPayload`), why a Task failed (`AiAnalysisError`,
`AiAnalysisErrorKind`, `AiAnalysisBadAnswer`,
`AiAnalysisRecoverableError`, `AiAnalysisRecoverableErrorKind`), the
tokens it used (`AiAnalysisUsage`) and the 409 body
(`AiAnalysisConflict`, `AiAnalysisConflictCode`).
- The .NET models print `[redacted]` for a `password` field in
`ToString()`, so logging an `AiAnalysisRequest` doesn't show the API
key. The template is a copy of the openapi-generator 7.9.0
`modelGeneric.mustache` with that one line changed.

The generated files come from `tools/generate-openapi` and
openapi-generator 7.9.0, trimmed to the AI analysis parts: the generator
also bumps the spec version and lists more `pullRecordingFile` content
types in the clients and docs, which master never regenerated.

Issue: DGW-462

---------

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Author: irvingoujAtDevolution

devolutions-gateway/openapi/doc/index.adoc

@@ -9,6 +9,22 @@ docs/AgentApi.md
 docs/AgentDomainAdvertisement.md
 docs/AgentInfo.md
 docs/AgentStatus.md
+docs/AiAnalysisBadAnswer.md
+docs/AiAnalysisConflict.md
+docs/AiAnalysisConflictCode.md
+docs/AiAnalysisError.md
+docs/AiAnalysisErrorKind.md
+docs/AiAnalysisFailedPayload.md
+docs/AiAnalysisParams.md
+docs/AiAnalysisPayload.md
+docs/AiAnalysisRecoverableError.md
+docs/AiAnalysisRecoverableErrorKind.md
+docs/AiAnalysisRequest.md
+docs/AiAnalysisRunningPayload.md
+docs/AiAnalysisSucceededPayload.md
+docs/AiAnalysisTask.md
+docs/AiAnalysisUsage.md
+docs/AiProvider.md
 docs/AppCredential.md
 docs/AppCredentialKind.md
 docs/AppTokenContentType.md
@@ -75,6 +91,8 @@ docs/StartTimeRange.md
 docs/SubProvisionerKey.md
 docs/Subscriber.md
 docs/TargetConnectionOptions.md
+docs/TaskState.md
+docs/TasksApi.md
 docs/TrafficApi.md
 docs/TrafficEventResponse.md
 docs/TransportProtocolResponse.md
@@ -93,6 +111,7 @@ src/Devolutions.Gateway.Client/Api/NetApi.cs
 src/Devolutions.Gateway.Client/Api/NetworkMonitoringApi.cs
 src/Devolutions.Gateway.Client/Api/PreflightApi.cs
 src/Devolutions.Gateway.Client/Api/SessionsApi.cs
+src/Devolutions.Gateway.Client/Api/TasksApi.cs
 src/Devolutions.Gateway.Client/Api/TrafficApi.cs
 src/Devolutions.Gateway.Client/Api/UpdateApi.cs
 src/Devolutions.Gateway.Client/Api/WebAppApi.cs
@@ -122,6 +141,22 @@ src/Devolutions.Gateway.Client/Model/AddressFamily.cs
 src/Devolutions.Gateway.Client/Model/AgentDomainAdvertisement.cs
 src/Devolutions.Gateway.Client/Model/AgentInfo.cs
 src/Devolutions.Gateway.Client/Model/AgentStatus.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisBadAnswer.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisConflict.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisConflictCode.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisError.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisErrorKind.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisFailedPayload.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisParams.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisPayload.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisRecoverableError.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisRecoverableErrorKind.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisRequest.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisRunningPayload.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisSucceededPayload.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisTask.cs
+src/Devolutions.Gateway.Client/Model/AiAnalysisUsage.cs
+src/Devolutions.Gateway.Client/Model/AiProvider.cs
 src/Devolutions.Gateway.Client/Model/AppCredential.cs
 src/Devolutions.Gateway.Client/Model/AppCredentialKind.cs
 src/Devolutions.Gateway.Client/Model/AppTokenContentType.cs
@@ -178,6 +213,7 @@ src/Devolutions.Gateway.Client/Model/StartTimeRange.cs
 src/Devolutions.Gateway.Client/Model/SubProvisionerKey.cs
 src/Devolutions.Gateway.Client/Model/Subscriber.cs
 src/Devolutions.Gateway.Client/Model/TargetConnectionOptions.cs
+src/Devolutions.Gateway.Client/Model/TaskState.cs
 src/Devolutions.Gateway.Client/Model/TrafficEventResponse.cs
 src/Devolutions.Gateway.Client/Model/TransportProtocolResponse.cs
 src/Devolutions.Gateway.Client/Model/UpdateProductInfo.cs

devolutions-gateway/openapi/dotnet-client/.openapi-generator/FILES

@@ -167,6 +167,8 @@ Class | Method | HTTP request | Description
 *PreflightApi* | [**PostPreflight**](docs/PreflightApi.md#postpreflight) | **POST** /jet/preflight | Performs a batch of preflight operations
 *SessionsApi* | [**GetSessions**](docs/SessionsApi.md#getsessions) | **GET** /jet/sessions | Lists running sessions
 *SessionsApi* | [**TerminateSession**](docs/SessionsApi.md#terminatesession) | **POST** /jet/session/{id}/terminate | Terminate forcefully a running session
+*TasksApi* | [**GetAiAnalysis**](docs/TasksApi.md#getaianalysis) | **GET** /jet/tasks/recording-ai-analysis/{task_id} | Gets an AI analysis of a recorded session
+*TasksApi* | [**StartAiAnalysis**](docs/TasksApi.md#startaianalysis) | **PUT** /jet/tasks/recording-ai-analysis/{task_id} | Starts an AI analysis of a recorded session
 *TrafficApi* | [**AckTrafficEvents**](docs/TrafficApi.md#acktrafficevents) | **POST** /jet/traffic/ack | Acknowledge traffic audit events and remove them from the queue
 *TrafficApi* | [**ClaimTrafficEvents**](docs/TrafficApi.md#claimtrafficevents) | **POST** /jet/traffic/claim | Claim traffic audit events for processing
 *UpdateApi* | [**GetUpdateProducts**](docs/UpdateApi.md#getupdateproducts) | **GET** /jet/update | Retrieve the currently installed version of each Devolutions product.
@@ -187,6 +189,22 @@ Class | Method | HTTP request | Description
  - [Model.AgentDomainAdvertisement](docs/AgentDomainAdvertisement.md)
  - [Model.AgentInfo](docs/AgentInfo.md)
  - [Model.AgentStatus](docs/AgentStatus.md)
+ - [Model.AiAnalysisBadAnswer](docs/AiAnalysisBadAnswer.md)
+ - [Model.AiAnalysisConflict](docs/AiAnalysisConflict.md)
+ - [Model.AiAnalysisConflictCode](docs/AiAnalysisConflictCode.md)
+ - [Model.AiAnalysisError](docs/AiAnalysisError.md)
+ - [Model.AiAnalysisErrorKind](docs/AiAnalysisErrorKind.md)
+ - [Model.AiAnalysisFailedPayload](docs/AiAnalysisFailedPayload.md)
+ - [Model.AiAnalysisParams](docs/AiAnalysisParams.md)
+ - [Model.AiAnalysisPayload](docs/AiAnalysisPayload.md)
+ - [Model.AiAnalysisRecoverableError](docs/AiAnalysisRecoverableError.md)
+ - [Model.AiAnalysisRecoverableErrorKind](docs/AiAnalysisRecoverableErrorKind.md)
+ - [Model.AiAnalysisRequest](docs/AiAnalysisRequest.md)
+ - [Model.AiAnalysisRunningPayload](docs/AiAnalysisRunningPayload.md)
+ - [Model.AiAnalysisSucceededPayload](docs/AiAnalysisSucceededPayload.md)
+ - [Model.AiAnalysisTask](docs/AiAnalysisTask.md)
+ - [Model.AiAnalysisUsage](docs/AiAnalysisUsage.md)
+ - [Model.AiProvider](docs/AiProvider.md)
  - [Model.AppCredential](docs/AppCredential.md)
  - [Model.AppCredentialKind](docs/AppCredentialKind.md)
  - [Model.AppTokenContentType](docs/AppTokenContentType.md)
@@ -243,6 +261,7 @@ Class | Method | HTTP request | Description
  - [Model.SubProvisionerKey](docs/SubProvisionerKey.md)
  - [Model.Subscriber](docs/Subscriber.md)
  - [Model.TargetConnectionOptions](docs/TargetConnectionOptions.md)
+ - [Model.TaskState](docs/TaskState.md)
  - [Model.TrafficEventResponse](docs/TrafficEventResponse.md)
  - [Model.TransportProtocolResponse](docs/TransportProtocolResponse.md)
  - [Model.UpdateProductInfo](docs/UpdateProductInfo.md)