@knowledge-stack/ksapi 1.95.4 → 1.96.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledge-stack/ksapi",
-  "version": "1.95.4",
+  "version": "1.96.0",
   "description": "OpenAPI client for @knowledge-stack/ksapi",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/AgentApi.ts

@@ -36,14 +36,10 @@ import {
 
 export interface AgentAskRequest {
     askRequest: AskRequest;
-    authorization?: string | null;
-    ksUat?: string | null;
 }
 
 export interface AgentExtractRequest {
     extractRequest: ExtractRequest;
-    authorization?: string | null;
-    ksUat?: string | null;
 }
 
 /**
@@ -56,8 +52,6 @@ export interface AgentApiInterface {
     /**
      * Creates request options for agentAsk without sending the request
      * @param {AskRequest} askRequest 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof AgentApiInterface
      */
@@ -67,8 +61,6 @@ export interface AgentApiInterface {
      * Run a one-shot text agent request to completion and return the payload.  The request blocks until the underlying Temporal workflow finishes. Clients should set a generous HTTP timeout to accommodate tool-heavy runs.  Quota: consumes one MESSAGE before ``start_workflow``. Refund semantics distinguish cause:  * **Cancellation** (client disconnect → ``asyncio.CancelledError``,   OR explicit ``DELETE /v1/workflows/{id}`` while we await   ``handle.result()`` → Temporal-wrapped ``CancelledError``)   → **NO REFUND.** The user walked away or actively cancelled;   that\'s their volition. We still best-effort cancel the   workflow so the agent stops burning LLM tokens, but the   consume stays charged. Detection uses   ``temporalio.exceptions.is_cancelled_exception`` which spans   both forms. * Any other exception (pre-enqueue ``start_workflow`` raise,   Temporal failure, workflow-internal error) → **REFUND.** Server   / our-problem failures don\'t bill the user.
      * @summary Agent Ask Handler
      * @param {AskRequest} askRequest 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AgentApiInterface
@@ -84,8 +76,6 @@ export interface AgentApiInterface {
     /**
      * Creates request options for agentExtract without sending the request
      * @param {ExtractRequest} extractRequest 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof AgentApiInterface
      */
@@ -95,8 +85,6 @@ export interface AgentApiInterface {
      * Run a one-shot structured extraction request and return the payload.  Validates the schema input on the route side (DOCUMENT → active version → valid JSON object) BEFORE consuming quota or starting the workflow. Bad schema → 400 with no quota debit. The workflow activity trusts the input and does not re-validate.  Quota: consumes one MESSAGE before ``start_workflow``. Refunds on any failure between consume and ``handle.result()`` returning — pre-enqueue ``start_workflow`` raises and post-enqueue workflow failures both refund.
      * @summary Agent Extract Handler
      * @param {ExtractRequest} extractRequest 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AgentApiInterface
@@ -133,10 +121,14 @@ export class AgentApi extends runtime.BaseAPI implements AgentApiInterface {
 
         headerParameters['Content-Type'] = 'application/json';
 
-        if (requestParameters['authorization'] != null) {
-            headerParameters['authorization'] = String(requestParameters['authorization']);
-        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
 
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
 
         let urlPath = `/v1/agent/ask`;
 
@@ -186,10 +178,14 @@ export class AgentApi extends runtime.BaseAPI implements AgentApiInterface {
 
         headerParameters['Content-Type'] = 'application/json';
 
-        if (requestParameters['authorization'] != null) {
-            headerParameters['authorization'] = String(requestParameters['authorization']);
-        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
 
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
 
         let urlPath = `/v1/agent/extract`;
 

package/src/apis/ApiKeysApi.ts

@@ -33,21 +33,14 @@ import {
 
 export interface CreateApiKeyOperationRequest {
     createApiKeyRequest: CreateApiKeyRequest;
-    ksUat?: string | null;
 }
 
 export interface DeleteApiKeyRequest {
     apiKeyId: string;
-    ksUat?: string | null;
 }
 
 export interface GetApiKeyRequest {
     apiKeyId: string;
-    ksUat?: string | null;
-}
-
-export interface ListApiKeysRequest {
-    ksUat?: string | null;
 }
 
 /**
@@ -60,7 +53,6 @@ export interface ApiKeysApiInterface {
     /**
      * Creates request options for createApiKey without sending the request
      * @param {CreateApiKeyRequest} createApiKeyRequest 
-     * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof ApiKeysApiInterface
      */
@@ -70,7 +62,6 @@ export interface ApiKeysApiInterface {
      * Create a new API key. The full key is returned only once.
      * @summary Create Api Key Handler
      * @param {CreateApiKeyRequest} createApiKeyRequest 
-     * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof ApiKeysApiInterface
@@ -86,7 +77,6 @@ export interface ApiKeysApiInterface {
     /**
      * Creates request options for deleteApiKey without sending the request
      * @param {string} apiKeyId 
-     * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof ApiKeysApiInterface
      */
@@ -96,7 +86,6 @@ export interface ApiKeysApiInterface {
      * Delete an API key.
      * @summary Delete Api Key Handler
      * @param {string} apiKeyId 
-     * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof ApiKeysApiInterface
@@ -112,7 +101,6 @@ export interface ApiKeysApiInterface {
     /**
      * Creates request options for getApiKey without sending the request
      * @param {string} apiKeyId 
-     * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof ApiKeysApiInterface
      */
@@ -122,7 +110,6 @@ export interface ApiKeysApiInterface {
      * Get a single API key by ID.
      * @summary Get Api Key Handler
      * @param {string} apiKeyId 
-     * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof ApiKeysApiInterface
@@ -137,27 +124,25 @@ export interface ApiKeysApiInterface {
 
     /**
      * Creates request options for listApiKeys without sending the request
-     * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof ApiKeysApiInterface
      */
-    listApiKeysRequestOpts(requestParameters: ListApiKeysRequest): Promise<runtime.RequestOpts>;
+    listApiKeysRequestOpts(): Promise<runtime.RequestOpts>;
 
     /**
      * List all API keys for the current user.
      * @summary List Api Keys Handler
-     * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof ApiKeysApiInterface
      */
-    listApiKeysRaw(requestParameters: ListApiKeysRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ApiKeyResponse>>>;
+    listApiKeysRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ApiKeyResponse>>>;
 
     /**
      * List all API keys for the current user.
      * List Api Keys Handler
      */
-    listApiKeys(requestParameters: ListApiKeysRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ApiKeyResponse>>;
+    listApiKeys(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ApiKeyResponse>>;
 
 }
 
@@ -311,7 +296,7 @@ export class ApiKeysApi extends runtime.BaseAPI implements ApiKeysApiInterface {
     /**
      * Creates request options for listApiKeys without sending the request
      */
-    async listApiKeysRequestOpts(requestParameters: ListApiKeysRequest): Promise<runtime.RequestOpts> {
+    async listApiKeysRequestOpts(): Promise<runtime.RequestOpts> {
         const queryParameters: any = {};
 
         const headerParameters: runtime.HTTPHeaders = {};
@@ -331,8 +316,8 @@ export class ApiKeysApi extends runtime.BaseAPI implements ApiKeysApiInterface {
      * List all API keys for the current user.
      * List Api Keys Handler
      */
-    async listApiKeysRaw(requestParameters: ListApiKeysRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ApiKeyResponse>>> {
-        const requestOptions = await this.listApiKeysRequestOpts(requestParameters);
+    async listApiKeysRaw(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ApiKeyResponse>>> {
+        const requestOptions = await this.listApiKeysRequestOpts();
         const response = await this.request(requestOptions, initOverrides);
 
         return new runtime.JSONApiResponse(response, (jsonValue) => jsonValue.map(ApiKeyResponseFromJSON));
@@ -342,8 +327,8 @@ export class ApiKeysApi extends runtime.BaseAPI implements ApiKeysApiInterface {
      * List all API keys for the current user.
      * List Api Keys Handler
      */
-    async listApiKeys(requestParameters: ListApiKeysRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ApiKeyResponse>> {
-        const response = await this.listApiKeysRaw(requestParameters, initOverrides);
+    async listApiKeys(initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ApiKeyResponse>> {
+        const response = await this.listApiKeysRaw(initOverrides);
         return await response.value();
     }
 

package/src/apis/AuditEventsApi.ts

@@ -0,0 +1,170 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import * as runtime from '../runtime';
+import type {
+  HTTPValidationError,
+  PaginatedResponseEventResponse,
+} from '../models/index';
+import {
+    HTTPValidationErrorFromJSON,
+    HTTPValidationErrorToJSON,
+    PaginatedResponseEventResponseFromJSON,
+    PaginatedResponseEventResponseToJSON,
+} from '../models/index';
+
+export interface ListAuditEventsRequest {
+    actorUserId?: string | null;
+    kind?: string | null;
+    since?: Date | null;
+    until?: Date | null;
+    subjectPathPartId?: string | null;
+    recursive?: boolean;
+    limit?: number;
+    offset?: number;
+}
+
+/**
+ * AuditEventsApi - interface
+ * 
+ * @export
+ * @interface AuditEventsApiInterface
+ */
+export interface AuditEventsApiInterface {
+    /**
+     * Creates request options for listAuditEvents without sending the request
+     * @param {string} [actorUserId] Filter to one actor
+     * @param {string} [kind] Filter to one event kind
+     * @param {Date} [since] Only events at or after this timestamp
+     * @param {Date} [until] Only events strictly before this timestamp
+     * @param {string} [subjectPathPartId] Scope to one document/folder/run subject
+     * @param {boolean} [recursive] Include the subject\'s descendants (needs subject)
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @throws {RequiredError}
+     * @memberof AuditEventsApiInterface
+     */
+    listAuditEventsRequestOpts(requestParameters: ListAuditEventsRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * List the tenant\'s audit events, newest first (admin/owner only).  Returns every event in the caller\'s own tenant — ADMIN/OWNER bypass path permissions by design. Filter by actor, kind, time window, and/or a subject subtree. Each event carries its resolved actor name.
+     * @summary List Audit Events Handler
+     * @param {string} [actorUserId] Filter to one actor
+     * @param {string} [kind] Filter to one event kind
+     * @param {Date} [since] Only events at or after this timestamp
+     * @param {Date} [until] Only events strictly before this timestamp
+     * @param {string} [subjectPathPartId] Scope to one document/folder/run subject
+     * @param {boolean} [recursive] Include the subject\&#39;s descendants (needs subject)
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AuditEventsApiInterface
+     */
+    listAuditEventsRaw(requestParameters: ListAuditEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseEventResponse>>;
+
+    /**
+     * List the tenant\'s audit events, newest first (admin/owner only).  Returns every event in the caller\'s own tenant — ADMIN/OWNER bypass path permissions by design. Filter by actor, kind, time window, and/or a subject subtree. Each event carries its resolved actor name.
+     * List Audit Events Handler
+     */
+    listAuditEvents(requestParameters: ListAuditEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseEventResponse>;
+
+}
+
+/**
+ * 
+ */
+export class AuditEventsApi extends runtime.BaseAPI implements AuditEventsApiInterface {
+
+    /**
+     * Creates request options for listAuditEvents without sending the request
+     */
+    async listAuditEventsRequestOpts(requestParameters: ListAuditEventsRequest): Promise<runtime.RequestOpts> {
+        const queryParameters: any = {};
+
+        if (requestParameters['actorUserId'] != null) {
+            queryParameters['actor_user_id'] = requestParameters['actorUserId'];
+        }
+
+        if (requestParameters['kind'] != null) {
+            queryParameters['kind'] = requestParameters['kind'];
+        }
+
+        if (requestParameters['since'] != null) {
+            queryParameters['since'] = (requestParameters['since'] as any).toISOString();
+        }
+
+        if (requestParameters['until'] != null) {
+            queryParameters['until'] = (requestParameters['until'] as any).toISOString();
+        }
+
+        if (requestParameters['subjectPathPartId'] != null) {
+            queryParameters['subject_path_part_id'] = requestParameters['subjectPathPartId'];
+        }
+
+        if (requestParameters['recursive'] != null) {
+            queryParameters['recursive'] = requestParameters['recursive'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['offset'] != null) {
+            queryParameters['offset'] = requestParameters['offset'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/v1/audit-events`;
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * List the tenant\'s audit events, newest first (admin/owner only).  Returns every event in the caller\'s own tenant — ADMIN/OWNER bypass path permissions by design. Filter by actor, kind, time window, and/or a subject subtree. Each event carries its resolved actor name.
+     * List Audit Events Handler
+     */
+    async listAuditEventsRaw(requestParameters: ListAuditEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseEventResponse>> {
+        const requestOptions = await this.listAuditEventsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PaginatedResponseEventResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * List the tenant\'s audit events, newest first (admin/owner only).  Returns every event in the caller\'s own tenant — ADMIN/OWNER bypass path permissions by design. Filter by actor, kind, time window, and/or a subject subtree. Each event carries its resolved actor name.
+     * List Audit Events Handler
+     */
+    async listAuditEvents(requestParameters: ListAuditEventsRequest = {}, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseEventResponse> {
+        const response = await this.listAuditEventsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/AuthApi.ts

@@ -81,8 +81,6 @@ import {
 
 export interface ChangePhoneNumberOperationRequest {
     changePhoneNumberRequest: ChangePhoneNumberRequest;
-    authorization?: string | null;
-    ksUat?: string | null;
 }
 
 export interface CreatePasswordUserOperationRequest {
@@ -133,20 +131,14 @@ export interface PwSigninRequest {
 
 export interface RefreshUatRequest {
     tenantId?: string | null;
-    authorization?: string | null;
-    ksUat?: string | null;
 }
 
 export interface RequestPhoneChangeOperationRequest {
     requestPhoneChangeRequest: RequestPhoneChangeRequest;
-    authorization?: string | null;
-    ksUat?: string | null;
 }
 
 export interface ResetPasswordRequest {
     passwordResetRequest: PasswordResetRequest;
-    authorization?: string | null;
-    ksUat?: string | null;
 }
 
 export interface ResetPasswordWithTokenRequest {
@@ -176,8 +168,6 @@ export interface AuthApiInterface {
     /**
      * Creates request options for changePhoneNumber without sending the request
      * @param {ChangePhoneNumberRequest} changePhoneNumberRequest 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof AuthApiInterface
      */
@@ -187,8 +177,6 @@ export interface AuthApiInterface {
      * Apply a verified phone-number change to the authenticated user.  The new phone is read from the Redis validation record pinned by ``/me/phone_number/verify``.
      * @summary Change Phone Number Handler
      * @param {ChangePhoneNumberRequest} changePhoneNumberRequest 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AuthApiInterface
@@ -439,8 +427,6 @@ export interface AuthApiInterface {
     /**
      * Creates request options for refreshUat without sending the request
      * @param {string} [tenantId] Target tenant ID to switch to. None=refresh current tenant
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof AuthApiInterface
      */
@@ -450,8 +436,6 @@ export interface AuthApiInterface {
      * Refresh or switch the user\'s active tenant token.
      * @summary Refresh Uat Handler
      * @param {string} [tenantId] Target tenant ID to switch to. None=refresh current tenant
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AuthApiInterface
@@ -467,8 +451,6 @@ export interface AuthApiInterface {
     /**
      * Creates request options for requestPhoneChange without sending the request
      * @param {RequestPhoneChangeRequest} requestPhoneChangeRequest 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof AuthApiInterface
      */
@@ -478,8 +460,6 @@ export interface AuthApiInterface {
      * Dispatch an SMS code to authorize a phone-number change.  Confirms the new phone isn\'t already taken by *another* user. The caller is identified by their UAT, so authentication is required.
      * @summary Request Phone Change Handler
      * @param {RequestPhoneChangeRequest} requestPhoneChangeRequest 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AuthApiInterface
@@ -495,8 +475,6 @@ export interface AuthApiInterface {
     /**
      * Creates request options for resetPassword without sending the request
      * @param {PasswordResetRequest} passwordResetRequest 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @throws {RequiredError}
      * @memberof AuthApiInterface
      */
@@ -506,8 +484,6 @@ export interface AuthApiInterface {
      * Reset password for the authenticated user
      * @summary Reset Password Handler
      * @param {PasswordResetRequest} passwordResetRequest 
-     * @param {string} [authorization] 
-     * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof AuthApiInterface
@@ -663,10 +639,14 @@ export class AuthApi extends runtime.BaseAPI implements AuthApiInterface {
 
         headerParameters['Content-Type'] = 'application/json';
 
-        if (requestParameters['authorization'] != null) {
-            headerParameters['authorization'] = String(requestParameters['authorization']);
-        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
 
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
 
         let urlPath = `/v1/auth/pw/me/phone_number`;
 
@@ -1180,10 +1160,14 @@ export class AuthApi extends runtime.BaseAPI implements AuthApiInterface {
 
         const headerParameters: runtime.HTTPHeaders = {};
 
-        if (requestParameters['authorization'] != null) {
-            headerParameters['authorization'] = String(requestParameters['authorization']);
-        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
 
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
 
         let urlPath = `/v1/auth/uat`;
 
@@ -1232,10 +1216,14 @@ export class AuthApi extends runtime.BaseAPI implements AuthApiInterface {
 
         headerParameters['Content-Type'] = 'application/json';
 
-        if (requestParameters['authorization'] != null) {
-            headerParameters['authorization'] = String(requestParameters['authorization']);
-        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
 
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
 
         let urlPath = `/v1/auth/pw/me/phone_number/verify`;
 
@@ -1285,10 +1273,14 @@ export class AuthApi extends runtime.BaseAPI implements AuthApiInterface {
 
         headerParameters['Content-Type'] = 'application/json';
 
-        if (requestParameters['authorization'] != null) {
-            headerParameters['authorization'] = String(requestParameters['authorization']);
-        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearerAuth", []);
 
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
 
         let urlPath = `/v1/auth/pw/reset`;