@thinkingai/ae-cli 6.1.13 → 6.1.14

package/dist/{te-engage-BRLSRVQT.js → te-engage-D6EG3NOR.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;