@alicloud/agentcore20260804 2.1.1 → 2.2.1

package/src/models/UpdateManagedAgentResponseBody.ts

@@ -2,6 +2,172 @@
 import * as $dara from '@darabonba/typescript';
 
 
+export class UpdateManagedAgentResponseBodyDataAgenticFsMounts 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 UpdateManagedAgentResponseBodyDataConfiguredSkillsVersionSelector 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 UpdateManagedAgentResponseBodyDataConfiguredSkills extends $dara.Model {
+  /**
+   * @remarks
+   * The skill name in the Workspace AI Registry.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * web-search
+   */
+  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
+   * A legacy compatibility field. Use sourceType and versionSelector for new requests.
+   * 
+   * @example
+   * 1.0.0
+   */
+  version?: string;
+  /**
+   * @remarks
+   * The version selector for the reference. Defaults to LABEL/latest if omitted. Currently supports LABEL/latest.
+   */
+  versionSelector?: UpdateManagedAgentResponseBodyDataConfiguredSkillsVersionSelector;
+  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: UpdateManagedAgentResponseBodyDataConfiguredSkillsVersionSelector,
+    };
+  }
+
+  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 UpdateManagedAgentResponseBodyDataEnvironmentCredentialReferences extends $dara.Model {
   /**
    * @remarks
@@ -121,7 +287,7 @@ export class UpdateManagedAgentResponseBodyDataEnvironment extends $dara.Model {
 export class UpdateManagedAgentResponseBodyDataHarnessConfiguration extends $dara.Model {
   /**
    * @remarks
-   * The connector service account key.
+   * The Connector Service Account Key.
    * 
    * @example
    * key-xxxx
@@ -129,7 +295,7 @@ export class UpdateManagedAgentResponseBodyDataHarnessConfiguration extends $dar
   connectorServiceAccountKey?: string;
   /**
    * @remarks
-   * The connector service account name.
+   * The Connector Service Account Name.
    * 
    * @example
    * my-connector-key
@@ -161,12 +327,12 @@ export class UpdateManagedAgentResponseBodyDataHarnessConfiguration extends $dar
 export class UpdateManagedAgentResponseBodyDataHarness extends $dara.Model {
   /**
    * @remarks
-   * The harness configuration.
+   * The runtime harness configuration.
    */
   configuration?: UpdateManagedAgentResponseBodyDataHarnessConfiguration;
   /**
    * @remarks
-   * The harness type.
+   * The runtime harness type.
    * 
    * @example
    * qodercli
@@ -217,7 +383,7 @@ export class UpdateManagedAgentResponseBodyDataModelQuota extends $dara.Model {
   limitType?: string;
   /**
    * @remarks
-   * Indicates whether the quota has been exceeded in the current period. This is a read-only field returned by the backend.
+   * Indicates whether the quota has been exceeded in the current period. This field is read-only and returned by the backend.
    * 
    * @example
    * false
@@ -225,7 +391,7 @@ export class UpdateManagedAgentResponseBodyDataModelQuota extends $dara.Model {
   overLimit?: boolean;
   /**
    * @remarks
-   * The quota statistical period. The value day indicates a daily period, and the value month indicates a monthly period.
+   * The quota statistical period. Valid values: day (daily) and month (monthly).
    * 
    * @example
    * day
@@ -233,7 +399,7 @@ export class UpdateManagedAgentResponseBodyDataModelQuota extends $dara.Model {
   periodType?: string;
   /**
    * @remarks
-   * The gateway quota rule status. This is a read-only field returned by the backend.
+   * The gateway quota rule status. This field is read-only and returned by the backend.
    * 
    * @example
    * ACTIVE
@@ -241,7 +407,7 @@ export class UpdateManagedAgentResponseBodyDataModelQuota extends $dara.Model {
   ruleStatus?: string;
   /**
    * @remarks
-   * The maximum number of tokens that can be consumed within a single period.
+   * The maximum number of tokens that can be consumed in a single period.
    * 
    * @example
    * 1000000
@@ -249,7 +415,7 @@ export class UpdateManagedAgentResponseBodyDataModelQuota extends $dara.Model {
   usageLimit?: number;
   /**
    * @remarks
-   * The number of tokens consumed in the current period. This is a read-only field returned by the backend.
+   * The number of tokens consumed in the current period. This field is read-only and returned by the backend.
    * 
    * @example
    * 12345
@@ -441,7 +607,7 @@ export class UpdateManagedAgentResponseBodyDataNetwork extends $dara.Model {
 export class UpdateManagedAgentResponseBodyDataOssMounts 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
@@ -449,7 +615,7 @@ export class UpdateManagedAgentResponseBodyDataOssMounts 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
@@ -457,7 +623,7 @@ export class UpdateManagedAgentResponseBodyDataOssMounts 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
@@ -498,7 +664,7 @@ export class UpdateManagedAgentResponseBodyDataOssMounts extends $dara.Model {
 export class UpdateManagedAgentResponseBodyDataRuntimeCompute extends $dara.Model {
   /**
    * @remarks
-   * The compute specification.
+   * The compute class.
    * 
    * This parameter is required.
    * 
@@ -530,12 +696,12 @@ export class UpdateManagedAgentResponseBodyDataRuntimeCompute extends $dara.Mode
 export class UpdateManagedAgentResponseBodyDataRuntimeHpa 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
@@ -543,7 +709,7 @@ export class UpdateManagedAgentResponseBodyDataRuntimeHpa 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
@@ -551,7 +717,7 @@ export class UpdateManagedAgentResponseBodyDataRuntimeHpa 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
@@ -559,7 +725,7 @@ export class UpdateManagedAgentResponseBodyDataRuntimeHpa 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
@@ -597,7 +763,7 @@ export class UpdateManagedAgentResponseBodyDataRuntimeHpa extends $dara.Model {
 export class UpdateManagedAgentResponseBodyDataRuntimeSessionPolicy 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
@@ -646,7 +812,7 @@ export class UpdateManagedAgentResponseBodyDataRuntime extends $dara.Model {
   compute?: UpdateManagedAgentResponseBodyDataRuntimeCompute;
   /**
    * @remarks
-   * The sandbox auto scaling and session configuration.
+   * The Sandbox auto scaling and session configuration.
    */
   hpa?: UpdateManagedAgentResponseBodyDataRuntimeHpa;
   /**
@@ -690,17 +856,91 @@ export class UpdateManagedAgentResponseBodyDataRuntime extends $dara.Model {
   }
 }
 
+export class UpdateManagedAgentResponseBodyDataSkillsVersionSelector 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 UpdateManagedAgentResponseBodyDataSkills extends $dara.Model {
   /**
    * @remarks
-   * The skill name.
+   * The version that has taken effect at runtime. This field is read-only.
    * 
-   * This parameter is required.
+   * @example
+   * 1.0.0
+   */
+  appliedVersion?: string;
+  /**
+   * @remarks
+   * Indicates whether the skill originates from a fixed template. This field is read-only. Template items cannot be removed.
+   * 
+   * @example
+   * false
+   */
+  fromTemplate?: boolean;
+  /**
+   * @remarks
+   * The skill name.
    * 
    * @example
    * code-analysis
    */
   name?: string;
+  /**
+   * @remarks
+   * The current target version. This field is read-only.
+   * 
+   * @example
+   * 1.0.0
+   */
+  resolvedVersion?: 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.
@@ -709,6 +949,64 @@ export class UpdateManagedAgentResponseBodyDataSkills extends $dara.Model {
    * 1.0.0
    */
   version?: string;
+  /**
+   * @remarks
+   * The referenced version selector. Defaults to LABEL/latest if omitted.
+   */
+  versionSelector?: UpdateManagedAgentResponseBodyDataSkillsVersionSelector;
+  static names(): { [key: string]: string } {
+    return {
+      appliedVersion: 'appliedVersion',
+      fromTemplate: 'fromTemplate',
+      name: 'name',
+      resolvedVersion: 'resolvedVersion',
+      sourceType: 'sourceType',
+      version: 'version',
+      versionSelector: 'versionSelector',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      appliedVersion: 'string',
+      fromTemplate: 'boolean',
+      name: 'string',
+      resolvedVersion: 'string',
+      sourceType: 'string',
+      version: 'string',
+      versionSelector: UpdateManagedAgentResponseBodyDataSkillsVersionSelector,
+    };
+  }
+
+  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 UpdateManagedAgentResponseBodyDataSubAgentsSkills 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',
@@ -740,7 +1038,7 @@ export class UpdateManagedAgentResponseBodyDataSubAgents extends $dara.Model {
    * This parameter is required.
    * 
    * @example
-   * Review the code
+   * Please review the code
    */
   instruction?: string;
   /**
@@ -753,10 +1051,16 @@ export class UpdateManagedAgentResponseBodyDataSubAgents extends $dara.Model {
    * reviewer-agent
    */
   name?: string;
+  /**
+   * @remarks
+   * The skills used by the child agent and their actual versions. The version field is not returned if the template package does not contain version information.
+   */
+  skills?: UpdateManagedAgentResponseBodyDataSubAgentsSkills[];
   static names(): { [key: string]: string } {
     return {
       instruction: 'instruction',
       name: 'name',
+      skills: 'skills',
     };
   }
 
@@ -764,10 +1068,14 @@ export class UpdateManagedAgentResponseBodyDataSubAgents extends $dara.Model {
     return {
       instruction: 'string',
       name: 'string',
+      skills: { 'type': 'array', 'itemType': UpdateManagedAgentResponseBodyDataSubAgentsSkills },
     };
   }
 
   validate() {
+    if(Array.isArray(this.skills)) {
+      $dara.Model.validateArray(this.skills);
+    }
     super.validate();
   }
 
@@ -779,7 +1087,7 @@ export class UpdateManagedAgentResponseBodyDataSubAgents extends $dara.Model {
 export class UpdateManagedAgentResponseBodyDataTemplateAiRegistry 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.
    * 
@@ -789,9 +1097,7 @@ export class UpdateManagedAgentResponseBodyDataTemplateAiRegistry extends $dara.
   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
@@ -823,7 +1129,7 @@ export class UpdateManagedAgentResponseBodyDataTemplateAiRegistry extends $dara.
 export class UpdateManagedAgentResponseBodyDataTemplate extends $dara.Model {
   /**
    * @remarks
-   * The AI registry template configuration.
+   * The AI Registry template configuration.
    */
   aiRegistry?: UpdateManagedAgentResponseBodyDataTemplateAiRegistry;
   static names(): { [key: string]: string } {
@@ -903,6 +1209,16 @@ export class UpdateManagedAgentResponseBodyData extends $dara.Model {
    * agent-1
    */
   agentId?: string;
+  /**
+   * @remarks
+   * The AgenticFS additional mount list. The total number of items combined with ossMounts cannot exceed 10.
+   */
+  agenticFsMounts?: UpdateManagedAgentResponseBodyDataAgenticFsMounts[];
+  /**
+   * @remarks
+   * The skills that are explicitly configured. This field contains only skills that the user appended or overrode, excluding skills inherited from templates. The resource model reads this field to preserve update semantics. The skills field in the request is still used for creation and update operations.
+   */
+  configuredSkills?: UpdateManagedAgentResponseBodyDataConfiguredSkills[];
   /**
    * @remarks
    * The creation mode.
@@ -937,12 +1253,12 @@ export class UpdateManagedAgentResponseBodyData extends $dara.Model {
   description?: string;
   /**
    * @remarks
-   * The environment configuration information.
+   * The environment configuration.
    */
   environment?: UpdateManagedAgentResponseBodyDataEnvironment;
   /**
    * @remarks
-   * The agent harness configuration.
+   * The agent runtime harness.
    */
   harness?: UpdateManagedAgentResponseBodyDataHarness;
   /**
@@ -971,7 +1287,7 @@ export class UpdateManagedAgentResponseBodyData extends $dara.Model {
   latestVersionStatus?: string;
   /**
    * @remarks
-   * The model configuration information.
+   * The model configuration.
    */
   model?: UpdateManagedAgentResponseBodyDataModel;
   /**
@@ -984,12 +1300,12 @@ export class UpdateManagedAgentResponseBodyData extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The network configuration information.
+   * The network configuration.
    */
   network?: UpdateManagedAgentResponseBodyDataNetwork;
   /**
    * @remarks
-   * The list of OSS mounts. A maximum of 10 entries are supported.
+   * The OSS mount list. A maximum of 10 items are supported.
    */
   ossMounts?: UpdateManagedAgentResponseBodyDataOssMounts[];
   /**
@@ -1007,7 +1323,7 @@ export class UpdateManagedAgentResponseBodyData extends $dara.Model {
   runtime?: UpdateManagedAgentResponseBodyDataRuntime;
   /**
    * @remarks
-   * The number of managed agent instances grouped by sandbox phase. Current keys: PENDING (being created or initialized), RUNNING (running), HIBERNATING (entering hibernation), HIBERNATED (hibernated), RESUMING (resuming), TERMINATING (being terminated), FAILED (runtime failure). Only phases that actually occur are returned. Missing keys should be treated as 0. This field is a dynamic mapping, and new keys may be added in the future. You can use FAILED > 0 to determine whether any abnormal instances exist.
+   * The instance counts of the managed agent grouped by sandbox phase. Current keys: PENDING (being created or initialized), RUNNING (running), HIBERNATING (entering hibernation), HIBERNATED (hibernated), RESUMING (resuming), TERMINATING (being terminated), and FAILED (runtime failure). Only phases that actually occur are returned. Missing keys are treated as 0. This field is a dynamic map and new keys may be added in the future. You can use FAILED > 0 to determine whether abnormal instances exist.
    */
   sandboxPhaseCounts?: { [key: string]: number };
   /**
@@ -1030,7 +1346,7 @@ export class UpdateManagedAgentResponseBodyData extends $dara.Model {
   subAgents?: UpdateManagedAgentResponseBodyDataSubAgents[];
   /**
    * @remarks
-   * The template configuration.
+   * The template configuration information.
    */
   template?: UpdateManagedAgentResponseBodyDataTemplate;
   /**
@@ -1057,6 +1373,8 @@ export class UpdateManagedAgentResponseBodyData extends $dara.Model {
   static names(): { [key: string]: string } {
     return {
       agentId: 'agentId',
+      agenticFsMounts: 'agenticFsMounts',
+      configuredSkills: 'configuredSkills',
       createMode: 'createMode',
       createdAt: 'createdAt',
       deployType: 'deployType',
@@ -1086,6 +1404,8 @@ export class UpdateManagedAgentResponseBodyData extends $dara.Model {
   static types(): { [key: string]: any } {
     return {
       agentId: 'string',
+      agenticFsMounts: { 'type': 'array', 'itemType': UpdateManagedAgentResponseBodyDataAgenticFsMounts },
+      configuredSkills: { 'type': 'array', 'itemType': UpdateManagedAgentResponseBodyDataConfiguredSkills },
       createMode: 'string',
       createdAt: 'string',
       deployType: 'string',
@@ -1113,6 +1433,12 @@ export class UpdateManagedAgentResponseBodyData extends $dara.Model {
   }
 
   validate() {
+    if(Array.isArray(this.agenticFsMounts)) {
+      $dara.Model.validateArray(this.agenticFsMounts);
+    }
+    if(Array.isArray(this.configuredSkills)) {
+      $dara.Model.validateArray(this.configuredSkills);
+    }
     if(this.environment && typeof (this.environment as any).validate === 'function') {
       (this.environment as any).validate();
     }
@@ -1178,7 +1504,7 @@ export class UpdateManagedAgentResponseBody extends $dara.Model {
   httpStatusCode?: number;
   /**
    * @remarks
-   * The result message of the request.
+   * The message returned for the request.
    * 
    * @example
    * success

package/src/models/UpdateManagedAgentShrinkRequest.ts

@@ -10,7 +10,7 @@ export class UpdateManagedAgentShrinkRequest extends $dara.Model {
   bodyShrink?: string;
   /**
    * @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

package/src/models/UpdateSkillLabelsRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class UpdateSkillLabelsRequestBody extends $dara.Model {
   /**
    * @remarks
-   * The version label mapping JSON string.
+   * A JSON string of version label mappings.
    * 
    * This parameter is required.
    *