@thinkingai/ae-cli 6.1.5 → 6.1.7

package/dist/te-experiment-KYRWAUZY.js

@@ -0,0 +1,590 @@
+import {
+  createCapabilityCommand
+} from "./chunk-6CHYBI64.js";
+import {
+  registerCapabilityGatewayRoute
+} from "./chunk-PTE56QPL.js";
+import "./chunk-RGXCNC4N.js";
+import "./chunk-IMMGMU54.js";
+import "./chunk-E7UXXHO3.js";
+import "./chunk-IR4ZLVPW.js";
+import "./chunk-V6FR6WTW.js";
+import "./chunk-24BAVOX3.js";
+import "./chunk-LYVNONC4.js";
+
+// src/commands/te-experiment/capability-shared.ts
+function createExperimentCapabilityCommand(config) {
+  return createCapabilityCommand({
+    ...config,
+    cliService: "experiment",
+    gatewayDomain: "engage"
+  });
+}
+function readRequiredObject(ctx, name) {
+  const value = ctx.json(name);
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`Flag --${name} must be a JSON object`);
+  }
+  return value;
+}
+function readRequiredStringArray(ctx, name) {
+  const value = ctx.json(name);
+  if (!Array.isArray(value) || value.length === 0 || !value.every((item) => typeof item === "string" && item.length > 0)) {
+    throw new Error(`Flag --${name} must be a non-empty JSON array of strings`);
+  }
+  return value;
+}
+function addOptionalString(input, name, value) {
+  if (value !== "") input[name] = value;
+}
+
+// src/commands/te-experiment/bucket/list.ts
+var bucketList = createExperimentCapabilityCommand({
+  resource: "bucket",
+  command: "list",
+  capabilityId: "experiment.bucket.list",
+  description: "List split buckets in a project.",
+  flags: [{ name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." }],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id") })
+});
+
+// src/commands/te-experiment/experiment/batch-delete.ts
+var experimentBatchDelete = createExperimentCapabilityCommand({
+  resource: "experiment",
+  command: "batch-delete",
+  capabilityId: "experiment.experiment.batch-delete",
+  description: "Batch delete experiments.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "exp-ids", type: "json", required: true, desc: "Experiment IDs as a JSON string array." }
+  ],
+  risk: "high-risk-write",
+  validate: (ctx) => {
+    readRequiredStringArray(ctx, "exp-ids");
+  },
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    exp_ids: readRequiredStringArray(ctx, "exp-ids")
+  })
+});
+
+// src/commands/te-experiment/experiment/conflict-check.ts
+function buildInput(ctx) {
+  const input = {
+    project_id: ctx.num("project-id"),
+    feature_key_list: readRequiredStringArray(ctx, "feature-key-list"),
+    traffic_layer_id: ctx.str("traffic-layer-id")
+  };
+  addOptionalString(input, "exp_id", ctx.str("exp-id"));
+  return input;
+}
+var experimentConflictCheck = createExperimentCapabilityCommand({
+  resource: "experiment",
+  command: "conflict-check",
+  capabilityId: "experiment.experiment.conflict-check",
+  description: "Pre-submit check for cross-layer Feature conflicts on a non-mutex traffic layer.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    {
+      name: "feature-key-list",
+      type: "json",
+      required: true,
+      desc: "Feature keys selected by the current experiment as a JSON string array."
+    },
+    {
+      name: "traffic-layer-id",
+      type: "string",
+      required: true,
+      desc: "Selected non-mutex traffic layer ID."
+    },
+    {
+      name: "exp-id",
+      type: "string",
+      required: false,
+      desc: "Current experiment ID when editing an existing draft."
+    }
+  ],
+  risk: "read",
+  validate: (ctx) => {
+    readRequiredStringArray(ctx, "feature-key-list");
+    if (ctx.str("traffic-layer-id") === "") {
+      throw new Error("Flag --traffic-layer-id is required");
+    }
+  },
+  buildInput
+});
+
+// src/commands/te-experiment/experiment/get.ts
+var experimentGet = createExperimentCapabilityCommand({
+  resource: "experiment",
+  command: "get",
+  capabilityId: "experiment.experiment.get",
+  description: "Get one experiment by ID.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "exp-id", type: "string", required: true, desc: "Experiment ID." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), exp_id: ctx.str("exp-id") })
+});
+
+// src/commands/te-experiment/experiment/list.ts
+function buildInput2(ctx) {
+  const input = {
+    project_id: ctx.num("project-id")
+  };
+  addOptionalString(input, "status", ctx.str("status"));
+  addOptionalString(input, "traffic_layer_id", ctx.str("traffic-layer-id"));
+  addOptionalString(input, "group_id", ctx.str("group-id"));
+  addOptionalString(input, "query_name", ctx.str("query-name"));
+  return input;
+}
+var experimentList = createExperimentCapabilityCommand({
+  resource: "experiment",
+  command: "list",
+  capabilityId: "experiment.experiment.list",
+  description: "List experiments in a project with optional status, traffic layer, group, and name filters.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    {
+      name: "status",
+      type: "string",
+      required: false,
+      desc: "Experiment status filter: draft, testing, pending, running, paused, ended, or archive."
+    },
+    {
+      name: "traffic-layer-id",
+      type: "string",
+      required: false,
+      desc: "Traffic layer ID filter."
+    },
+    {
+      name: "group-id",
+      type: "string",
+      required: false,
+      desc: "Business group ID filter."
+    },
+    {
+      name: "query-name",
+      type: "string",
+      required: false,
+      desc: "Fuzzy match against experiment name (exp_name LIKE)."
+    }
+  ],
+  risk: "read",
+  buildInput: buildInput2
+});
+
+// src/commands/te-experiment/experiment/list-archived.ts
+var experimentListArchived = createExperimentCapabilityCommand({
+  resource: "experiment",
+  command: "list-archived",
+  capabilityId: "experiment.experiment.list-archived",
+  description: "List archived experiments in a project.",
+  flags: [{ name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." }],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id") })
+});
+
+// src/commands/te-experiment/experiment/manage.ts
+var targetStatuses = ["draft", "testing", "pending", "running", "paused", "ended", "archive"];
+function buildInput3(ctx) {
+  const input = {
+    project_id: ctx.num("project-id"),
+    exp_id: ctx.str("exp-id"),
+    target_status: ctx.str("target-status")
+  };
+  addOptionalString(input, "remark", ctx.str("remark"));
+  return input;
+}
+var experimentManage = createExperimentCapabilityCommand({
+  resource: "experiment",
+  command: "manage",
+  capabilityId: "experiment.experiment.manage",
+  description: "Update an experiment status.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "exp-id", type: "string", required: true, desc: "Experiment ID." },
+    { name: "target-status", type: "string", required: true, desc: "Target experiment status." },
+    { name: "remark", type: "string", required: false, desc: "Operation remark." }
+  ],
+  risk: "write",
+  validate: (ctx) => {
+    const value = ctx.str("target-status");
+    if (!targetStatuses.includes(value)) {
+      throw new Error(`Flag --target-status must be one of: ${targetStatuses.join(", ")}`);
+    }
+  },
+  buildInput: buildInput3
+});
+
+// src/commands/te-experiment/experiment/ready-check.ts
+var experimentReadyCheck = createExperimentCapabilityCommand({
+  resource: "experiment",
+  command: "ready-check",
+  capabilityId: "experiment.experiment.ready-check",
+  description: "Check whether an experiment is ready for an online status transition.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "exp-id", type: "string", required: true, desc: "Experiment ID." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), exp_id: ctx.str("exp-id") })
+});
+
+// src/commands/te-experiment/experiment/save.ts
+var experimentSave = createExperimentCapabilityCommand({
+  resource: "experiment",
+  command: "save",
+  capabilityId: "experiment.experiment.save",
+  description: "Create or update an experiment draft.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "req", type: "json", required: true, desc: "Native camelCase experiment save request object." }
+  ],
+  risk: "write",
+  validate: (ctx) => {
+    readRequiredObject(ctx, "req");
+  },
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), req: readRequiredObject(ctx, "req") })
+});
+
+// src/commands/te-experiment/experiment/update-group.ts
+var experimentUpdateGroup = createExperimentCapabilityCommand({
+  resource: "experiment",
+  command: "update-group",
+  capabilityId: "experiment.experiment.update-group",
+  description: "Update the business group of one experiment.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "exp-id", type: "string", required: true, desc: "Experiment ID." },
+    {
+      name: "group-id",
+      type: "string",
+      required: true,
+      desc: 'Target business group ID. Use "0" for ungrouped.'
+    }
+  ],
+  risk: "write",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    exp_id: ctx.str("exp-id"),
+    group_id: ctx.str("group-id")
+  })
+});
+
+// src/commands/te-experiment/feature/batch-delete.ts
+var featureBatchDelete = createExperimentCapabilityCommand({
+  resource: "feature",
+  command: "batch-delete",
+  capabilityId: "experiment.feature.batch-delete",
+  description: "Batch delete Features.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "req", type: "json", required: true, desc: "Native camelCase Feature delete request object." }
+  ],
+  risk: "high-risk-write",
+  validate: (ctx) => {
+    readRequiredObject(ctx, "req");
+  },
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), req: readRequiredObject(ctx, "req") })
+});
+
+// src/commands/te-experiment/feature/get.ts
+function buildInput4(ctx) {
+  const input = {
+    project_id: ctx.num("project-id"),
+    feature_key: ctx.str("feature-key")
+  };
+  addOptionalString(input, "version", ctx.str("version"));
+  return input;
+}
+var featureGet = createExperimentCapabilityCommand({
+  resource: "feature",
+  command: "get",
+  capabilityId: "experiment.feature.get",
+  description: "Get one Feature by key and optional version.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "feature-key", type: "string", required: true, desc: "Feature key." },
+    { name: "version", type: "string", required: false, desc: "Feature version ID." }
+  ],
+  risk: "read",
+  buildInput: buildInput4
+});
+
+// src/commands/te-experiment/feature/list.ts
+var featureList = createExperimentCapabilityCommand({
+  resource: "feature",
+  command: "list",
+  capabilityId: "experiment.feature.list",
+  description: "List Features in a project.",
+  flags: [{ name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." }],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id") })
+});
+
+// src/commands/te-experiment/feature/save.ts
+var featureSave = createExperimentCapabilityCommand({
+  resource: "feature",
+  command: "save",
+  capabilityId: "experiment.feature.save",
+  description: "Create or update a Feature.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "req", type: "json", required: true, desc: "Native camelCase Feature save request object." }
+  ],
+  risk: "write",
+  validate: (ctx) => {
+    readRequiredObject(ctx, "req");
+  },
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), req: readRequiredObject(ctx, "req") })
+});
+
+// src/commands/te-experiment/feature/update-status.ts
+var featureUpdateStatus = createExperimentCapabilityCommand({
+  resource: "feature",
+  command: "update-status",
+  capabilityId: "experiment.feature.update-status",
+  description: "Update a Feature status.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "req", type: "json", required: true, desc: "Native camelCase Feature status request object." }
+  ],
+  risk: "write",
+  validate: (ctx) => {
+    readRequiredObject(ctx, "req");
+  },
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), req: readRequiredObject(ctx, "req") })
+});
+
+// src/commands/te-experiment/feature/version-list.ts
+var featureVersionList = createExperimentCapabilityCommand({
+  resource: "feature",
+  command: "version-list",
+  capabilityId: "experiment.feature.version-list",
+  description: "List Feature version history for one Feature key.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "feature-key", type: "string", required: true, desc: "Feature key." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    feature_key: ctx.str("feature-key")
+  })
+});
+
+// src/commands/te-experiment/feature/operation-log/query.ts
+var featureOperationLogQuery = createExperimentCapabilityCommand({
+  resource: "feature operation-log",
+  command: "query",
+  capabilityId: "experiment.feature.operation-log.query",
+  description: "Query Feature operation logs for one Feature key.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "feature-key", type: "string", required: true, desc: "Feature key." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    feature_key: ctx.str("feature-key")
+  })
+});
+
+// src/commands/te-experiment/metric/delete.ts
+var metricDelete = createExperimentCapabilityCommand({
+  resource: "metric",
+  command: "delete",
+  capabilityId: "experiment.metric.delete",
+  description: "Delete one experiment metric.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "metric-id", type: "string", required: true, desc: "Metric ID." }
+  ],
+  risk: "high-risk-write",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), metric_id: ctx.str("metric-id") })
+});
+
+// src/commands/te-experiment/metric/get.ts
+var metricGet = createExperimentCapabilityCommand({
+  resource: "metric",
+  command: "get",
+  capabilityId: "experiment.metric.get",
+  description: "Get one experiment metric by ID.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "metric-id", type: "string", required: true, desc: "Metric ID." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), metric_id: ctx.str("metric-id") })
+});
+
+// src/commands/te-experiment/metric/list.ts
+var metricList = createExperimentCapabilityCommand({
+  resource: "metric",
+  command: "list",
+  capabilityId: "experiment.metric.list",
+  description: "List experiment metrics in a project.",
+  flags: [{ name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." }],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id") })
+});
+
+// src/commands/te-experiment/metric/save.ts
+var metricSave = createExperimentCapabilityCommand({
+  resource: "metric",
+  command: "save",
+  capabilityId: "experiment.metric.save",
+  description: "Create or update an experiment metric.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "req", type: "json", required: true, desc: "Native camelCase metric save request object." }
+  ],
+  risk: "write",
+  validate: (ctx) => {
+    readRequiredObject(ctx, "req");
+  },
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), req: readRequiredObject(ctx, "req") })
+});
+
+// src/commands/te-experiment/operation-log/query.ts
+var operationLogQuery = createExperimentCapabilityCommand({
+  resource: "operation-log",
+  command: "query",
+  capabilityId: "experiment.operation-log.query",
+  description: "Query full operation logs for one experiment, including remark and structured changes.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "exp-id", type: "string", required: true, desc: "Experiment ID." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    exp_id: ctx.str("exp-id")
+  })
+});
+
+// src/commands/te-experiment/traffic-layer/batch-delete.ts
+var trafficLayerBatchDelete = createExperimentCapabilityCommand({
+  resource: "traffic-layer",
+  command: "batch-delete",
+  capabilityId: "experiment.traffic-layer.batch-delete",
+  description: "Batch delete traffic layers.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "layer-ids", type: "json", required: true, desc: "Traffic layer IDs as a JSON string array." }
+  ],
+  risk: "high-risk-write",
+  validate: (ctx) => {
+    readRequiredStringArray(ctx, "layer-ids");
+  },
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    layer_ids: readRequiredStringArray(ctx, "layer-ids")
+  })
+});
+
+// src/commands/te-experiment/traffic-layer/get.ts
+var trafficLayerGet = createExperimentCapabilityCommand({
+  resource: "traffic-layer",
+  command: "get",
+  capabilityId: "experiment.traffic-layer.get",
+  description: "Get one traffic layer by ID.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "layer-id", type: "string", required: true, desc: "Traffic layer ID." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), layer_id: ctx.str("layer-id") })
+});
+
+// src/commands/te-experiment/traffic-layer/list.ts
+var trafficLayerList = createExperimentCapabilityCommand({
+  resource: "traffic-layer",
+  command: "list",
+  capabilityId: "experiment.traffic-layer.list",
+  description: "List traffic layers in a project.",
+  flags: [{ name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." }],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id") })
+});
+
+// src/commands/te-experiment/traffic-layer/save.ts
+var trafficLayerSave = createExperimentCapabilityCommand({
+  resource: "traffic-layer",
+  command: "save",
+  capabilityId: "experiment.traffic-layer.save",
+  description: "Create or update a traffic layer.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "req", type: "json", required: true, desc: "Native camelCase traffic layer save request object." }
+  ],
+  risk: "write",
+  validate: (ctx) => {
+    readRequiredObject(ctx, "req");
+  },
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), req: readRequiredObject(ctx, "req") })
+});
+
+// src/commands/te-experiment/index.ts
+registerCapabilityGatewayRoute("experiment", { gatewayDomain: "engage" });
+var commands = [
+  experimentSave,
+  experimentList,
+  experimentListArchived,
+  experimentGet,
+  experimentReadyCheck,
+  experimentConflictCheck,
+  experimentManage,
+  experimentUpdateGroup,
+  experimentBatchDelete,
+  operationLogQuery,
+  trafficLayerSave,
+  trafficLayerGet,
+  trafficLayerList,
+  trafficLayerBatchDelete,
+  metricSave,
+  metricGet,
+  metricList,
+  metricDelete,
+  featureSave,
+  featureUpdateStatus,
+  featureGet,
+  featureList,
+  featureVersionList,
+  featureOperationLogQuery,
+  featureBatchDelete,
+  bucketList
+];
+var te_experiment_default = commands;
+export {
+  bucketList,
+  te_experiment_default as default,
+  experimentBatchDelete,
+  experimentConflictCheck,
+  experimentGet,
+  experimentList,
+  experimentListArchived,
+  experimentManage,
+  experimentReadyCheck,
+  experimentSave,
+  experimentUpdateGroup,
+  featureBatchDelete,
+  featureGet,
+  featureList,
+  featureOperationLogQuery,
+  featureSave,
+  featureUpdateStatus,
+  featureVersionList,
+  metricDelete,
+  metricGet,
+  metricList,
+  metricSave,
+  operationLogQuery,
+  trafficLayerBatchDelete,
+  trafficLayerGet,
+  trafficLayerList,
+  trafficLayerSave
+};

package/dist/{te-kb-CIZXRWMO.js → te-kb-E7NSCBRB.js}

@@ -11,18 +11,37 @@ import "./chunk-LYVNONC4.js";
 // src/commands/te-kb/query.ts
 var API_PATH = "/agent/api/external/knowledge-bases/query";
 function buildBody(ctx) {
-  return {
-    query: ctx.str("query"),
-    sources: ctx.json("sources")
+  const body = {
+    query: ctx.str("query")
   };
+  const sources = ctx.json("sources");
+  if (sources) body.sources = sources;
+  const topK = ctx.num("top-k");
+  if (topK) body.topK = topK;
+  const locale = ctx.str("locale");
+  if (locale) body.locale = locale;
+  return body;
 }
 var query = {
   service: "kb",
   command: "+query",
-  description: "Query knowledge.",
+  description: "Query knowledge bases via POST /agent/api/external/knowledge-bases/query. Returns ranked passages for a natural-language question.",
   flags: [
-    { name: "query", type: "string", required: true, alias: "q", desc: "Natural language question to query against the knowledge bases" },
-    { name: "sources", type: "json", required: true, desc: 'JSON array of knowledge base refs, e.g. [{"scope":"company","name":"engineering-handbook"}]' }
+    {
+      name: "query",
+      type: "string",
+      required: true,
+      alias: "q",
+      desc: "Natural language question to query against the knowledge bases"
+    },
+    {
+      name: "sources",
+      type: "json",
+      required: false,
+      desc: 'Optional JSON array of knowledge base refs to scope the query, e.g. [{"scope":"company","name":"engineering-handbook"}]. Omit to search all accessible knowledge bases.'
+    },
+    { name: "top-k", type: "number", required: false, desc: "Max number of hits to return (1-10000, default 10)" },
+    { name: "locale", type: "string", required: false, desc: "Optional locale: zh | en | ja | ko" }
   ],
   risk: "read",
   dryRun: (ctx) => ({