@thinkingai/ae-cli 6.0.40 → 6.0.41

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

@@ -1,16 +1,24 @@
 import {
   createCapabilityCommand
-} from "./chunk-7KQWSBSL.js";
+} from "./chunk-FNZA5RZA.js";
 import {
-  registerCapabilityGatewayRoute
-} from "./chunk-PTE56QPL.js";
+  CapabilityGatewayError,
+  buildCapabilityGatewayUrl,
+  fetchCapabilityGateway,
+  requestCapabilityGateway,
+  requestCapabilityGatewayWithEnvelope
+} from "./chunk-JUW4AJXN.js";
+import {
+  printError,
+  withOutputMetadata
+} from "./chunk-WZRX4KOH.js";
 import {
-  printError
-} from "./chunk-YTG6Q75E.js";
-import "./chunk-RBNKI5ZW.js";
-import "./chunk-Z3OXWCIA.js";
-import "./chunk-YV52FB5G.js";
-import "./chunk-GJJA4CQZ.js";
+  registerCapabilityGatewayRoute,
+  resolveGatewayDomain
+} from "./chunk-PTE56QPL.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",
@@ -3573,7 +3974,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_DATE3 = /^\d{4}-\d{2}-\d{2}$/;
 var pushRecordQuery = createEngageTaskCapabilityCommand({
   resource: "push-record",
   command: "query",
@@ -3601,11 +4002,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_DATE3.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_DATE3.test(endDate)) {
       printError("validation", "--end-date must be in yyyy-MM-dd format");
       process.exit(1);
     }
@@ -3887,12 +4288,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") })
 });
@@ -3922,6 +4325,8 @@ var commands6 = [
   taskBuildSaveGuide,
   taskSave,
   taskManage,
+  taskEffectQuery,
+  dataDetailQuery,
   channelRefStats,
   groupCreate,
   groupDelete,
@@ -3942,6 +4347,148 @@ var commands6 = [
 ];
 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 +4496,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
 };