@thinkingai/ae-cli 6.0.30 → 6.0.31

package/dist/{te-engage-545HJL6J.js → te-engage-EPE3QKDE.js}

@@ -1,15 +1,391 @@
+import {
+  createCapabilityCommand
+} from "./chunk-N2QORU5D.js";
+import {
+  registerCapabilityGatewayRoute
+} from "./chunk-HL2AJQ4Q.js";
+import "./chunk-DYOS6YY7.js";
+import {
+  printError
+} from "./chunk-TNW2CI4W.js";
 import {
   callMcpTool,
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-7QQ4233A.js";
+} from "./chunk-6LEYLOV3.js";
 import "./chunk-KGJQCYVC.js";
 import "./chunk-NOO24N7W.js";
 import "./chunk-2NDGFQHW.js";
 import "./chunk-AJTH7LT3.js";
 import "./chunk-YCLVYFK7.js";
 
+// src/commands/te-engage/shared.ts
+function createEngageCapabilityCommand(cliService, config) {
+  return createCapabilityCommand({
+    ...config,
+    cliService,
+    gatewayDomain: "engage"
+  });
+}
+function createEngageFlowCapabilityCommand(config) {
+  return createEngageCapabilityCommand("engage-flow", config);
+}
+function createEngageTaskCapabilityCommand(config) {
+  return createEngageCapabilityCommand("engage-task", config);
+}
+function createEngageSettingCapabilityCommand(config) {
+  return createEngageCapabilityCommand("engage-setting", config);
+}
+
+// src/commands/te-engage/engage-flow/operation-log/query.ts
+var operationLogQuery = createEngageFlowCapabilityCommand({
+  resource: "operation-log",
+  command: "query",
+  capabilityId: "engage-flow.operation-log.query",
+  description: "Query aggregated flow operation records and application logs for troubleshooting submission, approval, registration, execution, and distribution issues.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "flow-uuid", type: "string", required: true, desc: "Flow UUID to inspect." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), flow_uuid: ctx.str("flow-uuid") })
+});
+
+// src/commands/te-engage/engage-flow/version/list.ts
+var versionList = createEngageFlowCapabilityCommand({
+  resource: "version",
+  command: "list",
+  capabilityId: "engage-flow.version.list",
+  description: "List current, historical, new, update, and test versions for a flow.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "flow-id", type: "string", required: true, desc: "Flow ID whose versions should be listed." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), flow_id: ctx.str("flow-id") })
+});
+
+// src/commands/te-engage/engage-flow/index.ts
+var commands = [
+  operationLogQuery,
+  // testRun, // temporarily disabled: ae-cli engage-flow test run
+  versionList
+];
+var engage_flow_default = commands;
+
+// src/commands/te-engage/engage-setting/channel-touch-limits/list.ts
+var channelTouchLimitsList = createEngageSettingCapabilityCommand({
+  resource: "channel-touch-limits",
+  command: "list",
+  capabilityId: "engage-setting.channel-touch-limits.list",
+  description: "List channel touch-limit rules in a project. Requires channel view permission.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p" }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id")
+  })
+});
+
+// src/commands/te-engage/engage-setting/index.ts
+var commands2 = [channelTouchLimitsList];
+var engage_setting_default = commands2;
+
+// src/commands/te-engage/engage-task/channel-ref/stats.ts
+var channelRefStats = createEngageTaskCapabilityCommand({
+  resource: "channel-ref",
+  command: "stats",
+  capabilityId: "engage-task.channel-ref.stats",
+  description: "Query engagement-task reference counts for a channel.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "channel-id", type: "string", required: true, desc: "Channel ID." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    channel_id: ctx.str("channel-id")
+  })
+});
+
+// src/commands/te-engage/engage-task/group/create.ts
+var groupCreate = createEngageTaskCapabilityCommand({
+  resource: "group",
+  command: "create",
+  capabilityId: "engage-task.group.create",
+  description: "Create a task group.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "group-name", type: "string", required: true, desc: "Task group name." }
+  ],
+  risk: "write",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    group_name: ctx.str("group-name")
+  })
+});
+
+// src/commands/te-engage/engage-task/group/list.ts
+var groupList = createEngageTaskCapabilityCommand({
+  resource: "group",
+  command: "list",
+  capabilityId: "engage-task.group.list",
+  description: "List task groups 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-engage/engage-task/group/update.ts
+var groupUpdate = createEngageTaskCapabilityCommand({
+  resource: "group",
+  command: "update",
+  capabilityId: "engage-task.group.update",
+  description: "Rename a task group.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "group-id", type: "number", required: true, desc: "Task group ID." },
+    { name: "group-name", type: "string", required: true, desc: "New task group name." }
+  ],
+  risk: "write",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    group_id: ctx.num("group-id"),
+    group_name: ctx.str("group-name")
+  })
+});
+
+// src/commands/te-engage/engage-task/metric/list.ts
+var metricList = createEngageTaskCapabilityCommand({
+  resource: "metric",
+  command: "list",
+  capabilityId: "engage-task.metric.list",
+  description: "List metric settings configured for an engagement task.",
+  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." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    task_id: ctx.str("task-id")
+  })
+});
+
+// src/commands/te-engage/engage-task/metric/update.ts
+var metricUpdate = createEngageTaskCapabilityCommand({
+  resource: "metric",
+  command: "update",
+  capabilityId: "engage-task.metric.update",
+  description: "Update metric settings for an engagement task.",
+  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: "metric-map",
+      type: "json",
+      required: true,
+      desc: "Metric configuration map keyed by metric group."
+    }
+  ],
+  risk: "write",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    task_id: ctx.str("task-id"),
+    metric_map: ctx.json("metric-map")
+  })
+});
+
+// src/commands/te-engage/engage-task/operation-log/query.ts
+var operationLogQuery2 = createEngageTaskCapabilityCommand({
+  resource: "operation-log",
+  command: "query",
+  capabilityId: "engage-task.operation-log.query",
+  description: "Query task operation records and runtime logs for creation, changes, approval, sending, pauses, and completion.",
+  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." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({ project_id: ctx.num("project-id"), task_id: ctx.str("task-id") })
+});
+
+// src/commands/te-engage/engage-task/ops/delete.ts
+var opsDelete = createEngageTaskCapabilityCommand({
+  resource: "ops",
+  command: "delete",
+  capabilityId: "engage-task.ops.delete",
+  description: "Delete an engagement task.",
+  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." }
+  ],
+  risk: "high-risk-write",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    task_id: ctx.str("task-id")
+  })
+});
+
+// src/commands/te-engage/engage-task/ops/modify-group.ts
+var opsModifyGroup = createEngageTaskCapabilityCommand({
+  resource: "ops",
+  command: "modify-group",
+  capabilityId: "engage-task.ops.modify-group",
+  description: "Change the group assignment of an engagement task.",
+  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: "group-id",
+      type: "number",
+      required: true,
+      desc: "Task group ID. Use 0 for the default group."
+    }
+  ],
+  risk: "write",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    task_id: ctx.str("task-id"),
+    group_id: ctx.num("group-id")
+  })
+});
+
+// src/commands/te-engage/engage-task/push-record/query.ts
+var ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+var pushRecordQuery = createEngageTaskCapabilityCommand({
+  resource: "push-record",
+  command: "query",
+  capabilityId: "engage-task.push-record.query",
+  description: "Query task delivery and push records, including trigger, send, success, and failure details.",
+  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: "page-num", type: "number", required: false, desc: "Page number for scheduled tasks. Defaults to 1." },
+    { name: "page-size", type: "number", required: false, desc: "Page size for scheduled tasks. Defaults to 20." },
+    {
+      name: "start-date",
+      type: "string",
+      required: false,
+      desc: "Optional start date in yyyy-MM-dd format. Must not be after --end-date."
+    },
+    {
+      name: "end-date",
+      type: "string",
+      required: false,
+      desc: "Optional end date in yyyy-MM-dd format. Must not be before --start-date."
+    }
+  ],
+  risk: "read",
+  validate: (ctx) => {
+    const startDate = ctx.str("start-date");
+    const endDate = ctx.str("end-date");
+    if (startDate && !ISO_DATE.test(startDate)) {
+      printError("validation", "--start-date must be in yyyy-MM-dd format");
+      process.exit(1);
+    }
+    if (endDate && !ISO_DATE.test(endDate)) {
+      printError("validation", "--end-date must be in yyyy-MM-dd format");
+      process.exit(1);
+    }
+    if (startDate && endDate && startDate > endDate) {
+      printError("validation", "--start-date must not be after --end-date");
+      process.exit(1);
+    }
+  },
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    task_id: ctx.str("task-id"),
+    page_num: ctx.optionalNum("page-num"),
+    page_size: ctx.optionalNum("page-size"),
+    start_date: ctx.str("start-date") || void 0,
+    end_date: ctx.str("end-date") || void 0
+  })
+});
+
+// src/commands/te-engage/engage-task/segment-list/get.ts
+var segmentListGet = createEngageTaskCapabilityCommand({
+  resource: "segment-list",
+  command: "get",
+  capabilityId: "engage-task.segment-list.get",
+  description: "Get one segment associated with an engagement task by cluster ID.",
+  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: "cluster-id", type: "string", required: true, desc: "Segment cluster ID." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    task_id: ctx.str("task-id"),
+    cluster_id: ctx.str("cluster-id")
+  })
+});
+
+// src/commands/te-engage/engage-task/segment-list/query.ts
+var segmentListQuery = createEngageTaskCapabilityCommand({
+  resource: "segment-list",
+  command: "query",
+  capabilityId: "engage-task.segment-list.query",
+  description: "Query segments created from or associated with an engagement task.",
+  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." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    task_id: ctx.str("task-id")
+  })
+});
+
+// src/commands/te-engage/engage-task/segment-list/rename.ts
+var segmentListRename = createEngageTaskCapabilityCommand({
+  resource: "segment-list",
+  command: "rename",
+  capabilityId: "engage-task.segment-list.rename",
+  description: "Rename the display name of a task-associated segment.",
+  flags: [
+    { name: "project-id", type: "number", required: true, alias: "p", desc: "Numeric project ID." },
+    { name: "cluster-id", type: "string", required: true, desc: "Segment cluster ID." },
+    { name: "display-name", type: "string", required: true, desc: "New segment display name." }
+  ],
+  risk: "write",
+  buildInput: (ctx) => ({
+    project_id: ctx.num("project-id"),
+    cluster_id: ctx.str("cluster-id"),
+    display_name: ctx.str("display-name")
+  })
+});
+
+// src/commands/te-engage/engage-task/index.ts
+var commands3 = [
+  channelRefStats,
+  groupCreate,
+  // groupDelete, // temporarily disabled: ae-cli engage-task group delete
+  groupList,
+  groupUpdate,
+  metricList,
+  metricUpdate,
+  operationLogQuery2,
+  opsDelete,
+  opsModifyGroup,
+  // opsSubmitApproval, // temporarily disabled: ae-cli engage-task ops submit-approval
+  pushRecordQuery,
+  // raceRelease, // temporarily disabled: ae-cli engage-task race release
+  segmentListGet,
+  segmentListQuery,
+  segmentListRename
+  // segmentListSetVisibility, // temporarily disabled: ae-cli engage-task segment-list set-visibility
+];
+var engage_task_default = commands3;
+
 // src/commands/te-engage/utils.ts
 function buildMcpDryRun(ctx, serviceName46, toolName46, args) {
   const host = ctx.host();
@@ -395,7 +771,7 @@ var strategyList = {
 };
 
 // src/commands/te-engage/config/index.ts
-var commands = [
+var commands4 = [
   configItemTriggerReport,
   configItemAnalysisReport,
   configItemStrategyComparison,
@@ -407,7 +783,7 @@ var commands = [
   strategyDetail,
   manageStrategy
 ];
-var config_default = commands;
+var config_default = commands4;
 
 // src/commands/te-engage/flow/delete-flow.ts
 var serviceName11 = "engage_flow";
@@ -844,7 +1220,7 @@ var validateFlowNodeConfig = {
 };
 
 // src/commands/te-engage/flow/index.ts
-var commands2 = [
+var commands5 = [
   flowNodeOverviewReport,
   flowProcessReport,
   flowNodeDetailReport,
@@ -858,7 +1234,7 @@ var commands2 = [
   flowList,
   saveFlow
 ];
-var flow_default = commands2;
+var flow_default = commands5;
 
 // src/commands/te-engage/setting/add-approver.ts
 var serviceName23 = "engage_setting";
@@ -1145,7 +1521,7 @@ var whitelistList = {
 };
 
 // src/commands/te-engage/setting/index.ts
-var commands3 = [
+var commands6 = [
   channelList,
   channelDetail,
   updateChannelStatus,
@@ -1160,7 +1536,7 @@ var commands3 = [
   deleteConfigChannel,
   updateConfigChannelStatus
 ];
-var setting_default = commands3;
+var setting_default = commands6;
 
 // src/commands/te-engage/task/build-task-save-guide.ts
 var serviceName36 = "engage_task";
@@ -1497,7 +1873,7 @@ var taskStats = {
 };
 
 // src/commands/te-engage/task/index.ts
-var commands4 = [
+var commands7 = [
   taskDataOverview,
   taskDataDetail,
   taskMetricDetail,
@@ -1509,17 +1885,28 @@ var commands4 = [
   saveTask,
   manageTask
 ];
-var task_default = commands4;
+var task_default = commands7;
 
 // src/commands/te-engage/index.ts
+registerCapabilityGatewayRoute("engage-flow", { gatewayDomain: "engage" });
+registerCapabilityGatewayRoute("engage-task", { gatewayDomain: "engage" });
+registerCapabilityGatewayRoute("engage-setting", { gatewayDomain: "engage" });
 registerMcpMappings({
   "engage_config": { componentName: "engage", mappingPath: "config" },
   "engage_flow": { componentName: "engage", mappingPath: "flow" },
   "engage_setting": { componentName: "engage", mappingPath: "setting" },
   "engage_task": { componentName: "engage", mappingPath: "task" }
 });
-var commands5 = [...setting_default, ...task_default, ...config_default, ...flow_default];
-var te_engage_default = commands5;
+var commands8 = [
+  ...setting_default,
+  ...task_default,
+  ...config_default,
+  ...flow_default,
+  ...engage_flow_default,
+  ...engage_task_default,
+  ...engage_setting_default
+];
+var te_engage_default = commands8;
 export {
   te_engage_default as default
 };

package/dist/{te-meta-FADFLTDM.js → te-meta-MAAUHFQO.js}

@@ -2,7 +2,7 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-GWZ5MYWE.js";
+} from "./chunk-PKRD2IEM.js";
 import "./chunk-KGJQCYVC.js";
 import "./chunk-NOO24N7W.js";
 import "./chunk-2NDGFQHW.js";
@@ -66,7 +66,7 @@ var listEvents = createMcpCommand({
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "query", type: "string", required: false, desc: "Optional keyword filter. Fuzzy match is applied to eventName, eventDesc, and remark; if omitted, all events are returned.", alias: "q" },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported fields: eventId, eventName, eventDesc, remark, eventTag, authenticationStatus. Default fields when omitted: eventId, eventName, eventDesc, remark, authenticationStatus.", alias: "f" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 20, maximum: 50.", alias: "l" },
+    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 50, maximum: 200.", alias: "l", min: 1, max: 200 },
     { name: "offset", type: "number", required: false, desc: "Optional page offset. Default: 0.", alias: "o" },
     { name: "authenticated_only", type: "boolean", required: false, desc: "When true, return only authenticated events." }
   ],
@@ -91,7 +91,7 @@ var listProperties = createMcpCommand({
     { name: "event_name", type: "string", required: false, desc: "Optional event name filter" },
     { name: "query", type: "string", required: false, desc: "Optional keyword filter. Fuzzy match is applied to propName, propDesc, and remark; if omitted, all accessible properties are returned.", alias: "q" },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported fields: propId, propName, propDesc, remark, selectType, tableType, subTableType, authenticationStatus. Default fields when omitted: propId, propName, propDesc, remark, selectType, tableType, authenticationStatus.", alias: "f" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 20, maximum: 50.", alias: "l" },
+    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 50, maximum: 200.", alias: "l", min: 1, max: 200 },
     { name: "offset", type: "number", required: false, desc: "Optional page offset. Default: 0.", alias: "o" },
     { name: "authenticated_only", type: "boolean", required: false, desc: "When true, return only authenticated properties." }
   ],
@@ -205,12 +205,12 @@ var createVirtualProperty = createMcpCommand({
 // src/commands/te-meta/meta/list-metrics.ts
 var listMetrics = createMcpCommand({
   command: "+list_metrics",
-  description: "List metric metadata in the project. Use for metric metadata inspection/management, not as a pre-step for event/retention/funnel/prop_analysis ad-hoc builders. For event saved metric queries, pass the metric name directly to +build_event_analysis_qp in metrics[].event. Query performs fuzzy matching on metricName, metricDesc, and metricRemark. Supports authenticated asset filtering plus fields/limit/offset pagination. Default returned fields: metricId, metricName, metricDesc, metricRemark, metricMode, authenticationStatus.",
+  description: "List metric metadata in the project. Use for metric metadata inspection/management. For AI-facing analysis definitions, reference saved metrics by verified metric name in the analysis definition instead of calling old QP builders. Query performs fuzzy matching on metricName, metricDesc, and metricRemark. Supports authenticated asset filtering plus fields/limit/offset pagination. Default returned fields: metricId, metricName, metricDesc, metricRemark, metricMode, authenticationStatus.",
   flags: [
     { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
     { name: "query", type: "string", required: false, alias: "q", desc: "Optional keyword filter. Fuzzy match on metricName, metricDesc, metricRemark." },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported: metricId, metricName, metricDesc, metricRemark, metricMode, authenticationStatus, openId, creator, creatorLoginName, updateOpenId, updateCreator, updateLoginName, createTime, updateTime. Default fields when omitted: metricId, metricName, metricDesc, metricRemark, metricMode, authenticationStatus." },
-    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 20, maximum: 50." },
+    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 50, maximum: 200.", min: 1, max: 200 },
     { name: "offset", type: "number", required: false, desc: "Optional offset. Default: 0." },
     { name: "authenticated_only", type: "boolean", required: false, desc: "When true, return only authenticated metrics." }
   ],
@@ -229,7 +229,7 @@ var listMetrics = createMcpCommand({
 // src/commands/te-meta/meta/get-metric.ts
 var getMetric = createMcpCommand({
   command: "+get_metric",
-  description: "Get the definition details of a single metric. Use for metric metadata inspection/management, not as a pre-step for event ad-hoc builder; pass saved metric names directly to +build_event_analysis_qp in metrics[].event.",
+  description: "Get the definition details of a single metric. Use for metric metadata inspection/management. For AI-facing analysis definitions, reference saved metrics by verified metric name instead of calling old QP builders.",
   flags: [
     { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
     { name: "metric_id", type: "number", required: true, alias: "m", desc: "Metric ID" }
@@ -252,7 +252,7 @@ var createMetric = createMcpCommand({
     { name: "display_name", type: "string", required: true, desc: "Metric display name" },
     { name: "remark", type: "string", required: false, desc: "Optional metric remark" },
     { name: "model_type", type: "string", required: true, desc: "Metric model type: event or retention" },
-    { name: "events", type: "json", required: true, desc: "Metric events JSON. Use get_analysis_query_schema first to obtain the schema." },
+    { name: "events", type: "json", required: true, desc: "Metric events JSON. Follow the create_metric reference for the metric event contract." },
     { name: "params", type: "json", required: true, desc: "Metric parameters JSON. For event, use format config; for retention, use the eventView configuration." }
   ],
   risk: "write",
@@ -489,7 +489,7 @@ var listProjectMarkTimes = createMcpCommand({
     { name: "zone_offset", type: "number", required: false, desc: "Marker time zone offset" },
     { name: "query", type: "string", required: false, alias: "q", desc: "Optional keyword filter. Fuzzy match on markContent." },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported: id, projectId, markTime, userZoneTime, zoneOffset, markContent, isShow, creatorName, creatorId, lastModifierName, lastModifierId, createTime, updateTime." },
-    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 20, maximum: 10000." },
+    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 50, maximum: 200.", min: 1, max: 200 },
     { name: "offset", type: "number", required: false, desc: "Optional offset. Default: 0." }
   ],
   risk: "read",
@@ -545,7 +545,7 @@ var listEntities = createMcpCommand({
     { name: "event_name", type: "string", required: false, desc: "Optional event name filter" },
     { name: "query", type: "string", required: false, desc: "Optional keyword filter. Fuzzy match is applied to entityName, columnName, and columnDesc; if omitted, all entities are returned.", alias: "q" },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported fields: entityId, entityName, columnName, columnDesc, selectType, tableType, entityType. Default fields when omitted: entityId, entityName, columnName, columnDesc, selectType.", alias: "f" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 20, maximum: 10000.", alias: "l" },
+    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 50, maximum: 200.", alias: "l", min: 1, max: 200 },
     { name: "offset", type: "number", required: false, desc: "Optional page offset. Default: 0.", alias: "o" }
   ],
   risk: "read",

package/dist/{te-meta-PKT27OTN.js → te-meta-VKWNAWO4.js}

@@ -2,7 +2,7 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-7QQ4233A.js";
+} from "./chunk-6LEYLOV3.js";
 import "./chunk-KGJQCYVC.js";
 import "./chunk-NOO24N7W.js";
 import "./chunk-2NDGFQHW.js";
@@ -66,7 +66,7 @@ var listEvents = createMcpCommand({
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "query", type: "string", required: false, desc: "Optional keyword filter. Fuzzy match is applied to eventName, eventDesc, and remark; if omitted, all events are returned.", alias: "q" },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported fields: eventId, eventName, eventDesc, remark, eventTag, authenticationStatus. Default fields when omitted: eventId, eventName, eventDesc, remark, authenticationStatus.", alias: "f" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 20, maximum: 50.", alias: "l" },
+    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 50, maximum: 200.", alias: "l", min: 1, max: 200 },
     { name: "offset", type: "number", required: false, desc: "Optional page offset. Default: 0.", alias: "o" },
     { name: "authenticated_only", type: "boolean", required: false, desc: "When true, return only authenticated events." }
   ],
@@ -91,7 +91,7 @@ var listProperties = createMcpCommand({
     { name: "event_name", type: "string", required: false, desc: "Optional event name filter" },
     { name: "query", type: "string", required: false, desc: "Optional keyword filter. Fuzzy match is applied to propName, propDesc, and remark; if omitted, all accessible properties are returned.", alias: "q" },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported fields: propId, propName, propDesc, remark, selectType, tableType, subTableType, authenticationStatus. Default fields when omitted: propId, propName, propDesc, remark, selectType, tableType, authenticationStatus.", alias: "f" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 20, maximum: 50.", alias: "l" },
+    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 50, maximum: 200.", alias: "l", min: 1, max: 200 },
     { name: "offset", type: "number", required: false, desc: "Optional page offset. Default: 0.", alias: "o" },
     { name: "authenticated_only", type: "boolean", required: false, desc: "When true, return only authenticated properties." }
   ],
@@ -205,12 +205,12 @@ var createVirtualProperty = createMcpCommand({
 // src/commands/te-meta/meta/list-metrics.ts
 var listMetrics = createMcpCommand({
   command: "+list_metrics",
-  description: "List metric metadata in the project. Use for metric metadata inspection/management, not as a pre-step for event/retention/funnel/prop_analysis ad-hoc builders. For event saved metric queries, pass the metric name directly to +build_event_analysis_qp in metrics[].event. Query performs fuzzy matching on metricName, metricDesc, and metricRemark. Supports authenticated asset filtering plus fields/limit/offset pagination. Default returned fields: metricId, metricName, metricDesc, metricRemark, metricMode, authenticationStatus.",
+  description: "List metric metadata in the project. Use for metric metadata inspection/management. For AI-facing analysis definitions, reference saved metrics by verified metric name in the analysis definition instead of calling old QP builders. Query performs fuzzy matching on metricName, metricDesc, and metricRemark. Supports authenticated asset filtering plus fields/limit/offset pagination. Default returned fields: metricId, metricName, metricDesc, metricRemark, metricMode, authenticationStatus.",
   flags: [
     { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
     { name: "query", type: "string", required: false, alias: "q", desc: "Optional keyword filter. Fuzzy match on metricName, metricDesc, metricRemark." },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported: metricId, metricName, metricDesc, metricRemark, metricMode, authenticationStatus, openId, creator, creatorLoginName, updateOpenId, updateCreator, updateLoginName, createTime, updateTime. Default fields when omitted: metricId, metricName, metricDesc, metricRemark, metricMode, authenticationStatus." },
-    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 20, maximum: 50." },
+    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 50, maximum: 200.", min: 1, max: 200 },
     { name: "offset", type: "number", required: false, desc: "Optional offset. Default: 0." },
     { name: "authenticated_only", type: "boolean", required: false, desc: "When true, return only authenticated metrics." }
   ],
@@ -229,7 +229,7 @@ var listMetrics = createMcpCommand({
 // src/commands/te-meta/meta/get-metric.ts
 var getMetric = createMcpCommand({
   command: "+get_metric",
-  description: "Get the definition details of a single metric. Use for metric metadata inspection/management, not as a pre-step for event ad-hoc builder; pass saved metric names directly to +build_event_analysis_qp in metrics[].event.",
+  description: "Get the definition details of a single metric. Use for metric metadata inspection/management. For AI-facing analysis definitions, reference saved metrics by verified metric name instead of calling old QP builders.",
   flags: [
     { name: "project_id", type: "number", required: true, alias: "p", desc: "Project ID" },
     { name: "metric_id", type: "number", required: true, alias: "m", desc: "Metric ID" }
@@ -252,7 +252,7 @@ var createMetric = createMcpCommand({
     { name: "display_name", type: "string", required: true, desc: "Metric display name" },
     { name: "remark", type: "string", required: false, desc: "Optional metric remark" },
     { name: "model_type", type: "string", required: true, desc: "Metric model type: event or retention" },
-    { name: "events", type: "json", required: true, desc: "Metric events JSON. Use get_analysis_query_schema first to obtain the schema." },
+    { name: "events", type: "json", required: true, desc: "Metric events JSON. Follow the create_metric reference for the metric event contract." },
     { name: "params", type: "json", required: true, desc: "Metric parameters JSON. For event, use format config; for retention, use the eventView configuration." }
   ],
   risk: "write",
@@ -489,7 +489,7 @@ var listProjectMarkTimes = createMcpCommand({
     { name: "zone_offset", type: "number", required: false, desc: "Marker time zone offset" },
     { name: "query", type: "string", required: false, alias: "q", desc: "Optional keyword filter. Fuzzy match on markContent." },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported: id, projectId, markTime, userZoneTime, zoneOffset, markContent, isShow, creatorName, creatorId, lastModifierName, lastModifierId, createTime, updateTime." },
-    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 20, maximum: 10000." },
+    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 50, maximum: 200.", min: 1, max: 200 },
     { name: "offset", type: "number", required: false, desc: "Optional offset. Default: 0." }
   ],
   risk: "read",
@@ -545,7 +545,7 @@ var listEntities = createMcpCommand({
     { name: "event_name", type: "string", required: false, desc: "Optional event name filter" },
     { name: "query", type: "string", required: false, desc: "Optional keyword filter. Fuzzy match is applied to entityName, columnName, and columnDesc; if omitted, all entities are returned.", alias: "q" },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported fields: entityId, entityName, columnName, columnDesc, selectType, tableType, entityType. Default fields when omitted: entityId, entityName, columnName, columnDesc, selectType.", alias: "f" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 20, maximum: 10000.", alias: "l" },
+    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 50, maximum: 200.", alias: "l", min: 1, max: 200 },
     { name: "offset", type: "number", required: false, desc: "Optional page offset. Default: 0.", alias: "o" }
   ],
   risk: "read",