@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
@@ -21,7 +21,7 @@ export class GetCustomAgentResponseBodyDataAgenticFsMounts extends $dara.Model {
21
21
  path?: string;
22
22
  /**
23
23
  * @remarks
24
- * Specifies whether the mount is read-only. A value of true indicates a read-only mount, and a value of false indicates a read-write mount.
24
+ * Specifies whether the mount is read-only. A value of true indicates read-only, and false indicates read and write.
25
25
  *
26
26
  * @example
27
27
  * false
@@ -169,7 +169,7 @@ export class GetCustomAgentResponseBodyDataArtifactContainer extends $dara.Model
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 GetCustomAgentResponseBodyDataArtifact extends $dara.Model {
221
221
  container?: GetCustomAgentResponseBodyDataArtifactContainer;
222
222
  /**
223
223
  * @remarks
224
- * The TCP port listened on by the agent service.
224
+ * The TCP port listened by the agent service.
225
225
  *
226
226
  * This parameter is required.
227
227
  *
@@ -345,7 +345,7 @@ export class GetCustomAgentResponseBodyDataHealthCheck 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
@@ -377,7 +377,7 @@ export class GetCustomAgentResponseBodyDataHealthCheck 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 required to mark the instance as unhealthy.
381
381
  *
382
382
  * @example
383
383
  * 3
@@ -417,7 +417,9 @@ export class GetCustomAgentResponseBodyDataHealthCheck extends $dara.Model {
417
417
  export class GetCustomAgentResponseBodyDataLatestExecutionError extends $dara.Model {
418
418
  /**
419
419
  * @remarks
420
- * The cause code for the waiting or execution failure of the latest configuration. This code is used to determine the subsequent handling method.
420
+ * The reason code for the wait or execution failure of the latest configuration. This code is used to determine the subsequent handling method.
421
+ *
422
+ * This parameter is required.
421
423
  *
422
424
  * @example
423
425
  * AgentExecutionFailed
@@ -425,7 +427,9 @@ export class GetCustomAgentResponseBodyDataLatestExecutionError extends $dara.Mo
425
427
  code?: string;
426
428
  /**
427
429
  * @remarks
428
- * The reason why the latest configuration is pending or failed to execute. Determine what to do next based on the code and retryable fields.
430
+ * 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.
431
+ *
432
+ * This parameter is required.
429
433
  *
430
434
  * @example
431
435
  * Agent execution failed. Check the configuration and resubmit
@@ -433,7 +437,9 @@ export class GetCustomAgentResponseBodyDataLatestExecutionError extends $dara.Mo
433
437
  message?: string;
434
438
  /**
435
439
  * @remarks
436
- * Specifies whether automatic retries are 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.
440
+ * Specifies whether automatic retries are 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.
441
+ *
442
+ * This parameter is required.
437
443
  */
438
444
  retryable?: boolean;
439
445
  static names(): { [key: string]: string } {
@@ -534,7 +540,7 @@ export class GetCustomAgentResponseBodyDataLogging extends $dara.Model {
534
540
  export class GetCustomAgentResponseBodyDataNetworkAccessInternet extends $dara.Model {
535
541
  /**
536
542
  * @remarks
537
- * Specifies whether Internet access is allowed on the agent side. The actual access is still restricted by the workspace.
543
+ * Specifies whether Internet access is allowed on the agent side. The actual access remains restricted by the workspace.
538
544
  */
539
545
  enabled?: boolean;
540
546
  static names(): { [key: string]: string } {
@@ -561,7 +567,7 @@ export class GetCustomAgentResponseBodyDataNetworkAccessInternet extends $dara.M
561
567
  export class GetCustomAgentResponseBodyDataNetworkAccessVpc extends $dara.Model {
562
568
  /**
563
569
  * @remarks
564
- * Specifies whether access to the user VPC configured for the workspace is allowed on the agent side. The actual access is still restricted by the workspace.
570
+ * 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
571
  */
566
572
  enabled?: boolean;
567
573
  static names(): { [key: string]: string } {
@@ -588,12 +594,12 @@ export class GetCustomAgentResponseBodyDataNetworkAccessVpc extends $dara.Model
588
594
  export class GetCustomAgentResponseBodyDataNetwork extends $dara.Model {
589
595
  /**
590
596
  * @remarks
591
- * The Internet access configuration of the agent. If this field is not configured, Internet access is allowed on the agent side but is still restricted by the workspace.
597
+ * 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
598
  */
593
599
  accessInternet?: GetCustomAgentResponseBodyDataNetworkAccessInternet;
594
600
  /**
595
601
  * @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 is still restricted by the workspace.
602
+ * 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
603
  */
598
604
  accessVpc?: GetCustomAgentResponseBodyDataNetworkAccessVpc;
599
605
  static names(): { [key: string]: string } {
@@ -625,6 +631,33 @@ export class GetCustomAgentResponseBodyDataNetwork extends $dara.Model {
625
631
  }
626
632
  }
627
633
 
634
+ export class GetCustomAgentResponseBodyDataObservability extends $dara.Model {
635
+ /**
636
+ * @remarks
637
+ * Default value: true. If set to false, the platform Python probe is not loaded at runtime, and you must collect observability data yourself.
638
+ */
639
+ enabled?: boolean;
640
+ static names(): { [key: string]: string } {
641
+ return {
642
+ enabled: 'enabled',
643
+ };
644
+ }
645
+
646
+ static types(): { [key: string]: any } {
647
+ return {
648
+ enabled: 'boolean',
649
+ };
650
+ }
651
+
652
+ validate() {
653
+ super.validate();
654
+ }
655
+
656
+ constructor(map?: { [key: string]: any }) {
657
+ super(map);
658
+ }
659
+ }
660
+
628
661
  export class GetCustomAgentResponseBodyDataOssMounts extends $dara.Model {
629
662
  /**
630
663
  * @remarks
@@ -652,7 +685,7 @@ export class GetCustomAgentResponseBodyDataOssMounts extends $dara.Model {
652
685
  path?: string;
653
686
  /**
654
687
  * @remarks
655
- * Specifies whether the mount is read-only. A value of true indicates a read-only mount, and a value of false indicates a read-write mount.
688
+ * Specifies whether the mount is read-only. A value of true indicates read-only, and false indicates read and write.
656
689
  */
657
690
  readOnly?: boolean;
658
691
  static names(): { [key: string]: string } {
@@ -727,7 +760,7 @@ export class GetCustomAgentResponseBodyDataProtocolPaths extends $dara.Model {
727
760
  export class GetCustomAgentResponseBodyDataProtocol extends $dara.Model {
728
761
  /**
729
762
  * @remarks
730
- * The request header configurations for the current protocol, where the key is the name and the value is a string.
763
+ * The request header configuration for the current protocol. The key is the name and the value is a string.
731
764
  */
732
765
  headers?: { [key: string]: string };
733
766
  /**
@@ -737,10 +770,7 @@ export class GetCustomAgentResponseBodyDataProtocol extends $dara.Model {
737
770
  paths?: GetCustomAgentResponseBodyDataProtocolPaths[];
738
771
  /**
739
772
  * @remarks
740
- * The invocation protocol type. Valid values:
741
- * - agui: AG-UI protocol.
742
- * - openai-chat-completion: OpenAI Chat Completions compatible protocol.
743
- * - custom: Custom protocol.
773
+ * The invocation protocol type. Valid values: agui: AG-UI protocol; openai-chat-completion: OpenAI Chat Completions compatible protocol; custom: custom protocol.
744
774
  *
745
775
  * This parameter is required.
746
776
  *
@@ -782,10 +812,7 @@ export class GetCustomAgentResponseBodyDataProtocol extends $dara.Model {
782
812
  export class GetCustomAgentResponseBodyDataRuntimeCompute extends $dara.Model {
783
813
  /**
784
814
  * @remarks
785
- * The compute specification. Valid values:
786
- * - INTERACTIVE: 1 vCPU and 2 GiB of memory.
787
- * - STANDARD: 2 vCPUs and 4 GiB of memory.
788
- * - HEAVY: 4 vCPUs and 8 GiB of memory.
815
+ * The compute specification. Valid values: INTERACTIVE: 1 vCPU and 2 GiB of memory; STANDARD: 2 vCPUs and 4 GiB of memory; HEAVY: 4 vCPUs and 8 GiB of memory.
789
816
  *
790
817
  * This parameter is required.
791
818
  *
@@ -817,16 +844,14 @@ export class GetCustomAgentResponseBodyDataRuntimeCompute extends $dara.Model {
817
844
  export class GetCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
818
845
  /**
819
846
  * @remarks
820
- * Specifies whether to enable elastic scaling. Valid values:
821
- * - true: Enabled.
822
- * - false: Disabled.
847
+ * Specifies whether to enable elastic scaling. A value of true indicates that elastic scaling is enabled. A value of false indicates that elastic scaling is disabled.
823
848
  *
824
849
  * This parameter is required.
825
850
  */
826
851
  enabled?: boolean;
827
852
  /**
828
853
  * @remarks
829
- * The configured maximum number of concurrent sessions per runtime instance.
854
+ * The configured maximum number of concurrent sessions for a single runtime instance.
830
855
  *
831
856
  * @example
832
857
  * 100
@@ -888,7 +913,7 @@ export class GetCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
888
913
  export class GetCustomAgentResponseBodyDataRuntimeSessionPolicy extends $dara.Model {
889
914
  /**
890
915
  * @remarks
891
- * The name of the HTTP request header used by the session policy, applicable to ISOLATED_HEADER_FIELD.
916
+ * The name of the HTTP request header used by the session policy. This parameter is applicable to ISOLATED_HEADER_FIELD.
892
917
  *
893
918
  * @example
894
919
  * X-Session-Id
@@ -896,11 +921,7 @@ export class GetCustomAgentResponseBodyDataRuntimeSessionPolicy extends $dara.Mo
896
921
  headerName?: string;
897
922
  /**
898
923
  * @remarks
899
- * The session policy type. Valid values:
900
- * - AFFINITY: Session affinity.
901
- * - ISOLATED_HEADER_FIELD: Uses the request header specified by headerName to associate sessions.
902
- * - ISOLATED_COOKIE: Cookie-based session isolation. Not recommended.
903
- * Note: The compatible value DISABLED in a request is returned as AFFINITY.
924
+ * The session policy type. Valid values: AFFINITY: session affinity; ISOLATED_HEADER_FIELD: uses the request header specified by headerName to associate sessions. ISOLATED_COOKIE is not recommended. The compatible value DISABLED in requests is returned as AFFINITY.
904
925
  *
905
926
  * This parameter is required.
906
927
  *
@@ -934,19 +955,19 @@ export class GetCustomAgentResponseBodyDataRuntimeSessionPolicy extends $dara.Mo
934
955
  export class GetCustomAgentResponseBodyDataRuntime extends $dara.Model {
935
956
  /**
936
957
  * @remarks
937
- * The compute resource configuration for the agent runtime instance.
958
+ * The compute resource configuration of the agent runtime instance.
938
959
  *
939
960
  * This parameter is required.
940
961
  */
941
962
  compute?: GetCustomAgentResponseBodyDataRuntimeCompute;
942
963
  /**
943
964
  * @remarks
944
- * The elastic policy configuration for the agent.
965
+ * The elastic policy configuration of the agent.
945
966
  */
946
967
  hpa?: GetCustomAgentResponseBodyDataRuntimeHpa;
947
968
  /**
948
969
  * @remarks
949
- * The session policy configuration for the agent.
970
+ * The session policy configuration of the agent.
950
971
  *
951
972
  * This parameter is required.
952
973
  */
@@ -988,7 +1009,9 @@ export class GetCustomAgentResponseBodyDataRuntime extends $dara.Model {
988
1009
  export class GetCustomAgentResponseBodyData extends $dara.Model {
989
1010
  /**
990
1011
  * @remarks
991
- * The unique identifier of the custom agent. You can obtain this value from the response of CreateCustomAgent or ListCustomAgents.
1012
+ * The unique identifier of the custom agent. You can obtain this identifier from the response of CreateCustomAgent or ListCustomAgents.
1013
+ *
1014
+ * This parameter is required.
992
1015
  *
993
1016
  * @example
994
1017
  * agent-550e8400e29b41d4a716446655440000
@@ -1001,12 +1024,12 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1001
1024
  agenticFsMounts?: GetCustomAgentResponseBodyDataAgenticFsMounts[];
1002
1025
  /**
1003
1026
  * @remarks
1004
- * The latest submitted deployment artifact configuration, including the service listening port and ACR container image. To determine whether the configuration has taken effect, check the latestVersionStatus field.
1027
+ * The latest submitted deployment artifact configuration, including the service listening port and ACR container image. To determine whether the configuration has taken effect, refer to latestVersionStatus.
1005
1028
  */
1006
1029
  artifact?: GetCustomAgentResponseBodyDataArtifact;
1007
1030
  /**
1008
1031
  * @remarks
1009
- * The creation method of the agent. The value is CUSTOM for custom agents.
1032
+ * The creation method of the agent. CUSTOM is returned for custom agents.
1010
1033
  *
1011
1034
  * @example
1012
1035
  * CUSTOM
@@ -1022,7 +1045,7 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1022
1045
  createdAt?: string;
1023
1046
  /**
1024
1047
  * @remarks
1025
- * The deployment method of the agent. Custom agents are deployed and managed by the platform, and the value is MANAGED.
1048
+ * The deployment method of the agent. MANAGED is returned for custom agents because they are deployed and managed by the platform.
1026
1049
  *
1027
1050
  * @example
1028
1051
  * MANAGED
@@ -1030,12 +1053,25 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1030
1053
  deployType?: string;
1031
1054
  /**
1032
1055
  * @remarks
1033
- * The description of the agent.
1056
+ * The description of the agent\\"s purpose.
1034
1057
  *
1035
1058
  * @example
1036
- * Custom agent that provides conversation services
1059
+ * Custom agent that provides conversational services
1037
1060
  */
1038
1061
  description?: string;
1062
+ /**
1063
+ * @remarks
1064
+ * The value is null if no effective version exists. Do not use latestSpecVersion as a substitute. This field cannot be used to release the occupation protection of old cached instances.
1065
+ *
1066
+ * This parameter is required.
1067
+ *
1068
+ * @example
1069
+ * 1
1070
+ *
1071
+ * **if can be null:**
1072
+ * true
1073
+ */
1074
+ effectiveSpecVersion?: number;
1039
1075
  /**
1040
1076
  * @remarks
1041
1077
  * The environment variable configuration for the agent process.
@@ -1043,34 +1079,46 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1043
1079
  environment?: GetCustomAgentResponseBodyDataEnvironment;
1044
1080
  /**
1045
1081
  * @remarks
1046
- * The HTTP health check configuration of the agent. This field is empty if not configured.
1082
+ * The HTTP health check configuration of the agent. The value is empty if not configured.
1047
1083
  */
1048
1084
  healthCheck?: GetCustomAgentResponseBodyDataHealthCheck;
1049
1085
  /**
1050
1086
  * @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.
1087
+ * This field is always returned. If useImageCache is true, the value is the non-empty logical ID of the current workspace. If useImageCache is false, the value is null. The occupation of old instances after disabling is independently protected by the backend and is not backfilled as the current configuration association.
1088
+ *
1089
+ * This parameter is required.
1090
+ *
1091
+ * @example
1092
+ * img-example
1093
+ *
1094
+ * **if can be null:**
1095
+ * true
1096
+ */
1097
+ imageCacheId?: string;
1098
+ /**
1099
+ * @remarks
1100
+ * 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
1101
  */
1053
1102
  latestExecutionError?: GetCustomAgentResponseBodyDataLatestExecutionError;
1054
1103
  /**
1055
1104
  * @remarks
1056
1105
  * The current 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
1106
  *
1107
+ * This parameter is required.
1108
+ *
1058
1109
  * @example
1059
1110
  * 1
1060
1111
  */
1061
1112
  latestSpecVersion?: number;
1062
1113
  /**
1063
1114
  * @remarks
1064
- * The execution status corresponding to latestSpecVersion. Valid values:
1065
- * - pending: Waiting for execution.
1066
- * - processing: Executing.
1067
- * - waiting_retry: Waiting for a retry.
1068
- * - succeeded: Executed successfully.
1069
- * - failed: Execution failed.
1070
- * - superseded: Superseded by a subsequent version.
1115
+ * The execution status corresponding to latestSpecVersion. Valid values: pending (waiting for execution), processing (executing), waiting_retry (waiting for a retry), succeeded (execution successful), failed (execution failed), and superseded (replaced by a subsequent version).
1071
1116
  *
1072
1117
  * @example
1073
1118
  * succeeded
1119
+ *
1120
+ * **if can be null:**
1121
+ * true
1074
1122
  */
1075
1123
  latestVersionStatus?: string;
1076
1124
  /**
@@ -1080,7 +1128,9 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1080
1128
  logging?: GetCustomAgentResponseBodyDataLogging;
1081
1129
  /**
1082
1130
  * @remarks
1083
- * The name of the custom agent.
1131
+ * The custom agent name.
1132
+ *
1133
+ * This parameter is required.
1084
1134
  *
1085
1135
  * @example
1086
1136
  * my-custom-agent
@@ -1093,7 +1143,12 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1093
1143
  network?: GetCustomAgentResponseBodyDataNetwork;
1094
1144
  /**
1095
1145
  * @remarks
1096
- * The latest submitted list of OSS directory mounts.
1146
+ * The high-code agent observability configuration.
1147
+ */
1148
+ observability?: GetCustomAgentResponseBodyDataObservability;
1149
+ /**
1150
+ * @remarks
1151
+ * The list of recently submitted OSS directory mounts.
1097
1152
  */
1098
1153
  ossMounts?: GetCustomAgentResponseBodyDataOssMounts[];
1099
1154
  /**
@@ -1124,19 +1179,14 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1124
1179
  runtime?: GetCustomAgentResponseBodyDataRuntime;
1125
1180
  /**
1126
1181
  * @remarks
1127
- * The counts by runtime instance phase. Keys include PENDING (creating or initializing), RUNNING (running), HIBERNATING (hibernating), HIBERNATED (hibernated), RESUMING (resuming), TERMINATING (terminating), and FAILED (failed). Only phases that actually occur are returned. Missing keys are treated as 0.
1182
+ * The number of instances by runtime instance phase. Keys include PENDING (creating or initializing), RUNNING (running), HIBERNATING (hibernating), HIBERNATED (hibernated), RESUMING (resuming), TERMINATING (terminating), and FAILED (failed). Only phases that actually occur are returned. Missing keys are treated as 0.
1128
1183
  */
1129
1184
  sandboxPhaseCounts?: { [key: string]: number };
1130
1185
  /**
1131
1186
  * @remarks
1132
- * 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 check the execution progress of the latest configuration, query latestVersionStatus.
1187
+ * The overall status of the agent. Valid values: Creating: creating; Running: running; Failed: failed; Updating: updating; Deleting: deleting; Deleted: deleted. To query the execution progress of the latest configuration, check latestVersionStatus.
1188
+ *
1189
+ * This parameter is required.
1140
1190
  *
1141
1191
  * @example
1142
1192
  * Running
@@ -1144,16 +1194,28 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1144
1194
  status?: string;
1145
1195
  /**
1146
1196
  * @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.
1197
+ * The time when the agent was last updated. The time is in ISO 8601 format. The trailing Z indicates the UTC time zone. Fractional seconds may be included.
1148
1198
  *
1149
1199
  * @example
1150
1200
  * 2026-10-10T06:05:00Z
1151
1201
  */
1152
1202
  updatedAt?: string;
1203
+ /**
1204
+ * @remarks
1205
+ * Required. Reflects the accepted final configuration. If this field is missing in historical data, false is returned. Do not infer based on the cache status.
1206
+ *
1207
+ * This parameter is required.
1208
+ *
1209
+ * @example
1210
+ * true
1211
+ */
1212
+ useImageCache?: boolean;
1153
1213
  /**
1154
1214
  * @remarks
1155
1215
  * The ID of the workspace to which the custom agent belongs.
1156
1216
  *
1217
+ * This parameter is required.
1218
+ *
1157
1219
  * @example
1158
1220
  * ws-a1b2c3d4e5f6
1159
1221
  */
@@ -1167,14 +1229,17 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1167
1229
  createdAt: 'createdAt',
1168
1230
  deployType: 'deployType',
1169
1231
  description: 'description',
1232
+ effectiveSpecVersion: 'effectiveSpecVersion',
1170
1233
  environment: 'environment',
1171
1234
  healthCheck: 'healthCheck',
1235
+ imageCacheId: 'imageCacheId',
1172
1236
  latestExecutionError: 'latestExecutionError',
1173
1237
  latestSpecVersion: 'latestSpecVersion',
1174
1238
  latestVersionStatus: 'latestVersionStatus',
1175
1239
  logging: 'logging',
1176
1240
  name: 'name',
1177
1241
  network: 'network',
1242
+ observability: 'observability',
1178
1243
  ossMounts: 'ossMounts',
1179
1244
  protocol: 'protocol',
1180
1245
  regionId: 'regionId',
@@ -1183,6 +1248,7 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1183
1248
  sandboxPhaseCounts: 'sandboxPhaseCounts',
1184
1249
  status: 'status',
1185
1250
  updatedAt: 'updatedAt',
1251
+ useImageCache: 'useImageCache',
1186
1252
  workspaceId: 'workspaceId',
1187
1253
  };
1188
1254
  }
@@ -1196,14 +1262,17 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1196
1262
  createdAt: 'string',
1197
1263
  deployType: 'string',
1198
1264
  description: 'string',
1265
+ effectiveSpecVersion: 'number',
1199
1266
  environment: GetCustomAgentResponseBodyDataEnvironment,
1200
1267
  healthCheck: GetCustomAgentResponseBodyDataHealthCheck,
1268
+ imageCacheId: 'string',
1201
1269
  latestExecutionError: GetCustomAgentResponseBodyDataLatestExecutionError,
1202
1270
  latestSpecVersion: 'number',
1203
1271
  latestVersionStatus: 'string',
1204
1272
  logging: GetCustomAgentResponseBodyDataLogging,
1205
1273
  name: 'string',
1206
1274
  network: GetCustomAgentResponseBodyDataNetwork,
1275
+ observability: GetCustomAgentResponseBodyDataObservability,
1207
1276
  ossMounts: { 'type': 'array', 'itemType': GetCustomAgentResponseBodyDataOssMounts },
1208
1277
  protocol: { 'type': 'array', 'itemType': GetCustomAgentResponseBodyDataProtocol },
1209
1278
  regionId: 'string',
@@ -1212,6 +1281,7 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1212
1281
  sandboxPhaseCounts: { 'type': 'map', 'keyType': 'string', 'valueType': 'number' },
1213
1282
  status: 'string',
1214
1283
  updatedAt: 'string',
1284
+ useImageCache: 'boolean',
1215
1285
  workspaceId: 'string',
1216
1286
  };
1217
1287
  }
@@ -1238,6 +1308,9 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1238
1308
  if(this.network && typeof (this.network as any).validate === 'function') {
1239
1309
  (this.network as any).validate();
1240
1310
  }
1311
+ if(this.observability && typeof (this.observability as any).validate === 'function') {
1312
+ (this.observability as any).validate();
1313
+ }
1241
1314
  if(Array.isArray(this.ossMounts)) {
1242
1315
  $dara.Model.validateArray(this.ossMounts);
1243
1316
  }
@@ -1261,7 +1334,9 @@ export class GetCustomAgentResponseBodyData extends $dara.Model {
1261
1334
  export class GetCustomAgentResponseBody extends $dara.Model {
1262
1335
  /**
1263
1336
  * @remarks
1264
- * The request result code. The value is SUCCESS when the request is successful.
1337
+ * The request result code. The value is SUCCESS if the request is successful.
1338
+ *
1339
+ * This parameter is required.
1265
1340
  *
1266
1341
  * @example
1267
1342
  * SUCCESS
@@ -1269,20 +1344,26 @@ export class GetCustomAgentResponseBody extends $dara.Model {
1269
1344
  code?: string;
1270
1345
  /**
1271
1346
  * @remarks
1272
- * The latest submitted configuration and status of the custom agent. To determine whether the configuration has taken effect, check the latestVersionStatus field.
1347
+ * The latest submitted configuration and status of the custom agent. To determine whether the configuration has taken effect, refer to latestVersionStatus.
1348
+ *
1349
+ * This parameter is required.
1273
1350
  */
1274
1351
  data?: GetCustomAgentResponseBodyData;
1275
1352
  /**
1276
1353
  * @remarks
1277
1354
  * The HTTP status code of the request. A value of 200 indicates success.
1278
1355
  *
1356
+ * This parameter is required.
1357
+ *
1279
1358
  * @example
1280
1359
  * 200
1281
1360
  */
1282
1361
  httpStatusCode?: number;
1283
1362
  /**
1284
1363
  * @remarks
1285
- * The result message of the request. The value is success when the request is successful.
1364
+ * The processing result description of the request. A value of success indicates success.
1365
+ *
1366
+ * This parameter is required.
1286
1367
  *
1287
1368
  * @example
1288
1369
  * success
@@ -1292,13 +1373,17 @@ export class GetCustomAgentResponseBody extends $dara.Model {
1292
1373
  * @remarks
1293
1374
  * The unique identifier of the request, which is used to locate and troubleshoot issues.
1294
1375
  *
1376
+ * This parameter is required.
1377
+ *
1295
1378
  * @example
1296
1379
  * 550E8400-E29B-41D4-A716-446655440000
1297
1380
  */
1298
1381
  requestId?: string;
1299
1382
  /**
1300
1383
  * @remarks
1301
- * Indicates whether the request was processed successfully. A value of true indicates success. Note that a successful creation, update, or deletion response does not mean that the background operation is complete.
1384
+ * Indicates whether the request was successful. A value of true indicates that the request was successful. A successful creation, update, or deletion does not mean that the background operation is complete.
1385
+ *
1386
+ * This parameter is required.
1302
1387
  */
1303
1388
  success?: boolean;
1304
1389
  static names(): { [key: string]: string } {
@@ -0,0 +1,48 @@
1
+ // This file is auto-generated, don't edit it
2
+ import * as $dara from '@darabonba/typescript';
3
+
4
+
5
+ export class GetImageCacheRequest extends $dara.Model {
6
+ /**
7
+ * @remarks
8
+ * The product entry region, which is determined by the selected region endpoint.
9
+ *
10
+ * This parameter is required.
11
+ *
12
+ * @example
13
+ * cn-hangzhou
14
+ */
15
+ regionId?: string;
16
+ /**
17
+ * @remarks
18
+ * The current routed workspace. The server verifies the account, region, and resource ownership. This parameter cannot be omitted or used to access other workspaces.
19
+ *
20
+ * This parameter is required.
21
+ *
22
+ * @example
23
+ * ws-example
24
+ */
25
+ workspaceId?: string;
26
+ static names(): { [key: string]: string } {
27
+ return {
28
+ regionId: 'regionId',
29
+ workspaceId: 'workspaceId',
30
+ };
31
+ }
32
+
33
+ static types(): { [key: string]: any } {
34
+ return {
35
+ regionId: 'string',
36
+ workspaceId: 'string',
37
+ };
38
+ }
39
+
40
+ validate() {
41
+ super.validate();
42
+ }
43
+
44
+ constructor(map?: { [key: string]: any }) {
45
+ super(map);
46
+ }
47
+ }
48
+
@@ -0,0 +1,40 @@
1
+ // This file is auto-generated, don't edit it
2
+ import * as $dara from '@darabonba/typescript';
3
+ import { GetImageCacheResponseBody } from "./GetImageCacheResponseBody";
4
+
5
+
6
+ export class GetImageCacheResponse extends $dara.Model {
7
+ headers?: { [key: string]: string };
8
+ statusCode?: number;
9
+ body?: GetImageCacheResponseBody;
10
+ static names(): { [key: string]: string } {
11
+ return {
12
+ headers: 'headers',
13
+ statusCode: 'statusCode',
14
+ body: 'body',
15
+ };
16
+ }
17
+
18
+ static types(): { [key: string]: any } {
19
+ return {
20
+ headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
21
+ statusCode: 'number',
22
+ body: GetImageCacheResponseBody,
23
+ };
24
+ }
25
+
26
+ validate() {
27
+ if(this.headers) {
28
+ $dara.Model.validateMap(this.headers);
29
+ }
30
+ if(this.body && typeof (this.body as any).validate === 'function') {
31
+ (this.body as any).validate();
32
+ }
33
+ super.validate();
34
+ }
35
+
36
+ constructor(map?: { [key: string]: any }) {
37
+ super(map);
38
+ }
39
+ }
40
+