@thinkingai/ae-cli 6.1.28 → 6.1.29

package/dist/{te-dataops-UKD2XN3E.js → te-dataops-XNMO7MBF.js}

@@ -1,27 +1,28 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   resolveHost
-} from "./chunk-P6VFCH3P.js";
+} from "./chunk-IN7KKL6K.js";
 import {
   printError
-} from "./chunk-ELCR235M.js";
+} from "./chunk-QZLRHGVH.js";
 import {
   internalCallSourceHeaders
 } from "./chunk-Y74WTIKJ.js";
+import "./chunk-2UW3Y463.js";
 import {
   SecureStoreAuthError,
   getCliToken
-} from "./chunk-P7KL7IOH.js";
+} from "./chunk-H3K5UGYC.js";
 import {
   safeJsonParse
-} from "./chunk-LMCYSVVA.js";
+} from "./chunk-JNVVJ273.js";
 import {
   CliApiError,
   CliValidationError,
   PermissionError,
   externalCliTokenRequestOptions,
   logger
-} from "./chunk-ZW4VMY5H.js";
+} from "./chunk-Z3Q2AEIN.js";
 
 // src/commands/te-dataops/shared.ts
 import { randomBytes } from "crypto";

package/dist/{te-engage-X3DIXPRA.js → te-engage-6C3HCFQR.js}

@@ -1,14 +1,7 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   createCapabilityCommand
-} from "./chunk-UJ7UPRXK.js";
-import {
-  CapabilityGatewayError,
-  buildCapabilityGatewayUrl,
-  fetchCapabilityGateway,
-  requestCapabilityGateway,
-  requestCapabilityGatewayWithEnvelope
-} from "./chunk-QW3R6O7L.js";
+} from "./chunk-VCZE3IWO.js";
 import {
   registerCapabilityGatewayRoute,
   resolveGatewayDomain
@@ -16,13 +9,21 @@ import {
 import {
   printError,
   withOutputMetadata
-} from "./chunk-ELCR235M.js";
+} from "./chunk-QZLRHGVH.js";
+import {
+  CapabilityGatewayError,
+  buildCapabilityGatewayUrl,
+  fetchCapabilityGateway,
+  requestCapabilityGateway,
+  requestCapabilityGatewayWithEnvelope
+} from "./chunk-3SDHJOCR.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-P7KL7IOH.js";
-import "./chunk-LMCYSVVA.js";
+import "./chunk-2UW3Y463.js";
+import "./chunk-H3K5UGYC.js";
+import "./chunk-JNVVJ273.js";
 import {
   CliValidationError
-} from "./chunk-ZW4VMY5H.js";
+} from "./chunk-Z3Q2AEIN.js";
 
 // src/commands/te-engage/shared.ts
 function createEngageCapabilityCommand(cliService, config) {

package/dist/{te-experiment-MEIIK3DP.js → te-experiment-LVTRI3QK.js}

@@ -1,16 +1,19 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   createCapabilityCommand
-} from "./chunk-UJ7UPRXK.js";
-import "./chunk-QW3R6O7L.js";
+} from "./chunk-VCZE3IWO.js";
 import {
   registerCapabilityGatewayRoute
 } from "./chunk-KPQY44JQ.js";
-import "./chunk-ELCR235M.js";
+import "./chunk-QZLRHGVH.js";
+import "./chunk-3SDHJOCR.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-P7KL7IOH.js";
-import "./chunk-LMCYSVVA.js";
-import "./chunk-ZW4VMY5H.js";
+import "./chunk-2UW3Y463.js";
+import "./chunk-H3K5UGYC.js";
+import "./chunk-JNVVJ273.js";
+import {
+  CliValidationError
+} from "./chunk-Z3Q2AEIN.js";
 
 // src/commands/te-experiment/capability-shared.ts
 function createExperimentCapabilityCommand(config) {
@@ -206,6 +209,7 @@ var experimentManage = createExperimentCapabilityCommand({
   command: "manage",
   capabilityId: "experiment.experiment.manage",
   description: "Update an experiment status.",
+  helpText: "For scheduled Feature starts, submit with --target-status pending after saving startTime.\nUsing --target-status running starts immediately. Read experiment detail first: when\nstart_time_adjustment_required is true, an early start uses the current server time.",
   flags: [
     { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
     { name: "exp-id", type: "string", required: true, desc: "Experiment ID." },
@@ -237,11 +241,38 @@ var experimentReadyCheck = createExperimentCapabilityCommand({
 });
 
 // src/commands/te-experiment/experiment/save.ts
+function readTimestamp(ctx, name) {
+  const value = ctx.str(name);
+  if (!(ctx.has?.(name) ?? value !== "")) return void 0;
+  if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?(?:Z|[+-]\d{2}:\d{2})$/.test(value) || !Number.isFinite(Date.parse(value))) {
+    throw new CliValidationError(`Flag --${name} must be an ISO-8601 timestamp with a timezone offset`);
+  }
+  return value;
+}
+function buildInput4(ctx) {
+  const req = { ...readRequiredObject(ctx, "req") };
+  const startTime = readTimestamp(ctx, "start-time");
+  const fixedEndTime = readTimestamp(ctx, "fixed-end-time");
+  if (startTime !== void 0 || fixedEndTime !== void 0) {
+    if (req.expType && req.expType !== "feature") {
+      throw new CliValidationError("Flags --start-time and --fixed-end-time only support Feature experiments");
+    }
+    if (startTime !== void 0) req.startTime = startTime;
+    if (fixedEndTime !== void 0) {
+      if (req.expCycle != null && (typeof req.expCycle !== "object" || Array.isArray(req.expCycle))) {
+        throw new CliValidationError("Field req.expCycle must be a JSON object when --fixed-end-time is provided");
+      }
+      req.expCycle = { ...req.expCycle, cycleType: "time", fixedEndTime };
+    }
+  }
+  return { project_id: ctx.num("project-id"), req };
+}
 var experimentSave = createExperimentCapabilityCommand({
   resource: "experiment",
   command: "save",
   capabilityId: "experiment.experiment.save",
-  description: "Create or update an experiment draft.",
+  description: "Create or update an experiment, including Feature start and end times.",
+  helpText: "Timing flags override matching fields in --req. Saving does not submit or start an experiment.\nAfter readiness checks, use experiment experiment manage --target-status pending to submit.\nSubmitted Feature experiments with a start time are checked every half hour by the server.\nUse timestamps with minutes 00 or 30 to align with scheduling checks.",
   flags: [
     { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
     {
@@ -249,13 +280,15 @@ var experimentSave = createExperimentCapabilityCommand({
       type: "json",
       required: true,
       desc: "Native camelCase request; custom audiences use targeting.definitionRequest, never targetConfig."
-    }
+    },
+    { name: "start-time", type: "string", desc: "Optional Feature start timestamp with timezone offset; overrides req.startTime. The server clears seconds and milliseconds." },
+    { name: "fixed-end-time", type: "string", desc: "Optional Feature deadline with timezone offset; sets req.expCycle.cycleType=time and overrides fixedEndTime." }
   ],
   risk: "write",
   validate: (ctx) => {
-    readRequiredObject(ctx, "req");
+    buildInput4(ctx);
   },
-  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), req: readRequiredObject(ctx, "req") })
+  buildInput: buildInput4
 });
 
 // src/commands/te-experiment/experiment/update-group.ts
@@ -382,12 +415,13 @@ function readMetrics(ctx) {
   }
   return value;
 }
-function buildInput4(ctx) {
+function buildInput5(ctx) {
   const expId = ctx.str("exp-id").trim();
   const groups = readGroups(ctx);
   if (expId) {
     for (let index = 0; index < groups.length; index += 1) {
-      if (typeof groups[index].expGroupId !== "string" || groups[index].expGroupId.trim() === "") {
+      const expGroupId = groups[index].expGroupId;
+      if (typeof expGroupId !== "string" || expGroupId.trim() === "") {
         throw new Error(`Flag --groups[${index}].expGroupId is required when --exp-id is provided`);
       }
     }
@@ -441,9 +475,9 @@ var externalExperimentSaveSubmit = createExperimentCapabilityCommand({
   ],
   risk: "write",
   validate: (ctx) => {
-    buildInput4(ctx);
+    buildInput5(ctx);
   },
-  buildInput: buildInput4
+  buildInput: buildInput5
 });
 
 // src/commands/te-experiment/feature/batch-delete.ts
@@ -464,7 +498,7 @@ var featureBatchDelete = createExperimentCapabilityCommand({
 });
 
 // src/commands/te-experiment/feature/get.ts
-function buildInput5(ctx) {
+function buildInput6(ctx) {
   const input = {
     project_id: ctx.num("project-id"),
     feature_key: ctx.str("feature-key")
@@ -483,7 +517,7 @@ var featureGet = createExperimentCapabilityCommand({
     { name: "version", type: "string", required: false, desc: "Feature version ID." }
   ],
   risk: "read",
-  buildInput: buildInput5
+  buildInput: buildInput6
 });
 
 // src/commands/te-experiment/feature/list.ts
@@ -638,7 +672,7 @@ var featureWhitelistBatchDelete = createExperimentCapabilityCommand({
 });
 
 // src/commands/te-experiment/feature-whitelist/list.ts
-function buildInput6(ctx) {
+function buildInput7(ctx) {
   return {
     project_id: ctx.num("project-id"),
     feature_key: ctx.str("feature-key")
@@ -654,11 +688,11 @@ var featureWhitelistList = createExperimentCapabilityCommand({
     { name: "feature-key", type: "string", required: true, desc: "Existing Feature key." }
   ],
   risk: "read",
-  buildInput: buildInput6
+  buildInput: buildInput7
 });
 
 // src/commands/te-experiment/feature-whitelist/save.ts
-function buildInput7(ctx) {
+function buildInput8(ctx) {
   const ruleId = ctx.str("rule-id").trim();
   const status = ctx.str("status").trim() || "draft";
   if (!["draft", "enable", "disable"].includes(status)) {
@@ -695,9 +729,9 @@ var featureWhitelistSave = createExperimentCapabilityCommand({
   ],
   risk: "write",
   validate: (ctx) => {
-    buildInput7(ctx);
+    buildInput8(ctx);
   },
-  buildInput: buildInput7
+  buildInput: buildInput8
 });
 
 // src/commands/te-experiment/feature-whitelist/update-status.ts