@knowledge-stack/ksapi 1.143.0 → 1.145.0

package/dist/esm/models/CreateSkillRequest.js

@@ -11,13 +11,13 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-import { SkillScriptFileFromJSON, SkillScriptFileToJSON, } from './SkillScriptFile';
+import { SkillFileFromJSON, SkillFileToJSON, } from './SkillFile';
 export const CreateSkillRequestPropertyValidationAttributesMap = {
     name: {
         maxLength: 255,
     },
-    scripts: {
-        maxItems: 50,
+    files: {
+        maxItems: 2000,
         uniqueItems: false,
     },
 };
@@ -41,7 +41,7 @@ export function CreateSkillRequestFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'name': json['name'],
         'skillMd': json['skill_md'],
-        'scripts': json['scripts'] == null ? undefined : (json['scripts'].map(SkillScriptFileFromJSON)),
+        'files': json['files'] == null ? undefined : (json['files'].map(SkillFileFromJSON)),
     };
 }
 export function CreateSkillRequestToJSON(json) {
@@ -54,6 +54,6 @@ export function CreateSkillRequestToJSONTyped(value, ignoreDiscriminator = false
     return {
         'name': value['name'],
         'skill_md': value['skillMd'],
-        'scripts': value['scripts'] == null ? undefined : (value['scripts'].map(SkillScriptFileToJSON)),
+        'files': value['files'] == null ? undefined : (value['files'].map(SkillFileToJSON)),
     };
 }

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

@@ -10,12 +10,14 @@
  * Do not edit the class manually.
  */
 import type { UserInfo } from './UserInfo';
+import type { ResolvedRef } from './ResolvedRef';
 /**
  * One event row, anchored to a path_part subject.
  *
  * ``kind`` is namespaced ``domain.action`` (e.g. ``workflow.approval``,
  * ``document.created``). ``payload`` is the domain-specific structured
- * JSON associated with the event.
+ * JSON associated with the event, stored verbatim and never rewritten —
+ * the human-readable resolution lives alongside it in ``references``.
  * @export
  * @interface EventResponse
  */
@@ -64,6 +66,38 @@ export interface EventResponse {
      * @memberof EventResponse
      */
     actor?: UserInfo | null;
+    /**
+     *
+     * @type {string}
+     * @memberof EventResponse
+     */
+    subjectName?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof EventResponse
+     */
+    subjectPath?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof EventResponse
+     */
+    subjectObjectId?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof EventResponse
+     */
+    subjectPartType?: string | null;
+    /**
+     *
+     * @type {{ [key: string]: ResolvedRef; }}
+     * @memberof EventResponse
+     */
+    references?: {
+        [key: string]: ResolvedRef;
+    };
 }
 export declare const EventResponsePropertyValidationAttributesMap: {
     [property: string]: {

package/dist/esm/models/EventResponse.js

@@ -11,7 +11,9 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
+import { mapValues } from '../runtime';
 import { UserInfoFromJSON, UserInfoToJSON, } from './UserInfo';
+import { ResolvedRefFromJSON, ResolvedRefToJSON, } from './ResolvedRef';
 export const EventResponsePropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the EventResponse interface.
@@ -46,6 +48,11 @@ export function EventResponseFromJSONTyped(json, ignoreDiscriminator) {
         'actorUserId': json['actor_user_id'],
         'payload': json['payload'],
         'actor': json['actor'] == null ? undefined : UserInfoFromJSON(json['actor']),
+        'subjectName': json['subject_name'] == null ? undefined : json['subject_name'],
+        'subjectPath': json['subject_path'] == null ? undefined : json['subject_path'],
+        'subjectObjectId': json['subject_object_id'] == null ? undefined : json['subject_object_id'],
+        'subjectPartType': json['subject_part_type'] == null ? undefined : json['subject_part_type'],
+        'references': json['references'] == null ? undefined : (mapValues(json['references'], ResolvedRefFromJSON)),
     };
 }
 export function EventResponseToJSON(json) {
@@ -63,5 +70,10 @@ export function EventResponseToJSONTyped(value, ignoreDiscriminator = false) {
         'actor_user_id': value['actorUserId'],
         'payload': value['payload'],
         'actor': UserInfoToJSON(value['actor']),
+        'subject_name': value['subjectName'],
+        'subject_path': value['subjectPath'],
+        'subject_object_id': value['subjectObjectId'],
+        'subject_part_type': value['subjectPartType'],
+        'references': value['references'] == null ? undefined : (mapValues(value['references'], ResolvedRefToJSON)),
     };
 }

package/dist/esm/models/{SkillScriptFile.d.ts → ReorderPathPartRequest.d.ts}

@@ -10,25 +10,25 @@
  * Do not edit the class manually.
  */
 /**
- * A single script bundled under a skill's ``scripts/`` folder.
+ * Reorder a path part within its sibling list.
  * @export
- * @interface SkillScriptFile
+ * @interface ReorderPathPartRequest
  */
-export interface SkillScriptFile {
+export interface ReorderPathPartRequest {
     /**
-     * Script file name, e.g. inspect.py
+     * Place this node immediately after the given sibling PathPart id (must share the same parent). Pass the current tail's id to move to the end. Requires move_to_head=false.
      * @type {string}
-     * @memberof SkillScriptFile
+     * @memberof ReorderPathPartRequest
      */
-    name: string;
+    prevSiblingPathId?: string | null;
     /**
-     * Script file contents (UTF-8 text).
-     * @type {string}
-     * @memberof SkillScriptFile
+     * Move this node to the head of its sibling list.
+     * @type {boolean}
+     * @memberof ReorderPathPartRequest
      */
-    content: string;
+    moveToHead?: boolean;
 }
-export declare const SkillScriptFilePropertyValidationAttributesMap: {
+export declare const ReorderPathPartRequestPropertyValidationAttributesMap: {
     [property: string]: {
         maxLength?: number;
         minLength?: number;
@@ -44,10 +44,10 @@ export declare const SkillScriptFilePropertyValidationAttributesMap: {
     };
 };
 /**
- * Check if a given object implements the SkillScriptFile interface.
+ * Check if a given object implements the ReorderPathPartRequest interface.
  */
-export declare function instanceOfSkillScriptFile(value: object): value is SkillScriptFile;
-export declare function SkillScriptFileFromJSON(json: any): SkillScriptFile;
-export declare function SkillScriptFileFromJSONTyped(json: any, ignoreDiscriminator: boolean): SkillScriptFile;
-export declare function SkillScriptFileToJSON(json: any): SkillScriptFile;
-export declare function SkillScriptFileToJSONTyped(value?: SkillScriptFile | null, ignoreDiscriminator?: boolean): any;
+export declare function instanceOfReorderPathPartRequest(value: object): value is ReorderPathPartRequest;
+export declare function ReorderPathPartRequestFromJSON(json: any): ReorderPathPartRequest;
+export declare function ReorderPathPartRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): ReorderPathPartRequest;
+export declare function ReorderPathPartRequestToJSON(json: any): ReorderPathPartRequest;
+export declare function ReorderPathPartRequestToJSONTyped(value?: ReorderPathPartRequest | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/ReorderPathPartRequest.js

@@ -0,0 +1,44 @@
+/* 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.
+ */
+export const ReorderPathPartRequestPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the ReorderPathPartRequest interface.
+ */
+export function instanceOfReorderPathPartRequest(value) {
+    return true;
+}
+export function ReorderPathPartRequestFromJSON(json) {
+    return ReorderPathPartRequestFromJSONTyped(json, false);
+}
+export function ReorderPathPartRequestFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'prevSiblingPathId': json['prev_sibling_path_id'] == null ? undefined : json['prev_sibling_path_id'],
+        'moveToHead': json['move_to_head'] == null ? undefined : json['move_to_head'],
+    };
+}
+export function ReorderPathPartRequestToJSON(json) {
+    return ReorderPathPartRequestToJSONTyped(json, false);
+}
+export function ReorderPathPartRequestToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'prev_sibling_path_id': value['prevSiblingPathId'],
+        'move_to_head': value['moveToHead'],
+    };
+}

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

@@ -0,0 +1,79 @@
+/**
+ * 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.
+ */
+/**
+ * One id resolved to a human-readable, linkable entity.
+ *
+ * Every UUID that appears in an event (its subject, its actor, and any id
+ * inside the payload) resolves to one of these so the frontend can render a
+ * name and a link instead of a bare UUID. ``object_id`` is what the frontend
+ * routes on: a PDO id for a path_part (never the internal path_part_id), or
+ * the user id for a user.
+ * @export
+ * @interface ResolvedRef
+ */
+export interface ResolvedRef {
+    /**
+     *
+     * @type {ResolvedRefEntityTypeEnum}
+     * @memberof ResolvedRef
+     */
+    entityType: ResolvedRefEntityTypeEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof ResolvedRef
+     */
+    objectId: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ResolvedRef
+     */
+    displayName?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof ResolvedRef
+     */
+    partType?: string | null;
+}
+/**
+ * @export
+ */
+export declare const ResolvedRefEntityTypeEnum: {
+    readonly PathPart: 'path_part';
+    readonly User: 'user';
+};
+export type ResolvedRefEntityTypeEnum = typeof ResolvedRefEntityTypeEnum[keyof typeof ResolvedRefEntityTypeEnum];
+export declare const ResolvedRefPropertyValidationAttributesMap: {
+    [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 ResolvedRef interface.
+ */
+export declare function instanceOfResolvedRef(value: object): value is ResolvedRef;
+export declare function ResolvedRefFromJSON(json: any): ResolvedRef;
+export declare function ResolvedRefFromJSONTyped(json: any, ignoreDiscriminator: boolean): ResolvedRef;
+export declare function ResolvedRefToJSON(json: any): ResolvedRef;
+export declare function ResolvedRefToJSONTyped(value?: ResolvedRef | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/ResolvedRef.js

@@ -0,0 +1,59 @@
+/* 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.
+ */
+/**
+ * @export
+ */
+export const ResolvedRefEntityTypeEnum = {
+    PathPart: 'path_part',
+    User: 'user'
+};
+export const ResolvedRefPropertyValidationAttributesMap = {};
+/**
+ * Check if a given object implements the ResolvedRef interface.
+ */
+export function instanceOfResolvedRef(value) {
+    if (!('entityType' in value) || value['entityType'] === undefined)
+        return false;
+    if (!('objectId' in value) || value['objectId'] === undefined)
+        return false;
+    return true;
+}
+export function ResolvedRefFromJSON(json) {
+    return ResolvedRefFromJSONTyped(json, false);
+}
+export function ResolvedRefFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'entityType': json['entity_type'],
+        'objectId': json['object_id'],
+        'displayName': json['display_name'] == null ? undefined : json['display_name'],
+        'partType': json['part_type'] == null ? undefined : json['part_type'],
+    };
+}
+export function ResolvedRefToJSON(json) {
+    return ResolvedRefToJSONTyped(json, false);
+}
+export function ResolvedRefToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'entity_type': value['entityType'],
+        'object_id': value['objectId'],
+        'display_name': value['displayName'],
+        'part_type': value['partType'],
+    };
+}

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

@@ -0,0 +1,71 @@
+/**
+ * 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.
+ */
+/**
+ * One file in a skill bundle, at a path relative to the skill root.
+ *
+ * Skills carry arbitrary trees (``scripts/office/validate.py``,
+ * ``references/guide.md``, ``assets/logo.png``), so binary files are carried
+ * base64-encoded rather than excluded.
+ * @export
+ * @interface SkillFile
+ */
+export interface SkillFile {
+    /**
+     * Path relative to the skill root, e.g. scripts/office/run.py
+     * @type {string}
+     * @memberof SkillFile
+     */
+    path: string;
+    /**
+     * UTF-8 text, or base64-encoded bytes when encoding=base64.
+     * @type {string}
+     * @memberof SkillFile
+     */
+    content: string;
+    /**
+     * How `content` is encoded.
+     * @type {SkillFileEncodingEnum}
+     * @memberof SkillFile
+     */
+    encoding?: SkillFileEncodingEnum;
+}
+/**
+ * @export
+ */
+export declare const SkillFileEncodingEnum: {
+    readonly Utf8: 'utf-8';
+    readonly Base64: 'base64';
+};
+export type SkillFileEncodingEnum = typeof SkillFileEncodingEnum[keyof typeof SkillFileEncodingEnum];
+export declare const SkillFilePropertyValidationAttributesMap: {
+    [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 SkillFile interface.
+ */
+export declare function instanceOfSkillFile(value: object): value is SkillFile;
+export declare function SkillFileFromJSON(json: any): SkillFile;
+export declare function SkillFileFromJSONTyped(json: any, ignoreDiscriminator: boolean): SkillFile;
+export declare function SkillFileToJSON(json: any): SkillFile;
+export declare function SkillFileToJSONTyped(value?: SkillFile | null, ignoreDiscriminator?: boolean): any;

package/dist/esm/models/{SkillScriptFile.js → SkillFile.js}

@@ -11,42 +11,51 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-export const SkillScriptFilePropertyValidationAttributesMap = {
-    name: {
-        maxLength: 255,
+/**
+ * @export
+ */
+export const SkillFileEncodingEnum = {
+    Utf8: 'utf-8',
+    Base64: 'base64'
+};
+export const SkillFilePropertyValidationAttributesMap = {
+    path: {
+        maxLength: 1024,
     },
 };
 /**
- * Check if a given object implements the SkillScriptFile interface.
+ * Check if a given object implements the SkillFile interface.
  */
-export function instanceOfSkillScriptFile(value) {
-    if (!('name' in value) || value['name'] === undefined)
+export function instanceOfSkillFile(value) {
+    if (!('path' in value) || value['path'] === undefined)
         return false;
     if (!('content' in value) || value['content'] === undefined)
         return false;
     return true;
 }
-export function SkillScriptFileFromJSON(json) {
-    return SkillScriptFileFromJSONTyped(json, false);
+export function SkillFileFromJSON(json) {
+    return SkillFileFromJSONTyped(json, false);
 }
-export function SkillScriptFileFromJSONTyped(json, ignoreDiscriminator) {
+export function SkillFileFromJSONTyped(json, ignoreDiscriminator) {
     if (json == null) {
         return json;
     }
     return {
-        'name': json['name'],
+        'path': json['path'],
         'content': json['content'],
+        'encoding': json['encoding'] == null ? undefined : json['encoding'],
     };
 }
-export function SkillScriptFileToJSON(json) {
-    return SkillScriptFileToJSONTyped(json, false);
+export function SkillFileToJSON(json) {
+    return SkillFileToJSONTyped(json, false);
 }
-export function SkillScriptFileToJSONTyped(value, ignoreDiscriminator = false) {
+export function SkillFileToJSONTyped(value, ignoreDiscriminator = false) {
     if (value == null) {
         return value;
     }
     return {
-        'name': value['name'],
+        'path': value['path'],
         'content': value['content'],
+        'encoding': value['encoding'],
     };
 }

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

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import type { ItemPermissions } from './ItemPermissions';
-import type { SkillScriptFile } from './SkillScriptFile';
+import type { SkillFile } from './SkillFile';
 import type { PathPartApprovalState } from './PathPartApprovalState';
 import type { UserInfo } from './UserInfo';
 /**
@@ -74,17 +74,17 @@ export interface SkillResponse {
      */
     skillMd?: string | null;
     /**
-     * Bundled script file names; populated on the detail read and on mutation responses, empty on list.
+     * Bundle file paths relative to the skill root (SKILL.md excluded); populated on the detail read and on mutation responses, empty on list.
      * @type {Array<string>}
      * @memberof SkillResponse
      */
-    scriptNames?: Array<string>;
+    filePaths?: Array<string>;
     /**
-     * Bundled scripts with their contents; populated only on the detail read (GET /skills/{id}), null on list. Lets the editor read the current script set so a PATCH can safely resubmit the whole set.
-     * @type {Array<SkillScriptFile>}
+     * Bundle files with their contents; populated only on the detail read (GET /skills/{id}), null on list. Lets the editor read the current file set so a PATCH can safely resubmit the whole set.
+     * @type {Array<SkillFile>}
      * @memberof SkillResponse
      */
-    scripts?: Array<SkillScriptFile> | null;
+    files?: Array<SkillFile> | null;
     /**
      * 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}

package/dist/esm/models/SkillResponse.js

@@ -12,7 +12,7 @@
  * Do not edit the class manually.
  */
 import { ItemPermissionsFromJSON, ItemPermissionsToJSON, } from './ItemPermissions';
-import { SkillScriptFileFromJSON, SkillScriptFileToJSON, } from './SkillScriptFile';
+import { SkillFileFromJSON, SkillFileToJSON, } from './SkillFile';
 import { PathPartApprovalStateFromJSON, PathPartApprovalStateToJSON, } from './PathPartApprovalState';
 import { UserInfoFromJSON, UserInfoToJSON, } from './UserInfo';
 /**
@@ -65,8 +65,8 @@ export function SkillResponseFromJSONTyped(json, ignoreDiscriminator) {
         'name': json['name'],
         'description': json['description'],
         'skillMd': json['skill_md'] == null ? undefined : json['skill_md'],
-        'scriptNames': json['script_names'] == null ? undefined : json['script_names'],
-        'scripts': json['scripts'] == null ? undefined : (json['scripts'].map(SkillScriptFileFromJSON)),
+        'filePaths': json['file_paths'] == null ? undefined : json['file_paths'],
+        'files': json['files'] == null ? undefined : (json['files'].map(SkillFileFromJSON)),
         'hasUnpublishedChanges': json['has_unpublished_changes'] == null ? undefined : json['has_unpublished_changes'],
         'approvalState': PathPartApprovalStateFromJSON(json['approval_state']),
         'owner': json['owner'] == null ? undefined : UserInfoFromJSON(json['owner']),
@@ -92,8 +92,8 @@ export function SkillResponseToJSONTyped(value, ignoreDiscriminator = false) {
         'name': value['name'],
         'description': value['description'],
         'skill_md': value['skillMd'],
-        'script_names': value['scriptNames'],
-        'scripts': value['scripts'] == null ? undefined : (value['scripts'].map(SkillScriptFileToJSON)),
+        'file_paths': value['filePaths'],
+        'files': value['files'] == null ? undefined : (value['files'].map(SkillFileToJSON)),
         'has_unpublished_changes': value['hasUnpublishedChanges'],
         'approval_state': PathPartApprovalStateToJSON(value['approvalState']),
         'owner': UserInfoToJSON(value['owner']),

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

@@ -9,7 +9,7 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-import type { SkillScriptFile } from './SkillScriptFile';
+import type { SkillFile } from './SkillFile';
 /**
  * Edit working-copy files in place (does NOT cut a version).
  * @export
@@ -23,11 +23,11 @@ export interface UpdateSkillRequest {
      */
     skillMd?: string | null;
     /**
-     * Replace the working-copy scripts set (add/overwrite/remove to match); null leaves scripts unchanged, [] removes them all.
-     * @type {Array<SkillScriptFile>}
+     * Replace the whole bundle below SKILL.md (add/overwrite/remove to match); null leaves the tree unchanged, [] removes every file.
+     * @type {Array<SkillFile>}
      * @memberof UpdateSkillRequest
      */
-    scripts?: Array<SkillScriptFile> | null;
+    files?: Array<SkillFile> | null;
 }
 export declare const UpdateSkillRequestPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/esm/models/UpdateSkillRequest.js

@@ -11,10 +11,10 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-import { SkillScriptFileFromJSON, SkillScriptFileToJSON, } from './SkillScriptFile';
+import { SkillFileFromJSON, SkillFileToJSON, } from './SkillFile';
 export const UpdateSkillRequestPropertyValidationAttributesMap = {
-    scripts: {
-        maxItems: 50,
+    files: {
+        maxItems: 2000,
         uniqueItems: false,
     },
 };
@@ -33,7 +33,7 @@ export function UpdateSkillRequestFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'skillMd': json['skill_md'] == null ? undefined : json['skill_md'],
-        'scripts': json['scripts'] == null ? undefined : (json['scripts'].map(SkillScriptFileFromJSON)),
+        'files': json['files'] == null ? undefined : (json['files'].map(SkillFileFromJSON)),
     };
 }
 export function UpdateSkillRequestToJSON(json) {
@@ -45,6 +45,6 @@ export function UpdateSkillRequestToJSONTyped(value, ignoreDiscriminator = false
     }
     return {
         'skill_md': value['skillMd'],
-        'scripts': value['scripts'] == null ? undefined : (value['scripts'].map(SkillScriptFileToJSON)),
+        'files': value['files'] == null ? undefined : (value['files'].map(SkillFileToJSON)),
     };
 }

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

@@ -225,7 +225,9 @@ export * from './ProposeMemoryChunkRequest';
 export * from './ProposedMemoryChunkResponse';
 export * from './ReasoningPart';
 export * from './ReferenceType';
+export * from './ReorderPathPartRequest';
 export * from './RequestPhoneChangeRequest';
+export * from './ResolvedRef';
 export * from './ResolvedReferenceInput';
 export * from './ResolvedReferenceOutput';
 export * from './ResponseSendPwResetEmail';
@@ -253,9 +255,9 @@ export * from './SetApprovalStateRequest';
 export * from './SetWorkflowRunApprovalRequest';
 export * from './SheetVisibilityChange';
 export * from './SignInRequest';
+export * from './SkillFile';
 export * from './SkillOrder';
 export * from './SkillResponse';
-export * from './SkillScriptFile';
 export * from './SkillSearchResult';
 export * from './SkillVersionResponse';
 export * from './SortDirection';