@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
@@ -10,7 +10,7 @@ export declare class CreateCustomAgentResponseBodyDataAgenticFsMounts extends $d
10
10
  mountPath?: string;
11
11
  /**
12
12
  * @remarks
13
- * The relative directory within the mounted access point.
13
+ * The relative directory within the mounted AccessPoint.
14
14
  *
15
15
  * @example
16
16
  * workspace/data
@@ -18,7 +18,9 @@ export declare class CreateCustomAgentResponseBodyDataAgenticFsMounts extends $d
18
18
  path?: string;
19
19
  /**
20
20
  * @remarks
21
- * Specifies whether the mount is read-only.
21
+ * Specifies whether the mount is read-only. Valid values:
22
+ * - true: The mount is read-only.
23
+ * - false: The mount is readable and writable.
22
24
  *
23
25
  * @example
24
26
  * false
@@ -26,7 +28,7 @@ export declare class CreateCustomAgentResponseBodyDataAgenticFsMounts extends $d
26
28
  readOnly?: boolean;
27
29
  /**
28
30
  * @remarks
29
- * The domain name of the AgenticFS access point used for the mount.
31
+ * The domain name of the AgenticFS AccessPoint used for the mount.
30
32
  *
31
33
  * @example
32
34
  * ap-0123456789abcdef0.0123456789-vlm36.cn-hangzhou.nas.aliyuncs.com
@@ -136,7 +138,7 @@ export declare class CreateCustomAgentResponseBodyDataArtifactContainer extends
136
138
  tag?: string;
137
139
  /**
138
140
  * @remarks
139
- * The image source type. A value of acr indicates Alibaba Cloud Container Registry.
141
+ * The source type of the image. A value of acr indicates Alibaba Cloud Container Registry (ACR).
140
142
  *
141
143
  * This parameter is required.
142
144
  *
@@ -168,7 +170,7 @@ export declare class CreateCustomAgentResponseBodyDataArtifact extends $dara.Mod
168
170
  container?: CreateCustomAgentResponseBodyDataArtifactContainer;
169
171
  /**
170
172
  * @remarks
171
- * The TCP port listened on by the agent service.
173
+ * The TCP port that the agent service listens on.
172
174
  *
173
175
  * This parameter is required.
174
176
  *
@@ -255,7 +257,7 @@ export declare class CreateCustomAgentResponseBodyDataHealthCheck extends $dara.
255
257
  intervalSeconds?: number;
256
258
  /**
257
259
  * @remarks
258
- * The health check path.
260
+ * The HTTP health check path.
259
261
  *
260
262
  * @example
261
263
  * /healthz
@@ -296,18 +298,64 @@ export declare class CreateCustomAgentResponseBodyDataHealthCheck extends $dara.
296
298
  [key: string]: any;
297
299
  });
298
300
  }
301
+ export declare class CreateCustomAgentResponseBodyDataImageCachePreparation extends $dara.Model {
302
+ /**
303
+ * @remarks
304
+ * The value is the same as imageCacheId in the same response and belongs to the current workspace.
305
+ *
306
+ * This parameter is required.
307
+ *
308
+ * @example
309
+ * img-example
310
+ */
311
+ imageId?: string;
312
+ /**
313
+ * @remarks
314
+ * The acceptance snapshot of the current request, which can be PENDING, READY, or FAILED. This does not represent the real-time status. You can query the real-time status later by calling GetImageCache.
315
+ *
316
+ * This parameter is required.
317
+ *
318
+ * @example
319
+ * PENDING
320
+ */
321
+ statusAtAcceptance?: string;
322
+ /**
323
+ * @remarks
324
+ * The value is fixed as ACCEPTED, indicating that the logical association and preparation intent are confirmed.
325
+ *
326
+ * This parameter is required.
327
+ *
328
+ * @example
329
+ * ACCEPTED
330
+ */
331
+ submissionStatus?: string;
332
+ static names(): {
333
+ [key: string]: string;
334
+ };
335
+ static types(): {
336
+ [key: string]: any;
337
+ };
338
+ validate(): void;
339
+ constructor(map?: {
340
+ [key: string]: any;
341
+ });
342
+ }
299
343
  export declare class CreateCustomAgentResponseBodyDataLatestExecutionError extends $dara.Model {
300
344
  /**
301
345
  * @remarks
302
346
  * The reason code for the waiting or execution failure of the latest configuration. This code is used to determine the subsequent handling method.
303
347
  *
348
+ * This parameter is required.
349
+ *
304
350
  * @example
305
351
  * AgentExecutionFailed
306
352
  */
307
353
  code?: string;
308
354
  /**
309
355
  * @remarks
310
- * The description of the reason why the latest configuration is waiting or failed to execute. Refer to the code and retryable fields to determine what to do next.
356
+ * 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.
357
+ *
358
+ * This parameter is required.
311
359
  *
312
360
  * @example
313
361
  * Agent execution failed. Check the configuration and resubmit
@@ -315,7 +363,9 @@ export declare class CreateCustomAgentResponseBodyDataLatestExecutionError exten
315
363
  message?: string;
316
364
  /**
317
365
  * @remarks
318
- * 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.
366
+ * 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 the request.
367
+ *
368
+ * This parameter is required.
319
369
  */
320
370
  retryable?: boolean;
321
371
  static names(): {
@@ -332,7 +382,7 @@ export declare class CreateCustomAgentResponseBodyDataLatestExecutionError exten
332
382
  export declare class CreateCustomAgentResponseBodyDataLoggingSls extends $dara.Model {
333
383
  /**
334
384
  * @remarks
335
- * The name of the Simple Log Service Logstore that receives the agent logs.
385
+ * The name of the Simple Log Service Logstore that receives agent logs.
336
386
  *
337
387
  * @example
338
388
  * agent-runtime
@@ -340,7 +390,7 @@ export declare class CreateCustomAgentResponseBodyDataLoggingSls extends $dara.M
340
390
  logstore?: string;
341
391
  /**
342
392
  * @remarks
343
- * The name of the Simple Log Service project that receives the agent logs.
393
+ * The name of the Simple Log Service project that receives agent logs.
344
394
  *
345
395
  * @example
346
396
  * my-agent-logs
@@ -411,12 +461,12 @@ export declare class CreateCustomAgentResponseBodyDataNetworkAccessVpc extends $
411
461
  export declare class CreateCustomAgentResponseBodyDataNetwork extends $dara.Model {
412
462
  /**
413
463
  * @remarks
414
- * 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.
464
+ * The Internet access configuration of the agent. If this parameter is not configured, Internet access is allowed on the agent side but is still restricted by the workspace.
415
465
  */
416
466
  accessInternet?: CreateCustomAgentResponseBodyDataNetworkAccessInternet;
417
467
  /**
418
468
  * @remarks
419
- * 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.
469
+ * The user VPC access configuration of the agent. If this parameter is not configured, user VPC access is allowed on the agent side but is still restricted by the workspace.
420
470
  */
421
471
  accessVpc?: CreateCustomAgentResponseBodyDataNetworkAccessVpc;
422
472
  static names(): {
@@ -430,6 +480,23 @@ export declare class CreateCustomAgentResponseBodyDataNetwork extends $dara.Mode
430
480
  [key: string]: any;
431
481
  });
432
482
  }
483
+ export declare class CreateCustomAgentResponseBodyDataObservability extends $dara.Model {
484
+ /**
485
+ * @remarks
486
+ * Default value: true. If set to false, the platform Python probe is not loaded at runtime, and you must collect observability data yourself.
487
+ */
488
+ enabled?: boolean;
489
+ static names(): {
490
+ [key: string]: string;
491
+ };
492
+ static types(): {
493
+ [key: string]: any;
494
+ };
495
+ validate(): void;
496
+ constructor(map?: {
497
+ [key: string]: any;
498
+ });
499
+ }
433
500
  export declare class CreateCustomAgentResponseBodyDataOssMounts extends $dara.Model {
434
501
  /**
435
502
  * @remarks
@@ -441,7 +508,7 @@ export declare class CreateCustomAgentResponseBodyDataOssMounts extends $dara.Mo
441
508
  bucketName?: string;
442
509
  /**
443
510
  * @remarks
444
- * The OSS mount directory in the container, located under /mnt/oss/.
511
+ * The OSS mount directory in the container, which is located under /mnt/oss/.
445
512
  *
446
513
  * @example
447
514
  * /mnt/oss/train
@@ -457,7 +524,9 @@ export declare class CreateCustomAgentResponseBodyDataOssMounts extends $dara.Mo
457
524
  path?: string;
458
525
  /**
459
526
  * @remarks
460
- * Specifies whether the mount is read-only.
527
+ * Specifies whether the mount is read-only. Valid values:
528
+ * - true: The mount is read-only.
529
+ * - false: The mount is readable and writable.
461
530
  */
462
531
  readOnly?: boolean;
463
532
  static names(): {
@@ -474,7 +543,7 @@ export declare class CreateCustomAgentResponseBodyDataOssMounts extends $dara.Mo
474
543
  export declare class CreateCustomAgentResponseBodyDataProtocolPaths extends $dara.Model {
475
544
  /**
476
545
  * @remarks
477
- * The usage description of the current API path.
546
+ * The purpose description of the current API path.
478
547
  *
479
548
  * @example
480
549
  * AG-UI conversation API
@@ -482,7 +551,7 @@ export declare class CreateCustomAgentResponseBodyDataProtocolPaths extends $dar
482
551
  description?: string;
483
552
  /**
484
553
  * @remarks
485
- * The API path that corresponds to the current protocol.
554
+ * The API path corresponding to the current protocol.
486
555
  *
487
556
  * This parameter is required.
488
557
  *
@@ -504,7 +573,7 @@ export declare class CreateCustomAgentResponseBodyDataProtocolPaths extends $dar
504
573
  export declare class CreateCustomAgentResponseBodyDataProtocol extends $dara.Model {
505
574
  /**
506
575
  * @remarks
507
- * The request header configuration for the current protocol. The key is the header name and the value is a string.
576
+ * The request header configuration for the current protocol. The key is the name and the value is a string.
508
577
  */
509
578
  headers?: {
510
579
  [key: string]: string;
@@ -560,7 +629,9 @@ export declare class CreateCustomAgentResponseBodyDataRuntimeCompute extends $da
560
629
  export declare class CreateCustomAgentResponseBodyDataRuntimeHpa extends $dara.Model {
561
630
  /**
562
631
  * @remarks
563
- * Specifies whether elastic scaling is enabled. A value of true indicates that elastic scaling is enabled, and a value of false indicates that elastic scaling is disabled.
632
+ * Specifies whether to enable elastic scaling. Valid values:
633
+ * - true: Enabled.
634
+ * - false: Disabled.
564
635
  *
565
636
  * This parameter is required.
566
637
  */
@@ -591,7 +662,7 @@ export declare class CreateCustomAgentResponseBodyDataRuntimeHpa extends $dara.M
591
662
  minSandboxCount?: number;
592
663
  /**
593
664
  * @remarks
594
- * The maximum idle time for a session, in seconds.
665
+ * The maximum idle time configured for a session, in seconds.
595
666
  *
596
667
  * @example
597
668
  * 600
@@ -611,7 +682,7 @@ export declare class CreateCustomAgentResponseBodyDataRuntimeHpa extends $dara.M
611
682
  export declare class CreateCustomAgentResponseBodyDataRuntimeSessionPolicy extends $dara.Model {
612
683
  /**
613
684
  * @remarks
614
- * The name of the HTTP request header used by the session policy. This parameter applies to ISOLATED_HEADER_FIELD.
685
+ * The name of the HTTP request header used by the session policy. This parameter is applicable to ISOLATED_HEADER_FIELD.
615
686
  *
616
687
  * @example
617
688
  * X-Session-Id
@@ -619,7 +690,10 @@ export declare class CreateCustomAgentResponseBodyDataRuntimeSessionPolicy exten
619
690
  headerName?: string;
620
691
  /**
621
692
  * @remarks
622
- * The type of the session policy. Valid values: AFFINITY (session affinity), ISOLATED_HEADER_FIELD (associates sessions by using the request header specified by headerName), and ISOLATED_COOKIE (not recommended). The compatible value DISABLED in requests is returned as AFFINITY.
693
+ * The type of the session policy. Valid values:
694
+ * - AFFINITY: Session affinity.
695
+ * - ISOLATED_HEADER_FIELD: Uses the request header specified by headerName to associate sessions.
696
+ * ISOLATED_COOKIE is not recommended. The compatible value DISABLED in a request is returned as AFFINITY.
623
697
  *
624
698
  * This parameter is required.
625
699
  *
@@ -648,12 +722,12 @@ export declare class CreateCustomAgentResponseBodyDataRuntime extends $dara.Mode
648
722
  compute?: CreateCustomAgentResponseBodyDataRuntimeCompute;
649
723
  /**
650
724
  * @remarks
651
- * The elastic policy configuration for the agent.
725
+ * The elastic policy configuration of the agent.
652
726
  */
653
727
  hpa?: CreateCustomAgentResponseBodyDataRuntimeHpa;
654
728
  /**
655
729
  * @remarks
656
- * The session policy configuration for the agent.
730
+ * The session policy configuration of the agent.
657
731
  *
658
732
  * This parameter is required.
659
733
  */
@@ -672,7 +746,9 @@ export declare class CreateCustomAgentResponseBodyDataRuntime extends $dara.Mode
672
746
  export declare class CreateCustomAgentResponseBodyData extends $dara.Model {
673
747
  /**
674
748
  * @remarks
675
- * The unique identifier of the custom agent. You can obtain this ID from the response of the CreateCustomAgent or ListCustomAgents operation.
749
+ * The unique identifier of the custom agent. You can obtain this ID from the response of CreateCustomAgent or ListCustomAgents.
750
+ *
751
+ * This parameter is required.
676
752
  *
677
753
  * @example
678
754
  * agent-550e8400e29b41d4a716446655440000
@@ -685,7 +761,7 @@ export declare class CreateCustomAgentResponseBodyData extends $dara.Model {
685
761
  agenticFsMounts?: CreateCustomAgentResponseBodyDataAgenticFsMounts[];
686
762
  /**
687
763
  * @remarks
688
- * 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.
764
+ * 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.
689
765
  */
690
766
  artifact?: CreateCustomAgentResponseBodyDataArtifact;
691
767
  /**
@@ -706,7 +782,7 @@ export declare class CreateCustomAgentResponseBodyData extends $dara.Model {
706
782
  createdAt?: string;
707
783
  /**
708
784
  * @remarks
709
- * The deployment method of the agent. Custom agents are deployed and managed by the platform, and the value is MANAGED.
785
+ * The deployment method of the agent. Custom agents are deployed and managed by the platform. The value is MANAGED.
710
786
  *
711
787
  * @example
712
788
  * MANAGED
@@ -714,12 +790,25 @@ export declare class CreateCustomAgentResponseBodyData extends $dara.Model {
714
790
  deployType?: string;
715
791
  /**
716
792
  * @remarks
717
- * The description of the agent.
793
+ * The description of the agent\\"s purpose.
718
794
  *
719
795
  * @example
720
- * Custom agent that provides conversation services
796
+ * Custom agent that provides conversational services
721
797
  */
722
798
  description?: string;
799
+ /**
800
+ * @remarks
801
+ * 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 cache instances.
802
+ *
803
+ * This parameter is required.
804
+ *
805
+ * @example
806
+ * 1
807
+ *
808
+ * **if can be null:**
809
+ * true
810
+ */
811
+ effectiveSpecVersion?: number;
723
812
  /**
724
813
  * @remarks
725
814
  * The environment variable configuration for the agent process.
@@ -730,6 +819,24 @@ export declare class CreateCustomAgentResponseBodyData extends $dara.Model {
730
819
  * The HTTP health check configuration of the agent. This field is empty if no health check is configured.
731
820
  */
732
821
  healthCheck?: CreateCustomAgentResponseBodyDataHealthCheck;
822
+ /**
823
+ * @remarks
824
+ * 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 the feature is disabled is independently protected by the backend and is not backfilled as the current configuration association.
825
+ *
826
+ * This parameter is required.
827
+ *
828
+ * @example
829
+ * img-example
830
+ *
831
+ * **if can be null:**
832
+ * true
833
+ */
834
+ imageCacheId?: string;
835
+ /**
836
+ * @remarks
837
+ * This field is always returned when caching is enabled in the final configuration for creation or update, 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.
838
+ */
839
+ imageCachePreparation?: CreateCustomAgentResponseBodyDataImageCachePreparation;
733
840
  /**
734
841
  * @remarks
735
842
  * 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.
@@ -737,7 +844,9 @@ export declare class CreateCustomAgentResponseBodyData extends $dara.Model {
737
844
  latestExecutionError?: CreateCustomAgentResponseBodyDataLatestExecutionError;
738
845
  /**
739
846
  * @remarks
740
- * 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.
847
+ * 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.
848
+ *
849
+ * This parameter is required.
741
850
  *
742
851
  * @example
743
852
  * 1
@@ -745,16 +854,19 @@ export declare class CreateCustomAgentResponseBodyData extends $dara.Model {
745
854
  latestSpecVersion?: number;
746
855
  /**
747
856
  * @remarks
748
- * The execution status corresponding to the latestSpecVersion. Valid values:
749
- * - pending: Waiting for execution.
857
+ * The execution status corresponding to latestSpecVersion. Valid values:
858
+ * - pending: Pending execution.
750
859
  * - processing: Executing.
751
860
  * - waiting_retry: Waiting for retry.
752
861
  * - succeeded: Execution succeeded.
753
862
  * - failed: Execution failed.
754
- * - superseded: Superseded by a later version.
863
+ * - superseded: Superseded by a subsequent version.
755
864
  *
756
865
  * @example
757
866
  * succeeded
867
+ *
868
+ * **if can be null:**
869
+ * true
758
870
  */
759
871
  latestVersionStatus?: string;
760
872
  /**
@@ -766,15 +878,22 @@ export declare class CreateCustomAgentResponseBodyData extends $dara.Model {
766
878
  * @remarks
767
879
  * The name of the custom agent.
768
880
  *
881
+ * This parameter is required.
882
+ *
769
883
  * @example
770
884
  * my-custom-agent
771
885
  */
772
886
  name?: string;
773
887
  /**
774
888
  * @remarks
775
- * The network access configuration of the agent. The actual access scope is also restricted by the workspace network configuration.
889
+ * The network access configuration of the agent. The actual access scope is also restricted by the network configuration of the workspace.
776
890
  */
777
891
  network?: CreateCustomAgentResponseBodyDataNetwork;
892
+ /**
893
+ * @remarks
894
+ * The high-code agent observability configuration.
895
+ */
896
+ observability?: CreateCustomAgentResponseBodyDataObservability;
778
897
  /**
779
898
  * @remarks
780
899
  * The latest submitted list of OSS directory mounts.
@@ -808,14 +927,23 @@ export declare class CreateCustomAgentResponseBodyData extends $dara.Model {
808
927
  runtime?: CreateCustomAgentResponseBodyDataRuntime;
809
928
  /**
810
929
  * @remarks
811
- * The statistics of instance counts by running 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.
930
+ * The instance counts grouped by running 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.
812
931
  */
813
932
  sandboxPhaseCounts?: {
814
933
  [key: string]: number;
815
934
  };
816
935
  /**
817
936
  * @remarks
818
- * The overall status of the agent. Valid values: Creating, Running, Failed, Updating, Deleting, and Deleted. To query the execution progress of the latest configuration, check latestVersionStatus.
937
+ * The overall status of the agent. Valid values:
938
+ * - Creating: Creating.
939
+ * - Running: Running.
940
+ * - Failed: Failed.
941
+ * - Updating: Updating.
942
+ * - Deleting: Deleting.
943
+ * - Deleted: Deleted.
944
+ * To check the execution progress of the latest configuration, query latestVersionStatus.
945
+ *
946
+ * This parameter is required.
819
947
  *
820
948
  * @example
821
949
  * Running
@@ -823,16 +951,28 @@ export declare class CreateCustomAgentResponseBodyData extends $dara.Model {
823
951
  status?: string;
824
952
  /**
825
953
  * @remarks
826
- * 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.
954
+ * The time when the agent was last updated. The time follows the ISO 8601 standard and is displayed in UTC. Fractional seconds are supported.
827
955
  *
828
956
  * @example
829
957
  * 2026-10-10T06:05:00Z
830
958
  */
831
959
  updatedAt?: string;
960
+ /**
961
+ * @remarks
962
+ * The image cache switch. This field is always returned and reflects the final accepted configuration. If this field is missing in historical data, false is returned. Do not infer the status based on the cache status.
963
+ *
964
+ * This parameter is required.
965
+ *
966
+ * @example
967
+ * true
968
+ */
969
+ useImageCache?: boolean;
832
970
  /**
833
971
  * @remarks
834
972
  * The ID of the workspace to which the custom agent belongs.
835
973
  *
974
+ * This parameter is required.
975
+ *
836
976
  * @example
837
977
  * ws-a1b2c3d4e5f6
838
978
  */
@@ -851,7 +991,9 @@ export declare class CreateCustomAgentResponseBodyData extends $dara.Model {
851
991
  export declare class CreateCustomAgentResponseBody extends $dara.Model {
852
992
  /**
853
993
  * @remarks
854
- * The request result code. The value is SUCCESS when the request is successful.
994
+ * The request result code. The value is SUCCESS if the request is successful.
995
+ *
996
+ * This parameter is required.
855
997
  *
856
998
  * @example
857
999
  * SUCCESS
@@ -860,11 +1002,15 @@ export declare class CreateCustomAgentResponseBody extends $dara.Model {
860
1002
  /**
861
1003
  * @remarks
862
1004
  * 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.
1005
+ *
1006
+ * This parameter is required.
863
1007
  */
864
1008
  data?: CreateCustomAgentResponseBodyData;
865
1009
  /**
866
1010
  * @remarks
867
- * The HTTP status code of the request. A value of 200 indicates success.
1011
+ * The HTTP status code returned. A value of 200 indicates that the request was successful.
1012
+ *
1013
+ * This parameter is required.
868
1014
  *
869
1015
  * @example
870
1016
  * 200
@@ -872,7 +1018,9 @@ export declare class CreateCustomAgentResponseBody extends $dara.Model {
872
1018
  httpStatusCode?: number;
873
1019
  /**
874
1020
  * @remarks
875
- * The processing result message of the request. The value is success when the request is successful.
1021
+ * The result message of the request. A value of success indicates that the request was successful.
1022
+ *
1023
+ * This parameter is required.
876
1024
  *
877
1025
  * @example
878
1026
  * success
@@ -880,7 +1028,9 @@ export declare class CreateCustomAgentResponseBody extends $dara.Model {
880
1028
  message?: string;
881
1029
  /**
882
1030
  * @remarks
883
- * The unique identifier of the request, which is used to locate and troubleshoot issues.
1031
+ * The ID of the request. You can use this ID to locate and troubleshoot issues.
1032
+ *
1033
+ * This parameter is required.
884
1034
  *
885
1035
  * @example
886
1036
  * 550E8400-E29B-41D4-A716-446655440000
@@ -888,7 +1038,9 @@ export declare class CreateCustomAgentResponseBody extends $dara.Model {
888
1038
  requestId?: string;
889
1039
  /**
890
1040
  * @remarks
891
- * Specifies 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.
1041
+ * Indicates whether the request was successful. A value of true indicates that the request was successful. A successful creation, update, or deletion response does not mean that the backend operation is complete.
1042
+ *
1043
+ * This parameter is required.
892
1044
  */
893
1045
  success?: boolean;
894
1046
  static names(): {
@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
33
33
  };
34
34
  })();
35
35
  Object.defineProperty(exports, "__esModule", { value: true });
36
- exports.CreateCustomAgentResponseBody = exports.CreateCustomAgentResponseBodyData = exports.CreateCustomAgentResponseBodyDataRuntime = exports.CreateCustomAgentResponseBodyDataRuntimeSessionPolicy = exports.CreateCustomAgentResponseBodyDataRuntimeHpa = exports.CreateCustomAgentResponseBodyDataRuntimeCompute = exports.CreateCustomAgentResponseBodyDataProtocol = exports.CreateCustomAgentResponseBodyDataProtocolPaths = exports.CreateCustomAgentResponseBodyDataOssMounts = exports.CreateCustomAgentResponseBodyDataNetwork = exports.CreateCustomAgentResponseBodyDataNetworkAccessVpc = exports.CreateCustomAgentResponseBodyDataNetworkAccessInternet = exports.CreateCustomAgentResponseBodyDataLogging = exports.CreateCustomAgentResponseBodyDataLoggingSls = exports.CreateCustomAgentResponseBodyDataLatestExecutionError = exports.CreateCustomAgentResponseBodyDataHealthCheck = exports.CreateCustomAgentResponseBodyDataEnvironment = exports.CreateCustomAgentResponseBodyDataEnvironmentVariables = exports.CreateCustomAgentResponseBodyDataArtifact = exports.CreateCustomAgentResponseBodyDataArtifactContainer = exports.CreateCustomAgentResponseBodyDataArtifactCode = exports.CreateCustomAgentResponseBodyDataAgenticFsMounts = void 0;
36
+ exports.CreateCustomAgentResponseBody = exports.CreateCustomAgentResponseBodyData = exports.CreateCustomAgentResponseBodyDataRuntime = exports.CreateCustomAgentResponseBodyDataRuntimeSessionPolicy = exports.CreateCustomAgentResponseBodyDataRuntimeHpa = exports.CreateCustomAgentResponseBodyDataRuntimeCompute = exports.CreateCustomAgentResponseBodyDataProtocol = exports.CreateCustomAgentResponseBodyDataProtocolPaths = exports.CreateCustomAgentResponseBodyDataOssMounts = exports.CreateCustomAgentResponseBodyDataObservability = exports.CreateCustomAgentResponseBodyDataNetwork = exports.CreateCustomAgentResponseBodyDataNetworkAccessVpc = exports.CreateCustomAgentResponseBodyDataNetworkAccessInternet = exports.CreateCustomAgentResponseBodyDataLogging = exports.CreateCustomAgentResponseBodyDataLoggingSls = exports.CreateCustomAgentResponseBodyDataLatestExecutionError = exports.CreateCustomAgentResponseBodyDataImageCachePreparation = exports.CreateCustomAgentResponseBodyDataHealthCheck = exports.CreateCustomAgentResponseBodyDataEnvironment = exports.CreateCustomAgentResponseBodyDataEnvironmentVariables = exports.CreateCustomAgentResponseBodyDataArtifact = exports.CreateCustomAgentResponseBodyDataArtifactContainer = exports.CreateCustomAgentResponseBodyDataArtifactCode = exports.CreateCustomAgentResponseBodyDataAgenticFsMounts = void 0;
37
37
  // This file is auto-generated, don't edit it
38
38
  const $dara = __importStar(require("@darabonba/typescript"));
39
39
  class CreateCustomAgentResponseBodyDataAgenticFsMounts extends $dara.Model {
@@ -214,6 +214,29 @@ class CreateCustomAgentResponseBodyDataHealthCheck extends $dara.Model {
214
214
  }
215
215
  }
216
216
  exports.CreateCustomAgentResponseBodyDataHealthCheck = CreateCustomAgentResponseBodyDataHealthCheck;
217
+ class CreateCustomAgentResponseBodyDataImageCachePreparation extends $dara.Model {
218
+ static names() {
219
+ return {
220
+ imageId: 'imageId',
221
+ statusAtAcceptance: 'statusAtAcceptance',
222
+ submissionStatus: 'submissionStatus',
223
+ };
224
+ }
225
+ static types() {
226
+ return {
227
+ imageId: 'string',
228
+ statusAtAcceptance: 'string',
229
+ submissionStatus: 'string',
230
+ };
231
+ }
232
+ validate() {
233
+ super.validate();
234
+ }
235
+ constructor(map) {
236
+ super(map);
237
+ }
238
+ }
239
+ exports.CreateCustomAgentResponseBodyDataImageCachePreparation = CreateCustomAgentResponseBodyDataImageCachePreparation;
217
240
  class CreateCustomAgentResponseBodyDataLatestExecutionError extends $dara.Model {
218
241
  static names() {
219
242
  return {
@@ -345,6 +368,25 @@ class CreateCustomAgentResponseBodyDataNetwork extends $dara.Model {
345
368
  }
346
369
  }
347
370
  exports.CreateCustomAgentResponseBodyDataNetwork = CreateCustomAgentResponseBodyDataNetwork;
371
+ class CreateCustomAgentResponseBodyDataObservability extends $dara.Model {
372
+ static names() {
373
+ return {
374
+ enabled: 'enabled',
375
+ };
376
+ }
377
+ static types() {
378
+ return {
379
+ enabled: 'boolean',
380
+ };
381
+ }
382
+ validate() {
383
+ super.validate();
384
+ }
385
+ constructor(map) {
386
+ super(map);
387
+ }
388
+ }
389
+ exports.CreateCustomAgentResponseBodyDataObservability = CreateCustomAgentResponseBodyDataObservability;
348
390
  class CreateCustomAgentResponseBodyDataOssMounts extends $dara.Model {
349
391
  static names() {
350
392
  return {
@@ -529,14 +571,18 @@ class CreateCustomAgentResponseBodyData extends $dara.Model {
529
571
  createdAt: 'createdAt',
530
572
  deployType: 'deployType',
531
573
  description: 'description',
574
+ effectiveSpecVersion: 'effectiveSpecVersion',
532
575
  environment: 'environment',
533
576
  healthCheck: 'healthCheck',
577
+ imageCacheId: 'imageCacheId',
578
+ imageCachePreparation: 'imageCachePreparation',
534
579
  latestExecutionError: 'latestExecutionError',
535
580
  latestSpecVersion: 'latestSpecVersion',
536
581
  latestVersionStatus: 'latestVersionStatus',
537
582
  logging: 'logging',
538
583
  name: 'name',
539
584
  network: 'network',
585
+ observability: 'observability',
540
586
  ossMounts: 'ossMounts',
541
587
  protocol: 'protocol',
542
588
  regionId: 'regionId',
@@ -545,6 +591,7 @@ class CreateCustomAgentResponseBodyData extends $dara.Model {
545
591
  sandboxPhaseCounts: 'sandboxPhaseCounts',
546
592
  status: 'status',
547
593
  updatedAt: 'updatedAt',
594
+ useImageCache: 'useImageCache',
548
595
  workspaceId: 'workspaceId',
549
596
  };
550
597
  }
@@ -557,14 +604,18 @@ class CreateCustomAgentResponseBodyData extends $dara.Model {
557
604
  createdAt: 'string',
558
605
  deployType: 'string',
559
606
  description: 'string',
607
+ effectiveSpecVersion: 'number',
560
608
  environment: CreateCustomAgentResponseBodyDataEnvironment,
561
609
  healthCheck: CreateCustomAgentResponseBodyDataHealthCheck,
610
+ imageCacheId: 'string',
611
+ imageCachePreparation: CreateCustomAgentResponseBodyDataImageCachePreparation,
562
612
  latestExecutionError: CreateCustomAgentResponseBodyDataLatestExecutionError,
563
613
  latestSpecVersion: 'number',
564
614
  latestVersionStatus: 'string',
565
615
  logging: CreateCustomAgentResponseBodyDataLogging,
566
616
  name: 'string',
567
617
  network: CreateCustomAgentResponseBodyDataNetwork,
618
+ observability: CreateCustomAgentResponseBodyDataObservability,
568
619
  ossMounts: { 'type': 'array', 'itemType': CreateCustomAgentResponseBodyDataOssMounts },
569
620
  protocol: { 'type': 'array', 'itemType': CreateCustomAgentResponseBodyDataProtocol },
570
621
  regionId: 'string',
@@ -573,6 +624,7 @@ class CreateCustomAgentResponseBodyData extends $dara.Model {
573
624
  sandboxPhaseCounts: { 'type': 'map', 'keyType': 'string', 'valueType': 'number' },
574
625
  status: 'string',
575
626
  updatedAt: 'string',
627
+ useImageCache: 'boolean',
576
628
  workspaceId: 'string',
577
629
  };
578
630
  }
@@ -589,6 +641,9 @@ class CreateCustomAgentResponseBodyData extends $dara.Model {
589
641
  if (this.healthCheck && typeof this.healthCheck.validate === 'function') {
590
642
  this.healthCheck.validate();
591
643
  }
644
+ if (this.imageCachePreparation && typeof this.imageCachePreparation.validate === 'function') {
645
+ this.imageCachePreparation.validate();
646
+ }
592
647
  if (this.latestExecutionError && typeof this.latestExecutionError.validate === 'function') {
593
648
  this.latestExecutionError.validate();
594
649
  }
@@ -598,6 +653,9 @@ class CreateCustomAgentResponseBodyData extends $dara.Model {
598
653
  if (this.network && typeof this.network.validate === 'function') {
599
654
  this.network.validate();
600
655
  }
656
+ if (this.observability && typeof this.observability.validate === 'function') {
657
+ this.observability.validate();
658
+ }
601
659
  if (Array.isArray(this.ossMounts)) {
602
660
  $dara.Model.validateArray(this.ossMounts);
603
661
  }