<fix>[sdk]: update SDK files for LongJobProgressDetail

Resolves: ZSTAC-82318

Change-Id: I8931c4207547b836b522c9b5cea2db807a032d5c

Author: AlanJager

header/src/main/java/org/zstack/header/core/progress/LongJobProgressDetailBuilder.java

@@ -142,6 +142,7 @@ private static LongJobProgressDetail tryParseAiDownloadFormat(Map<String, Object
             }
 
             LongJobProgressDetail detail = new LongJobProgressDetail();
+            Map<String, Object> extra = new HashMap<>();
 
             // state field
             Object stateVal = inner.get("state");
@@ -156,7 +157,7 @@ private static LongJobProgressDetail tryParseAiDownloadFormat(Map<String, Object
 
                 Number percent = toNumber(progress.get("percent"));
                 if (percent != null) {
-                    detail.setPercent((int) Math.round(percent.doubleValue()));
+                    detail.setPercent(Math.max(0, Math.min(100, (int) Math.round(percent.doubleValue()))));
                 }
 
                 // AI agent uses snake_case field names
@@ -205,9 +206,7 @@ private static LongJobProgressDetail tryParseAiDownloadFormat(Map<String, Object
                 extraProgress.remove("downloaded_files");
                 extraProgress.remove("total_files");
                 extraProgress.remove("stage");
-                if (!extraProgress.isEmpty()) {
-                    detail.setExtra(extraProgress);
-                }
+                extra.putAll(extraProgress);
             }
 
             // stateReason field — can be String or Map (structured reason with code/description)
@@ -218,6 +217,22 @@ private static LongJobProgressDetail tryParseAiDownloadFormat(Map<String, Object
                 detail.setStateReason(JSONObjectUtil.toJsonString(stateReason));
             }
 
+            // preserve unknown keys from inner top-level
+            Map<String, Object> extraInner = new HashMap<>(inner);
+            extraInner.remove("state");
+            extraInner.remove("progress");
+            extraInner.remove("state_reason");
+            extra.putAll(extraInner);
+
+            // preserve unknown keys from raw outer-level
+            Map<String, Object> extraRaw = new HashMap<>(raw);
+            extraRaw.remove("data");
+            extra.putAll(extraRaw);
+
+            if (!extra.isEmpty()) {
+                detail.setExtra(extra);
+            }
+
             return detail;
         } catch (Exception e) {
             logger.trace("LongJobProgressDetailBuilder: failed to parse AI download format", e);

header/src/main/java/org/zstack/header/core/progress/TaskProgressInventory.java

@@ -18,7 +18,7 @@ public class TaskProgressInventory {
     private Long time;
     private List<TaskProgressInventory> subTasks;
     private String arguments;
-    /** Typed progress detail parsed from opaque. Null when opaque is absent or unrecognized. */
+    /** Typed progress detail parsed from opaque. Null when opaque is absent or parsing fails. */
     private LongJobProgressDetail progressDetail;
 
     public TaskProgressInventory() {

sdk/src/main/java/SourceClassMap.java

@@ -247,6 +247,7 @@ public class SourceClassMap {
 			put("org.zstack.header.core.external.service.ExternalServiceCapabilities", "org.zstack.sdk.ExternalServiceCapabilities");
 			put("org.zstack.header.core.external.service.ExternalServiceInventory", "org.zstack.sdk.ExternalServiceInventory");
 			put("org.zstack.header.core.progress.ChainInfo", "org.zstack.sdk.ChainInfo");
+			put("org.zstack.header.core.progress.LongJobProgressDetail", "org.zstack.sdk.LongJobProgressDetail");
 			put("org.zstack.header.core.progress.PendingTaskInfo", "org.zstack.sdk.PendingTaskInfo");
 			put("org.zstack.header.core.progress.RunningTaskInfo", "org.zstack.sdk.RunningTaskInfo");
 			put("org.zstack.header.core.progress.TaskInfo", "org.zstack.sdk.TaskInfo");
@@ -1208,6 +1209,7 @@ public class SourceClassMap {
 			put("org.zstack.sdk.LogType", "org.zstack.log.server.LogType");
 			put("org.zstack.sdk.LoginAuthenticationProcedureDesc", "org.zstack.header.identity.login.LoginAuthenticationProcedureDesc");
 			put("org.zstack.sdk.LongJobInventory", "org.zstack.header.longjob.LongJobInventory");
+			put("org.zstack.sdk.LongJobProgressDetail", "org.zstack.header.core.progress.LongJobProgressDetail");
 			put("org.zstack.sdk.LongJobState", "org.zstack.header.longjob.LongJobState");
 			put("org.zstack.sdk.LunInventory", "org.zstack.header.storageDevice.LunInventory");
 			put("org.zstack.sdk.MaaSUsage", "org.zstack.ai.message.MaaSUsage");

sdk/src/main/java/org/zstack/sdk/LongJobProgressDetail.java

@@ -84,11 +84,11 @@ public java.lang.Long getEstimatedRemainingSeconds() {
         return this.estimatedRemainingSeconds;
     }
 
-    public java.util.LinkedHashMap extra;
-    public void setExtra(java.util.LinkedHashMap extra) {
+    public java.util.Map extra;
+    public void setExtra(java.util.Map extra) {
         this.extra = extra;
     }
-    public java.util.LinkedHashMap getExtra() {
+    public java.util.Map getExtra() {
         return this.extra;
     }
 

sdk/src/main/java/org/zstack/sdk/TaskProgressInventory.java

@@ -1,6 +1,6 @@
 package org.zstack.sdk;
 
-
+import org.zstack.sdk.LongJobProgressDetail;
 
 public class TaskProgressInventory  {
 
@@ -76,11 +76,11 @@ public java.lang.String getArguments() {
         return this.arguments;
     }
 
-    public org.zstack.sdk.LongJobProgressDetail progressDetail;
-    public void setProgressDetail(org.zstack.sdk.LongJobProgressDetail progressDetail) {
+    public LongJobProgressDetail progressDetail;
+    public void setProgressDetail(LongJobProgressDetail progressDetail) {
         this.progressDetail = progressDetail;
     }
-    public org.zstack.sdk.LongJobProgressDetail getProgressDetail() {
+    public LongJobProgressDetail getProgressDetail() {
         return this.progressDetail;
     }