@thinkingai/ae-cli 1.0.28 → 6.0.16

package/dist/{te-analysis-A2OSGHQ4.js → te-analysis-VAR4KUOK.js}

@@ -2,12 +2,13 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-WCHI7725.js";
+} from "./chunk-DMMEPCST.js";
 import {
   isGlobalQueryModeEnabled
-} from "./chunk-GSJGPNKK.js";
-import "./chunk-CAQYQA4R.js";
-import "./chunk-SRJIAOBN.js";
+} from "./chunk-PN3OS34E.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-RSHMZ3LG.js";
+import "./chunk-6W4QOZAL.js";
 
 // src/commands/te-analysis/shared.ts
 function createMcpCommand(config) {
@@ -77,7 +78,7 @@ function optionalClusterQueryArgs(ctx) {
   };
 }
 var DEFAULT_QUERY_LIMIT = 1e3;
-var MAX_QUERY_LIMIT = 1e5;
+var MAX_QUERY_LIMIT = 1e4;
 function assertLimitWithinCap(value, flagName) {
   if (value === void 0) return;
   if (!Number.isInteger(value) || value < 1 || value > MAX_QUERY_LIMIT) {
@@ -146,7 +147,7 @@ var listAlerts = createMcpCommand({
   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. Performs fuzzy matching against alert names; if omitted, all alerts are returned." },
-    { name: "limit", type: "number", required: false, alias: "l", desc: "Optional page size. Default: 20, maximum: 50." },
+    { name: "limit", type: "number", required: false, alias: "l", desc: "Optional page size. Default: 20, maximum: 10000." },
     { name: "offset", type: "number", required: false, alias: "o", desc: "Optional page offset. Default: 0." }
   ],
   risk: "read",
@@ -227,7 +228,7 @@ var listReports = createMcpCommand({
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "query", type: "string", required: false, desc: "Optional keyword filter. Performs fuzzy matching against report names, descriptions, and AI remarks; if omitted, all accessible reports are returned.", alias: "q" },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported fields: reportId, reportName, reportDesc, reportModel, aiRemark.", 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: 20, maximum: 10000.", alias: "l" },
     { name: "offset", type: "number", required: false, desc: "Optional page offset. Default: 0.", alias: "o" }
   ],
   risk: "read",
@@ -258,13 +259,13 @@ var getReportDefinition = createMcpCommand({
 // src/commands/te-analysis/report/query-report-data.ts
 var queryReportData = createMcpCommand({
   command: "+query_report_data",
-  description: "Query analysis data for one or more reports. Supports extra filters, group-by settings, and time range overrides.",
+  description: "Query analysis data for one or more reports. Supports extra filters, group-by settings, and time range overrides. For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "report_ids", type: "json", required: true, desc: "List of report IDs" },
     { name: "filters", type: "json", required: false, desc: "Optional filter JSON. See +get_filter_schema for the structure." },
     { name: "group_by", type: "json", required: false, desc: "Optional group-by JSON array. See +get_groupby_schema for the structure." },
-    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID. Generated automatically if omitted." },
+    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
     { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true" },
     { name: "start_date", type: "string", required: false, desc: "Optional start date in yyyy-MM-dd format" },
     { name: "end_date", type: "string", required: false, desc: "Optional end date in yyyy-MM-dd format" },
@@ -332,7 +333,7 @@ var listDashboards = createMcpCommand({
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "query", type: "string", required: false, desc: "Optional keyword filter. Performs fuzzy matching against dashboard names and AI remarks; if omitted, all accessible dashboards are returned.", alias: "q" },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported fields: dashboardId, dashboardName, aiRemark.", 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: 20, maximum: 10000.", alias: "l" },
     { name: "offset", type: "number", required: false, desc: "Optional page offset. Default: 0.", alias: "o" }
   ],
   risk: "read",
@@ -345,6 +346,87 @@ var listDashboards = createMcpCommand({
   })
 });
 
+// src/commands/te-analysis/dashboard/list-bi-panels.ts
+var listBiPanels = createMcpCommand({
+  command: "+list_bi_panels",
+  description: "List BI panels accessible to the current MCP user in a project. Use this before requesting BI panel structure or data. Does not return pages, charts, controls, raw config, SQL, or permission-rule details.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "query", type: "string", required: false, desc: "Optional keyword filter. Fuzzy matches BI panel names.", alias: "q" },
+    { name: "fields", type: "json", required: false, desc: "Optional returned fields. Supported values: panelId, name, spaceId, spaceName, ownerName, updatedAt, pageCount, hasSummary.", alias: "f" },
+    { name: "limit", type: "number", required: false, desc: "Optional page size. Default: 20, maximum: 10000.", alias: "l" },
+    { name: "offset", type: "number", required: false, desc: "Optional page offset. Default: 0.", alias: "o" }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    query: optionalString(ctx, "query"),
+    fields: optionalJson(ctx, "fields"),
+    limit: optionalNumber(ctx, "limit"),
+    offset: optionalNumber(ctx, "offset")
+  })
+});
+
+// src/commands/te-analysis/dashboard/get-bi-panel-detail.ts
+var getBiPanelDetail = createMcpCommand({
+  command: "+get_bi_panel_detail",
+  description: "Get a BI panel released structure without querying data. Use this after list_bi_panels to inspect pages, queryable charts, summary, dashboard-level controls, and page chart filter controls.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "panel_id", type: "number", required: true, desc: "BI panel ID returned by +list_bi_panels" },
+    { name: "fields", type: "json", required: false, desc: "Optional detail sections. Supported values: basic, pages, charts, parameterControls, permissionControls, chartFilterControls, summary.", alias: "f" }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    panelId: ctx.num("panel_id"),
+    fields: optionalJson(ctx, "fields")
+  })
+});
+
+// src/commands/te-analysis/dashboard/query-bi-panel-data.ts
+var queryBiPanelData = createMcpCommand({
+  command: "+query_bi_panel_data",
+  description: "Query released BI panel data. Use result_type=charts for page chart data as columns and rows, or result_type=summary for summary markdown and blocks. Call get_bi_panel_detail first to obtain pageKey, chartIds, columns, and control schemas. For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
+  flags: [
+    { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
+    { name: "panel_id", type: "number", required: true, desc: "BI panel ID returned by +list_bi_panels" },
+    { name: "page_key", type: "string", required: true, desc: "Page key returned by +get_bi_panel_detail" },
+    { name: "result_type", type: "string", required: true, desc: "Result type. Supported values: charts, summary." },
+    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
+    { name: "chart_ids", type: "json", required: false, desc: "Optional chart IDs when result_type=charts. If omitted, all queryable charts on the page are queried." },
+    { name: "parameter_controls", type: "json", required: false, desc: "Optional dashboard-level parameter control overrides. Each item must have controlId and one scalar value." },
+    { name: "permission_controls", type: "json", required: false, desc: "Optional dashboard-level permission control values. Each item must have controlId and value. value may be one scalar or an array; allowedValues are hints, not an MCP-side whitelist." },
+    { name: "chart_filter_controls", type: "json", required: false, desc: "Optional page chart filter control values. Each item must have controlId and value. value may be one scalar or an array and applies only to bound charts." },
+    { name: "columns", type: "json", required: false, desc: "Optional returned columns for chart data. Must match columns returned by +get_bi_panel_detail." },
+    { name: "row_limit", type: "number", required: false, desc: "Optional chart row limit. Default: 50, maximum: 10000." },
+    { name: "row_offset", type: "number", required: false, desc: "Optional chart row offset. Default: 0." },
+    { name: "block_limit", type: "number", required: false, desc: "Optional summary block limit. Default: 20, maximum: 10000." },
+    { name: "block_offset", type: "number", required: false, desc: "Optional summary block offset. Default: 0." },
+    { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true." },
+    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. Default: 3, minimum: 1, maximum: 10." }
+  ],
+  risk: "read",
+  buildArgs: (ctx) => ({
+    projectId: ctx.num("project_id"),
+    panelId: ctx.num("panel_id"),
+    pageKey: ctx.str("page_key"),
+    resultType: ctx.str("result_type"),
+    requestId: optionalString(ctx, "request_id"),
+    chartIds: optionalJson(ctx, "chart_ids"),
+    parameterControls: optionalJson(ctx, "parameter_controls"),
+    permissionControls: optionalJson(ctx, "permission_controls"),
+    chartFilterControls: optionalJson(ctx, "chart_filter_controls"),
+    columns: optionalJson(ctx, "columns"),
+    rowLimit: optionalNumber(ctx, "row_limit"),
+    rowOffset: optionalNumber(ctx, "row_offset"),
+    blockLimit: optionalNumber(ctx, "block_limit"),
+    blockOffset: optionalNumber(ctx, "block_offset"),
+    useCache: optionalBoolean(ctx, "use_cache"),
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
+  })
+});
+
 // src/commands/te-analysis/dashboard/query-dashboard-detail.ts
 var queryDashboardDetail = createMcpCommand({
   command: "+query_dashboard_detail",
@@ -363,7 +445,7 @@ var queryDashboardDetail = createMcpCommand({
 // src/commands/te-analysis/dashboard/query-dashboard-report-data.ts
 var queryDashboardReportData = createMcpCommand({
   command: "+query_dashboard_report_data",
-  description: "Query analysis data for one or more reports in a dashboard. Supports additional filters and time range overrides.",
+  description: "Query analysis data for one or more reports in a dashboard. Supports additional filters and time range overrides. For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "dashboard_id", type: "number", required: true, desc: "Dashboard ID", alias: "d" },
@@ -373,6 +455,8 @@ var queryDashboardReportData = createMcpCommand({
     { name: "time_granularity", type: "string", required: false, desc: "Optional time granularity used to override the report default. Supported values: minute, minute5, minute10, hour, day, week, month, quarter, year, total." },
     { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true" },
     { name: "report_ids", type: "json", required: false, desc: "Optional report IDs JSON array" },
+    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
+    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." },
     ...clusterQueryFlags("Optional cluster query scope. Supported values: GLOBAL, SLAVE. Omit to follow dashboard configuration.")
   ],
   risk: "read",
@@ -385,6 +469,8 @@ var queryDashboardReportData = createMcpCommand({
     timeGranularity: optionalString(ctx, "time_granularity"),
     useCache: optionalBoolean(ctx, "use_cache"),
     reportIds: optionalJson(ctx, "report_ids"),
+    requestId: optionalString(ctx, "request_id"),
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes"),
     ...optionalClusterQueryArgs(ctx)
   })
 });
@@ -469,7 +555,7 @@ var listPublicAccessLinks = createMcpCommand({
     { 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 shorter and remarks." },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Supported: id, shorter, creator, projectIdAndName, source, accessId, target, options, remarks, accessStatus, effectTime, expireTime, createTime, updateTime." },
-    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 20, maximum: 50." },
+    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 20, maximum: 10000." },
     { name: "offset", type: "number", required: false, desc: "Optional offset. Default: 0." }
   ],
   risk: "read",
@@ -558,6 +644,9 @@ var createSpace = createMcpCommand({
 // src/commands/te-analysis/dashboard/index.ts
 var commands3 = [
   listDashboards,
+  listBiPanels,
+  getBiPanelDetail,
+  queryBiPanelData,
   queryDashboardDetail,
   queryDashboardReportData,
   createDashboard,
@@ -573,18 +662,18 @@ var dashboard_default = commands3;
 // src/commands/te-analysis/model/query-adhoc.ts
 var queryAdhoc = createMcpCommand({
   command: "+query_adhoc",
-  description: "Run ad hoc analysis with an already-built qp. For event, retention, funnel, and prop_analysis, call the matching +build_*_analysis_qp command first and pass its qp; do not handcraft qp or call get_analysis_query_schema/list_events/list_properties/list_metrics/get_metric before the builder. For distribution, attribution, heat_map, interval, path, rank_list, and sql, use the legacy schema/metadata path. Supports fields/limit/offset pagination.",
+  description: "Run ad hoc analysis with an already-built qp. For event, retention, funnel, and prop_analysis, call the matching +build_*_analysis_qp command first and pass its qp; do not handcraft qp or call get_analysis_query_schema/list_events/list_properties/list_metrics/get_metric before the builder. For distribution, attribution, heat_map, interval, path, rank_list, and sql, use the legacy schema/metadata path. Supports fields/limit/offset pagination. For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "model_type", type: "string", required: true, desc: "Model type. Supported values: event, retention, funnel, distribution, attribution, heat_map, interval, path, rank_list, prop_analysis, sql." },
     { name: "qp", type: "json", required: true, desc: "Query parameter JSON. For event/retention/funnel/prop_analysis, pass qp returned by the matching +build_*_analysis_qp command. Use +get_analysis_query_schema only for non-builder/manual model types." },
-    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and deduplication. Generated automatically if omitted." },
+    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
     { name: "use_cache", type: "boolean", required: false, desc: "Whether to use result cache. Default: true" },
     { name: "zone_offset", type: "number", required: false, desc: "Time zone offset in hours. For example, UTC+8 is 8 and UTC-5 is -5" },
     { name: "is_sort_by_columns", type: "boolean", required: false, desc: "Whether to sort query results by columns. Default: false" },
     { name: "resolve_recent_day", type: "boolean", required: false, desc: "Whether to resolve relative time expressions such as last 7 days. If omitted, the service auto-resolves when qp.eventView.recentDay exists and start/end time is incomplete; otherwise it defaults to false." },
     { name: "fields", type: "json", required: false, desc: "Optional fields to return. Must match column names in result." },
-    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 1000, maximum: 100000. For model_type=sql, either omit LIMIT in the SQL or keep it equal to --limit (the two must not differ)." },
+    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 1000, maximum: 10000. For model_type=sql, either omit LIMIT in the SQL or keep it equal to --limit (the two must not differ)." },
     { name: "offset", type: "number", required: false, desc: "Optional offset. Default: 0." },
     { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." },
     ...clusterQueryFlags("Optional cluster query scope. Supported values: GLOBAL, SLAVE. Omit to query the current self cluster. SQL model analysis does not support this parameter.")
@@ -614,6 +703,21 @@ var queryAdhoc = createMcpCommand({
   })
 });
 
+// src/commands/te-analysis/model/cancel-query.ts
+var cancelQuery = createMcpCommand({
+  command: "+cancel_query",
+  description: "Cancel a running MCP query by request ID. Use this when a previous query is no longer needed, the caller or agent timed out before the query returned, the request returns fetch failed, hits an HTTP timeout, or the user asks to stop waiting. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running; call +cancel_query --request_id <same value> with the preset requestId to release it. For proactive cancellation, pass requestId to the query tool before starting it, then call cancel_query with the same value if you stop waiting. The auto-generated requestId is not available when the HTTP request fails before a response.",
+  flags: [
+    { name: "request_id", type: "string", required: true, desc: "Request ID returned by a query tool in metadata.requestId, or the requestId supplied before starting the query. It must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef." },
+    { name: "reason", type: "string", required: false, desc: "Optional cancellation reason. Default: MCP_CANCEL_QUERY_TOOL." }
+  ],
+  risk: "write",
+  buildArgs: (ctx) => ({
+    requestId: ctx.str("request_id"),
+    reason: optionalString(ctx, "reason")
+  })
+});
+
 // src/commands/te-analysis/model/build-event-analysis-qp.ts
 var buildEventAnalysisQp = createMcpCommand({
   command: "+build_event_analysis_qp",
@@ -699,7 +803,7 @@ var buildPropAnalysisQp = createMcpCommand({
 // src/commands/te-analysis/model/drilldown-users.ts
 var drilldownUsers = createMcpCommand({
   command: "+drilldown_users",
-  description: "Drill down to the user list for a specific data point in an existing analysis result. Use only after query_adhoc, query_report_data, or query_dashboard_report_data, and keep qp consistent with the source analysis. Supports pagination with limit/offset.",
+  description: "Drill down to the user list for a specific data point in an existing analysis result. Use only after query_adhoc, query_report_data, or query_dashboard_report_data, and keep qp consistent with the source analysis. Supports pagination with limit/offset. For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "model_type", type: "string", required: true, desc: "Model type used in the source analysis. Supported values: event, retention, funnel, distribution, attribution, heat_map, interval, path, rank_list, prop_analysis, sql." },
@@ -719,8 +823,9 @@ var drilldownUsers = createMcpCommand({
     { name: "include_total", type: "boolean", required: false, desc: "Whether to query users from the total row. Default: false" },
     { name: "relation_val", type: "string", required: false, desc: "Relation value used in relation analysis scenarios" },
     { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true" },
-    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 1000, maximum: 100000." },
+    { name: "limit", type: "number", required: false, desc: "Optional limit. Default: 1000, maximum: 10000." },
     { name: "offset", type: "number", required: false, desc: "Optional offset. Default: 0." },
+    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
     { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
   ],
   risk: "read",
@@ -748,6 +853,7 @@ var drilldownUsers = createMcpCommand({
     useCache: optionalBoolean(ctx, "use_cache"),
     limit: optionalNumber(ctx, "limit") ?? DEFAULT_QUERY_LIMIT,
     offset: optionalNumber(ctx, "offset"),
+    requestId: optionalString(ctx, "request_id"),
     timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
   })
 });
@@ -755,7 +861,7 @@ var drilldownUsers = createMcpCommand({
 // src/commands/te-analysis/model/drilldown-user-events.ts
 var drilldownUserEvents = createMcpCommand({
   command: "+drilldown_user_events",
-  description: "Drill down to detailed event sequences for a specific user on specific dates. Use the result of drilldown_users and keep event names and dates consistent with the source analysis.",
+  description: "Drill down to detailed event sequences for a specific user on specific dates. Use the result of drilldown_users and keep event names and dates consistent with the source analysis. For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "user_id", type: "string", required: true, desc: "User ID from drilldown_users" },
@@ -774,7 +880,8 @@ var drilldownUserEvents = createMcpCommand({
     { name: "entity_value", type: "string", required: false, desc: "Optional entity value for multi-entity scenarios" },
     { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true" },
     { name: "page_num", type: "number", required: false, desc: "Start page number. Default: 1" },
-    { name: "page_size", type: "number", required: false, desc: "Page size. Default: 1000, maximum: 100000." },
+    { name: "page_size", type: "number", required: false, desc: "Page size. Default: 1000, maximum: 10000." },
+    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
     { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
   ],
   risk: "read",
@@ -800,6 +907,7 @@ var drilldownUserEvents = createMcpCommand({
     useCache: optionalBoolean(ctx, "use_cache"),
     pageNum: optionalNumber(ctx, "page_num"),
     pageSize: optionalNumber(ctx, "page_size") ?? DEFAULT_QUERY_LIMIT,
+    requestId: optionalString(ctx, "request_id"),
     timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
   })
 });
@@ -908,6 +1016,7 @@ var commands4 = [
   buildFunnelAnalysisQp,
   buildPropAnalysisQp,
   queryAdhoc,
+  cancelQuery,
   drilldownUsers,
   drilldownUserEvents,
   createResultCluster,
@@ -919,7 +1028,7 @@ var model_default = commands4;
 // src/commands/te-analysis/entity/query-entity-details.ts
 var queryEntityDetails = createMcpCommand({
   command: "+query_entity_details",
-  description: "Query entity detail data based on an entity ID and cluster definition. Supports display properties, sorting, and result limits.",
+  description: "Query entity detail data based on an entity ID and cluster definition. Supports display properties, sorting, and result limits. For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "entity_id", type: "number", required: false, desc: "Optional entity ID used in multi-entity scenarios. If omitted, the default user entity is used." },
@@ -927,9 +1036,11 @@ var queryEntityDetails = createMcpCommand({
     { name: "properties", type: "json", required: false, desc: "Optional display properties JSON" },
     { name: "sort_by", type: "string", required: false, desc: "Optional sort field" },
     { name: "sort_order", type: "string", required: false, desc: "Optional sort order. Supported values: asc and desc" },
-    { name: "limit", type: "number", required: false, desc: "Optional result limit. Default: 1000, maximum: 100000" },
+    { name: "limit", type: "number", required: false, desc: "Optional result limit. Default: 1000, maximum: 10000" },
     { name: "zone_offset", type: "number", required: false, desc: "Time zone offset. For example, UTC+8 is 8" },
-    { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true" }
+    { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true" },
+    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
+    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
   ],
   risk: "read",
   validate: (ctx) => {
@@ -944,14 +1055,16 @@ var queryEntityDetails = createMcpCommand({
     sortOrder: optionalString(ctx, "sort_order"),
     limit: optionalNumber(ctx, "limit") ?? DEFAULT_QUERY_LIMIT,
     zoneOffset: optionalNumber(ctx, "zone_offset"),
-    useCache: optionalBoolean(ctx, "use_cache")
+    useCache: optionalBoolean(ctx, "use_cache"),
+    requestId: optionalString(ctx, "request_id"),
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
   })
 });
 
 // src/commands/te-analysis/entity/query-event-details.ts
 var queryEventDetails = createMcpCommand({
   command: "+query_event_details",
-  description: "Query event detail data. Supports time range, filters, display properties, sorting, and result limits. Time can be specified via --relative_date_range OR (--start_time AND --end_time).",
+  description: "Query event detail data. Supports time range, filters, display properties, sorting, and result limits. Time can be specified via --relative_date_range OR (--start_time AND --end_time). For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "event_name", type: "string", required: true, desc: "Event name" },
@@ -962,9 +1075,11 @@ var queryEventDetails = createMcpCommand({
     { name: "properties", type: "json", required: false, desc: "Optional display properties JSON" },
     { name: "sort_by", type: "string", required: false, desc: "Optional sort field" },
     { name: "sort_order", type: "string", required: false, desc: "Optional sort order. Supported values: asc and desc" },
-    { name: "limit", type: "number", required: false, desc: "Optional result limit. Default: 1000" },
+    { name: "limit", type: "number", required: false, desc: "Optional result limit. Default: 1000, maximum: 10000" },
     { name: "zone_offset", type: "number", required: false, desc: "Time zone offset. For example, UTC+8 is 8" },
-    { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true" }
+    { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true" },
+    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
+    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
   ],
   risk: "read",
   buildArgs: (ctx) => ({
@@ -979,7 +1094,9 @@ var queryEventDetails = createMcpCommand({
     sortOrder: optionalString(ctx, "sort_order"),
     limit: optionalNumber(ctx, "limit"),
     zoneOffset: optionalNumber(ctx, "zone_offset"),
-    useCache: optionalBoolean(ctx, "use_cache")
+    useCache: optionalBoolean(ctx, "use_cache"),
+    requestId: optionalString(ctx, "request_id"),
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
   })
 });
 
@@ -1024,7 +1141,7 @@ var buildEventDetailsSql = createMcpCommand({
     { name: "properties", type: "json", required: false, desc: "Optional display properties JSON" },
     { name: "sort_by", type: "string", required: false, desc: "Optional sort field" },
     { name: "sort_order", type: "string", required: false, desc: "Optional sort order. Supported values: asc and desc" },
-    { name: "limit", type: "number", required: false, desc: "Optional result limit. Default: 100" },
+    { name: "limit", type: "number", required: false, desc: "Optional result limit. Default: 100, maximum: 10000" },
     { name: "zone_offset", type: "number", required: false, desc: "Time zone offset. For example, UTC+8 is 8" }
   ],
   risk: "read",

package/dist/{te-audience-LI67PPGO.js → te-audience-KMKYI2YJ.js}

@@ -2,10 +2,11 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-WCHI7725.js";
-import "./chunk-GSJGPNKK.js";
-import "./chunk-CAQYQA4R.js";
-import "./chunk-SRJIAOBN.js";
+} from "./chunk-DMMEPCST.js";
+import "./chunk-PN3OS34E.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-RSHMZ3LG.js";
+import "./chunk-6W4QOZAL.js";
 
 // src/commands/te-audience/shared.ts
 function createMcpCommand(config) {
@@ -64,7 +65,7 @@ var listClusters = createMcpCommand({
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "query", type: "string", required: false, desc: "Keyword filter", alias: "q" },
     { name: "fields", type: "json", required: false, desc: "Optional return field list JSON array" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 50" },
+    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 10000" },
     { name: "offset", type: "number", required: false, desc: "Optional page offset, default 0" }
   ],
   risk: "read",
@@ -95,7 +96,7 @@ var getClustersByName = createMcpCommand({
 // src/commands/te-audience/cluster/list-cluster-members.ts
 var listClusterMembers = createMcpCommand({
   command: "+list_cluster_members",
-  description: "List members in the specified cluster with optional query/fields/limit/offset",
+  description: "List members in the specified cluster with optional query/fields/limit/offset. For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "cluster_name", type: "string", required: true, desc: "Cluster name" },
@@ -103,8 +104,10 @@ var listClusterMembers = createMcpCommand({
     { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache, default true" },
     { name: "query", type: "string", required: false, desc: "Optional keyword filter on #user_id and selected properties" },
     { name: "fields", type: "json", required: false, desc: "Optional return field list JSON array" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 50" },
-    { name: "offset", type: "number", required: false, desc: "Optional page offset, default 0" }
+    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 10000" },
+    { name: "offset", type: "number", required: false, desc: "Optional page offset, default 0" },
+    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
+    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
   ],
   risk: "read",
   buildArgs: (ctx) => ({
@@ -115,7 +118,9 @@ var listClusterMembers = createMcpCommand({
     query: optionalString(ctx, "query"),
     fields: optionalJson(ctx, "fields"),
     limit: optionalNumber(ctx, "limit"),
-    offset: optionalNumber(ctx, "offset")
+    offset: optionalNumber(ctx, "offset"),
+    requestId: optionalString(ctx, "request_id"),
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
   })
 });
 
@@ -204,7 +209,7 @@ var listTags = createMcpCommand({
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "query", type: "string", required: false, desc: "Keyword filter", alias: "q" },
     { name: "fields", type: "json", required: false, desc: "Optional return field list JSON array" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 50" },
+    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 10000" },
     { name: "offset", type: "number", required: false, desc: "Optional page offset, default 0" }
   ],
   risk: "read",
@@ -235,7 +240,7 @@ var getTagsByName = createMcpCommand({
 // src/commands/te-audience/tag/list-tag-members.ts
 var listTagMembers = createMcpCommand({
   command: "+list_tag_members",
-  description: "List members in the specified tag with optional query/fields/limit/offset",
+  description: "List members in the specified tag with optional query/fields/limit/offset. For long-running or cancelable queries, provide requestId before starting. For any query that may exceed the CLI or MCP HTTP timeout, preset requestId so you can call +cancel_query --request_id <same value> if you stop waiting or the request returns fetch failed. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. If provided, requestId must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. Submitted queries return metadata.requestId; pass that value to cancel_query(requestId) when the query is no longer needed. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup.",
   flags: [
     { name: "project_id", type: "number", required: true, desc: "Project ID", alias: "p" },
     { name: "tag_name", type: "string", required: true, desc: "Tag name" },
@@ -244,8 +249,10 @@ var listTagMembers = createMcpCommand({
     { name: "use_cache", type: "boolean", required: false, desc: "Whether to use cache, default true" },
     { name: "query", type: "string", required: false, desc: "Optional keyword filter on #user_id and selected properties" },
     { name: "fields", type: "json", required: false, desc: "Optional return field list JSON array" },
-    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 50" },
-    { name: "offset", type: "number", required: false, desc: "Optional page offset, default 0" }
+    { name: "limit", type: "number", required: false, desc: "Optional page size, default 20, max 10000" },
+    { name: "offset", type: "number", required: false, desc: "Optional page offset, default 0" },
+    { name: "request_id", type: "string", required: false, desc: "Optional unique request ID used for tracking and cancellation. If provided, it must use mcp_<32 lowercase hex UUID>, for example mcp_0123456789abcdef0123456789abcdef. For long-running or cancelable queries, provide this before starting the query so it can be cancelled later with +cancel_query --request_id <same value>, even if the caller stops waiting before the tool returns. If fetch failed, HTTP timeout, or caller timeout happens, the backend query may still be running. The auto-generated requestId is not available when the HTTP request fails before a response, so preset requestId is required for proactive cleanup. Generated automatically if omitted. The response metadata.requestId can also be passed to cancel_query when the query is no longer needed." },
+    { name: "timeout_minutes", type: "number", required: false, desc: "Query timeout in minutes. If omitted, 30 minutes is used." }
   ],
   risk: "read",
   buildArgs: (ctx) => ({
@@ -257,7 +264,9 @@ var listTagMembers = createMcpCommand({
     query: optionalString(ctx, "query"),
     fields: optionalJson(ctx, "fields"),
     limit: optionalNumber(ctx, "limit"),
-    offset: optionalNumber(ctx, "offset")
+    offset: optionalNumber(ctx, "offset"),
+    requestId: optionalString(ctx, "request_id"),
+    timeoutMinutes: optionalNumber(ctx, "timeout_minutes")
   })
 });
 

package/dist/{te-common-35WVU3C5.js → te-common-WNCZB7R7.js}

@@ -2,10 +2,11 @@ import {
   callMcpTool,
   parseMcpResult,
   resolveMcpUrl
-} from "./chunk-WCHI7725.js";
-import "./chunk-GSJGPNKK.js";
-import "./chunk-CAQYQA4R.js";
-import "./chunk-SRJIAOBN.js";
+} from "./chunk-DMMEPCST.js";
+import "./chunk-PN3OS34E.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-RSHMZ3LG.js";
+import "./chunk-6W4QOZAL.js";
 
 // src/commands/te-common/shared.ts
 function createMcpCommand(config) {

package/dist/{te-community-LEAP6PWT.js → te-community-JEEFXPB3.js}

@@ -3,10 +3,11 @@ import {
   parseMcpResult,
   registerMcpMappings,
   resolveMcpUrl
-} from "./chunk-WCHI7725.js";
-import "./chunk-GSJGPNKK.js";
-import "./chunk-CAQYQA4R.js";
-import "./chunk-SRJIAOBN.js";
+} from "./chunk-DMMEPCST.js";
+import "./chunk-PN3OS34E.js";
+import "./chunk-NOO24N7W.js";
+import "./chunk-RSHMZ3LG.js";
+import "./chunk-6W4QOZAL.js";
 
 // src/commands/te-community/get_channel_info.ts
 var getChannelInfo = {
@@ -49,7 +50,7 @@ var searchPosts = {
     { name: "sentiment-types", type: "string", required: false, desc: "Sentiment filter: 0 negative, 1 positive, 2 neutral. Comma-separated." },
     { name: "order-by", type: "number", required: false, desc: "Sort: 0 publish time desc, 1 weight desc, 2 publish time asc, 3 reply count desc, 4 heat desc." },
     { name: "page-num", type: "number", required: false, desc: "Page number, starting at 1." },
-    { name: "page-size", type: "number", required: false, desc: "Page size." }
+    { name: "page-size", type: "number", required: false, desc: "Page size. Max 10000." }
   ],
   risk: "read",
   execute: async (ctx) => {
@@ -102,10 +103,10 @@ var getPostDetail = {
     { name: "resource-type", type: "number", required: true, desc: "Resource type: 0 post, 1 video." },
     { name: "danmu-order-by", type: "number", required: false, desc: "Sort for danmu: 0 video timestamp desc, 1 publish time desc." },
     { name: "danmu-page-num", type: "number", required: false, desc: "Page number for danmu pagination, starting at 1." },
-    { name: "danmu-page-size", type: "number", required: false, desc: "Page size for danmu pagination." },
+    { name: "danmu-page-size", type: "number", required: false, desc: "Page size for danmu pagination. Max 10000." },
     { name: "reply-order-by", type: "number", required: false, desc: "Sort for comments: 0 publish time desc, 1 publish time asc." },
     { name: "reply-page-num", type: "number", required: false, desc: "Page number for comments, starting at 1." },
-    { name: "reply-page-size", type: "number", required: false, desc: "Page size for comments." }
+    { name: "reply-page-size", type: "number", required: false, desc: "Page size for comments. Max 10000." }
   ],
   risk: "read",
   execute: async (ctx) => {
@@ -182,7 +183,7 @@ var getSentimentOverview = {
     { name: "start-time", type: "string", required: true, desc: "Statistics range start (inclusive). Format: yyyy-MM-dd." },
     { name: "end-time", type: "string", required: true, desc: "Statistics range end (inclusive). Format: yyyy-MM-dd." },
     { name: "is-merged", type: "boolean", required: false, desc: "Whether to aggregate merged keywords." },
-    { name: "limit", type: "number", required: false, desc: "Max number of keywords to return." }
+    { name: "limit", type: "number", required: false, desc: "Max number of keywords to return. Max 10000." }
   ],
   risk: "read",
   execute: async (ctx) => {
@@ -457,7 +458,7 @@ var getLivestreamDetail = {
     { name: "search-word", type: "string", required: false, desc: "Keyword to filter interaction detail rows." },
     { name: "order-by", type: "number", required: false, desc: "Sort: 0 interaction time desc, 1 interaction time asc." },
     { name: "page-num", type: "number", required: false, desc: "Page number, starting at 1." },
-    { name: "page-size", type: "number", required: false, desc: "Page size." }
+    { name: "page-size", type: "number", required: false, desc: "Page size. Max 10000." }
   ],
   risk: "read",
   execute: async (ctx) => {
@@ -617,7 +618,7 @@ var getRiskContent = {
     { name: "include-trends", type: "boolean", required: false, desc: "Whether to include trend aggregates in the response." },
     { name: "order-by", type: "number", required: false, desc: "Sort: 0 publish time desc." },
     { name: "page-num", type: "number", required: false, desc: "Page number, starting at 1." },
-    { name: "page-size", type: "number", required: false, desc: "Page size." }
+    { name: "page-size", type: "number", required: false, desc: "Page size. Max 10000." }
   ],
   risk: "read",
   execute: async (ctx) => {