@knowledge-stack/ksapi 1.72.3 → 1.77.1

package/dist/esm/apis/AgentApi.d.ts

@@ -0,0 +1,114 @@
+/**
+ * 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 } 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 declare class AgentApi extends runtime.BaseAPI implements AgentApiInterface {
+    /**
+     * Creates request options for agentAsk without sending the request
+     */
+    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.
+     * Agent Ask Handler
+     */
+    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
+     */
+    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.
+     * Agent Extract Handler
+     */
+    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>;
+}

package/dist/esm/apis/AgentApi.js

@@ -0,0 +1,119 @@
+/* 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.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as runtime from '../runtime';
+import { AskRequestToJSON, AskResponseFromJSON, ExtractRequestToJSON, ExtractResponseFromJSON, } from '../models/index';
+/**
+ *
+ */
+export class AgentApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for agentAsk without sending the request
+     */
+    agentAskRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['askRequest'] == null) {
+                throw new runtime.RequiredError('askRequest', 'Required parameter "askRequest" was null or undefined when calling agentAsk().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            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
+     */
+    agentAskRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.agentAskRequestOpts(requestParameters);
+            const response = yield 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
+     */
+    agentAsk(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.agentAskRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+    /**
+     * Creates request options for agentExtract without sending the request
+     */
+    agentExtractRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['extractRequest'] == null) {
+                throw new runtime.RequiredError('extractRequest', 'Required parameter "extractRequest" was null or undefined when calling agentExtract().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            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
+     */
+    agentExtractRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.agentExtractRequestOpts(requestParameters);
+            const response = yield 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
+     */
+    agentExtract(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.agentExtractRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
+}

package/dist/esm/apis/ChunksApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { ChunkBulkResponse, ChunkNeighborsResponse, ChunkResponse, ChunkSearchRequest, CreateChunkRequest, ScoredChunkResponse, UpdateChunkContentRequest, UpdateChunkMetadataRequest, VersionChunkIdsResponse } from '../models/index';
+import type { ChunkBulkResponse, ChunkNeighborsResponse, ChunkResponse, ChunkSearchRequest, CreateChunkRequest, PartType, ScoredChunkResponse, UpdateChunkContentRequest, UpdateChunkMetadataRequest, VersionChunkIdsResponse } from '../models/index';
 export interface CreateChunkOperationRequest {
     createChunkRequest: CreateChunkRequest;
     authorization?: string | null;
@@ -31,7 +31,8 @@ export interface GetChunkNeighborsRequest {
     chunkId: string;
     prev?: number;
     next?: number;
-    chunksOnly?: boolean;
+    contentType?: PartType;
+    withinSection?: boolean;
     authorization?: string | null;
     ksUat?: string | null;
 }
@@ -149,9 +150,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}
@@ -159,12 +161,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.
@@ -173,7 +176,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>;
@@ -237,7 +240,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]
@@ -248,7 +251,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>>;
@@ -358,12 +361,12 @@ export declare class ChunksApi extends runtime.BaseAPI implements ChunksApiInter
      */
     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.
      * Get Chunk Neighbors Handler
      */
     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>;
@@ -400,12 +403,12 @@ export declare class ChunksApi extends runtime.BaseAPI implements ChunksApiInter
      */
     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.
      * Search Chunks Handler
      */
     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>>;

package/dist/esm/apis/ChunksApi.js

@@ -176,8 +176,11 @@ export class ChunksApi extends runtime.BaseAPI {
             if (requestParameters['next'] != null) {
                 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 = {};
             if (requestParameters['authorization'] != null) {
@@ -194,7 +197,7 @@ export class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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
      */
     getChunkNeighborsRaw(requestParameters, initOverrides) {
@@ -205,7 +208,7 @@ export class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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, initOverrides) {
@@ -328,7 +331,7 @@ export class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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
      */
     searchChunksRaw(requestParameters, initOverrides) {
@@ -339,7 +342,7 @@ export class ChunksApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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, initOverrides) {

package/dist/esm/apis/DocumentsApi.d.ts

@@ -263,7 +263,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
@@ -275,7 +275,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>;
@@ -373,12 +373,12 @@ export declare class DocumentsApi extends runtime.BaseAPI implements DocumentsAp
      */
     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.
      * Update Document Handler
      */
     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>;

package/dist/esm/apis/DocumentsApi.js

@@ -406,7 +406,7 @@ export class DocumentsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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
      */
     updateDocumentRaw(requestParameters, initOverrides) {
@@ -417,7 +417,7 @@ export class DocumentsApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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, initOverrides) {

package/dist/esm/apis/FoldersApi.d.ts

@@ -296,7 +296,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
@@ -308,7 +308,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>;
@@ -420,12 +420,12 @@ export declare class FoldersApi extends runtime.BaseAPI implements FoldersApiInt
      */
     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.
      * Update Folder Handler
      */
     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>;

package/dist/esm/apis/FoldersApi.js

@@ -418,7 +418,7 @@ export class FoldersApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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
      */
     updateFolderRaw(requestParameters, initOverrides) {
@@ -429,7 +429,7 @@ export class FoldersApi extends runtime.BaseAPI {
         });
     }
     /**
-     * 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, initOverrides) {