@alicloud/agentcore20260804 2.2.0 → 2.2.1

package/src/models/GetManagedAgentResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class GetManagedAgentResponseBodyDataAgenticFsMounts extends $dara.Model {
   /**
    * @remarks
-   * The subdirectory under /mnt/agenticfs/ in the container. Each mount item is validated as required by the backend. Mount targets must not be duplicated or have parent-child overlaps.
+   * The subdirectory under /mnt/agenticfs/ in the container. This field is 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
@@ -13,7 +13,7 @@ export class GetManagedAgentResponseBodyDataAgenticFsMounts extends $dara.Model
   mountPath?: string;
   /**
    * @remarks
-   * The non-empty relative directory that exists under the AccessPoint. Each mount item is validated as required by the backend. Root directory, absolute paths, or parent directory segments are not allowed.
+   * The non-empty relative directory that exists under the AccessPoint. This field is required for each mount item as validated by the backend. Root directories, absolute paths, and parent directory segments are not allowed.
    * 
    * @example
    * workspace/data
@@ -21,7 +21,7 @@ export class GetManagedAgentResponseBodyDataAgenticFsMounts extends $dara.Model
   path?: string;
   /**
    * @remarks
-   * Specifies whether to mount as read-only. Defaults to false if omitted. This is not a RAM role read-only policy.
+   * Specifies whether to mount in read-only mode. Default value: false. This is not a RAM role read-only policy.
    * 
    * @example
    * false
@@ -29,7 +29,7 @@ export class GetManagedAgentResponseBodyDataAgenticFsMounts extends $dara.Model
   readOnly?: boolean;
   /**
    * @remarks
-   * The AccessPoint domain name. Each mount item is validated as required by the backend. The value does not include protocol, port, or path. Obtain the value from the DomainName field in the NAS ListAccessPoints response.
+   * The AccessPoint domain name. This field is required for each mount item as validated by the backend. The value does not include protocol, port, or path. Use the DomainName from the NAS ListAccessPoints response.
    * 
    * @example
    * ap-0123456789abcdef0.0123456789-vlm36.cn-hangzhou.nas.aliyuncs.com
@@ -64,11 +64,19 @@ export class GetManagedAgentResponseBodyDataAgenticFsMounts extends $dara.Model
 
 export class GetManagedAgentResponseBodyDataConfiguredSkillsVersionSelector extends $dara.Model {
   /**
+   * @remarks
+   * The version selector type. Valid values:
+   * - LABEL: selects by label.
+   * - VERSION: selects by specific version.
+   * 
    * @example
    * LABEL
    */
   type?: string;
   /**
+   * @remarks
+   * The selector value. When the type is LABEL, this is the label name (such as latest). When the type is VERSION, this is the specific version number.
+   * 
    * @example
    * latest
    */
@@ -99,6 +107,8 @@ export class GetManagedAgentResponseBodyDataConfiguredSkillsVersionSelector exte
 export class GetManagedAgentResponseBodyDataConfiguredSkills extends $dara.Model {
   /**
    * @remarks
+   * The skill name in the Workspace AI Registry.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -106,15 +116,27 @@ export class GetManagedAgentResponseBodyDataConfiguredSkills extends $dara.Model
    */
   name?: string;
   /**
+   * @remarks
+   * The skill source type. Valid values:
+   * - REFERENCE: references the AI Registry.
+   * - STATIC: statically provided with the package.
+   * 
    * @example
    * REFERENCE
    */
   sourceType?: string;
   /**
+   * @remarks
+   * **[Deprecated]** Legacy compatibility field. Use sourceType and versionSelector for new requests.
+   * 
    * @example
    * 1.0.0
    */
   version?: string;
+  /**
+   * @remarks
+   * The version selector for the referenced skill. If omitted, the default value is LABEL/latest. Currently, only LABEL/latest is supported.
+   */
   versionSelector?: GetManagedAgentResponseBodyDataConfiguredSkillsVersionSelector;
   static names(): { [key: string]: string } {
     return {
@@ -265,7 +287,7 @@ export class GetManagedAgentResponseBodyDataEnvironment extends $dara.Model {
 export class GetManagedAgentResponseBodyDataHarnessConfiguration extends $dara.Model {
   /**
    * @remarks
-   * The connector service account key.
+   * The Connector Service Account Key.
    * 
    * @example
    * key-xxxx
@@ -273,7 +295,7 @@ export class GetManagedAgentResponseBodyDataHarnessConfiguration extends $dara.M
   connectorServiceAccountKey?: string;
   /**
    * @remarks
-   * The connector service account name.
+   * The Connector Service Account Name.
    * 
    * @example
    * my-connector-key
@@ -305,12 +327,12 @@ export class GetManagedAgentResponseBodyDataHarnessConfiguration extends $dara.M
 export class GetManagedAgentResponseBodyDataHarness extends $dara.Model {
   /**
    * @remarks
-   * The runtime framework configuration.
+   * The runtime harness configuration.
    */
   configuration?: GetManagedAgentResponseBodyDataHarnessConfiguration;
   /**
    * @remarks
-   * The runtime framework type.
+   * The runtime harness type.
    * 
    * @example
    * qodercli
@@ -369,7 +391,9 @@ export class GetManagedAgentResponseBodyDataModelQuota extends $dara.Model {
   overLimit?: boolean;
   /**
    * @remarks
-   * The quota statistical period. Valid values: day (daily) and month (monthly).
+   * The quota statistical period. Valid values:
+   * - day: daily.
+   * - month: monthly.
    * 
    * @example
    * day
@@ -385,7 +409,7 @@ export class GetManagedAgentResponseBodyDataModelQuota extends $dara.Model {
   ruleStatus?: string;
   /**
    * @remarks
-   * The maximum number of tokens allowed per period.
+   * The maximum number of tokens that can be consumed in a single period.
    * 
    * @example
    * 1000000
@@ -451,7 +475,7 @@ export class GetManagedAgentResponseBodyDataModel extends $dara.Model {
   modelName?: string;
   /**
    * @remarks
-   * The model token quota configuration and quota usage status for the current period. This field is empty if no quota is configured.
+   * The model token quota configuration and the quota usage status for the current period. This field is empty if no quota is configured.
    */
   quota?: GetManagedAgentResponseBodyDataModelQuota;
   static names(): { [key: string]: string } {
@@ -585,7 +609,7 @@ export class GetManagedAgentResponseBodyDataNetwork extends $dara.Model {
 export class GetManagedAgentResponseBodyDataOssMounts extends $dara.Model {
   /**
    * @remarks
-   * The OSS bucket name. Each mount item is validated as required by the backend.
+   * The OSS bucket name. This field is required for each mount item as validated by the backend.
    * 
    * @example
    * bucket-001
@@ -593,7 +617,7 @@ export class GetManagedAgentResponseBodyDataOssMounts extends $dara.Model {
   bucketName?: string;
   /**
    * @remarks
-   * The absolute mount path in the container. Each mount item is validated as required by the backend.
+   * The absolute mount path inside the container. This field is validated as required by the backend for each mount entry.
    * 
    * @example
    * /mnt/oss/datasets
@@ -609,7 +633,7 @@ export class GetManagedAgentResponseBodyDataOssMounts extends $dara.Model {
   path?: string;
   /**
    * @remarks
-   * Specifies whether to mount as read-only. Defaults to false if not specified.
+   * Specifies whether to mount as read-only. Default value: false.
    */
   readOnly?: boolean;
   static names(): { [key: string]: string } {
@@ -674,12 +698,12 @@ export class GetManagedAgentResponseBodyDataRuntimeCompute extends $dara.Model {
 export class GetManagedAgentResponseBodyDataRuntimeHpa extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to enable auto scaling. This field is required when hpa is present, as validated by the backend.
+   * Specifies whether to enable auto scaling. This field is validated as required by the backend when hpa is present.
    */
   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. This field is validated as required by the backend when hpa is present.
    * 
    * @example
    * 5
@@ -687,7 +711,7 @@ export class GetManagedAgentResponseBodyDataRuntimeHpa extends $dara.Model {
   maxConcurrentSessionsPerSandbox?: number;
   /**
    * @remarks
-   * The maximum number of sandboxes. This parameter is required when HPA is enabled and must be no less than the minimum value.
+   * The maximum number of sandboxes. This field is required when HPA is enabled and must be no less than the minimum value.
    * 
    * @example
    * 3
@@ -695,7 +719,7 @@ export class GetManagedAgentResponseBodyDataRuntimeHpa extends $dara.Model {
   maxSandboxCount?: number;
   /**
    * @remarks
-   * The minimum number of sandboxes. This parameter is required when HPA is enabled.
+   * The minimum number of sandboxes. This field is required when HPA is enabled.
    * 
    * @example
    * 1
@@ -703,7 +727,7 @@ export class GetManagedAgentResponseBodyDataRuntimeHpa extends $dara.Model {
   minSandboxCount?: number;
   /**
    * @remarks
-   * The time-to-live (TTL) of a session after inactivity, in seconds. This parameter is required by backend validation when hpa is specified.
+   * The time-to-live in seconds for a session after inactivity. This field is validated as required by the backend when hpa is present.
    * 
    * @example
    * 3600
@@ -741,7 +765,7 @@ export class GetManagedAgentResponseBodyDataRuntimeHpa extends $dara.Model {
 export class GetManagedAgentResponseBodyDataRuntimeSessionPolicy extends $dara.Model {
   /**
    * @remarks
-   * The name of the HTTP header used for session affinity. This parameter takes effect only when sessionPolicy.type is set to ISOLATED_HEADER_FIELD.
+   * The HTTP header name used for session affinity. This field takes effect when sessionPolicy.type is set to ISOLATED_HEADER_FIELD.
    * 
    * @example
    * X-Session-Id
@@ -836,11 +860,19 @@ export class GetManagedAgentResponseBodyDataRuntime extends $dara.Model {
 
 export class GetManagedAgentResponseBodyDataSkillsVersionSelector extends $dara.Model {
   /**
+   * @remarks
+   * The version selector type. Valid values:
+   * - LABEL: selects by label.
+   * - VERSION: selects by specific version.
+   * 
    * @example
    * LABEL
    */
   type?: string;
   /**
+   * @remarks
+   * The selector value. When the type is LABEL, this is the label name (such as latest). When the type is VERSION, this is the specific version number.
+   * 
    * @example
    * latest
    */
@@ -870,11 +902,17 @@ export class GetManagedAgentResponseBodyDataSkillsVersionSelector extends $dara.
 
 export class GetManagedAgentResponseBodyDataSkills extends $dara.Model {
   /**
+   * @remarks
+   * The version currently in effect at runtime. This field is read-only.
+   * 
    * @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
    */
@@ -888,11 +926,19 @@ export class GetManagedAgentResponseBodyDataSkills extends $dara.Model {
    */
   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: references the AI Registry.
+   * - STATIC: statically provided with the package.
+   * 
    * @example
    * REFERENCE
    */
@@ -905,6 +951,10 @@ export class GetManagedAgentResponseBodyDataSkills extends $dara.Model {
    * 1.0.0
    */
   version?: string;
+  /**
+   * @remarks
+   * The referenced version selector. Defaults to LABEL/latest if omitted.
+   */
   versionSelector?: GetManagedAgentResponseBodyDataSkillsVersionSelector;
   static names(): { [key: string]: string } {
     return {
@@ -942,20 +992,60 @@ export class GetManagedAgentResponseBodyDataSkills extends $dara.Model {
   }
 }
 
+export class GetManagedAgentResponseBodyDataSubAgentsSkills extends $dara.Model {
+  /**
+   * @remarks
+   * The skill name used by the child agent. Declared as optional for compatibility, but validated as required by the backend for each entry.
+   * 
+   * @example
+   * web-search
+   */
+  name?: string;
+  /**
+   * @remarks
+   * The optional version number. If omitted, null, or blank, the latest version is resolved.
+   * 
+   * @example
+   * 1.0.0
+   */
+  version?: string;
+  static names(): { [key: string]: string } {
+    return {
+      name: 'name',
+      version: 'version',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      name: 'string',
+      version: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class GetManagedAgentResponseBodyDataSubAgents extends $dara.Model {
   /**
    * @remarks
-   * The sub-agent instruction.
+   * The child agent instruction.
    * 
    * This parameter is required.
    * 
    * @example
-   * Please review the code
+   * Review the code
    */
   instruction?: string;
   /**
    * @remarks
-   * The sub-agent name.
+   * The child agent name.
    * 
    * This parameter is required.
    * 
@@ -963,10 +1053,16 @@ export class GetManagedAgentResponseBodyDataSubAgents extends $dara.Model {
    * reviewer-agent
    */
   name?: string;
+  /**
+   * @remarks
+   * The skills and actual versions used by the child agent. The version field is not returned when the template package does not contain version information.
+   */
+  skills?: GetManagedAgentResponseBodyDataSubAgentsSkills[];
   static names(): { [key: string]: string } {
     return {
       instruction: 'instruction',
       name: 'name',
+      skills: 'skills',
     };
   }
 
@@ -974,10 +1070,14 @@ export class GetManagedAgentResponseBodyDataSubAgents extends $dara.Model {
     return {
       instruction: 'string',
       name: 'string',
+      skills: { 'type': 'array', 'itemType': GetManagedAgentResponseBodyDataSubAgentsSkills },
     };
   }
 
   validate() {
+    if(Array.isArray(this.skills)) {
+      $dara.Model.validateArray(this.skills);
+    }
     super.validate();
   }
 
@@ -1113,12 +1213,12 @@ export class GetManagedAgentResponseBodyData extends $dara.Model {
   agentId?: string;
   /**
    * @remarks
-   * The AgenticFS additional mount list. The total number of items combined with ossMounts cannot exceed 10.
+   * The list of additional AgenticFS mounts. The total number of AgenticFS mounts and OSS mounts cannot exceed 10.
    */
   agenticFsMounts?: GetManagedAgentResponseBodyDataAgenticFsMounts[];
   /**
    * @remarks
-   * 仅包含用户追加或覆盖的 Skill，不包含模板继承项。资源模型读取此字段以保留更新语义；创建和更新仍使用请求中的 skills。
+   * The skills that are explicitly added or overridden by the user. This field does not include skills inherited from the template. The resource model reads this field to preserve update semantics. The skills field in the request is still used for create and update operations.
    */
   configuredSkills?: GetManagedAgentResponseBodyDataConfiguredSkills[];
   /**
@@ -1160,7 +1260,7 @@ export class GetManagedAgentResponseBodyData extends $dara.Model {
   environment?: GetManagedAgentResponseBodyDataEnvironment;
   /**
    * @remarks
-   * The agent runtime framework.
+   * The agent runtime harness.
    */
   harness?: GetManagedAgentResponseBodyDataHarness;
   /**
@@ -1181,7 +1281,7 @@ export class GetManagedAgentResponseBodyData extends $dara.Model {
   latestSpecVersion?: number;
   /**
    * @remarks
-   * The latest version status.
+   * The status of the latest version.
    * 
    * @example
    * succeeded
@@ -1207,7 +1307,7 @@ export class GetManagedAgentResponseBodyData extends $dara.Model {
   network?: GetManagedAgentResponseBodyDataNetwork;
   /**
    * @remarks
-   * The OSS mount list. A maximum of 10 items are supported.
+   * The list of OSS mounts. A maximum of 10 items are allowed.
    */
   ossMounts?: GetManagedAgentResponseBodyDataOssMounts[];
   /**
@@ -1225,7 +1325,7 @@ export class GetManagedAgentResponseBodyData extends $dara.Model {
   runtime?: GetManagedAgentResponseBodyDataRuntime;
   /**
    * @remarks
-   * The instance count 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), 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.
+   * The instance counts of the managed agent grouped by sandbox phase. Current keys: PENDING (creating or initializing), RUNNING (running), HIBERNATING (hibernating), HIBERNATED (hibernated), RESUMING (resuming), TERMINATING (terminating), FAILED (runtime failure). Only phases that actually occur are returned. Missing keys should be treated as 0. This field is a dynamic map and new keys may be added in the future. Use FAILED > 0 to determine whether abnormal instances exist.
    */
   sandboxPhaseCounts?: { [key: string]: number };
   /**
@@ -1243,7 +1343,7 @@ export class GetManagedAgentResponseBodyData extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The list of sub-agent configurations.
+   * The list of child agent configurations.
    */
   subAgents?: GetManagedAgentResponseBodyDataSubAgents[];
   /**
@@ -1258,7 +1358,7 @@ export class GetManagedAgentResponseBodyData extends $dara.Model {
   tools?: GetManagedAgentResponseBodyDataTools[];
   /**
    * @remarks
-   * The update time in RFC 3339 format.
+   * The time when the resource was last updated, in RFC 3339 format.
    * 
    * @example
    * 2026-01-01T00:00:00Z
@@ -1398,7 +1498,7 @@ export class GetManagedAgentResponseBody extends $dara.Model {
   data?: GetManagedAgentResponseBodyData;
   /**
    * @remarks
-   * The HTTP status code. The value 200 indicates success.
+   * The HTTP status code. A value of 200 indicates success.
    * 
    * @example
    * 200

package/src/models/ListSkillsRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListSkillsRequest extends $dara.Model {
   /**
    * @remarks
-   * The maximum number of entries to return per page.
+   * The maximum number of entries per page.
    * 
    * @example
    * 20
@@ -21,7 +21,7 @@ export class ListSkillsRequest extends $dara.Model {
   nextToken?: string;
   /**
    * @remarks
-   * The sort field. The value download_count is supported. Default value: gmt_modified.
+   * The field by which to sort results. The value download_count is supported. Default value: gmt_modified.
    * 
    * @example
    * download_count

package/src/models/ListSkillsResponseBody.ts

@@ -28,13 +28,20 @@ export class ListSkillsResponseBodyDataPageItems extends $dara.Model {
    */
   downloadCount?: number;
   /**
+   * @remarks
+   * The draft mode. Valid values:
+   * - HEAD: The Skill has a persistent draft.
+   * - VERSIONED: Each edit creates a versioned draft.
+   * 
+   * The value is determined by the server. The caller uses this value to render the status column.
+   * 
    * @example
    * HEAD
    */
   draftMode?: string;
   /**
    * @remarks
-   * The version that is being edited.
+   * The version that is being edited. In HEAD draft mode, the value is HEAD.
    * 
    * @example
    * 1.0.0
@@ -84,7 +91,7 @@ export class ListSkillsResponseBodyDataPageItems extends $dara.Model {
   owner?: string;
   /**
    * @remarks
-   * The version that is under review.
+   * The version that is under review. In HEAD draft mode, the value is HEAD.
    * 
    * @example
    * 1.0.0
@@ -241,7 +248,7 @@ export class ListSkillsResponseBody extends $dara.Model {
   data?: ListSkillsResponseBodyData;
   /**
    * @remarks
-   * The maximum number of entries to return per page.
+   * The maximum number of entries per page.
    * 
    * @example
    * 20