@knowledge-stack/ksapi 1.135.1 → 1.136.1

package/dist/esm/models/WorkflowDefinitionResponse.js

@@ -80,6 +80,7 @@ export function WorkflowDefinitionResponseFromJSONTyped(json, ignoreDiscriminato
         'isActive': json['is_active'],
         'approvalRequired': json['approval_required'],
         'isTemplate': json['is_template'],
+        'selectedSkillIds': json['selected_skill_ids'] == null ? undefined : json['selected_skill_ids'],
         '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'],
@@ -111,6 +112,7 @@ export function WorkflowDefinitionResponseToJSONTyped(value, ignoreDiscriminator
         'is_active': value['isActive'],
         'approval_required': value['approvalRequired'],
         'is_template': value['isTemplate'],
+        'selected_skill_ids': value['selectedSkillIds'],
         'common_file_path_part_ids': value['commonFilePathPartIds'],
         'created_from_id': value['createdFromId'],
         'copy_count': value['copyCount'],

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

@@ -62,6 +62,12 @@ export interface WorkflowRunSnapshot {
      * @memberof WorkflowRunSnapshot
      */
     userMessage?: string | null;
+    /**
+     * Skill PDO ids to force-load into the run at turn 0, merged with the definition's prefill. Definition selections are validated readable + SKILL at write time; every id is re-checked fail-closed when the run materializes (a skill deleted or revoked after selection is dropped, never bricking the run). The runner materializes each skill's ACTIVE published version into the agent's skills dir; the agent can still discover others via search. Empty for the common case; pre-feature snapshots default to empty.
+     * @type {Array<string>}
+     * @memberof WorkflowRunSnapshot
+     */
+    selectedSkillIds?: Array<string>;
 }
 export declare const WorkflowRunSnapshotPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/esm/models/WorkflowRunSnapshot.js

@@ -47,6 +47,7 @@ export function WorkflowRunSnapshotFromJSONTyped(json, ignoreDiscriminator) {
         'inputs': (json['inputs'].map(InputSnapshotFromJSON)),
         'excludedCommonFiles': json['excluded_common_files'] == null ? undefined : (json['excluded_common_files'].map(ExcludedCommonFileFromJSON)),
         'userMessage': json['user_message'] == null ? undefined : json['user_message'],
+        'selectedSkillIds': json['selected_skill_ids'] == null ? undefined : json['selected_skill_ids'],
     };
 }
 export function WorkflowRunSnapshotToJSON(json) {
@@ -63,5 +64,6 @@ export function WorkflowRunSnapshotToJSONTyped(value, ignoreDiscriminator = fals
         'inputs': (value['inputs'].map(InputSnapshotToJSON)),
         'excluded_common_files': value['excludedCommonFiles'] == null ? undefined : (value['excludedCommonFiles'].map(ExcludedCommonFileToJSON)),
         'user_message': value['userMessage'],
+        'selected_skill_ids': value['selectedSkillIds'],
     };
 }

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

@@ -1,6 +1,7 @@
 export * from './AcceptDisclaimerRequest';
 export * from './AcceptInviteResponse';
 export * from './AccessCheckResponse';
+export * from './ActivateSkillVersionRequest';
 export * from './AddMemberRequest';
 export * from './AncestryResponse';
 export * from './ApiAuthConfig';
@@ -62,6 +63,7 @@ export * from './CreatePasswordUserRequest';
 export * from './CreatePermissionRequest';
 export * from './CreatePhonePasswordUserRequest';
 export * from './CreateSectionRequest';
+export * from './CreateSkillRequest';
 export * from './CreateTagRequest';
 export * from './CreateThreadMessageRequest';
 export * from './CreateThreadRequest';
@@ -122,7 +124,7 @@ export * from './FeedbackTargetType';
 export * from './FolderAction';
 export * from './FolderActionResponse';
 export * from './FolderResponse';
-export * from './FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponse';
+export * from './FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR';
 export * from './GroupMemberOrder';
 export * from './GroupPermissionOrder';
 export * from './GroupPermissionResponse';
@@ -166,7 +168,7 @@ export * from './NetworkClass';
 export * from './NonFilesystemReferenceType';
 export * from './OnboardingCompanyRequest';
 export * from './OnboardingProfileRequest';
-export * from './PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator';
+export * from './PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat';
 export * from './PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator';
 export * from './PaginatedResponseDocumentResponse';
 export * from './PaginatedResponseDocumentVersionResponse';
@@ -181,6 +183,7 @@ export * from './PaginatedResponseMemoryChunkResponse';
 export * from './PaginatedResponsePathPartResponse';
 export * from './PaginatedResponsePendingMemoryChunkResponse';
 export * from './PaginatedResponsePermissionResponse';
+export * from './PaginatedResponseSkillResponse';
 export * from './PaginatedResponseTagResponse';
 export * from './PaginatedResponseTenantResponse';
 export * from './PaginatedResponseTenantUserResponse';
@@ -225,6 +228,8 @@ export * from './RunFolder';
 export * from './RunFolderRef';
 export * from './SSOInitiateResponse';
 export * from './ScoredChunkResponse';
+export * from './SearchSkillsRequest';
+export * from './SearchSkillsResponse';
 export * from './SearchSortOrder';
 export * from './SearchTablesRequest';
 export * from './SearchTablesResponse';
@@ -240,6 +245,11 @@ export * from './SetApprovalStateRequest';
 export * from './SetWorkflowRunApprovalRequest';
 export * from './SheetVisibilityChange';
 export * from './SignInRequest';
+export * from './SkillOrder';
+export * from './SkillResponse';
+export * from './SkillScriptFile';
+export * from './SkillSearchResult';
+export * from './SkillVersionResponse';
 export * from './SortDirection';
 export * from './StartWorkflowRunRequest';
 export * from './Step';
@@ -296,6 +306,7 @@ export * from './UpdateGroupRequest';
 export * from './UpdateInviteRequest';
 export * from './UpdatePermissionRequest';
 export * from './UpdateSectionRequest';
+export * from './UpdateSkillRequest';
 export * from './UpdateTableRequest';
 export * from './UpdateTagRequest';
 export * from './UpdateTenantRequest';

package/dist/esm/models/index.js

@@ -3,6 +3,7 @@
 export * from './AcceptDisclaimerRequest';
 export * from './AcceptInviteResponse';
 export * from './AccessCheckResponse';
+export * from './ActivateSkillVersionRequest';
 export * from './AddMemberRequest';
 export * from './AncestryResponse';
 export * from './ApiAuthConfig';
@@ -64,6 +65,7 @@ export * from './CreatePasswordUserRequest';
 export * from './CreatePermissionRequest';
 export * from './CreatePhonePasswordUserRequest';
 export * from './CreateSectionRequest';
+export * from './CreateSkillRequest';
 export * from './CreateTagRequest';
 export * from './CreateThreadMessageRequest';
 export * from './CreateThreadRequest';
@@ -124,7 +126,7 @@ export * from './FeedbackTargetType';
 export * from './FolderAction';
 export * from './FolderActionResponse';
 export * from './FolderResponse';
-export * from './FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponse';
+export * from './FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR';
 export * from './GroupMemberOrder';
 export * from './GroupPermissionOrder';
 export * from './GroupPermissionResponse';
@@ -168,7 +170,7 @@ export * from './NetworkClass';
 export * from './NonFilesystemReferenceType';
 export * from './OnboardingCompanyRequest';
 export * from './OnboardingProfileRequest';
-export * from './PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDataSourceResponseDataSourceSchemaResponseDataSourceTableResponseApiConnectionResponseDiscriminator';
+export * from './PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseWorkflowDefinitionResponseWorkflowRunResponseDat';
 export * from './PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator';
 export * from './PaginatedResponseDocumentResponse';
 export * from './PaginatedResponseDocumentVersionResponse';
@@ -183,6 +185,7 @@ export * from './PaginatedResponseMemoryChunkResponse';
 export * from './PaginatedResponsePathPartResponse';
 export * from './PaginatedResponsePendingMemoryChunkResponse';
 export * from './PaginatedResponsePermissionResponse';
+export * from './PaginatedResponseSkillResponse';
 export * from './PaginatedResponseTagResponse';
 export * from './PaginatedResponseTenantResponse';
 export * from './PaginatedResponseTenantUserResponse';
@@ -227,6 +230,8 @@ export * from './RunFolder';
 export * from './RunFolderRef';
 export * from './SSOInitiateResponse';
 export * from './ScoredChunkResponse';
+export * from './SearchSkillsRequest';
+export * from './SearchSkillsResponse';
 export * from './SearchSortOrder';
 export * from './SearchTablesRequest';
 export * from './SearchTablesResponse';
@@ -242,6 +247,11 @@ export * from './SetApprovalStateRequest';
 export * from './SetWorkflowRunApprovalRequest';
 export * from './SheetVisibilityChange';
 export * from './SignInRequest';
+export * from './SkillOrder';
+export * from './SkillResponse';
+export * from './SkillScriptFile';
+export * from './SkillSearchResult';
+export * from './SkillVersionResponse';
 export * from './SortDirection';
 export * from './StartWorkflowRunRequest';
 export * from './Step';
@@ -298,6 +308,7 @@ export * from './UpdateGroupRequest';
 export * from './UpdateInviteRequest';
 export * from './UpdatePermissionRequest';
 export * from './UpdateSectionRequest';
+export * from './UpdateSkillRequest';
 export * from './UpdateTableRequest';
 export * from './UpdateTagRequest';
 export * from './UpdateTenantRequest';

package/dist/models/ActivateSkillVersionRequest.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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.
+ */
+/**
+ * Activate a specific published version.
+ * @export
+ * @interface ActivateSkillVersionRequest
+ */
+export interface ActivateSkillVersionRequest {
+    /**
+     * Required (true) to activate when the working copy has unpublished edits — activating overwrites them. Otherwise the request is a 409.
+     * @type {boolean}
+     * @memberof ActivateSkillVersionRequest
+     */
+    confirmDiscardUnpublished?: boolean;
+}
+export declare const ActivateSkillVersionRequestPropertyValidationAttributesMap: {
+    [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 ActivateSkillVersionRequest interface.
+ */
+export declare function instanceOfActivateSkillVersionRequest(value: object): value is ActivateSkillVersionRequest;
+export declare function ActivateSkillVersionRequestFromJSON(json: any): ActivateSkillVersionRequest;
+export declare function ActivateSkillVersionRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): ActivateSkillVersionRequest;
+export declare function ActivateSkillVersionRequestToJSON(json: any): ActivateSkillVersionRequest;
+export declare function ActivateSkillVersionRequestToJSONTyped(value?: ActivateSkillVersionRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/models/ActivateSkillVersionRequest.js

@@ -0,0 +1,50 @@
+"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.ActivateSkillVersionRequestPropertyValidationAttributesMap = void 0;
+exports.instanceOfActivateSkillVersionRequest = instanceOfActivateSkillVersionRequest;
+exports.ActivateSkillVersionRequestFromJSON = ActivateSkillVersionRequestFromJSON;
+exports.ActivateSkillVersionRequestFromJSONTyped = ActivateSkillVersionRequestFromJSONTyped;
+exports.ActivateSkillVersionRequestToJSON = ActivateSkillVersionRequestToJSON;
+exports.ActivateSkillVersionRequestToJSONTyped = ActivateSkillVersionRequestToJSONTyped;
+exports.ActivateSkillVersionRequestPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the ActivateSkillVersionRequest interface.
+ */
+function instanceOfActivateSkillVersionRequest(value) {
+    return true;
+}
+function ActivateSkillVersionRequestFromJSON(json) {
+    return ActivateSkillVersionRequestFromJSONTyped(json, false);
+}
+function ActivateSkillVersionRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'confirmDiscardUnpublished': json['confirm_discard_unpublished'] == null ? undefined : json['confirm_discard_unpublished'],
+    };
+}
+function ActivateSkillVersionRequestToJSON(json) {
+    return ActivateSkillVersionRequestToJSONTyped(json, false);
+}
+function ActivateSkillVersionRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'confirm_discard_unpublished': value['confirmDiscardUnpublished'],
+    };
+}

package/dist/models/CreateSkillRequest.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { SkillScriptFile } from './SkillScriptFile';
+/**
+ * Author a skill from a SKILL.md bundle.
+ * @export
+ * @interface CreateSkillRequest
+ */
+export interface CreateSkillRequest {
+    /**
+     * Skill machine name (its folder name); unique within the tenant.
+     * @type {string}
+     * @memberof CreateSkillRequest
+     */
+    name: string;
+    /**
+     * Full SKILL.md content: YAML frontmatter with name + description, then the markdown instruction body.
+     * @type {string}
+     * @memberof CreateSkillRequest
+     */
+    skillMd: string;
+    /**
+     * Optional scripts bundled under the skill's scripts/ folder.
+     * @type {Array<SkillScriptFile>}
+     * @memberof CreateSkillRequest
+     */
+    scripts?: Array<SkillScriptFile>;
+}
+export declare const CreateSkillRequestPropertyValidationAttributesMap: {
+    [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 CreateSkillRequest interface.
+ */
+export declare function instanceOfCreateSkillRequest(value: object): value is CreateSkillRequest;
+export declare function CreateSkillRequestFromJSON(json: any): CreateSkillRequest;
+export declare function CreateSkillRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): CreateSkillRequest;
+export declare function CreateSkillRequestToJSON(json: any): CreateSkillRequest;
+export declare function CreateSkillRequestToJSONTyped(value?: CreateSkillRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/models/CreateSkillRequest.js

@@ -0,0 +1,67 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management.  ## Integrating (RPA / machine clients)  **Base URL.** Knowledge Stack is self-hosted — point at your own deployment host (see `servers`). The `localhost` entry is for local development only.  **Authentication.** Send `Authorization: Bearer <api-key>` on every request. Mint an API key once via `POST /v1/api-keys` from a signed-in browser session; the raw `sk-user-...` secret is returned **only** at creation, so store it then. A key inherits its owning user\'s live tenant role and path permissions — create RPA keys from a least-privilege user, and set `expires_at` for rotation. The `ks_uat` cookie scheme is browser-only and cannot be used by headless clients.  **Async work is polled, not pushed.** There are no outbound webhooks. - `POST /v1/documents/ingest` returns `201` immediately with a `workflow_id`;   poll `GET /v1/system-jobs/document_versions/{workflow_id}` until `status` is   terminal (anything other than `pending`/`processing`). The `Location` response   header points at this poll resource. - `POST /v1/workflow-runs/{run_id}/start` returns `202`; poll   `GET /v1/workflow-runs/{run_id}` until `execution_state` is `COMPLETED` or   `FAILED`. The `Location` header points at the run resource. - `POST /v1/agent/ask` is **synchronous** — it blocks until the agent finishes   and returns the answer inline. Use a generous HTTP timeout.  **Pagination.** List endpoints accept `limit`/`offset` and return `{items, total, limit, offset}`.  **Errors.** Every non-2xx body is `{detail, code, request_id}`. `code` is a stable value from a closed set (see the `ErrorResponse` schema\'s `code` enum) — branch on it rather than parsing `detail`. Quota rejections return `429` with a `Retry-After` header; transient lock contention returns a retryable `503`. Quote `request_id` (also the `x-request-id` response header) to support.  **Idempotency.** `POST /v1/workflow-runs` accepts an `idempotency_key` to dedupe retried run creation. `agent/ask` charges one message *before* running and does not refund a client-cancelled call.
+ *
+ * The version of the OpenAPI document: 0.1.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateSkillRequestPropertyValidationAttributesMap = void 0;
+exports.instanceOfCreateSkillRequest = instanceOfCreateSkillRequest;
+exports.CreateSkillRequestFromJSON = CreateSkillRequestFromJSON;
+exports.CreateSkillRequestFromJSONTyped = CreateSkillRequestFromJSONTyped;
+exports.CreateSkillRequestToJSON = CreateSkillRequestToJSON;
+exports.CreateSkillRequestToJSONTyped = CreateSkillRequestToJSONTyped;
+const SkillScriptFile_1 = require("./SkillScriptFile");
+exports.CreateSkillRequestPropertyValidationAttributesMap = {
+    name: {
+        maxLength: 255,
+    },
+    scripts: {
+        maxItems: 50,
+        uniqueItems: false,
+    },
+};
+/**
+ * Check if a given object implements the CreateSkillRequest interface.
+ */
+function instanceOfCreateSkillRequest(value) {
+    if (!('name' in value) || value['name'] === undefined)
+        return false;
+    if (!('skillMd' in value) || value['skillMd'] === undefined)
+        return false;
+    return true;
+}
+function CreateSkillRequestFromJSON(json) {
+    return CreateSkillRequestFromJSONTyped(json, false);
+}
+function CreateSkillRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'name': json['name'],
+        'skillMd': json['skill_md'],
+        'scripts': json['scripts'] == null ? undefined : (json['scripts'].map(SkillScriptFile_1.SkillScriptFileFromJSON)),
+    };
+}
+function CreateSkillRequestToJSON(json) {
+    return CreateSkillRequestToJSONTyped(json, false);
+}
+function CreateSkillRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'name': value['name'],
+        'skill_md': value['skillMd'],
+        'scripts': value['scripts'] == null ? undefined : (value['scripts'].map(SkillScriptFile_1.SkillScriptFileToJSON)),
+    };
+}

package/dist/models/CreateWorkflowDefinitionRequest.d.ts

@@ -61,6 +61,12 @@ export interface CreateWorkflowDefinitionRequest {
      * @memberof CreateWorkflowDefinitionRequest
      */
     isTemplate?: boolean;
+    /**
+     * Skill PDO ids force-loaded into every run of this workflow by default (prefill). Each run inherits these and may add more; the agent can still discover others via search. Each must be a SKILL the caller can read.
+     * @type {Array<string>}
+     * @memberof CreateWorkflowDefinitionRequest
+     */
+    selectedSkillIds?: Array<string>;
     /**
      * Optional path_part ids of common files (DOCUMENT / FOLDER / DATA_SOURCE / API_CONNECTION) attached to every run of this workflow — e.g. an output template. Merged with each run's own inputs at Start. The caller must be able to read each one.
      * @type {Array<string>}

package/dist/models/CreateWorkflowDefinitionRequest.js

@@ -29,6 +29,10 @@ exports.CreateWorkflowDefinitionRequestPropertyValidationAttributesMap = {
         minimum: 60,
         exclusiveMinimum: false,
     },
+    selectedSkillIds: {
+        maxItems: 20,
+        uniqueItems: false,
+    },
     commonFilePathPartIds: {
         maxItems: 20,
         uniqueItems: false,
@@ -61,6 +65,7 @@ function CreateWorkflowDefinitionRequestFromJSONTyped(json, ignoreDiscriminator)
         'instructionPathPartId': json['instruction_path_part_id'] == null ? undefined : json['instruction_path_part_id'],
         'approvalRequired': json['approval_required'],
         'isTemplate': json['is_template'] == null ? undefined : json['is_template'],
+        'selectedSkillIds': json['selected_skill_ids'] == null ? undefined : json['selected_skill_ids'],
         'commonFilePathPartIds': json['common_file_path_part_ids'] == null ? undefined : json['common_file_path_part_ids'],
     };
 }
@@ -79,6 +84,7 @@ function CreateWorkflowDefinitionRequestToJSONTyped(value, ignoreDiscriminator =
         'instruction_path_part_id': value['instructionPathPartId'],
         'approval_required': value['approvalRequired'],
         'is_template': value['isTemplate'],
+        'selected_skill_ids': value['selectedSkillIds'],
         'common_file_path_part_ids': value['commonFilePathPartIds'],
     };
 }

package/dist/models/{FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponse.d.ts → FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR.d.ts}

@@ -15,14 +15,15 @@ import type { DataSourceSchemaResponse } from './DataSourceSchemaResponse';
 import type { DataSourceTableResponse } from './DataSourceTableResponse';
 import type { DocumentResponse } from './DocumentResponse';
 import type { FolderResponse } from './FolderResponse';
+import type { SkillResponse } from './SkillResponse';
 import type { WorkflowDefinitionResponse } from './WorkflowDefinitionResponse';
 import type { WorkflowRunResponse } from './WorkflowRunResponse';
 /**
- * @type FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponse
+ * @type FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR
  *
  * @export
  */
-export type FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponse = {
+export type FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR = {
     partType: 'API_CONNECTION';
 } & ApiConnectionResponse | {
     partType: 'DATA_SOURCE';
@@ -35,11 +36,13 @@ export type FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkfl
 } & DocumentResponse | {
     partType: 'FOLDER';
 } & FolderResponse | {
+    partType: 'SKILL';
+} & SkillResponse | {
     partType: 'WORKFLOW_DEFINITION';
 } & WorkflowDefinitionResponse | {
     partType: 'WORKFLOW_RUN';
 } & WorkflowRunResponse;
-export declare function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseFromJSON(json: any): FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponse;
-export declare function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponse;
-export declare function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseToJSON(json: any): any;
-export declare function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseToJSONTyped(value?: FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponse | null, ignoreDiscriminator?: boolean): any;
+export declare function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSON(json: any): FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR;
+export declare function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSONTyped(json: any, ignoreDiscriminator: boolean): FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR;
+export declare function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSON(json: any): any;
+export declare function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSONTyped(value?: FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR | null, ignoreDiscriminator?: boolean): any;

package/dist/models/{FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponse.js → FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR.js}

@@ -13,22 +13,23 @@
  * Do not edit the class manually.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseFromJSON = FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseFromJSON;
-exports.FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseFromJSONTyped = FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseFromJSONTyped;
-exports.FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseToJSON = FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseToJSON;
-exports.FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseToJSONTyped = FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseToJSONTyped;
+exports.FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSON = FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSON;
+exports.FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSONTyped = FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSONTyped;
+exports.FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSON = FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSON;
+exports.FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSONTyped = FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSONTyped;
 const ApiConnectionResponse_1 = require("./ApiConnectionResponse");
 const DataSourceResponse_1 = require("./DataSourceResponse");
 const DataSourceSchemaResponse_1 = require("./DataSourceSchemaResponse");
 const DataSourceTableResponse_1 = require("./DataSourceTableResponse");
 const DocumentResponse_1 = require("./DocumentResponse");
 const FolderResponse_1 = require("./FolderResponse");
+const SkillResponse_1 = require("./SkillResponse");
 const WorkflowDefinitionResponse_1 = require("./WorkflowDefinitionResponse");
 const WorkflowRunResponse_1 = require("./WorkflowRunResponse");
-function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseFromJSON(json) {
-    return FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseFromJSONTyped(json, false);
+function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSON(json) {
+    return FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSONTyped(json, false);
 }
-function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseFromJSONTyped(json, ignoreDiscriminator) {
+function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRFromJSONTyped(json, ignoreDiscriminator) {
     if (json == null) {
         return json;
     }
@@ -45,6 +46,8 @@ function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowR
             return Object.assign({}, (0, DocumentResponse_1.DocumentResponseFromJSONTyped)(json, true), { partType: 'DOCUMENT' });
         case 'FOLDER':
             return Object.assign({}, (0, FolderResponse_1.FolderResponseFromJSONTyped)(json, true), { partType: 'FOLDER' });
+        case 'SKILL':
+            return Object.assign({}, (0, SkillResponse_1.SkillResponseFromJSONTyped)(json, true), { partType: 'SKILL' });
         case 'WORKFLOW_DEFINITION':
             return Object.assign({}, (0, WorkflowDefinitionResponse_1.WorkflowDefinitionResponseFromJSONTyped)(json, true), { partType: 'WORKFLOW_DEFINITION' });
         case 'WORKFLOW_RUN':
@@ -53,10 +56,10 @@ function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowR
             return json;
     }
 }
-function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseToJSON(json) {
-    return FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseToJSONTyped(json, false);
+function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSON(json) {
+    return FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSONTyped(json, false);
 }
-function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaResponseOrDataSourceTableResponseOrApiConnectionResponseToJSONTyped(value, ignoreDiscriminator = false) {
+function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaRToJSONTyped(value, ignoreDiscriminator = false) {
     if (value == null) {
         return value;
     }
@@ -73,6 +76,8 @@ function FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowR
             return Object.assign({}, (0, DocumentResponse_1.DocumentResponseToJSON)(value), { partType: 'DOCUMENT' });
         case 'FOLDER':
             return Object.assign({}, (0, FolderResponse_1.FolderResponseToJSON)(value), { partType: 'FOLDER' });
+        case 'SKILL':
+            return Object.assign({}, (0, SkillResponse_1.SkillResponseToJSON)(value), { partType: 'SKILL' });
         case 'WORKFLOW_DEFINITION':
             return Object.assign({}, (0, WorkflowDefinitionResponse_1.WorkflowDefinitionResponseToJSON)(value), { partType: 'WORKFLOW_DEFINITION' });
         case 'WORKFLOW_RUN':