@knowledge-stack/ksapi 1.144.0 → 1.145.0

package/dist/models/CreateSkillRequest.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';
 /**
  * Author a skill from a SKILL.md bundle.
  * @export
@@ -29,11 +29,11 @@ export interface CreateSkillRequest {
      */
     skillMd: string;
     /**
-     * Optional scripts bundled under the skill's scripts/ folder.
-     * @type {Array<SkillScriptFile>}
+     * Optional bundle files at paths relative to the skill root (scripts/, references/, assets/, …). SKILL.md is supplied separately and must not be repeated here.
+     * @type {Array<SkillFile>}
      * @memberof CreateSkillRequest
      */
-    scripts?: Array<SkillScriptFile>;
+    files?: Array<SkillFile>;
 }
 export declare const CreateSkillRequestPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/models/CreateSkillRequest.js

@@ -19,13 +19,13 @@ exports.CreateSkillRequestFromJSON = CreateSkillRequestFromJSON;
 exports.CreateSkillRequestFromJSONTyped = CreateSkillRequestFromJSONTyped;
 exports.CreateSkillRequestToJSON = CreateSkillRequestToJSON;
 exports.CreateSkillRequestToJSONTyped = CreateSkillRequestToJSONTyped;
-const SkillScriptFile_1 = require("./SkillScriptFile");
+const SkillFile_1 = require("./SkillFile");
 exports.CreateSkillRequestPropertyValidationAttributesMap = {
     name: {
         maxLength: 255,
     },
-    scripts: {
-        maxItems: 50,
+    files: {
+        maxItems: 2000,
         uniqueItems: false,
     },
 };
@@ -49,7 +49,7 @@ function CreateSkillRequestFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'name': json['name'],
         'skillMd': json['skill_md'],
-        'scripts': json['scripts'] == null ? undefined : (json['scripts'].map(SkillScriptFile_1.SkillScriptFileFromJSON)),
+        'files': json['files'] == null ? undefined : (json['files'].map(SkillFile_1.SkillFileFromJSON)),
     };
 }
 function CreateSkillRequestToJSON(json) {
@@ -62,6 +62,6 @@ function CreateSkillRequestToJSONTyped(value, ignoreDiscriminator = false) {
     return {
         'name': value['name'],
         'skill_md': value['skillMd'],
-        'scripts': value['scripts'] == null ? undefined : (value['scripts'].map(SkillScriptFile_1.SkillScriptFileToJSON)),
+        'files': value['files'] == null ? undefined : (value['files'].map(SkillFile_1.SkillFileToJSON)),
     };
 }

package/dist/models/{SkillScriptFile.d.ts → SkillFile.d.ts}

@@ -10,25 +10,43 @@
  * Do not edit the class manually.
  */
 /**
- * A single script bundled under a skill's ``scripts/`` folder.
+ * 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 SkillScriptFile
+ * @interface SkillFile
  */
-export interface SkillScriptFile {
+export interface SkillFile {
     /**
-     * Script file name, e.g. inspect.py
+     * Path relative to the skill root, e.g. scripts/office/run.py
      * @type {string}
-     * @memberof SkillScriptFile
+     * @memberof SkillFile
      */
-    name: string;
+    path: string;
     /**
-     * Script file contents (UTF-8 text).
+     * UTF-8 text, or base64-encoded bytes when encoding=base64.
      * @type {string}
-     * @memberof SkillScriptFile
+     * @memberof SkillFile
      */
     content: string;
+    /**
+     * How `content` is encoded.
+     * @type {SkillFileEncodingEnum}
+     * @memberof SkillFile
+     */
+    encoding?: SkillFileEncodingEnum;
 }
-export declare const SkillScriptFilePropertyValidationAttributesMap: {
+/**
+ * @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;
@@ -44,10 +62,10 @@ export declare const SkillScriptFilePropertyValidationAttributesMap: {
     };
 };
 /**
- * Check if a given object implements the SkillScriptFile interface.
+ * Check if a given object implements the SkillFile 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 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/models/{SkillScriptFile.js → SkillFile.js}

@@ -13,48 +13,57 @@
  * Do not edit the class manually.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SkillScriptFilePropertyValidationAttributesMap = void 0;
-exports.instanceOfSkillScriptFile = instanceOfSkillScriptFile;
-exports.SkillScriptFileFromJSON = SkillScriptFileFromJSON;
-exports.SkillScriptFileFromJSONTyped = SkillScriptFileFromJSONTyped;
-exports.SkillScriptFileToJSON = SkillScriptFileToJSON;
-exports.SkillScriptFileToJSONTyped = SkillScriptFileToJSONTyped;
-exports.SkillScriptFilePropertyValidationAttributesMap = {
-    name: {
-        maxLength: 255,
+exports.SkillFilePropertyValidationAttributesMap = exports.SkillFileEncodingEnum = void 0;
+exports.instanceOfSkillFile = instanceOfSkillFile;
+exports.SkillFileFromJSON = SkillFileFromJSON;
+exports.SkillFileFromJSONTyped = SkillFileFromJSONTyped;
+exports.SkillFileToJSON = SkillFileToJSON;
+exports.SkillFileToJSONTyped = SkillFileToJSONTyped;
+/**
+ * @export
+ */
+exports.SkillFileEncodingEnum = {
+    Utf8: 'utf-8',
+    Base64: 'base64'
+};
+exports.SkillFilePropertyValidationAttributesMap = {
+    path: {
+        maxLength: 1024,
     },
 };
 /**
- * Check if a given object implements the SkillScriptFile interface.
+ * Check if a given object implements the SkillFile interface.
  */
-function instanceOfSkillScriptFile(value) {
-    if (!('name' in value) || value['name'] === undefined)
+function instanceOfSkillFile(value) {
+    if (!('path' in value) || value['path'] === undefined)
         return false;
     if (!('content' in value) || value['content'] === undefined)
         return false;
     return true;
 }
-function SkillScriptFileFromJSON(json) {
-    return SkillScriptFileFromJSONTyped(json, false);
+function SkillFileFromJSON(json) {
+    return SkillFileFromJSONTyped(json, false);
 }
-function SkillScriptFileFromJSONTyped(json, ignoreDiscriminator) {
+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'],
     };
 }
-function SkillScriptFileToJSON(json) {
-    return SkillScriptFileToJSONTyped(json, false);
+function SkillFileToJSON(json) {
+    return SkillFileToJSONTyped(json, false);
 }
-function SkillScriptFileToJSONTyped(value, ignoreDiscriminator = false) {
+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/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/models/SkillResponse.js

@@ -20,7 +20,7 @@ exports.SkillResponseFromJSONTyped = SkillResponseFromJSONTyped;
 exports.SkillResponseToJSON = SkillResponseToJSON;
 exports.SkillResponseToJSONTyped = SkillResponseToJSONTyped;
 const ItemPermissions_1 = require("./ItemPermissions");
-const SkillScriptFile_1 = require("./SkillScriptFile");
+const SkillFile_1 = require("./SkillFile");
 const PathPartApprovalState_1 = require("./PathPartApprovalState");
 const UserInfo_1 = require("./UserInfo");
 /**
@@ -73,8 +73,8 @@ 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(SkillScriptFile_1.SkillScriptFileFromJSON)),
+        'filePaths': json['file_paths'] == null ? undefined : json['file_paths'],
+        'files': json['files'] == null ? undefined : (json['files'].map(SkillFile_1.SkillFileFromJSON)),
         'hasUnpublishedChanges': json['has_unpublished_changes'] == null ? undefined : json['has_unpublished_changes'],
         'approvalState': (0, PathPartApprovalState_1.PathPartApprovalStateFromJSON)(json['approval_state']),
         'owner': json['owner'] == null ? undefined : (0, UserInfo_1.UserInfoFromJSON)(json['owner']),
@@ -100,8 +100,8 @@ 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(SkillScriptFile_1.SkillScriptFileToJSON)),
+        'file_paths': value['filePaths'],
+        'files': value['files'] == null ? undefined : (value['files'].map(SkillFile_1.SkillFileToJSON)),
         'has_unpublished_changes': value['hasUnpublishedChanges'],
         'approval_state': (0, PathPartApprovalState_1.PathPartApprovalStateToJSON)(value['approvalState']),
         'owner': (0, UserInfo_1.UserInfoToJSON)(value['owner']),

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

@@ -19,10 +19,10 @@ exports.UpdateSkillRequestFromJSON = UpdateSkillRequestFromJSON;
 exports.UpdateSkillRequestFromJSONTyped = UpdateSkillRequestFromJSONTyped;
 exports.UpdateSkillRequestToJSON = UpdateSkillRequestToJSON;
 exports.UpdateSkillRequestToJSONTyped = UpdateSkillRequestToJSONTyped;
-const SkillScriptFile_1 = require("./SkillScriptFile");
+const SkillFile_1 = require("./SkillFile");
 exports.UpdateSkillRequestPropertyValidationAttributesMap = {
-    scripts: {
-        maxItems: 50,
+    files: {
+        maxItems: 2000,
         uniqueItems: false,
     },
 };
@@ -41,7 +41,7 @@ function UpdateSkillRequestFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'skillMd': json['skill_md'] == null ? undefined : json['skill_md'],
-        'scripts': json['scripts'] == null ? undefined : (json['scripts'].map(SkillScriptFile_1.SkillScriptFileFromJSON)),
+        'files': json['files'] == null ? undefined : (json['files'].map(SkillFile_1.SkillFileFromJSON)),
     };
 }
 function UpdateSkillRequestToJSON(json) {
@@ -53,6 +53,6 @@ function UpdateSkillRequestToJSONTyped(value, ignoreDiscriminator = false) {
     }
     return {
         'skill_md': value['skillMd'],
-        'scripts': value['scripts'] == null ? undefined : (value['scripts'].map(SkillScriptFile_1.SkillScriptFileToJSON)),
+        'files': value['files'] == null ? undefined : (value['files'].map(SkillFile_1.SkillFileToJSON)),
     };
 }

package/dist/models/index.d.ts

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

package/dist/models/index.js

@@ -273,9 +273,9 @@ __exportStar(require("./SetApprovalStateRequest"), exports);
 __exportStar(require("./SetWorkflowRunApprovalRequest"), exports);
 __exportStar(require("./SheetVisibilityChange"), exports);
 __exportStar(require("./SignInRequest"), exports);
+__exportStar(require("./SkillFile"), exports);
 __exportStar(require("./SkillOrder"), exports);
 __exportStar(require("./SkillResponse"), exports);
-__exportStar(require("./SkillScriptFile"), exports);
 __exportStar(require("./SkillSearchResult"), exports);
 __exportStar(require("./SkillVersionResponse"), exports);
 __exportStar(require("./SortDirection"), exports);

package/docs/CreateSkillRequest.md

@@ -9,7 +9,7 @@ Name | Type
 ------------ | -------------
 `name` | string
 `skillMd` | string
-`scripts` | [Array<SkillScriptFile>](SkillScriptFile.md)
+`files` | [Array<SkillFile>](SkillFile.md)
 
 ## Example
 
@@ -20,7 +20,7 @@ import type { CreateSkillRequest } from '@knowledge-stack/ksapi'
 const example = {
   "name": null,
   "skillMd": null,
-  "scripts": null,
+  "files": null,
 } satisfies CreateSkillRequest
 
 console.log(example)

package/docs/FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR.md

@@ -65,8 +65,8 @@ Name | Type
 `disclaimerAcceptedAt` | Date
 `disclaimerAcceptedBy` | string
 `skillMd` | string
-`scriptNames` | Array<string>
-`scripts` | [Array<SkillScriptFile>](SkillScriptFile.md)
+`filePaths` | Array<string>
+`files` | [Array<SkillFile>](SkillFile.md)
 `hasUnpublishedChanges` | boolean
 
 ## Example
@@ -135,8 +135,8 @@ const example = {
   "disclaimerAcceptedAt": null,
   "disclaimerAcceptedBy": null,
   "skillMd": null,
-  "scriptNames": null,
-  "scripts": null,
+  "filePaths": null,
+  "files": null,
   "hasUnpublishedChanges": null,
 } satisfies FolderResponseOrDocumentResponseOrWorkflowDefinitionResponseOrWorkflowRunResponseOrDataSourceResponseOrDataSourceSchemaR
 

package/docs/{SkillScriptFile.md → SkillFile.md}

@@ -1,25 +1,27 @@
 
-# SkillScriptFile
+# SkillFile
 
-A single script bundled under a skill\'s ``scripts/`` folder.
+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.
 
 ## Properties
 
 Name | Type
 ------------ | -------------
-`name` | string
+`path` | string
 `content` | string
+`encoding` | string
 
 ## Example
 
 ```typescript
-import type { SkillScriptFile } from '@knowledge-stack/ksapi'
+import type { SkillFile } from '@knowledge-stack/ksapi'
 
 // TODO: Update the object below with actual values
 const example = {
-  "name": null,
+  "path": null,
   "content": null,
-} satisfies SkillScriptFile
+  "encoding": null,
+} satisfies SkillFile
 
 console.log(example)
 
@@ -28,7 +30,7 @@ const exampleJSON: string = JSON.stringify(example)
 console.log(exampleJSON)
 
 // Parse the JSON string back to an object
-const exampleParsed = JSON.parse(exampleJSON) as SkillScriptFile
+const exampleParsed = JSON.parse(exampleJSON) as SkillFile
 console.log(exampleParsed)
 ```
 

package/docs/SkillResponse.md

@@ -16,8 +16,8 @@ Name | Type
 `name` | string
 `description` | string
 `skillMd` | string
-`scriptNames` | Array<string>
-`scripts` | [Array<SkillScriptFile>](SkillScriptFile.md)
+`filePaths` | Array<string>
+`files` | [Array<SkillFile>](SkillFile.md)
 `hasUnpublishedChanges` | boolean
 `approvalState` | [PathPartApprovalState](PathPartApprovalState.md)
 `owner` | [UserInfo](UserInfo.md)
@@ -41,8 +41,8 @@ const example = {
   "name": null,
   "description": null,
   "skillMd": null,
-  "scriptNames": null,
-  "scripts": null,
+  "filePaths": null,
+  "files": null,
   "hasUnpublishedChanges": null,
   "approvalState": null,
   "owner": null,

package/docs/SkillsApi.md

@@ -554,11 +554,11 @@ example().catch(console.error);
 
 ## getSkill
 
-> SkillResponse getSkill(skillId)
+> SkillResponse getSkill(skillId, includeFileContents)
 
 Get Skill Handler
 
-Skill detail: SKILL.md, script contents, has_unpublished_changes, perms.
+Skill detail: SKILL.md, file paths (+ contents on request), perms.
 
 ### Example
 
@@ -582,6 +582,8 @@ async function example() {
   const body = {
     // string
     skillId: 38400000-8cf0-11bd-b23e-10b96e4ef00d,
+    // boolean | Include every bundle file\'s contents (base64 for binary). Off by default — the editor opts in; a large skill\'s contents can be many MB and one S3 read per file. (optional)
+    includeFileContents: true,
   } satisfies GetSkillRequest;
 
   try {
@@ -602,6 +604,7 @@ example().catch(console.error);
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
 | **skillId** | `string` |  | [Defaults to `undefined`] |
+| **includeFileContents** | `boolean` | Include every bundle file\'s contents (base64 for binary). Off by default — the editor opts in; a large skill\'s contents can be many MB and one S3 read per file. | [Optional] [Defaults to `false`] |
 
 ### Return type
 
@@ -633,7 +636,7 @@ example().catch(console.error);
 
 Import Skill Handler
 
-Create a skill by importing a redistributable ZIP (works across tenants).
+Create a skill from an uploaded ZIP or tarball (works across tenants).
 
 ### Example
 

package/docs/UpdateSkillRequest.md

@@ -8,7 +8,7 @@ Edit working-copy files in place (does NOT cut a version).
 Name | Type
 ------------ | -------------
 `skillMd` | string
-`scripts` | [Array<SkillScriptFile>](SkillScriptFile.md)
+`files` | [Array<SkillFile>](SkillFile.md)
 
 ## Example
 
@@ -18,7 +18,7 @@ import type { UpdateSkillRequest } from '@knowledge-stack/ksapi'
 // TODO: Update the object below with actual values
 const example = {
   "skillMd": null,
-  "scripts": null,
+  "files": null,
 } satisfies UpdateSkillRequest
 
 console.log(example)

package/package.json

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

package/src/apis/SkillsApi.ts

@@ -87,6 +87,7 @@ export interface ExportSkillRequest {
 
 export interface GetSkillRequest {
     skillId: string;
+    includeFileContents?: boolean;
 }
 
 export interface ImportSkillRequest {
@@ -300,15 +301,17 @@ export interface SkillsApiInterface {
     /**
      * Creates request options for getSkill without sending the request
      * @param {string} skillId 
+     * @param {boolean} [includeFileContents] Include every bundle file\'s contents (base64 for binary). Off by default — the editor opts in; a large skill\'s contents can be many MB and one S3 read per file.
      * @throws {RequiredError}
      * @memberof SkillsApiInterface
      */
     getSkillRequestOpts(requestParameters: GetSkillRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Skill detail: SKILL.md, script contents, has_unpublished_changes, perms.
+     * Skill detail: SKILL.md, file paths (+ contents on request), perms.
      * @summary Get Skill Handler
      * @param {string} skillId 
+     * @param {boolean} [includeFileContents] Include every bundle file\&#39;s contents (base64 for binary). Off by default — the editor opts in; a large skill\&#39;s contents can be many MB and one S3 read per file.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof SkillsApiInterface
@@ -316,7 +319,7 @@ export interface SkillsApiInterface {
     getSkillRaw(requestParameters: GetSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>>;
 
     /**
-     * Skill detail: SKILL.md, script contents, has_unpublished_changes, perms.
+     * Skill detail: SKILL.md, file paths (+ contents on request), perms.
      * Get Skill Handler
      */
     getSkill(requestParameters: GetSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse>;
@@ -330,7 +333,7 @@ export interface SkillsApiInterface {
     importSkillRequestOpts(requestParameters: ImportSkillRequest): Promise<runtime.RequestOpts>;
 
     /**
-     * Create a skill by importing a redistributable ZIP (works across tenants).
+     * Create a skill from an uploaded ZIP or tarball (works across tenants).
      * @summary Import Skill Handler
      * @param {Blob} file 
      * @param {*} [options] Override http request option.
@@ -340,7 +343,7 @@ export interface SkillsApiInterface {
     importSkillRaw(requestParameters: ImportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>>;
 
     /**
-     * Create a skill by importing a redistributable ZIP (works across tenants).
+     * Create a skill from an uploaded ZIP or tarball (works across tenants).
      * Import Skill Handler
      */
     importSkill(requestParameters: ImportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse>;
@@ -902,6 +905,10 @@ export class SkillsApi extends runtime.BaseAPI implements SkillsApiInterface {
 
         const queryParameters: any = {};
 
+        if (requestParameters['includeFileContents'] != null) {
+            queryParameters['include_file_contents'] = requestParameters['includeFileContents'];
+        }
+
         const headerParameters: runtime.HTTPHeaders = {};
 
         if (this.configuration && this.configuration.accessToken) {
@@ -925,7 +932,7 @@ export class SkillsApi extends runtime.BaseAPI implements SkillsApiInterface {
     }
 
     /**
-     * Skill detail: SKILL.md, script contents, has_unpublished_changes, perms.
+     * Skill detail: SKILL.md, file paths (+ contents on request), perms.
      * Get Skill Handler
      */
     async getSkillRaw(requestParameters: GetSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>> {
@@ -936,7 +943,7 @@ export class SkillsApi extends runtime.BaseAPI implements SkillsApiInterface {
     }
 
     /**
-     * Skill detail: SKILL.md, script contents, has_unpublished_changes, perms.
+     * Skill detail: SKILL.md, file paths (+ contents on request), perms.
      * Get Skill Handler
      */
     async getSkill(requestParameters: GetSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse> {
@@ -1000,7 +1007,7 @@ export class SkillsApi extends runtime.BaseAPI implements SkillsApiInterface {
     }
 
     /**
-     * Create a skill by importing a redistributable ZIP (works across tenants).
+     * Create a skill from an uploaded ZIP or tarball (works across tenants).
      * Import Skill Handler
      */
     async importSkillRaw(requestParameters: ImportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SkillResponse>> {
@@ -1011,7 +1018,7 @@ export class SkillsApi extends runtime.BaseAPI implements SkillsApiInterface {
     }
 
     /**
-     * Create a skill by importing a redistributable ZIP (works across tenants).
+     * Create a skill from an uploaded ZIP or tarball (works across tenants).
      * Import Skill Handler
      */
     async importSkill(requestParameters: ImportSkillRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SkillResponse> {