@knowledge-stack/ksapi 1.88.1 → 1.89.0

package/dist/apis/WorkflowDefinitionsApi.d.ts

@@ -10,25 +10,27 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { CreateWorkflowDefinitionRequest, InvokeWorkflowRequest, PaginatedResponseWorkflowDefinitionResponse, PaginatedResponseWorkflowRunResponse, UpdateWorkflowDefinitionRequest, WorkflowDefinitionResponse, WorkflowRunResponse } from '../models/index';
+import type { CreateWorkflowDefinitionRequest, PaginatedResponseWorkflowDefinitionResponse, PaginatedResponseWorkflowRunResponse, UpdateWorkflowDefinitionRequest, WorkflowDefinitionResponse, WorkflowRunResponse } from '../models/index';
 export interface CreateWorkflowDefinitionOperationRequest {
     createWorkflowDefinitionRequest: CreateWorkflowDefinitionRequest;
     authorization?: string | null;
     ksUat?: string | null;
 }
-export interface DeleteWorkflowDefinitionRequest {
+export interface CreateWorkflowRunRequest {
     definitionId: string;
     authorization?: string | null;
     ksUat?: string | null;
+    files?: Array<Blob>;
+    inputScope?: string | null;
+    idempotencyKey?: string | null;
 }
-export interface GetWorkflowDefinitionRequest {
+export interface DeleteWorkflowDefinitionRequest {
     definitionId: string;
     authorization?: string | null;
     ksUat?: string | null;
 }
-export interface InvokeWorkflowOperationRequest {
+export interface GetWorkflowDefinitionRequest {
     definitionId: string;
-    invokeWorkflowRequest: InvokeWorkflowRequest;
     authorization?: string | null;
     ksUat?: string | null;
 }
@@ -83,41 +85,48 @@ export interface WorkflowDefinitionsApiInterface {
      */
     createWorkflowDefinition(requestParameters: CreateWorkflowDefinitionOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowDefinitionResponse>;
     /**
-     * Creates request options for deleteWorkflowDefinition without sending the request
+     * Creates request options for createWorkflowRun without sending the request
      * @param {string} definitionId
      * @param {string} [authorization]
      * @param {string} [ksUat]
+     * @param {Array<Blob>} [files] Files to ingest under the run\\\&#39;s &#x60;&#x60;inputs/&#x60;&#x60; folder. Each filename may include POSIX-style &#x60;&#x60;/&#x60;&#x60; separators to reconstruct a folder structure under &#x60;&#x60;inputs/&#x60;&#x60;.
+     * @param {string} [inputScope] JSON array of &#x60;&#x60;DOCUMENT&#x60;&#x60; or &#x60;&#x60;FOLDER&#x60;&#x60; path_part UUIDs referenced from the existing knowledge base. Combined with &#x60;&#x60;files&#x60;&#x60; in a single request to form the run\\\&#39;s input scope.
+     * @param {string} [idempotencyKey] Optional key to prevent duplicate runs from retries.
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface
      */
-    deleteWorkflowDefinitionRequestOpts(requestParameters: DeleteWorkflowDefinitionRequest): Promise<runtime.RequestOpts>;
+    createWorkflowRunRequestOpts(requestParameters: CreateWorkflowRunRequest): Promise<runtime.RequestOpts>;
     /**
-     *
-     * @summary Delete Workflow Definition Handler
+     * Trigger a workflow run from uploaded files and/or KB references.  The merged endpoint accepts both kinds of input in one multipart request. Each uploaded file is ingested under ``runs/<id>/inputs/`` (S3 + DB rows only; no Temporal pipeline). Each ``input_scope`` entry is resolved per its part_type: a DOCUMENT is pinned to its active ``DOCUMENT_VERSION``; a FOLDER is pinned by reference only and read live by the runner. A request that supplies neither is rejected.
+     * @summary Create Workflow Run Handler
      * @param {string} definitionId
      * @param {string} [authorization]
      * @param {string} [ksUat]
+     * @param {Array<Blob>} [files] Files to ingest under the run\\\&#39;s &#x60;&#x60;inputs/&#x60;&#x60; folder. Each filename may include POSIX-style &#x60;&#x60;/&#x60;&#x60; separators to reconstruct a folder structure under &#x60;&#x60;inputs/&#x60;&#x60;.
+     * @param {string} [inputScope] JSON array of &#x60;&#x60;DOCUMENT&#x60;&#x60; or &#x60;&#x60;FOLDER&#x60;&#x60; path_part UUIDs referenced from the existing knowledge base. Combined with &#x60;&#x60;files&#x60;&#x60; in a single request to form the run\\\&#39;s input scope.
+     * @param {string} [idempotencyKey] Optional key to prevent duplicate runs from retries.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface
      */
-    deleteWorkflowDefinitionRaw(requestParameters: DeleteWorkflowDefinitionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
+    createWorkflowRunRaw(requestParameters: CreateWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
     /**
-     * Delete Workflow Definition Handler
+     * Trigger a workflow run from uploaded files and/or KB references.  The merged endpoint accepts both kinds of input in one multipart request. Each uploaded file is ingested under ``runs/<id>/inputs/`` (S3 + DB rows only; no Temporal pipeline). Each ``input_scope`` entry is resolved per its part_type: a DOCUMENT is pinned to its active ``DOCUMENT_VERSION``; a FOLDER is pinned by reference only and read live by the runner. A request that supplies neither is rejected.
+     * Create Workflow Run Handler
      */
-    deleteWorkflowDefinition(requestParameters: DeleteWorkflowDefinitionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
+    createWorkflowRun(requestParameters: CreateWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
     /**
-     * Creates request options for getWorkflowDefinition without sending the request
+     * Creates request options for deleteWorkflowDefinition without sending the request
      * @param {string} definitionId
      * @param {string} [authorization]
      * @param {string} [ksUat]
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface
      */
-    getWorkflowDefinitionRequestOpts(requestParameters: GetWorkflowDefinitionRequest): Promise<runtime.RequestOpts>;
+    deleteWorkflowDefinitionRequestOpts(requestParameters: DeleteWorkflowDefinitionRequest): Promise<runtime.RequestOpts>;
     /**
      *
-     * @summary Get Workflow Definition Handler
+     * @summary Delete Workflow Definition Handler
      * @param {string} definitionId
      * @param {string} [authorization]
      * @param {string} [ksUat]
@@ -125,38 +134,35 @@ export interface WorkflowDefinitionsApiInterface {
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface
      */
-    getWorkflowDefinitionRaw(requestParameters: GetWorkflowDefinitionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowDefinitionResponse>>;
+    deleteWorkflowDefinitionRaw(requestParameters: DeleteWorkflowDefinitionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<void>>;
     /**
-     * Get Workflow Definition Handler
+     * Delete Workflow Definition Handler
      */
-    getWorkflowDefinition(requestParameters: GetWorkflowDefinitionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowDefinitionResponse>;
+    deleteWorkflowDefinition(requestParameters: DeleteWorkflowDefinitionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<void>;
     /**
-     * Creates request options for invokeWorkflow without sending the request
+     * Creates request options for getWorkflowDefinition without sending the request
      * @param {string} definitionId
-     * @param {InvokeWorkflowRequest} invokeWorkflowRequest
      * @param {string} [authorization]
      * @param {string} [ksUat]
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface
      */
-    invokeWorkflowRequestOpts(requestParameters: InvokeWorkflowOperationRequest): Promise<runtime.RequestOpts>;
+    getWorkflowDefinitionRequestOpts(requestParameters: GetWorkflowDefinitionRequest): Promise<runtime.RequestOpts>;
     /**
-     * Trigger a workflow run.  All business logic lives in ``WorkflowInvocationService``. This handler only orchestrates the two phases:  1. **Phase 1 (in-session):** validate, build snapshot, persist run row,    mint JWT. Wrapped in a single DB session so the run insert and the    idempotency-race resolution share a transaction. 2. **Phase 2 (out-of-session):** dispatch HTTP call to the SELF_HOSTED    runner. Best-effort — the run is already persisted, so failures here    transition the run to ``FAILED`` rather than rejecting the request.
-     * @summary Invoke Workflow Handler
+     *
+     * @summary Get Workflow Definition Handler
      * @param {string} definitionId
-     * @param {InvokeWorkflowRequest} invokeWorkflowRequest
      * @param {string} [authorization]
      * @param {string} [ksUat]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface
      */
-    invokeWorkflowRaw(requestParameters: InvokeWorkflowOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
+    getWorkflowDefinitionRaw(requestParameters: GetWorkflowDefinitionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowDefinitionResponse>>;
     /**
-     * Trigger a workflow run.  All business logic lives in ``WorkflowInvocationService``. This handler only orchestrates the two phases:  1. **Phase 1 (in-session):** validate, build snapshot, persist run row,    mint JWT. Wrapped in a single DB session so the run insert and the    idempotency-race resolution share a transaction. 2. **Phase 2 (out-of-session):** dispatch HTTP call to the SELF_HOSTED    runner. Best-effort — the run is already persisted, so failures here    transition the run to ``FAILED`` rather than rejecting the request.
-     * Invoke Workflow Handler
+     * Get Workflow Definition Handler
      */
-    invokeWorkflow(requestParameters: InvokeWorkflowOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
+    getWorkflowDefinition(requestParameters: GetWorkflowDefinitionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowDefinitionResponse>;
     /**
      * Creates request options for listWorkflowDefinitions without sending the request
      * @param {number} [limit] Number of items per page
@@ -254,6 +260,20 @@ export declare class WorkflowDefinitionsApi extends runtime.BaseAPI implements W
      * Create Workflow Definition Handler
      */
     createWorkflowDefinition(requestParameters: CreateWorkflowDefinitionOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowDefinitionResponse>;
+    /**
+     * Creates request options for createWorkflowRun without sending the request
+     */
+    createWorkflowRunRequestOpts(requestParameters: CreateWorkflowRunRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Trigger a workflow run from uploaded files and/or KB references.  The merged endpoint accepts both kinds of input in one multipart request. Each uploaded file is ingested under ``runs/<id>/inputs/`` (S3 + DB rows only; no Temporal pipeline). Each ``input_scope`` entry is resolved per its part_type: a DOCUMENT is pinned to its active ``DOCUMENT_VERSION``; a FOLDER is pinned by reference only and read live by the runner. A request that supplies neither is rejected.
+     * Create Workflow Run Handler
+     */
+    createWorkflowRunRaw(requestParameters: CreateWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
+    /**
+     * Trigger a workflow run from uploaded files and/or KB references.  The merged endpoint accepts both kinds of input in one multipart request. Each uploaded file is ingested under ``runs/<id>/inputs/`` (S3 + DB rows only; no Temporal pipeline). Each ``input_scope`` entry is resolved per its part_type: a DOCUMENT is pinned to its active ``DOCUMENT_VERSION``; a FOLDER is pinned by reference only and read live by the runner. A request that supplies neither is rejected.
+     * Create Workflow Run Handler
+     */
+    createWorkflowRun(requestParameters: CreateWorkflowRunRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
     /**
      * Creates request options for deleteWorkflowDefinition without sending the request
      */
@@ -278,20 +298,6 @@ export declare class WorkflowDefinitionsApi extends runtime.BaseAPI implements W
      * Get Workflow Definition Handler
      */
     getWorkflowDefinition(requestParameters: GetWorkflowDefinitionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowDefinitionResponse>;
-    /**
-     * Creates request options for invokeWorkflow without sending the request
-     */
-    invokeWorkflowRequestOpts(requestParameters: InvokeWorkflowOperationRequest): Promise<runtime.RequestOpts>;
-    /**
-     * Trigger a workflow run.  All business logic lives in ``WorkflowInvocationService``. This handler only orchestrates the two phases:  1. **Phase 1 (in-session):** validate, build snapshot, persist run row,    mint JWT. Wrapped in a single DB session so the run insert and the    idempotency-race resolution share a transaction. 2. **Phase 2 (out-of-session):** dispatch HTTP call to the SELF_HOSTED    runner. Best-effort — the run is already persisted, so failures here    transition the run to ``FAILED`` rather than rejecting the request.
-     * Invoke Workflow Handler
-     */
-    invokeWorkflowRaw(requestParameters: InvokeWorkflowOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
-    /**
-     * Trigger a workflow run.  All business logic lives in ``WorkflowInvocationService``. This handler only orchestrates the two phases:  1. **Phase 1 (in-session):** validate, build snapshot, persist run row,    mint JWT. Wrapped in a single DB session so the run insert and the    idempotency-race resolution share a transaction. 2. **Phase 2 (out-of-session):** dispatch HTTP call to the SELF_HOSTED    runner. Best-effort — the run is already persisted, so failures here    transition the run to ``FAILED`` rather than rejecting the request.
-     * Invoke Workflow Handler
-     */
-    invokeWorkflow(requestParameters: InvokeWorkflowOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
     /**
      * Creates request options for listWorkflowDefinitions without sending the request
      */

package/dist/apis/WorkflowDefinitionsApi.js

@@ -106,53 +106,83 @@ class WorkflowDefinitionsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Creates request options for deleteWorkflowDefinition without sending the request
+     * Creates request options for createWorkflowRun without sending the request
      */
-    deleteWorkflowDefinitionRequestOpts(requestParameters) {
+    createWorkflowRunRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['definitionId'] == null) {
-                throw new runtime.RequiredError('definitionId', 'Required parameter "definitionId" was null or undefined when calling deleteWorkflowDefinition().');
+                throw new runtime.RequiredError('definitionId', 'Required parameter "definitionId" was null or undefined when calling createWorkflowRun().');
             }
             const queryParameters = {};
             const headerParameters = {};
             if (requestParameters['authorization'] != null) {
                 headerParameters['authorization'] = String(requestParameters['authorization']);
             }
-            let urlPath = `/v1/workflow-definitions/{definition_id}`;
+            const consumes = [
+                { contentType: 'multipart/form-data' },
+            ];
+            // @ts-ignore: canConsumeForm may be unused
+            const canConsumeForm = runtime.canConsumeForm(consumes);
+            let formParams;
+            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['files'] != null) {
+                requestParameters['files'].forEach((element) => {
+                    formParams.append('files', element);
+                });
+            }
+            if (requestParameters['inputScope'] != null) {
+                formParams.append('input_scope', requestParameters['inputScope']);
+            }
+            if (requestParameters['idempotencyKey'] != null) {
+                formParams.append('idempotency_key', requestParameters['idempotencyKey']);
+            }
+            let urlPath = `/v1/workflow-definitions/{definition_id}/runs`;
             urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
             return {
                 path: urlPath,
-                method: 'DELETE',
+                method: 'POST',
                 headers: headerParameters,
                 query: queryParameters,
+                body: formParams,
             };
         });
     }
     /**
-     * Delete Workflow Definition Handler
+     * Trigger a workflow run from uploaded files and/or KB references.  The merged endpoint accepts both kinds of input in one multipart request. Each uploaded file is ingested under ``runs/<id>/inputs/`` (S3 + DB rows only; no Temporal pipeline). Each ``input_scope`` entry is resolved per its part_type: a DOCUMENT is pinned to its active ``DOCUMENT_VERSION``; a FOLDER is pinned by reference only and read live by the runner. A request that supplies neither is rejected.
+     * Create Workflow Run Handler
      */
-    deleteWorkflowDefinitionRaw(requestParameters, initOverrides) {
+    createWorkflowRunRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = yield this.deleteWorkflowDefinitionRequestOpts(requestParameters);
+            const requestOptions = yield this.createWorkflowRunRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.VoidApiResponse(response);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WorkflowRunResponseFromJSON)(jsonValue));
         });
     }
     /**
-     * Delete Workflow Definition Handler
+     * Trigger a workflow run from uploaded files and/or KB references.  The merged endpoint accepts both kinds of input in one multipart request. Each uploaded file is ingested under ``runs/<id>/inputs/`` (S3 + DB rows only; no Temporal pipeline). Each ``input_scope`` entry is resolved per its part_type: a DOCUMENT is pinned to its active ``DOCUMENT_VERSION``; a FOLDER is pinned by reference only and read live by the runner. A request that supplies neither is rejected.
+     * Create Workflow Run Handler
      */
-    deleteWorkflowDefinition(requestParameters, initOverrides) {
+    createWorkflowRun(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            yield this.deleteWorkflowDefinitionRaw(requestParameters, initOverrides);
+            const response = yield this.createWorkflowRunRaw(requestParameters, initOverrides);
+            return yield response.value();
         });
     }
     /**
-     * Creates request options for getWorkflowDefinition without sending the request
+     * Creates request options for deleteWorkflowDefinition without sending the request
      */
-    getWorkflowDefinitionRequestOpts(requestParameters) {
+    deleteWorkflowDefinitionRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['definitionId'] == null) {
-                throw new runtime.RequiredError('definitionId', 'Required parameter "definitionId" was null or undefined when calling getWorkflowDefinition().');
+                throw new runtime.RequiredError('definitionId', 'Required parameter "definitionId" was null or undefined when calling deleteWorkflowDefinition().');
             }
             const queryParameters = {};
             const headerParameters = {};
@@ -163,77 +193,69 @@ class WorkflowDefinitionsApi extends runtime.BaseAPI {
             urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
             return {
                 path: urlPath,
-                method: 'GET',
+                method: 'DELETE',
                 headers: headerParameters,
                 query: queryParameters,
             };
         });
     }
     /**
-     * Get Workflow Definition Handler
+     * Delete Workflow Definition Handler
      */
-    getWorkflowDefinitionRaw(requestParameters, initOverrides) {
+    deleteWorkflowDefinitionRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = yield this.getWorkflowDefinitionRequestOpts(requestParameters);
+            const requestOptions = yield this.deleteWorkflowDefinitionRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WorkflowDefinitionResponseFromJSON)(jsonValue));
+            return new runtime.VoidApiResponse(response);
         });
     }
     /**
-     * Get Workflow Definition Handler
+     * Delete Workflow Definition Handler
      */
-    getWorkflowDefinition(requestParameters, initOverrides) {
+    deleteWorkflowDefinition(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.getWorkflowDefinitionRaw(requestParameters, initOverrides);
-            return yield response.value();
+            yield this.deleteWorkflowDefinitionRaw(requestParameters, initOverrides);
         });
     }
     /**
-     * Creates request options for invokeWorkflow without sending the request
+     * Creates request options for getWorkflowDefinition without sending the request
      */
-    invokeWorkflowRequestOpts(requestParameters) {
+    getWorkflowDefinitionRequestOpts(requestParameters) {
         return __awaiter(this, void 0, void 0, function* () {
             if (requestParameters['definitionId'] == null) {
-                throw new runtime.RequiredError('definitionId', 'Required parameter "definitionId" was null or undefined when calling invokeWorkflow().');
-            }
-            if (requestParameters['invokeWorkflowRequest'] == null) {
-                throw new runtime.RequiredError('invokeWorkflowRequest', 'Required parameter "invokeWorkflowRequest" was null or undefined when calling invokeWorkflow().');
+                throw new runtime.RequiredError('definitionId', 'Required parameter "definitionId" was null or undefined when calling getWorkflowDefinition().');
             }
             const queryParameters = {};
             const headerParameters = {};
-            headerParameters['Content-Type'] = 'application/json';
             if (requestParameters['authorization'] != null) {
                 headerParameters['authorization'] = String(requestParameters['authorization']);
             }
-            let urlPath = `/v1/workflow-definitions/{definition_id}/invoke`;
+            let urlPath = `/v1/workflow-definitions/{definition_id}`;
             urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
             return {
                 path: urlPath,
-                method: 'POST',
+                method: 'GET',
                 headers: headerParameters,
                 query: queryParameters,
-                body: (0, index_1.InvokeWorkflowRequestToJSON)(requestParameters['invokeWorkflowRequest']),
             };
         });
     }
     /**
-     * Trigger a workflow run.  All business logic lives in ``WorkflowInvocationService``. This handler only orchestrates the two phases:  1. **Phase 1 (in-session):** validate, build snapshot, persist run row,    mint JWT. Wrapped in a single DB session so the run insert and the    idempotency-race resolution share a transaction. 2. **Phase 2 (out-of-session):** dispatch HTTP call to the SELF_HOSTED    runner. Best-effort — the run is already persisted, so failures here    transition the run to ``FAILED`` rather than rejecting the request.
-     * Invoke Workflow Handler
+     * Get Workflow Definition Handler
      */
-    invokeWorkflowRaw(requestParameters, initOverrides) {
+    getWorkflowDefinitionRaw(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const requestOptions = yield this.invokeWorkflowRequestOpts(requestParameters);
+            const requestOptions = yield this.getWorkflowDefinitionRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WorkflowRunResponseFromJSON)(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.WorkflowDefinitionResponseFromJSON)(jsonValue));
         });
     }
     /**
-     * Trigger a workflow run.  All business logic lives in ``WorkflowInvocationService``. This handler only orchestrates the two phases:  1. **Phase 1 (in-session):** validate, build snapshot, persist run row,    mint JWT. Wrapped in a single DB session so the run insert and the    idempotency-race resolution share a transaction. 2. **Phase 2 (out-of-session):** dispatch HTTP call to the SELF_HOSTED    runner. Best-effort — the run is already persisted, so failures here    transition the run to ``FAILED`` rather than rejecting the request.
-     * Invoke Workflow Handler
+     * Get Workflow Definition Handler
      */
-    invokeWorkflow(requestParameters, initOverrides) {
+    getWorkflowDefinition(requestParameters, initOverrides) {
         return __awaiter(this, void 0, void 0, function* () {
-            const response = yield this.invokeWorkflowRaw(requestParameters, initOverrides);
+            const response = yield this.getWorkflowDefinitionRaw(requestParameters, initOverrides);
             return yield response.value();
         });
     }

package/dist/apis/WorkflowMemoryApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AppendMemoryChunkRequest, EditMemoryChunkRequest, ListMemoryChunksResponse, MemoryChunkResponse } from '../models/index';
+import type { AppendMemoryChunkRequest, EditMemoryChunkRequest, MemoryChunkResponse, PaginatedResponseMemoryChunkResponse } from '../models/index';
 export interface AppendWorkflowMemoryChunkRequest {
     definitionId: string;
     appendMemoryChunkRequest: AppendMemoryChunkRequest;
@@ -38,6 +38,8 @@ export interface GetWorkflowMemoryChunkRequest {
 }
 export interface ListWorkflowMemoryChunksRequest {
     definitionId: string;
+    limit?: number;
+    offset?: number;
     authorization?: string | null;
     ksUat?: string | null;
 }
@@ -59,7 +61,7 @@ export interface WorkflowMemoryApiInterface {
      */
     appendWorkflowMemoryChunkRequestOpts(requestParameters: AppendWorkflowMemoryChunkRequest): Promise<runtime.RequestOpts>;
     /**
-     * Append a new memory chunk.  Exposed for external agents (e.g. self-hosted runners) that need to capture learnings without touching the DB directly. The new chunk\'s ``chunk_id`` is server-assigned. Each call snapshots a new DocumentVersion, just like edit/forget.
+     *
      * @summary Append Workflow Memory Chunk Handler
      * @param {string} definitionId
      * @param {AppendMemoryChunkRequest} appendMemoryChunkRequest
@@ -71,7 +73,6 @@ export interface WorkflowMemoryApiInterface {
      */
     appendWorkflowMemoryChunkRaw(requestParameters: AppendWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MemoryChunkResponse>>;
     /**
-     * Append a new memory chunk.  Exposed for external agents (e.g. self-hosted runners) that need to capture learnings without touching the DB directly. The new chunk\'s ``chunk_id`` is server-assigned. Each call snapshots a new DocumentVersion, just like edit/forget.
      * Append Workflow Memory Chunk Handler
      */
     appendWorkflowMemoryChunk(requestParameters: AppendWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MemoryChunkResponse>;
@@ -158,6 +159,8 @@ export interface WorkflowMemoryApiInterface {
     /**
      * Creates request options for listWorkflowMemoryChunks without sending the request
      * @param {string} definitionId
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
      * @param {string} [authorization]
      * @param {string} [ksUat]
      * @throws {RequiredError}
@@ -168,17 +171,19 @@ export interface WorkflowMemoryApiInterface {
      *
      * @summary List Workflow Memory Chunks Handler
      * @param {string} definitionId
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
      * @param {string} [authorization]
      * @param {string} [ksUat]
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowMemoryApiInterface
      */
-    listWorkflowMemoryChunksRaw(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListMemoryChunksResponse>>;
+    listWorkflowMemoryChunksRaw(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseMemoryChunkResponse>>;
     /**
      * List Workflow Memory Chunks Handler
      */
-    listWorkflowMemoryChunks(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListMemoryChunksResponse>;
+    listWorkflowMemoryChunks(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseMemoryChunkResponse>;
 }
 /**
  *
@@ -189,12 +194,10 @@ export declare class WorkflowMemoryApi extends runtime.BaseAPI implements Workfl
      */
     appendWorkflowMemoryChunkRequestOpts(requestParameters: AppendWorkflowMemoryChunkRequest): Promise<runtime.RequestOpts>;
     /**
-     * Append a new memory chunk.  Exposed for external agents (e.g. self-hosted runners) that need to capture learnings without touching the DB directly. The new chunk\'s ``chunk_id`` is server-assigned. Each call snapshots a new DocumentVersion, just like edit/forget.
      * Append Workflow Memory Chunk Handler
      */
     appendWorkflowMemoryChunkRaw(requestParameters: AppendWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MemoryChunkResponse>>;
     /**
-     * Append a new memory chunk.  Exposed for external agents (e.g. self-hosted runners) that need to capture learnings without touching the DB directly. The new chunk\'s ``chunk_id`` is server-assigned. Each call snapshots a new DocumentVersion, just like edit/forget.
      * Append Workflow Memory Chunk Handler
      */
     appendWorkflowMemoryChunk(requestParameters: AppendWorkflowMemoryChunkRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MemoryChunkResponse>;
@@ -241,9 +244,9 @@ export declare class WorkflowMemoryApi extends runtime.BaseAPI implements Workfl
     /**
      * List Workflow Memory Chunks Handler
      */
-    listWorkflowMemoryChunksRaw(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ListMemoryChunksResponse>>;
+    listWorkflowMemoryChunksRaw(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseMemoryChunkResponse>>;
     /**
      * List Workflow Memory Chunks Handler
      */
-    listWorkflowMemoryChunks(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ListMemoryChunksResponse>;
+    listWorkflowMemoryChunks(requestParameters: ListWorkflowMemoryChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseMemoryChunkResponse>;
 }

package/dist/apis/WorkflowMemoryApi.js

@@ -91,7 +91,6 @@ class WorkflowMemoryApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Append a new memory chunk.  Exposed for external agents (e.g. self-hosted runners) that need to capture learnings without touching the DB directly. The new chunk\'s ``chunk_id`` is server-assigned. Each call snapshots a new DocumentVersion, just like edit/forget.
      * Append Workflow Memory Chunk Handler
      */
     appendWorkflowMemoryChunkRaw(requestParameters, initOverrides) {
@@ -102,7 +101,6 @@ class WorkflowMemoryApi extends runtime.BaseAPI {
         });
     }
     /**
-     * Append a new memory chunk.  Exposed for external agents (e.g. self-hosted runners) that need to capture learnings without touching the DB directly. The new chunk\'s ``chunk_id`` is server-assigned. Each call snapshots a new DocumentVersion, just like edit/forget.
      * Append Workflow Memory Chunk Handler
      */
     appendWorkflowMemoryChunk(requestParameters, initOverrides) {
@@ -262,6 +260,12 @@ class WorkflowMemoryApi extends runtime.BaseAPI {
                 throw new runtime.RequiredError('definitionId', 'Required parameter "definitionId" was null or undefined when calling listWorkflowMemoryChunks().');
             }
             const queryParameters = {};
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
+            if (requestParameters['offset'] != null) {
+                queryParameters['offset'] = requestParameters['offset'];
+            }
             const headerParameters = {};
             if (requestParameters['authorization'] != null) {
                 headerParameters['authorization'] = String(requestParameters['authorization']);
@@ -283,7 +287,7 @@ class WorkflowMemoryApi extends runtime.BaseAPI {
         return __awaiter(this, void 0, void 0, function* () {
             const requestOptions = yield this.listWorkflowMemoryChunksRequestOpts(requestParameters);
             const response = yield this.request(requestOptions, initOverrides);
-            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.ListMemoryChunksResponseFromJSON)(jsonValue));
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PaginatedResponseMemoryChunkResponseFromJSON)(jsonValue));
         });
     }
     /**