@knowledge-stack/ksapi 3.16.1 → 3.17.0

package/dist/esm/models/{MemoryChunkResponse.js → MemoryEntryResponse.js}

@@ -12,11 +12,11 @@
  * Do not edit the class manually.
  */
 import { MemoryKindFromJSON, MemoryKindToJSON, } from './MemoryKind';
-export const MemoryChunkResponsePropertyValidationAttributesMap = {};
+export const MemoryEntryResponsePropertyValidationAttributesMap = {};
 /**
- * Check if a given object implements the MemoryChunkResponse interface.
+ * Check if a given object implements the MemoryEntryResponse interface.
  */
-export function instanceOfMemoryChunkResponse(value) {
+export function instanceOfMemoryEntryResponse(value) {
     if (!('chunkId' in value) || value['chunkId'] === undefined)
         return false;
     if (!('kind' in value) || value['kind'] === undefined)
@@ -25,10 +25,10 @@ export function instanceOfMemoryChunkResponse(value) {
         return false;
     return true;
 }
-export function MemoryChunkResponseFromJSON(json) {
-    return MemoryChunkResponseFromJSONTyped(json, false);
+export function MemoryEntryResponseFromJSON(json) {
+    return MemoryEntryResponseFromJSONTyped(json, false);
 }
-export function MemoryChunkResponseFromJSONTyped(json, ignoreDiscriminator) {
+export function MemoryEntryResponseFromJSONTyped(json, ignoreDiscriminator) {
     if (json == null) {
         return json;
     }
@@ -38,10 +38,10 @@ export function MemoryChunkResponseFromJSONTyped(json, ignoreDiscriminator) {
         'body': json['body'],
     };
 }
-export function MemoryChunkResponseToJSON(json) {
-    return MemoryChunkResponseToJSONTyped(json, false);
+export function MemoryEntryResponseToJSON(json) {
+    return MemoryEntryResponseToJSONTyped(json, false);
 }
-export function MemoryChunkResponseToJSONTyped(value, ignoreDiscriminator = false) {
+export function MemoryEntryResponseToJSONTyped(value, ignoreDiscriminator = false) {
     if (value == null) {
         return value;
     }

package/dist/esm/models/{PaginatedResponseMemoryChunkResponse.d.ts → PaginatedResponseMemoryEntryResponse.d.ts}

@@ -9,39 +9,39 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-import type { MemoryChunkResponse } from './MemoryChunkResponse';
+import type { MemoryEntryResponse } from './MemoryEntryResponse';
 /**
  *
  * @export
- * @interface PaginatedResponseMemoryChunkResponse
+ * @interface PaginatedResponseMemoryEntryResponse
  */
-export interface PaginatedResponseMemoryChunkResponse {
+export interface PaginatedResponseMemoryEntryResponse {
     /**
      * List of items
-     * @type {Array<MemoryChunkResponse>}
-     * @memberof PaginatedResponseMemoryChunkResponse
+     * @type {Array<MemoryEntryResponse>}
+     * @memberof PaginatedResponseMemoryEntryResponse
      */
-    items: Array<MemoryChunkResponse>;
+    items: Array<MemoryEntryResponse>;
     /**
      * Total number of items
      * @type {number}
-     * @memberof PaginatedResponseMemoryChunkResponse
+     * @memberof PaginatedResponseMemoryEntryResponse
      */
     total: number;
     /**
      * Number of items per page
      * @type {number}
-     * @memberof PaginatedResponseMemoryChunkResponse
+     * @memberof PaginatedResponseMemoryEntryResponse
      */
     limit: number;
     /**
      * Number of items to skip
      * @type {number}
-     * @memberof PaginatedResponseMemoryChunkResponse
+     * @memberof PaginatedResponseMemoryEntryResponse
      */
     offset: number;
 }
-export declare const PaginatedResponseMemoryChunkResponsePropertyValidationAttributesMap: {
+export declare const PaginatedResponseMemoryEntryResponsePropertyValidationAttributesMap: {
     [property: string]: {
         maxLength?: number;
         minLength?: number;
@@ -57,10 +57,10 @@ export declare const PaginatedResponseMemoryChunkResponsePropertyValidationAttri
     };
 };
 /**
- * Check if a given object implements the PaginatedResponseMemoryChunkResponse interface.
+ * Check if a given object implements the PaginatedResponseMemoryEntryResponse interface.
  */
-export declare function instanceOfPaginatedResponseMemoryChunkResponse(value: object): value is PaginatedResponseMemoryChunkResponse;
-export declare function PaginatedResponseMemoryChunkResponseFromJSON(json: any): PaginatedResponseMemoryChunkResponse;
-export declare function PaginatedResponseMemoryChunkResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): PaginatedResponseMemoryChunkResponse;
-export declare function PaginatedResponseMemoryChunkResponseToJSON(json: any): PaginatedResponseMemoryChunkResponse;
-export declare function PaginatedResponseMemoryChunkResponseToJSONTyped(value?: PaginatedResponseMemoryChunkResponse | null, ignoreDiscriminator?: boolean): any;
+export declare function instanceOfPaginatedResponseMemoryEntryResponse(value: object): value is PaginatedResponseMemoryEntryResponse;
+export declare function PaginatedResponseMemoryEntryResponseFromJSON(json: any): PaginatedResponseMemoryEntryResponse;
+export declare function PaginatedResponseMemoryEntryResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): PaginatedResponseMemoryEntryResponse;
+export declare function PaginatedResponseMemoryEntryResponseToJSON(json: any): PaginatedResponseMemoryEntryResponse;
+export declare function PaginatedResponseMemoryEntryResponseToJSONTyped(value?: PaginatedResponseMemoryEntryResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/{PaginatedResponseMemoryChunkResponse.js → PaginatedResponseMemoryEntryResponse.js}

@@ -11,8 +11,8 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-import { MemoryChunkResponseFromJSON, MemoryChunkResponseToJSON, } from './MemoryChunkResponse';
-export const PaginatedResponseMemoryChunkResponsePropertyValidationAttributesMap = {
+import { MemoryEntryResponseFromJSON, MemoryEntryResponseToJSON, } from './MemoryEntryResponse';
+export const PaginatedResponseMemoryEntryResponsePropertyValidationAttributesMap = {
     total: {
         minimum: 0,
         exclusiveMinimum: false,
@@ -27,9 +27,9 @@ export const PaginatedResponseMemoryChunkResponsePropertyValidationAttributesMap
     },
 };
 /**
- * Check if a given object implements the PaginatedResponseMemoryChunkResponse interface.
+ * Check if a given object implements the PaginatedResponseMemoryEntryResponse interface.
  */
-export function instanceOfPaginatedResponseMemoryChunkResponse(value) {
+export function instanceOfPaginatedResponseMemoryEntryResponse(value) {
     if (!('items' in value) || value['items'] === undefined)
         return false;
     if (!('total' in value) || value['total'] === undefined)
@@ -40,29 +40,29 @@ export function instanceOfPaginatedResponseMemoryChunkResponse(value) {
         return false;
     return true;
 }
-export function PaginatedResponseMemoryChunkResponseFromJSON(json) {
-    return PaginatedResponseMemoryChunkResponseFromJSONTyped(json, false);
+export function PaginatedResponseMemoryEntryResponseFromJSON(json) {
+    return PaginatedResponseMemoryEntryResponseFromJSONTyped(json, false);
 }
-export function PaginatedResponseMemoryChunkResponseFromJSONTyped(json, ignoreDiscriminator) {
+export function PaginatedResponseMemoryEntryResponseFromJSONTyped(json, ignoreDiscriminator) {
     if (json == null) {
         return json;
     }
     return {
-        'items': (json['items'].map(MemoryChunkResponseFromJSON)),
+        'items': (json['items'].map(MemoryEntryResponseFromJSON)),
         'total': json['total'],
         'limit': json['limit'],
         'offset': json['offset'],
     };
 }
-export function PaginatedResponseMemoryChunkResponseToJSON(json) {
-    return PaginatedResponseMemoryChunkResponseToJSONTyped(json, false);
+export function PaginatedResponseMemoryEntryResponseToJSON(json) {
+    return PaginatedResponseMemoryEntryResponseToJSONTyped(json, false);
 }
-export function PaginatedResponseMemoryChunkResponseToJSONTyped(value, ignoreDiscriminator = false) {
+export function PaginatedResponseMemoryEntryResponseToJSONTyped(value, ignoreDiscriminator = false) {
     if (value == null) {
         return value;
     }
     return {
-        'items': (value['items'].map(MemoryChunkResponseToJSON)),
+        'items': (value['items'].map(MemoryEntryResponseToJSON)),
         'total': value['total'],
         'limit': value['limit'],
         'offset': value['offset'],

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

@@ -0,0 +1,66 @@
+/**
+ * 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.
+ */
+import type { RepoVersionResponse } from './RepoVersionResponse';
+/**
+ *
+ * @export
+ * @interface PaginatedResponseRepoVersionResponse
+ */
+export interface PaginatedResponseRepoVersionResponse {
+    /**
+     * List of items
+     * @type {Array<RepoVersionResponse>}
+     * @memberof PaginatedResponseRepoVersionResponse
+     */
+    items: Array<RepoVersionResponse>;
+    /**
+     * Total number of items
+     * @type {number}
+     * @memberof PaginatedResponseRepoVersionResponse
+     */
+    total: number;
+    /**
+     * Number of items per page
+     * @type {number}
+     * @memberof PaginatedResponseRepoVersionResponse
+     */
+    limit: number;
+    /**
+     * Number of items to skip
+     * @type {number}
+     * @memberof PaginatedResponseRepoVersionResponse
+     */
+    offset: number;
+}
+export declare const PaginatedResponseRepoVersionResponsePropertyValidationAttributesMap: {
+    [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 PaginatedResponseRepoVersionResponse interface.
+ */
+export declare function instanceOfPaginatedResponseRepoVersionResponse(value: object): value is PaginatedResponseRepoVersionResponse;
+export declare function PaginatedResponseRepoVersionResponseFromJSON(json: any): PaginatedResponseRepoVersionResponse;
+export declare function PaginatedResponseRepoVersionResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): PaginatedResponseRepoVersionResponse;
+export declare function PaginatedResponseRepoVersionResponseToJSON(json: any): PaginatedResponseRepoVersionResponse;
+export declare function PaginatedResponseRepoVersionResponseToJSONTyped(value?: PaginatedResponseRepoVersionResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/PaginatedResponseRepoVersionResponse.js

@@ -0,0 +1,70 @@
+/* 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.
+ */
+import { RepoVersionResponseFromJSON, RepoVersionResponseToJSON, } from './RepoVersionResponse';
+export const PaginatedResponseRepoVersionResponsePropertyValidationAttributesMap = {
+    total: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+    limit: {
+        minimum: 1,
+        exclusiveMinimum: false,
+    },
+    offset: {
+        minimum: 0,
+        exclusiveMinimum: false,
+    },
+};
+/**
+ * Check if a given object implements the PaginatedResponseRepoVersionResponse interface.
+ */
+export function instanceOfPaginatedResponseRepoVersionResponse(value) {
+    if (!('items' in value) || value['items'] === undefined)
+        return false;
+    if (!('total' in value) || value['total'] === undefined)
+        return false;
+    if (!('limit' in value) || value['limit'] === undefined)
+        return false;
+    if (!('offset' in value) || value['offset'] === undefined)
+        return false;
+    return true;
+}
+export function PaginatedResponseRepoVersionResponseFromJSON(json) {
+    return PaginatedResponseRepoVersionResponseFromJSONTyped(json, false);
+}
+export function PaginatedResponseRepoVersionResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'items': (json['items'].map(RepoVersionResponseFromJSON)),
+        'total': json['total'],
+        'limit': json['limit'],
+        'offset': json['offset'],
+    };
+}
+export function PaginatedResponseRepoVersionResponseToJSON(json) {
+    return PaginatedResponseRepoVersionResponseToJSONTyped(json, false);
+}
+export function PaginatedResponseRepoVersionResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'items': (value['items'].map(RepoVersionResponseToJSON)),
+        'total': value['total'],
+        'limit': value['limit'],
+        'offset': value['offset'],
+    };
+}

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

@@ -0,0 +1,60 @@
+/**
+ * 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.
+ */
+import type { RepoSaveSkipReason } from './RepoSaveSkipReason';
+/**
+ *
+ * @export
+ * @interface RecordRepoSaveSkipRequest
+ */
+export interface RecordRepoSaveSkipRequest {
+    /**
+     * The run whose turn produced the changes.
+     * @type {string}
+     * @memberof RecordRepoSaveSkipRequest
+     */
+    runId: string;
+    /**
+     *
+     * @type {RepoSaveSkipReason}
+     * @memberof RecordRepoSaveSkipRequest
+     */
+    reason: RepoSaveSkipReason;
+    /**
+     * A machine-readable code adding context, e.g. the refusal code (`repo_too_large`) or `commits_not_on_main`; never free text.
+     * @type {string}
+     * @memberof RecordRepoSaveSkipRequest
+     */
+    detail?: string | null;
+}
+export declare const RecordRepoSaveSkipRequestPropertyValidationAttributesMap: {
+    [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 RecordRepoSaveSkipRequest interface.
+ */
+export declare function instanceOfRecordRepoSaveSkipRequest(value: object): value is RecordRepoSaveSkipRequest;
+export declare function RecordRepoSaveSkipRequestFromJSON(json: any): RecordRepoSaveSkipRequest;
+export declare function RecordRepoSaveSkipRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): RecordRepoSaveSkipRequest;
+export declare function RecordRepoSaveSkipRequestToJSON(json: any): RecordRepoSaveSkipRequest;
+export declare function RecordRepoSaveSkipRequestToJSONTyped(value?: RecordRepoSaveSkipRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/RecordRepoSaveSkipRequest.js

@@ -0,0 +1,55 @@
+/* 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.
+ */
+import { RepoSaveSkipReasonFromJSON, RepoSaveSkipReasonToJSON, } from './RepoSaveSkipReason';
+export const RecordRepoSaveSkipRequestPropertyValidationAttributesMap = {
+    detail: {
+        pattern: '/^[a-z0-9_]{1,64}$/',
+    },
+};
+/**
+ * Check if a given object implements the RecordRepoSaveSkipRequest interface.
+ */
+export function instanceOfRecordRepoSaveSkipRequest(value) {
+    if (!('runId' in value) || value['runId'] === undefined)
+        return false;
+    if (!('reason' in value) || value['reason'] === undefined)
+        return false;
+    return true;
+}
+export function RecordRepoSaveSkipRequestFromJSON(json) {
+    return RecordRepoSaveSkipRequestFromJSONTyped(json, false);
+}
+export function RecordRepoSaveSkipRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'runId': json['run_id'],
+        'reason': RepoSaveSkipReasonFromJSON(json['reason']),
+        'detail': json['detail'] == null ? undefined : json['detail'],
+    };
+}
+export function RecordRepoSaveSkipRequestToJSON(json) {
+    return RecordRepoSaveSkipRequestToJSONTyped(json, false);
+}
+export function RecordRepoSaveSkipRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'run_id': value['runId'],
+        'reason': RepoSaveSkipReasonToJSON(value['reason']),
+        'detail': value['detail'],
+    };
+}

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

@@ -0,0 +1,126 @@
+/**
+ * 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.
+ */
+import type { RepoTreeEntry } from './RepoTreeEntry';
+/**
+ * A retained run branch, independently of whether it reached main.
+ * @export
+ * @interface RepoBranchResponse
+ */
+export interface RepoBranchResponse {
+    /**
+     *
+     * @type {string}
+     * @memberof RepoBranchResponse
+     */
+    versionId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof RepoBranchResponse
+     */
+    headSha: string;
+    /**
+     *
+     * @type {string}
+     * @memberof RepoBranchResponse
+     */
+    previousHeadSha: string | null;
+    /**
+     *
+     * @type {number}
+     * @memberof RepoBranchResponse
+     */
+    commitsAdded: number;
+    /**
+     *
+     * @type {string}
+     * @memberof RepoBranchResponse
+     */
+    runId: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof RepoBranchResponse
+     */
+    savedByUserId: string;
+    /**
+     *
+     * @type {Date}
+     * @memberof RepoBranchResponse
+     */
+    savedAt: Date;
+    /**
+     *
+     * @type {string}
+     * @memberof RepoBranchResponse
+     */
+    instructionVersionId: string | null;
+    /**
+     * Retained run-branch version this publication integrated.
+     * @type {string}
+     * @memberof RepoBranchResponse
+     */
+    candidateVersionId?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof RepoBranchResponse
+     */
+    branch: string;
+    /**
+     *
+     * @type {string}
+     * @memberof RepoBranchResponse
+     */
+    baseVersionId: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof RepoBranchResponse
+     */
+    integratedVersionId: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof RepoBranchResponse
+     */
+    integratedHeadSha: string | null;
+    /**
+     *
+     * @type {Array<RepoTreeEntry>}
+     * @memberof RepoBranchResponse
+     */
+    files: Array<RepoTreeEntry>;
+}
+export declare const RepoBranchResponsePropertyValidationAttributesMap: {
+    [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 RepoBranchResponse interface.
+ */
+export declare function instanceOfRepoBranchResponse(value: object): value is RepoBranchResponse;
+export declare function RepoBranchResponseFromJSON(json: any): RepoBranchResponse;
+export declare function RepoBranchResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): RepoBranchResponse;
+export declare function RepoBranchResponseToJSON(json: any): RepoBranchResponse;
+export declare function RepoBranchResponseToJSONTyped(value?: RepoBranchResponse | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/RepoBranchResponse.js

@@ -0,0 +1,95 @@
+/* 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.
+ */
+import { RepoTreeEntryFromJSON, RepoTreeEntryToJSON, } from './RepoTreeEntry';
+export const RepoBranchResponsePropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the RepoBranchResponse interface.
+ */
+export function instanceOfRepoBranchResponse(value) {
+    if (!('versionId' in value) || value['versionId'] === undefined)
+        return false;
+    if (!('headSha' in value) || value['headSha'] === undefined)
+        return false;
+    if (!('previousHeadSha' in value) || value['previousHeadSha'] === undefined)
+        return false;
+    if (!('commitsAdded' in value) || value['commitsAdded'] === undefined)
+        return false;
+    if (!('runId' in value) || value['runId'] === undefined)
+        return false;
+    if (!('savedByUserId' in value) || value['savedByUserId'] === undefined)
+        return false;
+    if (!('savedAt' in value) || value['savedAt'] === undefined)
+        return false;
+    if (!('instructionVersionId' in value) || value['instructionVersionId'] === undefined)
+        return false;
+    if (!('branch' in value) || value['branch'] === undefined)
+        return false;
+    if (!('baseVersionId' in value) || value['baseVersionId'] === undefined)
+        return false;
+    if (!('integratedVersionId' in value) || value['integratedVersionId'] === undefined)
+        return false;
+    if (!('integratedHeadSha' in value) || value['integratedHeadSha'] === undefined)
+        return false;
+    if (!('files' in value) || value['files'] === undefined)
+        return false;
+    return true;
+}
+export function RepoBranchResponseFromJSON(json) {
+    return RepoBranchResponseFromJSONTyped(json, false);
+}
+export function RepoBranchResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'versionId': json['version_id'],
+        'headSha': json['head_sha'],
+        'previousHeadSha': json['previous_head_sha'],
+        'commitsAdded': json['commits_added'],
+        'runId': json['run_id'],
+        'savedByUserId': json['saved_by_user_id'],
+        'savedAt': (new Date(json['saved_at'])),
+        'instructionVersionId': json['instruction_version_id'],
+        'candidateVersionId': json['candidate_version_id'] == null ? undefined : json['candidate_version_id'],
+        'branch': json['branch'],
+        'baseVersionId': json['base_version_id'],
+        'integratedVersionId': json['integrated_version_id'],
+        'integratedHeadSha': json['integrated_head_sha'],
+        'files': (json['files'].map(RepoTreeEntryFromJSON)),
+    };
+}
+export function RepoBranchResponseToJSON(json) {
+    return RepoBranchResponseToJSONTyped(json, false);
+}
+export function RepoBranchResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'version_id': value['versionId'],
+        'head_sha': value['headSha'],
+        'previous_head_sha': value['previousHeadSha'],
+        'commits_added': value['commitsAdded'],
+        'run_id': value['runId'],
+        'saved_by_user_id': value['savedByUserId'],
+        'saved_at': value['savedAt'].toISOString(),
+        'instruction_version_id': value['instructionVersionId'],
+        'candidate_version_id': value['candidateVersionId'],
+        'branch': value['branch'],
+        'base_version_id': value['baseVersionId'],
+        'integrated_version_id': value['integratedVersionId'],
+        'integrated_head_sha': value['integratedHeadSha'],
+        'files': (value['files'].map(RepoTreeEntryToJSON)),
+    };
+}