@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.
- package/.openapi-generator/FILES +28 -0
- package/README.md +25 -11
- package/dist/apis/AdminKbApi.d.ts +109 -0
- package/dist/apis/AdminKbApi.js +172 -0
- package/dist/apis/AdminWorkflowsApi.d.ts +252 -0
- package/dist/apis/AdminWorkflowsApi.js +337 -0
- package/dist/apis/SkillsApi.d.ts +4 -4
- package/dist/apis/SkillsApi.js +2 -2
- package/dist/apis/index.d.ts +2 -0
- package/dist/apis/index.js +2 -0
- package/dist/esm/apis/AdminKbApi.d.ts +109 -0
- package/dist/esm/apis/AdminKbApi.js +135 -0
- package/dist/esm/apis/AdminWorkflowsApi.d.ts +252 -0
- package/dist/esm/apis/AdminWorkflowsApi.js +300 -0
- package/dist/esm/apis/SkillsApi.d.ts +4 -4
- package/dist/esm/apis/SkillsApi.js +2 -2
- package/dist/esm/apis/index.d.ts +2 -0
- package/dist/esm/apis/index.js +2 -0
- package/dist/esm/models/DefinitionOutputStat.d.ts +65 -0
- package/dist/esm/models/DefinitionOutputStat.js +56 -0
- package/dist/esm/models/HourHistogramResponse.d.ts +53 -0
- package/dist/esm/models/HourHistogramResponse.js +54 -0
- package/dist/esm/models/KbMetric.d.ts +26 -0
- package/dist/esm/models/KbMetric.js +44 -0
- package/dist/esm/models/KbSummaryResponse.d.ts +152 -0
- package/dist/esm/models/KbSummaryResponse.js +109 -0
- package/dist/esm/models/KbTimeseriesResponse.d.ts +71 -0
- package/dist/esm/models/KbTimeseriesResponse.js +57 -0
- package/dist/esm/models/LabeledSeries.d.ts +54 -0
- package/dist/esm/models/LabeledSeries.js +47 -0
- package/dist/esm/models/LeaderboardEntry.d.ts +59 -0
- package/dist/esm/models/LeaderboardEntry.js +52 -0
- package/dist/esm/models/RunTimeseriesResponse.d.ts +61 -0
- package/dist/esm/models/RunTimeseriesResponse.js +52 -0
- package/dist/esm/models/SkillResponse.d.ts +7 -0
- package/dist/esm/models/SkillResponse.js +3 -0
- package/dist/esm/models/TimeBucket.d.ts +27 -0
- package/dist/esm/models/TimeBucket.js +45 -0
- package/dist/esm/models/TimeseriesPoint.d.ts +53 -0
- package/dist/esm/models/TimeseriesPoint.js +48 -0
- package/dist/esm/models/WorkflowLeaderboardResponse.d.ts +54 -0
- package/dist/esm/models/WorkflowLeaderboardResponse.js +45 -0
- package/dist/esm/models/WorkflowOutputStatsResponse.d.ts +54 -0
- package/dist/esm/models/WorkflowOutputStatsResponse.js +47 -0
- package/dist/esm/models/index.d.ts +12 -0
- package/dist/esm/models/index.js +12 -0
- package/dist/models/DefinitionOutputStat.d.ts +65 -0
- package/dist/models/DefinitionOutputStat.js +64 -0
- package/dist/models/HourHistogramResponse.d.ts +53 -0
- package/dist/models/HourHistogramResponse.js +62 -0
- package/dist/models/KbMetric.d.ts +26 -0
- package/dist/models/KbMetric.js +52 -0
- package/dist/models/KbSummaryResponse.d.ts +152 -0
- package/dist/models/KbSummaryResponse.js +117 -0
- package/dist/models/KbTimeseriesResponse.d.ts +71 -0
- package/dist/models/KbTimeseriesResponse.js +65 -0
- package/dist/models/LabeledSeries.d.ts +54 -0
- package/dist/models/LabeledSeries.js +55 -0
- package/dist/models/LeaderboardEntry.d.ts +59 -0
- package/dist/models/LeaderboardEntry.js +60 -0
- package/dist/models/RunTimeseriesResponse.d.ts +61 -0
- package/dist/models/RunTimeseriesResponse.js +60 -0
- package/dist/models/SkillResponse.d.ts +7 -0
- package/dist/models/SkillResponse.js +3 -0
- package/dist/models/TimeBucket.d.ts +27 -0
- package/dist/models/TimeBucket.js +53 -0
- package/dist/models/TimeseriesPoint.d.ts +53 -0
- package/dist/models/TimeseriesPoint.js +56 -0
- package/dist/models/WorkflowLeaderboardResponse.d.ts +54 -0
- package/dist/models/WorkflowLeaderboardResponse.js +53 -0
- package/dist/models/WorkflowOutputStatsResponse.d.ts +54 -0
- package/dist/models/WorkflowOutputStatsResponse.js +55 -0
- package/dist/models/index.d.ts +12 -0
- package/dist/models/index.js +12 -0
- package/docs/AdminKbApi.md +163 -0
- package/docs/AdminWorkflowsApi.md +424 -0
- package/docs/DefinitionOutputStat.md +41 -0
- package/docs/FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR.md +2 -0
- package/docs/HourHistogramResponse.md +37 -0
- package/docs/KbMetric.md +33 -0
- package/docs/KbSummaryResponse.md +67 -0
- package/docs/KbTimeseriesResponse.md +41 -0
- package/docs/LabeledSeries.md +37 -0
- package/docs/LeaderboardEntry.md +39 -0
- package/docs/RunTimeseriesResponse.md +39 -0
- package/docs/SkillResponse.md +2 -0
- package/docs/SkillsApi.md +1 -1
- package/docs/TimeBucket.md +33 -0
- package/docs/TimeseriesPoint.md +37 -0
- package/docs/WorkflowLeaderboardResponse.md +37 -0
- package/docs/WorkflowOutputStatsResponse.md +37 -0
- package/package.json +1 -1
- package/src/apis/AdminKbApi.ts +237 -0
- package/src/apis/AdminWorkflowsApi.ts +539 -0
- package/src/apis/SkillsApi.ts +4 -4
- package/src/apis/index.ts +2 -0
- package/src/models/DefinitionOutputStat.ts +110 -0
- package/src/models/HourHistogramResponse.ts +97 -0
- package/src/models/KbMetric.ts +54 -0
- package/src/models/KbSummaryResponse.ts +235 -0
- package/src/models/KbTimeseriesResponse.ts +136 -0
- package/src/models/LabeledSeries.ts +99 -0
- package/src/models/LeaderboardEntry.ts +101 -0
- package/src/models/RunTimeseriesResponse.ts +117 -0
- package/src/models/SkillResponse.ts +15 -0
- package/src/models/TimeBucket.ts +55 -0
- package/src/models/TimeseriesPoint.ts +92 -0
- package/src/models/WorkflowLeaderboardResponse.ts +98 -0
- package/src/models/WorkflowOutputStatsResponse.ts +99 -0
- 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
|
+
|
package/src/models/index.ts
CHANGED
|
@@ -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';
|