@botpress/adk-cli 1.13.0 → 1.13.1

package/dist/cli.js

@@ -347541,7 +347541,7 @@ var init_internal = __esm(() => {
   });
   init_define_PACKAGE_VERSIONS = __esm2({
     "<define:__PACKAGE_VERSIONS__>"() {
-      define_PACKAGE_VERSIONS_default = { runtime: "1.13.0", adk: "1.13.0", sdk: "5.0.2", llmz: "0.0.35", zai: "2.5.5", cognitive: "0.3.3" };
+      define_PACKAGE_VERSIONS_default = { runtime: "1.13.1", adk: "1.13.1", sdk: "5.0.2", llmz: "0.0.35", zai: "2.5.5", cognitive: "0.3.3" };
     }
   });
   init_asset = __esm2({
@@ -380558,18 +380558,31 @@ yield <Message>
       init_define_BUILD();
       init_define_PACKAGE_VERSIONS();
       init_runtime2();
-      BaseConversationInstance = class {
+      BaseConversationInstance = class _BaseConversationInstance {
         id;
         channel;
         integration;
+        alias;
         conversation;
         client;
         TrackedState;
         TrackedTags;
-        constructor(conversation2, client2) {
+        static extractAliasFromTags(tags) {
+          if (!tags)
+            return;
+          for (const tagKey of Object.keys(tags)) {
+            const colonIndex = tagKey.indexOf(":");
+            if (colonIndex > 0) {
+              return tagKey.substring(0, colonIndex);
+            }
+          }
+          return;
+        }
+        constructor(conversation2, client2, alias) {
           this.id = conversation2.id;
-          this.channel = `${conversation2.integration}.${conversation2.channel}`;
           this.integration = conversation2.integration;
+          this.alias = alias ?? _BaseConversationInstance.extractAliasFromTags(conversation2.tags) ?? conversation2.integration;
+          this.channel = `${this.alias}.${conversation2.channel}`;
           this.conversation = conversation2;
           this.client = client2;
           const states = context.get("states", { optional: true });
@@ -654257,7 +654270,7 @@ var init_library2 = __esm(() => {
   });
   init_define_PACKAGE_VERSIONS2 = __esm4({
     "<define:__PACKAGE_VERSIONS__>"() {
-      define_PACKAGE_VERSIONS_default2 = { runtime: "1.13.0", adk: "1.13.0", sdk: "5.0.2", llmz: "0.0.35", zai: "2.5.5", cognitive: "0.3.3" };
+      define_PACKAGE_VERSIONS_default2 = { runtime: "1.13.1", adk: "1.13.1", sdk: "5.0.2", llmz: "0.0.35", zai: "2.5.5", cognitive: "0.3.3" };
     }
   });
   init_assets2 = __esm4({
@@ -687879,18 +687892,31 @@ yield <Message>
       init_define_BUILD2();
       init_define_PACKAGE_VERSIONS2();
       init_runtime22();
-      BaseConversationInstance2 = class {
+      BaseConversationInstance2 = class _BaseConversationInstance {
         id;
         channel;
         integration;
+        alias;
         conversation;
         client;
         TrackedState;
         TrackedTags;
-        constructor(conversation2, client2) {
+        static extractAliasFromTags(tags) {
+          if (!tags)
+            return;
+          for (const tagKey of Object.keys(tags)) {
+            const colonIndex = tagKey.indexOf(":");
+            if (colonIndex > 0) {
+              return tagKey.substring(0, colonIndex);
+            }
+          }
+          return;
+        }
+        constructor(conversation2, client2, alias) {
           this.id = conversation2.id;
-          this.channel = `${conversation2.integration}.${conversation2.channel}`;
           this.integration = conversation2.integration;
+          this.alias = alias ?? _BaseConversationInstance.extractAliasFromTags(conversation2.tags) ?? conversation2.integration;
+          this.channel = `${this.alias}.${conversation2.channel}`;
           this.conversation = conversation2;
           this.client = client2;
           const states = context3.get("states", { optional: true });
@@ -696254,6 +696280,17 @@ class ValidationErrors {
       context: { integration, version: version3 }
     };
   }
+  static invalidIntegrationAlias(alias) {
+    return {
+      $type: ValidationErrors.$type,
+      code: "INVALID_INTEGRATION_ALIAS",
+      severity: "error",
+      message: `Invalid integration alias '${alias}'`,
+      file: "agent.config.ts",
+      hint: 'Integration aliases must be 2-100 characters and contain only lowercase letters, numbers, underscores, and hyphens (e.g., "slack", "my-slack", "slack_prod")',
+      context: { alias }
+    };
+  }
   static unknownIntegration(integration, source, detailedMessage) {
     return {
       $type: ValidationErrors.$type,
@@ -697829,6 +697866,9 @@ class EnhancedIntegrationCache {
     return key.replace(/[^a-zA-Z0-9_-]/g, "_");
   }
 }
+function isIntegrationAliasValid(alias) {
+  return alias.length >= INTEGRATION_ALIAS_MIN_LENGTH && alias.length <= INTEGRATION_ALIAS_MAX_LENGTH && INTEGRATION_ALIAS_REGEX.test(alias);
+}
 
 class IntegrationParser {
   static parseIntegrationRef(versionString) {
@@ -697846,6 +697886,10 @@ class IntegrationParser {
     }
     for (const [alias, value2] of Object.entries(dependencies.integrations)) {
       try {
+        if (!isIntegrationAliasValid(alias)) {
+          errors.push(ValidationErrors.invalidIntegrationAlias(alias));
+          continue;
+        }
         const ref = this.parseIntegrationRef(value2.version);
         const versionResult = versionSchema.safeParse(ref.version);
         if (!versionResult.success) {
@@ -697869,13 +697913,30 @@ class IntegrationParser {
     const seen = new Map;
     for (const integration of integrations) {
       const key = integration.ref.fullName;
-      const aliases = seen.get(key) || [];
-      aliases.push(integration.alias);
-      seen.set(key, aliases);
+      const group2 = seen.get(key) || [];
+      group2.push(integration);
+      seen.set(key, group2);
     }
-    for (const [integration, aliases] of seen.entries()) {
-      if (aliases.length > 1) {
-        errors.push(ValidationErrors.warning(`Integration '${integration}' is used with multiple aliases: ${aliases.join(", ")}. This is valid but ensure each has different configurations.`, "agent.config.ts"));
+    for (const [integrationName, group2] of seen.entries()) {
+      if (group2.length > 1) {
+        const duplicateConfigs = [];
+        for (let i2 = 0;i2 < group2.length; i2++) {
+          for (let j = i2 + 1;j < group2.length; j++) {
+            const configA = JSON.stringify(group2[i2].config ?? {});
+            const configB = JSON.stringify(group2[j].config ?? {});
+            if (configA === configB) {
+              if (!duplicateConfigs.includes(group2[i2].alias)) {
+                duplicateConfigs.push(group2[i2].alias);
+              }
+              if (!duplicateConfigs.includes(group2[j].alias)) {
+                duplicateConfigs.push(group2[j].alias);
+              }
+            }
+          }
+        }
+        if (duplicateConfigs.length > 0) {
+          errors.push(ValidationErrors.warning(`Integration '${integrationName}' has aliases with identical configurations: ${duplicateConfigs.join(", ")}. Consider using different configs or removing duplicates.`, "agent.config.ts"));
+        }
       }
     }
     return errors;
@@ -698617,12 +698678,17 @@ class IntegrationChecker {
       throw new Error(`Integration definition not found for ${alias}`);
     }
     let installedIntegration = null;
-    for (const [_key, installed] of Object.entries(installedIntegrations)) {
-      const matches = installed.name === ref.fullName || installed.name === ref.name;
-      if (matches) {
-        installedIntegration = installed;
-        processedIntegrationIds.add(installed.id);
-        break;
+    if (installedIntegrations[alias]) {
+      installedIntegration = installedIntegrations[alias];
+      processedIntegrationIds.add(installedIntegration.id);
+    } else {
+      for (const [_key, installed] of Object.entries(installedIntegrations)) {
+        const matches = installed.name === ref.fullName || installed.name === ref.name;
+        if (matches) {
+          installedIntegration = installed;
+          processedIntegrationIds.add(installed.id);
+          break;
+        }
       }
     }
     const desiredInstallStatus = enabled === false ? "disabled" : "enabled";
@@ -699331,7 +699397,7 @@ class AgentProjectGenerator {
         deploy: "adk deploy"
       },
       dependencies: {
-        "@botpress/runtime": "^1.13.0"
+        "@botpress/runtime": "^1.13.1"
       },
       devDependencies: {
         typescript: "^5.9.3"
@@ -703834,11 +703900,11 @@ var import_debug, import_debug2, import_ts_morph, __defProp11, __commonJS8 = (cb
 `));
     return code;
   }
-}, ADK_VERSION = "1.13.0", relative22 = (from, to3) => {
+}, ADK_VERSION = "1.13.1", relative22 = (from, to3) => {
   const fromDir = path102.dirname(from);
   const relative32 = path102.relative(fromDir, to3);
   return relative32.startsWith(".") ? relative32 : `./${relative32}`;
-}, init_utils10, exports_action_types, init_action_types, exports_integration_action_types, init_integration_action_types, require_package3, bpCliImporter, auth, debug, BP_CLI_VERSION = "5.1.1", BP_CLI_INSTALL_ALL, BP_CLI_INSTALL_DIR, BP_CLI_BIN_PATH, BpAddCommand, BpBuildCommand, BpDeployCommand, BpDevCommand, BpChatCommand, workspaceCache, agentInfoKeyOrder, dependenciesKeyOrder, integrationKeyOrder, defaultAdkFolder = ".adk", integrationRefSchema, versionSchema, HubCache, debug2, AgentProject, FileWatcher, CLAUDE_template_default = `# Botpress ADK Project Context
+}, init_utils10, exports_action_types, init_action_types, exports_integration_action_types, init_integration_action_types, require_package3, bpCliImporter, auth, debug, BP_CLI_VERSION = "5.1.1", BP_CLI_INSTALL_ALL, BP_CLI_INSTALL_DIR, BP_CLI_BIN_PATH, BpAddCommand, BpBuildCommand, BpDeployCommand, BpDevCommand, BpChatCommand, workspaceCache, agentInfoKeyOrder, dependenciesKeyOrder, integrationKeyOrder, defaultAdkFolder = ".adk", INTEGRATION_ALIAS_MIN_LENGTH = 2, INTEGRATION_ALIAS_MAX_LENGTH = 100, INTEGRATION_ALIAS_REGEX, integrationRefSchema, versionSchema, HubCache, debug2, AgentProject, FileWatcher, CLAUDE_template_default = `# Botpress ADK Project Context
 
 This project is built with the **Botpress Agent Development Kit (ADK)** - a TypeScript-first framework for building AI agents.
 
@@ -705232,6 +705298,7 @@ var init_dist17 = __esm(() => {
       ValidationErrorCode2["INVALID_DEPENDENCIES_SYNTAX"] = "INVALID_DEPENDENCIES_SYNTAX";
       ValidationErrorCode2["INVALID_DEPENDENCIES_SCHEMA"] = "INVALID_DEPENDENCIES_SCHEMA";
       ValidationErrorCode2["INVALID_VERSION_FORMAT"] = "INVALID_VERSION_FORMAT";
+      ValidationErrorCode2["INVALID_INTEGRATION_ALIAS"] = "INVALID_INTEGRATION_ALIAS";
       ValidationErrorCode2["UNKNOWN_INTEGRATION"] = "UNKNOWN_INTEGRATION";
       ValidationErrorCode2["INCOMPATIBLE_VERSION"] = "INCOMPATIBLE_VERSION";
       ValidationErrorCode2["CIRCULAR_DEPENDENCY"] = "CIRCULAR_DEPENDENCY";
@@ -705313,7 +705380,7 @@ var init_dist17 = __esm(() => {
   require_package3 = __commonJS8((exports7, module) => {
     module.exports = {
       name: "@botpress/adk",
-      version: "1.13.0",
+      version: "1.13.1",
       description: "Core ADK library for building AI agents on Botpress",
       type: "module",
       main: "dist/index.js",
@@ -705360,7 +705427,7 @@ var init_dist17 = __esm(() => {
         "@botpress/cli": "^5.1.1",
         "@botpress/client": "^1.28.0",
         "@botpress/cognitive": "^0.3.3",
-        "@botpress/runtime": "^1.13.0",
+        "@botpress/runtime": "^1.13.1",
         "@botpress/sdk": "^5.0.2",
         "@bpinternal/jex": "^1.2.4",
         "@bpinternal/yargs-extra": "^0.0.21",
@@ -705862,6 +705929,7 @@ ${this.stderrLines.join(`
   integrationKeyOrder = ["version", "enabled", "configurationType", "config"];
   init_fs();
   init_validation_errors();
+  INTEGRATION_ALIAS_REGEX = /^(?:[a-z][a-z0-9_-]*\/)?[a-z][a-z0-9_-]*$/;
   integrationRefSchema = X.string().transform((val, ctx) => {
     const match5 = val.match(/^(?:([^/]+)\/)?([^@]+)@(.+)$/);
     if (!match5) {
@@ -711961,7 +712029,7 @@ var init_Separator = __esm(async () => {
 var require_package4 = __commonJS((exports7, module) => {
   module.exports = {
     name: "@botpress/adk",
-    version: "1.13.0",
+    version: "1.13.1",
     description: "Core ADK library for building AI agents on Botpress",
     type: "module",
     main: "dist/index.js",
@@ -712008,7 +712076,7 @@ var require_package4 = __commonJS((exports7, module) => {
       "@botpress/cli": "^5.1.1",
       "@botpress/client": "^1.28.0",
       "@botpress/cognitive": "^0.3.3",
-      "@botpress/runtime": "^1.13.0",
+      "@botpress/runtime": "^1.13.1",
       "@botpress/sdk": "^5.0.2",
       "@bpinternal/jex": "^1.2.4",
       "@bpinternal/yargs-extra": "^0.0.21",
@@ -713950,7 +714018,7 @@ function checkRuntimeVersion(agentRoot) {
 `));
   }
 }
-var semver2, EXPECTED_RUNTIME_VERSION = "1.13.0", SUPPORTED_RUNTIME_RANGE = ">=1.13.0";
+var semver2, EXPECTED_RUNTIME_VERSION = "1.13.1", SUPPORTED_RUNTIME_RANGE = ">=1.13.0";
 var init_runtime_version_check = __esm(() => {
   init_source();
   semver2 = __toESM(require_semver2(), 1);
@@ -729088,7 +729156,7 @@ function getPlatformInfo() {
   }
   return { target, extension, isWindows: isWindows6 };
 }
-async function getLatestVersion() {
+async function getVersion(tagOrVersion) {
   const response = await fetch(REGISTRY_URL2, {
     headers: { Accept: "application/json" }
   });
@@ -729096,11 +729164,27 @@ async function getLatestVersion() {
     throw new Error("Failed to fetch version information from npm");
   }
   const data = await response.json();
-  const latest = data["dist-tags"]?.latest;
-  if (!latest) {
-    throw new Error("Could not determine latest version");
+  const distTags = data["dist-tags"];
+  const versions3 = Object.keys(data.versions || {});
+  if (!tagOrVersion) {
+    const latest = distTags?.latest;
+    if (!latest) {
+      throw new Error("Could not determine latest version");
+    }
+    return { version: latest, tag: "latest" };
+  }
+  if (distTags[tagOrVersion]) {
+    return { version: distTags[tagOrVersion], tag: tagOrVersion };
   }
-  return latest;
+  const normalizedVersion = tagOrVersion.replace(/^v/, "");
+  if (versions3.includes(normalizedVersion)) {
+    return { version: normalizedVersion, tag: null };
+  }
+  const availableTags = Object.keys(distTags).join(", ");
+  throw new Error(`Unknown tag or version: ${tagOrVersion}
+
+   Available tags: ${availableTags}
+   Or specify a version like: 1.13.0`);
 }
 async function downloadBinary(version3, target, extension) {
   const fileName = `adk-${target}${extension}`;
@@ -729202,16 +729286,21 @@ del "%~f0"
     }
   }
 }
-async function adkSelfUpgrade(currentVersion) {
+async function adkSelfUpgrade(currentVersion, tagOrVersion) {
   try {
+    const currentPath = getCurrentBinaryPath();
     console.log(`\uD83D\uDCE6 Current version: ${currentVersion}`);
-    const latestVersion = await getLatestVersion();
-    console.log(`\uD83D\uDCE6 Latest version: ${latestVersion}`);
-    if (currentVersion === latestVersion) {
-      console.log("\u2705 You already have the latest version!");
+    console.log(`\uD83D\uDCCD Binary path: ${currentPath}`);
+    const { version: targetVersion, tag } = await getVersion(tagOrVersion);
+    if (tag) {
+      console.log(`\uD83D\uDCE6 Target: ${tag} (v${targetVersion})`);
+    } else {
+      console.log(`\uD83D\uDCE6 Target version: ${targetVersion}`);
+    }
+    if (currentVersion === targetVersion) {
+      console.log("\u2705 You already have this version!");
       return;
     }
-    const currentPath = getCurrentBinaryPath();
     const { isWindows: isWindows6 } = getPlatformInfo();
     if (!isWindows6 && !checkWritePermissions(currentPath)) {
       console.error(`
@@ -729230,14 +729319,14 @@ async function adkSelfUpgrade(currentVersion) {
     const { target, extension } = getPlatformInfo();
     let binaryBuffer;
     if (isWindows6) {
-      binaryBuffer = await downloadBinaryWindows(latestVersion, target, extension);
+      binaryBuffer = await downloadBinaryWindows(targetVersion, target, extension);
     } else {
-      binaryBuffer = await downloadBinary(latestVersion, target, extension);
+      binaryBuffer = await downloadBinary(targetVersion, target, extension);
     }
     replaceBinary(binaryBuffer, isWindows6);
     if (!isWindows6) {
       console.log(`
-   v${currentVersion} \u2192 v${latestVersion}`);
+   v${currentVersion} \u2192 v${targetVersion}`);
       console.log(`
    Run \x1B[36madk --version\x1B[0m to verify`);
     }
@@ -890825,7 +890914,7 @@ if (!checkNodeVersion(true)) {
   checkNodeVersion(false);
   process.exit(1);
 }
-var CLI_VERSION = "1.13.0";
+var CLI_VERSION = "1.13.1";
 if (CLI_VERSION.startsWith("<<") && CLI_VERSION.endsWith(">>")) {
   try {
     const __filename2 = fileURLToPath14(import.meta.url);
@@ -891032,11 +891121,11 @@ program.command("info").description("Show detailed information about an integrat
     process.exit(1);
   }
 });
-program.command("self-upgrade").alias("self-update").description("Upgrade ADK CLI to the latest version").action(async () => {
+program.command("self-upgrade").alias("self-update").description("Upgrade ADK CLI to the latest version (or a specific tag/version)").argument("[tag-or-version]", "Tag (beta, next) or version (1.13.0) to install").action(async (tagOrVersion) => {
   try {
     await trackCmd("self-upgrade", async () => {
       const { adkSelfUpgrade: adkSelfUpgrade2 } = await Promise.resolve().then(() => (init_upgrade(), exports_upgrade));
-      await adkSelfUpgrade2(CLI_VERSION);
+      await adkSelfUpgrade2(CLI_VERSION, tagOrVersion);
     }, false);
   } catch (error2) {
     console.error("Error:", error2 instanceof Error ? error2.message : String(error2));

package/dist/commands.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.13.0",
-  "generatedAt": "2025-12-18T22:14:42.621Z",
+  "version": "1.13.1",
+  "generatedAt": "2025-12-19T01:21:56.024Z",
   "cliName": "adk",
   "globalOptions": [
     {
@@ -520,11 +520,17 @@
     {
       "name": "self-upgrade",
       "fullName": "self-upgrade",
-      "description": "Upgrade ADK CLI to the latest version",
+      "description": "Upgrade ADK CLI to the latest version (or a specific tag/version)",
       "aliases": [
         "self-update"
       ],
-      "arguments": [],
+      "arguments": [
+        {
+          "name": "tag-or-version",
+          "description": "Tag (beta, next) or version (1.13.0) to install",
+          "required": false
+        }
+      ],
       "options": []
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botpress/adk-cli",
-  "version": "1.13.0",
+  "version": "1.13.1",
   "description": "Command-line interface for the Botpress Agent Development Kit (ADK)",
   "type": "module",
   "main": "dist/index.js",
@@ -41,9 +41,11 @@
     "url": "https://github.com/botpress/adk"
   },
   "dependencies": {
-    "@botpress/adk": "^1.13.0",
+    "@botpress/adk": "^1.13.1",
     "@botpress/cli": "^5.1.1",
-    "@botpress/runtime": "^1.13.0",
+    "@botpress/client": "^1.28.0",
+    "@botpress/runtime": "^1.13.1",
+    "@botpress/sdk": "^5.0.2",
     "@botpress/webchat-client": "^0.4.0",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "adm-zip": "^0.5.16",