@celonis/content-cli 1.12.0 → 1.13.1

package/commands/action-flows/action-flow/action-flow.service.js

@@ -13,7 +13,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "uuid", "adm-zip", "form-data", "fs", "./action-flow-api", "../../../core/utils/file-service", "../../../core/utils/logger", "../../../core/utils/file.constants"], factory);
+        define(["require", "exports", "uuid", "adm-zip", "form-data", "fs", "./action-flow-api", "../../../core/utils/file-service", "../../../core/utils/logger", "../../../core/utils/file.constants", "node:path"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -27,6 +27,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const file_service_1 = require("../../../core/utils/file-service");
     const logger_1 = require("../../../core/utils/logger");
     const file_constants_1 = require("../../../core/utils/file.constants");
+    const node_path_1 = require("node:path");
     class ActionFlowService {
         constructor(context) {
             this.actionFlowApi = new action_flow_api_1.ActionFlowApi(context);
@@ -43,7 +44,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                     this.attachMetadataFile(metadataFilePath, zip);
                 }
                 const fileName = "action-flows_export_" + (0, uuid_1.v4)() + ".zip";
-                zip.writeZip(fileName, () => fs.chmodSync(fileName, file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS));
+                const fullFilePath = (0, node_path_1.resolve)(process.cwd(), fileName);
+                zip.writeZip(fullFilePath, () => fs.chmodSync(fullFilePath, file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS));
                 logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + fileName);
             });
         }

package/commands/asset-registry/asset-registry-api.js

@@ -13,13 +13,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./asset-registry-error"], factory);
+        define(["require", "exports", "./asset-registry-error", "../../core/utils/path"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.AssetRegistryApi = void 0;
     const asset_registry_error_1 = require("./asset-registry-error");
+    const path_1 = require("../../core/utils/path");
     class AssetRegistryApi {
         constructor(context) {
             this.httpClient = () => context.httpClient;
@@ -27,45 +28,70 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         listTypes() {
             return __awaiter(this, void 0, void 0, function* () {
                 return this.httpClient()
-                    .get("/pacman/api/core/asset-registry/types")
+                    .get(AssetRegistryApi.endpointUrl("types"))
                     .catch((e) => (0, asset_registry_error_1.handleAssetRegistryApiError)("listing asset registry types", e));
             });
         }
         listSkills() {
             return __awaiter(this, void 0, void 0, function* () {
                 return this.httpClient()
-                    .get("/pacman/api/core/asset-registry/skills")
+                    .get(AssetRegistryApi.endpointUrl("skills"))
                     .catch((e) => (0, asset_registry_error_1.handleAssetRegistryApiError)("listing asset registry skills", e));
             });
         }
         getType(assetType) {
             return __awaiter(this, void 0, void 0, function* () {
                 return this.httpClient()
-                    .get(`/pacman/api/core/asset-registry/types/${encodeURIComponent(assetType)}`)
+                    .get(AssetRegistryApi.endpointUrl("types", encodeURIComponent(assetType)))
                     .catch((e) => (0, asset_registry_error_1.handleAssetRegistryApiError)(`getting asset type '${assetType}'`, e));
             });
         }
         getSchema(assetType) {
             return __awaiter(this, void 0, void 0, function* () {
                 return this.httpClient()
-                    .get(`/pacman/api/core/asset-registry/schemas/${encodeURIComponent(assetType)}`)
+                    .get(AssetRegistryApi.endpointUrl("schemas", encodeURIComponent(assetType)))
                     .catch((e) => (0, asset_registry_error_1.handleAssetRegistryApiError)(`getting schema for asset type '${assetType}'`, e));
             });
         }
         getExamples(assetType) {
             return __awaiter(this, void 0, void 0, function* () {
                 return this.httpClient()
-                    .get(`/pacman/api/core/asset-registry/examples/${encodeURIComponent(assetType)}`)
+                    .get(AssetRegistryApi.endpointUrl("examples", encodeURIComponent(assetType)))
                     .catch((e) => (0, asset_registry_error_1.handleAssetRegistryApiError)(`getting examples for asset type '${assetType}'`, e));
             });
         }
         validate(assetType, body) {
             return __awaiter(this, void 0, void 0, function* () {
                 return this.httpClient()
-                    .post(`/pacman/api/core/asset-registry/validate/${encodeURIComponent(assetType)}`, body)
+                    .post(AssetRegistryApi.endpointUrl("validate", encodeURIComponent(assetType)), body)
                     .catch((e) => (0, asset_registry_error_1.handleAssetRegistryApiError)(`validating asset type '${assetType}'`, e));
             });
         }
+        getSkillFile(skillPath, filePath) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const operation = filePath
+                    ? `getting skill file '${filePath}' for '${skillPath}'`
+                    : `getting SKILL.md for '${skillPath}'`;
+                const url = this.buildSkillFileUrl(skillPath, filePath);
+                return this.httpClient()
+                    .getFile(url)
+                    .catch((e) => (0, asset_registry_error_1.handleAssetRegistryApiError)(operation, e));
+            });
+        }
+        buildSkillFileUrl(skillPath, filePath) {
+            const segments = ["skills", encodePathSegments(skillPath)];
+            if (filePath) {
+                segments.push(encodePathSegments(filePath));
+            }
+            return AssetRegistryApi.endpointUrl(...segments);
+        }
+        static endpointUrl(...segments) {
+            return `${AssetRegistryApi.BASE_URL}/${segments.join("/")}`;
+        }
     }
     exports.AssetRegistryApi = AssetRegistryApi;
+    AssetRegistryApi.BASE_URL = "/pacman/api/core/asset-registry";
+    function encodePathSegments(value) {
+        return (0, path_1.trimSlashes)(value).split("/").map(encodeURIComponent).join("/");
+    }
 });

package/commands/asset-registry/asset-registry.service.js

@@ -13,7 +13,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./asset-registry-api", "../../core/utils/file-service", "../../core/utils/logger", "uuid", "fs"], factory);
+        define(["require", "exports", "./asset-registry-api", "../../core/utils/file-service", "../../core/utils/logger", "../../core/utils/path", "uuid", "node:path"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -22,8 +22,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const asset_registry_api_1 = require("./asset-registry-api");
     const file_service_1 = require("../../core/utils/file-service");
     const logger_1 = require("../../core/utils/logger");
+    const path_1 = require("../../core/utils/path");
     const uuid_1 = require("uuid");
-    const fs = require("fs");
+    const path = require("node:path");
     class AssetRegistryService {
         constructor(context) {
             this.api = new asset_registry_api_1.AssetRegistryApi(context);
@@ -48,6 +49,27 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 }
             });
         }
+        getSkillFile(opts) {
+            var _a;
+            return __awaiter(this, void 0, void 0, function* () {
+                const filename = this.resolveLocalFilename(opts.file);
+                const targetDir = (_a = opts.output) !== null && _a !== void 0 ? _a : ".";
+                const buffer = yield this.api.getSkillFile(opts.path, opts.file);
+                const absolutePath = file_service_1.fileService.writeBufferToPath(targetDir, filename, buffer);
+                logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + absolutePath);
+            });
+        }
+        resolveLocalFilename(file) {
+            if (!file) {
+                return "SKILL.md";
+            }
+            const trimmed = (0, path_1.trimSlashes)(file);
+            const base = trimmed ? path.basename(trimmed) : "";
+            if (!base) {
+                throw new logger_1.FatalError(`--file must point to a file, got '${file}'.`);
+            }
+            return base;
+        }
         listSkills(jsonResponse) {
             return __awaiter(this, void 0, void 0, function* () {
                 const response = yield this.api.listSkills();
@@ -107,7 +129,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 throw new logger_1.FatalError("Option -f is mutually exclusive with --packageKey, --nodeKey and --configuration.");
             }
             if (hasFile) {
-                return this.parseJson(fs.readFileSync(opts.file, "utf-8"), `-f ${opts.file}`);
+                return this.parseJson(file_service_1.fileService.readFile(opts.file), `-f ${opts.file}`);
             }
             if (hasNodeKey && hasConfig) {
                 throw new logger_1.FatalError("Options --nodeKey and --configuration are mutually exclusive. Use --nodeKey to validate a stored node, or --configuration to validate a configuration. For full control, use -f.");

package/commands/asset-registry/module.js

@@ -57,6 +57,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .description("List all available agent skills (name, description, path)")
                 .option("--json", "Return the response as a JSON file")
                 .action(this.listSkills);
+            skillsCommand.command("get")
+                .description("Download a skill file (defaults to SKILL.md)")
+                .requiredOption("--path <path>", "Skill path from 'skills list' (e.g. platform/<skill> or asset/<assetType>/<skill>)")
+                .option("--file <file>", "Relative path of a reference file within the skill (defaults to SKILL.md)")
+                .option("--output <output>", "Destination directory (defaults to current working directory)")
+                .action(this.getSkillFile);
         }
         listTypes(context, command, options) {
             return __awaiter(this, void 0, void 0, function* () {
@@ -95,6 +101,15 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 yield new asset_registry_service_1.AssetRegistryService(context).listSkills(!!options.json);
             });
         }
+        getSkillFile(context, command, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                yield new asset_registry_service_1.AssetRegistryService(context).getSkillFile({
+                    path: options.path,
+                    file: options.file,
+                    output: options.output,
+                });
+            });
+        }
     }
     return Module;
 });

package/commands/configuration-management/api/single-package-export-api.js

@@ -0,0 +1,38 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "../../../core/utils/logger"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.SinglePackageExportApi = void 0;
+    const logger_1 = require("../../../core/utils/logger");
+    class SinglePackageExportApi {
+        constructor(context) {
+            this.httpClient = () => context.httpClient;
+        }
+        exportPackage(packageKey) {
+            return __awaiter(this, void 0, void 0, function* () {
+                return this.httpClient()
+                    .getFile(`/pacman/api/core/staging/packages/${packageKey}/export-file`)
+                    .catch(e => {
+                    throw new logger_1.FatalError(`Problem exporting package ${packageKey}: ${e}`);
+                });
+            });
+        }
+    }
+    exports.SinglePackageExportApi = SinglePackageExportApi;
+});

package/commands/configuration-management/module.js

@@ -16,7 +16,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "../../core/command/module-handler", "./config-command.service", "./staging-package.service", "./metadata.service", "../t2tc/t2tc-command.service", "./variable-command.service", "./node.service", "./node-diff.service", "./node-dependency.service", "./package-version-command.service", "./package-validation.service", "./single-package-import.service"], factory);
+        define(["require", "exports", "../../core/command/module-handler", "./config-command.service", "./staging-package.service", "./metadata.service", "../t2tc/t2tc-command.service", "./variable-command.service", "./node.service", "./node-diff.service", "./node-dependency.service", "./package-version-command.service", "./package-validation.service", "./single-package-import.service", "./single-package-export.service"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -32,6 +32,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const package_version_command_service_1 = require("./package-version-command.service");
     const package_validation_service_1 = require("./package-validation.service");
     const single_package_import_service_1 = require("./single-package-import.service");
+    const single_package_export_service_1 = require("./single-package-export.service");
     class Module extends module_handler_1.IModule {
         register(context, configurator) {
             const configCommand = configurator.command("config")
@@ -80,16 +81,25 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             const packageCommand = configCommand.command("package")
                 .description("Commands for working with a single package.");
             packageCommand.command("import")
-                .description("Import a package from a zip file or directory. Uses the package format, which is not interchangeable with the 't2tc package export' / 't2tc package import' batch archive.")
+                .description("Import a package from a zip file, directory, or Git branch. Uses the package format, which is not interchangeable with the 't2tc package export' / 't2tc package import' batch archive.")
                 .option("-f, --file <file>", "Package zip file (relative path)")
                 .option("-d, --directory <directory>", "Package directory (relative path)")
                 .option("--overwrite", "Flag to allow overwriting an existing package with the same key")
                 .option("--json", "Return the response as a JSON file")
+                .option("--gitProfile <gitProfile>", "Git profile which you want to use for the Git operations")
+                .option("--gitBranch <gitBranch>", "Git branch from which you want to pull the package and import")
                 .action(this.importSinglePackage);
+            packageCommand.command("export")
+                .description("Export a single package's staging (draft) version to an unzipped directory (or a single zip with --zip, or to a Git branch with --gitBranch). Uses the package format, which is not interchangeable with the 't2tc package export' / 't2tc package import' batch archive.")
+                .requiredOption("--packageKey <packageKey>", "Key of the package to export")
+                .option("--zip", "Export the package as a single <packageKey>.zip file instead of an unzipped <packageKey> directory", false)
+                .option("--gitProfile <gitProfile>", "Git profile which you want to use for the Git operations")
+                .option("--gitBranch <gitBranch>", "Git branch in which you want to push the exported package")
+                .action(this.exportSinglePackage);
             packageCommand.command("validate")
                 .description("Validate package node configurations")
                 .requiredOption("--packageKey <packageKey>", "Key of the package to validate")
-                .option("--layers <layers...>", "Validation layers to run. Allowed values: SCHEMA, BUSINESS, PACKAGE_SETTINGS (can be combined, e.g. --layers SCHEMA BUSINESS PACKAGE_SETTINGS). Defaults to SCHEMA.", ["SCHEMA"])
+                .option("--layers <layers...>", "Validation layers to run. Allowed values: SCHEMA, BUSINESS, PACKAGE_SETTINGS, PIG_SEMANTICS, DATA_PIPELINES (can be combined, e.g. --layers SCHEMA BUSINESS PACKAGE_SETTINGS PIG_SEMANTICS DATA_PIPELINES). Defaults to SCHEMA.", ["SCHEMA"])
                 .option("--nodeKeys <nodeKeys...>", "Specific node keys to validate (default: all nodes)")
                 .option("--json", "Return the response as a JSON file")
                 .action(this.validatePackage);
@@ -102,7 +112,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .description("[Deprecated] Use 'config package validate' instead. Validate package node configurations.")
                 .deprecationNotice("'config validate' is deprecated and will be removed in a future release. Use 'config package validate' instead.")
                 .requiredOption("--packageKey <packageKey>", "Key of the package to validate")
-                .option("--layers <layers...>", "Validation layers to run. Allowed values: SCHEMA, BUSINESS, PACKAGE_SETTINGS (can be combined, e.g. --layers SCHEMA BUSINESS PACKAGE_SETTINGS). Defaults to SCHEMA.", ["SCHEMA"])
+                .option("--layers <layers...>", "Validation layers to run. Allowed values: SCHEMA, BUSINESS, PACKAGE_SETTINGS, PIG_SEMANTICS, DATA_PIPELINES (can be combined, e.g. --layers SCHEMA BUSINESS PACKAGE_SETTINGS PIG_SEMANTICS DATA_PIPELINES). Defaults to SCHEMA.", ["SCHEMA"])
                 .option("--nodeKeys <nodeKeys...>", "Specific node keys to validate (default: all nodes)")
                 .option("--json", "Return the response as a JSON file")
                 .action(this.validatePackage);
@@ -271,7 +281,18 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         }
         importSinglePackage(context, command, options) {
             return __awaiter(this, void 0, void 0, function* () {
-                yield new single_package_import_service_1.SinglePackageImportService(context).importPackage(options.file, options.directory, options.overwrite, options.json);
+                if (options.gitProfile && !options.gitBranch) {
+                    throw new Error("Please specify a branch using --gitBranch when using a Git profile.");
+                }
+                yield new single_package_import_service_1.SinglePackageImportService(context).importPackage(options.file, options.directory, options.overwrite, options.json, options.gitBranch);
+            });
+        }
+        exportSinglePackage(context, command, options) {
+            return __awaiter(this, void 0, void 0, function* () {
+                if (options.gitProfile && !options.gitBranch) {
+                    throw new Error("Please specify a branch using --gitBranch when using a Git profile.");
+                }
+                yield new single_package_export_service_1.SinglePackageExportService(context).exportPackage(options.packageKey, options.zip, options.gitBranch);
             });
         }
         diffPackages(context, command, options) {

package/commands/configuration-management/single-package-export.service.js

@@ -0,0 +1,64 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "node:fs", "../../core/utils/file-service", "../../core/utils/logger", "../../core/git-profile/git/git.service", "./api/single-package-export-api", "node:path"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.SinglePackageExportService = void 0;
+    const fs = require("node:fs");
+    const file_service_1 = require("../../core/utils/file-service");
+    const logger_1 = require("../../core/utils/logger");
+    const git_service_1 = require("../../core/git-profile/git/git.service");
+    const single_package_export_api_1 = require("./api/single-package-export-api");
+    const node_path_1 = require("node:path");
+    class SinglePackageExportService {
+        constructor(context) {
+            this.singlePackageExportApi = new single_package_export_api_1.SinglePackageExportApi(context);
+            this.gitService = new git_service_1.GitService(context);
+        }
+        exportPackage(packageKey, zip, gitBranch) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const packageData = yield this.singlePackageExportApi.exportPackage(packageKey);
+                if (gitBranch) {
+                    yield this.exportToGitBranch(packageData, gitBranch);
+                    return;
+                }
+                if (zip) {
+                    const fileName = `${packageKey}.zip`;
+                    file_service_1.fileService.writeBufferToFileWithGivenName(packageData, (0, node_path_1.resolve)(process.cwd(), fileName));
+                    logger_1.logger.info(file_service_1.FileService.fileDownloadedMessage + fileName);
+                    return;
+                }
+                file_service_1.fileService.extractZipBufferToDirectory(packageData, packageKey);
+                logger_1.logger.info(`Successful export. Exported directory: ${packageKey}`);
+            });
+        }
+        exportToGitBranch(packageData, gitBranch) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const extractedDirectory = file_service_1.fileService.extractZipBufferToTempDirectory(packageData);
+                try {
+                    yield this.gitService.pushToBranch(extractedDirectory, gitBranch);
+                    logger_1.logger.info("Successfully exported package to branch: " + gitBranch);
+                }
+                finally {
+                    fs.rmSync(extractedDirectory, { recursive: true, force: true });
+                }
+            });
+        }
+    }
+    exports.SinglePackageExportService = SinglePackageExportService;
+});

package/commands/configuration-management/single-package-import.service.js

@@ -13,7 +13,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "uuid", "form-data", "node:stream", "adm-zip", "node:fs", "../../core/utils/file-service", "../../core/utils/logger", "./api/single-package-import-api"], factory);
+        define(["require", "exports", "uuid", "form-data", "node:stream", "adm-zip", "node:fs", "../../core/utils/file-service", "../../core/utils/logger", "../../core/git-profile/git/git.service", "./api/single-package-import-api"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -26,23 +26,46 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const fs = require("node:fs");
     const file_service_1 = require("../../core/utils/file-service");
     const logger_1 = require("../../core/utils/logger");
+    const git_service_1 = require("../../core/git-profile/git/git.service");
     const single_package_import_api_1 = require("./api/single-package-import-api");
     class SinglePackageImportService {
         constructor(context) {
             this.singlePackageImportApi = new single_package_import_api_1.SinglePackageImportApi(context);
+            this.gitService = new git_service_1.GitService(context);
         }
-        importPackage(file, directory, overwrite, jsonResponse) {
+        importPackage(file, directory, overwrite, jsonResponse, gitBranch) {
             return __awaiter(this, void 0, void 0, function* () {
-                const resolvedSource = this.resolveSource(file, directory);
+                if ((file || directory) && gitBranch) {
+                    throw new Error("You cannot use --file or --directory together with --gitBranch. Only one import source can be defined.");
+                }
+                if (!file && !directory && !gitBranch) {
+                    throw new Error("You must provide a --file, a --directory, or a --gitBranch option to import a package.");
+                }
+                let gitTempDir;
                 try {
-                    const packageZip = new AdmZip(resolvedSource.zipPath);
-                    const formData = this.buildBodyForImport(packageZip, resolvedSource.zipPath);
-                    const result = yield this.singlePackageImportApi.importPackage(formData, overwrite);
-                    this.outputResult(result, jsonResponse);
+                    let resolvedSource;
+                    if (gitBranch) {
+                        gitTempDir = yield this.gitService.pullFromBranch(gitBranch);
+                        resolvedSource = { zipPath: file_service_1.fileService.zipDirectoryAsSinglePackage(gitTempDir), isTemporary: true };
+                    }
+                    else {
+                        resolvedSource = this.resolveSource(file, directory);
+                    }
+                    try {
+                        const packageZip = new AdmZip(resolvedSource.zipPath);
+                        const formData = this.buildBodyForImport(packageZip, resolvedSource.zipPath);
+                        const result = yield this.singlePackageImportApi.importPackage(formData, overwrite);
+                        this.outputResult(result, jsonResponse);
+                    }
+                    finally {
+                        if (resolvedSource.isTemporary) {
+                            fs.rmSync(resolvedSource.zipPath);
+                        }
+                    }
                 }
                 finally {
-                    if (resolvedSource.isTemporary) {
-                        fs.rmSync(resolvedSource.zipPath);
+                    if (gitTempDir) {
+                        fs.rmSync(gitTempDir, { recursive: true, force: true });
                     }
                 }
             });
@@ -51,9 +74,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             if (file && directory) {
                 throw new Error("You cannot use both --file and --directory options at the same time. Only one import source can be defined.");
             }
-            if (!file && !directory) {
-                throw new Error("You must provide either a --file or a --directory option to import a package.");
-            }
             if (file) {
                 if (file_service_1.fileService.isDirectory(file)) {
                     throw new Error("The --file option accepts only zip files.");

package/commands/configuration-management/variable.service.js

@@ -84,25 +84,23 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         }
         getVersionedVariablesByKeyVersionPairs(keysByVersion, keysByVersionFile) {
             return __awaiter(this, void 0, void 0, function* () {
-                const variablesExportRequest = yield this.buildKeyVersionPairs(keysByVersion, keysByVersionFile);
+                const variablesExportRequest = this.buildKeyVersionPairs(keysByVersion, keysByVersionFile);
                 const variableManifests = yield this.variableApi.findVariablesWithValuesByPackageKeysAndVersion(variablesExportRequest);
                 return (0, connection_variable_helper_1.fixConnectionVariables)(variableManifests);
             });
         }
         buildKeyVersionPairs(keysByVersion, keysByVersionFile) {
-            return __awaiter(this, void 0, void 0, function* () {
-                let variablesExportRequest = [];
-                if (keysByVersion.length !== 0) {
-                    variablesExportRequest = this.buildKeyAndVersionPairsFromArrayInput(keysByVersion);
-                }
-                else if (keysByVersion.length === 0 && keysByVersionFile !== "") {
-                    variablesExportRequest = yield file_service_1.fileService.readFileToJson(keysByVersionFile);
-                }
-                else {
-                    throw new logger_1.FatalError("Please provide keysByVersion mappings or file path!");
-                }
-                return variablesExportRequest;
-            });
+            let variablesExportRequest = [];
+            if (keysByVersion.length !== 0) {
+                variablesExportRequest = this.buildKeyAndVersionPairsFromArrayInput(keysByVersion);
+            }
+            else if (keysByVersion.length === 0 && keysByVersionFile !== "") {
+                variablesExportRequest = file_service_1.fileService.readFileToJson(keysByVersionFile);
+            }
+            else {
+                throw new logger_1.FatalError("Please provide keysByVersion mappings or file path!");
+            }
+            return variablesExportRequest;
         }
         buildKeyAndVersionPairsFromArrayInput(keysByVersion) {
             return keysByVersion.map(keyAndVersion => {

package/commands/studio/manager/package.manager.js

@@ -93,7 +93,7 @@
         validateOptions() {
             if (this.newKey && this.overwrite) {
                 logger_1.logger.error("You cannot overwrite a package and set a new key at the same time. Please use only one of the options.");
-                process.exit();
+                process.exit(1);
             }
         }
         getPushUrlWithParams(pushUrl) {

package/commands/studio/module.js

@@ -29,7 +29,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         register(context, configurator) {
             const listCommand = configurator.command("list");
             listCommand.command("packages")
-                .description("Command to list all packages")
+                .description("[Deprecated] Use 'config package list' instead. Command to list all packages")
+                .deprecationNotice("'list packages' is deprecated and will be removed in a future release. Use 'config package list' instead.")
                 .option("--json", "Return response as json type", "")
                 .option("--includeDependencies", "Include variables and dependencies", "")
                 .option("--packageKeys <packageKeys...>", "Lists only given package keys")
@@ -49,7 +50,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .requiredOption("--key <key>", "Key of asset you want to pull")
                 .action(this.pullAsset);
             pullCommand.command("package")
-                .description("Command to pull a package")
+                .description("[Deprecated] Use 'config package export' instead. Command to pull a package")
+                .deprecationNotice("'pull package' is deprecated and will be removed in a future release. Use 'config package export' instead.")
                 .requiredOption("--key <key>", "Key of the package you want to pull")
                 .option("--store", "Pull package with store deployment metadata")
                 .option("--newKey <newKey>", "Define a new key for your package")
@@ -66,14 +68,16 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .requiredOption("--package <packageKey>", "Key of the package you want to push assets to")
                 .action(this.pushAssets);
             pushCommand.command("package")
-                .description("Command to push a package to Studio")
+                .description("[Deprecated] Use 'config package import' instead. Command to push a package to Studio")
+                .deprecationNotice("'push package' is deprecated and will be removed in a future release. Use 'config package import' instead.")
                 .option("--newKey <newKey>", "Define a new key for your package")
                 .option("--overwrite", "Overwrite package and its assets")
                 .requiredOption("-f, --file <file>", "The file you want to push")
                 .requiredOption("--spaceKey <spaceKey>", "The key of the destination space")
                 .action(this.pushPackage);
             pushCommand.command("packages")
-                .description("Command to push packages to Studio")
+                .description("[Deprecated] Use 'config package import' (single package) instead. Command to push packages to Studio")
+                .deprecationNotice("'push packages' is deprecated and will be removed in a future release. Use 'config package import' (single package) instead.")
                 .requiredOption("--spaceKey <spaceKey>", "The key of the destination space")
                 .action(this.pushPackages);
             pushCommand.command("widget")

package/commands/t2tc/module.js

@@ -38,7 +38,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 .option("--staging", "List staging packages instead", false)
                 .action(this.listPackages);
             t2tcPackageCommand.command("export")
-                .description("Export one or more packages into a Team-to-Team Copy archive. The archive is consumed by 't2tc package import' / 't2tc package diff'.")
+                .description("Export one or more packages into a Team-to-Team Copy archive. The archive is consumed by 't2tc package import' / 't2tc package diff'. To export a single standalone package, use 'config package export'.")
                 .option("--packageKeys <packageKeys...>", "Keys of packages to export. Exports the latest deployed version only")
                 .option("--keysByVersion <keysByVersion...>", "Keys of packages to export by version")
                 .option("--withDependencies", "Include variables and dependencies", "")

package/commands/t2tc/t2tc-package.service.js

@@ -13,7 +13,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "uuid", "form-data", "stream", "adm-zip", "./batch-export-import.constants", "../../core/utils/file-service", "../../core/utils/logger", "../../core/utils/json", "../studio/api/package-api", "./api/t2tc-package-api", "../configuration-management/api/variable-api", "../configuration-management/connection-variable.helper", "./studio.service", "../../core/git-profile/git/git.service", "fs", "../../core/utils/file.constants"], factory);
+        define(["require", "exports", "uuid", "form-data", "stream", "adm-zip", "./batch-export-import.constants", "../../core/utils/file-service", "../../core/utils/logger", "../../core/utils/json", "../studio/api/package-api", "./api/t2tc-package-api", "../configuration-management/api/variable-api", "../configuration-management/connection-variable.helper", "./studio.service", "../../core/git-profile/git/git.service", "fs", "../../core/utils/file.constants", "node:path"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -35,6 +35,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     const git_service_1 = require("../../core/git-profile/git/git.service");
     const fs = require("fs");
     const file_constants_1 = require("../../core/utils/file.constants");
+    const node_path_1 = require("node:path");
     class T2tcPackageService {
         constructor(context) {
             this.t2tcPackageApi = new t2tc_package_api_1.T2tcPackageApi(context);
@@ -138,7 +139,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 const postPackageImportData = yield this.t2tcPackageApi.importPackages(formData, overwrite, performValidation);
                 yield this.studioService.processImportedPackages(configs, existingStudioPackages, studioManifests);
                 if (gitBranch) {
-                    fs.rmSync(temporaryGitFolder, { recursive: true });
+                    fs.rmSync(temporaryGitFolder, { recursive: true, force: true });
                 }
                 fs.rmSync(sourceToBeImported);
                 const reportFileName = "config_import_report_" + (0, uuid_1.v4)() + ".json";
@@ -229,7 +230,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             else {
                 const fileDownloadedMessage = "File downloaded successfully. New filename: ";
                 const filename = `export_${(0, uuid_1.v4)()}.zip`;
-                exportedZip.writeZip(filename, () => fs.chmodSync(filename, file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS));
+                const fullFilePath = (0, node_path_1.resolve)(process.cwd(), filename);
+                exportedZip.writeZip(fullFilePath, () => fs.chmodSync(fullFilePath, file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS));
                 logger_1.logger.info(fileDownloadedMessage + filename);
             }
         }

package/content-cli.js

@@ -19,6 +19,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
+    exports.createProgram = void 0;
     const semverSatisfies = require("semver/functions/satisfies");
     const commander_1 = require("commander");
     const module_handler_1 = require("./core/command/module-handler");
@@ -31,61 +32,86 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
      *
      * This is the main entry point for the CLI.
      */
-    // Check if the Node.js version satisfies the minimum requirements
     const requiredVersion = ">=10.10.0";
-    if (!semverSatisfies(process.version, requiredVersion)) {
-        logger_1.logger.error(`Node version ${process.version} not supported. Please upgrade your node version to ${requiredVersion}`);
-        process.exit(1);
-    }
-    // Global configuration options
-    const program = new commander_1.Command();
-    program.configureHelp({
-        formatHelp: (cmd, helper) => new CustomHelp_1.ContentCLIHelp().formatHelp(cmd, helper),
-        subcommandTerm: cmd => new CustomHelp_1.ContentCLIHelp().subcommandTerm(cmd),
-        optionTerm: opt => new CustomHelp_1.ContentCLIHelp().optionTerm(opt),
-    });
-    program.version(version_1.VersionUtils.getCurrentCliVersion());
-    program.option("-q, --quietmode", "Reduce output to a minimum", false);
-    program.option("-p, --profile [profile]");
-    program.option("--gitProfile [gitProfile]", "Git profile to use");
-    program.option("--debug", "Print debug messages", false);
-    program.option("--dev", "Development Mode", false);
-    program.parseOptions(process.argv);
-    if (!program.opts().quietmode) {
-        console.log(`Content CLI - (C) Copyright 2025 - Celonis SE - Version ${version_1.VersionUtils.getCurrentCliVersion()}`);
-        console.log();
+    function addDefaultOptions(program) {
+        program.option("-q, --quietmode", "Reduce output to a minimum", false);
+        program.option("-p, --profile [profile]");
+        program.option("--gitProfile [gitProfile]", "Git profile to use");
+        program.option("--debug", "Print debug messages", false);
+        program.option("--dev", "Development Mode", false);
     }
-    if (program.opts().debug) {
-        logger_1.logger.transports.forEach(t => {
-            t.level = "debug";
+    /**
+     * Build a fully-configured Commander program without parsing argv
+     */
+    function createProgram(context, opts = {}) {
+        var _a;
+        const program = new commander_1.Command();
+        program.configureHelp({
+            formatHelp: (cmd, helper) => new CustomHelp_1.ContentCLIHelp().formatHelp(cmd, helper),
+            subcommandTerm: cmd => new CustomHelp_1.ContentCLIHelp().subcommandTerm(cmd),
+            optionTerm: opt => new CustomHelp_1.ContentCLIHelp().optionTerm(opt),
         });
+        program.version(version_1.VersionUtils.getCurrentCliVersion());
+        addDefaultOptions(program);
+        const moduleHandler = new module_handler_1.ModuleHandler(program, context);
+        configureRootCommands(moduleHandler.configurator);
+        if (opts.modules) {
+            for (const moduleClass of opts.modules) {
+                const moduleInstance = new moduleClass();
+                moduleInstance.register(context, moduleHandler.configurator);
+            }
+        }
+        else {
+            const rootPath = __dirname;
+            const devMode = (_a = opts.devMode) !== null && _a !== void 0 ? _a : !!program.opts().dev;
+            moduleHandler.discoverAndRegisterModules(rootPath, devMode);
+        }
+        return program;
     }
+    exports.createProgram = createProgram;
     /**
      * To support the legacy command structure, we have to configure some root commands
      * that the individual modules will extend.
      */
     function configureRootCommands(configurator) {
-        configurator.command("list")
-            .description("Commands to list content.")
-            .alias("ls");
+        configurator.command("list").description("Commands to list content.").alias("ls");
     }
     function run() {
         return __awaiter(this, void 0, void 0, function* () {
-            const context = new cli_context_1.Context(program.opts());
+            if (!semverSatisfies(process.version, requiredVersion)) {
+                logger_1.logger.error(`Node version ${process.version} not supported. Please upgrade your node version to ${requiredVersion}`);
+                process.exit(1);
+            }
+            // Parse global options up-front so banner/debug-level decisions can use
+            // them before module discovery runs.
+            const bootstrapProgram = new commander_1.Command();
+            addDefaultOptions(bootstrapProgram);
+            bootstrapProgram.allowUnknownOption(true);
+            bootstrapProgram.parseOptions(process.argv);
+            const globalOpts = bootstrapProgram.opts();
+            if (!globalOpts.quietmode) {
+                console.log(`Content CLI - (C) Copyright 2025 - Celonis SE - Version ${version_1.VersionUtils.getCurrentCliVersion()}`);
+                console.log();
+            }
+            if (globalOpts.debug) {
+                logger_1.logger.transports.forEach(t => {
+                    t.level = "debug";
+                });
+            }
+            const context = new cli_context_1.Context(globalOpts);
             yield context.init();
-            const moduleHandler = new module_handler_1.ModuleHandler(program, context);
-            configureRootCommands(moduleHandler.configurator);
-            moduleHandler.discoverAndRegisterModules(__dirname, program.opts().dev);
+            const program = createProgram(context, { devMode: !!globalOpts.dev });
             try {
-                program.parse(process.argv);
+                yield program.parseAsync(process.argv);
             }
             catch (error) {
                 logger_1.logger.error(`An unexpected error occurred: ${error}`);
             }
         });
     }
-    run();
-    // catch uncaught exceptions
+    if (require.main === module) {
+        run();
+    }
     process.on("uncaughtException", (error, origin) => {
         console.error("\n💥 UNCAUGHT EXCEPTION!\n");
         console.error("Error:", error);

package/core/command/module-handler.js

@@ -200,7 +200,12 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                     yield handler(this.ctx, this.cmd, this.cmd.optsWithGlobals());
                 }
                 catch (error) {
+                    if (error instanceof logger_1.GracefulError) {
+                        logger_1.logger.error(error.message);
+                        return;
+                    }
                     logger_1.logger.error(`An unexpected error occured executing a command: ${error}`);
+                    process.exitCode = 1;
                 }
             }));
         }

package/core/utils/file-service.js

@@ -1,12 +1,3 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 (function (factory) {
     if (typeof module === "object" && typeof module.exports === "object") {
         var v = factory(require, exports);
@@ -33,12 +24,35 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 mode: file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS,
             });
         }
-        readFileToJson(fileName) {
-            return __awaiter(this, void 0, void 0, function* () {
-                const fileContent = this.readFile(fileName);
-                return JSON.parse(fileContent);
+        writeBufferToFileWithGivenName(data, filename) {
+            fs.writeFileSync(path.resolve(process.cwd(), filename), data, {
+                mode: file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS,
             });
         }
+        writeBufferToPath(targetDir, filename, data) {
+            const resolvedDir = path.resolve(process.cwd(), targetDir);
+            const absolutePath = path.join(resolvedDir, filename);
+            this.mkdirRecursive(resolvedDir);
+            this.writeBufferToFileWithGivenName(data, absolutePath);
+            return absolutePath;
+        }
+        extractZipBufferToDirectory(data, targetDir) {
+            const targetPath = path.resolve(process.cwd(), targetDir);
+            this.mkdirRecursive(targetPath);
+            new AdmZip(data).extractAllTo(targetPath, true, true);
+            this.restrictFilePermissions(targetPath);
+        }
+        extractZipBufferToTempDirectory(data) {
+            const tempDir = path.join(os.tmpdir(), `content-cli-${(0, uuid_1.v4)()}`);
+            this.mkdirRecursive(tempDir);
+            new AdmZip(data).extractAllTo(tempDir, true, true);
+            this.restrictFilePermissions(tempDir);
+            return tempDir;
+        }
+        readFileToJson(fileName) {
+            const fileContent = this.readFile(fileName);
+            return JSON.parse(fileContent);
+        }
         readFile(filename) {
             if (!fs.existsSync(path.resolve(process.cwd(), filename))) {
                 logger_1.logger.error(new logger_1.FatalError(`The provided file '${filename}' does not exit`));
@@ -50,7 +64,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             return this.extractExportedZipWithNestedZipsToDir(zipFile, tempDir);
         }
         extractExportedZipWithNestedZipsToDir(zipFile, targetDir) {
-            fs.mkdirSync(targetDir, { recursive: true, mode: file_constants_1.FileConstants.DEFAULT_FOLDER_PERMISSIONS });
+            this.mkdirRecursive(targetDir);
             zipFile.extractAllTo(targetDir, true, true);
             const files = fs.readdirSync(targetDir);
             for (const file of files) {
@@ -58,7 +72,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 if (file.endsWith(".zip")) {
                     const nestedZip = new AdmZip(innerZipPath);
                     const nestedDir = innerZipPath.replace(/\.zip$/, "");
-                    fs.mkdirSync(nestedDir, { recursive: true, mode: file_constants_1.FileConstants.DEFAULT_FOLDER_PERMISSIONS });
+                    this.mkdirRecursive(nestedDir);
                     nestedZip.extractAllTo(nestedDir, true, true);
                     fs.rmSync(innerZipPath); // Optionally remove the inner zip
                 }
@@ -90,7 +104,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
                 }
             });
             const tempDir = path.join(os.tmpdir(), "content-cli-exports");
-            fs.mkdirSync(tempDir, { recursive: true, mode: file_constants_1.FileConstants.DEFAULT_FOLDER_PERMISSIONS });
+            this.mkdirRecursive(tempDir);
             const zipFilePath = path.join(tempDir, `export_${(0, uuid_1.v4)()}.zip`);
             finalZip.writeZip(zipFilePath, () => fs.chmodSync(zipFilePath, file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS));
             return zipFilePath;
@@ -102,7 +116,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
             const zip = new AdmZip();
             zip.addLocalFolder(sourceDir);
             const tempDir = path.join(os.tmpdir(), "content-cli-imports");
-            fs.mkdirSync(tempDir, { recursive: true, mode: file_constants_1.FileConstants.DEFAULT_FOLDER_PERMISSIONS });
+            this.mkdirRecursive(tempDir);
             const zipFilePath = path.join(tempDir, `single_package_${(0, uuid_1.v4)()}.zip`);
             zip.writeZip(zipFilePath, () => fs.chmodSync(zipFilePath, file_constants_1.FileConstants.DEFAULT_FILE_PERMISSIONS));
             return zipFilePath;
@@ -110,6 +124,9 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         getSerializedFileContent(data) {
             return data;
         }
+        mkdirRecursive(dir) {
+            fs.mkdirSync(dir, { recursive: true, mode: file_constants_1.FileConstants.DEFAULT_FOLDER_PERMISSIONS });
+        }
         restrictFilePermissions(targetDir) {
             var _a;
             const files = fs.readdirSync(targetDir);

package/core/utils/path.js

@@ -0,0 +1,17 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.trimSlashes = void 0;
+    function trimSlashes(value) {
+        return value.replace(/^\/+/, "").replace(/\/+$/, "");
+    }
+    exports.trimSlashes = trimSlashes;
+});

package/lib/commands/asset-registry/asset-registry-api.d.ts

@@ -1,6 +1,8 @@
+/// <reference types="node" />
 import { Context } from "../../core/command/cli-context";
 import { AgentSkillsResponse, AssetRegistryDescriptor, AssetRegistryMetadata } from "./asset-registry.interfaces";
 export declare class AssetRegistryApi {
+    private static readonly BASE_URL;
     private httpClient;
     constructor(context: Context);
     listTypes(): Promise<AssetRegistryMetadata>;
@@ -9,4 +11,7 @@ export declare class AssetRegistryApi {
     getSchema(assetType: string): Promise<any>;
     getExamples(assetType: string): Promise<any>;
     validate(assetType: string, body: any): Promise<any>;
+    getSkillFile(skillPath: string, filePath?: string): Promise<Buffer>;
+    private buildSkillFileUrl;
+    private static endpointUrl;
 }

package/lib/commands/asset-registry/asset-registry.interfaces.d.ts

@@ -48,3 +48,8 @@ export interface AgentSkill {
 export interface AgentSkillsResponse {
     skills: AgentSkill[];
 }
+export interface GetSkillFileOptions {
+    path: string;
+    file?: string;
+    output?: string;
+}

package/lib/commands/asset-registry/asset-registry.service.d.ts

@@ -1,9 +1,11 @@
-import { ValidateOptions } from "./asset-registry.interfaces";
+import { GetSkillFileOptions, ValidateOptions } from "./asset-registry.interfaces";
 import { Context } from "../../core/command/cli-context";
 export declare class AssetRegistryService {
     private api;
     constructor(context: Context);
     listTypes(jsonResponse: boolean): Promise<void>;
+    getSkillFile(opts: GetSkillFileOptions): Promise<void>;
+    private resolveLocalFilename;
     listSkills(jsonResponse: boolean): Promise<void>;
     getType(assetType: string, jsonResponse: boolean): Promise<void>;
     getSchema(assetType: string, jsonResponse: boolean): Promise<void>;

package/lib/commands/asset-registry/module.d.ts

@@ -8,5 +8,6 @@ declare class Module extends IModule {
     private validate;
     private getExamples;
     private listSkills;
+    private getSkillFile;
 }
 export = Module;

package/lib/commands/configuration-management/api/single-package-export-api.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="node" />
+import { Context } from "../../../core/command/cli-context";
+export declare class SinglePackageExportApi {
+    private readonly httpClient;
+    constructor(context: Context);
+    exportPackage(packageKey: string): Promise<Buffer>;
+}

package/lib/commands/configuration-management/module.d.ts

@@ -13,6 +13,7 @@ declare class Module extends IModule {
     private createPackageVersion;
     private batchImportPackages;
     private importSinglePackage;
+    private exportSinglePackage;
     private diffPackages;
     private validatePackage;
     private listVariables;

package/lib/commands/configuration-management/single-package-export.service.d.ts

@@ -0,0 +1,8 @@
+import { Context } from "../../core/command/cli-context";
+export declare class SinglePackageExportService {
+    private readonly singlePackageExportApi;
+    private readonly gitService;
+    constructor(context: Context);
+    exportPackage(packageKey: string, zip: boolean, gitBranch: string): Promise<void>;
+    private exportToGitBranch;
+}

package/lib/commands/configuration-management/single-package-import.service.d.ts

@@ -2,8 +2,9 @@ import { Context } from "../../core/command/cli-context";
 export declare class SinglePackageImportService {
     private static readonly MAX_UNCOMPRESSED_ZIP_SIZE;
     private readonly singlePackageImportApi;
+    private readonly gitService;
     constructor(context: Context);
-    importPackage(file: string, directory: string, overwrite: boolean, jsonResponse: boolean): Promise<void>;
+    importPackage(file: string, directory: string, overwrite: boolean, jsonResponse: boolean, gitBranch: string): Promise<void>;
     private resolveSource;
     private buildBodyForImport;
     private assertUncompressedSizeWithinLimit;

package/lib/content-cli.d.ts

@@ -1,2 +1,16 @@
 #!/usr/bin/env node
-export {};
+import { Command } from "commander";
+import { IModuleConstructor } from "./core/command/module-handler";
+import { Context } from "./core/command/cli-context";
+export interface CreateProgramOptions {
+    /**
+     * Explicit list of module classes to register. When provided, the factory
+     * skips automatic, filesystem-based module discovery.
+     */
+    modules?: IModuleConstructor[];
+    devMode?: boolean;
+}
+/**
+ * Build a fully-configured Commander program without parsing argv
+ */
+export declare function createProgram(context: Context, opts?: CreateProgramOptions): Command;

package/lib/core/utils/file-service.d.ts

@@ -1,8 +1,13 @@
+/// <reference types="node" />
 import AdmZip = require("adm-zip");
 export declare class FileService {
     static readonly fileDownloadedMessage = "File downloaded successfully. New filename: ";
     writeToFileWithGivenName(data: any, filename: string): void;
-    readFileToJson<T>(fileName: string): Promise<T>;
+    writeBufferToFileWithGivenName(data: Buffer, filename: string): void;
+    writeBufferToPath(targetDir: string, filename: string, data: Buffer): string;
+    extractZipBufferToDirectory(data: Buffer, targetDir: string): void;
+    extractZipBufferToTempDirectory(data: Buffer): string;
+    readFileToJson(fileName: string): any;
     readFile(filename: string): string;
     extractExportedZipWithNestedZips(zipFile: AdmZip): string;
     extractExportedZipWithNestedZipsToDir(zipFile: AdmZip, targetDir: string): string;
@@ -10,6 +15,7 @@ export declare class FileService {
     zipDirectoryInBatchExportFormat(sourceDir: string): string;
     zipDirectoryAsSinglePackage(sourceDir: string): string;
     private getSerializedFileContent;
+    private mkdirRecursive;
     private restrictFilePermissions;
 }
 export declare const fileService: FileService;

package/lib/core/utils/path.d.ts

@@ -0,0 +1 @@
+export declare function trimSlashes(value: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celonis/content-cli",
-  "version": "1.12.0",
+  "version": "1.13.1",
   "description": "CLI Tool to help manage content in Celonis Platform",
   "main": "content-cli.js",
   "bin": {
@@ -21,14 +21,14 @@
     "adm-zip": "0.5.14",
     "chalk": "4.1.2",
     "uuid": "9.0.1",
-    "axios": "1.13.5",
+    "axios": "1.16.0",
     "commander": "13.1.0",
-    "form-data": "4.0.4",
+    "form-data": "4.0.6",
     "openid-client": "5.6.1",
     "hpagent": "1.2.0",
     "@github/keytar": "7.10.6",
     "semver": "7.6.3",
-    "simple-git": "3.32.3",
+    "simple-git": "3.36.0",
     "valid-url": "1.0.9",
     "winston": "3.17.0",
     "yaml": "2.8.3"