@thinkingai/ae-cli 6.0.41 → 6.0.42

package/dist/{te-engage-6RNGK5GH.js → te-engage-LCEGC7G4.js}

@@ -3918,6 +3918,319 @@ var groupUpdate = createEngageTaskCapabilityCommand({
   })
 });
 
+// src/commands/te-engage/engage-task/indicator-user/shared.ts
+var ISO_DATE3 = /^\d{4}-\d{2}-\d{2}$/;
+var DECIMAL_TIME_ZONE = /^[+-]?\d{1,2}(?:\.\d+)?$/;
+var taskIndicatorUserIndicators = [
+  "original_trigger",
+  "plan",
+  "actual_trigger",
+  "trigger_success",
+  "view",
+  "click",
+  "main",
+  "secondary",
+  "metric",
+  "click_activate",
+  "main_activate",
+  "secondary_activate"
+];
+var indicatorSet = new Set(taskIndicatorUserIndicators);
+var groupBySet = /* @__PURE__ */ new Set(["batch", "date", "trigger", "experiment"]);
+var retentionTypeSet = /* @__PURE__ */ new Set(["retention", "lost"]);
+var sourceSet = /* @__PURE__ */ new Set(["task", "experiment", "metric"]);
+var pushLanguageCodeSet = /* @__PURE__ */ new Set([
+  "all",
+  "default",
+  "ar",
+  "az",
+  "bs",
+  "ca",
+  "zh-Hans",
+  "zh-Hant",
+  "hr",
+  "cs",
+  "da",
+  "nl",
+  "en",
+  "et",
+  "fi",
+  "fr",
+  "ka",
+  "bg",
+  "de",
+  "el",
+  "hi",
+  "he",
+  "hu",
+  "id",
+  "it",
+  "ja",
+  "ko",
+  "lv",
+  "lt",
+  "ms",
+  "nb",
+  "fa",
+  "pl",
+  "pt",
+  "pa",
+  "ro",
+  "ru",
+  "sr",
+  "sk",
+  "es",
+  "sv",
+  "th",
+  "tr",
+  "uk",
+  "vi"
+]);
+var lostUnsupportedIndicatorSet = /* @__PURE__ */ new Set([
+  "original_trigger",
+  "metric",
+  "click_activate",
+  "main_activate",
+  "secondary_activate"
+]);
+var taskIndicatorUserFlags = [
+  { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+  { name: "task-id", type: "string", required: true, desc: "Engagement task ID." },
+  {
+    name: "indicator",
+    type: "string",
+    required: true,
+    desc: `Indicator segment. Values: ${taskIndicatorUserIndicators.join(", ")}.`
+  },
+  { name: "start-time", type: "string", required: true, desc: "Segment start date in yyyy-MM-dd format." },
+  { name: "end-time", type: "string", required: true, desc: "Segment end date in yyyy-MM-dd format." },
+  {
+    name: "group-by",
+    type: "string",
+    required: false,
+    desc: "Grouping context: batch, date, trigger, or experiment. Activate indicators require and default to experiment; others default to date."
+  },
+  { name: "is-summary", type: "boolean", required: false, desc: "Whether to query a summary segment. Defaults to true." },
+  {
+    name: "retention-type",
+    type: "string",
+    required: false,
+    desc: "Segment mode: retention or lost. Defaults to retention."
+  },
+  {
+    name: "source",
+    type: "string",
+    required: false,
+    desc: "Report source: task, experiment, or metric. Defaults to metric for metric indicators, experiment for activate indicators or experiment grouping, and task otherwise."
+  },
+  { name: "secondary-index", type: "number", required: false, desc: "Secondary indicator index from 1 to 10." },
+  { name: "metric-id", type: "string", required: false, desc: "Metric setting ID; required when --indicator=metric." },
+  { name: "task-instance-id", type: "string", required: false, desc: "Optional non-triggered task instance ID." },
+  { name: "exp-group-id", type: "string", required: false, desc: "Optional experiment group ID." },
+  { name: "push-language-code", type: "string", required: false, desc: "Push language filter, such as all, default, en, zh-Hans, or zh-Hant." },
+  { name: "user-time-zone", type: "string", required: false, desc: "User timezone filter: all or a decimal offset available on the task." },
+  { name: "show-time-zone", type: "string", required: false, desc: "Display timezone offset from -12 to 14. Omitted or 99 uses the backend default." }
+];
+var taskIndicatorUserRequestFlag = {
+  name: "request-id",
+  type: "string",
+  required: false,
+  desc: "Query correlation ID. Generated when omitted."
+};
+var taskIndicatorUserLimitFlag = {
+  name: "limit",
+  type: "number",
+  required: false,
+  desc: "Maximum number of rows returned inline. Defaults to backend policy."
+};
+var taskIndicatorUserTimeoutFlag = {
+  name: "timeout-seconds",
+  type: "number",
+  required: false,
+  desc: "Query or export timeout in seconds. Defaults to backend policy."
+};
+var taskIndicatorUserFormatFlag = {
+  name: "artifact-format",
+  type: "string",
+  required: false,
+  desc: "Export artifact format: csv or jsonl. Defaults to jsonl."
+};
+function validateTaskIndicatorUserInput(ctx) {
+  const indicator = ctx.str("indicator");
+  if (!indicatorSet.has(indicator)) {
+    fail2(`--indicator must be one of: ${taskIndicatorUserIndicators.join(", ")}`);
+  }
+  validateDate3(ctx.str("start-time"), "--start-time");
+  validateDate3(ctx.str("end-time"), "--end-time");
+  if (ctx.str("start-time") > ctx.str("end-time")) {
+    fail2("--start-time must be earlier than or equal to --end-time");
+  }
+  validateOptionalSet(ctx.str("group-by"), "--group-by", groupBySet);
+  validateOptionalSet(ctx.str("retention-type"), "--retention-type", retentionTypeSet);
+  validateOptionalSet(ctx.str("source"), "--source", sourceSet);
+  validateOptionalSet(ctx.str("push-language-code"), "--push-language-code", pushLanguageCodeSet);
+  validateShowTimeZone(ctx.str("show-time-zone"));
+  validateUserTimeZone(ctx.str("user-time-zone"));
+  const secondary = indicator === "secondary" || indicator === "secondary_activate";
+  const secondaryIndex = ctx.optionalNum("secondary-index");
+  if (secondary && (secondaryIndex === void 0 || !Number.isInteger(secondaryIndex) || secondaryIndex < 1 || secondaryIndex > 10)) {
+    fail2("--secondary-index must be an integer from 1 to 10 for secondary indicators");
+  }
+  if (!secondary && secondaryIndex !== void 0) {
+    fail2("--secondary-index is only accepted for secondary indicators");
+  }
+  if (indicator === "metric" && !ctx.str("metric-id")) {
+    fail2("--metric-id is required when --indicator=metric");
+  }
+  if (indicator !== "metric" && ctx.str("metric-id")) {
+    fail2("--metric-id is only accepted when --indicator=metric");
+  }
+  const source = ctx.str("source");
+  const metric = indicator === "metric";
+  if (metric && source && source !== "metric") {
+    fail2("--source must be metric when --indicator=metric");
+  }
+  if (!metric && source === "metric") {
+    fail2("--source=metric requires --indicator=metric");
+  }
+  const activate = indicator === "click_activate" || indicator === "main_activate" || indicator === "secondary_activate";
+  const groupBy = ctx.str("group-by");
+  if (activate && source && source !== "experiment") {
+    fail2("--source must be experiment for activate indicators");
+  }
+  if (activate && groupBy && groupBy !== "experiment") {
+    fail2("--group-by must be experiment for activate indicators");
+  }
+  if (ctx.str("retention-type") === "lost" && lostUnsupportedIndicatorSet.has(indicator)) {
+    fail2(`--retention-type=lost is not supported for --indicator=${indicator}`);
+  }
+  const isSummary = readOptionalBoolean(ctx, "is-summary");
+  const effectiveGroupBy = groupBy || (activate ? "experiment" : "date");
+  if (indicator === "plan" && ctx.str("exp-group-id")) {
+    fail2("--exp-group-id is not supported when --indicator=plan");
+  }
+  if (indicator === "plan" && effectiveGroupBy === "experiment" && isSummary === false) {
+    fail2("--is-summary=false is not supported for plan indicators grouped by experiment");
+  }
+  if (effectiveGroupBy === "experiment" && !metric && source && source !== "experiment") {
+    fail2("--source must be experiment when --group-by=experiment");
+  }
+  if (effectiveGroupBy === "batch" && isSummary === false && !ctx.str("task-instance-id")) {
+    fail2("--task-instance-id is required for a non-summary batch segment");
+  }
+  if (effectiveGroupBy === "experiment" && isSummary === false && !ctx.str("exp-group-id")) {
+    fail2("--exp-group-id is required for a non-summary experiment segment");
+  }
+}
+function buildTaskIndicatorUserInput(ctx) {
+  return {
+    project_id: ctx.num("project-id"),
+    task_id: ctx.str("task-id"),
+    indicator: ctx.str("indicator"),
+    start_time: ctx.str("start-time"),
+    end_time: ctx.str("end-time"),
+    group_by: ctx.str("group-by") || void 0,
+    is_summary: readOptionalBoolean(ctx, "is-summary"),
+    retention_type: ctx.str("retention-type") || void 0,
+    source: ctx.str("source") || void 0,
+    secondary_index: ctx.optionalNum("secondary-index"),
+    metric_id: ctx.str("metric-id") || void 0,
+    task_instance_id: ctx.str("task-instance-id") || void 0,
+    exp_group_id: ctx.str("exp-group-id") || void 0,
+    push_language_code: ctx.str("push-language-code") || void 0,
+    user_time_zone: ctx.str("user-time-zone") || void 0,
+    show_time_zone: ctx.str("show-time-zone") || void 0,
+    request_id: ctx.str("request-id") || void 0,
+    limit: ctx.optionalNum("limit"),
+    format: ctx.str("artifact-format") || void 0,
+    timeout_seconds: ctx.optionalNum("timeout-seconds")
+  };
+}
+function validateDate3(value, flag) {
+  if (!ISO_DATE3.test(value)) {
+    fail2(`${flag} must be in yyyy-MM-dd format`);
+  }
+}
+function validateOptionalSet(value, flag, allowed) {
+  if (value && !allowed.has(value)) {
+    fail2(`${flag} must be one of: ${[...allowed].join(", ")}`);
+  }
+}
+function validateShowTimeZone(value) {
+  if (!value) {
+    return;
+  }
+  if (!DECIMAL_TIME_ZONE.test(value)) {
+    fail2("--show-time-zone must use decimal hour-offset format like 8.0 or -5.0");
+  }
+  const offset = Number(value);
+  if ((offset < -12 || offset > 14) && offset !== 99) {
+    fail2("--show-time-zone must be between -12 and 14, or 99");
+  }
+}
+function validateUserTimeZone(value) {
+  if (!value || value === "all") {
+    return;
+  }
+  if (!DECIMAL_TIME_ZONE.test(value)) {
+    fail2("--user-time-zone must be all or a decimal hour offset like 8.0 or -5.0");
+  }
+  const offset = Number(value);
+  if (offset < -12 || offset > 14) {
+    fail2("--user-time-zone must be between -12 and 14, or all");
+  }
+}
+function fail2(message) {
+  printError("validation", message);
+  process.exit(1);
+}
+
+// src/commands/te-engage/engage-task/indicator-user/export.ts
+var taskIndicatorUserExport = createEngageTaskCapabilityCommand({
+  resource: "indicator-user",
+  command: "export",
+  capabilityId: "engage-task.indicator-user.export",
+  description: "Export users behind an engagement-task indicator segment.",
+  flags: [
+    ...taskIndicatorUserFlags,
+    taskIndicatorUserRequestFlag,
+    taskIndicatorUserFormatFlag,
+    taskIndicatorUserTimeoutFlag
+  ],
+  risk: "read",
+  validate: validateTaskIndicatorUserInput,
+  buildInput: buildTaskIndicatorUserInput
+});
+
+// src/commands/te-engage/engage-task/indicator-user/run.ts
+var taskIndicatorUserRun = createEngageTaskCapabilityCommand({
+  resource: "indicator-user",
+  command: "run",
+  capabilityId: "engage-task.indicator-user.run",
+  description: "Query users behind an engagement-task indicator segment inline.",
+  flags: [
+    ...taskIndicatorUserFlags,
+    taskIndicatorUserRequestFlag,
+    taskIndicatorUserLimitFlag,
+    taskIndicatorUserTimeoutFlag
+  ],
+  risk: "read",
+  validate: validateTaskIndicatorUserInput,
+  buildInput: buildTaskIndicatorUserInput
+});
+
+// src/commands/te-engage/engage-task/indicator-user/sql.ts
+var taskIndicatorUserSql = createEngageTaskCapabilityCommand({
+  resource: "indicator-user",
+  command: "sql",
+  capabilityId: "engage-task.indicator-user.sql",
+  description: "Build validated user-detail SQL for an engagement-task indicator segment.",
+  flags: taskIndicatorUserFlags,
+  risk: "read",
+  validate: validateTaskIndicatorUserInput,
+  buildInput: buildTaskIndicatorUserInput
+});
+
 // src/commands/te-engage/engage-task/metric/list.ts
 var metricList = createEngageTaskCapabilityCommand({
   resource: "metric",
@@ -3974,7 +4287,7 @@ var operationLogQuery2 = createEngageTaskCapabilityCommand({
 });
 
 // src/commands/te-engage/engage-task/push-record/query.ts
-var ISO_DATE3 = /^\d{4}-\d{2}-\d{2}$/;
+var ISO_DATE4 = /^\d{4}-\d{2}-\d{2}$/;
 var pushRecordQuery = createEngageTaskCapabilityCommand({
   resource: "push-record",
   command: "query",
@@ -4002,11 +4315,11 @@ var pushRecordQuery = createEngageTaskCapabilityCommand({
   validate: (ctx) => {
     const startDate = ctx.str("start-date");
     const endDate = ctx.str("end-date");
-    if (startDate && !ISO_DATE3.test(startDate)) {
+    if (startDate && !ISO_DATE4.test(startDate)) {
       printError("validation", "--start-date must be in yyyy-MM-dd format");
       process.exit(1);
     }
-    if (endDate && !ISO_DATE3.test(endDate)) {
+    if (endDate && !ISO_DATE4.test(endDate)) {
       printError("validation", "--end-date must be in yyyy-MM-dd format");
       process.exit(1);
     }
@@ -4317,6 +4630,74 @@ var taskStats = createEngageTaskCapabilityCommand({
   buildInput: (ctx) => ({ project_id: ctx.num("project-id"), req: readRequiredJsonObject(ctx, "req") })
 });
 
+// src/commands/te-engage/engage-task/user-detail/export.ts
+var taskUserDetailStatuses = [
+  "frequency_control",
+  "fatigue_control",
+  "fail",
+  "success",
+  "sample",
+  "exp_skip_push",
+  "deduplicate",
+  "push_plan",
+  "push_actual"
+];
+var statusSet = new Set(taskUserDetailStatuses);
+var taskUserDetailExport = createEngageTaskCapabilityCommand({
+  resource: "user-detail",
+  command: "export",
+  capabilityId: "engage-task.user-detail.export",
+  description: "Export user details for one non-triggered task instance and user status.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "task-id", type: "string", required: true, desc: "Engagement task ID." },
+    { name: "task-instance-id", type: "string", required: true, desc: "Non-triggered task instance ID." },
+    {
+      name: "task-exec-detail-id",
+      type: "string",
+      required: false,
+      desc: "Optional execution detail ID used to narrow the task instance export."
+    },
+    {
+      name: "user-status",
+      type: "string",
+      required: false,
+      desc: `English user status. Defaults to fail. Values: ${taskUserDetailStatuses.join(", ")}.`
+    },
+    { name: "request-id", type: "string", required: false, desc: "Export correlation ID. Generated when omitted." },
+    {
+      name: "artifact-format",
+      type: "string",
+      required: false,
+      desc: "Export artifact format: csv or jsonl. Defaults to jsonl."
+    },
+    {
+      name: "timeout-seconds",
+      type: "number",
+      required: false,
+      desc: "Export timeout in seconds. Defaults to backend policy and cannot exceed 21600."
+    }
+  ],
+  risk: "read",
+  validate: (ctx) => {
+    const status = ctx.str("user-status") || "fail";
+    if (!statusSet.has(status)) {
+      printError("validation", `--user-status must be one of: ${taskUserDetailStatuses.join(", ")}`);
+      process.exit(1);
+    }
+  },
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    task_id: ctx.str("task-id"),
+    task_instance_id: ctx.str("task-instance-id"),
+    task_exec_detail_id: ctx.str("task-exec-detail-id") || void 0,
+    user_status: ctx.str("user-status") || "fail",
+    request_id: ctx.str("request-id") || void 0,
+    format: ctx.str("artifact-format") || void 0,
+    timeout_seconds: ctx.optionalNum("timeout-seconds")
+  })
+});
+
 // src/commands/te-engage/engage-task/index.ts
 var commands6 = [
   taskList,
@@ -4332,6 +4713,9 @@ var commands6 = [
   groupDelete,
   groupList,
   groupUpdate,
+  taskIndicatorUserSql,
+  taskIndicatorUserRun,
+  taskIndicatorUserExport,
   metricList,
   metricUpdate,
   operationLogQuery2,
@@ -4343,7 +4727,8 @@ var commands6 = [
   segmentListSetVisibility,
   taskDelete,
   taskModifyGroup,
-  taskSubmitApproval
+  taskSubmitApproval,
+  taskUserDetailExport
 ];
 var engage_task_default = commands6;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkingai/ae-cli",
-  "version": "6.0.41",
+  "version": "6.0.42",
   "description": "CLI tool for ThinkingAI (AE) analytics platform",
   "type": "module",
   "bin": {

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

@@ -124,11 +124,13 @@ Property aggregation example:
 {
   "time_range": {"mode": "previous", "unit": "day", "value": 7},
   "metrics": [
-    {"event": "purchase", "aggregation": "sum", "property": "amount"}
+    {"event": "purchase", "display_name": "Purchase revenue", "aggregation": "sum", "property": "amount"}
   ]
 }
 ```
 
+Set optional `display_name` on an event metric when the report should show a business-facing metric name. It applies to regular event metrics, saved metrics, and formula metrics. Omit it to use the event name or the default formula-metric label.
+
 Formula metric example:
 
 ```json
@@ -136,6 +138,7 @@ Formula metric example:
   "time_range": {"mode": "previous", "unit": "day", "value": 7},
   "metrics": [
     {
+      "display_name": "Revenue per user",
       "formula": "revenue / users",
       "dependencies": [
         {"alias": "revenue", "event": "purchase", "aggregation": "sum", "property": "amount"},

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

@@ -12,7 +12,7 @@ ae-cli analysis alert list [options]
 
 Capability id: `analysis.alert.list`
 
-Input sends `project_id`, optional `query`, `limit`, and `offset`. Do not send camelCase aliases.
+Input sends `project_id`, optional `queries`, `limit`, and `offset`. `queries` accepts 1 to 20 non-empty strings with OR semantics; matching rows include `matched_queries` and `matched_fields`. Do not send singular `query` or camelCase aliases.
 
 Output is the capability gateway envelope: success is `ok=true,data,meta`; failure is `ok=false,error`. Export commands return lifecycle data such as `run_id` and `artifact_id` for inspect/download.
 
@@ -21,7 +21,6 @@ Parameters:
 | Parameter | Description | Required |
 | --- | --- | --- |
 | `--project-id` | See command help | Yes |
-| `--query` | See command help | No |
+| `--queries` | JSON array of 1 to 20 keyword filters | No |
 | `--limit` | See command help | No |
 | `--offset` | See command help | No |
-

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

@@ -81,7 +81,7 @@ Prefer the run/artifact commands over hand-written HTTP, Python, or curl. Analys
 | `drilldown-entities run/export` | `analysis.query.drilldown_entities` / `analysis.query.drilldown_entities_export` | Preview/export users or custom entities for an advertised entity cell | `--project-id`, `--query-context-id`, optional `--source`, `--coordinate` | Subject plus entity rows/artifact |
 | `query drilldown-user-events` | `analysis.query.drilldown_user_events` | Query one drilldown user's event sequence | `--project-id`, `--drilldown-context-id`, `--user-id` | Event sequence rows |
 | `query create-result-cluster` | `analysis.query.create_result_cluster` | Save the advertised user/custom-entity cell population as its result cluster | `--project-id`, `--query-context-id`, optional `--source`, `--coordinate`, `--cluster-name` | Result cluster creation result |
-| `report list` | `analysis.report.list` | Find accessible reports | `--project-id`, optional `--query`, `--fields`, `--limit`, `--offset` | Paginated report summaries |
+| `report list` | `analysis.report.list` | Find accessible reports | `--project-id`, optional `--queries`, `--fields`, `--limit`, `--offset` | Paginated report summaries |
 | `report list-export` | `analysis.report.list_export` | Export report catalog | same as list, plus optional `--artifact-format`, `--request-id` | Async artifact descriptor |
 | `report get` | `analysis.report.get` | Inspect current report definition as AI QP | `--project-id`, `--report-id` | Report metadata plus `model_type` and `definition` |
 | `report create` | `analysis.report.create` | Create a report from AI QP definition | `--report-name`, `--model-type`, `--definition` | Created report ID and normalized definition |
@@ -95,7 +95,7 @@ Prefer the run/artifact commands over hand-written HTTP, Python, or curl. Analys
 | `report-version rollback` | `analysis.report_version.rollback` | Rollback a report version | `--report-id`, `--target-version` | Rollback result |
 | `report-abnormal get` | `analysis.report_abnormal.get` | Inspect report abnormal dependencies | `--report-id` | Abnormal info |
 | `dashboard-report add` | `analysis.dashboard_report.add` | Add reports to a dashboard | `--dashboard-id`, `--report-ids` | Add result |
-| `dashboard list` | `analysis.dashboard.list` | Find accessible dashboards | `--project-id`, optional `--query`, `--fields`, `--limit`, `--offset` | Paginated dashboard summaries |
+| `dashboard list` | `analysis.dashboard.list` | Find accessible dashboards | `--project-id`, optional `--queries`, `--fields`, `--limit`, `--offset` | Paginated dashboard summaries |
 | `dashboard create` | `analysis.dashboard.create` | Create a dashboard | `--project-id`, `--dashboard-name`, optional `--space-id`, `--folder-id` | Created dashboard |
 | `dashboard get` | `analysis.dashboard.get` | Inspect one dashboard definition/share/report structure, including creator and creation/update time | `--project-id`, `--dashboard-id` | Dashboard detail |
 | `dashboard update` | `analysis.dashboard.update` | Update settings or upsert a note | `--operation settings|note-upsert`, IDs, optional `--payload` | Update result |
@@ -131,7 +131,7 @@ Prefer the run/artifact commands over hand-written HTTP, Python, or curl. Analys
 | `bi-panel-page-data export` | `analysis.bi_panel_page_data.export` | Large/long BI page data | same as run, optional `--artifact-format jsonl` | Async artifact descriptor |
 | `project-space list` | `analysis.project_space.list` | Find accessible project spaces | `--project-id`, optional list filters | Paginated project spaces |
 | `project-space get` | `analysis.project_space.get` | Inspect one project space | `--project-id`, `--space-id` | Project space detail |
-| `favorite add` | `analysis.favorite.add` | Favorite dashboard/BI/folder | `--asset-id`, `--asset-type`, optional `--payload` | Favorite result |
+| `favorite add` | `analysis.favorite.add` | Favorite dashboard/BI/folder | required `--asset-id`, `--asset-type`; optional `--space-id` | Favorite result |
 | `favorite remove` | `analysis.favorite.remove` | Remove favorite | same as add | Remove result |
 | `public-link create` | `analysis.public_link.create` | Generate public link | `--resource-type`, `--resource-id`, `--effective-at`, `--expires-at` | Link result |
 | `public-link list` | `analysis.public_link.list` | List public links | `--project-id`, optional list filters | Paginated links |
@@ -213,10 +213,10 @@ Output is the gateway envelope; `data` contains members.
 ## Examples
 
 ```bash
-ae-cli analysis dashboard list --project-id 1 --query retention --limit 50
+ae-cli analysis dashboard list --project-id 1 --queries '["retention","留存"]' --limit 50
 ae-cli analysis adhoc run --project-id 1 --model-type sql --definition '{"sql":"select * from events limit 20"}'
 ae-cli analysis adhoc export --project-id 1 --model-type sql --definition '{"sql":"select * from events where country ${Text:country}","params":[{"name":"country","type":"text","value":"US"}]}' --artifact-format jsonl
-ae-cli analysis report list --project-id 1 --query revenue --limit 50
+ae-cli analysis report list --project-id 1 --queries '["revenue","收入"]' --limit 50
 ae-cli analysis report-data run --project-id 1 --report-ids '[1001]' --preview-rows 50
 ae-cli analysis report-data run --project-id 1 --report-ids '[1001]' --filters '{"relation":"and","items":[{"field":{"name":"country","type":"user_property"},"operator":"eq","values":["US"]}]}' --group-by '[{"field":{"name":"country","type":"user_property"}}]' --sql-params '[{"name":"platform","value":"ios"}]' --preview-rows 50
 ae-cli analysis drilldown-entities run --query-context-id ctx_0123456789abcdef0123456789abcdef --source '{"report_id":1001}' --coordinate '{"cohort_date":"2026-07-01","group_values":[],"period_index":1,"population":"retained"}'

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

@@ -7,10 +7,10 @@ Do not use for dashboard assets. Use `dashboard list`.
 Command:
 
 ```bash
-ae-cli analysis bi-panel list --project-id <project_id> [--query <keyword>] [--limit 50] [--offset 0]
+ae-cli analysis bi-panel list --project-id <project_id> [--queries '["growth","retention"]'] [--limit 50] [--offset 0]
 ```
 
-Input sends `project_id` and optional `query`, `fields`, `limit`, `offset`. Prefer the default projection for discovery. Do not request generic `id`; BI panel summaries use fields such as `panel_id` and `name` when projected.
+Input sends `project_id` and optional `queries`, `fields`, `limit`, `offset`. `queries` accepts 1 to 20 non-empty strings with OR semantics; matching rows include `matched_queries` and `matched_fields`, and singular `query` is not accepted. Prefer the default projection for discovery. Do not request generic `id`; BI panel summaries use fields such as `panel_id` and `name` when projected.
 
 When `has_more=true`, continue only with the returned `next_offset`; do not calculate the next page locally.