@botpress/adk-cli 1.7.14 → 1.7.16

package/dist/cli.js

@@ -346924,7 +346924,7 @@ var init_internal = __esm(() => {
   });
   init_define_PACKAGE_VERSIONS = __esm2({
     "<define:__PACKAGE_VERSIONS__>"() {
-      define_PACKAGE_VERSIONS_default = { runtime: "1.7.14", adk: "1.7.14", sdk: "4.19.0", llmz: "0.0.31", zai: "2.5.0", cognitive: "0.2.0" };
+      define_PACKAGE_VERSIONS_default = { runtime: "1.7.16", adk: "1.7.16", sdk: "4.19.0", llmz: "0.0.31", zai: "2.5.0", cognitive: "0.2.0" };
     }
   });
   init_globalThis = __esm2({
@@ -381402,6 +381402,12 @@ If the question is not related to the knowledge bases, do NOT use this tool.`.tr
             if (tags[WellKnownTags.knowledge.KNOWLEDGE_SOURCE_ID]) {
               citationMetadata.sourceId = tags[WellKnownTags.knowledge.KNOWLEDGE_SOURCE_ID];
             }
+            for (const key in citationMetadata) {
+              let value2 = citationMetadata[key];
+              if (typeof value2 !== "string" || value2.trim().length === 0 || value2.length > 1024) {
+                delete citationMetadata[key];
+              }
+            }
             const { tag } = citations.registerSource(citationMetadata);
             message3.push(`<${tag} file="${p.file.key}" title="${citationMetadata.title || p.file.key}">`);
             message3.push(p.content);
@@ -627100,7 +627106,7 @@ class AgentProjectGenerator {
         deploy: "adk deploy"
       },
       dependencies: {
-        "@botpress/runtime": "^1.7.14"
+        "@botpress/runtime": "^1.7.16"
       },
       devDependencies: {
         typescript: "^5.9.3"
@@ -630051,7 +630057,7 @@ var import_ts_morph, __defProp9, __commonJS5 = (cb4, mod) => () => (mod || cb4((
 `));
     return code;
   }
-}, ADK_VERSION = "1.7.14", relative2 = (from, to3) => {
+}, ADK_VERSION = "1.7.16", relative2 = (from, to3) => {
   const fromDir = path10.dirname(from);
   const relative32 = path10.relative(fromDir, to3);
   return relative32.startsWith(".") ? relative32 : `./${relative32}`;
@@ -630249,7 +630255,7 @@ var init_dist15 = __esm(() => {
   require_package3 = __commonJS5((exports, module) => {
     module.exports = {
       name: "@botpress/adk",
-      version: "1.7.14",
+      version: "1.7.16",
       description: "Core ADK library for building AI agents on Botpress",
       type: "module",
       main: "dist/index.js",
@@ -630296,7 +630302,7 @@ var init_dist15 = __esm(() => {
         "@botpress/cli": "^4.23",
         "@botpress/client": "^1.27.0",
         "@botpress/cognitive": "^0.2.0",
-        "@botpress/runtime": "^1.7.14",
+        "@botpress/runtime": "^1.7.16",
         "@botpress/sdk": "^4.18.1",
         "@bpinternal/yargs-extra": "^0.0.21",
         "@parcel/watcher": "^2.5.1",
@@ -636775,7 +636781,7 @@ var init_Separator = __esm(async () => {
 var require_package4 = __commonJS((exports, module) => {
   module.exports = {
     name: "@botpress/adk",
-    version: "1.7.14",
+    version: "1.7.16",
     description: "Core ADK library for building AI agents on Botpress",
     type: "module",
     main: "dist/index.js",
@@ -636822,7 +636828,7 @@ var require_package4 = __commonJS((exports, module) => {
       "@botpress/cli": "^4.23",
       "@botpress/client": "^1.27.0",
       "@botpress/cognitive": "^0.2.0",
-      "@botpress/runtime": "^1.7.14",
+      "@botpress/runtime": "^1.7.16",
       "@botpress/sdk": "^4.18.1",
       "@bpinternal/yargs-extra": "^0.0.21",
       "@parcel/watcher": "^2.5.1",
@@ -638298,7 +638304,7 @@ function checkRuntimeVersion(agentRoot) {
 `));
   }
 }
-var semver2, EXPECTED_RUNTIME_VERSION = "1.7.14";
+var semver2, EXPECTED_RUNTIME_VERSION = "1.7.16";
 var init_runtime_version_check = __esm(() => {
   init_source();
   semver2 = __toESM(require_semver2(), 1);
@@ -654219,6 +654225,33 @@ function formatHelp(cmd, version) {
   return sections.join(`
 `);
 }
+function formatCommandHelp(cmd) {
+  const theme = defaultTheme;
+  const sections = [];
+  sections.push("");
+  sections.push(source_default.hex(theme.text.primary).bold(cmd.name()));
+  sections.push(source_default.hex(theme.text.secondary)(cmd.description()));
+  sections.push("");
+  sections.push(source_default.hex(theme.text.primary).bold("Usage"));
+  const usage = cmd.usage();
+  sections.push(`  ${source_default.hex(theme.text.dim)("$")} ${source_default.hex(theme.accent.cyan)("adk")} ${source_default.hex(theme.accent.cyan)(cmd.name())} ${source_default.hex(theme.text.dim)(usage)}`);
+  sections.push("");
+  const options = cmd.options;
+  if (options.length > 0) {
+    sections.push(source_default.hex(theme.text.primary).bold("Options"));
+    for (const option of options) {
+      const flags = option.flags;
+      const description = option.description;
+      const flagsDisplay = source_default.hex(theme.accent.yellow)(flags);
+      const flagsPadded = flagsDisplay.padEnd(30);
+      const descriptionText = source_default.hex(theme.text.secondary)(description);
+      sections.push(`  ${flagsPadded}  ${descriptionText}`);
+    }
+    sections.push("");
+  }
+  return sections.join(`
+`);
+}
 function formatWelcome(version) {
   const theme = defaultTheme;
   const logoLine1 = source_default.hex(theme.accent.purple)(" \u2584\u2580\u2588 \u2588\u2580\u2584 \u2588\u2584\u2580");
@@ -654268,11 +654301,114 @@ function formatWelcome(version) {
 // src/cli.ts
 init_node_version_check();
 init_agent_root();
+
+// src/utils/string-similarity.ts
+function calculateLevenshteinDistance(str1, str2) {
+  const len1 = str1.length;
+  const len2 = str2.length;
+  const matrix = [];
+  for (let i = 0;i <= len1; i++) {
+    matrix[i] = [i];
+  }
+  for (let j = 0;j <= len2; j++) {
+    matrix[0][j] = j;
+  }
+  for (let i = 1;i <= len1; i++) {
+    for (let j = 1;j <= len2; j++) {
+      if (str1[i - 1] === str2[j - 1]) {
+        matrix[i][j] = matrix[i - 1][j - 1];
+      } else {
+        matrix[i][j] = Math.min(matrix[i - 1][j] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j - 1] + 1);
+      }
+    }
+  }
+  return matrix[len1][len2];
+}
+function calculateSimilarityScore(str1, str2) {
+  const len1 = str1.length;
+  const len2 = str2.length;
+  const maxLen = Math.max(len1, len2);
+  const minLen = Math.min(len1, len2);
+  if (maxLen === 0)
+    return 1;
+  const distance = calculateLevenshteinDistance(str1, str2);
+  let score = 1 - distance / maxLen;
+  const lengthDiff = Math.abs(len1 - len2);
+  if (lengthDiff > 2) {
+    score *= 0.5;
+  } else if (lengthDiff > 1) {
+    score *= 0.75;
+  }
+  if (str1[0] === str2[0]) {
+    score *= 1.1;
+    const prefixLen = Math.min(3, minLen);
+    if (str1.slice(0, prefixLen) === str2.slice(0, prefixLen)) {
+      score *= 1.15;
+    }
+  }
+  return Math.min(1, score);
+}
+
+// src/utils/command-suggestions.ts
+function findSimilarCommands(unknownCommand, allCommands) {
+  const commandNames = [];
+  for (const cmd of allCommands) {
+    const cmdName = cmd.name();
+    const aliases = cmd.aliases();
+    const mainScore = calculateSimilarityScore(unknownCommand.toLowerCase(), cmdName.toLowerCase());
+    commandNames.push({ command: cmd, name: cmdName, score: mainScore });
+    for (const alias of aliases) {
+      const aliasScore = calculateSimilarityScore(unknownCommand.toLowerCase(), alias.toLowerCase());
+      commandNames.push({ command: cmd, name: alias, score: aliasScore });
+    }
+  }
+  commandNames.sort((a, b) => b.score - a.score);
+  const filtered = commandNames.filter((item) => {
+    if (item.name.toLowerCase() === unknownCommand.toLowerCase()) {
+      return false;
+    }
+    if (item.score < 0.5) {
+      return false;
+    }
+    const lengthDiff = Math.abs(unknownCommand.length - item.name.length);
+    if (lengthDiff > 3 && item.score < 0.65) {
+      return false;
+    }
+    return true;
+  });
+  const seen = new Set;
+  const unique = [];
+  for (const item of filtered) {
+    if (!seen.has(item.command)) {
+      seen.add(item.command);
+      unique.push(item.command);
+      if (unique.length >= 3)
+        break;
+    }
+  }
+  return unique;
+}
+function formatSuggestion(unknownCommand, suggestions) {
+  if (suggestions.length === 0) {
+    return "";
+  }
+  if (suggestions.length === 1) {
+    return `Did you mean ${suggestions[0].name()}?`;
+  }
+  const names = suggestions.map((cmd) => cmd.name());
+  if (suggestions.length === 2) {
+    return `Did you mean ${names[0]} or ${names[1]}?`;
+  }
+  return `Did you mean ${names.slice(0, -1).join(", ")}, or ${names[names.length - 1]}?`;
+}
+
+// src/cli.ts
+init_source();
 if (!checkNodeVersion(true)) {
   checkNodeVersion(false);
   process.exit(1);
 }
-var CLI_VERSION = "1.7.14";
+var CLI_VERSION = "1.7.16";
 
 program.name("adk").description("Botpress Agent Development Kit (ADK) - CLI for building AI agents").version(CLI_VERSION).option("--no-cache", "Disable caching for integration lookups").configureHelp({
   formatHelp: () => formatHelp(program, CLI_VERSION)
@@ -654478,10 +654614,31 @@ assets.command("pull").description("Download remote assets to local directory").
     process.exit(1);
   }
 });
+function configureAllCommandsHelp() {
+  function configureHelpRecursive(cmd) {
+    cmd.configureHelp({
+      formatHelp: () => formatCommandHelp(cmd)
+    });
+    cmd.commands.forEach((subcmd) => {
+      configureHelpRecursive(subcmd);
+    });
+  }
+  program.commands.forEach((cmd) => {
+    configureHelpRecursive(cmd);
+  });
+}
+configureAllCommandsHelp();
 program.on("command:*", function(operands) {
-  console.error(`
-Error: Unknown command '${operands[0]}'
-`);
+  const unknownCommand = operands[0];
+  const allCommands = Array.from(program.commands);
+  const suggestions = findSimilarCommands(unknownCommand, allCommands);
+  const suggestionText = formatSuggestion(unknownCommand, suggestions);
+  console.error(source_default.red(`adk: "${unknownCommand}" is not an adk command. See 'adk help'.
+`));
+  if (suggestionText) {
+    console.error(source_default.yellow(`\uD83D\uDCA1 ${suggestionText}
+`));
+  }
   program.help();
 });
 async function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botpress/adk-cli",
-  "version": "1.7.14",
+  "version": "1.7.16",
   "description": "Command-line interface for the Botpress Agent Development Kit (ADK)",
   "type": "module",
   "main": "dist/index.js",
@@ -40,9 +40,9 @@
     "url": "https://github.com/botpress/adk"
   },
   "dependencies": {
-    "@botpress/adk": "^1.7.14",
+    "@botpress/adk": "^1.7.16",
     "@botpress/cli": "^4.23",
-    "@botpress/runtime": "^1.7.14",
+    "@botpress/runtime": "^1.7.16",
     "adm-zip": "^0.5.16",
     "chalk": "^5.4.1",
     "clipboardy": "^4.0.0",