@thinkingai/ae-cli 1.0.27 → 1.0.30

package/dist/{te-analysis-CMXADIJM.js → te-analysis-CB3DA5I5.js}

@@ -2,10 +2,14 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-GLNZSDKO.js";
+import {
+  isGlobalQueryModeEnabled
+} from "./chunk-GSJGPNKK.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-U6TKB3IV.js";
+import "./chunk-JM34JPCO.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-analysis/shared.ts
 function createMcpCommand(config) {
@@ -56,6 +60,24 @@ function optionalJsonString(ctx, name) {
 function requiredJsonString(ctx, name) {
   return JSON.stringify(ctx.json(name));
 }
+function clusterQueryFlags(scopeDesc) {
+  if (!isGlobalQueryModeEnabled()) {
+    return [];
+  }
+  return [
+    { name: "cluster_query_scope", type: "string", required: false, desc: scopeDesc },
+    { name: "slave_cluster_id", type: "string", required: false, desc: "Slave cluster ID. Required when cluster_query_scope=SLAVE. Use +list_query_clusters first to choose this value." }
+  ];
+}
+function optionalClusterQueryArgs(ctx) {
+  if (!isGlobalQueryModeEnabled()) {
+    return {};
+  }
+  return {
+    clusterQueryScope: optionalString(ctx, "cluster_query_scope"),
+    slaveClusterId: optionalString(ctx, "slave_cluster_id")
+  };
+}
 var DEFAULT_QUERY_LIMIT = 1e3;
 var MAX_QUERY_LIMIT = 1e5;
 function assertLimitWithinCap(value, flagName) {
@@ -249,7 +271,8 @@ var queryReportData = createMcpCommand({
     { name: "start_date", type: "string", required: false, desc: "Optional start date in yyyy-MM-dd format" },
     { name: "end_date", type: "string", required: false, desc: "Optional end date in yyyy-MM-dd format" },
     { name: "time_granularity", type: "string", required: false, desc: "Optional time granularity used to override the report default. Supported values: minute, minute5, minute10, hour, day, week, month, quarter, year, total." },
-    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
+    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." },
+    ...clusterQueryFlags("Optional cluster query scope. Supported values: GLOBAL, SLAVE. Omit to query the current self cluster.")
   ],
   risk: "read",
   buildArgs: (ctx) => ({
@@ -262,7 +285,8 @@ var queryReportData = createMcpCommand({
     startDate: optionalString(ctx, "start_date"),
     endDate: optionalString(ctx, "end_date"),
     timeGranularity: optionalString(ctx, "time_granularity"),
-    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes"),
+    ...optionalClusterQueryArgs(ctx)
   })
 });
 
@@ -350,7 +374,8 @@ var queryDashboardReportData = createMcpCommand({
     { name: "end_date", type: "string", required: false, desc: "Optional end date in yyyy-MM-dd format" },
     { name: "time_granularity", type: "string", required: false, desc: "Optional time granularity used to override the report default. Supported values: minute, minute5, minute10, hour, day, week, month, quarter, year, total." },
     { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true" },
-    { name: "report_ids", type: "json", required: false, desc: "Optional report IDs JSON array" }
+    { name: "report_ids", type: "json", required: false, desc: "Optional report IDs JSON array" },
+    ...clusterQueryFlags("Optional cluster query scope. Supported values: GLOBAL, SLAVE. Omit to follow dashboard configuration.")
   ],
   risk: "read",
   buildArgs: (ctx) => ({
@@ -361,7 +386,8 @@ var queryDashboardReportData = createMcpCommand({
     endDate: optionalString(ctx, "end_date"),
     timeGranularity: optionalString(ctx, "time_granularity"),
     useCache: optionalBoolean(ctx, "use_cache"),
-    reportIds: optionalJson(ctx, "report_ids")
+    reportIds: optionalJson(ctx, "report_ids"),
+    ...optionalClusterQueryArgs(ctx)
   })
 });
 
@@ -562,7 +588,8 @@ var queryAdhoc = createMcpCommand({
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Must match column names in result." },
     { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 1000, maximum: 100000. For model_type=sql, either omit LIMIT in the SQL or keep it equal to --limit (the two must not differ)." },
     { name: "offset", type: "number", required: false, desc: "Optional offset. Default: 0." },
-    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
+    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." },
+    ...clusterQueryFlags("Optional cluster query scope. Supported values: GLOBAL, SLAVE. Omit to query the current self cluster. SQL model analysis does not support this parameter.")
   ],
   risk: "read",
   validate: (ctx) => {
@@ -584,7 +611,8 @@ var queryAdhoc = createMcpCommand({
     fields: optionalJson(ctx, "fields"),
     limit: resolveSqlAwareLimit(optionalNumber(ctx, "limit"), ctx.str("model_type"), ctx.json("qp")),
     offset: optionalNumber(ctx, "offset"),
-    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes"),
+    ...optionalClusterQueryArgs(ctx)
   })
 });
 
@@ -1069,16 +1097,36 @@ var commands6 = [
 ];
 var schema_default = commands6;
 
-// src/commands/te-analysis/index.ts
+// src/commands/te-analysis/global/list-query-clusters.ts
+var listQueryClusters = createMcpCommand({
+  command: "+list_query_clusters",
+  description: "List query cluster options accessible to the current account in the project. Use this to decide whether to query the current self cluster, global aggregated data, or one specific slave cluster.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID used to resolve cluster query permissions", alias: "p" }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id")
+  })
+});
+
+// src/commands/te-analysis/global/index.ts
 var commands7 = [
+  listQueryClusters
+];
+var global_default = commands7;
+
+// src/commands/te-analysis/index.ts
+var commands8 = [
   ...meta_default,
   ...report_default,
   ...dashboard_default,
   ...model_default,
   ...entity_default,
-  ...schema_default
+  ...schema_default,
+  ...isGlobalQueryModeEnabled() ? global_default : []
 ];
-var te_analysis_default = commands7;
+var te_analysis_default = commands8;
 export {
   te_analysis_default as default
 };

package/dist/{te-audience-LPZFFSXM.js → te-audience-W7SCQFC7.js}

@@ -2,10 +2,12 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-GLNZSDKO.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-U6TKB3IV.js";
+import "./chunk-JM34JPCO.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-audience/shared.ts
 function createMcpCommand(config) {
@@ -59,7 +61,7 @@ function requiredJsonString(ctx, name) {
 // src/commands/te-audience/cluster/list-clusters.ts
 var listClusters = createMcpCommand({
   command: "+list_clusters",
-  description: "List cluster metadata with optional query/fields/limit/offset",
+  description: "List user cohort/segment cluster metadata with optional query/fields/limit/offset.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "query", type: "string", required: false, desc: "Keyword filter", alias: "q" },

package/dist/{te-common-BXQFKTB3.js → te-common-FBXVWBSI.js}

@@ -2,10 +2,12 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-GLNZSDKO.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-U6TKB3IV.js";
+import "./chunk-JM34JPCO.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-common/shared.ts
 function createMcpCommand(config) {
@@ -49,15 +51,25 @@ var commands = [
 var project_default = commands;
 
 // src/commands/te-common/resource/get-resource-url.ts
-function normalizeResourceUrlFields(node) {
+function normalizeResourceUrlFields(node, host) {
   if (!node || typeof node !== "object") return;
   const obj = node;
-  for (const value of Object.values(obj)) {
-    if (value && typeof value === "object") {
-      normalizeResourceUrlFields(value);
+  for (const [key, value] of Object.entries(obj)) {
+    if (typeof value === "string") {
+      if (/url|link/i.test(key) || value.includes("/#/")) {
+        obj[key] = absolutizeRelativeUrls(value, host);
+      }
+    } else if (value && typeof value === "object") {
+      normalizeResourceUrlFields(value, host);
     }
   }
 }
+function absolutizeRelativeUrls(s, host) {
+  const base = host.replace(/\/+$/, "");
+  s = s.replace(/\]\((\/(?!\/)[^)]*)\)/g, `](${base}$1)`);
+  if (/^\/(?!\/)/.test(s)) s = base + s;
+  return s;
+}
 var getResourceUrl = {
   service: "analysis_common",
   command: "+get_resource_url",
@@ -96,7 +108,7 @@ var getResourceUrl = {
     if (typeof parsed !== "object" || parsed === null) {
       return parsed;
     }
-    normalizeResourceUrlFields(parsed);
+    normalizeResourceUrlFields(parsed, ctx.host());
     return parsed;
   }
 };

package/dist/{te-community-K5S3VOZY.js → te-community-LNVDZSGW.js}

@@ -3,10 +3,12 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-GLNZSDKO.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-U6TKB3IV.js";
+import "./chunk-JM34JPCO.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-community/get_channel_info.ts
 var getChannelInfo = {

package/dist/{te-dataops-567IMCQG.js → te-dataops-IPCSSWYH.js}

@@ -3,10 +3,12 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-GLNZSDKO.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-U6TKB3IV.js";
+import "./chunk-JM34JPCO.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-dataops/datatable/list-tables-by-page.ts
 var listTablesByPage = {
@@ -1534,7 +1536,7 @@ var executeSql2 = {
     { name: "spaceCode", type: "string", required: true, desc: "Space code" },
     { name: "repoCode", type: "string", required: true, desc: "Repository code" },
     { name: "sql", type: "string", required: true, desc: "SQL statement" },
-    { name: "engineType", type: "string", required: true, desc: "SQL execution engine: TASK_ENGINE_TRINO(default, suitable for interactive queries), TASK_ENGINE_STARROCKS(suitable for real-time analytics and high-concurrency queries)" },
+    { name: "engineType", type: "string", required: false, default: "TASK_ENGINE_TRINO", desc: "SQL execution engine: TASK_ENGINE_TRINO(default, suitable for interactive queries), TASK_ENGINE_STARROCKS(suitable for real-time analytics and high-concurrency queries)" },
     { name: "confirmed", type: "boolean", required: true, desc: "Whether confirmed to execute. First call: omit or pass false for preview, then pass true to execute" }
   ],
   risk: "write",
@@ -1558,8 +1560,8 @@ var listCatalogs2 = {
   description: "Lists all catalogs and their schemas in the repository. Returns: catalogs(list containing catalogName and schemas sub-list). Requires repoCode (obtainable via ide_list_repos)",
   flags: [
     { name: "spaceCode", type: "string", required: true, desc: "Space code" },
-    { name: "connType", type: "string", required: true, desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
-    { name: "repoCode", type: "string", required: true, desc: "Repository code, defaults to te_etl if not provided" }
+    { name: "connType", type: "string", required: false, default: "SPACE", desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
+    { name: "repoCode", type: "string", required: false, default: "te_etl", desc: "Repository code, defaults to te_etl if not provided" }
   ],
   risk: "read",
   execute: async (ctx) => {
@@ -1580,8 +1582,8 @@ var getSchemaInfo = {
   description: "Gets schema statistics, including table count and view count. Returns: tableCount, viewCount",
   flags: [
     { name: "spaceCode", type: "string", required: true, desc: "Space code" },
-    { name: "connType", type: "string", required: true, desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
-    { name: "repoCode", type: "string", required: true, desc: "Repository code, defaults to te_etl if not provided" },
+    { name: "connType", type: "string", required: false, default: "SPACE", desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
+    { name: "repoCode", type: "string", required: false, default: "te_etl", desc: "Repository code, defaults to te_etl if not provided" },
     { name: "catalog", type: "string", required: true, desc: "Catalog name" },
     { name: "schema", type: "string", required: true, desc: "Schema name" }
   ],
@@ -1606,12 +1608,12 @@ var searchColumns = {
   description: "Fuzzy search column names across tables. Returns: columnName, columnType, tableName, catalogName, schemaName. Useful for finding which tables contain a specific field",
   flags: [
     { name: "spaceCode", type: "string", required: true, desc: "Space code" },
-    { name: "repoCode", type: "string", required: true, desc: "Repository code, defaults to te_etl if not provided" },
+    { name: "repoCode", type: "string", required: false, default: "te_etl", desc: "Repository code, defaults to te_etl if not provided" },
     { name: "searchKey", type: "string", required: true, desc: "Column name search keyword" },
     { name: "tables", type: "string", required: true, desc: "List of tables to search (JSON array format, each item contains catalog, schema, tableName fields)" },
-    { name: "engineType", type: "string", required: true, desc: "SQL execution engine: TASK_ENGINE_TRINO(default), TASK_ENGINE_STARROCKS" },
-    { name: "pageNum", type: "number", required: true, desc: "Page number, default 1" },
-    { name: "pageSize", type: "number", required: true, desc: "Page size, default 100" }
+    { name: "engineType", type: "string", required: false, default: "TASK_ENGINE_TRINO", desc: "SQL execution engine: TASK_ENGINE_TRINO(default), TASK_ENGINE_STARROCKS" },
+    { name: "pageNum", type: "number", required: false, default: 1, desc: "Page number, default 1" },
+    { name: "pageSize", type: "number", required: false, default: 100, desc: "Page size, default 100" }
   ],
   risk: "read",
   execute: async (ctx) => {
@@ -1636,12 +1638,12 @@ var getTableDetail2 = {
   description: "Gets real-time table metadata from the data warehouse engine, including column definitions, DDL, partition information. Returns: columns(name/type/comment), ddl, partitions, rowCount, dataSize. Difference from datatable_get_table_detail: This tool directly queries real-time metadata from the data warehouse engine, datatable queries dataops platform registered information(including data lineage). Difference from integration_get_table_structure: integration queries external data source metadata",
   flags: [
     { name: "spaceCode", type: "string", required: true, desc: "Space code" },
-    { name: "connType", type: "string", required: true, desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
-    { name: "repoCode", type: "string", required: true, desc: "Repository code, defaults to te_etl if not provided" },
+    { name: "connType", type: "string", required: false, default: "SPACE", desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
+    { name: "repoCode", type: "string", required: false, default: "te_etl", desc: "Repository code, defaults to te_etl if not provided" },
     { name: "catalog", type: "string", required: true, desc: "Catalog name" },
     { name: "schema", type: "string", required: true, desc: "Schema name" },
     { name: "tableName", type: "string", required: true, desc: "Table name" },
-    { name: "engineType", type: "string", required: true, desc: "SQL execution engine: TASK_ENGINE_TRINO(default), TASK_ENGINE_STARROCKS" },
+    { name: "engineType", type: "string", required: false, default: "TASK_ENGINE_TRINO", desc: "SQL execution engine: TASK_ENGINE_TRINO(default), TASK_ENGINE_STARROCKS" },
     { name: "isView", type: "boolean", required: true, desc: "Whether it is a view, auto-detect if not provided" }
   ],
   risk: "read",
@@ -1668,11 +1670,11 @@ var generateSql = {
   description: "Generates SELECT SQL statement based on table name and column names. Returns: Executable SELECT SQL string. Related tools: ide_execute_sql (execute the generated SQL)",
   flags: [
     { name: "spaceCode", type: "string", required: true, desc: "Space code" },
-    { name: "repoCode", type: "string", required: true, desc: "Repository code, defaults to te_etl if not provided" },
+    { name: "repoCode", type: "string", required: false, default: "te_etl", desc: "Repository code, defaults to te_etl if not provided" },
     { name: "catalog", type: "string", required: true, desc: "Catalog name" },
     { name: "schema", type: "string", required: true, desc: "Schema name" },
     { name: "tableName", type: "string", required: true, desc: "Table name" },
-    { name: "engineType", type: "string", required: true, desc: "SQL execution engine: TASK_ENGINE_TRINO(default), TASK_ENGINE_STARROCKS" },
+    { name: "engineType", type: "string", required: false, default: "TASK_ENGINE_TRINO", desc: "SQL execution engine: TASK_ENGINE_TRINO(default), TASK_ENGINE_STARROCKS" },
     { name: "selectColumns", type: "string", required: true, desc: "List of column names to query, queries all columns if not provided" }
   ],
   risk: "read",
@@ -1698,8 +1700,8 @@ var searchTables = {
   description: "Fuzzy search tables by keyword across catalog/schema. Returns: tableName, catalogName, schemaName, tableType. Difference from datatable_search_tables: This tool queries real-time metadata from the data warehouse engine, datatable queries dataops platform registered metadata(including business descriptions)",
   flags: [
     { name: "spaceCode", type: "string", required: true, desc: "Space code" },
-    { name: "connType", type: "string", required: true, desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
-    { name: "repoCode", type: "string", required: true, desc: "Repository code, defaults to te_etl if not provided" },
+    { name: "connType", type: "string", required: false, default: "SPACE", desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
+    { name: "repoCode", type: "string", required: false, default: "te_etl", desc: "Repository code, defaults to te_etl if not provided" },
     { name: "searchKey", type: "string", required: true, desc: "Search keyword" },
     { name: "size", type: "number", required: true, desc: "Maximum number of results to return" }
   ],
@@ -1742,13 +1744,13 @@ var listTables = {
   description: "Paginated list of tables/views under a schema. Returns: tableName, tableType. Defaults to physical tables, set isView=true to return views",
   flags: [
     { name: "spaceCode", type: "string", required: true, desc: "Space code" },
-    { name: "connType", type: "string", required: true, desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
-    { name: "repoCode", type: "string", required: true, desc: "Repository code, defaults to te_etl if not provided" },
+    { name: "connType", type: "string", required: false, default: "SPACE", desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
+    { name: "repoCode", type: "string", required: false, default: "te_etl", desc: "Repository code, defaults to te_etl if not provided" },
     { name: "catalog", type: "string", required: true, desc: "Catalog name" },
     { name: "schema", type: "string", required: true, desc: "Schema name" },
-    { name: "isView", type: "boolean", required: true, desc: "Whether to query views, default false returns physical tables, set true to return views" },
-    { name: "pageNum", type: "number", required: true, desc: "Page number, default 1" },
-    { name: "pageSize", type: "number", required: true, desc: "Page size, default 100" }
+    { name: "isView", type: "boolean", required: false, desc: "Whether to query views, default false returns physical tables, set true to return views" },
+    { name: "pageNum", type: "number", required: false, default: 1, desc: "Page number, default 1" },
+    { name: "pageSize", type: "number", required: false, default: 100, desc: "Page size, default 100" }
   ],
   risk: "read",
   execute: async (ctx) => {
@@ -1774,8 +1776,8 @@ var getQueryResult = {
   description: "Gets result data details (column names + row data) for a specific query record. Returns: columns(column definitions), rows(data rows). Requires recordId (obtainable via ide_list_query_history). Note: Only queries with SUCCESS status have result data",
   flags: [
     { name: "spaceCode", type: "string", required: true, desc: "Space code" },
-    { name: "connType", type: "string", required: true, desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
-    { name: "repoCode", type: "string", required: true, desc: "Repository code, defaults to te_etl if not provided" },
+    { name: "connType", type: "string", required: false, default: "SPACE", desc: "Connection type: SPACE(data warehouse for daily queries, default), ETL(ETL engine for data processing), APP(app warehouse for external services)" },
+    { name: "repoCode", type: "string", required: false, default: "te_etl", desc: "Repository code, defaults to te_etl if not provided" },
     { name: "recordId", type: "number", required: true, desc: "Query record ID (obtainable via ide_list_query_history)" }
   ],
   risk: "read",

package/dist/{te-engage-TBUTGW5F.js → te-engage-KARARMIR.js}

@@ -3,10 +3,12 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-GLNZSDKO.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-U6TKB3IV.js";
+import "./chunk-JM34JPCO.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-engage/utils.ts
 function buildMcpDryRun(ctx, serviceName46, toolName46, args) {

package/dist/{te-kb-XHVBWP5E.js → te-kb-2Z2CARN3.js}

@@ -1,11 +1,13 @@
 import {
   kbApi,
   kbUpload
-} from "./chunk-MWWYGZ76.js";
-import "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-SF3KTPIC.js";
+import "./chunk-GLNZSDKO.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-U6TKB3IV.js";
+import "./chunk-JM34JPCO.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-kb/query.ts
 var API_PATH = "/agent/api/external/knowledge-bases/query";

package/dist/{te-meta-NQ4U3VJW.js → te-meta-PDKLMWXN.js}

@@ -2,10 +2,12 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-GLNZSDKO.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-U6TKB3IV.js";
+import "./chunk-JM34JPCO.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-meta/shared.ts
 function createMcpCommand(config) {

package/dist/{te-team-556APRIU.js → te-team-SW5B7DHO.js}

@@ -1,14 +1,17 @@
 import {
+  getAuthHeaders,
   kbApi
-} from "./chunk-MWWYGZ76.js";
+} from "./chunk-SF3KTPIC.js";
 import {
   printError,
   printOutput
-} from "./chunk-B4UL2VIJ.js";
-import "./chunk-2NGWYMLB.js";
-import "./chunk-SRRUNQIM.js";
-import "./chunk-BI5ZVD6T.js";
-import "./chunk-MNHE6SSI.js";
+} from "./chunk-CLJF7MQA.js";
+import "./chunk-GLNZSDKO.js";
+import "./chunk-GSJGPNKK.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-U6TKB3IV.js";
+import "./chunk-JM34JPCO.js";
+import "./chunk-SRJIAOBN.js";
 
 // src/commands/te-team/shared.ts
 var API_PREFIX = process.env.AE_API_PREFIX ?? "/agent";
@@ -176,17 +179,19 @@ var listTemplates = {
 };
 
 // src/commands/te-team/team/list-projects.ts
-var OAUTH_CHECK_PATH = "/api/oauth/check";
+var OAUTH_CHECK_PATH = "/agent/api/external/team/oauth/check";
 var listProjects = {
   service: "team",
   command: "+list-projects",
   description: "List all projects available to the current user (from /api/oauth/check).",
   flags: [],
   risk: "read",
-  dryRun: (ctx) => ({ method: "POST", url: `${ctx.host().replace(/\/$/, "")}${OAUTH_CHECK_PATH}` }),
+  dryRun: (ctx) => ({
+    method: "POST",
+    url: `${ctx.host().replace(/\/$/, "")}${OAUTH_CHECK_PATH}`
+  }),
   execute: async (ctx) => {
-    const accessToken = await ctx.token();
-    const data = await kbApi(ctx, "POST", OAUTH_CHECK_PATH, {}, { accessToken });
+    const data = await kbApi(ctx, "POST", OAUTH_CHECK_PATH, {});
     return data?.projectInfoList ?? data;
   }
 };
@@ -393,7 +398,7 @@ var watchRun = {
   execute: async (ctx) => {
     const runId = ctx.str("id");
     const quiet = ctx.bool("quiet");
-    const token = await ctx.token();
+    const authHeaders = await getAuthHeaders(ctx);
     const host = ctx.host().replace(/\/$/, "");
     let lastLogTs = ctx.num("after-log") || void 0;
     let reconnects = 0;
@@ -404,7 +409,7 @@ var watchRun = {
       try {
         resp = await fetch(url.toString(), {
           headers: {
-            Authorization: `bearer ${token}`,
+            ...authHeaders,
             Accept: "text/event-stream",
             "Cache-Control": "no-cache"
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkingai/ae-cli",
-  "version": "1.0.27",
+  "version": "1.0.30",
   "description": "CLI tool for ThinkingAI (AE) analytics platform",
   "type": "module",
   "bin": {
@@ -16,13 +16,17 @@
   "scripts": {
     "dev": "tsx src/index.ts",
     "build": "tsup src/index.ts --format esm --outDir dist",
-    "verify:analysis-tools": "node scripts/verify-te-analysis-tools.mjs",
+    "verify:config": "node test/config-commands.test.mjs",
+    "verify:analysis-tools": "tsx scripts/verify-te-analysis-tools.mjs",
+    "verify:analysis-cluster-routing": "node scripts/verify-analysis-cluster-routing.mjs",
+    "verify:multi-cluster-mode": "node test/multi-cluster-mode.test.mjs",
     "verify:analysis-builder-dry-run": "node scripts/verify-te-analysis-builder-dry-run.mjs",
     "verify:analysis-audience-tools": "node scripts/verify-te-audience-tools.mjs",
     "verify:analysis-meta-tools": "node scripts/verify-te-meta-tools.mjs",
     "verify:analysis-common-tools": "node scripts/verify-te-common-tools.mjs",
     "verify:team-tools": "node scripts/verify-te-team-tools.mjs",
     "verify:agent-tools": "node scripts/verify-agent-tools.mjs",
+    "verify:self-check-overlay": "node test/self-check-overlay.test.mjs",
     "verify:update-check": "npx tsx test/update-check.test.mjs",
     "self-check": "node self-check/scan.mjs",
     "check:agents-docs": "node scripts/check-agents-docs-sync.mjs",

package/skills/ae-agent/SKILL.md

@@ -21,6 +21,7 @@ ae-cli agent +<command> [options]
 - Toggle operations on company/system resources only affect the current user's preference, not the global state.
 - JSON flags must be valid JSON strings, usually wrapped in single quotes in shell.
 - Successful commands return JSON by default. Use `--format table` when a table is easier to scan.
+- `--host <url>` overrides the active AE host. It is available on every command and may be placed after the subcommand, e.g. `ae-cli agent +<command> --host <url>`.
 
 ## Commands
 
@@ -127,7 +128,7 @@ ae-cli agent +toggle-model --id <model-cuid> --enabled false
 ## Notes
 
 - Only `personal` scope resources can be created or deleted via CLI.
-- MCP creation automatically validates server connectivity.
+- MCP creation does NOT validate server connectivity — an unreachable URL is accepted at create time and only fails when the agent actually calls the MCP at runtime. Double-check the URL.
 - Attachment upload supports files up to 50MB each, with a 1GB user quota.
 - Batch attachment uploads support partial success — individual file failures don't affect others.
 - Skill `--instructions @-` reads from stdin, useful for piping long instruction text.

package/skills/ae-analysis/SKILL.md

@@ -6,7 +6,6 @@ description: "AE/TE/ThinkingEngine/ThinkingAI ae-cli manual for analysis-side ta
 
 # ae-analysis
 
-> **CRITICAL - This skill is self-contained.** Use the Global AE CLI Rules below; do not require a separate shared skill for analysis-side tasks.
 > **CRITICAL - For all commands that require `project_id`, you MUST satisfy `PROJECT_ID_GATE` first (no guessing): verify the project by ID/name with `analysis_common +list_projects` only when there is no valid project context yet, when the user switches project/host/environment, or when the supplied project is ambiguous. Reuse a project already verified in the same continuous conversation and same host/environment.**
 > **CRITICAL - For write operations in this skill, you MUST complete the post-write link loop when applicable:** after success and extractable `resource_id`, call `analysis_common +get_resource_url` and return the main result + resource link (or explicit link-failure reason).
 > **CRITICAL - Before running any `+<tool_name>` command, you MUST first read the corresponding `references/<tool_name>.md`.** The reference filename always equals the command name without the leading `+`, for example `+query_adhoc` -> `references/query_adhoc.md`.
@@ -21,6 +20,7 @@ Global parameters:
 |---|---|
 | `--format <json\|table>` | Output format. Default is JSON. |
 | `--jq <expr>` | jq filter expression for JSON output. |
+| `--host <url>` | Override the active AE host. Available on every command and may be placed after the subcommand, e.g. `ae-cli analysis +list_dashboards --host <url>`. |
 
 Output and errors:
 - Successful commands return machine-readable JSON by default.

package/skills/ae-analysis/references/list_clusters.md

@@ -1,4 +1,4 @@
-# analysis_audience +list_clusters (Cluster Search)
+# analysis_audience +list_clusters (Audience/User Segment Cluster Search)
 
 > **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
 
@@ -8,8 +8,10 @@ Domain: **Cluster Management**
 
 **Fuzzy Search Fallback:** If `--query` returns no results, retry with broader keywords (max 3 attempts), then fall back to full list. See [SKILL.md § C. FUZZY_SEARCH_FALLBACK](../SKILL.md#c-fuzzy_search_fallback).
 
+**Term boundary:** This command lists audience/user segment clusters only. It is not a server, region, or deployment inventory tool.
+
 ## Use Cases
-- List cluster metadata accessible to the current user in the project.
+- List audience/user segment cluster metadata accessible to the current user in the project.
 - Supports payload governance parameters: `query`, `fields`, `limit`, `offset`.
 - Returns a paginated envelope (items + total + limit + offset + hasMore), not cluster members.