@botpress/adk-cli 1.10.2 → 1.10.3

package/dist/cli.js

@@ -352010,7 +352010,7 @@ var init_internal = __esm(() => {
   });
   init_define_PACKAGE_VERSIONS = __esm2({
     "<define:__PACKAGE_VERSIONS__>"() {
-      define_PACKAGE_VERSIONS_default = { runtime: "1.10.2", adk: "1.10.2", sdk: "4.20.2", llmz: "0.0.33", zai: "2.5.0", cognitive: "0.2.0" };
+      define_PACKAGE_VERSIONS_default = { runtime: "1.10.3", adk: "1.10.3", sdk: "4.20.2", llmz: "0.0.33", zai: "2.5.0", cognitive: "0.2.0" };
     }
   });
   init_asset = __esm2({
@@ -658306,7 +658306,7 @@ var init_library2 = __esm(() => {
   });
   init_define_PACKAGE_VERSIONS2 = __esm4({
     "<define:__PACKAGE_VERSIONS__>"() {
-      define_PACKAGE_VERSIONS_default2 = { runtime: "1.10.2", adk: "1.10.2", sdk: "4.20.2", llmz: "0.0.33", zai: "2.5.0", cognitive: "0.2.0" };
+      define_PACKAGE_VERSIONS_default2 = { runtime: "1.10.3", adk: "1.10.3", sdk: "4.20.2", llmz: "0.0.33", zai: "2.5.0", cognitive: "0.2.0" };
     }
   });
   init_assets2 = __esm4({
@@ -703011,7 +703011,7 @@ class AgentProjectGenerator {
         deploy: "adk deploy"
       },
       dependencies: {
-        "@botpress/runtime": "^1.10.2"
+        "@botpress/runtime": "^1.10.3"
       },
       devDependencies: {
         typescript: "^5.9.3"
@@ -707131,7 +707131,7 @@ var import_ts_morph, __defProp11, __commonJS7 = (cb4, mod) => () => (mod || cb4(
 `));
     return code;
   }
-}, ADK_VERSION = "1.10.2", relative22 = (from, to3) => {
+}, ADK_VERSION = "1.10.3", relative22 = (from, to3) => {
   const fromDir = path102.dirname(from);
   const relative32 = path102.relative(fromDir, to3);
   return relative32.startsWith(".") ? relative32 : `./${relative32}`;
@@ -707346,7 +707346,7 @@ var init_dist17 = __esm(() => {
   require_package3 = __commonJS7((exports7, module) => {
     module.exports = {
       name: "@botpress/adk",
-      version: "1.10.2",
+      version: "1.10.3",
       description: "Core ADK library for building AI agents on Botpress",
       type: "module",
       main: "dist/index.js",
@@ -707393,7 +707393,7 @@ var init_dist17 = __esm(() => {
         "@botpress/cli": "^4.27.3",
         "@botpress/client": "^1.27.2",
         "@botpress/cognitive": "^0.2.0",
-        "@botpress/runtime": "^1.10.2",
+        "@botpress/runtime": "^1.10.3",
         "@botpress/sdk": "^4.18.1",
         "@bpinternal/jex": "^1.2.4",
         "@bpinternal/yargs-extra": "^0.0.21",
@@ -713937,7 +713937,7 @@ var init_Separator = __esm(async () => {
 var require_package4 = __commonJS((exports7, module) => {
   module.exports = {
     name: "@botpress/adk",
-    version: "1.10.2",
+    version: "1.10.3",
     description: "Core ADK library for building AI agents on Botpress",
     type: "module",
     main: "dist/index.js",
@@ -713984,7 +713984,7 @@ var require_package4 = __commonJS((exports7, module) => {
       "@botpress/cli": "^4.27.3",
       "@botpress/client": "^1.27.2",
       "@botpress/cognitive": "^0.2.0",
-      "@botpress/runtime": "^1.10.2",
+      "@botpress/runtime": "^1.10.3",
       "@botpress/sdk": "^4.18.1",
       "@bpinternal/jex": "^1.2.4",
       "@bpinternal/yargs-extra": "^0.0.21",
@@ -715931,7 +715931,7 @@ function checkRuntimeVersion(agentRoot) {
 `));
   }
 }
-var semver2, EXPECTED_RUNTIME_VERSION = "1.10.2";
+var semver2, EXPECTED_RUNTIME_VERSION = "1.10.3";
 var init_runtime_version_check = __esm(() => {
   init_source();
   semver2 = __toESM(require_semver2(), 1);
@@ -732081,7 +732081,7 @@ function formatWelcome(version) {
     sections.push(`  ${commandDisplay}${padding}  ${descriptionText}`);
   }
   sections.push("");
-  sections.push(source_default.hex(theme.text.dim)("Learn more: https://docs.botpress.com"));
+  sections.push(source_default.hex(theme.text.dim)("Learn more: https://www.botpress.com/docs/for-developers/adk/overview"));
   sections.push("");
   return sections.join(`
 `);
@@ -732257,7 +732257,7 @@ if (!checkNodeVersion(true)) {
   checkNodeVersion(false);
   process.exit(1);
 }
-var CLI_VERSION = "1.10.2";
+var CLI_VERSION = "1.10.3";
 if (CLI_VERSION.startsWith("<<") && CLI_VERSION.endsWith(">>")) {
   try {
     const __filename2 = fileURLToPath12(import.meta.url);

package/dist/commands.json

@@ -0,0 +1,503 @@
+{
+  "version": "1.10.3",
+  "generatedAt": "2025-12-03T18:29:11.763Z",
+  "cliName": "adk",
+  "globalOptions": [
+    {
+      "flags": "--no-cache",
+      "description": "Disable caching for integration lookups"
+    },
+    {
+      "flags": "--version, -V",
+      "description": "Show version number"
+    },
+    {
+      "flags": "--help, -h",
+      "description": "Show help for command"
+    }
+  ],
+  "commands": [
+    {
+      "name": "add",
+      "fullName": "add",
+      "description": "Add an integration or interface to your agent",
+      "aliases": [
+        "i",
+        "install"
+      ],
+      "arguments": [
+        {
+          "name": "resource",
+          "description": "integration (e.g., slack@1.0.0) or interface (e.g., interface:translator@1.0.0)",
+          "required": true
+        }
+      ],
+      "options": [
+        {
+          "flags": "--alias <alias>",
+          "description": "use a custom alias for the resource"
+        }
+      ]
+    },
+    {
+      "name": "assets",
+      "fullName": "assets",
+      "description": "Manage agent assets and static files",
+      "aliases": [],
+      "arguments": [],
+      "options": []
+    },
+    {
+      "name": "list",
+      "fullName": "assets list",
+      "description": "List all asset files",
+      "aliases": [],
+      "arguments": [],
+      "options": [
+        {
+          "flags": "--local",
+          "description": "show only local assets"
+        },
+        {
+          "flags": "--remote",
+          "description": "show only remote assets"
+        }
+      ]
+    },
+    {
+      "name": "pull",
+      "fullName": "assets pull",
+      "description": "Download remote assets to local directory",
+      "aliases": [],
+      "arguments": [],
+      "options": []
+    },
+    {
+      "name": "status",
+      "fullName": "assets status",
+      "description": "Show asset synchronization status",
+      "aliases": [],
+      "arguments": [],
+      "options": []
+    },
+    {
+      "name": "sync",
+      "fullName": "assets sync",
+      "description": "Synchronize assets with remote storage",
+      "aliases": [],
+      "arguments": [],
+      "options": [
+        {
+          "flags": "--dry-run",
+          "description": "preview changes without applying them"
+        },
+        {
+          "flags": "-y, --yes",
+          "description": "skip confirmation prompts"
+        },
+        {
+          "flags": "--bail-on-failure",
+          "description": "stop on first error"
+        },
+        {
+          "flags": "--force",
+          "description": "force re-upload all files"
+        }
+      ]
+    },
+    {
+      "name": "build",
+      "fullName": "build",
+      "description": "Build the agent for production",
+      "aliases": [],
+      "arguments": [],
+      "options": []
+    },
+    {
+      "name": "chat",
+      "fullName": "chat",
+      "description": "Chat with your agent in development mode",
+      "aliases": [],
+      "arguments": [],
+      "options": []
+    },
+    {
+      "name": "config",
+      "fullName": "config",
+      "description": "",
+      "aliases": [],
+      "arguments": [],
+      "options": [
+        {
+          "flags": "--prod",
+          "description": "use production configuration"
+        }
+      ]
+    },
+    {
+      "name": "config:get",
+      "fullName": "config:get",
+      "description": "Get a configuration value",
+      "aliases": [],
+      "arguments": [
+        {
+          "name": "key",
+          "description": "configuration key",
+          "required": true
+        }
+      ],
+      "options": [
+        {
+          "flags": "--prod",
+          "description": "use production configuration"
+        }
+      ]
+    },
+    {
+      "name": "config:set",
+      "fullName": "config:set",
+      "description": "Set a configuration value",
+      "aliases": [],
+      "arguments": [
+        {
+          "name": "key",
+          "description": "configuration key",
+          "required": true
+        },
+        {
+          "name": "value",
+          "description": "configuration value",
+          "required": true
+        }
+      ],
+      "options": [
+        {
+          "flags": "--prod",
+          "description": "use production configuration"
+        }
+      ]
+    },
+    {
+      "name": "deploy",
+      "fullName": "deploy",
+      "description": "Deploy the agent to Botpress",
+      "aliases": [],
+      "arguments": [],
+      "options": [
+        {
+          "flags": "-e, --env <environment>",
+          "description": "deployment environment",
+          "defaultValue": "production"
+        },
+        {
+          "flags": "-y, --yes",
+          "description": "auto-approve preflight changes without prompting"
+        }
+      ]
+    },
+    {
+      "name": "dev",
+      "fullName": "dev",
+      "description": "Start development mode with hot reloading",
+      "aliases": [],
+      "arguments": [],
+      "options": [
+        {
+          "flags": "-p, --port <port>",
+          "description": "port for development server",
+          "defaultValue": "3000"
+        },
+        {
+          "flags": "--port-console <port>",
+          "description": "port for console server",
+          "defaultValue": "3001"
+        },
+        {
+          "flags": "-l, --logs",
+          "description": "stream logs to stderr (CI/CLI-friendly)"
+        }
+      ]
+    },
+    {
+      "name": "info",
+      "fullName": "info",
+      "description": "Show detailed information about an integration",
+      "aliases": [],
+      "arguments": [
+        {
+          "name": "name",
+          "description": "integration name",
+          "required": true
+        }
+      ],
+      "options": [
+        {
+          "flags": "--actions",
+          "description": "show only actions"
+        },
+        {
+          "flags": "--channels",
+          "description": "show only channels"
+        },
+        {
+          "flags": "--events",
+          "description": "show only events"
+        },
+        {
+          "flags": "--full",
+          "description": "show all details"
+        },
+        {
+          "flags": "--format <format>",
+          "description": "output format (table, json)",
+          "defaultValue": "table"
+        }
+      ]
+    },
+    {
+      "name": "init",
+      "fullName": "init",
+      "description": "Initialize a new ADK agent project",
+      "aliases": [],
+      "arguments": [
+        {
+          "name": "name",
+          "description": "name of the agent project",
+          "required": false
+        }
+      ],
+      "options": [
+        {
+          "flags": "-t, --template <template>",
+          "description": "template to use (default: blank)"
+        }
+      ]
+    },
+    {
+      "name": "kb",
+      "fullName": "kb",
+      "description": "Manage knowledge bases and synchronization",
+      "aliases": [],
+      "arguments": [],
+      "options": []
+    },
+    {
+      "name": "sync",
+      "fullName": "kb sync",
+      "description": "Synchronize knowledge bases with Botpress (requires --dev or --prod)",
+      "aliases": [],
+      "arguments": [],
+      "options": [
+        {
+          "flags": "--dev",
+          "description": "sync with development bot"
+        },
+        {
+          "flags": "--prod",
+          "description": "sync with production bot"
+        },
+        {
+          "flags": "--dry-run",
+          "description": "preview changes without applying them"
+        },
+        {
+          "flags": "-y, --yes",
+          "description": "skip confirmation prompts"
+        },
+        {
+          "flags": "--force",
+          "description": "force re-sync all knowledge bases"
+        }
+      ]
+    },
+    {
+      "name": "link",
+      "fullName": "link",
+      "description": "Link local agent to workspace and bot",
+      "aliases": [],
+      "arguments": [],
+      "options": [
+        {
+          "flags": "--workspace <workspaceId>",
+          "description": "workspace ID"
+        },
+        {
+          "flags": "--bot <botId>",
+          "description": "bot ID to link to"
+        },
+        {
+          "flags": "--dev <devBotId>",
+          "description": "dev bot ID (optional)"
+        },
+        {
+          "flags": "--api-url <apiUrl>",
+          "description": "Botpress API URL (e.g., https://api.botpress.cloud)"
+        }
+      ]
+    },
+    {
+      "name": "list",
+      "fullName": "list",
+      "description": "List integrations (installed or available)",
+      "aliases": [],
+      "arguments": [],
+      "options": [
+        {
+          "flags": "--available",
+          "description": "list all available integrations"
+        },
+        {
+          "flags": "--format <format>",
+          "description": "output format (table, json)",
+          "defaultValue": "table"
+        },
+        {
+          "flags": "--limit <number>",
+          "description": "limit number of results",
+          "defaultValue": "50"
+        }
+      ]
+    },
+    {
+      "name": "login",
+      "fullName": "login",
+      "description": "Authenticate with your Botpress account",
+      "aliases": [],
+      "arguments": [],
+      "options": [
+        {
+          "flags": "--token <token>",
+          "description": "Botpress API token"
+        },
+        {
+          "flags": "--profile <profile>",
+          "description": "profile name to use",
+          "defaultValue": "default"
+        },
+        {
+          "flags": "--api-url <url>",
+          "description": "Botpress API URL",
+          "defaultValue": "https://api.botpress.cloud"
+        }
+      ]
+    },
+    {
+      "name": "profiles",
+      "fullName": "profiles",
+      "description": "Manage authentication profiles",
+      "aliases": [],
+      "arguments": [],
+      "options": []
+    },
+    {
+      "name": "list",
+      "fullName": "profiles list",
+      "description": "List all configured profiles",
+      "aliases": [],
+      "arguments": [],
+      "options": []
+    },
+    {
+      "name": "set",
+      "fullName": "profiles set",
+      "description": "Switch to a different profile",
+      "aliases": [],
+      "arguments": [
+        {
+          "name": "profile",
+          "description": "profile name to switch to",
+          "required": false
+        }
+      ],
+      "options": []
+    },
+    {
+      "name": "remove",
+      "fullName": "remove",
+      "description": "Remove an integration from your agent",
+      "aliases": [
+        "rm"
+      ],
+      "arguments": [
+        {
+          "name": "integration",
+          "description": "integration alias to remove (interactive if not specified)",
+          "required": false
+        }
+      ],
+      "options": []
+    },
+    {
+      "name": "search",
+      "fullName": "search",
+      "description": "Search for integrations in the Botpress hub",
+      "aliases": [],
+      "arguments": [
+        {
+          "name": "query",
+          "description": "search query",
+          "required": true
+        }
+      ],
+      "options": [
+        {
+          "flags": "--format <format>",
+          "description": "output format (table, json)",
+          "defaultValue": "table"
+        },
+        {
+          "flags": "--limit <number>",
+          "description": "limit number of results",
+          "defaultValue": "20"
+        }
+      ]
+    },
+    {
+      "name": "self-upgrade",
+      "fullName": "self-upgrade",
+      "description": "Upgrade ADK CLI to the latest version",
+      "aliases": [
+        "self-update"
+      ],
+      "arguments": [],
+      "options": []
+    },
+    {
+      "name": "telemetry",
+      "fullName": "telemetry",
+      "description": "Manage telemetry preferences",
+      "aliases": [],
+      "arguments": [],
+      "options": [
+        {
+          "flags": "--status",
+          "description": "show telemetry status"
+        },
+        {
+          "flags": "--enable",
+          "description": "enable telemetry"
+        },
+        {
+          "flags": "--disable",
+          "description": "disable telemetry"
+        }
+      ]
+    },
+    {
+      "name": "upgrade",
+      "fullName": "upgrade",
+      "description": "Upgrade integration(s) to latest version",
+      "aliases": [
+        "up"
+      ],
+      "arguments": [
+        {
+          "name": "integration",
+          "description": "integration alias to upgrade (interactive if not specified)",
+          "required": false
+        }
+      ],
+      "options": []
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botpress/adk-cli",
-  "version": "1.10.2",
+  "version": "1.10.3",
   "description": "Command-line interface for the Botpress Agent Development Kit (ADK)",
   "type": "module",
   "main": "dist/index.js",
@@ -19,6 +19,7 @@
     "dev": "bun src/cli.ts",
     "clean": "rm -rf dist",
     "prepublishOnly": "bun run clean && bun run build",
+    "generate:docs": "bun scripts/generate-commands-json.ts",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:ui": "vitest --ui"
@@ -40,9 +41,9 @@
     "url": "https://github.com/botpress/adk"
   },
   "dependencies": {
-    "@botpress/adk": "^1.10.2",
+    "@botpress/adk": "^1.10.3",
     "@botpress/cli": "^4.27.3",
-    "@botpress/runtime": "^1.10.2",
+    "@botpress/runtime": "^1.10.3",
     "adm-zip": "^0.5.16",
     "chalk": "^5.4.1",
     "clipboardy": "^4.0.0",