@thinkingai/ae-cli 6.0.53 → 6.0.55

package/dist/{te-analysis-3EVYQ3IO.js → te-analysis-ISXKJKRT.js}

@@ -7,12 +7,12 @@ import {
   waitForAnalysisRun,
   withAsyncArtifactLifecycle,
   withInterruptSignal
-} from "./chunk-PGCIKZRE.js";
+} from "./chunk-RGYPSEYD.js";
 import {
   createCapabilityCommand,
   definitionIntentSnapshotFlag,
   modelDefinitionIntentSnapshotFlag
-} from "./chunk-647BRKZK.js";
+} from "./chunk-374V5R6N.js";
 import {
   registerCapabilityGatewayRoute,
   resolveGatewayDomain
@@ -23,23 +23,25 @@ import {
   dryRunCapability,
   executeCapability,
   executeCapabilityWithEnvelope,
+  readCliAgentContext,
   requestCapabilityGateway,
   requestCapabilityGatewayWithEnvelope,
+  runWithCliAgentContext,
   uploadInputFile,
   validateCapability,
   validateCapabilityWithEnvelope
-} from "./chunk-QYXDJOLA.js";
+} from "./chunk-VZZNLV3I.js";
 import {
   withOutputMetadata
-} from "./chunk-BW7JUDEI.js";
+} from "./chunk-6VNIR4AP.js";
 import "./chunk-Y74WTIKJ.js";
 import {
   getCliToken
-} from "./chunk-DU72X2IO.js";
-import "./chunk-IG3DYEIR.js";
+} from "./chunk-GHXZK54S.js";
+import "./chunk-ZL7SGNIA.js";
 import {
   CliValidationError
-} from "./chunk-YVGXGTD6.js";
+} from "./chunk-WNGFSIOB.js";
 
 // src/commands/te-analysis/capability-shared.ts
 var ANALYSIS_GATEWAY_CLI_SERVICES = /* @__PURE__ */ new Set(["project", "system"]);
@@ -2323,7 +2325,7 @@ var metadataGovernanceRecommendationAutoReview = {
     AUTO_REVIEW_CAPABILITY_ID,
     autoReviewInput(ctx)
   ),
-  execute: async (ctx) => {
+  execute: async (ctx) => withAutoReviewAgentContext(async () => {
     const input = autoReviewInput(ctx);
     if (hasExplicitLimit(ctx)) {
       await validateCapabilityWithEnvelope(ctx.host(), gatewayDomain(), AUTO_REVIEW_CAPABILITY_ID, input);
@@ -2346,8 +2348,15 @@ var metadataGovernanceRecommendationAutoReview = {
       }, result.meta);
     }
     return withOutputMetadata(result.data, result.meta);
-  }
+  })
 };
+async function withAutoReviewAgentContext(run) {
+  const inherited = readCliAgentContext();
+  return runWithCliAgentContext({
+    agent_session_id: inherited.agent_session_id || randomUUID(),
+    agent_turn_id: inherited.agent_turn_id || randomUUID()
+  }, run);
+}
 function autoReviewInput(ctx) {
   return compactInput({
     ...projectInput(ctx),
@@ -4141,7 +4150,7 @@ var reportGet = createAnalysisCapabilityCommand({
   resource: "report",
   command: "get",
   capabilityId: "analysis.report.get",
-  description: "Get one analysis report definition as AI QP without executing report data.",
+  description: "Get one analysis report definition and event-report presentation without executing report data.",
   flags: [projectIdFlag, { name: "report-id", type: "number", required: true, desc: "Report ID." }],
   risk: "read",
   buildInput: (ctx) => ({
@@ -4172,7 +4181,7 @@ var REPORT_WRITE_MODEL_TYPE_VALUES = [
 ];
 var REPORT_WRITE_MODEL_DESCRIPTION = `${AI_MODEL_DESCRIPTION} Report create/update also supports tag for saved tag report data; use tag as the AI-facing spelling.`;
 var AI_DEFINITION_DESCRIPTION = 'Event metrics: omit optional display_name unless the target command schema explicitly supports it. Funnel step filters use event_property_name (not field) and string-array values, including "true"/"false" for boolean properties. For tag/cluster filters, cluster_date_policy accepts LATEST (default), AUTO (match the computed result for each analysis date), or SPECIFIED (requires specified_cluster_date in yyyy-MM-dd format). AI-facing model definition JSON. Do not pass raw QP, events, event_view, visual_view, or analysis_query. Distribution filters must be attached to the corresponding distribution_metrics[].filters; do not use top-level filters or relation. For path definitions, global filters support user_property, cluster, and tag only; event_property is not supported. session_unit accepts second (1..999), minute (1..999), or hour (1..24). Do not use day; express one day as session_interval=24 and session_unit=hour. For SQL, a simple query is {"sql":"select ..."}; raw variables use ${name}, while typed params use ${Text:name}, ${Selector:name}, or ${PartDate:name}. PartDate expands to a complete predicate, so write WHERE ${PartDate:d}, not a column followed by the placeholder. A part_date parameter may set boolean use_timezone; it defaults to false and controls whether that parameter uses the query effective timezone. Selector value must match one options[].value. Trino identifiers containing #, $, @, spaces, punctuation, or a reserved word must be delimited with double quotes, for example SELECT "#user_id", "$part_event", "end" FROM ...; single quotes are string literals. For multiline SQL JSON, the decoded sql value must contain a real line break; do not submit a literal \\n sequence outside quoted SQL text. Queries against an event table must include a date-partition predicate on the quoted "$part_date" column, for example WHERE "$part_date" BETWEEN \'2026-07-01\' AND \'2026-07-07\'; the backend rejects event-table SQL without it. The CLI preserves SQL text and never auto-quotes identifiers.';
-var REPORT_WRITE_DEFINITION_DESCRIPTION = `${AI_DEFINITION_DESCRIPTION} Saved-report filters may contain one compound group level only; every item inside that group must be a leaf without another items array. Historical deeper trees remain readable but cannot be written back as a definition. For model_type=tag, pass a tag report intent such as {"tag":{"tag_name":"vip_users","time_range":{"mode":"recent","unit":"day","value":7}}}. Tags are supported for report create/update and report data, not ad-hoc analysis.`;
+var REPORT_WRITE_DEFINITION_DESCRIPTION = `${AI_DEFINITION_DESCRIPTION} Saved funnel definitions may set optional funnel.steps[].display_name; report get returns it and report create/update preserves it. Saved-report filters may contain one compound group level only; every item inside that group must be a leaf without another items array. Historical deeper trees remain readable but cannot be written back as a definition. For model_type=tag, pass a tag report intent such as {"tag":{"tag_name":"vip_users","time_range":{"mode":"recent","unit":"day","value":7}}}. Tags are supported for report create/update and report data, not ad-hoc analysis.`;
 function aiModelTypeFlag(required) {
   return {
     name: "model-type",
@@ -4263,6 +4272,61 @@ function validateReportMetadataResolutions(ctx) {
   }
 }
 
+// src/commands/te-analysis/report/presentation.ts
+var reportPresentationFlag = {
+  name: "presentation",
+  type: "json",
+  required: false,
+  desc: 'Optional top-level event-report display JSON: chart_type (line|combo|bar|stacked|cumulative|pie), table_layout (date|event|group), series [{metric_index:1,type:"bar"|"line",axis:"primary"|"secondary"}]. Line/combo/cumulative require a non-total time_particle_size. Metric indexes are 1-based definition.metrics positions. Series is a subset patch; [] resets all series, and chart_type=line resets to pure primary-axis lines. Omit to preserve the saved chart/result-table layout on same-model updates. For a dashboard table card use analysis dashboard-report update --chart-type table.'
+};
+function validateReportPresentation(ctx) {
+  if (!(ctx.has?.("presentation") ?? ctx.str("presentation") !== "")) return;
+  const value = ctx.json("presentation");
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("--presentation must be a non-empty event-report display object.");
+  }
+  const presentation = value;
+  const keys = Object.keys(presentation);
+  if (keys.length === 0 || keys.some((key) => !["chart_type", "table_layout", "series"].includes(key))) {
+    throw new Error("--presentation accepts only chart_type, table_layout, and series; use semantic names, not raw QP fields.");
+  }
+  if (presentation.chart_type === "table") {
+    throw new Error("A table is a dashboard card display; use analysis dashboard-report update --chart-type table.");
+  }
+  if (Object.hasOwn(presentation, "chart_type") && (typeof presentation.chart_type !== "string" || !["line", "combo", "bar", "stacked", "cumulative", "pie"].includes(presentation.chart_type))) {
+    throw new Error("--presentation.chart_type must be line, combo, bar, stacked, cumulative, or pie.");
+  }
+  if (Object.hasOwn(presentation, "table_layout") && (typeof presentation.table_layout !== "string" || !["date", "event", "group"].includes(presentation.table_layout))) {
+    throw new Error("--presentation.table_layout must be date, event, or group.");
+  }
+  if (ctx.str("model-type") !== "" && ctx.str("model-type") !== "event") {
+    throw new Error("--presentation is supported only for event reports.");
+  }
+  if (Object.hasOwn(presentation, "series")) validateSeries(presentation.series);
+}
+function validateSeries(value) {
+  if (!Array.isArray(value)) throw new Error("--presentation.series must be an array; [] resets all series.");
+  const indexes = /* @__PURE__ */ new Set();
+  for (const [position, item] of value.entries()) {
+    const path = `--presentation.series[${position}]`;
+    if (!item || typeof item !== "object" || Array.isArray(item) || Object.keys(item).length !== 3 || Object.keys(item).some((key) => !["metric_index", "type", "axis"].includes(key))) {
+      throw new Error(`${path} requires only metric_index, type, and axis, all three required.`);
+    }
+    const series = item;
+    if (typeof series.metric_index !== "number" || !Number.isInteger(series.metric_index) || series.metric_index < 1) {
+      throw new Error(`${path}.metric_index must be a positive 1-based integer position in definition.metrics.`);
+    }
+    if (indexes.has(series.metric_index)) throw new Error(`${path}.metric_index must not repeat another series binding.`);
+    indexes.add(series.metric_index);
+    if (typeof series.type !== "string" || !["bar", "line"].includes(series.type)) {
+      throw new Error(`${path}.type must be bar or line.`);
+    }
+    if (typeof series.axis !== "string" || !["primary", "secondary"].includes(series.axis)) {
+      throw new Error(`${path}.axis must be primary or secondary.`);
+    }
+  }
+}
+
 // src/commands/te-analysis/report/create.ts
 var reportCreate = createAnalysisCapabilityCommand({
   resource: "report",
@@ -4274,6 +4338,7 @@ var reportCreate = createAnalysisCapabilityCommand({
     { name: "report-name", type: "string", required: true, desc: "Report display name." },
     reportWriteModelTypeFlag(true),
     reportWriteDefinitionFlag(true),
+    reportPresentationFlag,
     modelDefinitionIntentSnapshotFlag,
     reportMetadataResolutionsFlag,
     { name: "report-desc", type: "string", required: false, desc: "Optional report description." },
@@ -4282,15 +4347,19 @@ var reportCreate = createAnalysisCapabilityCommand({
     { name: "dashboard-ids", type: "json", required: false, desc: "Optional dashboard ID array to associate after creation." }
   ],
   risk: "write",
-  validate: validateReportMetadataResolutions,
+  validate: (ctx) => {
+    validateReportMetadataResolutions(ctx);
+    validateReportPresentation(ctx);
+  },
   intentConsistency: { definitionFlag: "definition", modelTypeFlag: "model-type" },
   buildInput: (ctx) => compactInput({
     ...projectInput(ctx),
     report_name: ctx.str("report-name"),
     model_type: ctx.str("model-type"),
     definition: ctx.json("definition"),
+    presentation: optionalJson(ctx, "presentation"),
     resolutions: optionalJson(ctx, "resolutions"),
-    report_desc: optionalString(ctx, "report-desc"),
+    report_desc: optionalString(ctx, "report-desc") ?? "",
     cache_seconds: optionalNumber(ctx, "cache-seconds"),
     query_duration_ms: optionalNumber(ctx, "query-duration-ms"),
     dashboard_ids: optionalJsonArray(ctx, "dashboard-ids")
@@ -4301,9 +4370,10 @@ var reportCreate = createAnalysisCapabilityCommand({
 function validateReportUpdate(ctx) {
   const hasDefinition = ctx.str("definition") !== "";
   const hasResolutions = ctx.json("resolutions") !== void 0;
+  const hasPresentation = ctx.has?.("presentation") ?? ctx.str("presentation") !== "";
   const hasMetadataUpdate = ctx.str("report-name") !== "" || optionalStringPreserveEmpty(ctx, "report-desc") !== void 0;
-  if (!hasDefinition && !hasMetadataUpdate) {
-    throw new Error("At least one of --report-name, --report-desc, or --definition is required.");
+  if (!hasDefinition && !hasMetadataUpdate && !hasPresentation) {
+    throw new Error("At least one of --report-name, --report-desc, --definition, or --presentation is required.");
   }
   if (hasDefinition && ctx.str("model-type") === "") {
     throw new Error("--model-type is required when --definition is provided.");
@@ -4312,12 +4382,13 @@ function validateReportUpdate(ctx) {
     throw new Error("--resolutions requires --definition.");
   }
   validateReportMetadataResolutions(ctx);
+  validateReportPresentation(ctx);
 }
 var reportUpdate = createAnalysisCapabilityCommand({
   resource: "report",
   command: "update",
   capabilityId: "analysis.report.update",
-  description: "Update report metadata or AI QP definition through the capability gateway.",
+  description: "Update report metadata, AI QP definition, or event-report presentation through the capability gateway.",
   flags: [
     projectIdFlag,
     { name: "report-id", type: "number", required: true, desc: "Report ID to update." },
@@ -4326,6 +4397,7 @@ var reportUpdate = createAnalysisCapabilityCommand({
     { name: "report-desc", type: "string", required: false, desc: "New report description. Pass an empty string to clear it; omit to preserve it." },
     reportWriteModelTypeFlag(false),
     reportWriteDefinitionFlag(false),
+    reportPresentationFlag,
     modelDefinitionIntentSnapshotFlag,
     reportMetadataResolutionsFlag,
     { name: "cache-seconds", type: "number", required: false, desc: "Optional cache duration in seconds." },
@@ -4342,6 +4414,7 @@ var reportUpdate = createAnalysisCapabilityCommand({
     report_desc: optionalStringPreserveEmpty(ctx, "report-desc"),
     model_type: optionalString(ctx, "model-type"),
     definition: optionalJson(ctx, "definition"),
+    presentation: optionalJson(ctx, "presentation"),
     resolutions: optionalJson(ctx, "resolutions"),
     cache_seconds: optionalNumber(ctx, "cache-seconds"),
     query_duration_ms: optionalNumber(ctx, "query-duration-ms")
@@ -4791,6 +4864,42 @@ var dashboardCopy = createAnalysisCapabilityCommand({
   })
 });
 
+// src/commands/te-analysis/dashboard/move.ts
+var dashboardMove = createAnalysisCapabilityCommand({
+  resource: "dashboard",
+  command: "move",
+  capabilityId: "analysis.dashboard.move",
+  description: "Move one or more dashboards to the same project-space root or folder.",
+  flags: [
+    projectIdFlag,
+    {
+      name: "dashboard-ids",
+      type: "json",
+      required: true,
+      desc: "Dashboard ID array. Pass a one-item array to move a single dashboard."
+    },
+    {
+      name: "to-space-id",
+      type: "number",
+      required: true,
+      desc: "Target project space ID."
+    },
+    {
+      name: "to-folder-id",
+      type: "number",
+      required: false,
+      desc: "Target folder ID within the target project space. Omit to move to the space root."
+    }
+  ],
+  risk: "write",
+  buildInput: (ctx) => compactInput({
+    ...projectInput(ctx),
+    dashboard_ids: jsonArray(ctx, "dashboard-ids"),
+    to_space_id: ctx.num("to-space-id"),
+    to_folder_id: optionalNumber(ctx, "to-folder-id")
+  })
+});
+
 // src/commands/te-analysis/dashboard/freeze.ts
 var dashboardFreeze = createAnalysisCapabilityCommand({
   resource: "dashboard",
@@ -4849,6 +4958,7 @@ var commands19 = [
   dashboardDelete,
   dashboardHandover,
   dashboardCopy,
+  dashboardMove,
   dashboardFreeze,
   dashboardAbnormalGet,
   dashboardTaskStatus
@@ -4874,9 +4984,71 @@ var dashboardReportAdd = createAnalysisCapabilityCommand({
   })
 });
 
+// src/commands/te-analysis/dashboard-report/get.ts
+var dashboardReportGet = createAnalysisCapabilityCommand({
+  resource: "dashboard-report",
+  command: "get",
+  capabilityId: "analysis.dashboard_report.get",
+  description: "Get an event report card presentation on one analysis dashboard, not the source report definition.",
+  flags: [
+    projectIdFlag,
+    { name: "dashboard-id", type: "number", required: true, desc: "Dashboard containing the report card." },
+    { name: "report-id", type: "number", required: true, desc: "Existing event report ID on that dashboard." }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    ...projectInput(ctx),
+    dashboard_id: ctx.num("dashboard-id"),
+    report_id: ctx.num("report-id")
+  })
+});
+
+// src/commands/te-analysis/dashboard-report/update.ts
+var dashboardReportUpdate = createAnalysisCapabilityCommand({
+  resource: "dashboard-report",
+  command: "update",
+  capabilityId: "analysis.dashboard_report.update",
+  description: "Update one event report card presentation without changing the source report definition or other dashboards.",
+  flags: [
+    projectIdFlag,
+    { name: "dashboard-id", type: "number", required: true, desc: "Dashboard containing the report card." },
+    { name: "report-id", type: "number", required: true, desc: "Existing event report ID on that dashboard." },
+    { name: "chart-type", type: "string", required: false, desc: "Card chart type: line, combo, bar, stacked, cumulative, pie, or table. Combo inherits existing source-report series; this command cannot edit series. A pure line card requires resetting source combo first. Gateway validates compatibility with the saved event definition." },
+    { name: "table-layout", type: "string", required: false, desc: "Table layout: date, event, or group. Omit to preserve it." },
+    { name: "date-outside", type: "boolean", required: false, desc: "Show dates outside the table. True requires a grouped table with a non-date layout; also choose event/group layout when inherited. Pass false to clear, omit to preserve." }
+  ],
+  risk: "write",
+  validate: (ctx) => {
+    const chartType = optionalString(ctx, "chart-type");
+    const tableLayout = optionalString(ctx, "table-layout");
+    const dateOutside = optionalBoolean(ctx, "date-outside");
+    if (chartType === void 0 && tableLayout === void 0 && dateOutside === void 0) {
+      throw new Error("At least one of --chart-type, --table-layout, or --date-outside is required.");
+    }
+    if (chartType !== void 0 && !["line", "combo", "bar", "stacked", "cumulative", "pie", "table"].includes(chartType)) {
+      throw new Error("--chart-type must be line, combo, bar, stacked, cumulative, pie, or table.");
+    }
+    if (tableLayout !== void 0 && !["date", "event", "group"].includes(tableLayout)) {
+      throw new Error("--table-layout must be date, event, or group.");
+    }
+  },
+  buildInput: (ctx) => ({
+    ...projectInput(ctx),
+    dashboard_id: ctx.num("dashboard-id"),
+    report_id: ctx.num("report-id"),
+    presentation: compactInput({
+      chart_type: optionalString(ctx, "chart-type"),
+      table_layout: optionalString(ctx, "table-layout"),
+      date_outside: optionalBoolean(ctx, "date-outside")
+    })
+  })
+});
+
 // src/commands/te-analysis/dashboard-report/index.ts
 var commands20 = [
-  dashboardReportAdd
+  dashboardReportAdd,
+  dashboardReportGet,
+  dashboardReportUpdate
 ];
 var dashboard_report_default = commands20;
 
@@ -10519,14 +10691,14 @@ var monitorTimeFields = [
     type: "string",
     required: true,
     pattern: "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
-    desc: "Inclusive query range start, yyyy-MM-dd HH:mm:ss."
+    desc: "Inclusive completion-time range start, yyyy-MM-dd HH:mm:ss."
   },
   {
     flag: "end-time",
     type: "string",
     required: true,
     pattern: "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
-    desc: "Inclusive query range end, yyyy-MM-dd HH:mm:ss."
+    desc: "Inclusive completion-time range end, including the entire second, yyyy-MM-dd HH:mm:ss."
   }
 ];
 function validateTaskQueryInput(input) {
@@ -10590,6 +10762,27 @@ var systemMonitoringCommands = [
     ],
     validate: (_ctx, input) => validateTaskQueryInput(input)
   }),
+  defineSystemCommand({
+    resource: "query-task",
+    command: "realtime-list",
+    capabilityId: "system.query_task.realtime_list",
+    description: "List a bounded realtime query-monitor snapshot; use query-task list for historical logs.",
+    risk: "read",
+    fields: [
+      { flag: "duration-minutes", type: "number", min: 1, max: 30, desc: "Realtime window in minutes. Default: 30." },
+      ...monitorScopeFields,
+      { flag: "cluster-names", type: "json", required: true, array: true, desc: "Query cluster-name JSON array." },
+      { flag: "status-codes", type: "json", array: true, desc: "Optional task status-code JSON array." },
+      { flag: "limit", type: "number", min: 1, max: 200, desc: "Maximum returned tasks. Default: 100, max: 200." }
+    ],
+    validate: (_ctx, input) => {
+      validateMonitorScope(input);
+      requireAtLeastOne(input, ["cluster_names"], "--cluster-names must be a non-empty JSON array.");
+      if (input.status_codes !== void 0) {
+        requireAtLeastOne(input, ["status_codes"], "--status-codes must be a non-empty JSON array.");
+      }
+    }
+  }),
   defineSystemCommand({
     resource: "query-task",
     command: "get",
@@ -10932,6 +11125,89 @@ var commands81 = [
 ];
 var system_default = commands81;
 
+// src/commands/te-analysis/feedback/submit.ts
+import { createHash as createHash4, randomUUID as randomUUID2 } from "crypto";
+var analysisQueryCapabilities = /* @__PURE__ */ new Set([
+  "analysis.adhoc.run",
+  "analysis.adhoc.export",
+  "analysis.report_data.run",
+  "analysis.report_data.export",
+  "analysis.dashboard_report_data.run",
+  "analysis.dashboard_report_data.export",
+  "analysis.bi_panel_page_data.run",
+  "analysis.bi_panel_page_data.export",
+  "analysis.event_detail.run",
+  "analysis.event_detail.export",
+  "analysis.entity_detail.run",
+  "analysis.entity_detail.export",
+  "analysis.query.drilldown_events",
+  "analysis.query.drilldown_events_export",
+  "analysis.query.drilldown_entities",
+  "analysis.query.drilldown_entities_export",
+  "analysis.query.drilldown_user_events",
+  "analysis.query.drilldown_user_events_export",
+  "analysis.query.drilldown_session_details"
+]);
+function analysisFeedbackInput(ctx) {
+  if (!ctx.bool("query-completed")) throw new CliValidationError("Feedback requires a completed data query and final analysis answer.");
+  const queryCapabilityId = ctx.str("query-capability-id");
+  if (!analysisQueryCapabilities.has(queryCapabilityId)) throw new CliValidationError("query-capability-id must identify an executed analysis data query.");
+  const ratings = ["satisfied", "partially_satisfied", "dissatisfied", "unable_to_judge"];
+  const satisfaction = ctx.str("satisfaction");
+  if (!ratings.includes(satisfaction)) throw new CliValidationError("satisfaction must be an explicit user feedback category.");
+  const feedbackText = ctx.str("feedback-text");
+  if (!feedbackText.trim() || feedbackText.length > 2048) throw new CliValidationError("feedback-text must contain original user feedback up to 2048 characters.");
+  const context = readCliAgentContext();
+  if (!context.agent_session_id) throw new CliValidationError("The Agent context file must contain the evaluated agent_session_id.");
+  const turns = ctx.json("target-turn-ids") ?? [];
+  if (!Array.isArray(turns) || turns.length > 32 || turns.some((id) => typeof id !== "string" || !id.trim() || id.length > 191)) {
+    throw new CliValidationError("target-turn-ids must be an array of at most 32 nonblank existing turn IDs.");
+  }
+  if (turns.includes(context.agent_turn_id)) throw new CliValidationError("target-turn-ids must reference analysis turns, not the feedback turn.");
+  const targetTurns = [...new Set(turns)];
+  const suppliedId = ctx.str("feedback-id");
+  const feedbackId = suppliedId || (context.agent_turn_id ? createHash4("sha256").update(JSON.stringify([context.agent_session_id, context.agent_turn_id, targetTurns, queryCapabilityId, satisfaction, feedbackText])).digest("hex") : randomUUID2());
+  if (!feedbackId.trim() || feedbackId.length > 128) throw new CliValidationError("feedback-id must be a nonblank string up to 128 characters.");
+  const routeSummary = ctx.str("route-summary");
+  if (routeSummary.length > 2048) throw new CliValidationError("route-summary must be at most 2048 characters.");
+  const projectId = ctx.optionalNum("project-id");
+  if (projectId !== void 0 && (!Number.isInteger(projectId) || projectId <= 0)) {
+    throw new CliValidationError("project-id must be a positive integer.");
+  }
+  return {
+    feedback_id: feedbackId,
+    agent_session_id: context.agent_session_id,
+    target_turn_ids: targetTurns,
+    query_completed: true,
+    query_capability_id: queryCapabilityId,
+    satisfaction,
+    feedback_text: feedbackText,
+    ...projectId !== void 0 ? { project_id: projectId } : {},
+    ...routeSummary.trim() ? { route_summary: routeSummary } : {}
+  };
+}
+var analysisFeedbackSubmit = createAnalysisCapabilityCommand({
+  resource: "feedback",
+  command: "submit",
+  capabilityId: "analysis.feedback.submit",
+  risk: "write",
+  description: "Submit explicit user feedback after a completed analysis data query and final answer. Reuses Agent session and analysis turn IDs; never submits an answer body.",
+  flags: [
+    { name: "query-completed", type: "boolean", desc: "Confirm that query results and the final analysis answer have been delivered." },
+    { name: "query-capability-id", type: "string", required: true, desc: "Executed analysis data-query capability ID in the evaluated turns." },
+    { name: "satisfaction", type: "string", required: true, desc: "Explicit rating: satisfied, partially_satisfied, dissatisfied, or unable_to_judge." },
+    { name: "feedback-text", type: "string", required: true, sensitive: true, desc: "Original user feedback, up to 2048 characters. No answer content." },
+    { name: "target-turn-ids", type: "json", desc: "JSON array of evaluated analysis turn IDs; omit only when unknown." },
+    { name: "route-summary", type: "string", sensitive: true, desc: "Optional brief verifiable route and asset-selection rationale. No answer content." },
+    { name: "feedback-id", type: "string", desc: "Stable feedback ID for retries; defaults to current session/feedback-turn fingerprint when available." },
+    { name: "project-id", type: "number", desc: "Evaluated analysis project ID when available." }
+  ],
+  buildInput: analysisFeedbackInput
+});
+
+// src/commands/te-analysis/feedback/index.ts
+var feedback_default = [analysisFeedbackSubmit];
+
 // src/commands/te-analysis/index.ts
 registerCapabilityGatewayRoute("analysis", { gatewayDomain: "analysis" });
 registerCapabilityGatewayRoute("project", { gatewayDomain: "analysis" });
@@ -10978,7 +11254,8 @@ var baseCommands = [
   ...alert_detail_default,
   ...alert_job_default,
   ...alert_notice_config_default,
-  ...system_default
+  ...system_default,
+  ...feedback_default
 ];
 var commands82 = [...baseCommands];
 var te_analysis_default = commands82;

package/dist/{te-community-Z7JACGF3.js → te-community-42M7ICDO.js}

@@ -8,16 +8,16 @@ import {
 import {
   SecureStoreAuthError,
   getCliToken
-} from "./chunk-DU72X2IO.js";
+} from "./chunk-GHXZK54S.js";
 import {
   getActiveHost,
   safeJsonParse
-} from "./chunk-IG3DYEIR.js";
+} from "./chunk-ZL7SGNIA.js";
 import {
   CliValidationError,
   PermissionError,
   logger
-} from "./chunk-YVGXGTD6.js";
+} from "./chunk-WNGFSIOB.js";
 
 // src/core/mcp.ts
 async function permissionDetails(resp) {

package/dist/{te-dataops-F7GQOIS6.js → te-dataops-BNKNZ4F2.js}

@@ -1,26 +1,26 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   resolveHost
-} from "./chunk-N4BLPJC7.js";
+} from "./chunk-OP44TT4H.js";
 import {
   printError
-} from "./chunk-BW7JUDEI.js";
+} from "./chunk-6VNIR4AP.js";
 import {
   internalCallSourceHeaders
 } from "./chunk-Y74WTIKJ.js";
 import {
   SecureStoreAuthError,
   getCliToken
-} from "./chunk-DU72X2IO.js";
+} from "./chunk-GHXZK54S.js";
 import {
   safeJsonParse
-} from "./chunk-IG3DYEIR.js";
+} from "./chunk-ZL7SGNIA.js";
 import {
   CliApiError,
   CliValidationError,
   PermissionError,
   logger
-} from "./chunk-YVGXGTD6.js";
+} from "./chunk-WNGFSIOB.js";
 
 // src/commands/te-dataops/shared.ts
 import { randomBytes } from "crypto";

package/dist/{te-engage-LFBU6WWH.js → te-engage-BZE3MBKT.js}

@@ -1,7 +1,7 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   createCapabilityCommand
-} from "./chunk-647BRKZK.js";
+} from "./chunk-374V5R6N.js";
 import {
   registerCapabilityGatewayRoute,
   resolveGatewayDomain
@@ -12,17 +12,17 @@ import {
   fetchCapabilityGateway,
   requestCapabilityGateway,
   requestCapabilityGatewayWithEnvelope
-} from "./chunk-QYXDJOLA.js";
+} from "./chunk-VZZNLV3I.js";
 import {
   printError,
   withOutputMetadata
-} from "./chunk-BW7JUDEI.js";
+} from "./chunk-6VNIR4AP.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-DU72X2IO.js";
-import "./chunk-IG3DYEIR.js";
+import "./chunk-GHXZK54S.js";
+import "./chunk-ZL7SGNIA.js";
 import {
   CliValidationError
-} from "./chunk-YVGXGTD6.js";
+} from "./chunk-WNGFSIOB.js";
 
 // src/commands/te-engage/shared.ts
 function createEngageCapabilityCommand(cliService, config) {