@thinkingai/ae-cli 1.0.18 → 1.0.20

package/dist/{auth-2UTBG5U3.js → auth-A4NV2VHD.js}

@@ -4,9 +4,10 @@ import {
 } from "./chunk-KM57HI5B.js";
 import {
   clearMcpToken,
+  loadMcpTokenStore,
   setMcpTokenManual,
   validateMcpToken
-} from "./chunk-7QBNU44L.js";
+} from "./chunk-5CCFSPAF.js";
 import {
   clearToken,
   getAuthStatus,
@@ -14,11 +15,11 @@ import {
   resolveHost,
   setTokenManual,
   validateToken
-} from "./chunk-4KQ7H7DY.js";
+} from "./chunk-OVMQFFC2.js";
 import {
   loadConfig,
   saveConfig
-} from "./chunk-MR57UIKC.js";
+} from "./chunk-TMMUBSKW.js";
 
 // src/commands/auth.ts
 function registerAuth(program) {
@@ -70,14 +71,22 @@ function registerAuth(program) {
 `);
     printOutput({ saved: true, host, verified: true }, program.opts().format || "json");
   });
-  auth.command("status").description("Show current authentication status").action(() => {
+  auth.command("status").description("Show current authentication status").action(async () => {
     const host = resolveHost(program.opts().host);
     if (!host) {
       printOutput({ authenticated: false, host: "(none)", hint: "Run: ae-cli config set-host" }, program.opts().format || "json");
       return;
     }
-    const status = getAuthStatus(host);
-    printOutput(status, program.opts().format || "json");
+    const tokenStatus = getAuthStatus(host);
+    const hasValidToken = tokenStatus.authenticated;
+    const mcpStore = loadMcpTokenStore();
+    const cachedMcpToken = mcpStore[host];
+    let hasValidMcpToken = false;
+    if (cachedMcpToken) {
+      hasValidMcpToken = await validateMcpToken(cachedMcpToken, host);
+    }
+    const authenticated = hasValidToken || hasValidMcpToken;
+    printOutput({ authenticated, host }, program.opts().format || "json");
   });
   auth.command("logout").description("Clear stored token for active host").action(() => {
     const host = resolveHost(program.opts().host);

package/dist/{auth-ECD46NBA.js → auth-T3ILGJKW.js}

@@ -7,8 +7,8 @@ import {
   saveToken,
   setTokenManual,
   validateToken
-} from "./chunk-4KQ7H7DY.js";
-import "./chunk-MR57UIKC.js";
+} from "./chunk-OVMQFFC2.js";
+import "./chunk-TMMUBSKW.js";
 export {
   clearToken,
   getAuthStatus,

package/dist/{chunk-7QBNU44L.js → chunk-5CCFSPAF.js}

@@ -1,12 +1,13 @@
 import {
   getToken
-} from "./chunk-4KQ7H7DY.js";
+} from "./chunk-OVMQFFC2.js";
 import {
+  forceMigrateFromFallback,
   getActiveHost,
   getConfigDir,
   safeJsonParse,
   safeReadJsonFile
-} from "./chunk-MR57UIKC.js";
+} from "./chunk-TMMUBSKW.js";
 
 // src/core/mcp.ts
 import fs from "fs";
@@ -54,7 +55,6 @@ function genRequestId() {
 }
 var MCP_TOKEN_FILE = path.join(getConfigDir(), "mcp-tokens.json");
 var MCP_TOKEN_GENERATE_PATH = "/v1/ta/mcp/token/generate";
-var FALLBACK_MCP_TOKEN_FILE = "/data/app/te_agent_ta/.ae-config/mcp-token.json";
 function loadMcpTokenStore() {
   try {
     if (fs.existsSync(MCP_TOKEN_FILE)) {
@@ -69,23 +69,6 @@ function saveMcpTokenStore(store) {
   if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
   fs.writeFileSync(MCP_TOKEN_FILE, JSON.stringify(store, null, 2));
 }
-function getFallbackMcpToken(hostUrl) {
-  try {
-    if (!fs.existsSync(FALLBACK_MCP_TOKEN_FILE)) {
-      return null;
-    }
-    const fallbackData = safeReadJsonFile(FALLBACK_MCP_TOKEN_FILE);
-    if (fallbackData && typeof fallbackData === "object" && !Array.isArray(fallbackData)) {
-      const url = fallbackData.url;
-      const token = fallbackData["mcp-token"];
-      if (url === hostUrl && token) {
-        return token;
-      }
-    }
-  } catch {
-  }
-  return null;
-}
 async function generateMcpToken(hostUrl) {
   const teToken = await getToken(hostUrl);
   const base = hostUrl.replace(/\/+$/, "");
@@ -196,15 +179,12 @@ async function mcpRequest(url, method, params = {}, hostOverride) {
     headers,
     body: JSON.stringify(body)
   });
-  if (resp.status === 403) {
-    const fallbackToken = getFallbackMcpToken(hostUrl);
-    if (fallbackToken) {
-      const store = loadMcpTokenStore();
-      store[hostUrl] = fallbackToken;
-      saveMcpTokenStore(store);
+  if (!resp.ok) {
+    const migrated = forceMigrateFromFallback();
+    if (migrated && migrated[hostUrl]) {
       process.stderr.write(`[ae-cli] MCP token refreshed from fallback for ${hostUrl}
 `);
-      headers["mcp-token"] = fallbackToken;
+      headers["mcp-token"] = migrated[hostUrl];
       const retryResp = await fetch(url, {
         method: "POST",
         headers,
@@ -219,9 +199,6 @@ async function mcpRequest(url, method, params = {}, hostOverride) {
       }
       return retryData.result;
     }
-    throw new Error(`MCP token expired or invalid. Please set a new MCP token: ae-cli auth set-mcp-token <token> --host ${hostUrl}`);
-  }
-  if (!resp.ok) {
     throw new Error(`MCP HTTP error: ${resp.status} ${resp.statusText}`);
   }
   const data = safeJsonParse(await resp.text());
@@ -264,6 +241,7 @@ function parseMcpResult(result) {
 export {
   registerMcpMappings,
   resolveMcpUrl,
+  loadMcpTokenStore,
   clearMcpToken,
   setMcpTokenManual,
   validateMcpToken,

package/dist/{chunk-4KQ7H7DY.js → chunk-OVMQFFC2.js}

@@ -4,7 +4,7 @@ import {
   getConfigDir,
   safeJsonParse,
   safeReadJsonFile
-} from "./chunk-MR57UIKC.js";
+} from "./chunk-TMMUBSKW.js";
 
 // src/core/auth.ts
 import fs from "fs";

package/dist/{chunk-MR57UIKC.js → chunk-TMMUBSKW.js}

@@ -26,6 +26,15 @@ function migrateFromFallback() {
   if (!fs2.existsSync(FALLBACK_MCP_TOKEN_FILE) || fs2.existsSync(MCP_TOKENS_FILE)) {
     return null;
   }
+  return doMigrateFromFallback();
+}
+function forceMigrateFromFallback() {
+  if (!fs2.existsSync(FALLBACK_MCP_TOKEN_FILE)) {
+    return null;
+  }
+  return doMigrateFromFallback();
+}
+function doMigrateFromFallback() {
   try {
     const fallbackData = safeReadJsonFile(FALLBACK_MCP_TOKEN_FILE);
     const tokenStore = {};
@@ -156,6 +165,7 @@ function extractHostname(fullUrl) {
 export {
   safeJsonParse,
   safeReadJsonFile,
+  forceMigrateFromFallback,
   loadConfig,
   saveConfig,
   getActiveHost,

package/dist/{chunk-LAAS6ITR.js → chunk-TOXRLDUP.js}

@@ -2,10 +2,10 @@ import {
   clearToken,
   getToken,
   resolveHost
-} from "./chunk-4KQ7H7DY.js";
+} from "./chunk-OVMQFFC2.js";
 import {
   safeJsonParse
-} from "./chunk-MR57UIKC.js";
+} from "./chunk-TMMUBSKW.js";
 
 // src/core/client.ts
 import WebSocket from "ws";

package/dist/{client-O56G2SNJ.js → client-FPA76DGY.js}

@@ -4,9 +4,9 @@ import {
   queryReportData,
   querySql,
   wsQuery
-} from "./chunk-LAAS6ITR.js";
-import "./chunk-4KQ7H7DY.js";
-import "./chunk-MR57UIKC.js";
+} from "./chunk-TOXRLDUP.js";
+import "./chunk-OVMQFFC2.js";
+import "./chunk-TMMUBSKW.js";
 export {
   httpGet,
   httpPost,

package/dist/{config-BU5FHGGE.js → config-QZIEYXQZ.js}

@@ -4,14 +4,14 @@ import {
   getToken,
   loadToken,
   validateToken
-} from "./chunk-4KQ7H7DY.js";
+} from "./chunk-OVMQFFC2.js";
 import {
   addHost,
   listHosts,
   removeHost,
   setActiveHost,
   updateHostLabel
-} from "./chunk-MR57UIKC.js";
+} from "./chunk-TMMUBSKW.js";
 
 // src/commands/config.ts
 import * as readline from "readline";

package/dist/index.js

@@ -5,7 +5,7 @@ import {
 import {
   getActiveHost,
   safeJsonParse
-} from "./chunk-MR57UIKC.js";
+} from "./chunk-TMMUBSKW.js";
 
 // src/index.ts
 import { Command as CommanderCommand } from "commander";
@@ -62,7 +62,7 @@ function createRuntimeContext(cmd, opts, globalOpts) {
   let _clientModule = null;
   async function getClient() {
     if (!_clientModule) {
-      _clientModule = await import("./client-O56G2SNJ.js");
+      _clientModule = await import("./client-FPA76DGY.js");
     }
     return _clientModule;
   }
@@ -105,7 +105,7 @@ function createRuntimeContext(cmd, opts, globalOpts) {
       return client.queryReportData(projectId, reportId, qp, eventModel, options, ctx.host());
     },
     async token() {
-      const { getToken } = await import("./auth-ECD46NBA.js");
+      const { getToken } = await import("./auth-T3ILGJKW.js");
       return getToken(ctx.host());
     },
     host() {
@@ -210,59 +210,64 @@ program.name("ae-cli").version(version).description("CLI tool for ThinkingAI (AE
 async function loadCommands() {
   const commands = [];
   try {
-    const teAnalysis = await import("./te-analysis-UGKESPBE.js");
+    const teAnalysis = await import("./te-analysis-CFQBXUCO.js");
     commands.push(...teAnalysis.default);
   } catch {
   }
   try {
-    const teAudience = await import("./te-audience-THZNVHYB.js");
+    const teAudience = await import("./te-audience-WPBBWADL.js");
     commands.push(...teAudience.default);
   } catch {
   }
   try {
-    const teMeta = await import("./te-meta-MGO5BCMG.js");
+    const teMeta = await import("./te-meta-BO45GW32.js");
     commands.push(...teMeta.default);
   } catch {
   }
   try {
-    const teCommon = await import("./te-common-QZOUME3S.js");
+    const teCommon = await import("./te-common-GL3KBZPD.js");
     commands.push(...teCommon.default);
   } catch {
   }
   try {
-    const engage = await import("./te-engage-RYGEQTYK.js");
+    const engage = await import("./te-engage-2VFM37ZM.js");
     commands.push(...engage.default);
   } catch {
   }
   try {
-    const community = await import("./te-community-AZVW3NFX.js");
+    const community = await import("./te-community-3XEJNSQL.js");
     commands.push(...community.default);
   } catch {
   }
   try {
-    const dataops = await import("./te-dataops-OE5PX2K6.js");
+    const dataops = await import("./te-dataops-H4WSMCG5.js");
     commands.push(...dataops.default);
   } catch {
   }
+  try {
+    const teKb = await import("./te-kb-U6SQUJVC.js");
+    commands.push(...teKb.default);
+  } catch {
+  }
   return commands;
 }
 async function registerAuthCommands() {
   try {
-    const { registerAuth } = await import("./auth-2UTBG5U3.js");
+    const { registerAuth } = await import("./auth-A4NV2VHD.js");
     registerAuth(program);
   } catch {
   }
 }
 async function registerConfigCommands() {
   try {
-    const { registerConfig } = await import("./config-BU5FHGGE.js");
+    const { registerConfig } = await import("./config-QZIEYXQZ.js");
     registerConfig(program);
   } catch {
   }
 }
 async function registerApiCommand() {
   try {
-    const { registerApi } = await import("./raw-A3VN2B6I.js");
+    const { registerApi } = await import("./raw-MZIKHQH4.js");
     registerApi(program);
   } catch {
   }

package/dist/{raw-A3VN2B6I.js → raw-MZIKHQH4.js}

@@ -5,13 +5,13 @@ import {
 import {
   httpGet,
   httpPost
-} from "./chunk-LAAS6ITR.js";
+} from "./chunk-TOXRLDUP.js";
 import {
   resolveHost
-} from "./chunk-4KQ7H7DY.js";
+} from "./chunk-OVMQFFC2.js";
 import {
   safeJsonParse
-} from "./chunk-MR57UIKC.js";
+} from "./chunk-TMMUBSKW.js";
 
 // src/api/raw.ts
 function registerApi(program) {

package/dist/{te-analysis-UGKESPBE.js → te-analysis-CFQBXUCO.js}

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-7QBNU44L.js";
-import "./chunk-4KQ7H7DY.js";
-import "./chunk-MR57UIKC.js";
+} from "./chunk-5CCFSPAF.js";
+import "./chunk-OVMQFFC2.js";
+import "./chunk-TMMUBSKW.js";
 
 // src/commands/te-analysis/shared.ts
 function createMcpCommand(config) {
@@ -476,16 +476,16 @@ var dashboard_default = commands3;
 // src/commands/te-analysis/model/query-adhoc.ts
 var queryAdhoc = createMcpCommand({
   command: "+query_adhoc",
-  description: "Run ad hoc analysis for event, retention, funnel, distribution, attribution, heat map, interval, path, rank list, property analysis, or SQL models. Supports fields/limit/offset pagination.",
+  description: "Run ad hoc analysis with an already-built qp. For event, retention, funnel, and prop_analysis, call the matching +build_*_analysis_qp command first and pass its qp; do not handcraft qp or call get_analysis_query_schema/list_events/list_properties/list_metrics/get_metric before the builder. For distribution, attribution, heat_map, interval, path, rank_list, and sql, use the legacy schema/metadata path. Supports fields/limit/offset pagination.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "model_type", type: "string", required: true, desc: "Model type. Supported values: event, retention, funnel, distribution, attribution, heat_map, interval, path, rank_list, prop_analysis, sql." },
-    { name: "qp", type: "json", required: true, desc: "Query parameter JSON. Call +get_analysis_query_schema first and keep the time calculation logic consistent with the schema." },
+    { name: "qp", type: "json", required: true, desc: "Query parameter JSON. For event/retention/funnel/prop_analysis, pass qp returned by the matching +build_*_analysis_qp command. Use +get_analysis_query_schema only for non-builder/manual model types." },
     { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and deduplication. Generated automatically if omitted." },
     { name: "use_cache", type: "boolean", required: false, desc: "Whether to use result cache. Default: true" },
     { name: "zone_offset", type: "number", required: false, desc: "Time zone offset in hours. For example, UTC+8 is 8 and UTC-5 is -5" },
     { name: "is_sort_by_columns", type: "boolean", required: false, desc: "Whether to sort query results by columns. Default: false" },
-    { name: "resolve_recent_day", type: "boolean", required: false, desc: "Whether to resolve relative time expressions such as last 7 days. Default: false" },
+    { name: "resolve_recent_day", type: "boolean", required: false, desc: "Whether to resolve relative time expressions such as last 7 days. If omitted, the service auto-resolves when qp.eventView.recentDay exists and start/end time is incomplete; otherwise it defaults to false." },
     { 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: 20, maximum: 50." },
     { name: "offset", type: "number", required: false, desc: "Optional offset. Default: 0." },
@@ -508,6 +508,88 @@ var queryAdhoc = createMcpCommand({
   })
 });
 
+// src/commands/te-analysis/model/build-event-analysis-qp.ts
+var buildEventAnalysisQp = createMcpCommand({
+  command: "+build_event_analysis_qp",
+  description: "Build a validated event-analysis QP from structured intent. Call before query_adhoc for event ad-hoc analysis. Do not call get_analysis_query_schema/list_events/list_properties/list_metrics/get_metric first; the builder resolves events, properties, and saved metric names internally. For a saved metric, pass its name in metrics[].event. This command only builds qp and does not execute query_adhoc.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "time_range", type: "json", required: true, desc: "Required time range JSON for event analysis." },
+    { name: "metrics", type: "json", required: true, desc: "Required event metrics JSON array." },
+    { name: "time_particle_size", type: "string", required: false, desc: "Optional time granularity. Default: total." },
+    { name: "groups", type: "json", required: false, desc: "Optional group-by dimensions JSON array." },
+    { name: "filters", type: "json", required: false, desc: "Optional global filters JSON array." },
+    { name: "relation", type: "string", required: false, desc: "Optional filter relation. Supported values: and, or. Default: and." }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    timeRange: ctx.json("time_range"),
+    metrics: ctx.json("metrics"),
+    timeParticleSize: ctx.str("time_particle_size") || void 0,
+    groups: optionalJson(ctx, "groups"),
+    filters: optionalJson(ctx, "filters"),
+    relation: ctx.str("relation") || void 0
+  })
+});
+
+// src/commands/te-analysis/model/build-retention-analysis-qp.ts
+var buildRetentionAnalysisQp = createMcpCommand({
+  command: "+build_retention_analysis_qp",
+  description: "Build a validated retention-analysis QP from structured intent. Call before query_adhoc for retention ad-hoc analysis. Do not call get_analysis_query_schema/list_events/list_properties/list_metrics/get_metric first; the builder resolves events and properties internally. This command only builds qp and does not execute query_adhoc.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "time_range", type: "json", required: true, desc: "Required time range JSON for retention analysis." },
+    { name: "retention", type: "json", required: true, desc: "Required retention intent JSON." },
+    { name: "relation", type: "string", required: false, desc: "Optional top-level retention filter relation. Supported values: and, or. Default: and." },
+    { name: "time_particle_size", type: "string", required: false, desc: "Optional time granularity. Supported values: day, week, month." }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    timeRange: ctx.json("time_range"),
+    retention: ctx.json("retention"),
+    relation: ctx.str("relation") || void 0,
+    timeParticleSize: ctx.str("time_particle_size") || void 0
+  })
+});
+
+// src/commands/te-analysis/model/build-funnel-analysis-qp.ts
+var buildFunnelAnalysisQp = createMcpCommand({
+  command: "+build_funnel_analysis_qp",
+  description: "Build a validated funnel-analysis QP from structured intent. Call before query_adhoc for funnel ad-hoc analysis. Do not call get_analysis_query_schema/list_events/list_properties/list_metrics/get_metric first; the builder resolves events and properties internally. This command only builds qp and does not execute query_adhoc.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "time_range", type: "json", required: true, desc: "Required time range JSON for funnel analysis." },
+    { name: "funnel", type: "json", required: true, desc: "Required funnel intent JSON." },
+    { name: "relation", type: "string", required: false, desc: "Optional top-level funnel filter relation. Supported values: and, or. Default: and." },
+    { name: "time_particle_size", type: "string", required: false, desc: "Optional time granularity. Supported values: day, week, month." }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    timeRange: ctx.json("time_range"),
+    funnel: ctx.json("funnel"),
+    relation: ctx.str("relation") || void 0,
+    timeParticleSize: ctx.str("time_particle_size") || void 0
+  })
+});
+
+// src/commands/te-analysis/model/build-prop-analysis-qp.ts
+var buildPropAnalysisQp = createMcpCommand({
+  command: "+build_prop_analysis_qp",
+  description: "Build a validated prop-analysis QP from structured intent. Call before query_adhoc for prop_analysis ad-hoc analysis. Do not call get_analysis_query_schema/list_properties/list_metrics/get_metric first; the builder resolves user properties internally. This command only builds qp and does not execute query_adhoc.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "prop_analysis", type: "json", required: true, desc: "Required user property analysis intent JSON." }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    propAnalysis: ctx.json("prop_analysis")
+  })
+});
+
 // src/commands/te-analysis/model/drilldown-users.ts
 var drilldownUsers = createMcpCommand({
   command: "+drilldown_users",
@@ -709,6 +791,10 @@ var getTableColumns = createMcpCommand({
 
 // src/commands/te-analysis/model/index.ts
 var commands4 = [
+  buildEventAnalysisQp,
+  buildRetentionAnalysisQp,
+  buildFunnelAnalysisQp,
+  buildPropAnalysisQp,
   queryAdhoc,
   drilldownUsers,
   drilldownUserEvents,
@@ -854,7 +940,7 @@ var entity_default = commands5;
 // src/commands/te-analysis/schema/get-analysis-query-schema.ts
 var getAnalysisQuerySchema = createMcpCommand({
   command: "+get_analysis_query_schema",
-  description: "Get the analysis query schema for the specified model type. Returns field definitions and usage examples. Core segment contains basic request structure + common CalcType (~13 operators) + common AggregateType (~10 metrics). For most queries, core alone is sufficient.",
+  description: "Get the analysis query schema for non-builder/manual model paths. Do not use this tool for natural-language event, retention, funnel, or prop_analysis ad-hoc analysis; use the matching +build_*_analysis_qp command then +query_adhoc. Returns field definitions and usage examples for low-level/manual QP construction.",
   flags: [
     { name: "model_type", type: "string", required: true, desc: "Model type. Supported values: event, retention, funnel, distribution, sql, interval, path, attribution, prop_analysis, rank_list, heat_map" },
     { name: "segments", type: "string", required: false, desc: "Schema segments to include (comma-separated). Options: core, filter_group, calctype, aggregatetype, examples, full. Empty/null \u2192 core only (recommended)." },

package/dist/{te-audience-THZNVHYB.js → te-audience-WPBBWADL.js}

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-7QBNU44L.js";
-import "./chunk-4KQ7H7DY.js";
-import "./chunk-MR57UIKC.js";
+} from "./chunk-5CCFSPAF.js";
+import "./chunk-OVMQFFC2.js";
+import "./chunk-TMMUBSKW.js";
 
 // src/commands/te-audience/shared.ts
 function createMcpCommand(config) {

package/dist/{te-common-QZOUME3S.js → te-common-GL3KBZPD.js}

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-7QBNU44L.js";
-import "./chunk-4KQ7H7DY.js";
-import "./chunk-MR57UIKC.js";
+} from "./chunk-5CCFSPAF.js";
+import "./chunk-OVMQFFC2.js";
+import "./chunk-TMMUBSKW.js";
 
 // src/commands/te-common/shared.ts
 function createMcpCommand(config) {

package/dist/{te-community-AZVW3NFX.js → te-community-3XEJNSQL.js}

@@ -3,9 +3,9 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-7QBNU44L.js";
-import "./chunk-4KQ7H7DY.js";
-import "./chunk-MR57UIKC.js";
+} from "./chunk-5CCFSPAF.js";
+import "./chunk-OVMQFFC2.js";
+import "./chunk-TMMUBSKW.js";
 
 // src/commands/te-community/get_channel_info.ts
 var getChannelInfo = {

package/dist/{te-dataops-OE5PX2K6.js → te-dataops-H4WSMCG5.js}

@@ -3,9 +3,9 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-7QBNU44L.js";
-import "./chunk-4KQ7H7DY.js";
-import "./chunk-MR57UIKC.js";
+} from "./chunk-5CCFSPAF.js";
+import "./chunk-OVMQFFC2.js";
+import "./chunk-TMMUBSKW.js";
 
 // src/commands/te-dataops/datatable/list-tables-by-page.ts
 var listTablesByPage = {

package/dist/{te-engage-RYGEQTYK.js → te-engage-2VFM37ZM.js}

@@ -3,9 +3,9 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-7QBNU44L.js";
-import "./chunk-4KQ7H7DY.js";
-import "./chunk-MR57UIKC.js";
+} from "./chunk-5CCFSPAF.js";
+import "./chunk-OVMQFFC2.js";
+import "./chunk-TMMUBSKW.js";
 
 // src/commands/te-engage/utils.ts
 function buildMcpDryRun(ctx, serviceName44, toolName44, args) {

package/dist/te-kb-U6SQUJVC.js

@@ -0,0 +1,41 @@
+// src/commands/te-kb/query.ts
+var API_PATH = "/api/external/knowledge-bases/query";
+function buildBody(ctx) {
+  const body = {
+    query: ctx.str("query"),
+    sources: ctx.json("sources")
+  };
+  const modelId = ctx.str("model-id");
+  if (modelId) body.modelId = modelId;
+  const maxTurnsRaw = ctx.str("max-turns");
+  if (maxTurnsRaw !== "") body.maxTurns = ctx.num("max-turns");
+  return body;
+}
+var query = {
+  service: "kb",
+  command: "+query",
+  description: "Query knowledge bases via /api/external/knowledge-bases/query.",
+  flags: [
+    { name: "query", type: "string", required: true, alias: "q", desc: "Natural language question to query against the knowledge bases" },
+    { name: "sources", type: "json", required: true, desc: 'JSON array of knowledge base refs, e.g. [{"scope":"company","name":"engineering-handbook"}]' },
+    { name: "model-id", type: "string", required: false, default: "AE-Auto", desc: "Model identifier (default: AE-Auto)" },
+    { name: "max-turns", type: "number", required: false, default: 6, desc: "Maximum reasoning turns (default: 6)" }
+  ],
+  risk: "read",
+  dryRun: (ctx) => ({
+    method: "POST",
+    url: `${ctx.host().replace(/\/$/, "")}${API_PATH}`,
+    body: buildBody(ctx)
+  }),
+  execute: async (ctx) => ctx.api("POST", API_PATH, {}, buildBody(ctx))
+};
+
+// src/commands/te-kb/index.ts
+var commands = [
+  query
+];
+var te_kb_default = commands;
+export {
+  te_kb_default as default,
+  query
+};

package/dist/{te-meta-MGO5BCMG.js → te-meta-BO45GW32.js}

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-7QBNU44L.js";
-import "./chunk-4KQ7H7DY.js";
-import "./chunk-MR57UIKC.js";
+} from "./chunk-5CCFSPAF.js";
+import "./chunk-OVMQFFC2.js";
+import "./chunk-TMMUBSKW.js";
 
 // src/commands/te-meta/shared.ts
 function createMcpCommand(config) {
@@ -58,7 +58,7 @@ function requiredJsonString(ctx, name) {
 // src/commands/te-meta/meta/list-events.ts
 var listEvents = createMcpCommand({
   command: "+list_events",
-  description: "List events in the project. Query performs fuzzy matching on eventName, eventDesc and aiRemark. Supports fields/limit/offset payload governance.",
+  description: "List events in the project. Use for explicit metadata inspection, not as a pre-step for event/retention/funnel/prop_analysis ad-hoc builders; the builders resolve event names internally. Query performs fuzzy matching on eventName, eventDesc and aiRemark. Supports fields/limit/offset payload governance.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "query", type: "string", required: false, desc: "Optional keyword filter. Fuzzy match is applied to eventName, eventDesc, and aiRemark; if omitted, all events are returned.", alias: "q" },
@@ -79,7 +79,7 @@ var listEvents = createMcpCommand({
 // src/commands/te-meta/meta/list-properties.ts
 var listProperties = createMcpCommand({
   command: "+list_properties",
-  description: "List properties in the project. Query performs fuzzy matching on propName, propDesc and aiRemark. Supports fields/limit/offset payload governance.",
+  description: "List properties in the project. Use for explicit metadata inspection, not as a pre-step for event/retention/funnel/prop_analysis ad-hoc builders; the builders resolve property names internally. Query performs fuzzy matching on propName, propDesc and aiRemark. Supports fields/limit/offset payload governance.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "scope", type: "string", required: false, desc: "Property scope: event or user" },
@@ -198,7 +198,7 @@ var createVirtualProperty = createMcpCommand({
 // src/commands/te-meta/meta/list-metrics.ts
 var listMetrics = createMcpCommand({
   command: "+list_metrics",
-  description: "List metric metadata in the project. Query performs fuzzy matching on metricName, metricDesc, and metricRemark. Supports fields/limit/offset pagination.",
+  description: "List metric metadata in the project. Use for metric metadata inspection/management, not as a pre-step for event/retention/funnel/prop_analysis ad-hoc builders. For event saved metric queries, pass the metric name directly to +build_event_analysis_qp in metrics[].event. Query performs fuzzy matching on metricName, metricDesc, and metricRemark. Supports fields/limit/offset pagination.",
   flags: [
     { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
     { name: "query", type: "string", required: false, alias: "q", desc: "Optional keyword filter. Fuzzy match on metricName, metricDesc, metricRemark." },
@@ -220,7 +220,7 @@ var listMetrics = createMcpCommand({
 // src/commands/te-meta/meta/get-metric.ts
 var getMetric = createMcpCommand({
   command: "+get_metric",
-  description: "Get the definition details of a single metric",
+  description: "Get the definition details of a single metric. Use for metric metadata inspection/management, not as a pre-step for event ad-hoc builder; pass saved metric names directly to +build_event_analysis_qp in metrics[].event.",
   flags: [
     { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
     { name: "metric_id", type: "number", required: true, alias: "m", desc: "Metric ID" }