@knowledge-stack/ksapi 3.16.2 → 3.17.1

package/src/apis/WorkflowRepositoryApi.ts

@@ -0,0 +1,1002 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call. 
+ *
+ * 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 * as runtime from '../runtime';
+import type {
+  ErrorResponse,
+  EventResponse,
+  HTTPValidationError,
+  PaginatedResponseRepoVersionResponse,
+  RecordRepoSaveSkipRequest,
+  RepoBranchResponse,
+  RepoTreeResponse,
+  RepoVersionResponse,
+  WorkflowRepoResponse,
+} from '../models/index';
+import {
+    ErrorResponseFromJSON,
+    ErrorResponseToJSON,
+    EventResponseFromJSON,
+    EventResponseToJSON,
+    HTTPValidationErrorFromJSON,
+    HTTPValidationErrorToJSON,
+    PaginatedResponseRepoVersionResponseFromJSON,
+    PaginatedResponseRepoVersionResponseToJSON,
+    RecordRepoSaveSkipRequestFromJSON,
+    RecordRepoSaveSkipRequestToJSON,
+    RepoBranchResponseFromJSON,
+    RepoBranchResponseToJSON,
+    RepoTreeResponseFromJSON,
+    RepoTreeResponseToJSON,
+    RepoVersionResponseFromJSON,
+    RepoVersionResponseToJSON,
+    WorkflowRepoResponseFromJSON,
+    WorkflowRepoResponseToJSON,
+} from '../models/index';
+
+export interface DownloadWorkflowRepoBranchBundleRequest {
+    definitionId: string;
+    runId: string;
+    versionId?: string | null;
+}
+
+export interface DownloadWorkflowRepoBundleRequest {
+    definitionId: string;
+    versionId?: string | null;
+}
+
+export interface GetWorkflowRepoRequest {
+    definitionId: string;
+}
+
+export interface GetWorkflowRepoBranchRequest {
+    definitionId: string;
+    runId: string;
+}
+
+export interface GetWorkflowRepoTreeRequest {
+    definitionId: string;
+    commit?: string | null;
+}
+
+export interface ListWorkflowRepoVersionsRequest {
+    definitionId: string;
+    runId?: string | null;
+    limit?: number;
+    offset?: number;
+}
+
+export interface RecordWorkflowRepoSkippedSaveRequest {
+    definitionId: string;
+    recordRepoSaveSkipRequest: RecordRepoSaveSkipRequest;
+}
+
+export interface SaveWorkflowRepoBranchRequest {
+    definitionId: string;
+    runId: string;
+    bundle: Blob;
+    expectedVersionId?: string | null;
+    baseVersionId?: string | null;
+}
+
+export interface SaveWorkflowRepoVersionRequest {
+    definitionId: string;
+    bundle: Blob;
+    runId: string;
+    expectedVersionId?: string | null;
+    candidateVersionId?: string | null;
+}
+
+/**
+ * WorkflowRepositoryApi - interface
+ * 
+ * @export
+ * @interface WorkflowRepositoryApiInterface
+ */
+export interface WorkflowRepositoryApiInterface {
+    /**
+     * Creates request options for downloadWorkflowRepoBranchBundle without sending the request
+     * @param {string} definitionId 
+     * @param {string} runId 
+     * @param {string} [versionId] Retained branch version
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    downloadWorkflowRepoBranchBundleRequestOpts(requestParameters: DownloadWorkflowRepoBranchBundleRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Download a run branch; a named version must belong to that run.
+     * @summary Download Workflow Repo Branch Bundle Handler
+     * @param {string} definitionId 
+     * @param {string} runId 
+     * @param {string} [versionId] Retained branch version
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    downloadWorkflowRepoBranchBundleRaw(requestParameters: DownloadWorkflowRepoBranchBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>>;
+
+    /**
+     * Download a run branch; a named version must belong to that run.
+     * Download Workflow Repo Branch Bundle Handler
+     */
+    downloadWorkflowRepoBranchBundle(requestParameters: DownloadWorkflowRepoBranchBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob>;
+
+    /**
+     * Creates request options for downloadWorkflowRepoBundle without sending the request
+     * @param {string} definitionId 
+     * @param {string} [versionId] Saved version; default: main
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    downloadWorkflowRepoBundleRequestOpts(requestParameters: DownloadWorkflowRepoBundleRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Download a saved version as a git bundle (what a run clones).
+     * @summary Download Workflow Repo Bundle Handler
+     * @param {string} definitionId 
+     * @param {string} [versionId] Saved version; default: main
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    downloadWorkflowRepoBundleRaw(requestParameters: DownloadWorkflowRepoBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>>;
+
+    /**
+     * Download a saved version as a git bundle (what a run clones).
+     * Download Workflow Repo Bundle Handler
+     */
+    downloadWorkflowRepoBundle(requestParameters: DownloadWorkflowRepoBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob>;
+
+    /**
+     * Creates request options for getWorkflowRepo without sending the request
+     * @param {string} definitionId 
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    getWorkflowRepoRequestOpts(requestParameters: GetWorkflowRepoRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * The repository\'s current main: name, head commit and size.
+     * @summary Get Workflow Repo Handler
+     * @param {string} definitionId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    getWorkflowRepoRaw(requestParameters: GetWorkflowRepoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRepoResponse>>;
+
+    /**
+     * The repository\'s current main: name, head commit and size.
+     * Get Workflow Repo Handler
+     */
+    getWorkflowRepo(requestParameters: GetWorkflowRepoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRepoResponse>;
+
+    /**
+     * Creates request options for getWorkflowRepoBranch without sending the request
+     * @param {string} definitionId 
+     * @param {string} runId 
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    getWorkflowRepoBranchRequestOpts(requestParameters: GetWorkflowRepoBranchRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * The run\'s retained branch and whether its latest version reached main.
+     * @summary Get Workflow Repo Branch Handler
+     * @param {string} definitionId 
+     * @param {string} runId 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    getWorkflowRepoBranchRaw(requestParameters: GetWorkflowRepoBranchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RepoBranchResponse>>;
+
+    /**
+     * The run\'s retained branch and whether its latest version reached main.
+     * Get Workflow Repo Branch Handler
+     */
+    getWorkflowRepoBranch(requestParameters: GetWorkflowRepoBranchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RepoBranchResponse>;
+
+    /**
+     * Creates request options for getWorkflowRepoTree without sending the request
+     * @param {string} definitionId 
+     * @param {string} [commit] 
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    getWorkflowRepoTreeRequestOpts(requestParameters: GetWorkflowRepoTreeRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * File metadata at a saved snapshot head (default: main), path-sorted.  Intermediate commits without a saved manifest return repo_commit_not_found. This endpoint never reads object storage or interprets Git objects.
+     * @summary Get Workflow Repo Tree Handler
+     * @param {string} definitionId 
+     * @param {string} [commit] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    getWorkflowRepoTreeRaw(requestParameters: GetWorkflowRepoTreeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RepoTreeResponse>>;
+
+    /**
+     * File metadata at a saved snapshot head (default: main), path-sorted.  Intermediate commits without a saved manifest return repo_commit_not_found. This endpoint never reads object storage or interprets Git objects.
+     * Get Workflow Repo Tree Handler
+     */
+    getWorkflowRepoTree(requestParameters: GetWorkflowRepoTreeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RepoTreeResponse>;
+
+    /**
+     * Creates request options for listWorkflowRepoVersions without sending the request
+     * @param {string} definitionId 
+     * @param {string} [runId] Only versions saved by this run
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    listWorkflowRepoVersionsRequestOpts(requestParameters: ListWorkflowRepoVersionsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Saved versions, newest first: the save log.
+     * @summary List Workflow Repo Versions Handler
+     * @param {string} definitionId 
+     * @param {string} [runId] Only versions saved by this run
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    listWorkflowRepoVersionsRaw(requestParameters: ListWorkflowRepoVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseRepoVersionResponse>>;
+
+    /**
+     * Saved versions, newest first: the save log.
+     * List Workflow Repo Versions Handler
+     */
+    listWorkflowRepoVersions(requestParameters: ListWorkflowRepoVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseRepoVersionResponse>;
+
+    /**
+     * Creates request options for recordWorkflowRepoSkippedSave without sending the request
+     * @param {string} definitionId 
+     * @param {RecordRepoSaveSkipRequest} recordRepoSaveSkipRequest 
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    recordWorkflowRepoSkippedSaveRequestOpts(requestParameters: RecordWorkflowRepoSkippedSaveRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Record on a run that its turn\'s repository changes were not kept.  Needs only read on the workflow: the same authority as posting the follow-up message whose turn produced the changes.
+     * @summary Record Workflow Repo Skipped Save Handler
+     * @param {string} definitionId 
+     * @param {RecordRepoSaveSkipRequest} recordRepoSaveSkipRequest 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    recordWorkflowRepoSkippedSaveRaw(requestParameters: RecordWorkflowRepoSkippedSaveRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EventResponse>>;
+
+    /**
+     * Record on a run that its turn\'s repository changes were not kept.  Needs only read on the workflow: the same authority as posting the follow-up message whose turn produced the changes.
+     * Record Workflow Repo Skipped Save Handler
+     */
+    recordWorkflowRepoSkippedSave(requestParameters: RecordWorkflowRepoSkippedSaveRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EventResponse>;
+
+    /**
+     * Creates request options for saveWorkflowRepoBranch without sending the request
+     * @param {string} definitionId 
+     * @param {string} runId 
+     * @param {Blob} bundle Full git bundle of runs/&lt;run-id&gt;
+     * @param {string} [expectedVersionId] Previous retained version of this run branch
+     * @param {string} [baseVersionId] Accepted main version this branch started from
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    saveWorkflowRepoBranchRequestOpts(requestParameters: SaveWorkflowRepoBranchRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Retain a branch without publishing it to other runs.
+     * @summary Save Workflow Repo Branch Handler
+     * @param {string} definitionId 
+     * @param {string} runId 
+     * @param {Blob} bundle Full git bundle of runs/&lt;run-id&gt;
+     * @param {string} [expectedVersionId] Previous retained version of this run branch
+     * @param {string} [baseVersionId] Accepted main version this branch started from
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    saveWorkflowRepoBranchRaw(requestParameters: SaveWorkflowRepoBranchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RepoBranchResponse>>;
+
+    /**
+     * Retain a branch without publishing it to other runs.
+     * Save Workflow Repo Branch Handler
+     */
+    saveWorkflowRepoBranch(requestParameters: SaveWorkflowRepoBranchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RepoBranchResponse>;
+
+    /**
+     * Creates request options for saveWorkflowRepoVersion without sending the request
+     * @param {string} definitionId 
+     * @param {Blob} bundle Full git bundle of main
+     * @param {string} runId The run saving this version
+     * @param {string} [expectedVersionId] The version this save is based on; omit for the first save
+     * @param {string} [candidateVersionId] Retained run branch being integrated
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    saveWorkflowRepoVersionRequestOpts(requestParameters: SaveWorkflowRepoVersionRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Make a bundle the workflow\'s new main (compare-and-set on the base version).  409 ``repo_head_moved``: main moved since the base; integrate and retry. 409 ``repo_not_fast_forward``: the bundle does not contain main. 422 ``repo_invalid_bundle`` / ``repo_too_large`` / ``repo_unsafe_path``.
+     * @summary Save Workflow Repo Version Handler
+     * @param {string} definitionId 
+     * @param {Blob} bundle Full git bundle of main
+     * @param {string} runId The run saving this version
+     * @param {string} [expectedVersionId] The version this save is based on; omit for the first save
+     * @param {string} [candidateVersionId] Retained run branch being integrated
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WorkflowRepositoryApiInterface
+     */
+    saveWorkflowRepoVersionRaw(requestParameters: SaveWorkflowRepoVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RepoVersionResponse>>;
+
+    /**
+     * Make a bundle the workflow\'s new main (compare-and-set on the base version).  409 ``repo_head_moved``: main moved since the base; integrate and retry. 409 ``repo_not_fast_forward``: the bundle does not contain main. 422 ``repo_invalid_bundle`` / ``repo_too_large`` / ``repo_unsafe_path``.
+     * Save Workflow Repo Version Handler
+     */
+    saveWorkflowRepoVersion(requestParameters: SaveWorkflowRepoVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RepoVersionResponse>;
+
+}
+
+/**
+ * 
+ */
+export class WorkflowRepositoryApi extends runtime.BaseAPI implements WorkflowRepositoryApiInterface {
+
+    /**
+     * Creates request options for downloadWorkflowRepoBranchBundle without sending the request
+     */
+    async downloadWorkflowRepoBranchBundleRequestOpts(requestParameters: DownloadWorkflowRepoBranchBundleRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['definitionId'] == null) {
+            throw new runtime.RequiredError(
+                'definitionId',
+                'Required parameter "definitionId" was null or undefined when calling downloadWorkflowRepoBranchBundle().'
+            );
+        }
+
+        if (requestParameters['runId'] == null) {
+            throw new runtime.RequiredError(
+                'runId',
+                'Required parameter "runId" was null or undefined when calling downloadWorkflowRepoBranchBundle().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['versionId'] != null) {
+            queryParameters['version_id'] = requestParameters['versionId'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/workflow-definitions/{definition_id}/memory/repo/branches/{run_id}/bundle`;
+        urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
+        urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Download a run branch; a named version must belong to that run.
+     * Download Workflow Repo Branch Bundle Handler
+     */
+    async downloadWorkflowRepoBranchBundleRaw(requestParameters: DownloadWorkflowRepoBranchBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>> {
+        const requestOptions = await this.downloadWorkflowRepoBranchBundleRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.BlobApiResponse(response);
+    }
+
+    /**
+     * Download a run branch; a named version must belong to that run.
+     * Download Workflow Repo Branch Bundle Handler
+     */
+    async downloadWorkflowRepoBranchBundle(requestParameters: DownloadWorkflowRepoBranchBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob> {
+        const response = await this.downloadWorkflowRepoBranchBundleRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for downloadWorkflowRepoBundle without sending the request
+     */
+    async downloadWorkflowRepoBundleRequestOpts(requestParameters: DownloadWorkflowRepoBundleRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['definitionId'] == null) {
+            throw new runtime.RequiredError(
+                'definitionId',
+                'Required parameter "definitionId" was null or undefined when calling downloadWorkflowRepoBundle().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['versionId'] != null) {
+            queryParameters['version_id'] = requestParameters['versionId'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/workflow-definitions/{definition_id}/memory/repo/bundle`;
+        urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Download a saved version as a git bundle (what a run clones).
+     * Download Workflow Repo Bundle Handler
+     */
+    async downloadWorkflowRepoBundleRaw(requestParameters: DownloadWorkflowRepoBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>> {
+        const requestOptions = await this.downloadWorkflowRepoBundleRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.BlobApiResponse(response);
+    }
+
+    /**
+     * Download a saved version as a git bundle (what a run clones).
+     * Download Workflow Repo Bundle Handler
+     */
+    async downloadWorkflowRepoBundle(requestParameters: DownloadWorkflowRepoBundleRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob> {
+        const response = await this.downloadWorkflowRepoBundleRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getWorkflowRepo without sending the request
+     */
+    async getWorkflowRepoRequestOpts(requestParameters: GetWorkflowRepoRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['definitionId'] == null) {
+            throw new runtime.RequiredError(
+                'definitionId',
+                'Required parameter "definitionId" was null or undefined when calling getWorkflowRepo().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/workflow-definitions/{definition_id}/memory/repo`;
+        urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * The repository\'s current main: name, head commit and size.
+     * Get Workflow Repo Handler
+     */
+    async getWorkflowRepoRaw(requestParameters: GetWorkflowRepoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRepoResponse>> {
+        const requestOptions = await this.getWorkflowRepoRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => WorkflowRepoResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * The repository\'s current main: name, head commit and size.
+     * Get Workflow Repo Handler
+     */
+    async getWorkflowRepo(requestParameters: GetWorkflowRepoRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRepoResponse> {
+        const response = await this.getWorkflowRepoRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getWorkflowRepoBranch without sending the request
+     */
+    async getWorkflowRepoBranchRequestOpts(requestParameters: GetWorkflowRepoBranchRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['definitionId'] == null) {
+            throw new runtime.RequiredError(
+                'definitionId',
+                'Required parameter "definitionId" was null or undefined when calling getWorkflowRepoBranch().'
+            );
+        }
+
+        if (requestParameters['runId'] == null) {
+            throw new runtime.RequiredError(
+                'runId',
+                'Required parameter "runId" was null or undefined when calling getWorkflowRepoBranch().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/workflow-definitions/{definition_id}/memory/repo/branches/{run_id}`;
+        urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
+        urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * The run\'s retained branch and whether its latest version reached main.
+     * Get Workflow Repo Branch Handler
+     */
+    async getWorkflowRepoBranchRaw(requestParameters: GetWorkflowRepoBranchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RepoBranchResponse>> {
+        const requestOptions = await this.getWorkflowRepoBranchRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => RepoBranchResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * The run\'s retained branch and whether its latest version reached main.
+     * Get Workflow Repo Branch Handler
+     */
+    async getWorkflowRepoBranch(requestParameters: GetWorkflowRepoBranchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RepoBranchResponse> {
+        const response = await this.getWorkflowRepoBranchRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for getWorkflowRepoTree without sending the request
+     */
+    async getWorkflowRepoTreeRequestOpts(requestParameters: GetWorkflowRepoTreeRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['definitionId'] == null) {
+            throw new runtime.RequiredError(
+                'definitionId',
+                'Required parameter "definitionId" was null or undefined when calling getWorkflowRepoTree().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['commit'] != null) {
+            queryParameters['commit'] = requestParameters['commit'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/workflow-definitions/{definition_id}/memory/repo/tree`;
+        urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * File metadata at a saved snapshot head (default: main), path-sorted.  Intermediate commits without a saved manifest return repo_commit_not_found. This endpoint never reads object storage or interprets Git objects.
+     * Get Workflow Repo Tree Handler
+     */
+    async getWorkflowRepoTreeRaw(requestParameters: GetWorkflowRepoTreeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RepoTreeResponse>> {
+        const requestOptions = await this.getWorkflowRepoTreeRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => RepoTreeResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * File metadata at a saved snapshot head (default: main), path-sorted.  Intermediate commits without a saved manifest return repo_commit_not_found. This endpoint never reads object storage or interprets Git objects.
+     * Get Workflow Repo Tree Handler
+     */
+    async getWorkflowRepoTree(requestParameters: GetWorkflowRepoTreeRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RepoTreeResponse> {
+        const response = await this.getWorkflowRepoTreeRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for listWorkflowRepoVersions without sending the request
+     */
+    async listWorkflowRepoVersionsRequestOpts(requestParameters: ListWorkflowRepoVersionsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['definitionId'] == null) {
+            throw new runtime.RequiredError(
+                'definitionId',
+                'Required parameter "definitionId" was null or undefined when calling listWorkflowRepoVersions().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['runId'] != null) {
+            queryParameters['run_id'] = requestParameters['runId'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/workflow-definitions/{definition_id}/memory/repo/versions`;
+        urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Saved versions, newest first: the save log.
+     * List Workflow Repo Versions Handler
+     */
+    async listWorkflowRepoVersionsRaw(requestParameters: ListWorkflowRepoVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseRepoVersionResponse>> {
+        const requestOptions = await this.listWorkflowRepoVersionsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseRepoVersionResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Saved versions, newest first: the save log.
+     * List Workflow Repo Versions Handler
+     */
+    async listWorkflowRepoVersions(requestParameters: ListWorkflowRepoVersionsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseRepoVersionResponse> {
+        const response = await this.listWorkflowRepoVersionsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for recordWorkflowRepoSkippedSave without sending the request
+     */
+    async recordWorkflowRepoSkippedSaveRequestOpts(requestParameters: RecordWorkflowRepoSkippedSaveRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['definitionId'] == null) {
+            throw new runtime.RequiredError(
+                'definitionId',
+                'Required parameter "definitionId" was null or undefined when calling recordWorkflowRepoSkippedSave().'
+            );
+        }
+
+        if (requestParameters['recordRepoSaveSkipRequest'] == null) {
+            throw new runtime.RequiredError(
+                'recordRepoSaveSkipRequest',
+                'Required parameter "recordRepoSaveSkipRequest" was null or undefined when calling recordWorkflowRepoSkippedSave().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/workflow-definitions/{definition_id}/memory/repo/skipped-saves`;
+        urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: RecordRepoSaveSkipRequestToJSON(requestParameters['recordRepoSaveSkipRequest']),
+        };
+    }
+
+    /**
+     * Record on a run that its turn\'s repository changes were not kept.  Needs only read on the workflow: the same authority as posting the follow-up message whose turn produced the changes.
+     * Record Workflow Repo Skipped Save Handler
+     */
+    async recordWorkflowRepoSkippedSaveRaw(requestParameters: RecordWorkflowRepoSkippedSaveRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EventResponse>> {
+        const requestOptions = await this.recordWorkflowRepoSkippedSaveRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => EventResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Record on a run that its turn\'s repository changes were not kept.  Needs only read on the workflow: the same authority as posting the follow-up message whose turn produced the changes.
+     * Record Workflow Repo Skipped Save Handler
+     */
+    async recordWorkflowRepoSkippedSave(requestParameters: RecordWorkflowRepoSkippedSaveRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EventResponse> {
+        const response = await this.recordWorkflowRepoSkippedSaveRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for saveWorkflowRepoBranch without sending the request
+     */
+    async saveWorkflowRepoBranchRequestOpts(requestParameters: SaveWorkflowRepoBranchRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['definitionId'] == null) {
+            throw new runtime.RequiredError(
+                'definitionId',
+                'Required parameter "definitionId" was null or undefined when calling saveWorkflowRepoBranch().'
+            );
+        }
+
+        if (requestParameters['runId'] == null) {
+            throw new runtime.RequiredError(
+                'runId',
+                'Required parameter "runId" was null or undefined when calling saveWorkflowRepoBranch().'
+            );
+        }
+
+        if (requestParameters['bundle'] == null) {
+            throw new runtime.RequiredError(
+                'bundle',
+                'Required parameter "bundle" was null or undefined when calling saveWorkflowRepoBranch().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const consumes: runtime.Consume[] = [
+            { contentType: 'multipart/form-data' },
+        ];
+        // @ts-ignore: canConsumeForm may be unused
+        const canConsumeForm = runtime.canConsumeForm(consumes);
+
+        let formParams: { append(param: string, value: any): any };
+        let useForm = false;
+        // use FormData to transmit files using content-type "multipart/form-data"
+        useForm = canConsumeForm;
+        if (useForm) {
+            formParams = new FormData();
+        } else {
+            formParams = new URLSearchParams();
+        }
+
+        if (requestParameters['bundle'] != null) {
+            formParams.append('bundle', requestParameters['bundle'] as any);
+        }
+
+        if (requestParameters['expectedVersionId'] != null) {
+            formParams.append('expected_version_id', requestParameters['expectedVersionId'] as any);
+        }
+
+        if (requestParameters['baseVersionId'] != null) {
+            formParams.append('base_version_id', requestParameters['baseVersionId'] as any);
+        }
+
+
+        let urlPath = `/v1/workflow-definitions/{definition_id}/memory/repo/branches/{run_id}/versions`;
+        urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
+        urlPath = urlPath.replace(`{${"run_id"}}`, encodeURIComponent(String(requestParameters['runId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: formParams,
+        };
+    }
+
+    /**
+     * Retain a branch without publishing it to other runs.
+     * Save Workflow Repo Branch Handler
+     */
+    async saveWorkflowRepoBranchRaw(requestParameters: SaveWorkflowRepoBranchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RepoBranchResponse>> {
+        const requestOptions = await this.saveWorkflowRepoBranchRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => RepoBranchResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Retain a branch without publishing it to other runs.
+     * Save Workflow Repo Branch Handler
+     */
+    async saveWorkflowRepoBranch(requestParameters: SaveWorkflowRepoBranchRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RepoBranchResponse> {
+        const response = await this.saveWorkflowRepoBranchRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for saveWorkflowRepoVersion without sending the request
+     */
+    async saveWorkflowRepoVersionRequestOpts(requestParameters: SaveWorkflowRepoVersionRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['definitionId'] == null) {
+            throw new runtime.RequiredError(
+                'definitionId',
+                'Required parameter "definitionId" was null or undefined when calling saveWorkflowRepoVersion().'
+            );
+        }
+
+        if (requestParameters['bundle'] == null) {
+            throw new runtime.RequiredError(
+                'bundle',
+                'Required parameter "bundle" was null or undefined when calling saveWorkflowRepoVersion().'
+            );
+        }
+
+        if (requestParameters['runId'] == null) {
+            throw new runtime.RequiredError(
+                'runId',
+                'Required parameter "runId" was null or undefined when calling saveWorkflowRepoVersion().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        const consumes: runtime.Consume[] = [
+            { contentType: 'multipart/form-data' },
+        ];
+        // @ts-ignore: canConsumeForm may be unused
+        const canConsumeForm = runtime.canConsumeForm(consumes);
+
+        let formParams: { append(param: string, value: any): any };
+        let useForm = false;
+        // use FormData to transmit files using content-type "multipart/form-data"
+        useForm = canConsumeForm;
+        if (useForm) {
+            formParams = new FormData();
+        } else {
+            formParams = new URLSearchParams();
+        }
+
+        if (requestParameters['bundle'] != null) {
+            formParams.append('bundle', requestParameters['bundle'] as any);
+        }
+
+        if (requestParameters['runId'] != null) {
+            formParams.append('run_id', requestParameters['runId'] as any);
+        }
+
+        if (requestParameters['expectedVersionId'] != null) {
+            formParams.append('expected_version_id', requestParameters['expectedVersionId'] as any);
+        }
+
+        if (requestParameters['candidateVersionId'] != null) {
+            formParams.append('candidate_version_id', requestParameters['candidateVersionId'] as any);
+        }
+
+
+        let urlPath = `/v1/workflow-definitions/{definition_id}/memory/repo/versions`;
+        urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: formParams,
+        };
+    }
+
+    /**
+     * Make a bundle the workflow\'s new main (compare-and-set on the base version).  409 ``repo_head_moved``: main moved since the base; integrate and retry. 409 ``repo_not_fast_forward``: the bundle does not contain main. 422 ``repo_invalid_bundle`` / ``repo_too_large`` / ``repo_unsafe_path``.
+     * Save Workflow Repo Version Handler
+     */
+    async saveWorkflowRepoVersionRaw(requestParameters: SaveWorkflowRepoVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<RepoVersionResponse>> {
+        const requestOptions = await this.saveWorkflowRepoVersionRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => RepoVersionResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Make a bundle the workflow\'s new main (compare-and-set on the base version).  409 ``repo_head_moved``: main moved since the base; integrate and retry. 409 ``repo_not_fast_forward``: the bundle does not contain main. 422 ``repo_invalid_bundle`` / ``repo_too_large`` / ``repo_unsafe_path``.
+     * Save Workflow Repo Version Handler
+     */
+    async saveWorkflowRepoVersion(requestParameters: SaveWorkflowRepoVersionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<RepoVersionResponse> {
+        const response = await this.saveWorkflowRepoVersionRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}