@knowledge-stack/ksapi 1.159.1 → 1.160.0

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.0
 
 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.0`
 - 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/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;

package/dist/models/LastRunSummary.js

@@ -0,0 +1,72 @@
+"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.LastRunSummaryPropertyValidationAttributesMap = void 0;
+exports.instanceOfLastRunSummary = instanceOfLastRunSummary;
+exports.LastRunSummaryFromJSON = LastRunSummaryFromJSON;
+exports.LastRunSummaryFromJSONTyped = LastRunSummaryFromJSONTyped;
+exports.LastRunSummaryToJSON = LastRunSummaryToJSON;
+exports.LastRunSummaryToJSONTyped = LastRunSummaryToJSONTyped;
+const WorkflowExecutionState_1 = require("./WorkflowExecutionState");
+const PathPartApprovalState_1 = require("./PathPartApprovalState");
+exports.LastRunSummaryPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the LastRunSummary interface.
+ */
+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;
+}
+function LastRunSummaryFromJSON(json) {
+    return LastRunSummaryFromJSONTyped(json, false);
+}
+function LastRunSummaryFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'id': json['id'],
+        'executionState': (0, WorkflowExecutionState_1.WorkflowExecutionStateFromJSON)(json['execution_state']),
+        'approvalState': (0, PathPartApprovalState_1.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'],
+    };
+}
+function LastRunSummaryToJSON(json) {
+    return LastRunSummaryToJSONTyped(json, false);
+}
+function LastRunSummaryToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'id': value['id'],
+        'execution_state': (0, WorkflowExecutionState_1.WorkflowExecutionStateToJSON)(value['executionState']),
+        'approval_state': (0, PathPartApprovalState_1.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/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/models/WorkflowDefinitionOrder.js

@@ -20,12 +20,13 @@ exports.WorkflowDefinitionOrderFromJSONTyped = WorkflowDefinitionOrderFromJSONTy
 exports.WorkflowDefinitionOrderToJSON = WorkflowDefinitionOrderToJSON;
 exports.WorkflowDefinitionOrderToJSONTyped = WorkflowDefinitionOrderToJSONTyped;
 /**
- * Sortable fields for workflow-definition listings (time only for now).
+ * Sortable fields for workflow-definition listings.
  * @export
  */
 exports.WorkflowDefinitionOrder = {
     CreatedAt: 'CREATED_AT',
-    UpdatedAt: 'UPDATED_AT'
+    UpdatedAt: 'UPDATED_AT',
+    Name: 'NAME'
 };
 function instanceOfWorkflowDefinitionOrder(value) {
     for (const key in exports.WorkflowDefinitionOrder) {

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

@@ -20,6 +20,7 @@ exports.WorkflowDefinitionResponseFromJSONTyped = WorkflowDefinitionResponseFrom
 exports.WorkflowDefinitionResponseToJSON = WorkflowDefinitionResponseToJSON;
 exports.WorkflowDefinitionResponseToJSONTyped = WorkflowDefinitionResponseToJSONTyped;
 const ItemPermissions_1 = require("./ItemPermissions");
+const LastRunSummary_1 = require("./LastRunSummary");
 const PathPartApprovalState_1 = require("./PathPartApprovalState");
 const UserInfo_1 = require("./UserInfo");
 /**
@@ -92,6 +93,8 @@ function WorkflowDefinitionResponseFromJSONTyped(json, ignoreDiscriminator) {
         '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 : (0, LastRunSummary_1.LastRunSummaryFromJSON)(json['last_run']),
+        'pendingApprovalCount': json['pending_approval_count'] == null ? undefined : json['pending_approval_count'],
         'approvalState': (0, PathPartApprovalState_1.PathPartApprovalStateFromJSON)(json['approval_state']),
         'owner': json['owner'] == null ? undefined : (0, UserInfo_1.UserInfoFromJSON)(json['owner']),
         'createdAt': (new Date(json['created_at'])),
@@ -124,6 +127,8 @@ function WorkflowDefinitionResponseToJSONTyped(value, ignoreDiscriminator = fals
         'common_file_path_part_ids': value['commonFilePathPartIds'],
         'created_from_id': value['createdFromId'],
         'copy_count': value['copyCount'],
+        'last_run': (0, LastRunSummary_1.LastRunSummaryToJSON)(value['lastRun']),
+        'pending_approval_count': value['pendingApprovalCount'],
         'approval_state': (0, PathPartApprovalState_1.PathPartApprovalStateToJSON)(value['approvalState']),
         'owner': (0, UserInfo_1.UserInfoToJSON)(value['owner']),
         'created_at': value['createdAt'].toISOString(),

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

@@ -190,6 +190,7 @@ __exportStar(require("./KbMetric"), exports);
 __exportStar(require("./KbSummaryResponse"), exports);
 __exportStar(require("./KbTimeseriesResponse"), exports);
 __exportStar(require("./LabeledSeries"), exports);
+__exportStar(require("./LastRunSummary"), exports);
 __exportStar(require("./LeaderboardEntry"), exports);
 __exportStar(require("./LineageEdgeResponse"), exports);
 __exportStar(require("./LineageGraphResponse"), exports);

package/docs/FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR.md

@@ -36,6 +36,8 @@ Name | Type
 `commonFilePathPartIds` | Array<string>
 `createdFromId` | string
 `copyCount` | number
+`lastRun` | [LastRunSummary](LastRunSummary.md)
+`pendingApprovalCount` | number
 `workflowDefinitionId` | string
 `triggeredBy` | [UserInfo](UserInfo.md)
 `executionState` | [WorkflowExecutionState](WorkflowExecutionState.md)
@@ -106,6 +108,8 @@ const example = {
   "commonFilePathPartIds": null,
   "createdFromId": null,
   "copyCount": null,
+  "lastRun": null,
+  "pendingApprovalCount": null,
   "workflowDefinitionId": null,
   "triggeredBy": null,
   "executionState": null,

package/docs/LastRunSummary.md

@@ -0,0 +1,47 @@
+
+# LastRunSummary
+
+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.
+
+## Properties
+
+Name | Type
+------------ | -------------
+`id` | string
+`executionState` | [WorkflowExecutionState](WorkflowExecutionState.md)
+`approvalState` | [PathPartApprovalState](PathPartApprovalState.md)
+`createdAt` | Date
+`startedAt` | Date
+`completedAt` | Date
+`error` | string
+
+## Example
+
+```typescript
+import type { LastRunSummary } from '@knowledge-stack/ksapi'
+
+// TODO: Update the object below with actual values
+const example = {
+  "id": null,
+  "executionState": null,
+  "approvalState": null,
+  "createdAt": null,
+  "startedAt": null,
+  "completedAt": null,
+  "error": null,
+} satisfies LastRunSummary
+
+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 LastRunSummary
+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/WorkflowDefinitionOrder.md

@@ -1,7 +1,7 @@
 
 # WorkflowDefinitionOrder
 
-Sortable fields for workflow-definition listings (time only for now).
+Sortable fields for workflow-definition listings.
 
 ## Properties
 

package/docs/WorkflowDefinitionResponse.md

@@ -24,6 +24,8 @@ Name | Type
 `commonFilePathPartIds` | Array<string>
 `createdFromId` | string
 `copyCount` | number
+`lastRun` | [LastRunSummary](LastRunSummary.md)
+`pendingApprovalCount` | number
 `approvalState` | [PathPartApprovalState](PathPartApprovalState.md)
 `owner` | [UserInfo](UserInfo.md)
 `createdAt` | Date
@@ -54,6 +56,8 @@ const example = {
   "commonFilePathPartIds": null,
   "createdFromId": null,
   "copyCount": null,
+  "lastRun": null,
+  "pendingApprovalCount": null,
   "approvalState": null,
   "owner": null,
   "createdAt": null,

package/docs/WorkflowDefinitionsApi.md

@@ -408,7 +408,7 @@ example().catch(console.error);
 
 ## listWorkflowDefinitions
 
-> PaginatedResponseWorkflowDefinitionResponse listWorkflowDefinitions(mine, sortBy, sortDir, isTemplate, limit, offset, createdAfter, createdBefore, updatedAfter, updatedBefore)
+> PaginatedResponseWorkflowDefinitionResponse listWorkflowDefinitions(mine, search, sortBy, sortDir, isTemplate, limit, offset, createdAfter, createdBefore, updatedAfter, updatedBefore, includeTagIds, excludeTagIds)
 
 List Workflow Definitions Handler
 
@@ -434,6 +434,8 @@ async function example() {
   const body = {
     // boolean | Only definitions the caller created (owner). (optional)
     mine: true,
+    // string | Case-insensitive substring over name and description. (optional)
+    search: search_example,
     // WorkflowDefinitionOrder | Field to sort definitions by (default: CREATED_AT) (optional)
     sortBy: ...,
     // SortDirection | Sort direction; overrides the field\'s natural default (optional)
@@ -452,6 +454,10 @@ async function example() {
     updatedAfter: 2013-10-20T19:20:30+01:00,
     // Date | Only items updated strictly before this timestamp (optional)
     updatedBefore: 2013-10-20T19:20:30+01:00,
+    // Array<string> | Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance). (optional)
+    includeTagIds: ...,
+    // Array<string> | Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids. (optional)
+    excludeTagIds: ...,
   } satisfies ListWorkflowDefinitionsRequest;
 
   try {
@@ -472,7 +478,8 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **mine** | `boolean` | Only definitions the caller created (owner). | [Optional] [Defaults to `false`] |
-| **sortBy** | `WorkflowDefinitionOrder` | Field to sort definitions by (default: CREATED_AT) | [Optional] [Defaults to `undefined`] [Enum: CREATED_AT, UPDATED_AT] |
+| **search** | `string` | Case-insensitive substring over name and description. | [Optional] [Defaults to `undefined`] |
+| **sortBy** | `WorkflowDefinitionOrder` | Field to sort definitions by (default: CREATED_AT) | [Optional] [Defaults to `undefined`] [Enum: CREATED_AT, UPDATED_AT, NAME] |
 | **sortDir** | `SortDirection` | Sort direction; overrides the field\&#39;s natural default | [Optional] [Defaults to `undefined`] [Enum: ASC, DESC] |
 | **isTemplate** | `boolean` |  | [Optional] [Defaults to `false`] |
 | **limit** | `number` | Number of items per page | [Optional] [Defaults to `20`] |
@@ -481,6 +488,8 @@ example().catch(console.error);
 | **createdBefore** | `Date` | Only items created strictly before this timestamp | [Optional] [Defaults to `undefined`] |
 | **updatedAfter** | `Date` | Only items updated at or after this timestamp (inclusive) | [Optional] [Defaults to `undefined`] |
 | **updatedBefore** | `Date` | Only items updated strictly before this timestamp | [Optional] [Defaults to `undefined`] |
+| **includeTagIds** | `Array<string>` | Keep only items that carry at least one of these tags on the item itself or any ancestor folder (repeatable, OR / tag inheritance). | [Optional] |
+| **excludeTagIds** | `Array<string>` | Drop items that carry any of these tags on the item itself or any ancestor folder (repeatable). Takes precedence over include_tag_ids. | [Optional] |
 
 ### Return type
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowledge-stack/ksapi",
-  "version": "1.159.1",
+  "version": "1.160.0",
   "description": "OpenAPI client for @knowledge-stack/ksapi",
   "author": "OpenAPI-Generator",
   "repository": {

package/src/apis/WorkflowDefinitionsApi.ts

@@ -85,6 +85,7 @@ export interface InstantiateWorkflowTemplateOperationRequest {
 
 export interface ListWorkflowDefinitionsRequest {
     mine?: boolean;
+    search?: string | null;
     sortBy?: WorkflowDefinitionOrder;
     sortDir?: SortDirection;
     isTemplate?: boolean;
@@ -94,6 +95,8 @@ export interface ListWorkflowDefinitionsRequest {
     createdBefore?: Date | null;
     updatedAfter?: Date | null;
     updatedBefore?: Date | null;
+    includeTagIds?: Array<string> | null;
+    excludeTagIds?: Array<string> | null;
 }
 
 export interface ListWorkflowRunsRequest {
@@ -255,6 +258,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] 
@@ -264,6 +268,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
      */
@@ -273,6 +279,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] 
@@ -282,6 +289,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
@@ -700,6 +709,10 @@ export class WorkflowDefinitionsApi extends runtime.BaseAPI implements WorkflowD
             queryParameters['mine'] = requestParameters['mine'];
         }
 
+        if (requestParameters['search'] != null) {
+            queryParameters['search'] = requestParameters['search'];
+        }
+
         if (requestParameters['sortBy'] != null) {
             queryParameters['sort_by'] = requestParameters['sortBy'];
         }
@@ -736,6 +749,14 @@ export class WorkflowDefinitionsApi extends runtime.BaseAPI implements WorkflowD
             queryParameters['updated_before'] = (requestParameters['updatedBefore'] as any).toISOString();
         }
 
+        if (requestParameters['includeTagIds'] != null) {
+            queryParameters['include_tag_ids'] = requestParameters['includeTagIds'];
+        }
+
+        if (requestParameters['excludeTagIds'] != null) {
+            queryParameters['exclude_tag_ids'] = requestParameters['excludeTagIds'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         if (this.configuration && this.configuration.accessToken) {

package/src/models/LastRunSummary.ts

@@ -0,0 +1,155 @@
+/* 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 { mapValues } from '../runtime';
+import type { WorkflowExecutionState } from './WorkflowExecutionState';
+import {
+    WorkflowExecutionStateFromJSON,
+    WorkflowExecutionStateFromJSONTyped,
+    WorkflowExecutionStateToJSON,
+    WorkflowExecutionStateToJSONTyped,
+} from './WorkflowExecutionState';
+import type { PathPartApprovalState } from './PathPartApprovalState';
+import {
+    PathPartApprovalStateFromJSON,
+    PathPartApprovalStateFromJSONTyped,
+    PathPartApprovalStateToJSON,
+    PathPartApprovalStateToJSONTyped,
+} 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 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 function instanceOfLastRunSummary(value: object): value is LastRunSummary {
+    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: any): LastRunSummary {
+    return LastRunSummaryFromJSONTyped(json, false);
+}
+
+export function LastRunSummaryFromJSONTyped(json: any, ignoreDiscriminator: boolean): LastRunSummary {
+    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: any): LastRunSummary {
+    return LastRunSummaryToJSONTyped(json, false);
+}
+
+export function LastRunSummaryToJSONTyped(value?: LastRunSummary | null, ignoreDiscriminator: boolean = false): any {
+    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/src/models/WorkflowDefinitionOrder.ts

@@ -14,12 +14,13 @@
 
 
 /**
- * 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'
 } as const;
 export type WorkflowDefinitionOrder = typeof WorkflowDefinitionOrder[keyof typeof WorkflowDefinitionOrder];
 

package/src/models/WorkflowDefinitionResponse.ts

@@ -20,6 +20,13 @@ import {
     ItemPermissionsToJSON,
     ItemPermissionsToJSONTyped,
 } from './ItemPermissions';
+import type { LastRunSummary } from './LastRunSummary';
+import {
+    LastRunSummaryFromJSON,
+    LastRunSummaryFromJSONTyped,
+    LastRunSummaryToJSON,
+    LastRunSummaryToJSONTyped,
+} from './LastRunSummary';
 import type { PathPartApprovalState } from './PathPartApprovalState';
 import {
     PathPartApprovalStateFromJSON,
@@ -149,6 +156,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}
@@ -258,6 +277,8 @@ export function WorkflowDefinitionResponseFromJSONTyped(json: any, ignoreDiscrim
         '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'])),
@@ -294,6 +315,8 @@ export function WorkflowDefinitionResponseToJSONTyped(value?: WorkflowDefinition
         '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/src/models/index.ts

@@ -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';