@knowledge-stack/ksapi 1.142.2 → 1.144.0

package/.openapi-generator/FILES

@@ -252,7 +252,9 @@ docs/ProposedMemoryChunkResponse.md
 docs/PublicApi.md
 docs/ReasoningPart.md
 docs/ReferenceType.md
+docs/ReorderPathPartRequest.md
 docs/RequestPhoneChangeRequest.md
+docs/ResolvedRef.md
 docs/ResolvedReferenceInput.md
 docs/ResolvedReferenceOutput.md
 docs/ResponseSendPwResetEmail.md
@@ -665,7 +667,9 @@ src/models/ProposeMemoryChunkRequest.ts
 src/models/ProposedMemoryChunkResponse.ts
 src/models/ReasoningPart.ts
 src/models/ReferenceType.ts
+src/models/ReorderPathPartRequest.ts
 src/models/RequestPhoneChangeRequest.ts
+src/models/ResolvedRef.ts
 src/models/ResolvedReferenceInput.ts
 src/models/ResolvedReferenceOutput.ts
 src/models/ResponseSendPwResetEmail.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.142.2
+# @knowledge-stack/ksapi@1.144.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -177,6 +177,7 @@ All URIs are relative to *http://localhost:8000*
 *PathPartsApi* | [**getPathPartTags**](docs/PathPartsApi.md#getpathparttags) | **GET** /v1/path-parts/{path_part_id}/tags | Get Path Part Tags Handler
 *PathPartsApi* | [**listPathPartEvents**](docs/PathPartsApi.md#listpathpartevents) | **GET** /v1/path-parts/{path_part_id}/events | List Path Part Events Handler
 *PathPartsApi* | [**listPathParts**](docs/PathPartsApi.md#listpathparts) | **GET** /v1/path-parts | List Path Parts Handler
+*PathPartsApi* | [**reorderPathPart**](docs/PathPartsApi.md#reorderpathpartoperation) | **POST** /v1/path-parts/{path_part_id}/reorder | Reorder Path Part Handler
 *PathPartsApi* | [**setPathPartTags**](docs/PathPartsApi.md#setpathparttags) | **POST** /v1/path-parts/{path_part_id}/tags | Set Path Part Tags Handler
 *PathPartsApi* | [**transferPathPartOwner**](docs/PathPartsApi.md#transferpathpartowner) | **PUT** /v1/path-parts/{path_part_id}/owner | Transfer Path Part Owner Handler
 *PublicApi* | [**listPublicSubscriptions**](docs/PublicApi.md#listpublicsubscriptions) | **GET** /public/subscriptions | List Public Subscriptions Handler
@@ -515,7 +516,9 @@ All URIs are relative to *http://localhost:8000*
 - [ProposedMemoryChunkResponse](docs/ProposedMemoryChunkResponse.md)
 - [ReasoningPart](docs/ReasoningPart.md)
 - [ReferenceType](docs/ReferenceType.md)
+- [ReorderPathPartRequest](docs/ReorderPathPartRequest.md)
 - [RequestPhoneChangeRequest](docs/RequestPhoneChangeRequest.md)
+- [ResolvedRef](docs/ResolvedRef.md)
 - [ResolvedReferenceInput](docs/ResolvedReferenceInput.md)
 - [ResolvedReferenceOutput](docs/ResolvedReferenceOutput.md)
 - [ResponseSendPwResetEmail](docs/ResponseSendPwResetEmail.md)
@@ -670,7 +673,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.142.2`
+- Package version: `1.144.0`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/PathPartsApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AccessCheckResponse, AncestryResponse, AppendEventRequest, BulkTagRequest, EventResponse, PaginatedResponseEventResponse, PaginatedResponsePathPartResponse, PathOrder, PathPartResponse, PathPartTagsResponse, PermissionCapability, SortDirection, SubtreeChunksResponse, TransferOwnerRequest, TransferOwnerResponse } from '../models/index';
+import type { AccessCheckResponse, AncestryResponse, AppendEventRequest, BulkTagRequest, EventResponse, PaginatedResponseEventResponse, PaginatedResponsePathPartResponse, PathOrder, PathPartResponse, PathPartTagsResponse, PermissionCapability, ReorderPathPartRequest, SortDirection, SubtreeChunksResponse, TransferOwnerRequest, TransferOwnerResponse } from '../models/index';
 export interface AppendPathPartEventRequest {
     pathPartId: string;
     appendEventRequest: AppendEventRequest;
@@ -58,6 +58,10 @@ export interface ListPathPartsRequest {
     updatedAfter?: Date | null;
     updatedBefore?: Date | null;
 }
+export interface ReorderPathPartOperationRequest {
+    pathPartId: string;
+    reorderPathPartRequest: ReorderPathPartRequest;
+}
 export interface SetPathPartTagsRequest {
     pathPartId: string;
     bulkTagRequest: BulkTagRequest;
@@ -302,6 +306,29 @@ export interface PathPartsApiInterface {
      * List Path Parts Handler
      */
     listPathParts(requestParameters: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponsePathPartResponse>;
+    /**
+     * Creates request options for reorderPathPart without sending the request
+     * @param {string} pathPartId
+     * @param {ReorderPathPartRequest} reorderPathPartRequest
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    reorderPathPartRequestOpts(requestParameters: ReorderPathPartOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * @summary Reorder Path Part Handler
+     * @param {string} pathPartId
+     * @param {ReorderPathPartRequest} reorderPathPartRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    reorderPathPartRaw(requestParameters: ReorderPathPartOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartResponse>>;
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * Reorder Path Part Handler
+     */
+    reorderPathPart(requestParameters: ReorderPathPartOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartResponse>;
     /**
      * Creates request options for setPathPartTags without sending the request
      * @param {string} pathPartId
@@ -479,6 +506,20 @@ export declare class PathPartsApi extends runtime.BaseAPI implements PathPartsAp
      * List Path Parts Handler
      */
     listPathParts(requestParameters?: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponsePathPartResponse>;
+    /**
+     * Creates request options for reorderPathPart without sending the request
+     */
+    reorderPathPartRequestOpts(requestParameters: ReorderPathPartOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * Reorder Path Part Handler
+     */
+    reorderPathPartRaw(requestParameters: ReorderPathPartOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartResponse>>;
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * Reorder Path Part Handler
+     */
+    reorderPathPart(requestParameters: ReorderPathPartOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartResponse>;
     /**
      * Creates request options for setPathPartTags without sending the request
      */

package/dist/apis/PathPartsApi.js

@@ -560,6 +560,59 @@ class PathPartsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for reorderPathPart without sending the request
+     */
+    reorderPathPartRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['pathPartId'] == null) {
+                throw new runtime.RequiredError('pathPartId', 'Required parameter "pathPartId" was null or undefined when calling reorderPathPart().');
+            }
+            if (requestParameters['reorderPathPartRequest'] == null) {
+                throw new runtime.RequiredError('reorderPathPartRequest', 'Required parameter "reorderPathPartRequest" was null or undefined when calling reorderPathPart().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/path-parts/{path_part_id}/reorder`;
+            urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.ReorderPathPartRequestToJSON)(requestParameters['reorderPathPartRequest']),
+            };
+        });
+    }
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * Reorder Path Part Handler
+     */
+    reorderPathPartRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.reorderPathPartRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PathPartResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * Reorder Path Part Handler
+     */
+    reorderPathPart(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.reorderPathPartRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for setPathPartTags without sending the request
      */

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

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AccessCheckResponse, AncestryResponse, AppendEventRequest, BulkTagRequest, EventResponse, PaginatedResponseEventResponse, PaginatedResponsePathPartResponse, PathOrder, PathPartResponse, PathPartTagsResponse, PermissionCapability, SortDirection, SubtreeChunksResponse, TransferOwnerRequest, TransferOwnerResponse } from '../models/index';
+import type { AccessCheckResponse, AncestryResponse, AppendEventRequest, BulkTagRequest, EventResponse, PaginatedResponseEventResponse, PaginatedResponsePathPartResponse, PathOrder, PathPartResponse, PathPartTagsResponse, PermissionCapability, ReorderPathPartRequest, SortDirection, SubtreeChunksResponse, TransferOwnerRequest, TransferOwnerResponse } from '../models/index';
 export interface AppendPathPartEventRequest {
     pathPartId: string;
     appendEventRequest: AppendEventRequest;
@@ -58,6 +58,10 @@ export interface ListPathPartsRequest {
     updatedAfter?: Date | null;
     updatedBefore?: Date | null;
 }
+export interface ReorderPathPartOperationRequest {
+    pathPartId: string;
+    reorderPathPartRequest: ReorderPathPartRequest;
+}
 export interface SetPathPartTagsRequest {
     pathPartId: string;
     bulkTagRequest: BulkTagRequest;
@@ -302,6 +306,29 @@ export interface PathPartsApiInterface {
      * List Path Parts Handler
      */
     listPathParts(requestParameters: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponsePathPartResponse>;
+    /**
+     * Creates request options for reorderPathPart without sending the request
+     * @param {string} pathPartId
+     * @param {ReorderPathPartRequest} reorderPathPartRequest
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    reorderPathPartRequestOpts(requestParameters: ReorderPathPartOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * @summary Reorder Path Part Handler
+     * @param {string} pathPartId
+     * @param {ReorderPathPartRequest} reorderPathPartRequest
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    reorderPathPartRaw(requestParameters: ReorderPathPartOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartResponse>>;
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * Reorder Path Part Handler
+     */
+    reorderPathPart(requestParameters: ReorderPathPartOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartResponse>;
     /**
      * Creates request options for setPathPartTags without sending the request
      * @param {string} pathPartId
@@ -479,6 +506,20 @@ export declare class PathPartsApi extends runtime.BaseAPI implements PathPartsAp
      * List Path Parts Handler
      */
     listPathParts(requestParameters?: ListPathPartsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponsePathPartResponse>;
+    /**
+     * Creates request options for reorderPathPart without sending the request
+     */
+    reorderPathPartRequestOpts(requestParameters: ReorderPathPartOperationRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * Reorder Path Part Handler
+     */
+    reorderPathPartRaw(requestParameters: ReorderPathPartOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PathPartResponse>>;
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * Reorder Path Part Handler
+     */
+    reorderPathPart(requestParameters: ReorderPathPartOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartResponse>;
     /**
      * Creates request options for setPathPartTags without sending the request
      */

package/dist/esm/apis/PathPartsApi.js

@@ -21,7 +21,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import * as runtime from '../runtime';
-import { AccessCheckResponseFromJSON, AncestryResponseFromJSON, AppendEventRequestToJSON, BulkTagRequestToJSON, EventResponseFromJSON, PaginatedResponseEventResponseFromJSON, PaginatedResponsePathPartResponseFromJSON, PathPartResponseFromJSON, PathPartTagsResponseFromJSON, SubtreeChunksResponseFromJSON, TransferOwnerRequestToJSON, TransferOwnerResponseFromJSON, } from '../models/index';
+import { AccessCheckResponseFromJSON, AncestryResponseFromJSON, AppendEventRequestToJSON, BulkTagRequestToJSON, EventResponseFromJSON, PaginatedResponseEventResponseFromJSON, PaginatedResponsePathPartResponseFromJSON, PathPartResponseFromJSON, PathPartTagsResponseFromJSON, ReorderPathPartRequestToJSON, SubtreeChunksResponseFromJSON, TransferOwnerRequestToJSON, TransferOwnerResponseFromJSON, } from '../models/index';
 /**
  *
  */
@@ -524,6 +524,59 @@ export class PathPartsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for reorderPathPart without sending the request
+     */
+    reorderPathPartRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['pathPartId'] == null) {
+                throw new runtime.RequiredError('pathPartId', 'Required parameter "pathPartId" was null or undefined when calling reorderPathPart().');
+            }
+            if (requestParameters['reorderPathPartRequest'] == null) {
+                throw new runtime.RequiredError('reorderPathPartRequest', 'Required parameter "reorderPathPartRequest" was null or undefined when calling reorderPathPart().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (this.configuration && this.configuration.accessToken) {
+                const token = this.configuration.accessToken;
+                const tokenString = yield token("bearerAuth", []);
+                if (tokenString) {
+                    headerParameters["Authorization"] = `Bearer ${tokenString}`;
+                }
+            }
+            let urlPath = `/v1/path-parts/{path_part_id}/reorder`;
+            urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: ReorderPathPartRequestToJSON(requestParameters['reorderPathPartRequest']),
+            };
+        });
+    }
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * Reorder Path Part Handler
+     */
+    reorderPathPartRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.reorderPathPartRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => PathPartResponseFromJSON(jsonValue));
+        });
+    }
+    /**
+     * Reorder a path part within its sibling list.  The left-nav order follows the path_part sibling linked list: one per-parent chain shared by everyone in the tenant. Moving is confined to the node\'s current parent; use the folder/document move endpoints to change parents.
+     * Reorder Path Part Handler
+     */
+    reorderPathPart(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.reorderPathPartRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for setPathPartTags without sending the request
      */

package/dist/esm/models/EventResponse.d.ts

@@ -10,12 +10,14 @@
  * Do not edit the class manually.
  */
 import type { UserInfo } from './UserInfo';
+import type { ResolvedRef } from './ResolvedRef';
 /**
  * One event row, anchored to a path_part subject.
  *
  * ``kind`` is namespaced ``domain.action`` (e.g. ``workflow.approval``,
  * ``document.created``). ``payload`` is the domain-specific structured
- * JSON associated with the event.
+ * JSON associated with the event, stored verbatim and never rewritten —
+ * the human-readable resolution lives alongside it in ``references``.
  * @export
  * @interface EventResponse
  */
@@ -64,6 +66,38 @@ export interface EventResponse {
      * @memberof EventResponse
      */
     actor?: UserInfo | null;
+    /**
+     *
+     * @type {string}
+     * @memberof EventResponse
+     */
+    subjectName?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof EventResponse
+     */
+    subjectPath?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof EventResponse
+     */
+    subjectObjectId?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof EventResponse
+     */
+    subjectPartType?: string | null;
+    /**
+     *
+     * @type {{ [key: string]: ResolvedRef; }}
+     * @memberof EventResponse
+     */
+    references?: {
+        [key: string]: ResolvedRef;
+    };
 }
 export declare const EventResponsePropertyValidationAttributesMap: {
     [property: string]: {

package/dist/esm/models/EventResponse.js

@@ -11,7 +11,9 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import { mapValues } from '../runtime';
 import { UserInfoFromJSON, UserInfoToJSON, } from './UserInfo';
+import { ResolvedRefFromJSON, ResolvedRefToJSON, } from './ResolvedRef';
 export const EventResponsePropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the EventResponse interface.
@@ -46,6 +48,11 @@ export function EventResponseFromJSONTyped(json, ignoreDiscriminator) {
         'actorUserId': json['actor_user_id'],
         'payload': json['payload'],
         'actor': json['actor'] == null ? undefined : UserInfoFromJSON(json['actor']),
+        'subjectName': json['subject_name'] == null ? undefined : json['subject_name'],
+        'subjectPath': json['subject_path'] == null ? undefined : json['subject_path'],
+        'subjectObjectId': json['subject_object_id'] == null ? undefined : json['subject_object_id'],
+        'subjectPartType': json['subject_part_type'] == null ? undefined : json['subject_part_type'],
+        'references': json['references'] == null ? undefined : (mapValues(json['references'], ResolvedRefFromJSON)),
     };
 }
 export function EventResponseToJSON(json) {
@@ -63,5 +70,10 @@ export function EventResponseToJSONTyped(value, ignoreDiscriminator = false) {
         'actor_user_id': value['actorUserId'],
         'payload': value['payload'],
         'actor': UserInfoToJSON(value['actor']),
+        'subject_name': value['subjectName'],
+        'subject_path': value['subjectPath'],
+        'subject_object_id': value['subjectObjectId'],
+        'subject_part_type': value['subjectPartType'],
+        'references': value['references'] == null ? undefined : (mapValues(value['references'], ResolvedRefToJSON)),
     };
 }

package/dist/esm/models/ReorderPathPartRequest.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * 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.
+ */
+/**
+ * Reorder a path part within its sibling list.
+ * @export
+ * @interface ReorderPathPartRequest
+ */
+export interface ReorderPathPartRequest {
+    /**
+     * Place this node immediately after the given sibling PathPart id (must share the same parent). Pass the current tail's id to move to the end. Requires move_to_head=false.
+     * @type {string}
+     * @memberof ReorderPathPartRequest
+     */
+    prevSiblingPathId?: string | null;
+    /**
+     * Move this node to the head of its sibling list.
+     * @type {boolean}
+     * @memberof ReorderPathPartRequest
+     */
+    moveToHead?: boolean;
+}
+export declare const ReorderPathPartRequestPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};
+/**
+ * Check if a given object implements the ReorderPathPartRequest interface.
+ */
+export declare function instanceOfReorderPathPartRequest(value: object): value is ReorderPathPartRequest;
+export declare function ReorderPathPartRequestFromJSON(json: any): ReorderPathPartRequest;
+export declare function ReorderPathPartRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): ReorderPathPartRequest;
+export declare function ReorderPathPartRequestToJSON(json: any): ReorderPathPartRequest;
+export declare function ReorderPathPartRequestToJSONTyped(value?: ReorderPathPartRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/ReorderPathPartRequest.js

@@ -0,0 +1,44 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * 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.
+ */
+export const ReorderPathPartRequestPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the ReorderPathPartRequest interface.
+ */
+export function instanceOfReorderPathPartRequest(value) {
+    return true;
+}
+export function ReorderPathPartRequestFromJSON(json) {
+    return ReorderPathPartRequestFromJSONTyped(json, false);
+}
+export function ReorderPathPartRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'prevSiblingPathId': json['prev_sibling_path_id'] == null ? undefined : json['prev_sibling_path_id'],
+        'moveToHead': json['move_to_head'] == null ? undefined : json['move_to_head'],
+    };
+}
+export function ReorderPathPartRequestToJSON(json) {
+    return ReorderPathPartRequestToJSONTyped(json, false);
+}
+export function ReorderPathPartRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'prev_sibling_path_id': value['prevSiblingPathId'],
+        'move_to_head': value['moveToHead'],
+    };
+}

package/dist/esm/models/ResolvedRef.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * 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.
+ */
+/**
+ * One id resolved to a human-readable, linkable entity.
+ *
+ * Every UUID that appears in an event (its subject, its actor, and any id
+ * inside the payload) resolves to one of these so the frontend can render a
+ * name and a link instead of a bare UUID. ``object_id`` is what the frontend
+ * routes on: a PDO id for a path_part (never the internal path_part_id), or
+ * the user id for a user.
+ * @export
+ * @interface ResolvedRef
+ */
+export interface ResolvedRef {
+    /**
+     *
+     * @type {ResolvedRefEntityTypeEnum}
+     * @memberof ResolvedRef
+     */
+    entityType: ResolvedRefEntityTypeEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof ResolvedRef
+     */
+    objectId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ResolvedRef
+     */
+    displayName?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof ResolvedRef
+     */
+    partType?: string | null;
+}
+/**
+ * @export
+ */
+export declare const ResolvedRefEntityTypeEnum: {
+    readonly PathPart: 'path_part';
+    readonly User: 'user';
+};
+export type ResolvedRefEntityTypeEnum = typeof ResolvedRefEntityTypeEnum[keyof typeof ResolvedRefEntityTypeEnum];
+export declare const ResolvedRefPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};
+/**
+ * Check if a given object implements the ResolvedRef interface.
+ */
+export declare function instanceOfResolvedRef(value: object): value is ResolvedRef;
+export declare function ResolvedRefFromJSON(json: any): ResolvedRef;
+export declare function ResolvedRefFromJSONTyped(json: any, ignoreDiscriminator: boolean): ResolvedRef;
+export declare function ResolvedRefToJSON(json: any): ResolvedRef;
+export declare function ResolvedRefToJSONTyped(value?: ResolvedRef | null, ignoreDiscriminator?: boolean): any;