@alicloud/agentcore20260804 2.1.1 → 2.2.1

package/src/models/UpdateManagedAgentRequest.ts

@@ -2,6 +2,66 @@
 import * as $dara from '@darabonba/typescript';
 
 
+export class UpdateManagedAgentRequestBodyAgenticFsMounts extends $dara.Model {
+  /**
+   * @remarks
+   * The subdirectory under /mnt/agenticfs/ in the container. Required for each mount item as validated by the backend. Mount targets must not be duplicated or have parent-child overlaps.
+   * 
+   * @example
+   * /mnt/agenticfs/data
+   */
+  mountPath?: string;
+  /**
+   * @remarks
+   * A non-empty relative directory that exists under the AccessPoint. Required for each mount item as validated by the backend. Root directories, absolute paths, and parent directory segments are not allowed.
+   * 
+   * @example
+   * workspace/data
+   */
+  path?: string;
+  /**
+   * @remarks
+   * Specifies whether to mount in read-only mode. Default value: false. This is not a RAM role read-only policy.
+   * 
+   * @example
+   * false
+   */
+  readOnly?: boolean;
+  /**
+   * @remarks
+   * The AccessPoint domain name. Required for each mount item as validated by the backend. Do not include the protocol, port, or path. Use the DomainName value from the NAS ListAccessPoints response.
+   * 
+   * @example
+   * ap-0123456789abcdef0.0123456789-vlm36.cn-hangzhou.nas.aliyuncs.com
+   */
+  server?: string;
+  static names(): { [key: string]: string } {
+    return {
+      mountPath: 'mountPath',
+      path: 'path',
+      readOnly: 'readOnly',
+      server: 'server',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      mountPath: 'string',
+      path: 'string',
+      readOnly: 'boolean',
+      server: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class UpdateManagedAgentRequestBodyEnvironmentCredentialReferences extends $dara.Model {
   /**
    * @remarks
@@ -121,7 +181,7 @@ export class UpdateManagedAgentRequestBodyEnvironment extends $dara.Model {
 export class UpdateManagedAgentRequestBodyHarnessConfiguration extends $dara.Model {
   /**
    * @remarks
-   * The connector service account key.
+   * The Connector Service Account Key.
    * 
    * @example
    * key-xxxx
@@ -129,7 +189,7 @@ export class UpdateManagedAgentRequestBodyHarnessConfiguration extends $dara.Mod
   connectorServiceAccountKey?: string;
   /**
    * @remarks
-   * The connector service account name.
+   * The Connector Service Account Name.
    * 
    * @example
    * my-connector-key
@@ -161,12 +221,12 @@ export class UpdateManagedAgentRequestBodyHarnessConfiguration extends $dara.Mod
 export class UpdateManagedAgentRequestBodyHarness extends $dara.Model {
   /**
    * @remarks
-   * The harness configuration.
+   * The runtime harness configuration.
    */
   configuration?: UpdateManagedAgentRequestBodyHarnessConfiguration;
   /**
    * @remarks
-   * The harness type.
+   * The runtime harness type.
    * 
    * @example
    * qodercli
@@ -201,7 +261,7 @@ export class UpdateManagedAgentRequestBodyHarness extends $dara.Model {
 export class UpdateManagedAgentRequestBodyModelQuota extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to enable the token quota. Default value: true. If you set this parameter to false, the token quota is disabled and existing quota rules are deleted.
+   * Specifies whether to enable the token quota. Default value: true. Set to false to disable and delete existing quota rules.
    * 
    * @example
    * true
@@ -209,7 +269,7 @@ export class UpdateManagedAgentRequestBodyModelQuota extends $dara.Model {
   enabled?: boolean;
   /**
    * @remarks
-   * The quota limit type. This parameter is required by backend validation when the quota is enabled. Fixed value: token.
+   * The quota limit type. Required when the quota is enabled, as validated by the backend. Fixed value: token.
    * 
    * @example
    * token
@@ -217,9 +277,7 @@ export class UpdateManagedAgentRequestBodyModelQuota extends $dara.Model {
   limitType?: string;
   /**
    * @remarks
-   * The quota statistical period. This parameter is required by backend validation when the quota is enabled. Valid values:
-   * - day: daily.
-   * - month: monthly.
+   * The statistical period for the quota. Required when the quota is enabled, as validated by the backend. Valid values: day (daily) and month (monthly).
    * 
    * @example
    * day
@@ -227,7 +285,7 @@ export class UpdateManagedAgentRequestBodyModelQuota extends $dara.Model {
   periodType?: string;
   /**
    * @remarks
-   * The maximum number of tokens that can be consumed within a single period. This parameter is required by backend validation when the quota is enabled. The value must be greater than 0.
+   * The maximum number of tokens that can be consumed within a single period. Required when the quota is enabled, as validated by the backend. The value must be greater than 0.
    * 
    * @example
    * 1000000
@@ -281,7 +339,7 @@ export class UpdateManagedAgentRequestBodyModel extends $dara.Model {
   modelName?: string;
   /**
    * @remarks
-   * The model token quota configuration. If this parameter is not specified, no quota is configured.
+   * The model token quota configuration. If not specified, no quota is configured.
    */
   quota?: UpdateManagedAgentRequestBodyModelQuota;
   static names(): { [key: string]: string } {
@@ -415,7 +473,7 @@ export class UpdateManagedAgentRequestBodyNetwork extends $dara.Model {
 export class UpdateManagedAgentRequestBodyOssMounts extends $dara.Model {
   /**
    * @remarks
-   * The OSS bucket name. This parameter is required by backend validation for each mount entry.
+   * The OSS bucket name. Required for each mount item as validated by the backend.
    * 
    * @example
    * bucket-001
@@ -423,7 +481,7 @@ export class UpdateManagedAgentRequestBodyOssMounts extends $dara.Model {
   bucketName?: string;
   /**
    * @remarks
-   * The absolute mount path in the container. This parameter is required by backend validation for each mount entry.
+   * The absolute mount path in the container. Required for each mount item as validated by the backend.
    * 
    * @example
    * /mnt/oss/datasets
@@ -431,7 +489,7 @@ export class UpdateManagedAgentRequestBodyOssMounts extends $dara.Model {
   mountPath?: string;
   /**
    * @remarks
-   * The relative object prefix within the bucket. If this parameter is not specified, the entire bucket is mounted.
+   * The relative object prefix within the bucket. If not specified, the entire bucket is mounted.
    * 
    * @example
    * datasets
@@ -472,7 +530,7 @@ export class UpdateManagedAgentRequestBodyOssMounts extends $dara.Model {
 export class UpdateManagedAgentRequestBodyRuntimeCompute extends $dara.Model {
   /**
    * @remarks
-   * The compute specification.
+   * The compute class.
    * 
    * This parameter is required.
    * 
@@ -504,12 +562,12 @@ export class UpdateManagedAgentRequestBodyRuntimeCompute extends $dara.Model {
 export class UpdateManagedAgentRequestBodyRuntimeHpa extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to enable auto scaling. This parameter is required by backend validation when hpa is specified.
+   * Specifies whether to enable auto scaling. Required when hpa is present, as validated by the backend.
    */
   enabled?: boolean;
   /**
    * @remarks
-   * The maximum number of active sessions per sandbox. This parameter is required by backend validation when hpa is specified.
+   * The maximum number of active sessions per Sandbox. Required when hpa is present, as validated by the backend.
    * 
    * @example
    * 5
@@ -517,7 +575,7 @@ export class UpdateManagedAgentRequestBodyRuntimeHpa extends $dara.Model {
   maxConcurrentSessionsPerSandbox?: number;
   /**
    * @remarks
-   * The maximum number of sandboxes. This parameter is required when HPA is enabled and the value must be no less than the minimum value.
+   * The maximum number of Sandboxes. Required when HPA is enabled and must be greater than or equal to the minimum value.
    * 
    * @example
    * 3
@@ -525,7 +583,7 @@ export class UpdateManagedAgentRequestBodyRuntimeHpa extends $dara.Model {
   maxSandboxCount?: number;
   /**
    * @remarks
-   * The minimum number of sandboxes. This parameter is required when HPA is enabled.
+   * The minimum number of Sandboxes. Required when HPA is enabled.
    * 
    * @example
    * 1
@@ -533,7 +591,7 @@ export class UpdateManagedAgentRequestBodyRuntimeHpa extends $dara.Model {
   minSandboxCount?: number;
   /**
    * @remarks
-   * The session reclamation time after inactivity, in seconds. This parameter is required by backend validation when hpa is specified.
+   * The time-to-live (TTL) for a session after inactivity, in seconds. Required when hpa is present, as validated by the backend.
    * 
    * @example
    * 3600
@@ -571,7 +629,7 @@ export class UpdateManagedAgentRequestBodyRuntimeHpa extends $dara.Model {
 export class UpdateManagedAgentRequestBodyRuntimeSessionPolicy extends $dara.Model {
   /**
    * @remarks
-   * The name of the HTTP header used for session affinity. This parameter takes effect when sessionPolicy.type is set to ISOLATED_HEADER_FIELD.
+   * The name of the HTTP header used for session affinity. This parameter takes effect only when sessionPolicy.type is set to ISOLATED_HEADER_FIELD.
    * 
    * @example
    * X-Session-Id
@@ -620,7 +678,7 @@ export class UpdateManagedAgentRequestBodyRuntime extends $dara.Model {
   compute?: UpdateManagedAgentRequestBodyRuntimeCompute;
   /**
    * @remarks
-   * The sandbox auto scaling and session configuration.
+   * The Sandbox auto scaling and session configuration.
    */
   hpa?: UpdateManagedAgentRequestBodyRuntimeHpa;
   /**
@@ -664,6 +722,48 @@ export class UpdateManagedAgentRequestBodyRuntime extends $dara.Model {
   }
 }
 
+export class UpdateManagedAgentRequestBodySkillsVersionSelector extends $dara.Model {
+  /**
+   * @remarks
+   * The version selector type. Valid values:
+   * - LABEL: select by label.
+   * - VERSION: select by specific version.
+   * 
+   * @example
+   * LABEL
+   */
+  type?: string;
+  /**
+   * @remarks
+   * The selector value. If the type is LABEL, specify a label name such as latest. If the type is VERSION, specify a specific version number.
+   * 
+   * @example
+   * latest
+   */
+  value?: string;
+  static names(): { [key: string]: string } {
+    return {
+      type: 'type',
+      value: 'value',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      type: 'string',
+      value: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class UpdateManagedAgentRequestBodySkills extends $dara.Model {
   /**
    * @remarks
@@ -675,6 +775,16 @@ export class UpdateManagedAgentRequestBodySkills extends $dara.Model {
    * code-analysis
    */
   name?: string;
+  /**
+   * @remarks
+   * The skill source type. Valid values:
+   * - REFERENCE: referenced from AI Registry.
+   * - STATIC: statically bundled with the package.
+   * 
+   * @example
+   * REFERENCE
+   */
+  sourceType?: string;
   /**
    * @remarks
    * The skill version.
@@ -683,6 +793,58 @@ export class UpdateManagedAgentRequestBodySkills extends $dara.Model {
    * 1.0.0
    */
   version?: string;
+  /**
+   * @remarks
+   * The version selector for the reference. Defaults to LABEL/latest if omitted. Currently supports LABEL/latest.
+   */
+  versionSelector?: UpdateManagedAgentRequestBodySkillsVersionSelector;
+  static names(): { [key: string]: string } {
+    return {
+      name: 'name',
+      sourceType: 'sourceType',
+      version: 'version',
+      versionSelector: 'versionSelector',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      name: 'string',
+      sourceType: 'string',
+      version: 'string',
+      versionSelector: UpdateManagedAgentRequestBodySkillsVersionSelector,
+    };
+  }
+
+  validate() {
+    if(this.versionSelector && typeof (this.versionSelector as any).validate === 'function') {
+      (this.versionSelector as any).validate();
+    }
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
+export class UpdateManagedAgentRequestBodySubAgentsSkills extends $dara.Model {
+  /**
+   * @remarks
+   * The skill name used by the sub-agent. Declared as optional for compatibility, but the backend validates that each entry is required.
+   * 
+   * @example
+   * web-search
+   */
+  name?: string;
+  /**
+   * @remarks
+   * The optional version number. If omitted, set to null, or left blank, the latest version is resolved.
+   * 
+   * @example
+   * 1.0.0
+   */
+  version?: string;
   static names(): { [key: string]: string } {
     return {
       name: 'name',
@@ -714,7 +876,7 @@ export class UpdateManagedAgentRequestBodySubAgents extends $dara.Model {
    * This parameter is required.
    * 
    * @example
-   * Review the code
+   * Please review the code
    */
   instruction?: string;
   /**
@@ -727,10 +889,16 @@ export class UpdateManagedAgentRequestBodySubAgents extends $dara.Model {
    * reviewer-agent
    */
   name?: string;
+  /**
+   * @remarks
+   * The skills exclusively used by this sub-agent. Skill names must be unique within the same sub-agent. If this parameter is not specified or an empty array is passed, no skills are configured.
+   */
+  skills?: UpdateManagedAgentRequestBodySubAgentsSkills[];
   static names(): { [key: string]: string } {
     return {
       instruction: 'instruction',
       name: 'name',
+      skills: 'skills',
     };
   }
 
@@ -738,10 +906,14 @@ export class UpdateManagedAgentRequestBodySubAgents extends $dara.Model {
     return {
       instruction: 'string',
       name: 'string',
+      skills: { 'type': 'array', 'itemType': UpdateManagedAgentRequestBodySubAgentsSkills },
     };
   }
 
   validate() {
+    if(Array.isArray(this.skills)) {
+      $dara.Model.validateArray(this.skills);
+    }
     super.validate();
   }
 
@@ -753,7 +925,7 @@ export class UpdateManagedAgentRequestBodySubAgents extends $dara.Model {
 export class UpdateManagedAgentRequestBodyTemplateAiRegistry extends $dara.Model {
   /**
    * @remarks
-   * The name of the template in the AI registry.
+   * The name of the template in AI Registry.
    * 
    * This parameter is required.
    * 
@@ -763,9 +935,7 @@ export class UpdateManagedAgentRequestBodyTemplateAiRegistry extends $dara.Model
   name?: string;
   /**
    * @remarks
-   * The version of the template in the AI registry.
-   * 
-   * This parameter is required.
+   * The version of the template in AI Registry.
    * 
    * @example
    * 1.0.0
@@ -797,7 +967,7 @@ export class UpdateManagedAgentRequestBodyTemplateAiRegistry extends $dara.Model
 export class UpdateManagedAgentRequestBodyTemplate extends $dara.Model {
   /**
    * @remarks
-   * The AI registry template configuration.
+   * The AI Registry template configuration.
    */
   aiRegistry?: UpdateManagedAgentRequestBodyTemplateAiRegistry;
   static names(): { [key: string]: string } {
@@ -869,6 +1039,11 @@ export class UpdateManagedAgentRequestBodyTools extends $dara.Model {
 }
 
 export class UpdateManagedAgentRequestBody extends $dara.Model {
+  /**
+   * @remarks
+   * Omit to retain existing values, pass [] to clear, or pass a non-empty array for full replacement. null is rejected. Combined with OSS mounts, a maximum of 10 items are allowed.
+   */
+  agenticFsMounts?: UpdateManagedAgentRequestBodyAgenticFsMounts[];
   /**
    * @remarks
    * The description of the managed agent.
@@ -884,7 +1059,7 @@ export class UpdateManagedAgentRequestBody extends $dara.Model {
   environment?: UpdateManagedAgentRequestBodyEnvironment;
   /**
    * @remarks
-   * The agent harness configuration.
+   * The agent runtime harness.
    */
   harness?: UpdateManagedAgentRequestBodyHarness;
   /**
@@ -915,7 +1090,7 @@ export class UpdateManagedAgentRequestBody extends $dara.Model {
   network?: UpdateManagedAgentRequestBodyNetwork;
   /**
    * @remarks
-   * The list of OSS mounts. A maximum of 10 entries are supported. Pass an empty array to clear existing mounts.
+   * The list of OSS mounts. A maximum of 10 items are allowed. Pass an empty array to clear existing mounts.
    */
   ossMounts?: UpdateManagedAgentRequestBodyOssMounts[];
   /**
@@ -945,6 +1120,7 @@ export class UpdateManagedAgentRequestBody extends $dara.Model {
   tools?: UpdateManagedAgentRequestBodyTools[];
   static names(): { [key: string]: string } {
     return {
+      agenticFsMounts: 'agenticFsMounts',
       description: 'description',
       environment: 'environment',
       harness: 'harness',
@@ -963,6 +1139,7 @@ export class UpdateManagedAgentRequestBody extends $dara.Model {
 
   static types(): { [key: string]: any } {
     return {
+      agenticFsMounts: { 'type': 'array', 'itemType': UpdateManagedAgentRequestBodyAgenticFsMounts },
       description: 'string',
       environment: UpdateManagedAgentRequestBodyEnvironment,
       harness: UpdateManagedAgentRequestBodyHarness,
@@ -980,6 +1157,9 @@ export class UpdateManagedAgentRequestBody extends $dara.Model {
   }
 
   validate() {
+    if(Array.isArray(this.agenticFsMounts)) {
+      $dara.Model.validateArray(this.agenticFsMounts);
+    }
     if(this.environment && typeof (this.environment as any).validate === 'function') {
       (this.environment as any).validate();
     }
@@ -1026,7 +1206,7 @@ export class UpdateManagedAgentRequest extends $dara.Model {
   body?: UpdateManagedAgentRequestBody;
   /**
    * @remarks
-   * The reserved idempotency token. The backend does not provide idempotency guarantees in the current version.
+   * The reserved idempotency token. The backend does not provide idempotency guarantees in the current release.
    * 
    * @example
    * client-token-1