@knowledge-stack/ksapi 1.143.0 → 1.144.0

package/dist/esm/models/ResolvedRef.js

@@ -0,0 +1,59 @@
+/* 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
+ */
+export const ResolvedRefEntityTypeEnum = {
+    PathPart: 'path_part',
+    User: 'user'
+};
+export const ResolvedRefPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the ResolvedRef interface.
+ */
+export function instanceOfResolvedRef(value) {
+    if (!('entityType' in value) || value['entityType'] === undefined)
+        return false;
+    if (!('objectId' in value) || value['objectId'] === undefined)
+        return false;
+    return true;
+}
+export function ResolvedRefFromJSON(json) {
+    return ResolvedRefFromJSONTyped(json, false);
+}
+export function ResolvedRefFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'entityType': json['entity_type'],
+        'objectId': json['object_id'],
+        'displayName': json['display_name'] == null ? undefined : json['display_name'],
+        'partType': json['part_type'] == null ? undefined : json['part_type'],
+    };
+}
+export function ResolvedRefToJSON(json) {
+    return ResolvedRefToJSONTyped(json, false);
+}
+export function ResolvedRefToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'entity_type': value['entityType'],
+        'object_id': value['objectId'],
+        'display_name': value['displayName'],
+        'part_type': value['partType'],
+    };
+}

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

@@ -225,7 +225,9 @@ export * from './ProposeMemoryChunkRequest';
 export * from './ProposedMemoryChunkResponse';
 export * from './ReasoningPart';
 export * from './ReferenceType';
+export * from './ReorderPathPartRequest';
 export * from './RequestPhoneChangeRequest';
+export * from './ResolvedRef';
 export * from './ResolvedReferenceInput';
 export * from './ResolvedReferenceOutput';
 export * from './ResponseSendPwResetEmail';

package/dist/esm/models/index.js

@@ -227,7 +227,9 @@ export * from './ProposeMemoryChunkRequest';
 export * from './ProposedMemoryChunkResponse';
 export * from './ReasoningPart';
 export * from './ReferenceType';
+export * from './ReorderPathPartRequest';
 export * from './RequestPhoneChangeRequest';
+export * from './ResolvedRef';
 export * from './ResolvedReferenceInput';
 export * from './ResolvedReferenceOutput';
 export * from './ResponseSendPwResetEmail';

package/dist/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/models/EventResponse.js

@@ -19,7 +19,9 @@ exports.EventResponseFromJSON = EventResponseFromJSON;
 exports.EventResponseFromJSONTyped = EventResponseFromJSONTyped;
 exports.EventResponseToJSON = EventResponseToJSON;
 exports.EventResponseToJSONTyped = EventResponseToJSONTyped;
+const runtime_1 = require("../runtime");
 const UserInfo_1 = require("./UserInfo");
+const ResolvedRef_1 = require("./ResolvedRef");
 exports.EventResponsePropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the EventResponse interface.
@@ -54,6 +56,11 @@ function EventResponseFromJSONTyped(json, ignoreDiscriminator) {
         'actorUserId': json['actor_user_id'],
         'payload': json['payload'],
         'actor': json['actor'] == null ? undefined : (0, UserInfo_1.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 : ((0, runtime_1.mapValues)(json['references'], ResolvedRef_1.ResolvedRefFromJSON)),
     };
 }
 function EventResponseToJSON(json) {
@@ -71,5 +78,10 @@ function EventResponseToJSONTyped(value, ignoreDiscriminator = false) {
         'actor_user_id': value['actorUserId'],
         'payload': value['payload'],
         'actor': (0, UserInfo_1.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 : ((0, runtime_1.mapValues)(value['references'], ResolvedRef_1.ResolvedRefToJSON)),
     };
 }

package/dist/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/models/ReorderPathPartRequest.js

@@ -0,0 +1,52 @@
+"use strict";
+/* 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReorderPathPartRequestPropertyValidationAttributesMap = void 0;
+exports.instanceOfReorderPathPartRequest = instanceOfReorderPathPartRequest;
+exports.ReorderPathPartRequestFromJSON = ReorderPathPartRequestFromJSON;
+exports.ReorderPathPartRequestFromJSONTyped = ReorderPathPartRequestFromJSONTyped;
+exports.ReorderPathPartRequestToJSON = ReorderPathPartRequestToJSON;
+exports.ReorderPathPartRequestToJSONTyped = ReorderPathPartRequestToJSONTyped;
+exports.ReorderPathPartRequestPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the ReorderPathPartRequest interface.
+ */
+function instanceOfReorderPathPartRequest(value) {
+    return true;
+}
+function ReorderPathPartRequestFromJSON(json) {
+    return ReorderPathPartRequestFromJSONTyped(json, false);
+}
+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'],
+    };
+}
+function ReorderPathPartRequestToJSON(json) {
+    return ReorderPathPartRequestToJSONTyped(json, false);
+}
+function ReorderPathPartRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'prev_sibling_path_id': value['prevSiblingPathId'],
+        'move_to_head': value['moveToHead'],
+    };
+}

package/dist/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;

package/dist/models/ResolvedRef.js

@@ -0,0 +1,67 @@
+"use strict";
+/* 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResolvedRefPropertyValidationAttributesMap = exports.ResolvedRefEntityTypeEnum = void 0;
+exports.instanceOfResolvedRef = instanceOfResolvedRef;
+exports.ResolvedRefFromJSON = ResolvedRefFromJSON;
+exports.ResolvedRefFromJSONTyped = ResolvedRefFromJSONTyped;
+exports.ResolvedRefToJSON = ResolvedRefToJSON;
+exports.ResolvedRefToJSONTyped = ResolvedRefToJSONTyped;
+/**
+ * @export
+ */
+exports.ResolvedRefEntityTypeEnum = {
+    PathPart: 'path_part',
+    User: 'user'
+};
+exports.ResolvedRefPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the ResolvedRef interface.
+ */
+function instanceOfResolvedRef(value) {
+    if (!('entityType' in value) || value['entityType'] === undefined)
+        return false;
+    if (!('objectId' in value) || value['objectId'] === undefined)
+        return false;
+    return true;
+}
+function ResolvedRefFromJSON(json) {
+    return ResolvedRefFromJSONTyped(json, false);
+}
+function ResolvedRefFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'entityType': json['entity_type'],
+        'objectId': json['object_id'],
+        'displayName': json['display_name'] == null ? undefined : json['display_name'],
+        'partType': json['part_type'] == null ? undefined : json['part_type'],
+    };
+}
+function ResolvedRefToJSON(json) {
+    return ResolvedRefToJSONTyped(json, false);
+}
+function ResolvedRefToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'entity_type': value['entityType'],
+        'object_id': value['objectId'],
+        'display_name': value['displayName'],
+        'part_type': value['partType'],
+    };
+}

package/dist/models/index.d.ts

@@ -225,7 +225,9 @@ export * from './ProposeMemoryChunkRequest';
 export * from './ProposedMemoryChunkResponse';
 export * from './ReasoningPart';
 export * from './ReferenceType';
+export * from './ReorderPathPartRequest';
 export * from './RequestPhoneChangeRequest';
+export * from './ResolvedRef';
 export * from './ResolvedReferenceInput';
 export * from './ResolvedReferenceOutput';
 export * from './ResponseSendPwResetEmail';

package/dist/models/index.js

@@ -243,7 +243,9 @@ __exportStar(require("./ProposeMemoryChunkRequest"), exports);
 __exportStar(require("./ProposedMemoryChunkResponse"), exports);
 __exportStar(require("./ReasoningPart"), exports);
 __exportStar(require("./ReferenceType"), exports);
+__exportStar(require("./ReorderPathPartRequest"), exports);
 __exportStar(require("./RequestPhoneChangeRequest"), exports);
+__exportStar(require("./ResolvedRef"), exports);
 __exportStar(require("./ResolvedReferenceInput"), exports);
 __exportStar(require("./ResolvedReferenceOutput"), exports);
 __exportStar(require("./ResponseSendPwResetEmail"), exports);

package/docs/EventResponse.md

@@ -1,7 +1,7 @@
 
 # EventResponse
 
-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.
+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, stored verbatim and never rewritten — the human-readable resolution lives alongside it in ``references``.
 
 ## Properties
 
@@ -14,6 +14,11 @@ Name | Type
 `actorUserId` | string
 `payload` | { [key: string]: any; }
 `actor` | [UserInfo](UserInfo.md)
+`subjectName` | string
+`subjectPath` | string
+`subjectObjectId` | string
+`subjectPartType` | string
+`references` | [{ [key: string]: ResolvedRef; }](ResolvedRef.md)
 
 ## Example
 
@@ -29,6 +34,11 @@ const example = {
   "actorUserId": null,
   "payload": null,
   "actor": null,
+  "subjectName": null,
+  "subjectPath": null,
+  "subjectObjectId": null,
+  "subjectPartType": null,
+  "references": null,
 } satisfies EventResponse
 
 console.log(example)

package/docs/PathPartsApi.md

@@ -13,6 +13,7 @@ All URIs are relative to *http://localhost:8000*
 | [**getPathPartTags**](PathPartsApi.md#getpathparttags) | **GET** /v1/path-parts/{path_part_id}/tags | Get Path Part Tags Handler |
 | [**listPathPartEvents**](PathPartsApi.md#listpathpartevents) | **GET** /v1/path-parts/{path_part_id}/events | List Path Part Events Handler |
 | [**listPathParts**](PathPartsApi.md#listpathparts) | **GET** /v1/path-parts | List Path Parts Handler |
+| [**reorderPathPart**](PathPartsApi.md#reorderpathpartoperation) | **POST** /v1/path-parts/{path_part_id}/reorder | Reorder Path Part Handler |
 | [**setPathPartTags**](PathPartsApi.md#setpathparttags) | **POST** /v1/path-parts/{path_part_id}/tags | Set Path Part Tags Handler |
 | [**transferPathPartOwner**](PathPartsApi.md#transferpathpartowner) | **PUT** /v1/path-parts/{path_part_id}/owner | Transfer Path Part Owner Handler |
 
@@ -753,6 +754,84 @@ example().catch(console.error);
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## reorderPathPart
+
+> PathPartResponse reorderPathPart(pathPartId, reorderPathPartRequest)
+
+Reorder Path Part Handler
+
+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.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  PathPartsApi,
+} from '@knowledge-stack/ksapi';
+import type { ReorderPathPartOperationRequest } from '@knowledge-stack/ksapi';
+
+async function example() {
+  console.log("🚀 Testing @knowledge-stack/ksapi SDK...");
+  const config = new Configuration({ 
+    // To configure API key authorization: cookieAuth
+    apiKey: "YOUR API KEY",
+    // Configure HTTP bearer authorization: bearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new PathPartsApi(config);
+
+  const body = {
+    // string
+    pathPartId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // ReorderPathPartRequest
+    reorderPathPartRequest: ...,
+  } satisfies ReorderPathPartOperationRequest;
+
+  try {
+    const data = await api.reorderPathPart(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **pathPartId** | `string` |  | [Defaults to `undefined`] |
+| **reorderPathPartRequest** | [ReorderPathPartRequest](ReorderPathPartRequest.md) |  | |
+
+### Return type
+
+[**PathPartResponse**](PathPartResponse.md)
+
+### Authorization
+
+[cookieAuth](../README.md#cookieAuth), [bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Successful Response |  -  |
+| **422** | Validation Error |  -  |
+| **0** | Error response. |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## setPathPartTags
 
 > PathPartTagsResponse setPathPartTags(pathPartId, bulkTagRequest)

package/docs/ReorderPathPartRequest.md

@@ -0,0 +1,37 @@
+
+# ReorderPathPartRequest
+
+Reorder a path part within its sibling list.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`prevSiblingPathId` | string
+`moveToHead` | boolean
+
+## Example
+
+```typescript
+import type { ReorderPathPartRequest } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "prevSiblingPathId": null,
+  "moveToHead": null,
+} satisfies ReorderPathPartRequest
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ReorderPathPartRequest
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/docs/ResolvedRef.md

@@ -0,0 +1,41 @@
+
+# ResolvedRef
+
+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.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`entityType` | string
+`objectId` | string
+`displayName` | string
+`partType` | string
+
+## Example
+
+```typescript
+import type { ResolvedRef } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "entityType": null,
+  "objectId": null,
+  "displayName": null,
+  "partType": null,
+} satisfies ResolvedRef
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as ResolvedRef
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+