@thinkingai/ae-cli 6.1.9 → 6.1.11

package/README.md

@@ -29,6 +29,14 @@ npx -y skills add ThinkingAIAgenticEngine/ae-cli -g -y
 
 The Skills teach supported coding Agents, including Claude Code, Codex, Cursor, and similar tools, how to discover and call `ae-cli`.
 
+Install optional, approved scenario Skills with an interactive category picker:
+
+```bash
+npx skills@latest add ThinkingAIAgenticEngine/scenario-skills
+```
+
+See the [scenario-skills repository](https://github.com/ThinkingAIAgenticEngine/scenario-skills) for version-specific and non-interactive installation.
+
 Log in to an AE environment:
 
 ```bash
@@ -36,6 +44,8 @@ ae-cli auth login --host https://your-ae-host.example.com
 ae-cli auth status
 ```
 
+Use the AE URL supplied by your AgenticEngine administrator. If no Host is configured, `ae-cli` guides existing customers to obtain that URL first. Only users without an AgenticEngine environment are directed to [request a trial](https://thinkingai.cn/request-demo).
+
 ## Environment-Bound Updates
 
 Each AE environment returns the exact `aeCliVersion` it expects. Use the unified update command to install that CLI version and its matching Skills:
@@ -65,10 +75,15 @@ ae-cli --no-update-check capability list --domain analysis
 ## Quick Start
 
 ```bash
-# List and switch configured environments
+# Open the interactive environment manager
+ae-cli config
+
+# Or manage environments non-interactively
 ae-cli config list
+ae-cli --format table config list
 ae-cli config current
-ae-cli config use https://your-ae-host.example.com
+ae-cli config add https://your-ae-host.example.com --label production --use
+ae-cli config use production
 
 # Discover capabilities exposed by the host
 ae-cli capability list --domain analysis
@@ -134,6 +149,8 @@ Gateway-backed features follow the [Capability command admission rules](docs/cap
 ## Authentication and Environments
 
 Credentials are stored per host. Switching environments does not reuse a token from another host.
+Run `ae-cli config` in a terminal to add, activate, rename, or remove environments interactively.
+For scripts and agents, use the non-interactive subcommands:
 
 ```bash
 ae-cli auth login --host https://host-a.example.com
@@ -142,11 +159,16 @@ ae-cli auth logout --host https://host-a.example.com
 
 ae-cli config list
 ae-cli config current
-ae-cli config set-host https://host-b.example.com --label staging
+ae-cli config add https://host-b.example.com --label staging
 ae-cli config use staging
+ae-cli config rename staging pre-production
+ae-cli config remove pre-production --yes
 ```
 
+`<env>` accepts either an exact URL or a unique label. The active environment is clearly marked in the interactive manager and in `config list`. Removing an active environment is rejected while other environments remain; switch first so replacement is explicit. `config set-host` remains available as a compatibility command that adds or updates a host and activates it.
+
 Login uses a cross-platform device-code flow. Use `--no-browser` when the environment cannot open a browser.
+Trial guidance is emitted only when no Host is configured; normal commands and authentication flows for configured environments do not display it.
 
 ## Output and Safety
 

package/README.zh.md

@@ -29,6 +29,14 @@ npx -y skills add ThinkingAIAgenticEngine/ae-cli -g -y
 
 Skills 会帮助 Claude Code、Codex、Cursor 等编码 Agent 理解、发现并调用 `ae-cli`。
 
+按业务分类交互安装可选的已准出场景 Skill：
+
+```bash
+npx skills@latest add ThinkingAIAgenticEngine/scenario-skills
+```
+
+指定版本或非交互安装方式请查看 [scenario-skills 仓库](https://github.com/ThinkingAIAgenticEngine/scenario-skills)。
+
 登录 AE 环境：
 
 ```bash
@@ -36,6 +44,8 @@ ae-cli auth login --host https://your-ae-host.example.com
 ae-cli auth status
 ```
 
+请使用 AgenticEngine 管理员提供的 AE 地址。未配置 Host 时，`ae-cli` 会先引导已有客户向管理员获取地址；只有确认尚无 AgenticEngine 环境的用户，才会看到[申请试用](https://thinkingai.cn/request-demo)入口。
+
 ## 环境版本同步
 
 每个 AE 环境都会返回其要求的精确 `aeCliVersion`。使用统一更新命令安装对应版本的 CLI 和 Skills：
@@ -65,10 +75,15 @@ ae-cli --no-update-check capability list --domain analysis
 ## 快速开始
 
 ```bash
-# 查看和切换环境
+# 打开交互式环境管理器
+ae-cli config
+
+# 或使用非交互命令管理环境
 ae-cli config list
+ae-cli --format table config list
 ae-cli config current
-ae-cli config use https://your-ae-host.example.com
+ae-cli config add https://your-ae-host.example.com --label production --use
+ae-cli config use production
 
 # 发现当前 Host 暴露的能力
 ae-cli capability list --domain analysis
@@ -134,6 +149,8 @@ Gateway 命令遵循 [Capability 命令收录规则](docs/capability-command-adm
 ## 认证与多环境
 
 凭证按 Host 独立存储，切换环境不会复用其他 Host 的 token。
+在终端运行 `ae-cli config`，可以交互式添加、激活、重命名或删除环境。
+脚本和 Agent 应使用非交互子命令：
 
 ```bash
 ae-cli auth login --host https://host-a.example.com
@@ -142,11 +159,16 @@ ae-cli auth logout --host https://host-a.example.com
 
 ae-cli config list
 ae-cli config current
-ae-cli config set-host https://host-b.example.com --label staging
+ae-cli config add https://host-b.example.com --label staging
 ae-cli config use staging
+ae-cli config rename staging pre-production
+ae-cli config remove pre-production --yes
 ```
 
+`<env>` 可以是完整 URL 或唯一 label。交互管理器和 `config list` 都会明确标识 active 环境。当还存在其他环境时，不允许直接删除 active 环境；应先显式切换。`config set-host` 作为兼容命令继续保留，其语义是添加或更新 Host 并立即激活。
+
 登录使用跨平台设备码流程。当前环境无法打开浏览器时，可使用 `--no-browser`。
+试用引导仅在尚未配置 Host 时出现；已配置环境的正常命令和认证流程不会展示该提示。
 
 ## 输出与安全
 

package/dist/{auth-56Z45UVR.js → auth-GDV3H5I4.js}

@@ -5,27 +5,29 @@ import {
   printError,
   printOutput,
   runHostCompatCheck
-} from "./chunk-KTYR3U6D.js";
+} from "./chunk-YTG6Q75E.js";
 import {
   clearCliToken,
   mintCliToken
-} from "./chunk-E7UXXHO3.js";
+} from "./chunk-Z3OXWCIA.js";
 import {
   clear,
   load,
+  missingAeHostGuidance,
+  missingAeHostHint,
   resolveHost,
   save
-} from "./chunk-IR4ZLVPW.js";
+} from "./chunk-YV52FB5G.js";
 import {
   getFallbackCliToken,
   loadConfig,
   normalizeUrl,
   removeHost,
   saveConfig
-} from "./chunk-V6FR6WTW.js";
+} from "./chunk-GJJA4CQZ.js";
 import {
   logger
-} from "./chunk-LYVNONC4.js";
+} from "./chunk-JHENBQ5B.js";
 
 // src/core/device-auth.ts
 import { execFileSync } from "child_process";
@@ -283,7 +285,7 @@ function registerAuth(program) {
     const explicitHost = getExplicitAuthHostOverride(program, opts);
     const host = resolveAuthHost(program, opts);
     if (!host) {
-      printError("config", "No AE host configured.", "Run: ae-cli config set-host <url>");
+      printError("config", "No AE host configured.", missingAeHostHint());
       process.exit(1);
     }
     const config = loadConfig();
@@ -349,7 +351,15 @@ function registerAuth(program) {
   auth.command("status").description("Show authentication status for a host (--host or active host)").option("--host <url>", HOST_OPTION_DESC).action(async (opts) => {
     const host = resolveAuthHost(program, opts);
     if (!host) {
-      await printOutput({ authenticated: false, host: "(none)", hint: "Run: ae-cli config set-host <url>" }, program.opts().format || "json");
+      await printOutput(
+        {
+          authenticated: false,
+          host: "(none)",
+          hint: missingAeHostHint(),
+          next_steps: missingAeHostGuidance()
+        },
+        program.opts().format || "json"
+      );
       return;
     }
     const secureEntry = load(host);
@@ -388,7 +398,7 @@ function registerAuth(program) {
   auth.command("logout").description("Clear stored credentials (access token, CLI token, and host config) for a host (--host or active host)").option("--host <url>", HOST_OPTION_DESC).action(async (opts) => {
     const host = resolveAuthHost(program, opts);
     if (!host) {
-      printError("config", "No AE host configured.", "Run: ae-cli config set-host <url>");
+      printError("config", "No AE host configured.", missingAeHostHint());
       process.exit(1);
     }
     clearCliToken(host);

package/dist/{auth-ENM3FE6L.js → auth-NN55553T.js}

@@ -3,9 +3,9 @@ import {
   invalidateAccessTokenForRetry,
   resolveHost,
   validateToken
-} from "./chunk-IR4ZLVPW.js";
-import "./chunk-V6FR6WTW.js";
-import "./chunk-LYVNONC4.js";
+} from "./chunk-YV52FB5G.js";
+import "./chunk-GJJA4CQZ.js";
+import "./chunk-JHENBQ5B.js";
 export {
   getToken,
   invalidateAccessTokenForRetry,

package/dist/{capability-2H6PAOA3.js → capability-TPORIKRQ.js}

@@ -3,8 +3,13 @@ import {
   requiresConfirmation
 } from "./chunk-OO6XR6LK.js";
 import {
-  findGatewayDomain
+  findGatewayDomain,
+  resolveGatewayDomain
 } from "./chunk-PTE56QPL.js";
+import {
+  printError,
+  printOutput
+} from "./chunk-YTG6Q75E.js";
 import {
   CapabilityGatewayError,
   dryRunCapability,
@@ -12,23 +17,19 @@ import {
   inspectCapability,
   listCapabilities,
   validateCapability
-} from "./chunk-RGXCNC4N.js";
-import {
-  printError,
-  printOutput
-} from "./chunk-KTYR3U6D.js";
-import "./chunk-E7UXXHO3.js";
+} from "./chunk-RBNKI5ZW.js";
+import "./chunk-Z3OXWCIA.js";
 import {
   SecureStoreAuthError,
   resolveHost
-} from "./chunk-IR4ZLVPW.js";
+} from "./chunk-YV52FB5G.js";
 import {
   safeJsonParse
-} from "./chunk-V6FR6WTW.js";
+} from "./chunk-GJJA4CQZ.js";
 import {
   PermissionError
-} from "./chunk-24BAVOX3.js";
-import "./chunk-LYVNONC4.js";
+} from "./chunk-AXDXJTPC.js";
+import "./chunk-JHENBQ5B.js";
 
 // src/commands/capability/index.ts
 import * as readline from "readline";
@@ -48,13 +49,16 @@ function capabilityNamespace(capabilityId) {
 }
 function resolveCapabilityGatewayDomain(capabilityId, domainOverride) {
   const cliDomain = domainOverride?.trim() || capabilityNamespace(capabilityId);
+  return resolveCapabilityListDomain(cliDomain);
+}
+function resolveCapabilityListDomain(cliDomain) {
   if (!cliDomain) {
     throw new CapabilityCommandValidationError(
       "Cannot determine the capability domain.",
       "Pass --domain <domain>."
     );
   }
-  return findGatewayDomain(cliDomain) ?? cliDomain;
+  return resolveGatewayDomain(cliDomain, findGatewayDomain(cliDomain) ?? cliDomain);
 }
 function parseOptionalProjectId(raw) {
   if (raw === void 0) {
@@ -137,7 +141,7 @@ function registerCapability(program) {
   });
   capability.command("list").description("List capability summaries in a domain").requiredOption("--domain <domain>", "Capability namespace, such as analysis or metadata").option("--project-id <project-id>", "Filter by project membership, permissions, and enabled features").action(async (opts) => {
     await executeAndPrint(program, async (host) => {
-      const gatewayDomain = findGatewayDomain(opts.domain) ?? opts.domain;
+      const gatewayDomain = resolveCapabilityListDomain(opts.domain);
       const projectId = parseOptionalProjectId(opts.projectId);
       const catalog = normalizeCapabilityList(await listCapabilities(host, gatewayDomain, projectId));
       const capabilities = filterCapabilities(catalog, opts.domain);
@@ -149,7 +153,7 @@ function registerCapability(program) {
   );
   capability.command("search").description("Search capability IDs and descriptions in a domain").argument("<query>", "Case-insensitive search terms").requiredOption("--domain <domain>", "Capability namespace, such as analysis or metadata").option("--project-id <project-id>", "Filter by project membership, permissions, and enabled features").action(async (query, opts) => {
     await executeAndPrint(program, async (host) => {
-      const gatewayDomain = findGatewayDomain(opts.domain) ?? opts.domain;
+      const gatewayDomain = resolveCapabilityListDomain(opts.domain);
       const projectId = parseOptionalProjectId(opts.projectId);
       const catalog = normalizeCapabilityList(await listCapabilities(host, gatewayDomain, projectId));
       const capabilities = filterCapabilities(catalog, opts.domain, query);
@@ -274,7 +278,7 @@ function printCapabilityError(error) {
     return;
   }
   if (error instanceof PermissionError) {
-    printError("permission", error.message);
+    printError("permission", error.message, void 0, error.code);
     return;
   }
   if (error instanceof CapabilityGatewayError) {

package/dist/{capability-YPOQX6PL.js → capability-VQNC5CF7.js}

@@ -3,8 +3,13 @@ import {
   requiresConfirmation
 } from "./chunk-OO6XR6LK.js";
 import {
-  findGatewayDomain
+  findGatewayDomain,
+  resolveGatewayDomain
 } from "./chunk-PTE56QPL.js";
+import {
+  printError,
+  printOutput
+} from "./chunk-YTG6Q75E.js";
 import {
   CapabilityGatewayError,
   dryRunCapability,
@@ -12,23 +17,19 @@ import {
   inspectCapability,
   listCapabilities,
   validateCapability
-} from "./chunk-HQ2A7ITL.js";
-import {
-  printError,
-  printOutput
-} from "./chunk-KTYR3U6D.js";
-import "./chunk-E7UXXHO3.js";
+} from "./chunk-GS2P7LFD.js";
+import "./chunk-Z3OXWCIA.js";
 import {
   SecureStoreAuthError,
   resolveHost
-} from "./chunk-IR4ZLVPW.js";
+} from "./chunk-YV52FB5G.js";
 import {
   safeJsonParse
-} from "./chunk-V6FR6WTW.js";
+} from "./chunk-GJJA4CQZ.js";
 import {
   PermissionError
-} from "./chunk-24BAVOX3.js";
-import "./chunk-LYVNONC4.js";
+} from "./chunk-AXDXJTPC.js";
+import "./chunk-JHENBQ5B.js";
 
 // src/commands/capability/index.ts
 import * as readline from "readline";
@@ -48,13 +49,16 @@ function capabilityNamespace(capabilityId) {
 }
 function resolveCapabilityGatewayDomain(capabilityId, domainOverride) {
   const cliDomain = domainOverride?.trim() || capabilityNamespace(capabilityId);
+  return resolveCapabilityListDomain(cliDomain);
+}
+function resolveCapabilityListDomain(cliDomain) {
   if (!cliDomain) {
     throw new CapabilityCommandValidationError(
       "Cannot determine the capability domain.",
       "Pass --domain <domain>."
     );
   }
-  return findGatewayDomain(cliDomain) ?? cliDomain;
+  return resolveGatewayDomain(cliDomain, findGatewayDomain(cliDomain) ?? cliDomain);
 }
 function parseOptionalProjectId(raw) {
   if (raw === void 0) {
@@ -137,7 +141,7 @@ function registerCapability(program) {
   });
   capability.command("list").description("List capability summaries in a domain").requiredOption("--domain <domain>", "Capability namespace, such as analysis or metadata").option("--project-id <project-id>", "Filter by project membership, permissions, and enabled features").action(async (opts) => {
     await executeAndPrint(program, async (host) => {
-      const gatewayDomain = findGatewayDomain(opts.domain) ?? opts.domain;
+      const gatewayDomain = resolveCapabilityListDomain(opts.domain);
       const projectId = parseOptionalProjectId(opts.projectId);
       const catalog = normalizeCapabilityList(await listCapabilities(host, gatewayDomain, projectId));
       const capabilities = filterCapabilities(catalog, opts.domain);
@@ -149,7 +153,7 @@ function registerCapability(program) {
   );
   capability.command("search").description("Search capability IDs and descriptions in a domain").argument("<query>", "Case-insensitive search terms").requiredOption("--domain <domain>", "Capability namespace, such as analysis or metadata").option("--project-id <project-id>", "Filter by project membership, permissions, and enabled features").action(async (query, opts) => {
     await executeAndPrint(program, async (host) => {
-      const gatewayDomain = findGatewayDomain(opts.domain) ?? opts.domain;
+      const gatewayDomain = resolveCapabilityListDomain(opts.domain);
       const projectId = parseOptionalProjectId(opts.projectId);
       const catalog = normalizeCapabilityList(await listCapabilities(host, gatewayDomain, projectId));
       const capabilities = filterCapabilities(catalog, opts.domain, query);
@@ -274,7 +278,7 @@ function printCapabilityError(error) {
     return;
   }
   if (error instanceof PermissionError) {
-    printError("permission", error.message);
+    printError("permission", error.message, void 0, error.code);
     return;
   }
   if (error instanceof CapabilityGatewayError) {

package/dist/chunk-4NN5IWVN.js

@@ -0,0 +1,26 @@
+// src/commands/te-agent/skill-version.ts
+var SKILL_VERSION_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+var MAX_VERSION_PART = 2147483647;
+var MAX_SKILL_MD_BYTES = 1048576;
+function assertValidSkillVersion(version) {
+  const match = SKILL_VERSION_PATTERN.exec(version);
+  if (!match) {
+    throw new Error("--version must use major.minor format without leading zeroes");
+  }
+  const major = Number(match[1]);
+  const minor = Number(match[2]);
+  if (major > MAX_VERSION_PART || minor > MAX_VERSION_PART) {
+    throw new Error(`--version major and minor must not exceed ${MAX_VERSION_PART}`);
+  }
+}
+function assertSkillDocumentSize(content) {
+  const size = typeof content === "string" ? Buffer.byteLength(content, "utf8") : content.byteLength;
+  if (size > MAX_SKILL_MD_BYTES) {
+    throw new Error("SKILL.md must not exceed 1 MB");
+  }
+}
+
+export {
+  assertValidSkillVersion,
+  assertSkillDocumentSize
+};

package/dist/{chunk-DB4Q3ANU.js → chunk-6A2FUCIS.js}

@@ -3,13 +3,13 @@ import {
   getToken,
   invalidateAccessTokenForRetry,
   resolveHost
-} from "./chunk-IR4ZLVPW.js";
+} from "./chunk-YV52FB5G.js";
 import {
   safeJsonParse
-} from "./chunk-V6FR6WTW.js";
+} from "./chunk-GJJA4CQZ.js";
 import {
   logger
-} from "./chunk-LYVNONC4.js";
+} from "./chunk-JHENBQ5B.js";
 
 // src/core/client.ts
 import WebSocket from "ws";

package/dist/{chunk-PVBYJWC2.js → chunk-7KQWSBSL.js}

@@ -1,14 +1,14 @@
 import {
   resolveGatewayDomain
 } from "./chunk-PTE56QPL.js";
+import {
+  withOutputMetadata
+} from "./chunk-YTG6Q75E.js";
 import {
   dryRunCapability,
   executeCapabilityWithEnvelope,
   validateCapability
-} from "./chunk-HQ2A7ITL.js";
-import {
-  withOutputMetadata
-} from "./chunk-KTYR3U6D.js";
+} from "./chunk-RBNKI5ZW.js";
 
 // src/core/capability-command.ts
 import { randomBytes } from "crypto";

package/dist/{chunk-24BAVOX3.js → chunk-AXDXJTPC.js}

@@ -1,9 +1,11 @@
 // src/core/errors.ts
 var PermissionError = class extends Error {
-  constructor(message) {
+  constructor(message, code) {
     super(message);
+    this.code = code;
     this.name = "PermissionError";
   }
+  code;
 };
 var CliValidationError = class extends Error {
   code;

package/dist/{chunk-CPVTECJ3.js → chunk-DT6Y3TD7.js}

@@ -1,20 +1,20 @@
 import {
   getAnalysisMappingPathForClusterMode
-} from "./chunk-LCXU3AAT.js";
+} from "./chunk-NBPKWKRA.js";
 import {
   clearCliToken,
   getCliToken
-} from "./chunk-E7UXXHO3.js";
+} from "./chunk-Z3OXWCIA.js";
 import {
   getActiveHost,
   safeJsonParse
-} from "./chunk-V6FR6WTW.js";
+} from "./chunk-GJJA4CQZ.js";
 import {
   PermissionError
-} from "./chunk-24BAVOX3.js";
+} from "./chunk-AXDXJTPC.js";
 import {
   logger
-} from "./chunk-LYVNONC4.js";
+} from "./chunk-JHENBQ5B.js";
 
 // src/core/mcp.ts
 async function permissionMessage(resp) {