@thinkingai/ae-cli 6.1.17 → 6.1.19

package/README.md

@@ -20,6 +20,8 @@ The CLI is designed around:
 
 ## Installation
 
+For setup through Codex, Claude Code, Cursor, or another terminal-capable AI Agent, see the [AE CLI installation and upgrade guide](./cli-installation-guide.md).
+
 Install the public CLI and Agent Skills:
 
 ```bash

package/README.zh.md

@@ -20,6 +20,12 @@ CLI 的核心设计包括：
 
 ## 安装
 
+如果你希望由 Codex、Claude Code、Cursor 等 AI Agent 自动检查 Node.js、安装 CLI、完成登录并同步匹配版本，请让 Agent 阅读并执行 [AE CLI Installation and Upgrade](./cli-installation-guide.md)。
+
+可直接复制给 Agent，并把 `<AE_HOST>` 替换为你的 AE 地址：
+
+> 请阅读 https://raw.githubusercontent.com/ThinkingAIAgenticEngine/ae-cli/main/cli-installation-guide.md 并按说明帮我安装或升级 AE CLI。我的 AE 地址是 `<AE_HOST>`。只安装 AE CLI 和配套 Skills，不要修改当前项目；遇到登录授权或需要管理员权限时请暂停并提示我。
+
 安装公开版 CLI 和 Agent Skills：
 
 ```bash

package/dist/{auth-77BUFLGC.js → auth-QPEVVBKT.js}

@@ -1,37 +1,39 @@
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   getLocalCliPackageInfo
-} from "./chunk-VTWMIC5L.js";
+} from "./chunk-E2JKXMVO.js";
 import {
   printError,
   printOutput,
   runHostCompatCheck
-} from "./chunk-GT46FPXN.js";
+} from "./chunk-KEWVSO64.js";
 import {
+  CliTokenValidationUnavailableError,
   clearCliToken,
   mintCliToken,
   validateCliTokenOnServer
-} from "./chunk-4SGZG4XY.js";
+} from "./chunk-RWXIXOZG.js";
 import {
   SecureStoreAuthError,
   clear,
-  getFallbackCliToken,
   load,
-  loadConfig,
   missingAeHostGuidance,
   missingAeHostHint,
-  normalizeUrl,
-  removeHost,
   resolveHost,
-  save,
+  save
+} from "./chunk-O6K2ODUE.js";
+import {
+  getFallbackCliToken,
+  loadConfig,
+  normalizeUrl,
   saveConfig
-} from "./chunk-ZZUOD757.js";
+} from "./chunk-KZ6ZHF5J.js";
 import {
   PermissionError
-} from "./chunk-UW5UN47B.js";
+} from "./chunk-533JK3YX.js";
 import {
   logger
-} from "./chunk-LYVNONC4.js";
-import "./chunk-QGM4M3NI.js";
+} from "./chunk-FR2EDAQM.js";
 
 // src/core/device-auth.ts
 import { execFileSync } from "child_process";
@@ -264,6 +266,10 @@ async function validateExistingCliToken(host, cliToken) {
     await validateCliTokenOnServer(host, cliToken);
     return true;
   } catch (error) {
+    if (error instanceof CliTokenValidationUnavailableError) {
+      logger.warn(`auth status: ${error.message}; trusting the stored CLI token for compatibility`);
+      return true;
+    }
     if (!(error instanceof SecureStoreAuthError)) {
       throw error;
     }
@@ -439,7 +445,7 @@ function registerAuth(program) {
     }
     await printOutput({ authenticated: false, host, source: "none" }, program.opts().format || "json");
   });
-  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) => {
+  auth.command("logout").description("Clear stored credentials (access token, refresh token, and CLI token) 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.", missingAeHostHint());
@@ -447,8 +453,7 @@ function registerAuth(program) {
     }
     clearCliToken(host);
     clear(host);
-    removeHost(host);
-    process.stderr.write(`[ae-cli] Credentials and config cleared for ${host}
+    process.stderr.write(`[ae-cli] Credentials cleared for ${host}
 `);
     await printOutput({ cleared: true, host }, program.opts().format || "json");
   });

package/dist/auth-UMJAA72O.js

@@ -0,0 +1,15 @@
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
+import {
+  getToken,
+  invalidateAccessTokenForRetry,
+  resolveHost,
+  validateToken
+} from "./chunk-O6K2ODUE.js";
+import "./chunk-KZ6ZHF5J.js";
+import "./chunk-FR2EDAQM.js";
+export {
+  getToken,
+  invalidateAccessTokenForRetry,
+  resolveHost,
+  validateToken
+};

package/dist/{capability-72DTW5M2.js → capability-ASI62I4A.js}

@@ -1,15 +1,17 @@
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   normalizeRiskLevel,
   requiresConfirmation
-} from "./chunk-OO6XR6LK.js";
+} from "./chunk-AMBFK2K3.js";
 import {
   findGatewayDomain,
+  listRegisteredCapabilityDomains,
   resolveGatewayDomain
-} from "./chunk-PTE56QPL.js";
+} from "./chunk-TKHSULJT.js";
 import {
   printError,
   printOutput
-} from "./chunk-GT46FPXN.js";
+} from "./chunk-KEWVSO64.js";
 import {
   CapabilityGatewayError,
   dryRunCapability,
@@ -17,19 +19,20 @@ import {
   inspectCapability,
   listCapabilities,
   validateCapability
-} from "./chunk-P3FGXJTU.js";
-import "./chunk-C4MGVGJW.js";
-import "./chunk-4SGZG4XY.js";
+} from "./chunk-GJXRF7Y6.js";
+import "./chunk-Y74WTIKJ.js";
+import "./chunk-RWXIXOZG.js";
 import {
   SecureStoreAuthError,
-  resolveHost,
+  resolveHost
+} from "./chunk-O6K2ODUE.js";
+import {
   safeJsonParse
-} from "./chunk-ZZUOD757.js";
+} from "./chunk-KZ6ZHF5J.js";
 import {
   PermissionError
-} from "./chunk-UW5UN47B.js";
-import "./chunk-LYVNONC4.js";
-import "./chunk-QGM4M3NI.js";
+} from "./chunk-533JK3YX.js";
+import "./chunk-FR2EDAQM.js";
 
 // src/commands/capability/index.ts
 import * as readline from "readline";
@@ -51,7 +54,13 @@ function capabilityNamespace(capabilityId) {
 }
 function resolveCapabilityGatewayDomain(capabilityId, domainOverride) {
   const cliDomain = domainOverride?.trim() || capabilityNamespace(capabilityId);
-  return resolveCapabilityListDomain(cliDomain);
+  if (!cliDomain) {
+    throw new CapabilityCommandValidationError(
+      "Cannot determine the capability domain.",
+      "Pass --domain <domain>."
+    );
+  }
+  return resolveGatewayDomain(cliDomain, findGatewayDomain(cliDomain) ?? cliDomain);
 }
 function resolveCapabilityListDomain(cliDomain) {
   if (!cliDomain) {
@@ -60,7 +69,23 @@ function resolveCapabilityListDomain(cliDomain) {
       "Pass --domain <domain>."
     );
   }
-  return resolveGatewayDomain(cliDomain, findGatewayDomain(cliDomain) ?? cliDomain);
+  const gatewayDomain = findGatewayDomain(cliDomain);
+  if (gatewayDomain === void 0) {
+    const registeredDomains = listRegisteredCapabilityDomains();
+    const registeredHint = registeredDomains.length > 0 ? `Registered domains: ${registeredDomains.join(", ")}.` : "No capability domains are registered in this ae-cli process.";
+    throw new CapabilityCommandValidationError(
+      `Capability domain '${cliDomain}' is not registered.`,
+      `${registeredHint} Do not guess domain names.`,
+      "CAPABILITY_DOMAIN_NOT_REGISTERED"
+    );
+  }
+  return resolveGatewayDomain(cliDomain, gatewayDomain);
+}
+function emptyCapabilityCatalogWarning(capabilities) {
+  if (capabilities.length > 0) {
+    return void 0;
+  }
+  return "No capabilities were returned. This does not prove that the project permission is missing. Stop discovery instead of guessing other domains or retrying. If capabilities are expected, verify the capability deployment, enabled features, and permissions.";
 }
 function parseOptionalProjectId(raw) {
   if (raw === void 0) {
@@ -155,7 +180,13 @@ function registerCapability(program) {
       const projectId = parseOptionalProjectId(opts.projectId);
       const catalog = normalizeCapabilityList(await listCapabilities(host, gatewayDomain, projectId));
       const capabilities = filterCapabilities(catalog, opts.domain);
-      return { domain: opts.domain, count: capabilities.length, capabilities };
+      const warning = emptyCapabilityCatalogWarning(catalog);
+      return {
+        domain: opts.domain,
+        count: capabilities.length,
+        capabilities,
+        ...warning ? { warning } : {}
+      };
     });
   }).addHelpText(
     "after",
@@ -170,7 +201,14 @@ function registerCapability(program) {
       const projectId = parseOptionalProjectId(opts.projectId);
       const catalog = normalizeCapabilityList(await listCapabilities(host, gatewayDomain, projectId));
       const capabilities = filterCapabilities(catalog, opts.domain, query);
-      return { domain: opts.domain, query, count: capabilities.length, capabilities };
+      const warning = emptyCapabilityCatalogWarning(catalog);
+      return {
+        domain: opts.domain,
+        query,
+        count: capabilities.length,
+        capabilities,
+        ...warning ? { warning } : {}
+      };
     });
   }).addHelpText(
     "after",

package/dist/{chunk-UW5UN47B.js → chunk-533JK3YX.js}

@@ -1,3 +1,5 @@
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
+
 // src/core/errors.ts
 var PermissionError = class extends Error {
   constructor(message, code, hint) {

package/dist/{chunk-UOUS37JQ.js → chunk-6QK7SYYY.js}

@@ -1,17 +1,18 @@
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   internalCallSourceHeaders
-} from "./chunk-C4MGVGJW.js";
+} from "./chunk-Y74WTIKJ.js";
 import {
   clearCliToken,
   getCliToken
-} from "./chunk-4SGZG4XY.js";
+} from "./chunk-RWXIXOZG.js";
 import {
   getActiveHost,
   getSandboxRuntimeRoot
-} from "./chunk-ZZUOD757.js";
+} from "./chunk-KZ6ZHF5J.js";
 import {
   PermissionError
-} from "./chunk-UW5UN47B.js";
+} from "./chunk-533JK3YX.js";
 
 // src/core/te-agent-credentials.ts
 import { readFileSync } from "fs";

package/dist/{chunk-TUKQZTMI.js → chunk-7K24F7T2.js}

@@ -1,3 +1,5 @@
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
+
 // src/core/multiselect.ts
 var MultiselectCancelled = class extends Error {
   constructor() {

package/dist/{chunk-OO6XR6LK.js → chunk-AMBFK2K3.js}

@@ -1,3 +1,5 @@
+import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
+
 // src/core/capability-risk.ts
 var HIGH_RISK_LEVELS = /* @__PURE__ */ new Set(["high-risk-write"]);
 function normalizeRiskLevel(risk) {