@knowledge-stack/ksapi 1.82.0 → 1.84.0

package/src/apis/WorkflowRunsApi.ts

@@ -16,6 +16,9 @@
 import * as runtime from '../runtime';
 import type {
   HTTPValidationError,
+  PathPartApprovalResponse,
+  RejectFileRequest,
+  RunLockResponse,
   WorkflowCallbackResponse,
   WorkflowRunCallbackRequest,
   WorkflowRunResponse,
@@ -23,6 +26,12 @@ import type {
 import {
     HTTPValidationErrorFromJSON,
     HTTPValidationErrorToJSON,
+    PathPartApprovalResponseFromJSON,
+    PathPartApprovalResponseToJSON,
+    RejectFileRequestFromJSON,
+    RejectFileRequestToJSON,
+    RunLockResponseFromJSON,
+    RunLockResponseToJSON,
     WorkflowCallbackResponseFromJSON,
     WorkflowCallbackResponseToJSON,
     WorkflowRunCallbackRequestFromJSON,
@@ -31,6 +40,19 @@ import {
     WorkflowRunResponseToJSON,
 } from '../models/index';
 
+export interface AcquireWorkflowRunLockRequest {
+    runId: string;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
+export interface ApproveWorkflowRunFileRequest {
+    runId: string;
+    pathPartId: string;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
 export interface DeleteWorkflowRunRequest {
     runId: string;
     authorization?: string | null;
@@ -43,6 +65,27 @@ export interface GetWorkflowRunRequest {
     ksUat?: string | null;
 }
 
+export interface RejectWorkflowRunFileRequest {
+    runId: string;
+    pathPartId: string;
+    rejectFileRequest: RejectFileRequest;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
+export interface ReleaseWorkflowRunLockRequest {
+    runId: string;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
+export interface UnapproveWorkflowRunFileRequest {
+    runId: string;
+    pathPartId: string;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
 export interface WorkflowRunCallbackOperationRequest {
     runId: string;
     workflowRunCallbackRequest: WorkflowRunCallbackRequest;
@@ -55,6 +98,64 @@ export interface WorkflowRunCallbackOperationRequest {
  * @interface WorkflowRunsApiInterface
  */
 export interface WorkflowRunsApiInterface {
+    /**
+     * Creates request options for acquireWorkflowRunLock without sending the request
+     * @param {string} runId 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    acquireWorkflowRunLockRequestOpts(requestParameters: AcquireWorkflowRunLockRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Acquire (or renew) the reviewer lock on ``run_id``.  The current holder may re-POST to refresh ``lock_acquired_at``. A different user receives 409 until the lock is released or auto-swept.
+     * @summary Acquire Workflow Run Lock Handler
+     * @param {string} runId 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    acquireWorkflowRunLockRaw(requestParameters: AcquireWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RunLockResponse>>;
+
+    /**
+     * Acquire (or renew) the reviewer lock on ``run_id``.  The current holder may re-POST to refresh ``lock_acquired_at``. A different user receives 409 until the lock is released or auto-swept.
+     * Acquire Workflow Run Lock Handler
+     */
+    acquireWorkflowRunLock(requestParameters: AcquireWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RunLockResponse>;
+
+    /**
+     * Creates request options for approveWorkflowRunFile without sending the request
+     * @param {string} runId 
+     * @param {string} pathPartId 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    approveWorkflowRunFileRequestOpts(requestParameters: ApproveWorkflowRunFileRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Approve a single generated file. Caller must hold the run lock.
+     * @summary Approve Workflow Run File Handler
+     * @param {string} runId 
+     * @param {string} pathPartId 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    approveWorkflowRunFileRaw(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>>;
+
+    /**
+     * Approve a single generated file. Caller must hold the run lock.
+     * Approve Workflow Run File Handler
+     */
+    approveWorkflowRunFile(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse>;
+
     /**
      * Creates request options for deleteWorkflowRun without sending the request
      * @param {string} runId 
@@ -109,6 +210,96 @@ export interface WorkflowRunsApiInterface {
      */
     getWorkflowRun(requestParameters: GetWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
 
+    /**
+     * Creates request options for rejectWorkflowRunFile without sending the request
+     * @param {string} runId 
+     * @param {string} pathPartId 
+     * @param {RejectFileRequest} rejectFileRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    rejectWorkflowRunFileRequestOpts(requestParameters: RejectWorkflowRunFileRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Reject a single generated file with a reason. Caller must hold the run lock.
+     * @summary Reject Workflow Run File Handler
+     * @param {string} runId 
+     * @param {string} pathPartId 
+     * @param {RejectFileRequest} rejectFileRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    rejectWorkflowRunFileRaw(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>>;
+
+    /**
+     * Reject a single generated file with a reason. Caller must hold the run lock.
+     * Reject Workflow Run File Handler
+     */
+    rejectWorkflowRunFile(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse>;
+
+    /**
+     * Creates request options for releaseWorkflowRunLock without sending the request
+     * @param {string} runId 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    releaseWorkflowRunLockRequestOpts(requestParameters: ReleaseWorkflowRunLockRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Release the reviewer lock; only the holder may call this.  DELETE /lock is idempotent: returns 204 even if no lock is held.
+     * @summary Release Workflow Run Lock Handler
+     * @param {string} runId 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    releaseWorkflowRunLockRaw(requestParameters: ReleaseWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+
+    /**
+     * Release the reviewer lock; only the holder may call this.  DELETE /lock is idempotent: returns 204 even if no lock is held.
+     * Release Workflow Run Lock Handler
+     */
+    releaseWorkflowRunLock(requestParameters: ReleaseWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+
+    /**
+     * Creates request options for unapproveWorkflowRunFile without sending the request
+     * @param {string} runId 
+     * @param {string} pathPartId 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    unapproveWorkflowRunFileRequestOpts(requestParameters: UnapproveWorkflowRunFileRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Revert an approved file to ``pending``.  Does NOT require the reviewer lock — anyone with ``can_write`` on the run path may unapprove (pilot plan §11.7).
+     * @summary Unapprove Workflow Run File Handler
+     * @param {string} runId 
+     * @param {string} pathPartId 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRunsApiInterface
+     */
+    unapproveWorkflowRunFileRaw(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>>;
+
+    /**
+     * Revert an approved file to ``pending``.  Does NOT require the reviewer lock — anyone with ``can_write`` on the run path may unapprove (pilot plan §11.7).
+     * Unapprove Workflow Run File Handler
+     */
+    unapproveWorkflowRunFile(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse>;
+
     /**
      * Creates request options for workflowRunCallback without sending the request
      * @param {string} runId 
@@ -141,6 +332,116 @@ export interface WorkflowRunsApiInterface {
  */
 export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiInterface {
 
+    /**
+     * Creates request options for acquireWorkflowRunLock without sending the request
+     */
+    async acquireWorkflowRunLockRequestOpts(requestParameters: AcquireWorkflowRunLockRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['runId'] == null) {
+            throw new runtime.RequiredError(
+                'runId',
+                'Required parameter "runId" was null or undefined when calling acquireWorkflowRunLock().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/workflow-runs/{run_id}/lock`;
+        urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Acquire (or renew) the reviewer lock on ``run_id``.  The current holder may re-POST to refresh ``lock_acquired_at``. A different user receives 409 until the lock is released or auto-swept.
+     * Acquire Workflow Run Lock Handler
+     */
+    async acquireWorkflowRunLockRaw(requestParameters: AcquireWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RunLockResponse>> {
+        const requestOptions = await this.acquireWorkflowRunLockRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => RunLockResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Acquire (or renew) the reviewer lock on ``run_id``.  The current holder may re-POST to refresh ``lock_acquired_at``. A different user receives 409 until the lock is released or auto-swept.
+     * Acquire Workflow Run Lock Handler
+     */
+    async acquireWorkflowRunLock(requestParameters: AcquireWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RunLockResponse> {
+        const response = await this.acquireWorkflowRunLockRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for approveWorkflowRunFile without sending the request
+     */
+    async approveWorkflowRunFileRequestOpts(requestParameters: ApproveWorkflowRunFileRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['runId'] == null) {
+            throw new runtime.RequiredError(
+                'runId',
+                'Required parameter "runId" was null or undefined when calling approveWorkflowRunFile().'
+            );
+        }
+
+        if (requestParameters['pathPartId'] == null) {
+            throw new runtime.RequiredError(
+                'pathPartId',
+                'Required parameter "pathPartId" was null or undefined when calling approveWorkflowRunFile().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/workflow-runs/{run_id}/files/{path_part_id}/approve`;
+        urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Approve a single generated file. Caller must hold the run lock.
+     * Approve Workflow Run File Handler
+     */
+    async approveWorkflowRunFileRaw(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>> {
+        const requestOptions = await this.approveWorkflowRunFileRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PathPartApprovalResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Approve a single generated file. Caller must hold the run lock.
+     * Approve Workflow Run File Handler
+     */
+    async approveWorkflowRunFile(requestParameters: ApproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse> {
+        const response = await this.approveWorkflowRunFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for deleteWorkflowRun without sending the request
      */
@@ -238,6 +539,184 @@ export class WorkflowRunsApi extends runtime.BaseAPI implements WorkflowRunsApiI
         return await response.value();
     }
 
+    /**
+     * Creates request options for rejectWorkflowRunFile without sending the request
+     */
+    async rejectWorkflowRunFileRequestOpts(requestParameters: RejectWorkflowRunFileRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['runId'] == null) {
+            throw new runtime.RequiredError(
+                'runId',
+                'Required parameter "runId" was null or undefined when calling rejectWorkflowRunFile().'
+            );
+        }
+
+        if (requestParameters['pathPartId'] == null) {
+            throw new runtime.RequiredError(
+                'pathPartId',
+                'Required parameter "pathPartId" was null or undefined when calling rejectWorkflowRunFile().'
+            );
+        }
+
+        if (requestParameters['rejectFileRequest'] == null) {
+            throw new runtime.RequiredError(
+                'rejectFileRequest',
+                'Required parameter "rejectFileRequest" was null or undefined when calling rejectWorkflowRunFile().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/workflow-runs/{run_id}/files/{path_part_id}/reject`;
+        urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: RejectFileRequestToJSON(requestParameters['rejectFileRequest']),
+        };
+    }
+
+    /**
+     * Reject a single generated file with a reason. Caller must hold the run lock.
+     * Reject Workflow Run File Handler
+     */
+    async rejectWorkflowRunFileRaw(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>> {
+        const requestOptions = await this.rejectWorkflowRunFileRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PathPartApprovalResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Reject a single generated file with a reason. Caller must hold the run lock.
+     * Reject Workflow Run File Handler
+     */
+    async rejectWorkflowRunFile(requestParameters: RejectWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse> {
+        const response = await this.rejectWorkflowRunFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for releaseWorkflowRunLock without sending the request
+     */
+    async releaseWorkflowRunLockRequestOpts(requestParameters: ReleaseWorkflowRunLockRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['runId'] == null) {
+            throw new runtime.RequiredError(
+                'runId',
+                'Required parameter "runId" was null or undefined when calling releaseWorkflowRunLock().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/workflow-runs/{run_id}/lock`;
+        urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Release the reviewer lock; only the holder may call this.  DELETE /lock is idempotent: returns 204 even if no lock is held.
+     * Release Workflow Run Lock Handler
+     */
+    async releaseWorkflowRunLockRaw(requestParameters: ReleaseWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>> {
+        const requestOptions = await this.releaseWorkflowRunLockRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.VoidApiResponse(response);
+    }
+
+    /**
+     * Release the reviewer lock; only the holder may call this.  DELETE /lock is idempotent: returns 204 even if no lock is held.
+     * Release Workflow Run Lock Handler
+     */
+    async releaseWorkflowRunLock(requestParameters: ReleaseWorkflowRunLockRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void> {
+        await this.releaseWorkflowRunLockRaw(requestParameters, initOverrides);
+    }
+
+    /**
+     * Creates request options for unapproveWorkflowRunFile without sending the request
+     */
+    async unapproveWorkflowRunFileRequestOpts(requestParameters: UnapproveWorkflowRunFileRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['runId'] == null) {
+            throw new runtime.RequiredError(
+                'runId',
+                'Required parameter "runId" was null or undefined when calling unapproveWorkflowRunFile().'
+            );
+        }
+
+        if (requestParameters['pathPartId'] == null) {
+            throw new runtime.RequiredError(
+                'pathPartId',
+                'Required parameter "pathPartId" was null or undefined when calling unapproveWorkflowRunFile().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/workflow-runs/{run_id}/files/{path_part_id}/unapprove`;
+        urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+        urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Revert an approved file to ``pending``.  Does NOT require the reviewer lock — anyone with ``can_write`` on the run path may unapprove (pilot plan §11.7).
+     * Unapprove Workflow Run File Handler
+     */
+    async unapproveWorkflowRunFileRaw(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartApprovalResponse>> {
+        const requestOptions = await this.unapproveWorkflowRunFileRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PathPartApprovalResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Revert an approved file to ``pending``.  Does NOT require the reviewer lock — anyone with ``can_write`` on the run path may unapprove (pilot plan §11.7).
+     * Unapprove Workflow Run File Handler
+     */
+    async unapproveWorkflowRunFile(requestParameters: UnapproveWorkflowRunFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartApprovalResponse> {
+        const response = await this.unapproveWorkflowRunFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Creates request options for workflowRunCallback without sending the request
      */

package/src/apis/index.ts

@@ -24,5 +24,6 @@ export * from './ThreadsApi';
 export * from './UserPermissionsApi';
 export * from './UsersApi';
 export * from './WorkflowDefinitionsApi';
+export * from './WorkflowMemoryApi';
 export * from './WorkflowRunsApi';
 export * from './WorkflowsApi';

package/src/models/AppendEventRequest.ts

@@ -0,0 +1,102 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+/**
+ * Body for ``POST /v1/path-parts/{path_part_id}/events``.
+ * 
+ * The route requires ``can_write`` on the subject path_part. Server
+ * stamps ``id``/``tenant_id``/``actor_user_id``/``ts``/
+ * ``subject_path_part_id``; frontend supplies only ``kind`` and
+ * ``payload``. ``kind`` must NOT use a reserved server namespace —
+ * those are emitted by service code so the audit trail can't be
+ * forged by an authenticated client.
+ * @export
+ * @interface AppendEventRequest
+ */
+export interface AppendEventRequest {
+    /**
+     * 
+     * @type {string}
+     * @memberof AppendEventRequest
+     */
+    kind: string;
+    /**
+     * 
+     * @type {{ [key: string]: any; }}
+     * @memberof AppendEventRequest
+     */
+    payload?: { [key: string]: any; };
+}
+export const AppendEventRequestPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number,
+        minLength?: number,
+        pattern?: string,
+        maximum?: number,
+        exclusiveMaximum?: boolean,
+        minimum?: number,
+        exclusiveMinimum?: boolean,
+        multipleOf?: number,
+        maxItems?: number,
+        minItems?: number,
+        uniqueItems?: boolean
+    }
+} = {
+    kind: {
+        maxLength: 255,
+        minLength: 1,
+    },
+}
+
+
+/**
+ * Check if a given object implements the AppendEventRequest interface.
+ */
+export function instanceOfAppendEventRequest(value: object): value is AppendEventRequest {
+    if (!('kind' in value) || value['kind'] === undefined) return false;
+    return true;
+}
+
+export function AppendEventRequestFromJSON(json: any): AppendEventRequest {
+    return AppendEventRequestFromJSONTyped(json, false);
+}
+
+export function AppendEventRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): AppendEventRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'kind': json['kind'],
+        'payload': json['payload'] == null ? undefined : json['payload'],
+    };
+}
+
+export function AppendEventRequestToJSON(json: any): AppendEventRequest {
+    return AppendEventRequestToJSONTyped(json, false);
+}
+
+export function AppendEventRequestToJSONTyped(value?: AppendEventRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'kind': value['kind'],
+        'payload': value['payload'],
+    };
+}
+