@alicloud/agentcore20260804 2.4.0 → 2.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/dist/client.d.ts +144 -24
  2. package/dist/client.js +335 -24
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/CreateCustomAgentRequest.d.ts +63 -33
  5. package/dist/models/CreateCustomAgentRequest.js +27 -1
  6. package/dist/models/CreateCustomAgentRequest.js.map +1 -1
  7. package/dist/models/CreateCustomAgentResponseBody.d.ts +193 -41
  8. package/dist/models/CreateCustomAgentResponseBody.js +59 -1
  9. package/dist/models/CreateCustomAgentResponseBody.js.map +1 -1
  10. package/dist/models/CreateCustomAgentShrinkRequest.d.ts +1 -1
  11. package/dist/models/CreateImageCacheRequest.d.ts +122 -0
  12. package/dist/models/CreateImageCacheRequest.js +96 -0
  13. package/dist/models/CreateImageCacheRequest.js.map +1 -0
  14. package/dist/models/CreateImageCacheResponse.d.ts +19 -0
  15. package/dist/models/CreateImageCacheResponse.js +69 -0
  16. package/dist/models/CreateImageCacheResponse.js.map +1 -0
  17. package/dist/models/CreateImageCacheResponseBody.d.ts +260 -0
  18. package/dist/models/CreateImageCacheResponseBody.js +140 -0
  19. package/dist/models/CreateImageCacheResponseBody.js.map +1 -0
  20. package/dist/models/CreateImageCacheShrinkRequest.d.ts +50 -0
  21. package/dist/models/CreateImageCacheShrinkRequest.js +64 -0
  22. package/dist/models/CreateImageCacheShrinkRequest.js.map +1 -0
  23. package/dist/models/DeleteImageCacheRequest.d.ts +33 -0
  24. package/dist/models/DeleteImageCacheRequest.js +60 -0
  25. package/dist/models/DeleteImageCacheRequest.js.map +1 -0
  26. package/dist/models/DeleteImageCacheResponse.d.ts +19 -0
  27. package/dist/models/DeleteImageCacheResponse.js +69 -0
  28. package/dist/models/DeleteImageCacheResponse.js.map +1 -0
  29. package/dist/models/DeleteImageCacheResponseBody.d.ts +102 -0
  30. package/dist/models/DeleteImageCacheResponseBody.js +92 -0
  31. package/dist/models/DeleteImageCacheResponseBody.js.map +1 -0
  32. package/dist/models/GetCustomAgentResponseBody.d.ts +130 -66
  33. package/dist/models/GetCustomAgentResponseBody.js +31 -1
  34. package/dist/models/GetCustomAgentResponseBody.js.map +1 -1
  35. package/dist/models/GetImageCacheRequest.d.ts +33 -0
  36. package/dist/models/GetImageCacheRequest.js +60 -0
  37. package/dist/models/GetImageCacheRequest.js.map +1 -0
  38. package/dist/models/GetImageCacheResponse.d.ts +19 -0
  39. package/dist/models/GetImageCacheResponse.js +69 -0
  40. package/dist/models/GetImageCacheResponse.js.map +1 -0
  41. package/dist/models/GetImageCacheResponseBody.d.ts +264 -0
  42. package/dist/models/GetImageCacheResponseBody.js +140 -0
  43. package/dist/models/GetImageCacheResponseBody.js.map +1 -0
  44. package/dist/models/GetWorkspaceAcrRamAuthorizeUrlRequest.d.ts +2 -2
  45. package/dist/models/GetWorkspaceAcrRamAuthorizeUrlResponseBody.d.ts +23 -1
  46. package/dist/models/GetWorkspaceAcrRamAuthorizeUrlResponseBody.js.map +1 -1
  47. package/dist/models/ListImageCachesRequest.d.ts +113 -0
  48. package/dist/models/ListImageCachesRequest.js +80 -0
  49. package/dist/models/ListImageCachesRequest.js.map +1 -0
  50. package/dist/models/ListImageCachesResponse.d.ts +19 -0
  51. package/dist/models/ListImageCachesResponse.js +69 -0
  52. package/dist/models/ListImageCachesResponse.js.map +1 -0
  53. package/dist/models/ListImageCachesResponseBody.d.ts +290 -0
  54. package/dist/models/ListImageCachesResponseBody.js +146 -0
  55. package/dist/models/ListImageCachesResponseBody.js.map +1 -0
  56. package/dist/models/RetryImageCacheRequest.d.ts +60 -0
  57. package/dist/models/RetryImageCacheRequest.js +82 -0
  58. package/dist/models/RetryImageCacheRequest.js.map +1 -0
  59. package/dist/models/RetryImageCacheResponse.d.ts +19 -0
  60. package/dist/models/RetryImageCacheResponse.js +69 -0
  61. package/dist/models/RetryImageCacheResponse.js.map +1 -0
  62. package/dist/models/RetryImageCacheResponseBody.d.ts +264 -0
  63. package/dist/models/RetryImageCacheResponseBody.js +140 -0
  64. package/dist/models/RetryImageCacheResponseBody.js.map +1 -0
  65. package/dist/models/RetryImageCacheShrinkRequest.d.ts +48 -0
  66. package/dist/models/RetryImageCacheShrinkRequest.js +64 -0
  67. package/dist/models/RetryImageCacheShrinkRequest.js.map +1 -0
  68. package/dist/models/UpdateCustomAgentRequest.d.ts +68 -35
  69. package/dist/models/UpdateCustomAgentRequest.js +27 -1
  70. package/dist/models/UpdateCustomAgentRequest.js.map +1 -1
  71. package/dist/models/UpdateCustomAgentResponseBody.d.ts +184 -49
  72. package/dist/models/UpdateCustomAgentResponseBody.js +59 -1
  73. package/dist/models/UpdateCustomAgentResponseBody.js.map +1 -1
  74. package/dist/models/UpdateCustomAgentShrinkRequest.d.ts +2 -2
  75. package/dist/models/VerifyWorkspaceAcrRamAuthorizationResponseBody.d.ts +33 -3
  76. package/dist/models/VerifyWorkspaceAcrRamAuthorizationResponseBody.js.map +1 -1
  77. package/dist/models/model.d.ts +35 -0
  78. package/dist/models/model.js +157 -86
  79. package/dist/models/model.js.map +1 -1
  80. package/package.json +1 -1
  81. package/src/client.ts +371 -24
  82. package/src/models/CreateCustomAgentRequest.ts +80 -33
  83. package/src/models/CreateCustomAgentResponseBody.ts +233 -41
  84. package/src/models/CreateCustomAgentShrinkRequest.ts +1 -1
  85. package/src/models/CreateImageCacheRequest.ts +164 -0
  86. package/src/models/CreateImageCacheResponse.ts +40 -0
  87. package/src/models/CreateImageCacheResponseBody.ts +337 -0
  88. package/src/models/CreateImageCacheShrinkRequest.ts +69 -0
  89. package/src/models/DeleteImageCacheRequest.ts +48 -0
  90. package/src/models/DeleteImageCacheResponse.ts +40 -0
  91. package/src/models/DeleteImageCacheResponseBody.ts +140 -0
  92. package/src/models/GetCustomAgentResponseBody.ts +151 -66
  93. package/src/models/GetImageCacheRequest.ts +48 -0
  94. package/src/models/GetImageCacheResponse.ts +40 -0
  95. package/src/models/GetImageCacheResponseBody.ts +341 -0
  96. package/src/models/GetWorkspaceAcrRamAuthorizeUrlRequest.ts +2 -2
  97. package/src/models/GetWorkspaceAcrRamAuthorizeUrlResponseBody.ts +23 -1
  98. package/src/models/ListImageCachesRequest.ts +148 -0
  99. package/src/models/ListImageCachesResponse.ts +40 -0
  100. package/src/models/ListImageCachesResponseBody.ts +373 -0
  101. package/src/models/RetryImageCacheRequest.ts +90 -0
  102. package/src/models/RetryImageCacheResponse.ts +40 -0
  103. package/src/models/RetryImageCacheResponseBody.ts +341 -0
  104. package/src/models/RetryImageCacheShrinkRequest.ts +67 -0
  105. package/src/models/UpdateCustomAgentRequest.ts +85 -35
  106. package/src/models/UpdateCustomAgentResponseBody.ts +224 -49
  107. package/src/models/UpdateCustomAgentShrinkRequest.ts +2 -2
  108. package/src/models/VerifyWorkspaceAcrRamAuthorizationResponseBody.ts +33 -3
  109. package/src/models/model.ts +35 -0
@@ -13,7 +13,7 @@ export class UpdateCustomAgentResponseBodyDataAgenticFsMounts extends $dara.Mode
13
13
  mountPath?: string;
14
14
  /**
15
15
  * @remarks
16
- * The relative directory in the mounted access point.
16
+ * The relative directory within the mounted access point.
17
17
  *
18
18
  * @example
19
19
  * workspace/data
@@ -169,7 +169,7 @@ export class UpdateCustomAgentResponseBodyDataArtifactContainer extends $dara.Mo
169
169
  tag?: string;
170
170
  /**
171
171
  * @remarks
172
- * The image source type. A value of acr indicates Alibaba Cloud Container Registry.
172
+ * The image source type. A value of acr indicates Alibaba Cloud Container Registry (ACR).
173
173
  *
174
174
  * This parameter is required.
175
175
  *
@@ -221,7 +221,7 @@ export class UpdateCustomAgentResponseBodyDataArtifact extends $dara.Model {
221
221
  container?: UpdateCustomAgentResponseBodyDataArtifactContainer;
222
222
  /**
223
223
  * @remarks
224
- * The TCP port listened to by the agent service.
224
+ * The TCP port on which the agent service listens.
225
225
  *
226
226
  * This parameter is required.
227
227
  *
@@ -345,7 +345,7 @@ export class UpdateCustomAgentResponseBodyDataHealthCheck extends $dara.Model {
345
345
  healthyThreshold?: number;
346
346
  /**
347
347
  * @remarks
348
- * The interval between two consecutive health checks, in seconds.
348
+ * The interval between two health checks, in seconds.
349
349
  *
350
350
  * @example
351
351
  * 10
@@ -353,7 +353,7 @@ export class UpdateCustomAgentResponseBodyDataHealthCheck extends $dara.Model {
353
353
  intervalSeconds?: number;
354
354
  /**
355
355
  * @remarks
356
- * The Health Check Path for HTTP health checks.
356
+ * The HTTP health check path.
357
357
  *
358
358
  * @example
359
359
  * /healthz
@@ -361,7 +361,7 @@ export class UpdateCustomAgentResponseBodyDataHealthCheck extends $dara.Model {
361
361
  path?: string;
362
362
  /**
363
363
  * @remarks
364
- * The port accessed for the HTTP health check.
364
+ * The port accessed for HTTP health checks.
365
365
  *
366
366
  * @example
367
367
  * 8080
@@ -377,7 +377,7 @@ export class UpdateCustomAgentResponseBodyDataHealthCheck extends $dara.Model {
377
377
  timeoutSeconds?: number;
378
378
  /**
379
379
  * @remarks
380
- * The number of consecutive health check failures required to mark the agent as unhealthy.
380
+ * The number of consecutive health check failures after which the agent is considered unhealthy.
381
381
  *
382
382
  * @example
383
383
  * 3
@@ -414,10 +414,68 @@ export class UpdateCustomAgentResponseBodyDataHealthCheck extends $dara.Model {
414
414
  }
415
415
  }
416
416
 
417
+ export class UpdateCustomAgentResponseBodyDataImageCachePreparation extends $dara.Model {
418
+ /**
419
+ * @remarks
420
+ * The value is equal to the imageCacheId in the same response and belongs to the current workspace.
421
+ *
422
+ * This parameter is required.
423
+ *
424
+ * @example
425
+ * img-example
426
+ */
427
+ imageId?: string;
428
+ /**
429
+ * @remarks
430
+ * The acceptance snapshot of the current request, which can be PENDING, READY, or FAILED. This value does not represent the real-time status. You can query the real-time status by calling GetImageCache.
431
+ *
432
+ * This parameter is required.
433
+ *
434
+ * @example
435
+ * PENDING
436
+ */
437
+ statusAtAcceptance?: string;
438
+ /**
439
+ * @remarks
440
+ * The value is fixed as ACCEPTED, indicating that the logical association and preparation intent are confirmed.
441
+ *
442
+ * This parameter is required.
443
+ *
444
+ * @example
445
+ * ACCEPTED
446
+ */
447
+ submissionStatus?: string;
448
+ static names(): { [key: string]: string } {
449
+ return {
450
+ imageId: 'imageId',
451
+ statusAtAcceptance: 'statusAtAcceptance',
452
+ submissionStatus: 'submissionStatus',
453
+ };
454
+ }
455
+
456
+ static types(): { [key: string]: any } {
457
+ return {
458
+ imageId: 'string',
459
+ statusAtAcceptance: 'string',
460
+ submissionStatus: 'string',
461
+ };
462
+ }
463
+
464
+ validate() {
465
+ super.validate();
466
+ }
467
+
468
+ constructor(map?: { [key: string]: any }) {
469
+ super(map);
470
+ }
471
+ }
472
+
417
473
  export class UpdateCustomAgentResponseBodyDataLatestExecutionError extends $dara.Model {
418
474
  /**
419
475
  * @remarks
420
- * The reason code for the waiting or execution failure of the latest configuration. This code is used to determine the subsequent handling method.
476
+ * The cause code for the wait or execution failure of the latest configuration. You can use this code to determine the subsequent processing method.
477
+ *
478
+ * This parameter is required.
421
479
  *
422
480
  * @example
423
481
  * AgentExecutionFailed
@@ -425,7 +483,9 @@ export class UpdateCustomAgentResponseBodyDataLatestExecutionError extends $dara
425
483
  code?: string;
426
484
  /**
427
485
  * @remarks
428
- * The description of the reason why the latest configuration is waiting or failed to execute. Refer to code and retryable to determine what to do next.
486
+ * The description of the cause for the wait or when the latest configuration failed to execute. Check the code and retryable fields to determine What to do next.
487
+ *
488
+ * This parameter is required.
429
489
  *
430
490
  * @example
431
491
  * Agent execution failed. Check the configuration and resubmit
@@ -433,7 +493,9 @@ export class UpdateCustomAgentResponseBodyDataLatestExecutionError extends $dara
433
493
  message?: string;
434
494
  /**
435
495
  * @remarks
436
- * Specifies whether automatic retry is performed. If the value is true, you can query again later. If the value is false, check and fix the configuration based on the reason, and then resubmit the request.
496
+ * Specifies whether automatic retry is performed. If the value is true, you can query again later. If the value is false, check and fix the configuration based on the cause and then resubmit the agent.
497
+ *
498
+ * This parameter is required.
437
499
  */
438
500
  retryable?: boolean;
439
501
  static names(): { [key: string]: string } {
@@ -534,7 +596,7 @@ export class UpdateCustomAgentResponseBodyDataLogging extends $dara.Model {
534
596
  export class UpdateCustomAgentResponseBodyDataNetworkAccessInternet extends $dara.Model {
535
597
  /**
536
598
  * @remarks
537
- * Specifies whether Internet access is allowed on the agent side. The actual access is still limited by the workspace.
599
+ * Specifies whether Internet access is allowed on the agent side. The actual access remains restricted by the workspace.
538
600
  */
539
601
  enabled?: boolean;
540
602
  static names(): { [key: string]: string } {
@@ -561,7 +623,7 @@ export class UpdateCustomAgentResponseBodyDataNetworkAccessInternet extends $dar
561
623
  export class UpdateCustomAgentResponseBodyDataNetworkAccessVpc extends $dara.Model {
562
624
  /**
563
625
  * @remarks
564
- * Specifies whether access to the user VPC configured for the workspace is allowed on the agent side. The actual access is still limited by the workspace.
626
+ * Specifies whether access to the user VPC configured for the workspace is allowed on the agent side. The actual access remains restricted by the workspace.
565
627
  */
566
628
  enabled?: boolean;
567
629
  static names(): { [key: string]: string } {
@@ -588,12 +650,12 @@ export class UpdateCustomAgentResponseBodyDataNetworkAccessVpc extends $dara.Mod
588
650
  export class UpdateCustomAgentResponseBodyDataNetwork extends $dara.Model {
589
651
  /**
590
652
  * @remarks
591
- * The Internet access configuration of the agent. If this field is not configured, Internet access is allowed on the agent side, but it is still limited by the workspace.
653
+ * The Internet access configuration of the agent. If this parameter is not configured, Internet access is allowed on the agent side but remains restricted by the workspace.
592
654
  */
593
655
  accessInternet?: UpdateCustomAgentResponseBodyDataNetworkAccessInternet;
594
656
  /**
595
657
  * @remarks
596
- * The user VPC access configuration of the agent. If this field is not configured, user VPC access is allowed on the agent side, but it is still limited by the workspace.
658
+ * The user VPC access configuration of the agent. If this parameter is not configured, user VPC access is allowed on the agent side but remains restricted by the workspace.
597
659
  */
598
660
  accessVpc?: UpdateCustomAgentResponseBodyDataNetworkAccessVpc;
599
661
  static names(): { [key: string]: string } {
@@ -625,6 +687,33 @@ export class UpdateCustomAgentResponseBodyDataNetwork extends $dara.Model {
625
687
  }
626
688
  }
627
689
 
690
+ export class UpdateCustomAgentResponseBodyDataObservability extends $dara.Model {
691
+ /**
692
+ * @remarks
693
+ * Specifies whether to enable agent observability. Default value: true. If set to false, the platform Python probe is not loaded at runtime, and you must collect observability data yourself.
694
+ */
695
+ enabled?: boolean;
696
+ static names(): { [key: string]: string } {
697
+ return {
698
+ enabled: 'enabled',
699
+ };
700
+ }
701
+
702
+ static types(): { [key: string]: any } {
703
+ return {
704
+ enabled: 'boolean',
705
+ };
706
+ }
707
+
708
+ validate() {
709
+ super.validate();
710
+ }
711
+
712
+ constructor(map?: { [key: string]: any }) {
713
+ super(map);
714
+ }
715
+ }
716
+
628
717
  export class UpdateCustomAgentResponseBodyDataOssMounts extends $dara.Model {
629
718
  /**
630
719
  * @remarks
@@ -685,7 +774,7 @@ export class UpdateCustomAgentResponseBodyDataOssMounts extends $dara.Model {
685
774
  export class UpdateCustomAgentResponseBodyDataProtocolPaths extends $dara.Model {
686
775
  /**
687
776
  * @remarks
688
- * The description of the current API path.
777
+ * The usage description of the current API path.
689
778
  *
690
779
  * @example
691
780
  * AG-UI conversation API
@@ -727,12 +816,12 @@ export class UpdateCustomAgentResponseBodyDataProtocolPaths extends $dara.Model
727
816
  export class UpdateCustomAgentResponseBodyDataProtocol extends $dara.Model {
728
817
  /**
729
818
  * @remarks
730
- * The request header configurations for the current protocol. The key is the header name and the value is a string.
819
+ * The request header configuration for the current protocol. The key is the header name and the value is a string.
731
820
  */
732
821
  headers?: { [key: string]: string };
733
822
  /**
734
823
  * @remarks
735
- * The list of API paths corresponding to the current protocol.
824
+ * The list of API paths for the current protocol.
736
825
  */
737
826
  paths?: UpdateCustomAgentResponseBodyDataProtocolPaths[];
738
827
  /**
@@ -817,7 +906,7 @@ export class UpdateCustomAgentResponseBodyDataRuntimeCompute extends $dara.Model
817
906
  export class UpdateCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
818
907
  /**
819
908
  * @remarks
820
- * Specifies whether elastic scaling is enabled. Valid values:
909
+ * Specifies whether to enable elastic scaling. Valid values:
821
910
  * - true: Enabled.
822
911
  * - false: Disabled.
823
912
  *
@@ -888,7 +977,7 @@ export class UpdateCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
888
977
  export class UpdateCustomAgentResponseBodyDataRuntimeSessionPolicy extends $dara.Model {
889
978
  /**
890
979
  * @remarks
891
- * The name of the HTTP request header used by the session policy. This parameter applies to ISOLATED_HEADER_FIELD.
980
+ * The name of the HTTP request header used by the session policy. This applies to ISOLATED_HEADER_FIELD.
892
981
  *
893
982
  * @example
894
983
  * X-Session-Id
@@ -899,8 +988,7 @@ export class UpdateCustomAgentResponseBodyDataRuntimeSessionPolicy extends $dara
899
988
  * The type of the session policy. Valid values:
900
989
  * - AFFINITY: Session affinity.
901
990
  * - ISOLATED_HEADER_FIELD: Uses the request header specified by headerName to associate sessions.
902
- * - ISOLATED_COOKIE: Not recommended.
903
- * Note: The compatible value DISABLED in a request is returned as AFFINITY.
991
+ * ISOLATED_COOKIE is not recommended. The compatible value DISABLED in a request is returned as AFFINITY.
904
992
  *
905
993
  * This parameter is required.
906
994
  *
@@ -941,12 +1029,12 @@ export class UpdateCustomAgentResponseBodyDataRuntime extends $dara.Model {
941
1029
  compute?: UpdateCustomAgentResponseBodyDataRuntimeCompute;
942
1030
  /**
943
1031
  * @remarks
944
- * The elastic policy configurations for the agent.
1032
+ * The elastic policy configuration of the agent.
945
1033
  */
946
1034
  hpa?: UpdateCustomAgentResponseBodyDataRuntimeHpa;
947
1035
  /**
948
1036
  * @remarks
949
- * The session policy configurations for the agent.
1037
+ * The session policy configuration of the agent.
950
1038
  *
951
1039
  * This parameter is required.
952
1040
  */
@@ -990,6 +1078,8 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
990
1078
  * @remarks
991
1079
  * The unique identifier of the custom agent. You can obtain this ID from the response of the CreateCustomAgent or ListCustomAgents operation.
992
1080
  *
1081
+ * This parameter is required.
1082
+ *
993
1083
  * @example
994
1084
  * agent-550e8400e29b41d4a716446655440000
995
1085
  */
@@ -1001,12 +1091,12 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1001
1091
  agenticFsMounts?: UpdateCustomAgentResponseBodyDataAgenticFsMounts[];
1002
1092
  /**
1003
1093
  * @remarks
1004
- * The latest submitted deployment artifact configuration, including the service listening port and the ACR container image. To check whether the configuration has taken effect, refer to latestVersionStatus.
1094
+ * The latest submitted deployment artifact configuration, including the service listening port and the ACR container image. Check the latestVersionStatus field to determine whether the configuration has taken effect.
1005
1095
  */
1006
1096
  artifact?: UpdateCustomAgentResponseBodyDataArtifact;
1007
1097
  /**
1008
1098
  * @remarks
1009
- * The creation method of the agent. The value is CUSTOM for custom agents.
1099
+ * The creation method of the agent. A value of CUSTOM is returned for custom agents.
1010
1100
  *
1011
1101
  * @example
1012
1102
  * CUSTOM
@@ -1022,7 +1112,7 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1022
1112
  createdAt?: string;
1023
1113
  /**
1024
1114
  * @remarks
1025
- * The deployment method of the agent. Custom agents are deployed and managed by the platform, and the value is MANAGED.
1115
+ * The deployment method of the agent. Custom agents are deployed and managed by the platform, and a value of MANAGED is returned.
1026
1116
  *
1027
1117
  * @example
1028
1118
  * MANAGED
@@ -1030,7 +1120,7 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1030
1120
  deployType?: string;
1031
1121
  /**
1032
1122
  * @remarks
1033
- * The description of the agent.
1123
+ * The purpose description of the agent.
1034
1124
  *
1035
1125
  * @example
1036
1126
  * Custom agent that provides conversation services
@@ -1038,23 +1128,56 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1038
1128
  description?: string;
1039
1129
  /**
1040
1130
  * @remarks
1041
- * The environment variable configuration for the agent process.
1131
+ * The value is null if no effective version exists. Do not use latestSpecVersion as a substitute. You cannot use this field to release the occupation protection of old cache instances.
1132
+ *
1133
+ * This parameter is required.
1134
+ *
1135
+ * @example
1136
+ * 1
1137
+ *
1138
+ * **if can be null:**
1139
+ * true
1140
+ */
1141
+ effectiveSpecVersion?: number;
1142
+ /**
1143
+ * @remarks
1144
+ * The environment variable configuration of the agent process.
1042
1145
  */
1043
1146
  environment?: UpdateCustomAgentResponseBodyDataEnvironment;
1044
1147
  /**
1045
1148
  * @remarks
1046
- * The HTTP health check configuration of the agent. This field is empty if no health check is configured.
1149
+ * The HTTP health check configuration of the agent. The value is empty if not configured.
1047
1150
  */
1048
1151
  healthCheck?: UpdateCustomAgentResponseBodyDataHealthCheck;
1049
1152
  /**
1050
1153
  * @remarks
1051
- * The waiting or execution error of the latest configuration version. This field is returned only when the version is waiting for a retry or fails to execute.
1154
+ * This field is always returned. If useImageCache is set to true, the value is the non-empty logical ID of the current workspace. If useImageCache is set to false, the value is null. The occupation of old instances after the feature is disabled is independently protected by the backend and is not backfilled as the current configuration association.
1155
+ *
1156
+ * This parameter is required.
1157
+ *
1158
+ * @example
1159
+ * img-example
1160
+ *
1161
+ * **if can be null:**
1162
+ * true
1163
+ */
1164
+ imageCacheId?: string;
1165
+ /**
1166
+ * @remarks
1167
+ * This field is always returned when caching is enabled in the final configuration for a create or update operation, including the reuse of existing registrations. This field is omitted when the final switch is disabled or during a get operation. Old summaries are not returned.
1168
+ */
1169
+ imageCachePreparation?: UpdateCustomAgentResponseBodyDataImageCachePreparation;
1170
+ /**
1171
+ * @remarks
1172
+ * The wait or execution error of the latest configuration version. This field is returned only when the version is waiting for a retry or fails to execute.
1052
1173
  */
1053
1174
  latestExecutionError?: UpdateCustomAgentResponseBodyDataLatestExecutionError;
1054
1175
  /**
1055
1176
  * @remarks
1056
1177
  * The latest configuration version number. Updates with the same configuration may retain the original version number. This field does not indicate that the configuration has taken effect.
1057
1178
  *
1179
+ * This parameter is required.
1180
+ *
1058
1181
  * @example
1059
1182
  * 1
1060
1183
  */
@@ -1062,15 +1185,18 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1062
1185
  /**
1063
1186
  * @remarks
1064
1187
  * The execution status corresponding to latestSpecVersion. Valid values:
1065
- * - pending: Waiting for execution.
1188
+ * - pending: Pending execution.
1066
1189
  * - processing: Executing.
1067
- * - waiting_retry: Waiting for a retry.
1068
- * - succeeded: Executed successfully.
1190
+ * - waiting_retry: Waiting for retry.
1191
+ * - succeeded: Execution succeeded.
1069
1192
  * - failed: Execution failed.
1070
1193
  * - superseded: Superseded by a subsequent version.
1071
1194
  *
1072
1195
  * @example
1073
1196
  * succeeded
1197
+ *
1198
+ * **if can be null:**
1199
+ * true
1074
1200
  */
1075
1201
  latestVersionStatus?: string;
1076
1202
  /**
@@ -1082,15 +1208,22 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1082
1208
  * @remarks
1083
1209
  * The name of the custom agent.
1084
1210
  *
1211
+ * This parameter is required.
1212
+ *
1085
1213
  * @example
1086
1214
  * my-custom-agent
1087
1215
  */
1088
1216
  name?: string;
1089
1217
  /**
1090
1218
  * @remarks
1091
- * The network access configuration of the agent. The actual access scope is also limited by the network configuration of the workspace.
1219
+ * The network access configuration of the agent. The actual access scope is also restricted by the network configuration of the workspace.
1092
1220
  */
1093
1221
  network?: UpdateCustomAgentResponseBodyDataNetwork;
1222
+ /**
1223
+ * @remarks
1224
+ * The observability configuration for high-code agents.
1225
+ */
1226
+ observability?: UpdateCustomAgentResponseBodyDataObservability;
1094
1227
  /**
1095
1228
  * @remarks
1096
1229
  * The latest submitted list of OSS directory mounts.
@@ -1119,7 +1252,7 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1119
1252
  roleArn?: string;
1120
1253
  /**
1121
1254
  * @remarks
1122
- * The latest committed runtime configurations, including compute specifications, session policy, and elastic policy.
1255
+ * The latest committed runtime configuration, including compute specifications, session policy, and elastic policy.
1123
1256
  */
1124
1257
  runtime?: UpdateCustomAgentResponseBodyDataRuntime;
1125
1258
  /**
@@ -1130,13 +1263,15 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1130
1263
  /**
1131
1264
  * @remarks
1132
1265
  * The overall status of the agent. Valid values:
1133
- * - Creating: The agent is being created.
1134
- * - Running: The agent is running.
1135
- * - Failed: The agent failed.
1136
- * - Updating: The agent is being updated.
1137
- * - Deleting: The agent is being deleted.
1138
- * - Deleted: The agent is deleted.
1139
- * To query the execution progress of the latest configuration, check latestVersionStatus.
1266
+ * - Creating: Creating.
1267
+ * - Running: Running.
1268
+ * - Failed: Failed.
1269
+ * - Updating: Updating.
1270
+ * - Deleting: Deleting.
1271
+ * - Deleted: Deleted.
1272
+ * To check the execution progress of the latest configuration, query latestVersionStatus.
1273
+ *
1274
+ * This parameter is required.
1140
1275
  *
1141
1276
  * @example
1142
1277
  * Running
@@ -1144,16 +1279,28 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1144
1279
  status?: string;
1145
1280
  /**
1146
1281
  * @remarks
1147
- * The time when the agent was last updated. The time is in ISO 8601 format. A trailing Z indicates the UTC time zone. Fractional seconds may be included.
1282
+ * The time when the agent was last updated, in ISO 8601 format. The trailing Z indicates the UTC time zone, and fractional seconds may be included.
1148
1283
  *
1149
1284
  * @example
1150
1285
  * 2026-10-10T06:05:00Z
1151
1286
  */
1152
1287
  updatedAt?: string;
1288
+ /**
1289
+ * @remarks
1290
+ * Required. Reflects the final accepted configuration. If this field is missing in historical data, false is returned. Do not infer the value based on the cache status.
1291
+ *
1292
+ * This parameter is required.
1293
+ *
1294
+ * @example
1295
+ * true
1296
+ */
1297
+ useImageCache?: boolean;
1153
1298
  /**
1154
1299
  * @remarks
1155
1300
  * The ID of the workspace to which the custom agent belongs.
1156
1301
  *
1302
+ * This parameter is required.
1303
+ *
1157
1304
  * @example
1158
1305
  * ws-a1b2c3d4e5f6
1159
1306
  */
@@ -1167,14 +1314,18 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1167
1314
  createdAt: 'createdAt',
1168
1315
  deployType: 'deployType',
1169
1316
  description: 'description',
1317
+ effectiveSpecVersion: 'effectiveSpecVersion',
1170
1318
  environment: 'environment',
1171
1319
  healthCheck: 'healthCheck',
1320
+ imageCacheId: 'imageCacheId',
1321
+ imageCachePreparation: 'imageCachePreparation',
1172
1322
  latestExecutionError: 'latestExecutionError',
1173
1323
  latestSpecVersion: 'latestSpecVersion',
1174
1324
  latestVersionStatus: 'latestVersionStatus',
1175
1325
  logging: 'logging',
1176
1326
  name: 'name',
1177
1327
  network: 'network',
1328
+ observability: 'observability',
1178
1329
  ossMounts: 'ossMounts',
1179
1330
  protocol: 'protocol',
1180
1331
  regionId: 'regionId',
@@ -1183,6 +1334,7 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1183
1334
  sandboxPhaseCounts: 'sandboxPhaseCounts',
1184
1335
  status: 'status',
1185
1336
  updatedAt: 'updatedAt',
1337
+ useImageCache: 'useImageCache',
1186
1338
  workspaceId: 'workspaceId',
1187
1339
  };
1188
1340
  }
@@ -1196,14 +1348,18 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1196
1348
  createdAt: 'string',
1197
1349
  deployType: 'string',
1198
1350
  description: 'string',
1351
+ effectiveSpecVersion: 'number',
1199
1352
  environment: UpdateCustomAgentResponseBodyDataEnvironment,
1200
1353
  healthCheck: UpdateCustomAgentResponseBodyDataHealthCheck,
1354
+ imageCacheId: 'string',
1355
+ imageCachePreparation: UpdateCustomAgentResponseBodyDataImageCachePreparation,
1201
1356
  latestExecutionError: UpdateCustomAgentResponseBodyDataLatestExecutionError,
1202
1357
  latestSpecVersion: 'number',
1203
1358
  latestVersionStatus: 'string',
1204
1359
  logging: UpdateCustomAgentResponseBodyDataLogging,
1205
1360
  name: 'string',
1206
1361
  network: UpdateCustomAgentResponseBodyDataNetwork,
1362
+ observability: UpdateCustomAgentResponseBodyDataObservability,
1207
1363
  ossMounts: { 'type': 'array', 'itemType': UpdateCustomAgentResponseBodyDataOssMounts },
1208
1364
  protocol: { 'type': 'array', 'itemType': UpdateCustomAgentResponseBodyDataProtocol },
1209
1365
  regionId: 'string',
@@ -1212,6 +1368,7 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1212
1368
  sandboxPhaseCounts: { 'type': 'map', 'keyType': 'string', 'valueType': 'number' },
1213
1369
  status: 'string',
1214
1370
  updatedAt: 'string',
1371
+ useImageCache: 'boolean',
1215
1372
  workspaceId: 'string',
1216
1373
  };
1217
1374
  }
@@ -1229,6 +1386,9 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1229
1386
  if(this.healthCheck && typeof (this.healthCheck as any).validate === 'function') {
1230
1387
  (this.healthCheck as any).validate();
1231
1388
  }
1389
+ if(this.imageCachePreparation && typeof (this.imageCachePreparation as any).validate === 'function') {
1390
+ (this.imageCachePreparation as any).validate();
1391
+ }
1232
1392
  if(this.latestExecutionError && typeof (this.latestExecutionError as any).validate === 'function') {
1233
1393
  (this.latestExecutionError as any).validate();
1234
1394
  }
@@ -1238,6 +1398,9 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1238
1398
  if(this.network && typeof (this.network as any).validate === 'function') {
1239
1399
  (this.network as any).validate();
1240
1400
  }
1401
+ if(this.observability && typeof (this.observability as any).validate === 'function') {
1402
+ (this.observability as any).validate();
1403
+ }
1241
1404
  if(Array.isArray(this.ossMounts)) {
1242
1405
  $dara.Model.validateArray(this.ossMounts);
1243
1406
  }
@@ -1261,7 +1424,9 @@ export class UpdateCustomAgentResponseBodyData extends $dara.Model {
1261
1424
  export class UpdateCustomAgentResponseBody extends $dara.Model {
1262
1425
  /**
1263
1426
  * @remarks
1264
- * The request result code. The value is SUCCESS when the request is successful.
1427
+ * The request result code. The value is SUCCESS when the request succeeds.
1428
+ *
1429
+ * This parameter is required.
1265
1430
  *
1266
1431
  * @example
1267
1432
  * SUCCESS
@@ -1269,12 +1434,16 @@ export class UpdateCustomAgentResponseBody extends $dara.Model {
1269
1434
  code?: string;
1270
1435
  /**
1271
1436
  * @remarks
1272
- * The latest submitted configuration and status of the custom agent. A successful response indicates that the request is accepted, but the configuration may not have taken effect yet.
1437
+ * The latest submitted configuration and status of the custom agent. A successful response indicates that the request is accepted, but the configuration may not have taken effect.
1438
+ *
1439
+ * This parameter is required.
1273
1440
  */
1274
1441
  data?: UpdateCustomAgentResponseBodyData;
1275
1442
  /**
1276
1443
  * @remarks
1277
- * The HTTP status code of the request. A value of 200 indicates success.
1444
+ * The HTTP status code of the request. The value is 200 if the request is successful.
1445
+ *
1446
+ * This parameter is required.
1278
1447
  *
1279
1448
  * @example
1280
1449
  * 200
@@ -1282,7 +1451,9 @@ export class UpdateCustomAgentResponseBody extends $dara.Model {
1282
1451
  httpStatusCode?: number;
1283
1452
  /**
1284
1453
  * @remarks
1285
- * The processing result message of the request. The value is success if the request succeeds.
1454
+ * The result message of the request. The value is success if the request is successful.
1455
+ *
1456
+ * This parameter is required.
1286
1457
  *
1287
1458
  * @example
1288
1459
  * success
@@ -1290,7 +1461,9 @@ export class UpdateCustomAgentResponseBody extends $dara.Model {
1290
1461
  message?: string;
1291
1462
  /**
1292
1463
  * @remarks
1293
- * The unique identifier of the request. You can use this ID to locate and troubleshoot issues.
1464
+ * The unique identifier of the request, used to locate and troubleshoot issues.
1465
+ *
1466
+ * This parameter is required.
1294
1467
  *
1295
1468
  * @example
1296
1469
  * 550E8400-E29B-41D4-A716-446655440000
@@ -1298,7 +1471,9 @@ export class UpdateCustomAgentResponseBody extends $dara.Model {
1298
1471
  requestId?: string;
1299
1472
  /**
1300
1473
  * @remarks
1301
- * Indicates whether the request is successful. A value of true indicates that the request is successful. Note that a successful creation, update, or deletion does not mean that the background operation is complete.
1474
+ * Indicates whether the request was processed successfully. A value of true indicates that the request was processed successfully. A successful creation, update, or deletion does not mean that the background operation is complete.
1475
+ *
1476
+ * This parameter is required.
1302
1477
  */
1303
1478
  success?: boolean;
1304
1479
  static names(): { [key: string]: string } {
@@ -5,12 +5,12 @@ import * as $dara from '@darabonba/typescript';
5
5
  export class UpdateCustomAgentShrinkRequest extends $dara.Model {
6
6
  /**
7
7
  * @remarks
8
- * The update configuration for the custom agent. Provide at least one top-level field. Omitted top-level fields retain their original values. When providing a configuration object, you must specify its required subfields and include any optional configurations that you want to retain. Arrays are replaced as a whole.
8
+ * The update configuration for the custom agent. Specify at least one top-level field. Omitted top-level fields retain their original values. When providing a configuration object, specify its required subfields and include any optional configurations that you want to retain. Arrays are replaced as a whole.
9
9
  */
10
10
  bodyShrink?: string;
11
11
  /**
12
12
  * @remarks
13
- * Idempotency is not currently guaranteed. Do not rely on this parameter to prevent duplicate requests.
13
+ * Idempotence is not currently guaranteed. Do not rely on this parameter to prevent duplicate requests.
14
14
  *
15
15
  * @example
16
16
  * custom-agent-request-20261010-001