@kweaver-ai/kweaver-sdk 0.8.2 → 0.8.3

package/dist/commands/skill.js

@@ -4,129 +4,265 @@ import { ensureValidToken, formatHttpError, with401RefreshRetry } from "../auth/
 import { resolveBusinessDomain } from "../config/store.js";
 import { deleteSkill, downloadSkill, downloadSkillManagementArchive, fetchSkillContent, fetchSkillFile, getSkill, getSkillMarketDetail, getSkillContentIndex, getSkillManagementContent, installSkillArchive, listSkillMarket, listSkillHistory, listSkills, publishSkillHistory, readSkillFile, readSkillManagementFile, republishSkillHistory, registerSkillZip, updateSkillMetadata, updateSkillPackageContent, updateSkillPackageZip, updateSkillStatus, } from "../api/skills.js";
 import { bundleSkillDirectoryToZip, bundleSkillFileToZip } from "../utils/skill-bundle.js";
+import { renderHelp } from "../help/format.js";
+const SKILL_HELP = renderHelp({
+    tagline: "Skill registry and market — register, market, content, lifecycle",
+    usage: "kweaver skill <subcommand> [flags]",
+    sections: [
+        {
+            title: "REGISTRY",
+            items: [
+                { name: "list", desc: "List skills (filter by --name / --status / --source / --create-user)" },
+                { name: "get", desc: "Get a skill by id" },
+                { name: "register", desc: "Register a skill (--content-file <SKILL.md|dir> | --zip-file <path>)" },
+                { name: "set-status", desc: "Change status: unpublish | published | offline" },
+                { name: "delete", desc: "Delete a skill" },
+            ],
+        },
+        {
+            title: "MARKET",
+            items: [
+                { name: "market", desc: "Browse the skill market" },
+                { name: "market-get", desc: "Get a market skill by id" },
+                { name: "download", desc: "Download a skill package archive" },
+                { name: "install", desc: "Install a skill locally" },
+            ],
+        },
+        {
+            title: "CONTENT",
+            items: [
+                { name: "content", desc: "Read SKILL.md content" },
+                { name: "read-file", desc: "Read a file inside a skill (progressive)" },
+                { name: "management-content", desc: "Read SKILL.md via management endpoint" },
+                { name: "management-read-file", desc: "Read file inside skill via management endpoint" },
+                { name: "management-download", desc: "Download via management endpoint" },
+            ],
+        },
+        {
+            title: "LIFECYCLE",
+            items: [
+                { name: "update-metadata", desc: "Update metadata (name / description / category / source)" },
+                { name: "update-package", desc: "Update package content or zip" },
+                { name: "history", desc: "Show version history" },
+                { name: "republish", desc: "Republish a specific historical version" },
+                { name: "publish-history", desc: "Publish a historical version" },
+            ],
+        },
+    ],
+    flags: [
+        { name: "-bd, --biz-domain <s>", desc: "Business domain (default: bd_public)" },
+        { name: "--pretty / --compact", desc: "JSON output style (default: pretty)" },
+    ],
+    inheritedFlags: "--base-url, --token, --user, --help",
+    examples: [
+        "kweaver skill list --name kweaver",
+        "kweaver skill register --zip-file ./demo-skill.zip --source upload_zip",
+        "kweaver skill install skill-123 ./skills/demo-skill --force",
+    ],
+    learnMore: ["Use `kweaver skill <subcommand> --help` for flag details"],
+});
 function printSkillHelp(subcommand) {
     if (subcommand === "list") {
-        console.log(`kweaver skill list [--name kw] [--source src] [--status status] [--create-user user]
-                   [--page N] [--page-size N|--limit N] [--all] [-bd value] [--pretty|--compact]`);
+        console.log(renderHelp({
+            tagline: "List installed skills.",
+            usage: "kweaver skill list [--name kw] [--source src] [--status status] [--create-user user] [--page N] [--page-size N|--limit N] [--all] [-bd value] [--pretty|--compact]",
+            flags: [
+                { name: "--name kw", desc: "Filter by name keyword." },
+                { name: "--source src", desc: "Filter by source." },
+                { name: "--status status", desc: "Filter by status." },
+                { name: "--create-user user", desc: "Filter by creator." },
+                { name: "--page N", desc: "Page number." },
+                { name: "--page-size N", desc: "Page size (alias: --limit)." },
+                { name: "--all", desc: "Fetch all pages." },
+                { name: "-bd value", desc: "Override base URL." },
+                { name: "--pretty|--compact", desc: "Toggle pretty JSON output." },
+            ],
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "market") {
-        console.log(`kweaver skill market [--name kw] [--source src] [--page N] [--page-size N|--limit N]
-                     [--all] [-bd value] [--pretty|--compact]`);
+        console.log(renderHelp({
+            tagline: "Browse the skill marketplace.",
+            usage: "kweaver skill market [--name kw] [--source src] [--page N] [--page-size N|--limit N] [--all] [-bd value] [--pretty|--compact]",
+            flags: [
+                { name: "--name kw", desc: "Filter by name keyword." },
+                { name: "--source src", desc: "Filter by source." },
+                { name: "--page N", desc: "Page number." },
+                { name: "--page-size N", desc: "Page size (alias: --limit)." },
+                { name: "--all", desc: "Fetch all pages." },
+                { name: "-bd value", desc: "Override base URL." },
+                { name: "--pretty|--compact", desc: "Toggle pretty JSON output." },
+            ],
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "get") {
-        console.log("kweaver skill get <skill-id> [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Show installed skill details.",
+            usage: "kweaver skill get <skill-id> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "market-get") {
-        console.log("kweaver skill market-get <skill-id> [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Show marketplace skill details.",
+            usage: "kweaver skill market-get <skill-id> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "register") {
-        console.log(`kweaver skill register (--content-file <path> | --zip-file <path>)
-                       [--source src] [--extend-info json] [-bd value] [--pretty|--compact]
-
-  --content-file accepts either:
-    - a single file named SKILL.md (auto-bundled into a 1-file zip)
-    - a skill directory containing SKILL.md (bundled into a zip)
-  Both paths upload as multipart zip; the backend's file_type=content
-  registration is unreliable (publish-then-read returns 404) so the CLI
-  always goes through zip.
-  --zip-file accepts a pre-built .zip with SKILL.md at the archive root.`);
+        console.log(renderHelp({
+            tagline: "Register a new skill (multipart zip upload).",
+            usage: "kweaver skill register (--content-file <path> | --zip-file <path>) [--source src] [--extend-info json] [-bd value] [--pretty|--compact]",
+            flags: [
+                { name: "--content-file <path>", desc: "SKILL.md file or skill directory containing SKILL.md (auto-bundled into a zip)." },
+                { name: "--zip-file <path>", desc: "Pre-built .zip with SKILL.md at the archive root." },
+                { name: "--source src", desc: "Source tag." },
+                { name: "--extend-info json", desc: "Extra metadata as JSON object." },
+                { name: "-bd value", desc: "Override base URL." },
+                { name: "--pretty|--compact", desc: "Toggle pretty JSON output." },
+            ],
+            inheritedFlags: "--base-url, --token, --user, --help",
+            learnMore: [
+                "Both --content-file and --zip-file upload as multipart zip; the backend's",
+                "file_type=content registration is unreliable (publish-then-read returns 404)",
+                "so the CLI always goes through zip.",
+            ],
+        }));
         return;
     }
     if (subcommand === "set-status" || subcommand === "status") {
-        console.log("kweaver skill set-status <skill-id> <unpublish|published|offline> [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Set skill publish status.",
+            usage: "kweaver skill set-status <skill-id> <unpublish|published|offline> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "delete") {
-        console.log("kweaver skill delete <skill-id> [-y|--yes] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Delete a skill.",
+            usage: "kweaver skill delete <skill-id> [-y|--yes] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "update-metadata") {
-        console.log(`kweaver skill update-metadata <skill-id> --name <name> --description <text> --category <other_category|system>
-                         [--source <custom|internal>] [--extend-info json] [-bd value] [--pretty|--compact]`);
+        console.log(renderHelp({
+            tagline: "Update skill metadata fields.",
+            usage: "kweaver skill update-metadata <skill-id> --name <name> --description <text> --category <other_category|system> [--source <custom|internal>] [--extend-info json] [-bd value] [--pretty|--compact]",
+            flags: [
+                { name: "--name <name>", desc: "Skill name." },
+                { name: "--description <text>", desc: "Skill description." },
+                { name: "--category <other_category|system>", desc: "Skill category." },
+                { name: "--source <custom|internal>", desc: "Source tag." },
+                { name: "--extend-info json", desc: "Extra metadata as JSON object." },
+                { name: "-bd value", desc: "Override base URL." },
+                { name: "--pretty|--compact", desc: "Toggle pretty JSON output." },
+            ],
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "update-package") {
-        console.log(`kweaver skill update-package <skill-id> (--content-file <path> | --zip-file <path>)
-                        [-bd value] [--pretty|--compact]`);
+        console.log(renderHelp({
+            tagline: "Replace skill package contents.",
+            usage: "kweaver skill update-package <skill-id> (--content-file <path> | --zip-file <path>) [-bd value] [--pretty|--compact]",
+            flags: [
+                { name: "--content-file <path>", desc: "SKILL.md file or skill directory (auto-bundled into a zip)." },
+                { name: "--zip-file <path>", desc: "Pre-built .zip with SKILL.md at the archive root." },
+                { name: "-bd value", desc: "Override base URL." },
+                { name: "--pretty|--compact", desc: "Toggle pretty JSON output." },
+            ],
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "history") {
-        console.log("kweaver skill history <skill-id> [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Show skill edit history.",
+            usage: "kweaver skill history <skill-id> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "republish") {
-        console.log("kweaver skill republish <skill-id> --version <version> [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Republish a previous skill version.",
+            usage: "kweaver skill republish <skill-id> --version <version> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "publish-history") {
-        console.log("kweaver skill publish-history <skill-id> --version <version> [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Show publish history for a version.",
+            usage: "kweaver skill publish-history <skill-id> --version <version> [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "content") {
-        console.log("kweaver skill content <skill-id> [--raw] [--output file] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Fetch installed skill SKILL.md content.",
+            usage: "kweaver skill content <skill-id> [--raw] [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "read-file") {
-        console.log("kweaver skill read-file <skill-id> <rel-path> [--raw] [--output file] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Read a file from an installed skill.",
+            usage: "kweaver skill read-file <skill-id> <rel-path> [--raw] [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "download") {
-        console.log("kweaver skill download <skill-id> [--output file] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Download an installed skill package.",
+            usage: "kweaver skill download <skill-id> [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "install") {
-        console.log("kweaver skill install <skill-id> [directory] [--force] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Install a skill locally.",
+            usage: "kweaver skill install <skill-id> [directory] [--force] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "management-content") {
-        console.log("kweaver skill management-content <skill-id> [--raw] [--response-mode url|content] [--output file] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Fetch management-side skill SKILL.md content.",
+            usage: "kweaver skill management-content <skill-id> [--raw] [--response-mode url|content] [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "management-read-file") {
-        console.log("kweaver skill management-read-file <skill-id> <rel-path> [--response-mode url|content] [--output file] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Read a file via management API.",
+            usage: "kweaver skill management-read-file <skill-id> <rel-path> [--response-mode url|content] [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
     if (subcommand === "management-download") {
-        console.log("kweaver skill management-download <skill-id> [--response-mode url|content] [--output file] [-bd value] [--pretty|--compact]");
+        console.log(renderHelp({
+            tagline: "Download a skill via management API.",
+            usage: "kweaver skill management-download <skill-id> [--response-mode url|content] [--output file] [-bd value] [--pretty|--compact]",
+            inheritedFlags: "--base-url, --token, --user, --help",
+        }));
         return;
     }
-    console.log(`kweaver skill
-
-Subcommands:
-  list [--name kw] [--status status] [--page N] [--page-size N] [-bd value]
-  market [--name kw] [--source src] [--page N] [--page-size N] [-bd value]
-  get <skill-id> [-bd value]
-  market-get <skill-id> [-bd value]
-  register --content-file <path> | --zip-file <path> [--source src] [--extend-info json]
-           (--content-file accepts a file named SKILL.md or a directory; both auto-zip)
-  set-status <skill-id> <unpublish|published|offline> [-bd value]
-  delete <skill-id> [-y] [-bd value]
-  update-metadata <skill-id> --name <name> --description <text> --category <other_category|system> [--source <custom|internal>] [--extend-info json]
-  update-package <skill-id> (--content-file <path> | --zip-file <path>) [-bd value]
-  history <skill-id> [-bd value]
-  republish <skill-id> --version <version> [-bd value]
-  publish-history <skill-id> --version <version> [-bd value]
-  content <skill-id> [--raw] [--output file] [-bd value]
-  read-file <skill-id> <rel-path> [--raw] [--output file] [-bd value]
-  download <skill-id> [--output file] [-bd value]
-  install <skill-id> [directory] [--force] [-bd value]
-  management-content <skill-id> [--raw] [--response-mode url|content] [--output file] [-bd value]
-  management-read-file <skill-id> <rel-path> [--response-mode url|content] [--output file] [-bd value]
-  management-download <skill-id> [--response-mode url|content] [--output file] [-bd value]
-
-Examples:
-  kweaver skill list --name kweaver
-  kweaver skill register --zip-file ./demo-skill.zip --source upload_zip
-  kweaver skill update-metadata skill-123 --name "Demo" --description "Demo skill" --category system
-  kweaver skill update-package skill-123 --content-file ./SKILL.md
-  kweaver skill history skill-123
-  kweaver skill content skill-123 --raw
-  kweaver skill read-file skill-123 references/guide.md --output ./guide.md
-  kweaver skill install skill-123 ./skills/demo-skill --force`);
+    console.log(SKILL_HELP);
 }
 function format(value, pretty) {
     return JSON.stringify(value, null, pretty ? 2 : 0);

package/dist/commands/token.js

@@ -1,10 +1,21 @@
 import { ensureValidToken, formatHttpError } from "../auth/oauth.js";
+import { renderHelp } from "../help/format.js";
+const HELP = renderHelp({
+    tagline: "Print the current access token (auto-refresh first if needed)",
+    usage: "kweaver token",
+    inheritedFlags: "--base-url, --token, --user, --help",
+    examples: ["kweaver token", "kweaver --user alice token"],
+});
 export function parseTokenArgs(args) {
     if (args.length > 0) {
         throw new Error("Usage: kweaver token");
     }
 }
 export async function runTokenCommand(args) {
+    if (args[0] === "--help" || args[0] === "-h") {
+        console.log(HELP);
+        return 0;
+    }
     try {
         parseTokenArgs(args);
     }

package/dist/commands/tool.js

@@ -3,35 +3,52 @@ import { ensureValidToken, formatHttpError, with401RefreshRetry } from "../auth/
 import { debugTool, executeTool, listTools, setToolStatuses, uploadTool } from "../api/toolboxes.js";
 import { formatCallOutput } from "./call.js";
 import { resolveBusinessDomain } from "../config/store.js";
-const HELP = `kweaver tool
-
-Subcommands:
-  upload --toolbox <box-id> <openapi-spec-path> [--metadata-type openapi]
-                                              Upload an OpenAPI spec file as a tool
-  list --toolbox <box-id>                      List tools in a toolbox
-  enable --toolbox <box-id> <tool-id>...       Enable one or more tools
-  disable --toolbox <box-id> <tool-id>...      Disable one or more tools
-  execute --toolbox <box-id> <tool-id> [--body '<json>'|--body-file <path>]
-                                              [--header|--query|--path '<json>']
-                                              Invoke a published+enabled tool
-  debug   --toolbox <box-id> <tool-id> [--body '<json>'|--body-file <path>]
-                                              [--header|--query|--path '<json>']
-                                              Invoke a tool (works on draft/disabled too)
-
-Options for execute/debug:
-  --header '<json>'       Headers map forwarded to the downstream tool
-                          (Authorization is auto-injected from current session
-                          when --header omits it; pass {} to send none)
-  --query  '<json>'       Query params map forwarded to the downstream tool
-  --path   '<json>'       Path parameter map for OpenAPI path placeholders (e.g. {id})
-                          (JSON object: quote id and UUID, e.g. key id for get_dataview_detail /
-                          query_dataview_sql)
-  --timeout <seconds>     Per-call timeout (backend default applies when omitted)
-
-Common options:
-  -bd, --biz-domain <s>   Business domain (default: bd_public)
-  --pretty                Pretty-print JSON (default)
-  --compact               Single-line JSON (pipeline-friendly)`;
+import { renderHelp } from "../help/format.js";
+const HELP = renderHelp({
+    tagline: "Tools inside a toolbox — upload OpenAPI specs, enable/disable, execute",
+    usage: "kweaver tool <subcommand> --toolbox <box-id> [flags]",
+    sections: [
+        {
+            title: "AVAILABLE COMMANDS",
+            items: [
+                { name: "upload", desc: "Upload an OpenAPI spec file as a tool" },
+                { name: "list", desc: "List tools in a toolbox" },
+                { name: "enable", desc: "Enable one or more tools" },
+                { name: "disable", desc: "Disable one or more tools" },
+                { name: "execute", desc: "Invoke a published+enabled tool" },
+                { name: "debug", desc: "Invoke a tool (works on draft/disabled too)" },
+            ],
+        },
+    ],
+    flags: [
+        {
+            title: "Execute / debug",
+            flags: [
+                { name: "--body '<json>'", desc: "Request body" },
+                { name: "--body-file <path>", desc: "Request body from file" },
+                { name: "--header '<json>'", desc: "Headers map (Authorization auto-injected if omitted; pass {} to send none)" },
+                { name: "--query '<json>'", desc: "Query params map" },
+                { name: "--path '<json>'", desc: "Path params for OpenAPI placeholders, e.g. {\"id\":\"...\"}" },
+                { name: "--timeout <seconds>", desc: "Per-call timeout (backend default applies when omitted)" },
+            ],
+        },
+        {
+            title: "Common",
+            flags: [
+                { name: "-bd, --biz-domain <s>", desc: "Business domain (default: bd_public)" },
+                { name: "--pretty", desc: "Pretty-print JSON (default)" },
+                { name: "--compact", desc: "Single-line JSON (pipeline-friendly)" },
+            ],
+        },
+    ],
+    inheritedFlags: "--base-url, --token, --user, --help",
+    examples: [
+        "kweaver tool upload --toolbox <box-id> spec.yaml",
+        "kweaver tool list --toolbox <box-id>",
+        "kweaver tool execute --toolbox <box-id> <tool-id> --body '{\"key\":\"value\"}'",
+    ],
+    learnMore: ["Use `kweaver tool <subcommand> --help` for flag details"],
+});
 export async function runToolCommand(args) {
     const [subcommand, ...rest] = args;
     if (!subcommand || subcommand === "--help" || subcommand === "-h") {

package/dist/commands/toolbox.js

@@ -4,22 +4,38 @@ import { ensureValidToken, formatHttpError, with401RefreshRetry } from "../auth/
 import { createToolbox, deleteToolbox, exportConfig, importConfig, listToolboxes, setToolboxStatus, } from "../api/toolboxes.js";
 import { formatCallOutput } from "./call.js";
 import { resolveBusinessDomain } from "../config/store.js";
+import { renderHelp } from "../help/format.js";
 const VALID_IMPEX_TYPES = new Set(["toolbox", "mcp", "operator"]);
-const HELP = `kweaver toolbox
-
-Subcommands:
-  create --name <n> --service-url <url> [--description <d>]   Create a new toolbox
-  list [--keyword <s>] [--limit <n>] [--offset <n>]           List toolboxes
-  publish <box-id>                                            Publish a toolbox (status=published)
-  unpublish <box-id>                                          Unpublish (status=draft)
-  delete <box-id> [-y|--yes]                                  Delete a toolbox
-  export <box-id> [-o <file>|-] [--type toolbox|mcp|operator] Export toolbox config (.adp JSON)
-  import <file> [--type toolbox|mcp|operator]                 Import a previously exported config
-
-Options:
-  -bd, --biz-domain <s>   Business domain (default: bd_public)
-  --pretty                Pretty-print JSON (default)
-  --compact               Single-line JSON (pipeline-friendly)`;
+const HELP = renderHelp({
+    tagline: "Agent toolbox lifecycle — create, list, publish, delete, export/import",
+    usage: "kweaver toolbox <subcommand> [flags]",
+    sections: [
+        {
+            title: "AVAILABLE COMMANDS",
+            items: [
+                { name: "create", desc: "Create a new toolbox" },
+                { name: "list", desc: "List toolboxes" },
+                { name: "publish", desc: "Publish a toolbox (status=published)" },
+                { name: "unpublish", desc: "Unpublish (status=draft)" },
+                { name: "delete", desc: "Delete a toolbox" },
+                { name: "export", desc: "Export toolbox config (.adp JSON)" },
+                { name: "import", desc: "Import a previously exported config" },
+            ],
+        },
+    ],
+    flags: [
+        { name: "-bd, --biz-domain <s>", desc: "Business domain (default: bd_public)" },
+        { name: "--pretty", desc: "Pretty-print JSON (default)" },
+        { name: "--compact", desc: "Single-line JSON (pipeline-friendly)" },
+    ],
+    inheritedFlags: "--base-url, --token, --user, --help",
+    examples: [
+        "kweaver toolbox create --name MyBox --service-url https://svc.example.com",
+        "kweaver toolbox list --keyword analytics",
+        "kweaver toolbox export <box-id> -o box.adp",
+    ],
+    learnMore: ["Use `kweaver toolbox <subcommand> --help` for flag details"],
+});
 export async function runToolboxCommand(args) {
     const [subcommand, ...rest] = args;
     if (!subcommand || subcommand === "--help" || subcommand === "-h") {