@thinkingai/ae-cli 1.0.18 → 1.0.21

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/{auth-2UTBG5U3.js → auth-ZPA6O5KO.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) {
@@ -29,6 +30,16 @@ function registerAuth(program) {
       printError("config", "No AE host configured.", "Run: ae-cli config set-host");
       process.exit(1);
     }
+    const config = loadConfig();
+    if (!config.hosts[host]) {
+      config.hosts[host] = { label: host };
+      if (!config.activeHost) {
+        config.activeHost = host;
+      }
+      saveConfig(config);
+      process.stderr.write(`[ae-cli] Config saved for ${host}
+`);
+    }
     try {
       const token = await getToken(host);
       process.stderr.write(`[ae-cli] Authenticated to ${host}
@@ -70,14 +81,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/{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-LAAS6ITR.js → chunk-7G2F7IVO.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";
@@ -59,6 +59,34 @@ async function httpGet(modulePath, params = {}, hostUrl) {
 async function httpPost(modulePath, params = {}, body, hostUrl) {
   return request("POST", modulePath, params, body ?? {}, true, hostUrl);
 }
+async function httpDelete(modulePath, params = {}, body, hostUrl) {
+  return request("DELETE", modulePath, params, body ?? null, true, hostUrl);
+}
+async function uploadRequest(modulePath, form, params = {}, retry = true, hostUrl) {
+  const resolvedHost = resolveHost(hostUrl);
+  const token = await getToken(resolvedHost);
+  const url = buildUrl(resolvedHost, modulePath, params);
+  const headers = {
+    "Authorization": `bearer ${token}`
+  };
+  const resp = await fetch(url, { method: "POST", headers, body: form });
+  if ((resp.status === 401 || resp.status === 403) && retry) {
+    clearToken(resolvedHost);
+    return uploadRequest(modulePath, form, params, false, resolvedHost);
+  }
+  const data = safeJsonParse(await resp.text());
+  if (data.return_code === -1001 && retry) {
+    clearToken(resolvedHost);
+    return uploadRequest(modulePath, form, params, false, resolvedHost);
+  }
+  if (data.return_code !== 0 && data.return_code !== void 0) {
+    throw new Error(`AE API error: ${data.return_message || "unknown"} (code: ${data.return_code})`);
+  }
+  return data.data !== void 0 ? data.data : data;
+}
+async function httpUpload(modulePath, form, params = {}, hostUrl) {
+  return uploadRequest(modulePath, form, params, true, hostUrl);
+}
 async function wsQueryOnce(projectId, requestId, qp, eventModel, options = {}, token, hostUrl, timeoutMs = 3e4) {
   const wsUrl = buildWsUrl(hostUrl, token);
   return new Promise((resolve, reject) => {
@@ -142,6 +170,8 @@ async function queryReportData(projectId, reportId, qp, eventModel, options = {}
 export {
   httpGet,
   httpPost,
+  httpDelete,
+  httpUpload,
   wsQuery,
   querySql,
   queryReportData

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/{client-O56G2SNJ.js → client-NYAEJDQZ.js}

@@ -1,15 +1,19 @@
 import {
+  httpDelete,
   httpGet,
   httpPost,
+  httpUpload,
   queryReportData,
   querySql,
   wsQuery
-} from "./chunk-LAAS6ITR.js";
-import "./chunk-4KQ7H7DY.js";
-import "./chunk-MR57UIKC.js";
+} from "./chunk-7G2F7IVO.js";
+import "./chunk-OVMQFFC2.js";
+import "./chunk-TMMUBSKW.js";
 export {
+  httpDelete,
   httpGet,
   httpPost,
+  httpUpload,
   queryReportData,
   querySql,
   wsQuery

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-NYAEJDQZ.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-EHHYPYBN.js");
+    commands.push(...teKb.default);
+  } catch {
+  }
   return commands;
 }
 async function registerAuthCommands() {
   try {
-    const { registerAuth } = await import("./auth-2UTBG5U3.js");
+    const { registerAuth } = await import("./auth-ZPA6O5KO.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-6ZPW3YII.js");
     registerApi(program);
   } catch {
   }

package/dist/{raw-A3VN2B6I.js → raw-6ZPW3YII.js}

@@ -5,13 +5,13 @@ import {
 import {
   httpGet,
   httpPost
-} from "./chunk-LAAS6ITR.js";
+} from "./chunk-7G2F7IVO.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) {