@knowledge-stack/ksapi 1.139.0 → 1.140.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 (110) hide show
  1. package/.openapi-generator/FILES +28 -0
  2. package/README.md +25 -11
  3. package/dist/apis/AdminKbApi.d.ts +109 -0
  4. package/dist/apis/AdminKbApi.js +172 -0
  5. package/dist/apis/AdminWorkflowsApi.d.ts +252 -0
  6. package/dist/apis/AdminWorkflowsApi.js +337 -0
  7. package/dist/apis/SkillsApi.d.ts +4 -4
  8. package/dist/apis/SkillsApi.js +2 -2
  9. package/dist/apis/index.d.ts +2 -0
  10. package/dist/apis/index.js +2 -0
  11. package/dist/esm/apis/AdminKbApi.d.ts +109 -0
  12. package/dist/esm/apis/AdminKbApi.js +135 -0
  13. package/dist/esm/apis/AdminWorkflowsApi.d.ts +252 -0
  14. package/dist/esm/apis/AdminWorkflowsApi.js +300 -0
  15. package/dist/esm/apis/SkillsApi.d.ts +4 -4
  16. package/dist/esm/apis/SkillsApi.js +2 -2
  17. package/dist/esm/apis/index.d.ts +2 -0
  18. package/dist/esm/apis/index.js +2 -0
  19. package/dist/esm/models/DefinitionOutputStat.d.ts +65 -0
  20. package/dist/esm/models/DefinitionOutputStat.js +56 -0
  21. package/dist/esm/models/HourHistogramResponse.d.ts +53 -0
  22. package/dist/esm/models/HourHistogramResponse.js +54 -0
  23. package/dist/esm/models/KbMetric.d.ts +26 -0
  24. package/dist/esm/models/KbMetric.js +44 -0
  25. package/dist/esm/models/KbSummaryResponse.d.ts +152 -0
  26. package/dist/esm/models/KbSummaryResponse.js +109 -0
  27. package/dist/esm/models/KbTimeseriesResponse.d.ts +71 -0
  28. package/dist/esm/models/KbTimeseriesResponse.js +57 -0
  29. package/dist/esm/models/LabeledSeries.d.ts +54 -0
  30. package/dist/esm/models/LabeledSeries.js +47 -0
  31. package/dist/esm/models/LeaderboardEntry.d.ts +59 -0
  32. package/dist/esm/models/LeaderboardEntry.js +52 -0
  33. package/dist/esm/models/RunTimeseriesResponse.d.ts +61 -0
  34. package/dist/esm/models/RunTimeseriesResponse.js +52 -0
  35. package/dist/esm/models/SkillResponse.d.ts +7 -0
  36. package/dist/esm/models/SkillResponse.js +3 -0
  37. package/dist/esm/models/TimeBucket.d.ts +27 -0
  38. package/dist/esm/models/TimeBucket.js +45 -0
  39. package/dist/esm/models/TimeseriesPoint.d.ts +53 -0
  40. package/dist/esm/models/TimeseriesPoint.js +48 -0
  41. package/dist/esm/models/WorkflowLeaderboardResponse.d.ts +54 -0
  42. package/dist/esm/models/WorkflowLeaderboardResponse.js +45 -0
  43. package/dist/esm/models/WorkflowOutputStatsResponse.d.ts +54 -0
  44. package/dist/esm/models/WorkflowOutputStatsResponse.js +47 -0
  45. package/dist/esm/models/index.d.ts +12 -0
  46. package/dist/esm/models/index.js +12 -0
  47. package/dist/models/DefinitionOutputStat.d.ts +65 -0
  48. package/dist/models/DefinitionOutputStat.js +64 -0
  49. package/dist/models/HourHistogramResponse.d.ts +53 -0
  50. package/dist/models/HourHistogramResponse.js +62 -0
  51. package/dist/models/KbMetric.d.ts +26 -0
  52. package/dist/models/KbMetric.js +52 -0
  53. package/dist/models/KbSummaryResponse.d.ts +152 -0
  54. package/dist/models/KbSummaryResponse.js +117 -0
  55. package/dist/models/KbTimeseriesResponse.d.ts +71 -0
  56. package/dist/models/KbTimeseriesResponse.js +65 -0
  57. package/dist/models/LabeledSeries.d.ts +54 -0
  58. package/dist/models/LabeledSeries.js +55 -0
  59. package/dist/models/LeaderboardEntry.d.ts +59 -0
  60. package/dist/models/LeaderboardEntry.js +60 -0
  61. package/dist/models/RunTimeseriesResponse.d.ts +61 -0
  62. package/dist/models/RunTimeseriesResponse.js +60 -0
  63. package/dist/models/SkillResponse.d.ts +7 -0
  64. package/dist/models/SkillResponse.js +3 -0
  65. package/dist/models/TimeBucket.d.ts +27 -0
  66. package/dist/models/TimeBucket.js +53 -0
  67. package/dist/models/TimeseriesPoint.d.ts +53 -0
  68. package/dist/models/TimeseriesPoint.js +56 -0
  69. package/dist/models/WorkflowLeaderboardResponse.d.ts +54 -0
  70. package/dist/models/WorkflowLeaderboardResponse.js +53 -0
  71. package/dist/models/WorkflowOutputStatsResponse.d.ts +54 -0
  72. package/dist/models/WorkflowOutputStatsResponse.js +55 -0
  73. package/dist/models/index.d.ts +12 -0
  74. package/dist/models/index.js +12 -0
  75. package/docs/AdminKbApi.md +163 -0
  76. package/docs/AdminWorkflowsApi.md +424 -0
  77. package/docs/DefinitionOutputStat.md +41 -0
  78. package/docs/FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR.md +2 -0
  79. package/docs/HourHistogramResponse.md +37 -0
  80. package/docs/KbMetric.md +33 -0
  81. package/docs/KbSummaryResponse.md +67 -0
  82. package/docs/KbTimeseriesResponse.md +41 -0
  83. package/docs/LabeledSeries.md +37 -0
  84. package/docs/LeaderboardEntry.md +39 -0
  85. package/docs/RunTimeseriesResponse.md +39 -0
  86. package/docs/SkillResponse.md +2 -0
  87. package/docs/SkillsApi.md +1 -1
  88. package/docs/TimeBucket.md +33 -0
  89. package/docs/TimeseriesPoint.md +37 -0
  90. package/docs/WorkflowLeaderboardResponse.md +37 -0
  91. package/docs/WorkflowOutputStatsResponse.md +37 -0
  92. package/package.json +1 -1
  93. package/src/apis/AdminKbApi.ts +237 -0
  94. package/src/apis/AdminWorkflowsApi.ts +539 -0
  95. package/src/apis/SkillsApi.ts +4 -4
  96. package/src/apis/index.ts +2 -0
  97. package/src/models/DefinitionOutputStat.ts +110 -0
  98. package/src/models/HourHistogramResponse.ts +97 -0
  99. package/src/models/KbMetric.ts +54 -0
  100. package/src/models/KbSummaryResponse.ts +235 -0
  101. package/src/models/KbTimeseriesResponse.ts +136 -0
  102. package/src/models/LabeledSeries.ts +99 -0
  103. package/src/models/LeaderboardEntry.ts +101 -0
  104. package/src/models/RunTimeseriesResponse.ts +117 -0
  105. package/src/models/SkillResponse.ts +15 -0
  106. package/src/models/TimeBucket.ts +55 -0
  107. package/src/models/TimeseriesPoint.ts +92 -0
  108. package/src/models/WorkflowLeaderboardResponse.ts +98 -0
  109. package/src/models/WorkflowOutputStatsResponse.ts +99 -0
  110. package/src/models/index.ts +12 -0
@@ -0,0 +1,99 @@
1
+ /* tslint:disable */
2
+ /* eslint-disable */
3
+ /**
4
+ * Knowledge Stack API
5
+ * 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.
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
+
15
+ import { mapValues } from '../runtime';
16
+ import type { DefinitionOutputStat } from './DefinitionOutputStat';
17
+ import {
18
+ DefinitionOutputStatFromJSON,
19
+ DefinitionOutputStatFromJSONTyped,
20
+ DefinitionOutputStatToJSON,
21
+ DefinitionOutputStatToJSONTyped,
22
+ } from './DefinitionOutputStat';
23
+
24
+ /**
25
+ * Avg documents generated per workflow definition (completed runs).
26
+ * @export
27
+ * @interface WorkflowOutputStatsResponse
28
+ */
29
+ export interface WorkflowOutputStatsResponse {
30
+ /**
31
+ *
32
+ * @type {Array<DefinitionOutputStat>}
33
+ * @memberof WorkflowOutputStatsResponse
34
+ */
35
+ perDefinition?: Array<DefinitionOutputStat>;
36
+ /**
37
+ * Mean output DOCUMENTs across all completed runs; null when none.
38
+ * @type {number}
39
+ * @memberof WorkflowOutputStatsResponse
40
+ */
41
+ overallAvg: number | null;
42
+ }
43
+ export const WorkflowOutputStatsResponsePropertyValidationAttributesMap: {
44
+ [property: string]: {
45
+ maxLength?: number,
46
+ minLength?: number,
47
+ pattern?: string,
48
+ maximum?: number,
49
+ exclusiveMaximum?: boolean,
50
+ minimum?: number,
51
+ exclusiveMinimum?: boolean,
52
+ multipleOf?: number,
53
+ maxItems?: number,
54
+ minItems?: number,
55
+ uniqueItems?: boolean
56
+ }
57
+ } = {
58
+ }
59
+
60
+
61
+ /**
62
+ * Check if a given object implements the WorkflowOutputStatsResponse interface.
63
+ */
64
+ export function instanceOfWorkflowOutputStatsResponse(value: object): value is WorkflowOutputStatsResponse {
65
+ if (!('overallAvg' in value) || value['overallAvg'] === undefined) return false;
66
+ return true;
67
+ }
68
+
69
+ export function WorkflowOutputStatsResponseFromJSON(json: any): WorkflowOutputStatsResponse {
70
+ return WorkflowOutputStatsResponseFromJSONTyped(json, false);
71
+ }
72
+
73
+ export function WorkflowOutputStatsResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): WorkflowOutputStatsResponse {
74
+ if (json == null) {
75
+ return json;
76
+ }
77
+ return {
78
+
79
+ 'perDefinition': json['per_definition'] == null ? undefined : ((json['per_definition'] as Array<any>).map(DefinitionOutputStatFromJSON)),
80
+ 'overallAvg': json['overall_avg'],
81
+ };
82
+ }
83
+
84
+ export function WorkflowOutputStatsResponseToJSON(json: any): WorkflowOutputStatsResponse {
85
+ return WorkflowOutputStatsResponseToJSONTyped(json, false);
86
+ }
87
+
88
+ export function WorkflowOutputStatsResponseToJSONTyped(value?: WorkflowOutputStatsResponse | null, ignoreDiscriminator: boolean = false): any {
89
+ if (value == null) {
90
+ return value;
91
+ }
92
+
93
+ return {
94
+
95
+ 'per_definition': value['perDefinition'] == null ? undefined : ((value['perDefinition'] as Array<any>).map(DefinitionOutputStatToJSON)),
96
+ 'overall_avg': value['overallAvg'],
97
+ };
98
+ }
99
+
@@ -82,6 +82,7 @@ export * from './DataSourceSchemaListResponse';
82
82
  export * from './DataSourceSchemaResponse';
83
83
  export * from './DataSourceSyncResponse';
84
84
  export * from './DataSourceTableResponse';
85
+ export * from './DefinitionOutputStat';
85
86
  export * from './DiffFormat';
86
87
  export * from './DiffRow';
87
88
  export * from './DiffRowType';
@@ -133,6 +134,7 @@ export * from './GroupPermissionResponse';
133
134
  export * from './GroupResponse';
134
135
  export * from './HTTPValidationError';
135
136
  export * from './HealthCheckResponse';
137
+ export * from './HourHistogramResponse';
136
138
  export * from './HybridSearchProfile';
137
139
  export * from './IdpConfig';
138
140
  export * from './IdpType';
@@ -152,6 +154,11 @@ export * from './InviteResponse';
152
154
  export * from './InviteStatus';
153
155
  export * from './InviteUserRequest';
154
156
  export * from './ItemPermissions';
157
+ export * from './KbMetric';
158
+ export * from './KbSummaryResponse';
159
+ export * from './KbTimeseriesResponse';
160
+ export * from './LabeledSeries';
161
+ export * from './LeaderboardEntry';
155
162
  export * from './LineageEdgeResponse';
156
163
  export * from './LineageGraphResponse';
157
164
  export * from './LineageNodeResponse';
@@ -228,6 +235,7 @@ export * from './RevisionEdit';
228
235
  export * from './RootResponse';
229
236
  export * from './RunFolder';
230
237
  export * from './RunFolderRef';
238
+ export * from './RunTimeseriesResponse';
231
239
  export * from './SSOInitiateResponse';
232
240
  export * from './ScoredChunkResponse';
233
241
  export * from './SearchSkillsRequest';
@@ -291,6 +299,8 @@ export * from './ThreadMessageDetails';
291
299
  export * from './ThreadMessageResponse';
292
300
  export * from './ThreadOrder';
293
301
  export * from './ThreadResponse';
302
+ export * from './TimeBucket';
303
+ export * from './TimeseriesPoint';
294
304
  export * from './ToolDisplayType';
295
305
  export * from './ToolPart';
296
306
  export * from './ToolStatus';
@@ -334,6 +344,8 @@ export * from './WorkflowDefinitionOrder';
334
344
  export * from './WorkflowDefinitionResponse';
335
345
  export * from './WorkflowDetailResponse';
336
346
  export * from './WorkflowExecutionState';
347
+ export * from './WorkflowLeaderboardResponse';
348
+ export * from './WorkflowOutputStatsResponse';
337
349
  export * from './WorkflowRunAsset';
338
350
  export * from './WorkflowRunCallbackRequest';
339
351
  export * from './WorkflowRunOrder';