@thinkingai/ae-cli 6.1.12 → 6.1.14

package/dist/{te-engage-QWM4GFS7.js → te-engage-ZSMIJLUW.js}

@@ -1,16 +1,24 @@
 import {
   createCapabilityCommand
-} from "./chunk-7KQWSBSL.js";
+} from "./chunk-753BUTNZ.js";
 import {
-  registerCapabilityGatewayRoute
+  registerCapabilityGatewayRoute,
+  resolveGatewayDomain
 } from "./chunk-PTE56QPL.js";
 import {
-  printError
-} from "./chunk-YTG6Q75E.js";
-import "./chunk-RBNKI5ZW.js";
-import "./chunk-Z3OXWCIA.js";
-import "./chunk-YV52FB5G.js";
-import "./chunk-GJJA4CQZ.js";
+  printError,
+  withOutputMetadata
+} from "./chunk-WZRX4KOH.js";
+import {
+  CapabilityGatewayError,
+  buildCapabilityGatewayUrl,
+  fetchCapabilityGateway,
+  requestCapabilityGateway,
+  requestCapabilityGatewayWithEnvelope
+} from "./chunk-5XUSIK27.js";
+import "./chunk-S5NTSDBS.js";
+import "./chunk-ZQKDZXDO.js";
+import "./chunk-3FY3RJ26.js";
 import {
   CliValidationError
 } from "./chunk-AXDXJTPC.js";
@@ -42,6 +50,9 @@ function createEngageActivityCapabilityCommand(config) {
 function createEngageWorkbenchCapabilityCommand(config) {
   return createEngageCapabilityCommand("engage-workbench", config);
 }
+function createEngageQueryCapabilityCommand(config) {
+  return createEngageCapabilityCommand("engage-query", config);
+}
 
 // src/commands/te-engage/engage-flow/flow/update-remark.ts
 var flowUpdateRemark = createEngageFlowCapabilityCommand({
@@ -78,6 +89,9 @@ function readOptionalString(ctx, name) {
 function readOptionalNumber(ctx, name) {
   return hasFlag(ctx, name) ? ctx.num(name) : void 0;
 }
+function readOptionalBoolean(ctx, name) {
+  return hasFlag(ctx, name) ? ctx.bool(name) : void 0;
+}
 function readOptionalJsonArray(ctx, name) {
   const value = ctx.json(name);
   if (value === void 0) return void 0;
@@ -256,6 +270,7 @@ var METRIC_AGGREGATIONS = /* @__PURE__ */ new Set([
   "variance",
   "stddev"
 ]);
+var TASK_TRIGGER_PERIOD_SYMBOLS = /* @__PURE__ */ new Set(["TS01", "TS02", "TS03", "TS04"]);
 function validateSemanticAudienceDefinition(value, path) {
   const definition = object(value, path);
   rejectUnknown(definition, ["type", "conditions", "include_filter", "exclude_filter"], path);
@@ -307,6 +322,18 @@ function validateSemanticMetricDefinition(value, path) {
 function validateEmbeddedSemanticDefinitions(value, path) {
   walk(value, path);
 }
+function validateTaskTriggerPeriodDefinition(value, path) {
+  const request = object(value, path);
+  if (!isObject(request.triggerConfig)) return;
+  const triggerConfig = request.triggerConfig;
+  if (triggerConfig.triggerDefinition === void 0 || triggerConfig.triggerDefinition === null) return;
+  const definition = object(triggerConfig.triggerDefinition, `${path}.triggerConfig.triggerDefinition`);
+  const rules = array(definition.rules, `${path}.triggerConfig.triggerDefinition.rules`, 1);
+  const primaryRule = object(rules[0], `${path}.triggerConfig.triggerDefinition.rules[0]`);
+  const symbolPath = `${path}.triggerConfig.triggerDefinition.rules[0].periodTimeSymbol`;
+  required(primaryRule.periodTimeSymbol, symbolPath);
+  enumValue(primaryRule.periodTimeSymbol, TASK_TRIGGER_PERIOD_SYMBOLS, symbolPath);
+}
 function walk(value, path) {
   if (Array.isArray(value)) {
     value.forEach((item, index) => walk(item, `${path}[${index}]`));
@@ -603,6 +630,30 @@ var flowSave = createEngageFlowCapabilityCommand({
   buildInput: (ctx) => ({ project_id: ctx.num("project-id"), req: readRequest(ctx) })
 });
 
+// src/commands/te-engage/engage-flow/metric/update.ts
+var flowMetricUpdate = createEngageFlowCapabilityCommand({
+  resource: "metric",
+  command: "update",
+  capabilityId: "engage-flow.metric.update",
+  description: "Update metric settings for a flow canvas.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "flow-id", type: "string", required: true, desc: "Logical flow ID." },
+    {
+      name: "metric-map",
+      type: "json",
+      required: true,
+      desc: "Metric configuration map keyed by metric group."
+    }
+  ],
+  risk: "write",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    flow_id: ctx.str("flow-id"),
+    metric_map: ctx.json("metric-map")
+  })
+});
+
 // src/commands/te-engage/engage-flow/node-config/schema.ts
 var nodeConfigSchema = createEngageFlowCapabilityCommand({
   resource: "node-config",
@@ -638,6 +689,208 @@ var nodeConfigValidate = createEngageFlowCapabilityCommand({
   })
 });
 
+// src/commands/te-engage/engage-flow/report/shared.ts
+var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+var flowReportCommonFlags = [
+  { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+  { name: "flow-id", type: "string", required: false, desc: "Logical flow ID." },
+  { name: "flow-uuid", type: "string", required: false, desc: "Flow version UUID." },
+  { name: "request-id", type: "string", required: false, desc: "Query correlation ID. Generated when omitted." },
+  { name: "push-language-code", type: "string", required: false, desc: "Push language code." },
+  { name: "show-time-zone", type: "string", required: false, desc: "Display timezone offset." }
+];
+var flowMetricDetailFlags = [
+  ...flowReportCommonFlags,
+  { name: "node-uuid", type: "string", required: true, desc: "Flow node UUID." },
+  { name: "start-time", type: "string", required: true, desc: "Start date in yyyy-MM-dd format." },
+  { name: "end-time", type: "string", required: true, desc: "End date in yyyy-MM-dd format." },
+  { name: "branch-id", type: "string", required: false, desc: "Optional branch ID." },
+  { name: "indicator-name", type: "string", required: false, desc: "Optional indicator name." },
+  { name: "indicators-uuid", type: "string", required: false, desc: "Optional AB metric indicator UUID." },
+  { name: "data-dim-type", type: "string", required: false, desc: "Data dimension type, usually uv or pv." },
+  { name: "report-mode", type: "string", required: false, desc: "Metric report mode: node or ab. Defaults to node." }
+];
+var flowUserDetailFlags = [
+  { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+  { name: "flow-id", type: "string", required: false, desc: "Logical flow ID." },
+  { name: "flow-uuid", type: "string", required: false, desc: "Flow version UUID." },
+  { name: "request-id", type: "string", required: false, desc: "Query correlation ID. Generated when omitted." },
+  { name: "cluster-def", type: "string", required: false, desc: "Legacy cluster definition JSON. Prefer the report metric fields below." },
+  { name: "indicator-name", type: "string", required: false, desc: "Metric key returned by the corresponding flow report." },
+  { name: "data-view-type", type: "string", required: false, desc: "Data view type. Defaults to 2 (date view)." },
+  { name: "is-summary", type: "boolean", required: false, desc: "Whether to query a summary segment. Defaults to false." },
+  { name: "start-time", type: "string", required: false, desc: "Segment start date in yyyy-MM-dd format." },
+  { name: "end-time", type: "string", required: false, desc: "Segment end date in yyyy-MM-dd format." },
+  { name: "push-language-code", type: "string", required: false, desc: "Optional push language code from the report context." },
+  { name: "user-time-zone", type: "string", required: false, desc: "Optional user timezone." },
+  { name: "show-time-zone", type: "string", required: false, desc: "Optional report display timezone." },
+  { name: "node-uuid", type: "string", required: false, desc: "Flow node UUID." },
+  { name: "branch-id", type: "string", required: false, desc: "Optional branch ID." }
+];
+var flowNodeUserDetailFlags = flowUserDetailFlags.map((flag) => flag.name === "node-uuid" ? { ...flag, required: true } : flag);
+var inlineLimitFlag = {
+  name: "limit",
+  type: "number",
+  required: false,
+  desc: "Maximum number of rows returned inline. Defaults to backend value."
+};
+var timeoutSecondsFlag = {
+  name: "timeout-seconds",
+  type: "number",
+  required: false,
+  desc: "Query or export timeout in seconds. Defaults to backend policy."
+};
+var exportFormatFlags = [
+  {
+    name: "artifact-format",
+    type: "string",
+    required: false,
+    desc: "Export artifact format. Flow report and user detail exports support csv or jsonl. Defaults to jsonl."
+  }
+];
+function validateFlowReportInput(ctx) {
+  if (!ctx.str("flow-id") && !ctx.str("flow-uuid")) {
+    printError("validation", "At least one of --flow-id or --flow-uuid is required");
+    process.exit(1);
+  }
+  validateDate(ctx.str("start-time"), "--start-time");
+  validateDate(ctx.str("end-time"), "--end-time");
+}
+function validateFlowUserDetailInput(ctx) {
+  if (!ctx.str("flow-id") && !ctx.str("flow-uuid")) {
+    printError("validation", "At least one of --flow-id or --flow-uuid is required");
+    process.exit(1);
+  }
+  if (!ctx.str("cluster-def") && (!ctx.str("indicator-name") || !ctx.str("start-time") || !ctx.str("end-time"))) {
+    printError("validation", "Pass either --cluster-def or --indicator-name with --start-time and --end-time");
+    process.exit(1);
+  }
+  validateDate(ctx.str("start-time"), "--start-time");
+  validateDate(ctx.str("end-time"), "--end-time");
+}
+function buildFlowReportInput(ctx) {
+  return {
+    project_id: ctx.num("project-id"),
+    flow_id: ctx.str("flow-id") || void 0,
+    flow_uuid: ctx.str("flow-uuid") || void 0,
+    request_id: ctx.str("request-id") || void 0,
+    push_language_code: ctx.str("push-language-code") || void 0,
+    show_time_zone: ctx.str("show-time-zone") || void 0,
+    node_uuid: ctx.str("node-uuid") || void 0,
+    branch_id: ctx.str("branch-id") || void 0,
+    indicator_name: ctx.str("indicator-name") || void 0,
+    indicators_uuid: ctx.str("indicators-uuid") || void 0,
+    data_dim_type: ctx.str("data-dim-type") || void 0,
+    start_time: ctx.str("start-time") || void 0,
+    end_time: ctx.str("end-time") || void 0,
+    report_mode: ctx.str("report-mode") || void 0,
+    cluster_def: ctx.str("cluster-def") || void 0,
+    limit: ctx.optionalNum("limit"),
+    format: ctx.str("artifact-format") || void 0,
+    timeout_seconds: ctx.optionalNum("timeout-seconds")
+  };
+}
+function buildFlowUserDetailInput(ctx) {
+  return {
+    project_id: ctx.num("project-id"),
+    flow_id: ctx.str("flow-id") || void 0,
+    flow_uuid: ctx.str("flow-uuid") || void 0,
+    request_id: ctx.str("request-id") || void 0,
+    node_uuid: ctx.str("node-uuid") || void 0,
+    branch_id: ctx.str("branch-id") || void 0,
+    cluster_def: ctx.str("cluster-def") || void 0,
+    indicator_name: ctx.str("indicator-name") || void 0,
+    data_view_type: ctx.str("data-view-type") || void 0,
+    is_summary: readOptionalBoolean(ctx, "is-summary"),
+    start_time: ctx.str("start-time") || void 0,
+    end_time: ctx.str("end-time") || 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,
+    limit: ctx.optionalNum("limit"),
+    format: ctx.str("artifact-format") || void 0,
+    timeout_seconds: ctx.optionalNum("timeout-seconds")
+  };
+}
+function validateDate(value, flag) {
+  if (value && !ISO_DATE.test(value)) {
+    printError("validation", `${flag} must be in yyyy-MM-dd format`);
+    process.exit(1);
+  }
+}
+
+// src/commands/te-engage/engage-flow/metric-user/export.ts
+var metricUserExport = createEngageFlowCapabilityCommand({
+  resource: "metric-user",
+  command: "export",
+  capabilityId: "engage-flow.metric-user.export",
+  description: "Export users behind a flow metric segment.",
+  flags: [...flowUserDetailFlags, ...exportFormatFlags, timeoutSecondsFlag],
+  risk: "read",
+  validate: validateFlowUserDetailInput,
+  buildInput: buildFlowUserDetailInput
+});
+
+// src/commands/te-engage/engage-flow/metric-user/run.ts
+var metricUserRun = createEngageFlowCapabilityCommand({
+  resource: "metric-user",
+  command: "run",
+  capabilityId: "engage-flow.metric-user.run",
+  description: "Query users behind a flow metric segment inline.",
+  flags: [...flowUserDetailFlags, inlineLimitFlag, timeoutSecondsFlag],
+  risk: "read",
+  validate: validateFlowUserDetailInput,
+  buildInput: buildFlowUserDetailInput
+});
+
+// src/commands/te-engage/engage-flow/node-metric-user/export.ts
+var nodeMetricUserExport = createEngageFlowCapabilityCommand({
+  resource: "node-metric-user",
+  command: "export",
+  capabilityId: "engage-flow.node-metric-user.export",
+  description: "Export users behind a flow node metric segment.",
+  flags: [...flowNodeUserDetailFlags, ...exportFormatFlags, timeoutSecondsFlag],
+  risk: "read",
+  validate: validateFlowUserDetailInput,
+  buildInput: buildFlowUserDetailInput
+});
+
+// src/commands/te-engage/engage-flow/node-metric-user/run.ts
+var nodeMetricUserRun = createEngageFlowCapabilityCommand({
+  resource: "node-metric-user",
+  command: "run",
+  capabilityId: "engage-flow.node-metric-user.run",
+  description: "Query users behind a flow node metric segment inline.",
+  flags: [...flowNodeUserDetailFlags, inlineLimitFlag, timeoutSecondsFlag],
+  risk: "read",
+  validate: validateFlowUserDetailInput,
+  buildInput: buildFlowUserDetailInput
+});
+
+// src/commands/te-engage/engage-flow/node-user/export.ts
+var nodeUserExport = createEngageFlowCapabilityCommand({
+  resource: "node-user",
+  command: "export",
+  capabilityId: "engage-flow.node-user.export",
+  description: "Export users behind a flow node segment.",
+  flags: [...flowNodeUserDetailFlags, ...exportFormatFlags, timeoutSecondsFlag],
+  risk: "read",
+  validate: validateFlowUserDetailInput,
+  buildInput: buildFlowUserDetailInput
+});
+
+// src/commands/te-engage/engage-flow/node-user/run.ts
+var nodeUserRun = createEngageFlowCapabilityCommand({
+  resource: "node-user",
+  command: "run",
+  capabilityId: "engage-flow.node-user.run",
+  description: "Query users behind a flow node segment inline.",
+  flags: [...flowNodeUserDetailFlags, inlineLimitFlag, timeoutSecondsFlag],
+  risk: "read",
+  validate: validateFlowUserDetailInput,
+  buildInput: buildFlowUserDetailInput
+});
+
 // src/commands/te-engage/engage-flow/operation-log/query.ts
 var operationLogQuery = createEngageFlowCapabilityCommand({
   resource: "operation-log",
@@ -652,6 +905,30 @@ var operationLogQuery = createEngageFlowCapabilityCommand({
   buildInput: (ctx) => ({ project_id: ctx.num("project-id"), flow_id: ctx.str("flow-id") })
 });
 
+// src/commands/te-engage/engage-flow/report/metric-detail-export.ts
+var flowReportMetricDetailExport = createEngageFlowCapabilityCommand({
+  resource: "report metric-detail",
+  command: "export",
+  capabilityId: "engage-flow.report.metric-detail.export",
+  description: "Export a flow node metric detail report artifact.",
+  flags: [...flowMetricDetailFlags, ...exportFormatFlags, timeoutSecondsFlag],
+  risk: "read",
+  validate: validateFlowReportInput,
+  buildInput: buildFlowReportInput
+});
+
+// src/commands/te-engage/engage-flow/report/metric-detail-run.ts
+var flowReportMetricDetailRun = createEngageFlowCapabilityCommand({
+  resource: "report metric-detail",
+  command: "run",
+  capabilityId: "engage-flow.report.metric-detail.run",
+  description: "Query a flow node metric detail report inline.",
+  flags: [...flowMetricDetailFlags, inlineLimitFlag, timeoutSecondsFlag],
+  risk: "read",
+  validate: validateFlowReportInput,
+  buildInput: buildFlowReportInput
+});
+
 // src/commands/te-engage/engage-flow/version/list.ts
 var versionList = createEngageFlowCapabilityCommand({
   resource: "version",
@@ -673,9 +950,18 @@ var commands = [
   flowSave,
   nodeConfigSchema,
   nodeConfigValidate,
+  flowMetricUpdate,
   flowModifyBaseInfo,
   flowManage,
   flowDelete,
+  flowReportMetricDetailRun,
+  flowReportMetricDetailExport,
+  metricUserRun,
+  metricUserExport,
+  nodeUserRun,
+  nodeUserExport,
+  nodeMetricUserRun,
+  nodeMetricUserExport,
   operationLogQuery,
   // testRun,
   versionList,
@@ -3444,6 +3730,121 @@ var channelRefStats = createEngageTaskCapabilityCommand({
   })
 });
 
+// src/commands/te-engage/engage-task/task-data-shared.ts
+var ISO_DATE2 = /^\d{4}-\d{2}-\d{2}$/;
+var taskMetricDetailFlags = [
+  { 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: "start-time", type: "string", required: true, desc: "Start date in yyyy-MM-dd format." },
+  { name: "end-time", type: "string", required: true, desc: "End date in yyyy-MM-dd format." },
+  { name: "metric-id-list", type: "json", required: false, desc: "Optional metric setting ID JSON array." },
+  { name: "group-type", type: "number", required: false, desc: "Optional metric grouping mode: 1, 2, 3, or 4." },
+  { name: "push-language-code", type: "string", required: false, desc: "Optional push content language code." },
+  { name: "show-time-zone", type: "string", required: false, desc: "Display timezone offset, such as 8.0 or -5.0." },
+  { name: "request-id", type: "string", required: false, desc: "Caller-provided report request ID." }
+];
+var taskDataDetailFlags = [
+  { 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: "detail-type", type: "string", required: true, desc: "Detail mode: time, instance, or instance_daily." },
+  { name: "start-time", type: "string", required: true, desc: "Start date in yyyy-MM-dd format." },
+  { name: "end-time", type: "string", required: true, desc: "End date in yyyy-MM-dd format." },
+  { name: "task-instance-id", type: "string", required: false, desc: "Task instance ID. Required when detail-type is instance_daily." },
+  { name: "data-dim-type", type: "string", required: false, desc: "Data dimension type: uv or pv." },
+  { name: "retention-type", type: "string", required: false, desc: "Optional retention mode: retention or lost." },
+  { name: "data-view-type", type: "number", required: false, desc: "Triggered-task detail view type: 2 or 3." },
+  { name: "push-language-code", type: "string", required: false, desc: "Optional push content language code." },
+  { name: "show-time-zone", type: "string", required: false, desc: "Display timezone offset, such as 8.0 or -5.0." },
+  { name: "request-id", type: "string", required: false, desc: "Caller-provided report request ID." }
+];
+function validateTaskMetricDetailInput(ctx) {
+  validateDateRange(ctx);
+  const metricIdList = ctx.json("metric-id-list");
+  if (metricIdList != null && !Array.isArray(metricIdList)) {
+    printError("validation", "--metric-id-list must be a JSON array");
+    process.exit(1);
+  }
+}
+function validateTaskDataDetailInput(ctx) {
+  validateDateRange(ctx);
+  const detailType = ctx.str("detail-type");
+  if (!["time", "instance", "instance_daily"].includes(detailType)) {
+    printError("validation", "--detail-type must be time, instance, or instance_daily");
+    process.exit(1);
+  }
+  if (detailType === "instance_daily" && !ctx.str("task-instance-id")) {
+    printError("validation", "--task-instance-id is required when --detail-type is instance_daily");
+    process.exit(1);
+  }
+}
+function buildTaskMetricDetailInput(ctx) {
+  return {
+    project_id: ctx.num("project-id"),
+    task_id: ctx.str("task-id"),
+    start_time: ctx.str("start-time"),
+    end_time: ctx.str("end-time"),
+    metric_id_list: ctx.json("metric-id-list") || void 0,
+    group_type: ctx.optionalNum("group-type"),
+    push_language_code: ctx.str("push-language-code") || void 0,
+    show_time_zone: ctx.str("show-time-zone") || void 0,
+    request_id: ctx.str("request-id") || void 0
+  };
+}
+function buildTaskDataDetailInput(ctx) {
+  return {
+    project_id: ctx.num("project-id"),
+    task_id: ctx.str("task-id"),
+    detail_type: ctx.str("detail-type"),
+    task_instance_id: ctx.str("task-instance-id") || void 0,
+    start_time: ctx.str("start-time"),
+    end_time: ctx.str("end-time"),
+    data_dim_type: ctx.str("data-dim-type") || void 0,
+    retention_type: ctx.str("retention-type") || void 0,
+    data_view_type: ctx.optionalNum("data-view-type"),
+    push_language_code: ctx.str("push-language-code") || void 0,
+    show_time_zone: ctx.str("show-time-zone") || void 0,
+    request_id: ctx.str("request-id") || void 0
+  };
+}
+function validateDateRange(ctx) {
+  validateDate2(ctx.str("start-time"), "--start-time");
+  validateDate2(ctx.str("end-time"), "--end-time");
+  if (ctx.str("start-time") > ctx.str("end-time")) {
+    printError("validation", "--start-time must be earlier than or equal to --end-time");
+    process.exit(1);
+  }
+}
+function validateDate2(value, flag) {
+  if (value && !ISO_DATE2.test(value)) {
+    printError("validation", `${flag} must be in yyyy-MM-dd format`);
+    process.exit(1);
+  }
+}
+
+// src/commands/te-engage/engage-task/data-detail/query.ts
+var dataDetailQuery = createEngageTaskCapabilityCommand({
+  resource: "data-detail",
+  command: "query",
+  capabilityId: "engage-task.task-data.detail",
+  description: "Query task data-detail report data.",
+  flags: taskDataDetailFlags,
+  risk: "read",
+  validate: validateTaskDataDetailInput,
+  buildInput: buildTaskDataDetailInput
+});
+
+// src/commands/te-engage/engage-task/effect/query.ts
+var taskEffectQuery = createEngageTaskCapabilityCommand({
+  resource: "effect",
+  command: "query",
+  capabilityId: "engage-task.task-data.metric-detail",
+  description: "Query task metric-detail report data.",
+  flags: taskMetricDetailFlags,
+  risk: "read",
+  validate: validateTaskMetricDetailInput,
+  buildInput: buildTaskMetricDetailInput
+});
+
 // src/commands/te-engage/engage-task/group/create.ts
 var groupCreate = createEngageTaskCapabilityCommand({
   resource: "group",
@@ -3517,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",
@@ -3573,7 +4287,7 @@ var operationLogQuery2 = createEngageTaskCapabilityCommand({
 });
 
 // src/commands/te-engage/engage-task/push-record/query.ts
-var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+var ISO_DATE4 = /^\d{4}-\d{2}-\d{2}$/;
 var pushRecordQuery = createEngageTaskCapabilityCommand({
   resource: "push-record",
   command: "query",
@@ -3601,11 +4315,11 @@ var pushRecordQuery = createEngageTaskCapabilityCommand({
   validate: (ctx) => {
     const startDate = ctx.str("start-date");
     const endDate = ctx.str("end-date");
-    if (startDate && !ISO_DATE.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_DATE.test(endDate)) {
+    if (endDate && !ISO_DATE4.test(endDate)) {
       printError("validation", "--end-date must be in yyyy-MM-dd format");
       process.exit(1);
     }
@@ -3887,12 +4601,14 @@ var taskSave = createEngageTaskCapabilityCommand({
       name: "req",
       type: "json",
       required: true,
-      desc: "Task save JSON; custom audiences use targetConfig.definitionRequest."
+      desc: "Task save JSON; triggered tasks require periodTimeSymbol on the primary trigger rule."
     }
   ],
   risk: "write",
   validate: (ctx) => {
-    validateEmbeddedSemanticDefinitions(readRequiredJsonObject(ctx, "req"), "--req");
+    const req = readRequiredJsonObject(ctx, "req");
+    validateEmbeddedSemanticDefinitions(req, "--req");
+    validateTaskTriggerPeriodDefinition(req, "--req");
   },
   buildInput: (ctx) => ({ project_id: ctx.num("project-id"), req: readRequiredJsonObject(ctx, "req") })
 });
@@ -3914,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,
@@ -3922,11 +4706,16 @@ var commands6 = [
   taskBuildSaveGuide,
   taskSave,
   taskManage,
+  taskEffectQuery,
+  dataDetailQuery,
   channelRefStats,
   groupCreate,
   groupDelete,
   groupList,
   groupUpdate,
+  taskIndicatorUserSql,
+  taskIndicatorUserRun,
+  taskIndicatorUserExport,
   metricList,
   metricUpdate,
   operationLogQuery2,
@@ -3938,10 +4727,153 @@ var commands6 = [
   segmentListSetVisibility,
   taskDelete,
   taskModifyGroup,
-  taskSubmitApproval
+  taskSubmitApproval,
+  taskUserDetailExport
 ];
 var engage_task_default = commands6;
 
+// src/commands/te-engage/engage-query/artifact/download.ts
+import { mkdir, writeFile } from "fs/promises";
+import { dirname, resolve } from "path";
+var artifactDownload = {
+  service: "engage-query",
+  resource: "artifact",
+  command: "download",
+  description: "Download a generated engagement query artifact.",
+  flags: [
+    { name: "run-id", type: "string", required: true, desc: "Query or export run ID." },
+    { name: "artifact-id", type: "string", required: true, desc: "Artifact ID returned by an export capability." },
+    { name: "output", type: "string", required: true, desc: "Local output file path. Use a file path, not a directory." }
+  ],
+  risk: "read",
+  dryRun: (ctx) => ({
+    method: "GET",
+    url: buildCapabilityGatewayUrl(
+      ctx.host(),
+      resolveGatewayDomain("engage-query", "engage"),
+      artifactPath(ctx.str("run-id"), ctx.str("artifact-id"))
+    ),
+    output_path: resolve(ctx.str("output"))
+  }),
+  execute: async (ctx) => {
+    const runId = ctx.str("run-id");
+    const artifactId = ctx.str("artifact-id");
+    const outputPath = resolve(ctx.str("output"));
+    await ensureArtifactReady(ctx.host(), runId, artifactId);
+    const resp = await fetchArtifact(ctx.host(), runId, artifactId);
+    const bytes = Buffer.from(await resp.arrayBuffer());
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, bytes);
+    return {
+      run_id: runId,
+      artifact_id: artifactId,
+      output_path: outputPath,
+      bytes: bytes.length,
+      content_type: resp.headers.get("content-type") ?? void 0,
+      content_encoding: resp.headers.get("content-encoding") ?? void 0,
+      content_disposition: resp.headers.get("content-disposition") ?? void 0
+    };
+  }
+};
+function artifactPath(runId, artifactId) {
+  return `runs/${encodeURIComponent(runId)}/artifacts/${encodeURIComponent(artifactId)}/download`;
+}
+async function ensureArtifactReady(host, runId, artifactId) {
+  const descriptor = await inspectRun(host, runId);
+  const descriptorArtifactId = descriptor.artifact_id ?? descriptor.artifactId;
+  const artifactStatus = descriptor.artifact_status ?? descriptor.artifactStatus;
+  const errorMessage = descriptor.error_message ?? descriptor.errorMessage;
+  if (descriptorArtifactId && descriptorArtifactId !== artifactId) {
+    throw new CapabilityGatewayError(
+      `artifact_id ${artifactId} does not belong to run_id ${runId}`,
+      "ARTIFACT_RUN_MISMATCH",
+      400,
+      "Use the run_id and artifact_id pair from the same export response."
+    );
+  }
+  const ready = descriptor.status === "SUCCEEDED" && (artifactStatus === "READY" || artifactStatus === "COMPLETED");
+  if (ready) {
+    return;
+  }
+  const reason = errorMessage ? `; error=${errorMessage}` : "";
+  throw new CapabilityGatewayError(
+    `Artifact is not ready: run_status=${descriptor.status ?? "UNKNOWN"}, artifact_status=${artifactStatus ?? "UNKNOWN"}${reason}`,
+    "ARTIFACT_NOT_READY",
+    409,
+    "Run ae-cli engage-query run inspect --run-id <run_id> until status=SUCCEEDED and artifact_status=READY or COMPLETED, then retry artifact download. If status is FAILED or CANCELED, do not retry download."
+  );
+}
+async function inspectRun(host, runId) {
+  return await requestCapabilityGateway(
+    host,
+    resolveGatewayDomain("engage-query", "engage"),
+    `runs/${encodeURIComponent(runId)}`
+  );
+}
+async function fetchArtifact(host, runId, artifactId) {
+  return fetchCapabilityGateway(
+    host,
+    resolveGatewayDomain("engage-query", "engage"),
+    artifactPath(runId, artifactId),
+    "GET",
+    void 0,
+    "application/octet-stream"
+  );
+}
+
+// src/commands/te-engage/engage-query/query/cancel.ts
+var queryCancel = createEngageQueryCapabilityCommand({
+  resource: "query",
+  command: "cancel",
+  capabilityId: "engage-query.query.cancel",
+  description: "Cancel one running engagement query or export run.",
+  flags: [
+    { name: "run-id", type: "string", required: true, desc: "Query or export run ID." },
+    { name: "reason", type: "string", required: false, desc: "Optional cancellation reason." }
+  ],
+  risk: "write",
+  buildInput: (ctx) => ({
+    run_id: ctx.str("run-id"),
+    reason: ctx.str("reason") || void 0
+  })
+});
+
+// src/commands/te-engage/engage-query/run/inspect.ts
+var runInspect = {
+  service: "engage-query",
+  resource: "run",
+  command: "inspect",
+  description: "Inspect one engagement query or export run status.",
+  flags: [
+    { name: "run-id", type: "string", required: true, desc: "Query or export run ID." }
+  ],
+  risk: "read",
+  dryRun: (ctx) => ({
+    method: "GET",
+    url: buildCapabilityGatewayUrl(
+      ctx.host(),
+      resolveGatewayDomain("engage-query", "engage"),
+      `runs/${encodeURIComponent(ctx.str("run-id"))}`
+    )
+  }),
+  execute: async (ctx) => {
+    const result = await requestCapabilityGatewayWithEnvelope(
+      ctx.host(),
+      resolveGatewayDomain("engage-query", "engage"),
+      `runs/${encodeURIComponent(ctx.str("run-id"))}`
+    );
+    return withOutputMetadata(result.data, result.meta);
+  }
+};
+
+// src/commands/te-engage/engage-query/index.ts
+var commands7 = [
+  runInspect,
+  artifactDownload,
+  queryCancel
+];
+var engage_query_default = commands7;
+
 // src/commands/te-engage/index.ts
 registerCapabilityGatewayRoute("engage-flow", { gatewayDomain: "engage" });
 registerCapabilityGatewayRoute("engage-task", { gatewayDomain: "engage" });
@@ -3949,15 +4881,17 @@ registerCapabilityGatewayRoute("engage-setting", { gatewayDomain: "engage" });
 registerCapabilityGatewayRoute("engage-scene", { gatewayDomain: "engage" });
 registerCapabilityGatewayRoute("engage-activity", { gatewayDomain: "engage" });
 registerCapabilityGatewayRoute("engage-workbench", { gatewayDomain: "engage" });
-var commands7 = [
+registerCapabilityGatewayRoute("engage-query", { gatewayDomain: "engage" });
+var commands8 = [
   ...engage_flow_default,
   ...engage_task_default,
   ...engage_setting_default,
   ...engage_scene_default,
   ...engage_activity_default,
-  ...engage_workbench_default
+  ...engage_workbench_default,
+  ...engage_query_default
 ];
-var te_engage_default = commands7;
+var te_engage_default = commands8;
 export {
   te_engage_default as default
 };