@knowledge-stack/ksapi 1.135.1 → 1.136.0

package/src/models/SearchSkillsRequest.ts

@@ -0,0 +1,114 @@
+/* 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';
+/**
+ * Semantic skill discovery for the agent.
+ * @export
+ * @interface SearchSkillsRequest
+ */
+export interface SearchSkillsRequest {
+    /**
+     * What the agent needs a skill for.
+     * @type {string}
+     * @memberof SearchSkillsRequest
+     */
+    query: string;
+    /**
+     * 
+     * @type {number}
+     * @memberof SearchSkillsRequest
+     */
+    topK?: number;
+    /**
+     * 
+     * @type {number}
+     * @memberof SearchSkillsRequest
+     */
+    scoreThreshold?: number;
+}
+export const SearchSkillsRequestPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number,
+        minLength?: number,
+        pattern?: string,
+        maximum?: number,
+        exclusiveMaximum?: boolean,
+        minimum?: number,
+        exclusiveMinimum?: boolean,
+        multipleOf?: number,
+        maxItems?: number,
+        minItems?: number,
+        uniqueItems?: boolean
+    }
+} = {
+    query: {
+        minLength: 1,
+    },
+    topK: {
+        maximum: 50,
+        exclusiveMaximum: false,
+        minimum: 1,
+        exclusiveMinimum: false,
+    },
+    scoreThreshold: {
+        maximum: 1.0,
+        exclusiveMaximum: false,
+        minimum: 0.0,
+        exclusiveMinimum: false,
+    },
+}
+
+
+/**
+ * Check if a given object implements the SearchSkillsRequest interface.
+ */
+export function instanceOfSearchSkillsRequest(value: object): value is SearchSkillsRequest {
+    if (!('query' in value) || value['query'] === undefined) return false;
+    return true;
+}
+
+export function SearchSkillsRequestFromJSON(json: any): SearchSkillsRequest {
+    return SearchSkillsRequestFromJSONTyped(json, false);
+}
+
+export function SearchSkillsRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): SearchSkillsRequest {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'query': json['query'],
+        'topK': json['top_k'] == null ? undefined : json['top_k'],
+        'scoreThreshold': json['score_threshold'] == null ? undefined : json['score_threshold'],
+    };
+}
+
+export function SearchSkillsRequestToJSON(json: any): SearchSkillsRequest {
+    return SearchSkillsRequestToJSONTyped(json, false);
+}
+
+export function SearchSkillsRequestToJSONTyped(value?: SearchSkillsRequest | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'query': value['query'],
+        'top_k': value['topK'],
+        'score_threshold': value['scoreThreshold'],
+    };
+}
+

package/src/models/SearchSkillsResponse.ts

@@ -0,0 +1,90 @@
+/* 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 { SkillSearchResult } from './SkillSearchResult';
+import {
+    SkillSearchResultFromJSON,
+    SkillSearchResultFromJSONTyped,
+    SkillSearchResultToJSON,
+    SkillSearchResultToJSONTyped,
+} from './SkillSearchResult';
+
+/**
+ * 
+ * @export
+ * @interface SearchSkillsResponse
+ */
+export interface SearchSkillsResponse {
+    /**
+     * 
+     * @type {Array<SkillSearchResult>}
+     * @memberof SearchSkillsResponse
+     */
+    results?: Array<SkillSearchResult>;
+}
+export const SearchSkillsResponsePropertyValidationAttributesMap: {
+    [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 SearchSkillsResponse interface.
+ */
+export function instanceOfSearchSkillsResponse(value: object): value is SearchSkillsResponse {
+    return true;
+}
+
+export function SearchSkillsResponseFromJSON(json: any): SearchSkillsResponse {
+    return SearchSkillsResponseFromJSONTyped(json, false);
+}
+
+export function SearchSkillsResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): SearchSkillsResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'results': json['results'] == null ? undefined : ((json['results'] as Array<any>).map(SkillSearchResultFromJSON)),
+    };
+}
+
+export function SearchSkillsResponseToJSON(json: any): SearchSkillsResponse {
+    return SearchSkillsResponseToJSONTyped(json, false);
+}
+
+export function SearchSkillsResponseToJSONTyped(value?: SearchSkillsResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'results': value['results'] == null ? undefined : ((value['results'] as Array<any>).map(SkillSearchResultToJSON)),
+    };
+}
+

package/src/models/SkillOrder.ts

@@ -0,0 +1,54 @@
+/* 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.
+ */
+
+
+/**
+ * Sort fields for the skill list (sidebar/browse).
+ * @export
+ */
+export const SkillOrder = {
+    Name: 'NAME',
+    CreatedAt: 'CREATED_AT',
+    UpdatedAt: 'UPDATED_AT'
+} as const;
+export type SkillOrder = typeof SkillOrder[keyof typeof SkillOrder];
+
+
+export function instanceOfSkillOrder(value: any): boolean {
+    for (const key in SkillOrder) {
+        if (Object.prototype.hasOwnProperty.call(SkillOrder, key)) {
+            if (SkillOrder[key as keyof typeof SkillOrder] === value) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+
+export function SkillOrderFromJSON(json: any): SkillOrder {
+    return SkillOrderFromJSONTyped(json, false);
+}
+
+export function SkillOrderFromJSONTyped(json: any, ignoreDiscriminator: boolean): SkillOrder {
+    return json as SkillOrder;
+}
+
+export function SkillOrderToJSON(value?: SkillOrder | null): any {
+    return value as any;
+}
+
+export function SkillOrderToJSONTyped(value: any, ignoreDiscriminator: boolean): SkillOrder {
+    return value as SkillOrder;
+}
+

package/src/models/SkillResponse.ts

@@ -0,0 +1,244 @@
+/* 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 { ItemPermissions } from './ItemPermissions';
+import {
+    ItemPermissionsFromJSON,
+    ItemPermissionsFromJSONTyped,
+    ItemPermissionsToJSON,
+    ItemPermissionsToJSONTyped,
+} from './ItemPermissions';
+import type { PathPartApprovalState } from './PathPartApprovalState';
+import {
+    PathPartApprovalStateFromJSON,
+    PathPartApprovalStateFromJSONTyped,
+    PathPartApprovalStateToJSON,
+    PathPartApprovalStateToJSONTyped,
+} from './PathPartApprovalState';
+import type { UserInfo } from './UserInfo';
+import {
+    UserInfoFromJSON,
+    UserInfoFromJSONTyped,
+    UserInfoToJSON,
+    UserInfoToJSONTyped,
+} from './UserInfo';
+
+/**
+ * Skill response; ``part_type`` is the folder-listing discriminator.
+ * @export
+ * @interface SkillResponse
+ */
+export interface SkillResponse {
+    /**
+     * Path part type
+     * @type {SkillResponsePartTypeEnum}
+     * @memberof SkillResponse
+     */
+    partType?: SkillResponsePartTypeEnum;
+    /**
+     * 
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    id: string;
+    /**
+     * SKILL path_part of this skill
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    pathPartId: string;
+    /**
+     * FOLDER path_part of the containing folder
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    parentPathPartId: string | null;
+    /**
+     * Full materialized path from root
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    materializedPath: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    tenantId: string;
+    /**
+     * 
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    name: string;
+    /**
+     * One-line 'use when…' routing signal, from the SKILL.md frontmatter.
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    description: string;
+    /**
+     * Full SKILL.md content; populated on detail reads, null on list.
+     * @type {string}
+     * @memberof SkillResponse
+     */
+    skillMd?: string | null;
+    /**
+     * Bundled script file names; populated on detail reads.
+     * @type {Array<string>}
+     * @memberof SkillResponse
+     */
+    scriptNames?: Array<string>;
+    /**
+     * Whether the working copy differs from the active published version. Always present (incl. list responses) so the UI can flag a skill with an unpublished draft.
+     * @type {boolean}
+     * @memberof SkillResponse
+     */
+    hasUnpublishedChanges?: boolean;
+    /**
+     * 
+     * @type {PathPartApprovalState}
+     * @memberof SkillResponse
+     */
+    approvalState: PathPartApprovalState;
+    /**
+     * Creator, or null.
+     * @type {UserInfo}
+     * @memberof SkillResponse
+     */
+    owner?: UserInfo | null;
+    /**
+     * 
+     * @type {Date}
+     * @memberof SkillResponse
+     */
+    createdAt: Date;
+    /**
+     * 
+     * @type {Date}
+     * @memberof SkillResponse
+     */
+    updatedAt: Date;
+    /**
+     * Caller's effective rights; null on mutation responses.
+     * @type {ItemPermissions}
+     * @memberof SkillResponse
+     */
+    permissions?: ItemPermissions | null;
+}
+
+
+/**
+ * @export
+ */
+export const SkillResponsePartTypeEnum = {
+    Skill: 'SKILL'
+} as const;
+export type SkillResponsePartTypeEnum = typeof SkillResponsePartTypeEnum[keyof typeof SkillResponsePartTypeEnum];
+
+export const SkillResponsePropertyValidationAttributesMap: {
+    [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 SkillResponse interface.
+ */
+export function instanceOfSkillResponse(value: object): value is SkillResponse {
+    if (!('id' in value) || value['id'] === undefined) return false;
+    if (!('pathPartId' in value) || value['pathPartId'] === undefined) return false;
+    if (!('parentPathPartId' in value) || value['parentPathPartId'] === undefined) return false;
+    if (!('materializedPath' in value) || value['materializedPath'] === undefined) return false;
+    if (!('tenantId' in value) || value['tenantId'] === undefined) return false;
+    if (!('name' in value) || value['name'] === undefined) return false;
+    if (!('description' in value) || value['description'] === undefined) return false;
+    if (!('approvalState' in value) || value['approvalState'] === undefined) return false;
+    if (!('createdAt' in value) || value['createdAt'] === undefined) return false;
+    if (!('updatedAt' in value) || value['updatedAt'] === undefined) return false;
+    return true;
+}
+
+export function SkillResponseFromJSON(json: any): SkillResponse {
+    return SkillResponseFromJSONTyped(json, false);
+}
+
+export function SkillResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): SkillResponse {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'partType': json['part_type'] == null ? undefined : json['part_type'],
+        'id': json['id'],
+        'pathPartId': json['path_part_id'],
+        'parentPathPartId': json['parent_path_part_id'],
+        'materializedPath': json['materialized_path'],
+        'tenantId': json['tenant_id'],
+        'name': json['name'],
+        'description': json['description'],
+        'skillMd': json['skill_md'] == null ? undefined : json['skill_md'],
+        'scriptNames': json['script_names'] == null ? undefined : json['script_names'],
+        'hasUnpublishedChanges': json['has_unpublished_changes'] == null ? undefined : json['has_unpublished_changes'],
+        'approvalState': PathPartApprovalStateFromJSON(json['approval_state']),
+        'owner': json['owner'] == null ? undefined : UserInfoFromJSON(json['owner']),
+        'createdAt': (new Date(json['created_at'])),
+        'updatedAt': (new Date(json['updated_at'])),
+        'permissions': json['permissions'] == null ? undefined : ItemPermissionsFromJSON(json['permissions']),
+    };
+}
+
+export function SkillResponseToJSON(json: any): SkillResponse {
+    return SkillResponseToJSONTyped(json, false);
+}
+
+export function SkillResponseToJSONTyped(value?: SkillResponse | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'part_type': value['partType'],
+        'id': value['id'],
+        'path_part_id': value['pathPartId'],
+        'parent_path_part_id': value['parentPathPartId'],
+        'materialized_path': value['materializedPath'],
+        'tenant_id': value['tenantId'],
+        'name': value['name'],
+        'description': value['description'],
+        'skill_md': value['skillMd'],
+        'script_names': value['scriptNames'],
+        'has_unpublished_changes': value['hasUnpublishedChanges'],
+        'approval_state': PathPartApprovalStateToJSON(value['approvalState']),
+        'owner': UserInfoToJSON(value['owner']),
+        'created_at': value['createdAt'].toISOString(),
+        'updated_at': value['updatedAt'].toISOString(),
+        'permissions': ItemPermissionsToJSON(value['permissions']),
+    };
+}
+

package/src/models/SkillScriptFile.ts

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