@knowledge-stack/ksapi 1.72.4 → 1.77.1

package/src/apis/AgentApi.ts

@@ -0,0 +1,225 @@
+/* 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 {
+  AskRequest,
+  AskResponse,
+  ExtractRequest,
+  ExtractResponse,
+  HTTPValidationError,
+} from '../models/index';
+import {
+    AskRequestFromJSON,
+    AskRequestToJSON,
+    AskResponseFromJSON,
+    AskResponseToJSON,
+    ExtractRequestFromJSON,
+    ExtractRequestToJSON,
+    ExtractResponseFromJSON,
+    ExtractResponseToJSON,
+    HTTPValidationErrorFromJSON,
+    HTTPValidationErrorToJSON,
+} from '../models/index';
+
+export interface AgentAskRequest {
+    askRequest: AskRequest;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
+export interface AgentExtractRequest {
+    extractRequest: ExtractRequest;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
+/**
+ * AgentApi - interface
+ * 
+ * @export
+ * @interface AgentApiInterface
+ */
+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
+     */
+    agentAskRequestOpts(requestParameters: AgentAskRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * 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``. Refunds on any failure between consume and ``handle.result()`` returning — pre-enqueue ``start_workflow`` raises and post-enqueue workflow failures both refund.
+     * @summary Agent Ask Handler
+     * @param {AskRequest} askRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentApiInterface
+     */
+    agentAskRaw(requestParameters: AgentAskRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AskResponse>>;
+
+    /**
+     * 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``. Refunds on any failure between consume and ``handle.result()`` returning — pre-enqueue ``start_workflow`` raises and post-enqueue workflow failures both refund.
+     * Agent Ask Handler
+     */
+    agentAsk(requestParameters: AgentAskRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AskResponse>;
+
+    /**
+     * Creates request options for agentExtract without sending the request
+     * @param {ExtractRequest} extractRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof AgentApiInterface
+     */
+    agentExtractRequestOpts(requestParameters: AgentExtractRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * 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
+     */
+    agentExtractRaw(requestParameters: AgentExtractRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ExtractResponse>>;
+
+    /**
+     * 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.
+     * Agent Extract Handler
+     */
+    agentExtract(requestParameters: AgentExtractRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ExtractResponse>;
+
+}
+
+/**
+ * 
+ */
+export class AgentApi extends runtime.BaseAPI implements AgentApiInterface {
+
+    /**
+     * Creates request options for agentAsk without sending the request
+     */
+    async agentAskRequestOpts(requestParameters: AgentAskRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['askRequest'] == null) {
+            throw new runtime.RequiredError(
+                'askRequest',
+                'Required parameter "askRequest" was null or undefined when calling agentAsk().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/agent/ask`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: AskRequestToJSON(requestParameters['askRequest']),
+        };
+    }
+
+    /**
+     * 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``. Refunds on any failure between consume and ``handle.result()`` returning — pre-enqueue ``start_workflow`` raises and post-enqueue workflow failures both refund.
+     * Agent Ask Handler
+     */
+    async agentAskRaw(requestParameters: AgentAskRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AskResponse>> {
+        const requestOptions = await this.agentAskRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => AskResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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``. Refunds on any failure between consume and ``handle.result()`` returning — pre-enqueue ``start_workflow`` raises and post-enqueue workflow failures both refund.
+     * Agent Ask Handler
+     */
+    async agentAsk(requestParameters: AgentAskRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AskResponse> {
+        const response = await this.agentAskRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for agentExtract without sending the request
+     */
+    async agentExtractRequestOpts(requestParameters: AgentExtractRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['extractRequest'] == null) {
+            throw new runtime.RequiredError(
+                'extractRequest',
+                'Required parameter "extractRequest" was null or undefined when calling agentExtract().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/agent/extract`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: ExtractRequestToJSON(requestParameters['extractRequest']),
+        };
+    }
+
+    /**
+     * 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.
+     * Agent Extract Handler
+     */
+    async agentExtractRaw(requestParameters: AgentExtractRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ExtractResponse>> {
+        const requestOptions = await this.agentExtractRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ExtractResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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.
+     * Agent Extract Handler
+     */
+    async agentExtract(requestParameters: AgentExtractRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ExtractResponse> {
+        const response = await this.agentExtractRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}

package/src/apis/ChunksApi.ts

@@ -21,6 +21,7 @@ import type {
   ChunkSearchRequest,
   CreateChunkRequest,
   HTTPValidationError,
+  PartType,
   ScoredChunkResponse,
   UpdateChunkContentRequest,
   UpdateChunkMetadataRequest,
@@ -39,6 +40,8 @@ import {
     CreateChunkRequestToJSON,
     HTTPValidationErrorFromJSON,
     HTTPValidationErrorToJSON,
+    PartTypeFromJSON,
+    PartTypeToJSON,
     ScoredChunkResponseFromJSON,
     ScoredChunkResponseToJSON,
     UpdateChunkContentRequestFromJSON,
@@ -72,7 +75,8 @@ export interface GetChunkNeighborsRequest {
     chunkId: string;
     prev?: number;
     next?: number;
-    chunksOnly?: boolean;
+    contentType?: PartType;
+    withinSection?: boolean;
     authorization?: string | null;
     ksUat?: string | null;
 }
@@ -205,9 +209,10 @@ export interface ChunksApiInterface {
     /**
      * Creates request options for getChunkNeighbors without sending the request
      * @param {string} chunkId 
-     * @param {number} [prev] Number of preceding siblings to include
-     * @param {number} [next] Number of succeeding siblings to include
-     * @param {boolean} [chunksOnly] When true, stop traversal at non-CHUNK siblings (default: false)
+     * @param {number} [prev] Number of preceding items to include (max 50).
+     * @param {number} [next] Number of succeeding items to include (max 50).
+     * @param {PartType} [contentType] Filter by content type: SECTION or CHUNK. Omit to return both. SECTION is rejected when the anchor is a chunk (always).
+     * @param {boolean} [withinSection] When true (default), traverse only the anchor\'s sibling chain under the same parent. When false, traverse the entire document version in DFS order, crossing section boundaries.
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @throws {RequiredError}
@@ -216,12 +221,13 @@ export interface ChunksApiInterface {
     getChunkNeighborsRequestOpts(requestParameters: GetChunkNeighborsRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Return a window of items around an anchor chunk.  Two traversal modes:  - ``within_section=true`` (default): walks the sibling linked-list under   the anchor\'s parent. Stops at items outside ``content_type`` when set.   Authorized by the anchor\'s path read permission alone.  - ``within_section=false``: walks the full document version in   depth-first order and slices a window around the anchor. Crosses   section boundaries. Additionally requires read permission on the   enclosing document version\'s path (matching the   ``/v1/document_versions/{id}/contents`` endpoint). USERs whose path   permissions are scoped to a sub-section of the version will get   ``403`` and should use ``within_section=true``.  ``content_type=SECTION`` is rejected with ``400``: the anchor is always a chunk, so a SECTION-only filter would exclude it.
      * @summary Get Chunk Neighbors Handler
      * @param {string} chunkId 
-     * @param {number} [prev] Number of preceding siblings to include
-     * @param {number} [next] Number of succeeding siblings to include
-     * @param {boolean} [chunksOnly] When true, stop traversal at non-CHUNK siblings (default: false)
+     * @param {number} [prev] Number of preceding items to include (max 50).
+     * @param {number} [next] Number of succeeding items to include (max 50).
+     * @param {PartType} [contentType] Filter by content type: SECTION or CHUNK. Omit to return both. SECTION is rejected when the anchor is a chunk (always).
+     * @param {boolean} [withinSection] When true (default), traverse only the anchor\&#39;s sibling chain under the same parent. When false, traverse the entire document version in DFS order, crossing section boundaries.
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
@@ -231,7 +237,7 @@ export interface ChunksApiInterface {
     getChunkNeighborsRaw(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChunkNeighborsResponse>>;
 
     /**
-     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Return a window of items around an anchor chunk.  Two traversal modes:  - ``within_section=true`` (default): walks the sibling linked-list under   the anchor\'s parent. Stops at items outside ``content_type`` when set.   Authorized by the anchor\'s path read permission alone.  - ``within_section=false``: walks the full document version in   depth-first order and slices a window around the anchor. Crosses   section boundaries. Additionally requires read permission on the   enclosing document version\'s path (matching the   ``/v1/document_versions/{id}/contents`` endpoint). USERs whose path   permissions are scoped to a sub-section of the version will get   ``403`` and should use ``within_section=true``.  ``content_type=SECTION`` is rejected with ``400``: the anchor is always a chunk, so a SECTION-only filter would exclude it.
      * Get Chunk Neighbors Handler
      */
     getChunkNeighbors(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkNeighborsResponse>;
@@ -303,7 +309,7 @@ export interface ChunksApiInterface {
     searchChunksRequestOpts(requestParameters: SearchChunksRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.  **Billing note.** SEARCH consume runs *before* path-permission resolution. A request that resolves to an empty permission set (caller has read access to nothing in the requested scope) returns ``[]`` cleanly — without raising — so it is **not** refunded. This is intentional: differential billing for a no-results case would leak access shape to the caller. Callers concerned about charged no-op searches should validate path access client-side first.
      * @summary Search Chunks Handler
      * @param {ChunkSearchRequest} chunkSearchRequest 
      * @param {string} [authorization] 
@@ -315,7 +321,7 @@ export interface ChunksApiInterface {
     searchChunksRaw(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ScoredChunkResponse>>>;
 
     /**
-     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.  **Billing note.** SEARCH consume runs *before* path-permission resolution. A request that resolves to an empty permission set (caller has read access to nothing in the requested scope) returns ``[]`` cleanly — without raising — so it is **not** refunded. This is intentional: differential billing for a no-results case would leak access shape to the caller. Callers concerned about charged no-op searches should validate path access client-side first.
      * Search Chunks Handler
      */
     searchChunks(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ScoredChunkResponse>>;
@@ -566,8 +572,12 @@ export class ChunksApi extends runtime.BaseAPI implements ChunksApiInterface {
             queryParameters['next'] = requestParameters['next'];
         }
 
-        if (requestParameters['chunksOnly'] != null) {
-            queryParameters['chunks_only'] = requestParameters['chunksOnly'];
+        if (requestParameters['contentType'] != null) {
+            queryParameters['content_type'] = requestParameters['contentType'];
+        }
+
+        if (requestParameters['withinSection'] != null) {
+            queryParameters['within_section'] = requestParameters['withinSection'];
         }
 
         const headerParameters: runtime.HTTPHeaders = {};
@@ -589,7 +599,7 @@ export class ChunksApi extends runtime.BaseAPI implements ChunksApiInterface {
     }
 
     /**
-     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Return a window of items around an anchor chunk.  Two traversal modes:  - ``within_section=true`` (default): walks the sibling linked-list under   the anchor\'s parent. Stops at items outside ``content_type`` when set.   Authorized by the anchor\'s path read permission alone.  - ``within_section=false``: walks the full document version in   depth-first order and slices a window around the anchor. Crosses   section boundaries. Additionally requires read permission on the   enclosing document version\'s path (matching the   ``/v1/document_versions/{id}/contents`` endpoint). USERs whose path   permissions are scoped to a sub-section of the version will get   ``403`` and should use ``within_section=true``.  ``content_type=SECTION`` is rejected with ``400``: the anchor is always a chunk, so a SECTION-only filter would exclude it.
      * Get Chunk Neighbors Handler
      */
     async getChunkNeighborsRaw(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ChunkNeighborsResponse>> {
@@ -600,7 +610,7 @@ export class ChunksApi extends runtime.BaseAPI implements ChunksApiInterface {
     }
 
     /**
-     * Get neighboring siblings by traversing the sibling linked list.  Walks the sibling chain backward (prev) and forward (next) from the anchor chunk. Returns sections and chunks in sibling order within the same parent.  When ``chunks_only=true``, the traversal stops at the first non-CHUNK sibling in each direction, returning only chunk neighbors.
+     * Return a window of items around an anchor chunk.  Two traversal modes:  - ``within_section=true`` (default): walks the sibling linked-list under   the anchor\'s parent. Stops at items outside ``content_type`` when set.   Authorized by the anchor\'s path read permission alone.  - ``within_section=false``: walks the full document version in   depth-first order and slices a window around the anchor. Crosses   section boundaries. Additionally requires read permission on the   enclosing document version\'s path (matching the   ``/v1/document_versions/{id}/contents`` endpoint). USERs whose path   permissions are scoped to a sub-section of the version will get   ``403`` and should use ``within_section=true``.  ``content_type=SECTION`` is rejected with ``400``: the anchor is always a chunk, so a SECTION-only filter would exclude it.
      * Get Chunk Neighbors Handler
      */
     async getChunkNeighbors(requestParameters: GetChunkNeighborsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ChunkNeighborsResponse> {
@@ -743,7 +753,7 @@ export class ChunksApi extends runtime.BaseAPI implements ChunksApiInterface {
     }
 
     /**
-     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.  **Billing note.** SEARCH consume runs *before* path-permission resolution. A request that resolves to an empty permission set (caller has read access to nothing in the requested scope) returns ``[]`` cleanly — without raising — so it is **not** refunded. This is intentional: differential billing for a no-results case would leak access shape to the caller. Callers concerned about charged no-op searches should validate path access client-side first.
      * Search Chunks Handler
      */
     async searchChunksRaw(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Array<ScoredChunkResponse>>> {
@@ -754,7 +764,7 @@ export class ChunksApi extends runtime.BaseAPI implements ChunksApiInterface {
     }
 
     /**
-     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.
+     * Search over chunks using dense vector, BM25 full-text, or hybrid retrieval.  Combines search with path-based authorization and optional metadata filters. Uses Qdrant for retrieval and hydrates the matched chunks from Postgres.  **Billing note.** SEARCH consume runs *before* path-permission resolution. A request that resolves to an empty permission set (caller has read access to nothing in the requested scope) returns ``[]`` cleanly — without raising — so it is **not** refunded. This is intentional: differential billing for a no-results case would leak access shape to the caller. Callers concerned about charged no-op searches should validate path access client-side first.
      * Search Chunks Handler
      */
     async searchChunks(requestParameters: SearchChunksRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Array<ScoredChunkResponse>> {

package/src/apis/DocumentsApi.ts

@@ -327,7 +327,7 @@ export interface DocumentsApiInterface {
     updateDocumentRequestOpts(requestParameters: UpdateDocumentOperationRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
+     * Update a document (rename, move, change active version, Qdrant exclusion).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. To toggle Qdrant exclusion: provide `exclude_from_qdrant` field. Any combination can be sent in a single request.
      * @summary Update Document Handler
      * @param {string} documentId 
      * @param {UpdateDocumentRequest} updateDocumentRequest 
@@ -340,7 +340,7 @@ export interface DocumentsApiInterface {
     updateDocumentRaw(requestParameters: UpdateDocumentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentResponse>>;
 
     /**
-     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
+     * Update a document (rename, move, change active version, Qdrant exclusion).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. To toggle Qdrant exclusion: provide `exclude_from_qdrant` field. Any combination can be sent in a single request.
      * Update Document Handler
      */
     updateDocument(requestParameters: UpdateDocumentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse>;
@@ -812,7 +812,7 @@ export class DocumentsApi extends runtime.BaseAPI implements DocumentsApiInterfa
     }
 
     /**
-     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
+     * Update a document (rename, move, change active version, Qdrant exclusion).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. To toggle Qdrant exclusion: provide `exclude_from_qdrant` field. Any combination can be sent in a single request.
      * Update Document Handler
      */
     async updateDocumentRaw(requestParameters: UpdateDocumentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<DocumentResponse>> {
@@ -823,7 +823,7 @@ export class DocumentsApi extends runtime.BaseAPI implements DocumentsApiInterfa
     }
 
     /**
-     * Update a document (rename, move, and/or change active version).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. All can be done in a single request.
+     * Update a document (rename, move, change active version, Qdrant exclusion).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To change active version: provide `active_version_id` field. To toggle Qdrant exclusion: provide `exclude_from_qdrant` field. Any combination can be sent in a single request.
      * Update Document Handler
      */
     async updateDocument(requestParameters: UpdateDocumentOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<DocumentResponse> {

package/src/apis/FoldersApi.ts

@@ -367,7 +367,7 @@ export interface FoldersApiInterface {
     updateFolderRequestOpts(requestParameters: UpdateFolderOperationRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Update a folder (rename and/or move).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. Both can be done in a single request.
+     * Update a folder (rename, move, and/or toggle Qdrant exclusion).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To toggle Qdrant exclusion for this folder and its descendants: provide `exclude_from_qdrant` field. Any combination can be sent in a single request.
      * @summary Update Folder Handler
      * @param {string} folderId 
      * @param {UpdateFolderRequest} updateFolderRequest 
@@ -380,7 +380,7 @@ export interface FoldersApiInterface {
     updateFolderRaw(requestParameters: UpdateFolderOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FolderResponse>>;
 
     /**
-     * Update a folder (rename and/or move).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. Both can be done in a single request.
+     * Update a folder (rename, move, and/or toggle Qdrant exclusion).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To toggle Qdrant exclusion for this folder and its descendants: provide `exclude_from_qdrant` field. Any combination can be sent in a single request.
      * Update Folder Handler
      */
     updateFolder(requestParameters: UpdateFolderOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse>;
@@ -866,7 +866,7 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
     }
 
     /**
-     * Update a folder (rename and/or move).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. Both can be done in a single request.
+     * Update a folder (rename, move, and/or toggle Qdrant exclusion).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To toggle Qdrant exclusion for this folder and its descendants: provide `exclude_from_qdrant` field. Any combination can be sent in a single request.
      * Update Folder Handler
      */
     async updateFolderRaw(requestParameters: UpdateFolderOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FolderResponse>> {
@@ -877,7 +877,7 @@ export class FoldersApi extends runtime.BaseAPI implements FoldersApiInterface {
     }
 
     /**
-     * Update a folder (rename and/or move).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. Both can be done in a single request.
+     * Update a folder (rename, move, and/or toggle Qdrant exclusion).  To rename: provide `name` field. To move: provide `parent_path_part_id` field. To toggle Qdrant exclusion for this folder and its descendants: provide `exclude_from_qdrant` field. Any combination can be sent in a single request.
      * Update Folder Handler
      */
     async updateFolder(requestParameters: UpdateFolderOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FolderResponse> {

package/src/apis/InvitesApi.ts

@@ -21,6 +21,7 @@ import type {
   InviteStatus,
   InviteUserRequest,
   PaginatedResponseInviteResponse,
+  UpdateInviteRequest,
 } from '../models/index';
 import {
     AcceptInviteResponseFromJSON,
@@ -35,6 +36,8 @@ import {
     InviteUserRequestToJSON,
     PaginatedResponseInviteResponseFromJSON,
     PaginatedResponseInviteResponseToJSON,
+    UpdateInviteRequestFromJSON,
+    UpdateInviteRequestToJSON,
 } from '../models/index';
 
 export interface AcceptInviteRequest {
@@ -64,6 +67,13 @@ export interface ListInvitesRequest {
     ksUat?: string | null;
 }
 
+export interface UpdateInviteOperationRequest {
+    inviteId: string;
+    updateInviteRequest: UpdateInviteRequest;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
+
 /**
  * InvitesApi - interface
  * 
@@ -73,7 +83,7 @@ export interface ListInvitesRequest {
 export interface InvitesApiInterface {
     /**
      * Creates request options for acceptInvite without sending the request
-     * @param {string} inviteId 
+     * @param {string} inviteId Either an Invite ID (traditional per-email invite) OR a Tenant ID (when the tenant has ``invite_link.enabled``). Tenant lookup is tried first.
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @throws {RequiredError}
@@ -82,9 +92,9 @@ export interface InvitesApiInterface {
     acceptInviteRequestOpts(requestParameters: AcceptInviteRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Update an invite to accepted status and create tenant user.
+     * Accept an invite OR a tenant invite-link.  The path parameter ``invite_id`` may be either:   * a Tenant ID (when an admin has enabled ``invite_link`` on the tenant), OR   * an Invite ID (the traditional per-email invite flow).  Tenant lookup is tried first. If the row is found, the request is treated as an invite-link request — both 400 paths below have *distinct* messages so the frontend can branch on copy:   * \"does not have invite link enabled\" → admin hasn\'t turned it on   * \"does not support inviting users\"   → tenant kill-switch ``system_metadata.can_invite`` is honored on this path too — it\'s a hard kill switch for self-serve onboarding. Only when no tenant matches do we look up an Invite row.
      * @summary Accept Invite
-     * @param {string} inviteId 
+     * @param {string} inviteId Either an Invite ID (traditional per-email invite) OR a Tenant ID (when the tenant has &#x60;&#x60;invite_link.enabled&#x60;&#x60;). Tenant lookup is tried first.
      * @param {string} [authorization] 
      * @param {string} [ksUat] 
      * @param {*} [options] Override http request option.
@@ -94,7 +104,7 @@ export interface InvitesApiInterface {
     acceptInviteRaw(requestParameters: AcceptInviteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AcceptInviteResponse>>;
 
     /**
-     * Update an invite to accepted status and create tenant user.
+     * Accept an invite OR a tenant invite-link.  The path parameter ``invite_id`` may be either:   * a Tenant ID (when an admin has enabled ``invite_link`` on the tenant), OR   * an Invite ID (the traditional per-email invite flow).  Tenant lookup is tried first. If the row is found, the request is treated as an invite-link request — both 400 paths below have *distinct* messages so the frontend can branch on copy:   * \"does not have invite link enabled\" → admin hasn\'t turned it on   * \"does not support inviting users\"   → tenant kill-switch ``system_metadata.can_invite`` is honored on this path too — it\'s a hard kill switch for self-serve onboarding. Only when no tenant matches do we look up an Invite row.
      * Accept Invite
      */
     acceptInvite(requestParameters: AcceptInviteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AcceptInviteResponse>;
@@ -189,6 +199,36 @@ export interface InvitesApiInterface {
      */
     listInvites(requestParameters: ListInvitesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseInviteResponse>;
 
+    /**
+     * Creates request options for updateInvite without sending the request
+     * @param {string} inviteId 
+     * @param {UpdateInviteRequest} updateInviteRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @throws {RequiredError}
+     * @memberof InvitesApiInterface
+     */
+    updateInviteRequestOpts(requestParameters: UpdateInviteOperationRequest): Promise<runtime.RequestOpts>;
+
+    /**
+     * Update an invite\'s expiry or groups (admin/owner only).  The invite must belong to the caller\'s current tenant. Any provided groups are validated to belong to the same tenant.
+     * @summary Update Invite Handler
+     * @param {string} inviteId 
+     * @param {UpdateInviteRequest} updateInviteRequest 
+     * @param {string} [authorization] 
+     * @param {string} [ksUat] 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof InvitesApiInterface
+     */
+    updateInviteRaw(requestParameters: UpdateInviteOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<InviteResponse>>;
+
+    /**
+     * Update an invite\'s expiry or groups (admin/owner only).  The invite must belong to the caller\'s current tenant. Any provided groups are validated to belong to the same tenant.
+     * Update Invite Handler
+     */
+    updateInvite(requestParameters: UpdateInviteOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<InviteResponse>;
+
 }
 
 /**
@@ -228,7 +268,7 @@ export class InvitesApi extends runtime.BaseAPI implements InvitesApiInterface {
     }
 
     /**
-     * Update an invite to accepted status and create tenant user.
+     * Accept an invite OR a tenant invite-link.  The path parameter ``invite_id`` may be either:   * a Tenant ID (when an admin has enabled ``invite_link`` on the tenant), OR   * an Invite ID (the traditional per-email invite flow).  Tenant lookup is tried first. If the row is found, the request is treated as an invite-link request — both 400 paths below have *distinct* messages so the frontend can branch on copy:   * \"does not have invite link enabled\" → admin hasn\'t turned it on   * \"does not support inviting users\"   → tenant kill-switch ``system_metadata.can_invite`` is honored on this path too — it\'s a hard kill switch for self-serve onboarding. Only when no tenant matches do we look up an Invite row.
      * Accept Invite
      */
     async acceptInviteRaw(requestParameters: AcceptInviteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AcceptInviteResponse>> {
@@ -239,7 +279,7 @@ export class InvitesApi extends runtime.BaseAPI implements InvitesApiInterface {
     }
 
     /**
-     * Update an invite to accepted status and create tenant user.
+     * Accept an invite OR a tenant invite-link.  The path parameter ``invite_id`` may be either:   * a Tenant ID (when an admin has enabled ``invite_link`` on the tenant), OR   * an Invite ID (the traditional per-email invite flow).  Tenant lookup is tried first. If the row is found, the request is treated as an invite-link request — both 400 paths below have *distinct* messages so the frontend can branch on copy:   * \"does not have invite link enabled\" → admin hasn\'t turned it on   * \"does not support inviting users\"   → tenant kill-switch ``system_metadata.can_invite`` is honored on this path too — it\'s a hard kill switch for self-serve onboarding. Only when no tenant matches do we look up an Invite row.
      * Accept Invite
      */
     async acceptInvite(requestParameters: AcceptInviteRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AcceptInviteResponse> {
@@ -409,4 +449,65 @@ export class InvitesApi extends runtime.BaseAPI implements InvitesApiInterface {
         return await response.value();
     }
 
+    /**
+     * Creates request options for updateInvite without sending the request
+     */
+    async updateInviteRequestOpts(requestParameters: UpdateInviteOperationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['inviteId'] == null) {
+            throw new runtime.RequiredError(
+                'inviteId',
+                'Required parameter "inviteId" was null or undefined when calling updateInvite().'
+            );
+        }
+
+        if (requestParameters['updateInviteRequest'] == null) {
+            throw new runtime.RequiredError(
+                'updateInviteRequest',
+                'Required parameter "updateInviteRequest" was null or undefined when calling updateInvite().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (requestParameters['authorization'] != null) {
+            headerParameters['authorization'] = String(requestParameters['authorization']);
+        }
+
+
+        let urlPath = `/v1/invites/{invite_id}`;
+        urlPath = urlPath.replace(`{${"invite_id"}}`, encodeURIComponent(String(requestParameters['inviteId'])));
+
+        return {
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: UpdateInviteRequestToJSON(requestParameters['updateInviteRequest']),
+        };
+    }
+
+    /**
+     * Update an invite\'s expiry or groups (admin/owner only).  The invite must belong to the caller\'s current tenant. Any provided groups are validated to belong to the same tenant.
+     * Update Invite Handler
+     */
+    async updateInviteRaw(requestParameters: UpdateInviteOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<InviteResponse>> {
+        const requestOptions = await this.updateInviteRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => InviteResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Update an invite\'s expiry or groups (admin/owner only).  The invite must belong to the caller\'s current tenant. Any provided groups are validated to belong to the same tenant.
+     * Update Invite Handler
+     */
+    async updateInvite(requestParameters: UpdateInviteOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<InviteResponse> {
+        const response = await this.updateInviteRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
 }