@thinkingai/ae-cli 1.0.15 → 1.0.20

package/dist/index.js

@@ -5,7 +5,7 @@ import {
 import {
   getActiveHost,
   safeJsonParse
-} from "./chunk-EBFUVWIZ.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-HU63573O.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-4GAHTBVH.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-ZDJXMWZY.js");
+    const teAnalysis = await import("./te-analysis-CFQBXUCO.js");
     commands.push(...teAnalysis.default);
   } catch {
   }
   try {
-    const teAudience = await import("./te-audience-T5B52EEB.js");
+    const teAudience = await import("./te-audience-WPBBWADL.js");
     commands.push(...teAudience.default);
   } catch {
   }
   try {
-    const teMeta = await import("./te-meta-JJMV75KB.js");
+    const teMeta = await import("./te-meta-BO45GW32.js");
     commands.push(...teMeta.default);
   } catch {
   }
   try {
-    const teCommon = await import("./te-common-BPTXXTHQ.js");
+    const teCommon = await import("./te-common-GL3KBZPD.js");
     commands.push(...teCommon.default);
   } catch {
   }
   try {
-    const engage = await import("./te-engage-K3EANZ5P.js");
+    const engage = await import("./te-engage-2VFM37ZM.js");
     commands.push(...engage.default);
   } catch {
   }
   try {
-    const community = await import("./te-community-FPB5LH56.js");
+    const community = await import("./te-community-3XEJNSQL.js");
     commands.push(...community.default);
   } catch {
   }
   try {
-    const dataops = await import("./te-dataops-2NUJVG47.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-U2GHFMFY.js");
+    const { registerAuth } = await import("./auth-A4NV2VHD.js");
     registerAuth(program);
   } catch {
   }
 }
 async function registerConfigCommands() {
   try {
-    const { registerConfig } = await import("./config-OLF7RBPM.js");
+    const { registerConfig } = await import("./config-QZIEYXQZ.js");
     registerConfig(program);
   } catch {
   }
 }
 async function registerApiCommand() {
   try {
-    const { registerApi } = await import("./raw-GDO4IWNW.js");
+    const { registerApi } = await import("./raw-MZIKHQH4.js");
     registerApi(program);
   } catch {
   }

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

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

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

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-TJIMDNAU.js";
-import "./chunk-UK6HO5O5.js";
-import "./chunk-EBFUVWIZ.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-T5B52EEB.js → te-audience-WPBBWADL.js}

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-TJIMDNAU.js";
-import "./chunk-UK6HO5O5.js";
-import "./chunk-EBFUVWIZ.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-BPTXXTHQ.js → te-common-GL3KBZPD.js}

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-TJIMDNAU.js";
-import "./chunk-UK6HO5O5.js";
-import "./chunk-EBFUVWIZ.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-FPB5LH56.js → te-community-3XEJNSQL.js}

@@ -3,9 +3,9 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-TJIMDNAU.js";
-import "./chunk-UK6HO5O5.js";
-import "./chunk-EBFUVWIZ.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-2NUJVG47.js → te-dataops-H4WSMCG5.js}

@@ -3,9 +3,9 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-TJIMDNAU.js";
-import "./chunk-UK6HO5O5.js";
-import "./chunk-EBFUVWIZ.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-K3EANZ5P.js → te-engage-2VFM37ZM.js}

@@ -3,9 +3,9 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-TJIMDNAU.js";
-import "./chunk-UK6HO5O5.js";
-import "./chunk-EBFUVWIZ.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-JJMV75KB.js → te-meta-BO45GW32.js}

@@ -2,9 +2,9 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-TJIMDNAU.js";
-import "./chunk-UK6HO5O5.js";
-import "./chunk-EBFUVWIZ.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" }
@@ -380,12 +380,14 @@ var generateTrackProgram = createMcpCommand({
   description: "Generate a tracking plan from structured business context (async)",
   flags: [
     { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
-    { name: "form_data", type: "json", required: true, desc: "Structured business context JSON object with optional fields: account_system, revenue_model, core_gameplay, currency_system, main_entries, language, predefinedEvent, developmentCarrier" }
+    { name: "language", type: "string", required: true, alias: "l", desc: "Language code (zh-CN, en-US, ja-JP, ko-KR)" },
+    { name: "form_data", type: "json", required: true, desc: "Structured business context JSON object, optional fields for example: account_system, revenue_model, core_gameplay, currency_system, main_entries, predefinedEvent, developmentCarrier" }
   ],
   risk: "write",
   mcpService: "te_analysis_extend",
   buildArgs: (ctx) => ({
     projectId: ctx.num("project_id"),
+    language: ctx.str("language"),
     formData: ctx.json("form_data")
   })
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkingai/ae-cli",
-  "version": "1.0.15",
+  "version": "1.0.20",
   "description": "CLI tool for ThinkingAI (AE) analytics platform",
   "type": "module",
   "bin": {
@@ -17,6 +17,7 @@
     "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: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",