@knowledge-stack/ksapi 1.111.0 → 1.112.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (93) hide show
  1. package/.openapi-generator/FILES +6 -0
  2. package/README.md +6 -2
  3. package/dist/apis/DataSourcesApi.d.ts +46 -5
  4. package/dist/apis/DataSourcesApi.js +53 -2
  5. package/dist/apis/DocumentVersionsApi.d.ts +4 -4
  6. package/dist/apis/DocumentVersionsApi.js +2 -2
  7. package/dist/apis/WorkflowDefinitionsApi.d.ts +6 -0
  8. package/dist/apis/WorkflowDefinitionsApi.js +6 -0
  9. package/dist/apis/WorkflowRunsApi.d.ts +4 -4
  10. package/dist/apis/WorkflowRunsApi.js +2 -2
  11. package/dist/esm/apis/DataSourcesApi.d.ts +46 -5
  12. package/dist/esm/apis/DataSourcesApi.js +54 -3
  13. package/dist/esm/apis/DocumentVersionsApi.d.ts +4 -4
  14. package/dist/esm/apis/DocumentVersionsApi.js +2 -2
  15. package/dist/esm/apis/WorkflowDefinitionsApi.d.ts +6 -0
  16. package/dist/esm/apis/WorkflowDefinitionsApi.js +6 -0
  17. package/dist/esm/apis/WorkflowRunsApi.d.ts +4 -4
  18. package/dist/esm/apis/WorkflowRunsApi.js +2 -2
  19. package/dist/esm/models/CatalogColumnResponse.d.ts +7 -0
  20. package/dist/esm/models/CatalogColumnResponse.js +3 -0
  21. package/dist/esm/models/CatalogTableResponse.d.ts +6 -0
  22. package/dist/esm/models/CatalogTableResponse.js +4 -0
  23. package/dist/esm/models/ColumnConfig.d.ts +7 -0
  24. package/dist/esm/models/ColumnConfig.js +3 -0
  25. package/dist/esm/models/ColumnReference.d.ts +59 -0
  26. package/dist/esm/models/ColumnReference.js +50 -0
  27. package/dist/esm/models/DataSourceSchemaListResponse.d.ts +48 -0
  28. package/dist/esm/models/DataSourceSchemaListResponse.js +45 -0
  29. package/dist/esm/models/DataSourceSchemaResponse.d.ts +53 -0
  30. package/dist/esm/models/DataSourceSchemaResponse.js +48 -0
  31. package/dist/esm/models/DataSourceTableResponse.d.ts +6 -0
  32. package/dist/esm/models/DataSourceTableResponse.js +2 -0
  33. package/dist/esm/models/ModelTableRequest.d.ts +6 -0
  34. package/dist/esm/models/ModelTableRequest.js +2 -0
  35. package/dist/esm/models/UpdateWorkflowRunRequest.d.ts +12 -0
  36. package/dist/esm/models/UpdateWorkflowRunRequest.js +7 -0
  37. package/dist/esm/models/WorkflowRunResponse.d.ts +12 -0
  38. package/dist/esm/models/WorkflowRunResponse.js +6 -0
  39. package/dist/esm/models/index.d.ts +3 -0
  40. package/dist/esm/models/index.js +3 -0
  41. package/dist/models/CatalogColumnResponse.d.ts +7 -0
  42. package/dist/models/CatalogColumnResponse.js +3 -0
  43. package/dist/models/CatalogTableResponse.d.ts +6 -0
  44. package/dist/models/CatalogTableResponse.js +4 -0
  45. package/dist/models/ColumnConfig.d.ts +7 -0
  46. package/dist/models/ColumnConfig.js +3 -0
  47. package/dist/models/ColumnReference.d.ts +59 -0
  48. package/dist/models/ColumnReference.js +58 -0
  49. package/dist/models/DataSourceSchemaListResponse.d.ts +48 -0
  50. package/dist/models/DataSourceSchemaListResponse.js +53 -0
  51. package/dist/models/DataSourceSchemaResponse.d.ts +53 -0
  52. package/dist/models/DataSourceSchemaResponse.js +56 -0
  53. package/dist/models/DataSourceTableResponse.d.ts +6 -0
  54. package/dist/models/DataSourceTableResponse.js +2 -0
  55. package/dist/models/ModelTableRequest.d.ts +6 -0
  56. package/dist/models/ModelTableRequest.js +2 -0
  57. package/dist/models/UpdateWorkflowRunRequest.d.ts +12 -0
  58. package/dist/models/UpdateWorkflowRunRequest.js +7 -0
  59. package/dist/models/WorkflowRunResponse.d.ts +12 -0
  60. package/dist/models/WorkflowRunResponse.js +6 -0
  61. package/dist/models/index.d.ts +3 -0
  62. package/dist/models/index.js +3 -0
  63. package/docs/CatalogColumnResponse.md +2 -0
  64. package/docs/CatalogTableResponse.md +2 -0
  65. package/docs/ColumnConfig.md +2 -0
  66. package/docs/ColumnReference.md +39 -0
  67. package/docs/DataSourceSchemaListResponse.md +35 -0
  68. package/docs/DataSourceSchemaResponse.md +36 -0
  69. package/docs/DataSourceTableResponse.md +2 -0
  70. package/docs/DataSourcesApi.md +81 -2
  71. package/docs/DocumentVersionsApi.md +1 -1
  72. package/docs/FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceTableResponseOrApiConnectionResponse.md +6 -0
  73. package/docs/ModelTableRequest.md +2 -0
  74. package/docs/UpdateWorkflowRunRequest.md +4 -0
  75. package/docs/WorkflowDefinitionsApi.md +7 -1
  76. package/docs/WorkflowRunResponse.md +4 -0
  77. package/docs/WorkflowRunsApi.md +1 -1
  78. package/package.json +1 -1
  79. package/src/apis/DataSourcesApi.ts +97 -4
  80. package/src/apis/DocumentVersionsApi.ts +4 -4
  81. package/src/apis/WorkflowDefinitionsApi.ts +14 -0
  82. package/src/apis/WorkflowRunsApi.ts +4 -4
  83. package/src/models/CatalogColumnResponse.ts +16 -0
  84. package/src/models/CatalogTableResponse.ts +9 -0
  85. package/src/models/ColumnConfig.ts +16 -0
  86. package/src/models/ColumnReference.ts +100 -0
  87. package/src/models/DataSourceSchemaListResponse.ts +91 -0
  88. package/src/models/DataSourceSchemaResponse.ts +92 -0
  89. package/src/models/DataSourceTableResponse.ts +8 -0
  90. package/src/models/ModelTableRequest.ts +8 -0
  91. package/src/models/UpdateWorkflowRunRequest.ts +19 -0
  92. package/src/models/WorkflowRunResponse.ts +17 -0
  93. package/src/models/index.ts +3 -0
@@ -297,7 +297,7 @@ export interface DocumentVersionsApiInterface {
297
297
  */
298
298
  updateDocumentVersionMetadataRequestOpts(requestParameters: UpdateDocumentVersionMetadataRequest): Promise<runtime.RequestOpts>;
299
299
  /**
300
- * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
300
+ * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved. When this PATCH settles an ``inputs/`` upload\'s ingestion (an in-progress pipeline reaching a terminal state), it drives the parent workflow run forward: the two-step ``PENDING <-> NOT_STARTED`` toggle, plus auto-start / auto-fail for an ``auto_start`` run (see ``WorkflowRunStartService.auto_advance_on_input_settled``).
301
301
  * @summary Update Document Version Metadata Handler
302
302
  * @param {string} versionId DocumentVersion ID
303
303
  * @param {DocumentVersionMetadataUpdate} documentVersionMetadataUpdate
@@ -307,7 +307,7 @@ export interface DocumentVersionsApiInterface {
307
307
  */
308
308
  updateDocumentVersionMetadataRaw(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentVersionResponse>>;
309
309
  /**
310
- * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
310
+ * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved. When this PATCH settles an ``inputs/`` upload\'s ingestion (an in-progress pipeline reaching a terminal state), it drives the parent workflow run forward: the two-step ``PENDING <-> NOT_STARTED`` toggle, plus auto-start / auto-fail for an ``auto_start`` run (see ``WorkflowRunStartService.auto_advance_on_input_settled``).
311
311
  * Update Document Version Metadata Handler
312
312
  */
313
313
  updateDocumentVersionMetadata(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
@@ -445,12 +445,12 @@ export declare class DocumentVersionsApi extends runtime.BaseAPI implements Docu
445
445
  */
446
446
  updateDocumentVersionMetadataRequestOpts(requestParameters: UpdateDocumentVersionMetadataRequest): Promise<runtime.RequestOpts>;
447
447
  /**
448
- * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
448
+ * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved. When this PATCH settles an ``inputs/`` upload\'s ingestion (an in-progress pipeline reaching a terminal state), it drives the parent workflow run forward: the two-step ``PENDING <-> NOT_STARTED`` toggle, plus auto-start / auto-fail for an ``auto_start`` run (see ``WorkflowRunStartService.auto_advance_on_input_settled``).
449
449
  * Update Document Version Metadata Handler
450
450
  */
451
451
  updateDocumentVersionMetadataRaw(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentVersionResponse>>;
452
452
  /**
453
- * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
453
+ * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved. When this PATCH settles an ``inputs/`` upload\'s ingestion (an in-progress pipeline reaching a terminal state), it drives the parent workflow run forward: the two-step ``PENDING <-> NOT_STARTED`` toggle, plus auto-start / auto-fail for an ``auto_start`` run (see ``WorkflowRunStartService.auto_advance_on_input_settled``).
454
454
  * Update Document Version Metadata Handler
455
455
  */
456
456
  updateDocumentVersionMetadata(requestParameters: UpdateDocumentVersionMetadataRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentVersionResponse>;
@@ -544,7 +544,7 @@ export class DocumentVersionsApi extends runtime.BaseAPI {
544
544
  });
545
545
  }
546
546
  /**
547
- * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
547
+ * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved. When this PATCH settles an ``inputs/`` upload\'s ingestion (an in-progress pipeline reaching a terminal state), it drives the parent workflow run forward: the two-step ``PENDING <-> NOT_STARTED`` toggle, plus auto-start / auto-fail for an ``auto_start`` run (see ``WorkflowRunStartService.auto_advance_on_input_settled``).
548
548
  * Update Document Version Metadata Handler
549
549
  */
550
550
  updateDocumentVersionMetadataRaw(requestParameters, initOverrides) {
@@ -555,7 +555,7 @@ export class DocumentVersionsApi extends runtime.BaseAPI {
555
555
  });
556
556
  }
557
557
  /**
558
- * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved.
558
+ * Merge metadata fields into an existing document version\'s metadata. Only non-null fields in the request body are merged; existing metadata fields not present in the request are preserved. When this PATCH settles an ``inputs/`` upload\'s ingestion (an in-progress pipeline reaching a terminal state), it drives the parent workflow run forward: the two-step ``PENDING <-> NOT_STARTED`` toggle, plus auto-start / auto-fail for an ``auto_start`` run (see ``WorkflowRunStartService.auto_advance_on_input_settled``).
559
559
  * Update Document Version Metadata Handler
560
560
  */
561
561
  updateDocumentVersionMetadata(requestParameters, initOverrides) {
@@ -19,6 +19,8 @@ export interface CreateWorkflowRunRequest {
19
19
  files?: Array<Blob>;
20
20
  inputScope?: string | null;
21
21
  idempotencyKey?: string | null;
22
+ autoStart?: boolean;
23
+ userMessage?: string | null;
22
24
  }
23
25
  export interface DeleteWorkflowDefinitionRequest {
24
26
  definitionId: string;
@@ -90,6 +92,8 @@ export interface WorkflowDefinitionsApiInterface {
90
92
  * @param {Array<Blob>} [files] DEPRECATED — do not send files here. Carrying file bytes on run creation makes the call block on synchronous S3 upload (the ~30s \\\&#39;Create run\\\&#39; wait). Instead create an empty draft (omit this field), then upload each file to the run\\\&#39;s &#x60;&#x60;inputs/&#x60;&#x60; folder via &#x60;&#x60;POST /v1/documents/ingest&#x60;&#x60; with &#x60;&#x60;path_part_id&#x60;&#x60; set to the run\\\&#39;s &#x60;&#x60;inputs_path_part_id&#x60;&#x60;; that path ingests asynchronously and auto-syncs the run\\\&#39;s state. This field will be removed once the FE has migrated.
91
93
  * @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, pinned onto the new draft\\\&#39;s input scope. Optional — omit for an empty draft and add references later via PATCH.
92
94
  * @param {string} [idempotencyKey] Optional key to prevent duplicate runs from retries.
95
+ * @param {boolean} [autoStart] When true, the run starts itself once its &#x60;&#x60;inputs/&#x60;&#x60; uploads finish ingesting — eliminating the separate Start call. If an upload\\\&#39;s ingestion fails, the run is marked FAILED. Default false (two-step flow). Arm only after all uploads are queued; a synchronously-completing first upload would otherwise start the run before later uploads are added.
96
+ * @param {string} [userMessage] Optional note carried to the auto-start dispatch (the equivalent of the Start endpoint\\\&#39;s &#x60;&#x60;user_message&#x60;&#x60; for a self-starting run). Applied only when &#x60;&#x60;auto_start&#x60;&#x60; fires.
93
97
  * @throws {RequiredError}
94
98
  * @memberof WorkflowDefinitionsApiInterface
95
99
  */
@@ -101,6 +105,8 @@ export interface WorkflowDefinitionsApiInterface {
101
105
  * @param {Array<Blob>} [files] DEPRECATED — do not send files here. Carrying file bytes on run creation makes the call block on synchronous S3 upload (the ~30s \\\&#39;Create run\\\&#39; wait). Instead create an empty draft (omit this field), then upload each file to the run\\\&#39;s &#x60;&#x60;inputs/&#x60;&#x60; folder via &#x60;&#x60;POST /v1/documents/ingest&#x60;&#x60; with &#x60;&#x60;path_part_id&#x60;&#x60; set to the run\\\&#39;s &#x60;&#x60;inputs_path_part_id&#x60;&#x60;; that path ingests asynchronously and auto-syncs the run\\\&#39;s state. This field will be removed once the FE has migrated.
102
106
  * @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, pinned onto the new draft\\\&#39;s input scope. Optional — omit for an empty draft and add references later via PATCH.
103
107
  * @param {string} [idempotencyKey] Optional key to prevent duplicate runs from retries.
108
+ * @param {boolean} [autoStart] When true, the run starts itself once its &#x60;&#x60;inputs/&#x60;&#x60; uploads finish ingesting — eliminating the separate Start call. If an upload\\\&#39;s ingestion fails, the run is marked FAILED. Default false (two-step flow). Arm only after all uploads are queued; a synchronously-completing first upload would otherwise start the run before later uploads are added.
109
+ * @param {string} [userMessage] Optional note carried to the auto-start dispatch (the equivalent of the Start endpoint\\\&#39;s &#x60;&#x60;user_message&#x60;&#x60; for a self-starting run). Applied only when &#x60;&#x60;auto_start&#x60;&#x60; fires.
104
110
  * @param {*} [options] Override http request option.
105
111
  * @throws {RequiredError}
106
112
  * @memberof WorkflowDefinitionsApiInterface
@@ -116,6 +116,12 @@ export class WorkflowDefinitionsApi extends runtime.BaseAPI {
116
116
  if (requestParameters['idempotencyKey'] != null) {
117
117
  formParams.append('idempotency_key', requestParameters['idempotencyKey']);
118
118
  }
119
+ if (requestParameters['autoStart'] != null) {
120
+ formParams.append('auto_start', requestParameters['autoStart']);
121
+ }
122
+ if (requestParameters['userMessage'] != null) {
123
+ formParams.append('user_message', requestParameters['userMessage']);
124
+ }
119
125
  let urlPath = `/v1/workflow-definitions/{definition_id}/runs`;
120
126
  urlPath = urlPath.replace(`{${"definition_id"}}`, encodeURIComponent(String(requestParameters['definitionId'])));
121
127
  return {
@@ -300,7 +300,7 @@ export interface WorkflowRunsApiInterface {
300
300
  */
301
301
  updateWorkflowRunRequestOpts(requestParameters: UpdateWorkflowRunOperationRequest): Promise<runtime.RequestOpts>;
302
302
  /**
303
- * Edit a NOT_STARTED run\'s KB scope and / or display name. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
303
+ * Edit a NOT_STARTED run\'s KB scope, name, and / or auto_start. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` or ``PENDING`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation. Arming ``auto_start`` on a run that is already ``NOT_STARTED`` (its inputs have settled) dispatches it immediately — the run would otherwise never receive an ingestion-completion hook to start it. A ``PENDING`` run is left to auto-advance when its uploads finish.
304
304
  * @summary Update Workflow Run Handler
305
305
  * @param {string} runId
306
306
  * @param {UpdateWorkflowRunRequest} updateWorkflowRunRequest
@@ -310,7 +310,7 @@ export interface WorkflowRunsApiInterface {
310
310
  */
311
311
  updateWorkflowRunRaw(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
312
312
  /**
313
- * Edit a NOT_STARTED run\'s KB scope and / or display name. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
313
+ * Edit a NOT_STARTED run\'s KB scope, name, and / or auto_start. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` or ``PENDING`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation. Arming ``auto_start`` on a run that is already ``NOT_STARTED`` (its inputs have settled) dispatches it immediately — the run would otherwise never receive an ingestion-completion hook to start it. A ``PENDING`` run is left to auto-advance when its uploads finish.
314
314
  * Update Workflow Run Handler
315
315
  */
316
316
  updateWorkflowRun(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
@@ -469,12 +469,12 @@ export declare class WorkflowRunsApi extends runtime.BaseAPI implements Workflow
469
469
  */
470
470
  updateWorkflowRunRequestOpts(requestParameters: UpdateWorkflowRunOperationRequest): Promise<runtime.RequestOpts>;
471
471
  /**
472
- * Edit a NOT_STARTED run\'s KB scope and / or display name. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
472
+ * Edit a NOT_STARTED run\'s KB scope, name, and / or auto_start. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` or ``PENDING`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation. Arming ``auto_start`` on a run that is already ``NOT_STARTED`` (its inputs have settled) dispatches it immediately — the run would otherwise never receive an ingestion-completion hook to start it. A ``PENDING`` run is left to auto-advance when its uploads finish.
473
473
  * Update Workflow Run Handler
474
474
  */
475
475
  updateWorkflowRunRaw(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<WorkflowRunResponse>>;
476
476
  /**
477
- * Edit a NOT_STARTED run\'s KB scope and / or display name. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
477
+ * Edit a NOT_STARTED run\'s KB scope, name, and / or auto_start. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` or ``PENDING`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation. Arming ``auto_start`` on a run that is already ``NOT_STARTED`` (its inputs have settled) dispatches it immediately — the run would otherwise never receive an ingestion-completion hook to start it. A ``PENDING`` run is left to auto-advance when its uploads finish.
478
478
  * Update Workflow Run Handler
479
479
  */
480
480
  updateWorkflowRun(requestParameters: UpdateWorkflowRunOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<WorkflowRunResponse>;
@@ -538,7 +538,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
538
538
  });
539
539
  }
540
540
  /**
541
- * Edit a NOT_STARTED run\'s KB scope and / or display name. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
541
+ * Edit a NOT_STARTED run\'s KB scope, name, and / or auto_start. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` or ``PENDING`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation. Arming ``auto_start`` on a run that is already ``NOT_STARTED`` (its inputs have settled) dispatches it immediately — the run would otherwise never receive an ingestion-completion hook to start it. A ``PENDING`` run is left to auto-advance when its uploads finish.
542
542
  * Update Workflow Run Handler
543
543
  */
544
544
  updateWorkflowRunRaw(requestParameters, initOverrides) {
@@ -549,7 +549,7 @@ export class WorkflowRunsApi extends runtime.BaseAPI {
549
549
  });
550
550
  }
551
551
  /**
552
- * Edit a NOT_STARTED run\'s KB scope and / or display name. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation.
552
+ * Edit a NOT_STARTED run\'s KB scope, name, and / or auto_start. Both body fields are optional but at least one must be present. The run must be ``NOT_STARTED`` or ``PENDING`` (409 otherwise). Caller must be the triggerer or OWNER/ADMIN (403 otherwise). A name collision with a sibling run under the same definition\'s ``runs/`` folder maps to a 409 via ``IntegrityError`` translation. Arming ``auto_start`` on a run that is already ``NOT_STARTED`` (its inputs have settled) dispatches it immediately — the run would otherwise never receive an ingestion-completion hook to start it. A ``PENDING`` run is left to auto-advance when its uploads finish.
553
553
  * Update Workflow Run Handler
554
554
  */
555
555
  updateWorkflowRun(requestParameters, initOverrides) {
@@ -9,6 +9,7 @@
9
9
  * https://openapi-generator.tech
10
10
  * Do not edit the class manually.
11
11
  */
12
+ import type { ColumnReference } from './ColumnReference';
12
13
  /**
13
14
  *
14
15
  * @export
@@ -33,6 +34,12 @@ export interface CatalogColumnResponse {
33
34
  * @memberof CatalogColumnResponse
34
35
  */
35
36
  isPk: boolean;
37
+ /**
38
+ *
39
+ * @type {ColumnReference}
40
+ * @memberof CatalogColumnResponse
41
+ */
42
+ references?: ColumnReference | null;
36
43
  }
37
44
  export declare const CatalogColumnResponsePropertyValidationAttributesMap: {
38
45
  [property: string]: {
@@ -11,6 +11,7 @@
11
11
  * https://openapi-generator.tech
12
12
  * Do not edit the class manually.
13
13
  */
14
+ import { ColumnReferenceFromJSON, ColumnReferenceToJSON, } from './ColumnReference';
14
15
  export const CatalogColumnResponsePropertyValidationAttributesMap = {};
15
16
  /**
16
17
  * Check if a given object implements the CatalogColumnResponse interface.
@@ -35,6 +36,7 @@ export function CatalogColumnResponseFromJSONTyped(json, ignoreDiscriminator) {
35
36
  'name': json['name'],
36
37
  'dataType': json['data_type'],
37
38
  'isPk': json['is_pk'],
39
+ 'references': json['references'] == null ? undefined : ColumnReferenceFromJSON(json['references']),
38
40
  };
39
41
  }
40
42
  export function CatalogColumnResponseToJSON(json) {
@@ -48,5 +50,6 @@ export function CatalogColumnResponseToJSONTyped(value, ignoreDiscriminator = fa
48
50
  'name': value['name'],
49
51
  'data_type': value['dataType'],
50
52
  'is_pk': value['isPk'],
53
+ 'references': ColumnReferenceToJSON(value['references']),
51
54
  };
52
55
  }
@@ -22,6 +22,12 @@ export interface CatalogTableResponse {
22
22
  * @memberof CatalogTableResponse
23
23
  */
24
24
  name: string;
25
+ /**
26
+ *
27
+ * @type {string}
28
+ * @memberof CatalogTableResponse
29
+ */
30
+ schemaName: string;
25
31
  /**
26
32
  *
27
33
  * @type {Array<CatalogColumnResponse>}
@@ -19,6 +19,8 @@ export const CatalogTableResponsePropertyValidationAttributesMap = {};
19
19
  export function instanceOfCatalogTableResponse(value) {
20
20
  if (!('name' in value) || value['name'] === undefined)
21
21
  return false;
22
+ if (!('schemaName' in value) || value['schemaName'] === undefined)
23
+ return false;
22
24
  if (!('columns' in value) || value['columns'] === undefined)
23
25
  return false;
24
26
  return true;
@@ -32,6 +34,7 @@ export function CatalogTableResponseFromJSONTyped(json, ignoreDiscriminator) {
32
34
  }
33
35
  return {
34
36
  'name': json['name'],
37
+ 'schemaName': json['schema_name'],
35
38
  'columns': (json['columns'].map(CatalogColumnResponseFromJSON)),
36
39
  };
37
40
  }
@@ -44,6 +47,7 @@ export function CatalogTableResponseToJSONTyped(value, ignoreDiscriminator = fal
44
47
  }
45
48
  return {
46
49
  'name': value['name'],
50
+ 'schema_name': value['schemaName'],
47
51
  'columns': (value['columns'].map(CatalogColumnResponseToJSON)),
48
52
  };
49
53
  }
@@ -9,6 +9,7 @@
9
9
  * https://openapi-generator.tech
10
10
  * Do not edit the class manually.
11
11
  */
12
+ import type { ColumnReference } from './ColumnReference';
12
13
  /**
13
14
  * A modeled column. Only ``exposed`` columns are surfaced to the agent.
14
15
  * @export
@@ -45,6 +46,12 @@ export interface ColumnConfig {
45
46
  * @memberof ColumnConfig
46
47
  */
47
48
  exposed?: boolean;
49
+ /**
50
+ *
51
+ * @type {ColumnReference}
52
+ * @memberof ColumnConfig
53
+ */
54
+ references?: ColumnReference | null;
48
55
  }
49
56
  export declare const ColumnConfigPropertyValidationAttributesMap: {
50
57
  [property: string]: {
@@ -11,6 +11,7 @@
11
11
  * https://openapi-generator.tech
12
12
  * Do not edit the class manually.
13
13
  */
14
+ import { ColumnReferenceFromJSON, ColumnReferenceToJSON, } from './ColumnReference';
14
15
  export const ColumnConfigPropertyValidationAttributesMap = {};
15
16
  /**
16
17
  * Check if a given object implements the ColumnConfig interface.
@@ -33,6 +34,7 @@ export function ColumnConfigFromJSONTyped(json, ignoreDiscriminator) {
33
34
  'comment': json['comment'] == null ? undefined : json['comment'],
34
35
  'isPk': json['is_pk'] == null ? undefined : json['is_pk'],
35
36
  'exposed': json['exposed'] == null ? undefined : json['exposed'],
37
+ 'references': json['references'] == null ? undefined : ColumnReferenceFromJSON(json['references']),
36
38
  };
37
39
  }
38
40
  export function ColumnConfigToJSON(json) {
@@ -48,5 +50,6 @@ export function ColumnConfigToJSONTyped(value, ignoreDiscriminator = false) {
48
50
  'comment': value['comment'],
49
51
  'is_pk': value['isPk'],
50
52
  'exposed': value['exposed'],
53
+ 'references': ColumnReferenceToJSON(value['references']),
51
54
  };
52
55
  }
@@ -0,0 +1,59 @@
1
+ /**
2
+ * Knowledge Stack API
3
+ * Knowledge Stack backend API for authentication and knowledge management
4
+ *
5
+ * The version of the OpenAPI document: 0.1.0
6
+ *
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ /**
13
+ * The table+column a foreign-key column points at.
14
+ * @export
15
+ * @interface ColumnReference
16
+ */
17
+ export interface ColumnReference {
18
+ /**
19
+ *
20
+ * @type {string}
21
+ * @memberof ColumnReference
22
+ */
23
+ schemaName?: string | null;
24
+ /**
25
+ *
26
+ * @type {string}
27
+ * @memberof ColumnReference
28
+ */
29
+ table: string;
30
+ /**
31
+ *
32
+ * @type {string}
33
+ * @memberof ColumnReference
34
+ */
35
+ column: string;
36
+ }
37
+ export declare const ColumnReferencePropertyValidationAttributesMap: {
38
+ [property: string]: {
39
+ maxLength?: number;
40
+ minLength?: number;
41
+ pattern?: string;
42
+ maximum?: number;
43
+ exclusiveMaximum?: boolean;
44
+ minimum?: number;
45
+ exclusiveMinimum?: boolean;
46
+ multipleOf?: number;
47
+ maxItems?: number;
48
+ minItems?: number;
49
+ uniqueItems?: boolean;
50
+ };
51
+ };
52
+ /**
53
+ * Check if a given object implements the ColumnReference interface.
54
+ */
55
+ export declare function instanceOfColumnReference(value: object): value is ColumnReference;
56
+ export declare function ColumnReferenceFromJSON(json: any): ColumnReference;
57
+ export declare function ColumnReferenceFromJSONTyped(json: any, ignoreDiscriminator: boolean): ColumnReference;
58
+ export declare function ColumnReferenceToJSON(json: any): ColumnReference;
59
+ export declare function ColumnReferenceToJSONTyped(value?: ColumnReference | null, ignoreDiscriminator?: boolean): any;
@@ -0,0 +1,50 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * Knowledge Stack API
5
+ * Knowledge Stack backend API for authentication and knowledge management
6
+ *
7
+ * The version of the OpenAPI document: 0.1.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+ export const ColumnReferencePropertyValidationAttributesMap = {};
15
+ /**
16
+ * Check if a given object implements the ColumnReference interface.
17
+ */
18
+ export function instanceOfColumnReference(value) {
19
+ if (!('table' in value) || value['table'] === undefined)
20
+ return false;
21
+ if (!('column' in value) || value['column'] === undefined)
22
+ return false;
23
+ return true;
24
+ }
25
+ export function ColumnReferenceFromJSON(json) {
26
+ return ColumnReferenceFromJSONTyped(json, false);
27
+ }
28
+ export function ColumnReferenceFromJSONTyped(json, ignoreDiscriminator) {
29
+ if (json == null) {
30
+ return json;
31
+ }
32
+ return {
33
+ 'schemaName': json['schema_name'] == null ? undefined : json['schema_name'],
34
+ 'table': json['table'],
35
+ 'column': json['column'],
36
+ };
37
+ }
38
+ export function ColumnReferenceToJSON(json) {
39
+ return ColumnReferenceToJSONTyped(json, false);
40
+ }
41
+ export function ColumnReferenceToJSONTyped(value, ignoreDiscriminator = false) {
42
+ if (value == null) {
43
+ return value;
44
+ }
45
+ return {
46
+ 'schema_name': value['schemaName'],
47
+ 'table': value['table'],
48
+ 'column': value['column'],
49
+ };
50
+ }
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Knowledge Stack API
3
+ * Knowledge Stack backend API for authentication and knowledge management
4
+ *
5
+ * The version of the OpenAPI document: 0.1.0
6
+ *
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ import type { DataSourceSchemaResponse } from './DataSourceSchemaResponse';
13
+ /**
14
+ * The source's user namespaces (PG schemas / MySQL databases).
15
+ * @export
16
+ * @interface DataSourceSchemaListResponse
17
+ */
18
+ export interface DataSourceSchemaListResponse {
19
+ /**
20
+ *
21
+ * @type {Array<DataSourceSchemaResponse>}
22
+ * @memberof DataSourceSchemaListResponse
23
+ */
24
+ schemas: Array<DataSourceSchemaResponse>;
25
+ }
26
+ export declare const DataSourceSchemaListResponsePropertyValidationAttributesMap: {
27
+ [property: string]: {
28
+ maxLength?: number;
29
+ minLength?: number;
30
+ pattern?: string;
31
+ maximum?: number;
32
+ exclusiveMaximum?: boolean;
33
+ minimum?: number;
34
+ exclusiveMinimum?: boolean;
35
+ multipleOf?: number;
36
+ maxItems?: number;
37
+ minItems?: number;
38
+ uniqueItems?: boolean;
39
+ };
40
+ };
41
+ /**
42
+ * Check if a given object implements the DataSourceSchemaListResponse interface.
43
+ */
44
+ export declare function instanceOfDataSourceSchemaListResponse(value: object): value is DataSourceSchemaListResponse;
45
+ export declare function DataSourceSchemaListResponseFromJSON(json: any): DataSourceSchemaListResponse;
46
+ export declare function DataSourceSchemaListResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): DataSourceSchemaListResponse;
47
+ export declare function DataSourceSchemaListResponseToJSON(json: any): DataSourceSchemaListResponse;
48
+ export declare function DataSourceSchemaListResponseToJSONTyped(value?: DataSourceSchemaListResponse | null, ignoreDiscriminator?: boolean): any;
@@ -0,0 +1,45 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * Knowledge Stack API
5
+ * Knowledge Stack backend API for authentication and knowledge management
6
+ *
7
+ * The version of the OpenAPI document: 0.1.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+ import { DataSourceSchemaResponseFromJSON, DataSourceSchemaResponseToJSON, } from './DataSourceSchemaResponse';
15
+ export const DataSourceSchemaListResponsePropertyValidationAttributesMap = {};
16
+ /**
17
+ * Check if a given object implements the DataSourceSchemaListResponse interface.
18
+ */
19
+ export function instanceOfDataSourceSchemaListResponse(value) {
20
+ if (!('schemas' in value) || value['schemas'] === undefined)
21
+ return false;
22
+ return true;
23
+ }
24
+ export function DataSourceSchemaListResponseFromJSON(json) {
25
+ return DataSourceSchemaListResponseFromJSONTyped(json, false);
26
+ }
27
+ export function DataSourceSchemaListResponseFromJSONTyped(json, ignoreDiscriminator) {
28
+ if (json == null) {
29
+ return json;
30
+ }
31
+ return {
32
+ 'schemas': (json['schemas'].map(DataSourceSchemaResponseFromJSON)),
33
+ };
34
+ }
35
+ export function DataSourceSchemaListResponseToJSON(json) {
36
+ return DataSourceSchemaListResponseToJSONTyped(json, false);
37
+ }
38
+ export function DataSourceSchemaListResponseToJSONTyped(value, ignoreDiscriminator = false) {
39
+ if (value == null) {
40
+ return value;
41
+ }
42
+ return {
43
+ 'schemas': (value['schemas'].map(DataSourceSchemaResponseToJSON)),
44
+ };
45
+ }
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Knowledge Stack API
3
+ * Knowledge Stack backend API for authentication and knowledge management
4
+ *
5
+ * The version of the OpenAPI document: 0.1.0
6
+ *
7
+ *
8
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
9
+ * https://openapi-generator.tech
10
+ * Do not edit the class manually.
11
+ */
12
+ /**
13
+ *
14
+ * @export
15
+ * @interface DataSourceSchemaResponse
16
+ */
17
+ export interface DataSourceSchemaResponse {
18
+ /**
19
+ *
20
+ * @type {string}
21
+ * @memberof DataSourceSchemaResponse
22
+ */
23
+ name: string;
24
+ /**
25
+ *
26
+ * @type {boolean}
27
+ * @memberof DataSourceSchemaResponse
28
+ */
29
+ isDefault: boolean;
30
+ }
31
+ export declare const DataSourceSchemaResponsePropertyValidationAttributesMap: {
32
+ [property: string]: {
33
+ maxLength?: number;
34
+ minLength?: number;
35
+ pattern?: string;
36
+ maximum?: number;
37
+ exclusiveMaximum?: boolean;
38
+ minimum?: number;
39
+ exclusiveMinimum?: boolean;
40
+ multipleOf?: number;
41
+ maxItems?: number;
42
+ minItems?: number;
43
+ uniqueItems?: boolean;
44
+ };
45
+ };
46
+ /**
47
+ * Check if a given object implements the DataSourceSchemaResponse interface.
48
+ */
49
+ export declare function instanceOfDataSourceSchemaResponse(value: object): value is DataSourceSchemaResponse;
50
+ export declare function DataSourceSchemaResponseFromJSON(json: any): DataSourceSchemaResponse;
51
+ export declare function DataSourceSchemaResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): DataSourceSchemaResponse;
52
+ export declare function DataSourceSchemaResponseToJSON(json: any): DataSourceSchemaResponse;
53
+ export declare function DataSourceSchemaResponseToJSONTyped(value?: DataSourceSchemaResponse | null, ignoreDiscriminator?: boolean): any;
@@ -0,0 +1,48 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * Knowledge Stack API
5
+ * Knowledge Stack backend API for authentication and knowledge management
6
+ *
7
+ * The version of the OpenAPI document: 0.1.0
8
+ *
9
+ *
10
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
11
+ * https://openapi-generator.tech
12
+ * Do not edit the class manually.
13
+ */
14
+ export const DataSourceSchemaResponsePropertyValidationAttributesMap = {};
15
+ /**
16
+ * Check if a given object implements the DataSourceSchemaResponse interface.
17
+ */
18
+ export function instanceOfDataSourceSchemaResponse(value) {
19
+ if (!('name' in value) || value['name'] === undefined)
20
+ return false;
21
+ if (!('isDefault' in value) || value['isDefault'] === undefined)
22
+ return false;
23
+ return true;
24
+ }
25
+ export function DataSourceSchemaResponseFromJSON(json) {
26
+ return DataSourceSchemaResponseFromJSONTyped(json, false);
27
+ }
28
+ export function DataSourceSchemaResponseFromJSONTyped(json, ignoreDiscriminator) {
29
+ if (json == null) {
30
+ return json;
31
+ }
32
+ return {
33
+ 'name': json['name'],
34
+ 'isDefault': json['is_default'],
35
+ };
36
+ }
37
+ export function DataSourceSchemaResponseToJSON(json) {
38
+ return DataSourceSchemaResponseToJSONTyped(json, false);
39
+ }
40
+ export function DataSourceSchemaResponseToJSONTyped(value, ignoreDiscriminator = false) {
41
+ if (value == null) {
42
+ return value;
43
+ }
44
+ return {
45
+ 'name': value['name'],
46
+ 'is_default': value['isDefault'],
47
+ };
48
+ }
@@ -71,6 +71,12 @@ export interface DataSourceTableResponse {
71
71
  * @memberof DataSourceTableResponse
72
72
  */
73
73
  tableName: string;
74
+ /**
75
+ * Schema/namespace in the external DB; null = default schema
76
+ * @type {string}
77
+ * @memberof DataSourceTableResponse
78
+ */
79
+ schemaName?: string | null;
74
80
  /**
75
81
  *
76
82
  * @type {string}
@@ -71,6 +71,7 @@ export function DataSourceTableResponseFromJSONTyped(json, ignoreDiscriminator)
71
71
  'name': json['name'],
72
72
  'dataSourceId': json['data_source_id'],
73
73
  'tableName': json['table_name'],
74
+ 'schemaName': json['schema_name'] == null ? undefined : json['schema_name'],
74
75
  'description': json['description'],
75
76
  'columnConfig': json['column_config'],
76
77
  'approvalState': PathPartApprovalStateFromJSON(json['approval_state']),
@@ -96,6 +97,7 @@ export function DataSourceTableResponseToJSONTyped(value, ignoreDiscriminator =
96
97
  'name': value['name'],
97
98
  'data_source_id': value['dataSourceId'],
98
99
  'table_name': value['tableName'],
100
+ 'schema_name': value['schemaName'],
99
101
  'description': value['description'],
100
102
  'column_config': value['columnConfig'],
101
103
  'approval_state': PathPartApprovalStateToJSON(value['approvalState']),
@@ -22,6 +22,12 @@ export interface ModelTableRequest {
22
22
  * @memberof ModelTableRequest
23
23
  */
24
24
  tableName: string;
25
+ /**
26
+ * Schema/namespace of the table; omit for the default schema
27
+ * @type {string}
28
+ * @memberof ModelTableRequest
29
+ */
30
+ schemaName?: string | null;
25
31
  /**
26
32
  * Display name; defaults to table_name
27
33
  * @type {string}