@knowledge-stack/ksapi 1.159.1 → 1.160.1

package/.openapi-generator/FILES

@@ -197,6 +197,7 @@ docs/KbMetric.md
 docs/KbSummaryResponse.md
 docs/KbTimeseriesResponse.md
 docs/LabeledSeries.md
+docs/LastRunSummary.md
 docs/LeaderboardEntry.md
 docs/LineageEdgeResponse.md
 docs/LineageGraphResponse.md
@@ -641,6 +642,7 @@ src/models/KbMetric.ts
 src/models/KbSummaryResponse.ts
 src/models/KbTimeseriesResponse.ts
 src/models/LabeledSeries.ts
+src/models/LastRunSummary.ts
 src/models/LeaderboardEntry.ts
 src/models/LineageEdgeResponse.ts
 src/models/LineageGraphResponse.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.159.1
+# @knowledge-stack/ksapi@1.160.1
 
 A TypeScript SDK client for the localhost API.
 
@@ -476,6 +476,7 @@ All URIs are relative to *http://localhost:8000*
 - [KbSummaryResponse](docs/KbSummaryResponse.md)
 - [KbTimeseriesResponse](docs/KbTimeseriesResponse.md)
 - [LabeledSeries](docs/LabeledSeries.md)
+- [LastRunSummary](docs/LastRunSummary.md)
 - [LeaderboardEntry](docs/LeaderboardEntry.md)
 - [LineageEdgeResponse](docs/LineageEdgeResponse.md)
 - [LineageGraphResponse](docs/LineageGraphResponse.md)
@@ -709,7 +710,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.159.1`
+- Package version: `1.160.1`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/WorkflowDefinitionsApi.d.ts

@@ -36,6 +36,7 @@ export interface InstantiateWorkflowTemplateOperationRequest {
 }
 export interface ListWorkflowDefinitionsRequest {
     mine?: boolean;
+    search?: string | null;
     sortBy?: WorkflowDefinitionOrder;
     sortDir?: SortDirection;
     isTemplate?: boolean;
@@ -45,6 +46,8 @@ export interface ListWorkflowDefinitionsRequest {
     createdBefore?: Date | null;
     updatedAfter?: Date | null;
     updatedBefore?: Date | null;
+    includeTagIds?: Array<string> | null;
+    excludeTagIds?: Array<string> | null;
 }
 export interface ListWorkflowRunsRequest {
     definitionId: string;
@@ -188,6 +191,7 @@ export interface WorkflowDefinitionsApiInterface {
     /**
      * Creates request options for listWorkflowDefinitions without sending the request
      * @param {boolean} [mine] Only definitions the caller created (owner).
+     * @param {string} [search] Case-insensitive substring over name and description.
      * @param {WorkflowDefinitionOrder} [sortBy] Field to sort definitions by (default: CREATED_AT)
      * @param {SortDirection} [sortDir] Sort direction; overrides the field\&#39;s natural default
      * @param {boolean} [isTemplate]
@@ -197,6 +201,8 @@ export interface WorkflowDefinitionsApiInterface {
      * @param {Date} [createdBefore] Only items created strictly before this timestamp
      * @param {Date} [updatedAfter] Only items updated at or after this timestamp (inclusive)
      * @param {Date} [updatedBefore] Only items updated strictly before this timestamp
+     * @param {Array<string>} [includeTagIds] Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance).
+     * @param {Array<string>} [excludeTagIds] Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids.
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface
      */
@@ -205,6 +211,7 @@ export interface WorkflowDefinitionsApiInterface {
      *
      * @summary List Workflow Definitions Handler
      * @param {boolean} [mine] Only definitions the caller created (owner).
+     * @param {string} [search] Case-insensitive substring over name and description.
      * @param {WorkflowDefinitionOrder} [sortBy] Field to sort definitions by (default: CREATED_AT)
      * @param {SortDirection} [sortDir] Sort direction; overrides the field\&#39;s natural default
      * @param {boolean} [isTemplate]
@@ -214,6 +221,8 @@ export interface WorkflowDefinitionsApiInterface {
      * @param {Date} [createdBefore] Only items created strictly before this timestamp
      * @param {Date} [updatedAfter] Only items updated at or after this timestamp (inclusive)
      * @param {Date} [updatedBefore] Only items updated strictly before this timestamp
+     * @param {Array<string>} [includeTagIds] Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance).
+     * @param {Array<string>} [excludeTagIds] Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface

package/dist/apis/WorkflowDefinitionsApi.js

@@ -347,6 +347,9 @@ class WorkflowDefinitionsApi extends runtime.BaseAPI {
             if (requestParameters['mine'] != null) {
                 queryParameters['mine'] = requestParameters['mine'];
             }
+            if (requestParameters['search'] != null) {
+                queryParameters['search'] = requestParameters['search'];
+            }
             if (requestParameters['sortBy'] != null) {
                 queryParameters['sort_by'] = requestParameters['sortBy'];
             }
@@ -374,6 +377,12 @@ class WorkflowDefinitionsApi extends runtime.BaseAPI {
             if (requestParameters['updatedBefore'] != null) {
                 queryParameters['updated_before'] = requestParameters['updatedBefore'].toISOString();
             }
+            if (requestParameters['includeTagIds'] != null) {
+                queryParameters['include_tag_ids'] = requestParameters['includeTagIds'];
+            }
+            if (requestParameters['excludeTagIds'] != null) {
+                queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;

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

@@ -36,6 +36,7 @@ export interface InstantiateWorkflowTemplateOperationRequest {
 }
 export interface ListWorkflowDefinitionsRequest {
     mine?: boolean;
+    search?: string | null;
     sortBy?: WorkflowDefinitionOrder;
     sortDir?: SortDirection;
     isTemplate?: boolean;
@@ -45,6 +46,8 @@ export interface ListWorkflowDefinitionsRequest {
     createdBefore?: Date | null;
     updatedAfter?: Date | null;
     updatedBefore?: Date | null;
+    includeTagIds?: Array<string> | null;
+    excludeTagIds?: Array<string> | null;
 }
 export interface ListWorkflowRunsRequest {
     definitionId: string;
@@ -188,6 +191,7 @@ export interface WorkflowDefinitionsApiInterface {
     /**
      * Creates request options for listWorkflowDefinitions without sending the request
      * @param {boolean} [mine] Only definitions the caller created (owner).
+     * @param {string} [search] Case-insensitive substring over name and description.
      * @param {WorkflowDefinitionOrder} [sortBy] Field to sort definitions by (default: CREATED_AT)
      * @param {SortDirection} [sortDir] Sort direction; overrides the field\&#39;s natural default
      * @param {boolean} [isTemplate]
@@ -197,6 +201,8 @@ export interface WorkflowDefinitionsApiInterface {
      * @param {Date} [createdBefore] Only items created strictly before this timestamp
      * @param {Date} [updatedAfter] Only items updated at or after this timestamp (inclusive)
      * @param {Date} [updatedBefore] Only items updated strictly before this timestamp
+     * @param {Array<string>} [includeTagIds] Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance).
+     * @param {Array<string>} [excludeTagIds] Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids.
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface
      */
@@ -205,6 +211,7 @@ export interface WorkflowDefinitionsApiInterface {
      *
      * @summary List Workflow Definitions Handler
      * @param {boolean} [mine] Only definitions the caller created (owner).
+     * @param {string} [search] Case-insensitive substring over name and description.
      * @param {WorkflowDefinitionOrder} [sortBy] Field to sort definitions by (default: CREATED_AT)
      * @param {SortDirection} [sortDir] Sort direction; overrides the field\&#39;s natural default
      * @param {boolean} [isTemplate]
@@ -214,6 +221,8 @@ export interface WorkflowDefinitionsApiInterface {
      * @param {Date} [createdBefore] Only items created strictly before this timestamp
      * @param {Date} [updatedAfter] Only items updated at or after this timestamp (inclusive)
      * @param {Date} [updatedBefore] Only items updated strictly before this timestamp
+     * @param {Array<string>} [includeTagIds] Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance).
+     * @param {Array<string>} [excludeTagIds] Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof WorkflowDefinitionsApiInterface

package/dist/esm/apis/WorkflowDefinitionsApi.js

@@ -311,6 +311,9 @@ export class WorkflowDefinitionsApi extends runtime.BaseAPI {
             if (requestParameters['mine'] != null) {
                 queryParameters['mine'] = requestParameters['mine'];
             }
+            if (requestParameters['search'] != null) {
+                queryParameters['search'] = requestParameters['search'];
+            }
             if (requestParameters['sortBy'] != null) {
                 queryParameters['sort_by'] = requestParameters['sortBy'];
             }
@@ -338,6 +341,12 @@ export class WorkflowDefinitionsApi extends runtime.BaseAPI {
             if (requestParameters['updatedBefore'] != null) {
                 queryParameters['updated_before'] = requestParameters['updatedBefore'].toISOString();
             }
+            if (requestParameters['includeTagIds'] != null) {
+                queryParameters['include_tag_ids'] = requestParameters['includeTagIds'];
+            }
+            if (requestParameters['excludeTagIds'] != null) {
+                queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
+            }
             const headerParameters = {};
             if (this.configuration && this.configuration.accessToken) {
                 const token = this.configuration.accessToken;

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

@@ -0,0 +1,89 @@
+/**
+ * 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 { WorkflowExecutionState } from './WorkflowExecutionState';
+import type { PathPartApprovalState } from './PathPartApprovalState';
+/**
+ * The definition's most recent run — a compact projection for list rows.
+ *
+ * ``approval_state`` is the run folder's own approval state (execution and
+ * approval are separate axes). Named to avoid colliding with the unrelated
+ * ``last_run_timestamp`` document-ingestion concept.
+ * @export
+ * @interface LastRunSummary
+ */
+export interface LastRunSummary {
+    /**
+     *
+     * @type {string}
+     * @memberof LastRunSummary
+     */
+    id: string;
+    /**
+     *
+     * @type {WorkflowExecutionState}
+     * @memberof LastRunSummary
+     */
+    executionState: WorkflowExecutionState;
+    /**
+     *
+     * @type {PathPartApprovalState}
+     * @memberof LastRunSummary
+     */
+    approvalState: PathPartApprovalState;
+    /**
+     *
+     * @type {Date}
+     * @memberof LastRunSummary
+     */
+    createdAt: Date;
+    /**
+     *
+     * @type {Date}
+     * @memberof LastRunSummary
+     */
+    startedAt?: Date | null;
+    /**
+     *
+     * @type {Date}
+     * @memberof LastRunSummary
+     */
+    completedAt?: Date | null;
+    /**
+     *
+     * @type {string}
+     * @memberof LastRunSummary
+     */
+    error?: string | null;
+}
+export declare const LastRunSummaryPropertyValidationAttributesMap: {
+    [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 LastRunSummary interface.
+ */
+export declare function instanceOfLastRunSummary(value: object): value is LastRunSummary;
+export declare function LastRunSummaryFromJSON(json: any): LastRunSummary;
+export declare function LastRunSummaryFromJSONTyped(json: any, ignoreDiscriminator: boolean): LastRunSummary;
+export declare function LastRunSummaryToJSON(json: any): LastRunSummary;
+export declare function LastRunSummaryToJSONTyped(value?: LastRunSummary | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/LastRunSummary.js

@@ -0,0 +1,64 @@
+/* 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 { WorkflowExecutionStateFromJSON, WorkflowExecutionStateToJSON, } from './WorkflowExecutionState';
+import { PathPartApprovalStateFromJSON, PathPartApprovalStateToJSON, } from './PathPartApprovalState';
+export const LastRunSummaryPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the LastRunSummary interface.
+ */
+export function instanceOfLastRunSummary(value) {
+    if (!('id' in value) || value['id'] === undefined)
+        return false;
+    if (!('executionState' in value) || value['executionState'] === undefined)
+        return false;
+    if (!('approvalState' in value) || value['approvalState'] === undefined)
+        return false;
+    if (!('createdAt' in value) || value['createdAt'] === undefined)
+        return false;
+    return true;
+}
+export function LastRunSummaryFromJSON(json) {
+    return LastRunSummaryFromJSONTyped(json, false);
+}
+export function LastRunSummaryFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'id': json['id'],
+        'executionState': WorkflowExecutionStateFromJSON(json['execution_state']),
+        'approvalState': PathPartApprovalStateFromJSON(json['approval_state']),
+        'createdAt': (new Date(json['created_at'])),
+        'startedAt': json['started_at'] == null ? undefined : (new Date(json['started_at'])),
+        'completedAt': json['completed_at'] == null ? undefined : (new Date(json['completed_at'])),
+        'error': json['error'] == null ? undefined : json['error'],
+    };
+}
+export function LastRunSummaryToJSON(json) {
+    return LastRunSummaryToJSONTyped(json, false);
+}
+export function LastRunSummaryToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'id': value['id'],
+        'execution_state': WorkflowExecutionStateToJSON(value['executionState']),
+        'approval_state': PathPartApprovalStateToJSON(value['approvalState']),
+        'created_at': value['createdAt'].toISOString(),
+        'started_at': value['startedAt'] == null ? value['startedAt'] : value['startedAt'].toISOString(),
+        'completed_at': value['completedAt'] == null ? value['completedAt'] : value['completedAt'].toISOString(),
+        'error': value['error'],
+    };
+}

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

@@ -40,12 +40,6 @@ export interface UploadConstraints {
      * @memberof UploadConstraints
      */
     maxMediaBytes: number;
-    /**
-     *
-     * @type {number}
-     * @memberof UploadConstraints
-     */
-    maxVideoBytes: number;
     /**
      *
      * @type {number}

package/dist/esm/models/UploadConstraints.js

@@ -25,8 +25,6 @@ export function instanceOfUploadConstraints(value) {
         return false;
     if (!('maxMediaBytes' in value) || value['maxMediaBytes'] === undefined)
         return false;
-    if (!('maxVideoBytes' in value) || value['maxVideoBytes'] === undefined)
-        return false;
     if (!('maxMediaDurationMs' in value) || value['maxMediaDurationMs'] === undefined)
         return false;
     if (!('resumablePartSize' in value) || value['resumablePartSize'] === undefined)
@@ -45,7 +43,6 @@ export function UploadConstraintsFromJSONTyped(json, ignoreDiscriminator) {
         'maxBytes': json['max_bytes'],
         'maxImageBytes': json['max_image_bytes'],
         'maxMediaBytes': json['max_media_bytes'],
-        'maxVideoBytes': json['max_video_bytes'],
         'maxMediaDurationMs': json['max_media_duration_ms'],
         'resumablePartSize': json['resumable_part_size'],
     };
@@ -62,7 +59,6 @@ export function UploadConstraintsToJSONTyped(value, ignoreDiscriminator = false)
         'max_bytes': value['maxBytes'],
         'max_image_bytes': value['maxImageBytes'],
         'max_media_bytes': value['maxMediaBytes'],
-        'max_video_bytes': value['maxVideoBytes'],
         'max_media_duration_ms': value['maxMediaDurationMs'],
         'resumable_part_size': value['resumablePartSize'],
     };

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

@@ -10,12 +10,13 @@
  * Do not edit the class manually.
  */
 /**
- * Sortable fields for workflow-definition listings (time only for now).
+ * Sortable fields for workflow-definition listings.
  * @export
  */
 export declare const WorkflowDefinitionOrder: {
     readonly CreatedAt: 'CREATED_AT';
     readonly UpdatedAt: 'UPDATED_AT';
+    readonly Name: 'NAME';
 };
 export type WorkflowDefinitionOrder = typeof WorkflowDefinitionOrder[keyof typeof WorkflowDefinitionOrder];
 export declare function instanceOfWorkflowDefinitionOrder(value: any): boolean;

package/dist/esm/models/WorkflowDefinitionOrder.js

@@ -12,12 +12,13 @@
  * Do not edit the class manually.
  */
 /**
- * Sortable fields for workflow-definition listings (time only for now).
+ * Sortable fields for workflow-definition listings.
  * @export
  */
 export const WorkflowDefinitionOrder = {
     CreatedAt: 'CREATED_AT',
-    UpdatedAt: 'UPDATED_AT'
+    UpdatedAt: 'UPDATED_AT',
+    Name: 'NAME'
 };
 export function instanceOfWorkflowDefinitionOrder(value) {
     for (const key in WorkflowDefinitionOrder) {

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

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { ItemPermissions } from './ItemPermissions';
+import type { LastRunSummary } from './LastRunSummary';
 import type { PathPartApprovalState } from './PathPartApprovalState';
 import type { UserInfo } from './UserInfo';
 /**
@@ -126,6 +127,18 @@ export interface WorkflowDefinitionResponse {
      * @memberof WorkflowDefinitionResponse
      */
     copyCount?: number;
+    /**
+     * The definition's most recent run, or null if never run.
+     * @type {LastRunSummary}
+     * @memberof WorkflowDefinitionResponse
+     */
+    lastRun?: LastRunSummary | null;
+    /**
+     * Number of this definition's runs awaiting approval.
+     * @type {number}
+     * @memberof WorkflowDefinitionResponse
+     */
+    pendingApprovalCount?: number;
     /**
      *
      * @type {PathPartApprovalState}

package/dist/esm/models/WorkflowDefinitionResponse.js

@@ -12,6 +12,7 @@
  * Do not edit the class manually.
  */
 import { ItemPermissionsFromJSON, ItemPermissionsToJSON, } from './ItemPermissions';
+import { LastRunSummaryFromJSON, LastRunSummaryToJSON, } from './LastRunSummary';
 import { PathPartApprovalStateFromJSON, PathPartApprovalStateToJSON, } from './PathPartApprovalState';
 import { UserInfoFromJSON, UserInfoToJSON, } from './UserInfo';
 /**
@@ -84,6 +85,8 @@ export function WorkflowDefinitionResponseFromJSONTyped(json, ignoreDiscriminato
         'commonFilePathPartIds': json['common_file_path_part_ids'] == null ? undefined : json['common_file_path_part_ids'],
         'createdFromId': json['created_from_id'],
         'copyCount': json['copy_count'] == null ? undefined : json['copy_count'],
+        'lastRun': json['last_run'] == null ? undefined : LastRunSummaryFromJSON(json['last_run']),
+        'pendingApprovalCount': json['pending_approval_count'] == null ? undefined : json['pending_approval_count'],
         'approvalState': PathPartApprovalStateFromJSON(json['approval_state']),
         'owner': json['owner'] == null ? undefined : UserInfoFromJSON(json['owner']),
         'createdAt': (new Date(json['created_at'])),
@@ -116,6 +119,8 @@ export function WorkflowDefinitionResponseToJSONTyped(value, ignoreDiscriminator
         'common_file_path_part_ids': value['commonFilePathPartIds'],
         'created_from_id': value['createdFromId'],
         'copy_count': value['copyCount'],
+        'last_run': LastRunSummaryToJSON(value['lastRun']),
+        'pending_approval_count': value['pendingApprovalCount'],
         'approval_state': PathPartApprovalStateToJSON(value['approvalState']),
         'owner': UserInfoToJSON(value['owner']),
         'created_at': value['createdAt'].toISOString(),

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

@@ -172,6 +172,7 @@ export * from './KbMetric';
 export * from './KbSummaryResponse';
 export * from './KbTimeseriesResponse';
 export * from './LabeledSeries';
+export * from './LastRunSummary';
 export * from './LeaderboardEntry';
 export * from './LineageEdgeResponse';
 export * from './LineageGraphResponse';

package/dist/esm/models/index.js

@@ -174,6 +174,7 @@ export * from './KbMetric';
 export * from './KbSummaryResponse';
 export * from './KbTimeseriesResponse';
 export * from './LabeledSeries';
+export * from './LastRunSummary';
 export * from './LeaderboardEntry';
 export * from './LineageEdgeResponse';
 export * from './LineageGraphResponse';

package/dist/models/LastRunSummary.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 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 { WorkflowExecutionState } from './WorkflowExecutionState';
+import type { PathPartApprovalState } from './PathPartApprovalState';
+/**
+ * The definition's most recent run — a compact projection for list rows.
+ *
+ * ``approval_state`` is the run folder's own approval state (execution and
+ * approval are separate axes). Named to avoid colliding with the unrelated
+ * ``last_run_timestamp`` document-ingestion concept.
+ * @export
+ * @interface LastRunSummary
+ */
+export interface LastRunSummary {
+    /**
+     *
+     * @type {string}
+     * @memberof LastRunSummary
+     */
+    id: string;
+    /**
+     *
+     * @type {WorkflowExecutionState}
+     * @memberof LastRunSummary
+     */
+    executionState: WorkflowExecutionState;
+    /**
+     *
+     * @type {PathPartApprovalState}
+     * @memberof LastRunSummary
+     */
+    approvalState: PathPartApprovalState;
+    /**
+     *
+     * @type {Date}
+     * @memberof LastRunSummary
+     */
+    createdAt: Date;
+    /**
+     *
+     * @type {Date}
+     * @memberof LastRunSummary
+     */
+    startedAt?: Date | null;
+    /**
+     *
+     * @type {Date}
+     * @memberof LastRunSummary
+     */
+    completedAt?: Date | null;
+    /**
+     *
+     * @type {string}
+     * @memberof LastRunSummary
+     */
+    error?: string | null;
+}
+export declare const LastRunSummaryPropertyValidationAttributesMap: {
+    [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 LastRunSummary interface.
+ */
+export declare function instanceOfLastRunSummary(value: object): value is LastRunSummary;
+export declare function LastRunSummaryFromJSON(json: any): LastRunSummary;
+export declare function LastRunSummaryFromJSONTyped(json: any, ignoreDiscriminator: boolean): LastRunSummary;
+export declare function LastRunSummaryToJSON(json: any): LastRunSummary;
+export declare function LastRunSummaryToJSONTyped(value?: LastRunSummary | null, ignoreDiscriminator?: boolean): any;