@alicloud/agentcore20260804 2.3.0 → 2.3.1

package/src/models/CreateExternalAgentResponseBody.ts

@@ -2,13 +2,116 @@
 import * as $dara from '@darabonba/typescript';
 
 
+export class CreateExternalAgentResponseBodyDataConfiguredSkillsVersionSelector extends $dara.Model {
+  /**
+   * @remarks
+   * The type of the version selector. Valid values:
+   * - LABEL: By label.
+   * - VERSION: By specific version.
+   * 
+   * @example
+   * LABEL
+   */
+  type?: string;
+  /**
+   * @remarks
+   * The value of the selector. If the type is LABEL, this value is the label name, such as latest. If the type is VERSION, this value is the 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 CreateExternalAgentResponseBodyDataConfiguredSkills extends $dara.Model {
+  /**
+   * @remarks
+   * The name of the skill in Workspace AI Registry.
+   * 
+   * This parameter is required.
+   * 
+   * @example
+   * web-search
+   */
+  name?: string;
+  /**
+   * @remarks
+   * The source type of the skill. Valid values:
+   * - REFERENCE: References the AI Registry.
+   * - STATIC: Statically provided with the package.
+   * 
+   * @example
+   * REFERENCE
+   */
+  sourceType?: string;
+  /**
+   * @remarks
+   * The legacy compatibility field. New requests use sourceType and versionSelector.
+   * 
+   * @example
+   * 1.0.0
+   */
+  version?: string;
+  /**
+   * @remarks
+   * The referenced version selector. If omitted, the default value is LABEL/latest. Currently, only LABEL/latest is supported.
+   */
+  versionSelector?: CreateExternalAgentResponseBodyDataConfiguredSkillsVersionSelector;
+  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: CreateExternalAgentResponseBodyDataConfiguredSkillsVersionSelector,
+    };
+  }
+
+  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 CreateExternalAgentResponseBodyDataExternalAgentStatus extends $dara.Model {
   /**
    * @remarks
-   * The heartbeat status. ONLINE indicates that the most recent heartbeat has not exceeded the configured timeout threshold. STALE indicates that the heartbeat has timed out. UNKNOWN indicates that the heartbeat is missing or has an invalid format. Valid values:
-   * - ONLINE: Online.
-   * - STALE: Heartbeat expired.
-   * - UNKNOWN: Unknown.
+   * The heartbeat status. ONLINE indicates that the most recent heartbeat has not exceeded the configured timeout threshold. STALE indicates that the heartbeat has timed out. UNKNOWN indicates that the heartbeat is missing or has an invalid format. Valid values: ONLINE (online), STALE (heartbeat expired), and UNKNOWN (unknown).
    * 
    * @example
    * ONLINE
@@ -94,7 +197,7 @@ export class CreateExternalAgentResponseBodyDataModelQuota extends $dara.Model {
   limitType?: string;
   /**
    * @remarks
-   * Indicates whether the quota has been exceeded in the current cycle. 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
@@ -102,7 +205,7 @@ export class CreateExternalAgentResponseBodyDataModelQuota extends $dara.Model {
   overLimit?: boolean;
   /**
    * @remarks
-   * The quota statistical period. day indicates a daily period. month indicates a monthly period.
+   * The quota statistical period. The value day indicates daily statistics. The value month indicates monthly statistics.
    * 
    * @example
    * day
@@ -110,7 +213,7 @@ export class CreateExternalAgentResponseBodyDataModelQuota 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
@@ -118,7 +221,7 @@ export class CreateExternalAgentResponseBodyDataModelQuota extends $dara.Model {
   ruleStatus?: string;
   /**
    * @remarks
-   * The maximum number of tokens that can be consumed within a single cycle.
+   * The maximum number of tokens that can be consumed in a single period.
    * 
    * @example
    * 1000000
@@ -126,7 +229,7 @@ export class CreateExternalAgentResponseBodyDataModelQuota extends $dara.Model {
   usageLimit?: number;
   /**
    * @remarks
-   * The number of tokens consumed in the current cycle. 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
@@ -184,7 +287,7 @@ export class CreateExternalAgentResponseBodyDataModel extends $dara.Model {
   modelName?: string;
   /**
    * @remarks
-   * The model token quota configuration and the quota usage status in the current cycle. This field is empty if no quota is configured.
+   * The model token quota configuration and quota usage status for the current period. This field is empty if no quota is configured.
    */
   quota?: CreateExternalAgentResponseBodyDataModelQuota;
   static names(): { [key: string]: string } {
@@ -215,17 +318,91 @@ export class CreateExternalAgentResponseBodyDataModel extends $dara.Model {
   }
 }
 
+export class CreateExternalAgentResponseBodyDataSkillsVersionSelector extends $dara.Model {
+  /**
+   * @remarks
+   * The type of the version selector. Valid values:
+   * - LABEL: By label.
+   * - VERSION: By specific version.
+   * 
+   * @example
+   * LABEL
+   */
+  type?: string;
+  /**
+   * @remarks
+   * The value of the selector. If the type is LABEL, this value is the label name, such as latest. If the type is VERSION, this value is the 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 CreateExternalAgentResponseBodyDataSkills extends $dara.Model {
   /**
    * @remarks
-   * The skill name.
+   * The version applied at runtime. This field is read-only.
    * 
-   * This parameter is required.
+   * @example
+   * 1.0.0
+   */
+  appliedVersion?: string;
+  /**
+   * @remarks
+   * Indicates whether the skill comes 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 source type of the skill. Valid values:
+   * - REFERENCE: References the AI Registry.
+   * - STATIC: Statically provided with the package.
+   * 
+   * @example
+   * REFERENCE
+   */
+  sourceType?: string;
   /**
    * @remarks
    * The skill version.
@@ -234,21 +411,39 @@ export class CreateExternalAgentResponseBodyDataSkills extends $dara.Model {
    * 1.0.0
    */
   version?: string;
+  /**
+   * @remarks
+   * The referenced version selector. If omitted, the default value is LABEL/latest.
+   */
+  versionSelector?: CreateExternalAgentResponseBodyDataSkillsVersionSelector;
   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: CreateExternalAgentResponseBodyDataSkillsVersionSelector,
     };
   }
 
   validate() {
+    if(this.versionSelector && typeof (this.versionSelector as any).validate === 'function') {
+      (this.versionSelector as any).validate();
+    }
     super.validate();
   }
 
@@ -260,7 +455,7 @@ export class CreateExternalAgentResponseBodyDataSkills extends $dara.Model {
 export class CreateExternalAgentResponseBodyDataTemplateAiRegistry extends $dara.Model {
   /**
    * @remarks
-   * The name of the template in AI Registry.
+   * The name of the template in the AI Registry.
    * 
    * This parameter is required.
    * 
@@ -270,7 +465,7 @@ export class CreateExternalAgentResponseBodyDataTemplateAiRegistry extends $dara
   name?: string;
   /**
    * @remarks
-   * The version of the template in AI Registry.
+   * The version of the template in the AI Registry.
    * 
    * This parameter is required.
    * 
@@ -379,12 +574,17 @@ export class CreateExternalAgentResponseBodyDataTools extends $dara.Model {
 export class CreateExternalAgentResponseBodyData extends $dara.Model {
   /**
    * @remarks
-   * The external agent ID.
+   * The ID of the external agent.
    * 
    * @example
    * agent-1
    */
   agentId?: string;
+  /**
+   * @remarks
+   * Includes only the skills added or overridden by the user. Template-inherited skills are not included. The resource model reads this field to preserve update semantics. Creation and update operations still use the skills in the request.
+   */
+  configuredSkills?: CreateExternalAgentResponseBodyDataConfiguredSkills[];
   /**
    * @remarks
    * The creation mode.
@@ -395,7 +595,7 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   createMode?: string;
   /**
    * @remarks
-   * The creation time in RFC 3339 format.
+   * The creation time, in RFC 3339 format.
    * 
    * @example
    * 2026-01-01T00:00:00Z
@@ -414,7 +614,7 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
    * The description of the external agent.
    * 
    * @example
-   * A code review agent running in the user environment
+   * Code review agent running in the user environment
    */
   description?: string;
   /**
@@ -424,7 +624,7 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   externalAgentStatus?: CreateExternalAgentResponseBodyDataExternalAgentStatus;
   /**
    * @remarks
-   * The agent instruction that guides the behavior of the agent.
+   * The instructions that guide the behavior of the agent.
    * 
    * @example
    * You are a code review assistant
@@ -440,13 +640,7 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   latestSpecVersion?: number;
   /**
    * @remarks
-   * The processing status of the latest specification version. Valid values:
-   * - pending: Pending.
-   * - processing: Processing.
-   * - waiting_retry: Waiting for retry.
-   * - succeeded: Succeeded.
-   * - failed: Failed.
-   * - superseded: Superseded by a newer version.
+   * The processing status of the latest specification version. Valid values: pending (to be processed), processing (in progress), waiting_retry (waiting for retry), succeeded (success), failed (failure), and superseded (replaced by a new version).
    * 
    * @example
    * pending
@@ -454,14 +648,14 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   latestVersionStatus?: string;
   /**
    * @remarks
-   * The model configuration. Available only when modelSource is set to PLATFORM.
+   * The model configuration. This parameter is available only when modelSource is set to PLATFORM.
    */
   model?: CreateExternalAgentResponseBodyDataModel;
   /**
    * @remarks
-   * The model configuration source. PLATFORM indicates that the platform parses and delivers the model configuration. RUNTIME indicates that the external runtime manages the model independently, and the model parameter cannot be specified at the same time. Valid values:
-   * - PLATFORM: platform model.
-   * - RUNTIME: runtime model.
+   * The source of the model configuration. PLATFORM indicates that the platform parses and delivers the model configuration. RUNTIME indicates that the external runtime manages the model, and the model parameter cannot be passed at the same time. Valid values:
+   * - PLATFORM: Platform model.
+   * - RUNTIME: Runtime model.
    * 
    * @example
    * PLATFORM
@@ -498,13 +692,7 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   skills?: CreateExternalAgentResponseBodyDataSkills[];
   /**
    * @remarks
-   * The external agent status. Valid values:
-   * - Creating: Being created.
-   * - Running: Running.
-   * - Failed: Failed.
-   * - Updating: Being updated.
-   * - Deleting: Being deleted.
-   * - Deleted: Deleted.
+   * The status of the external agent. Valid values: Creating, Running, Failed, Updating, Deleting, and Deleted.
    * 
    * @example
    * Running
@@ -539,6 +727,7 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   static names(): { [key: string]: string } {
     return {
       agentId: 'agentId',
+      configuredSkills: 'configuredSkills',
       createMode: 'createMode',
       createdAt: 'createdAt',
       deployType: 'deployType',
@@ -564,6 +753,7 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   static types(): { [key: string]: any } {
     return {
       agentId: 'string',
+      configuredSkills: { 'type': 'array', 'itemType': CreateExternalAgentResponseBodyDataConfiguredSkills },
       createMode: 'string',
       createdAt: 'string',
       deployType: 'string',
@@ -587,6 +777,9 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   }
 
   validate() {
+    if(Array.isArray(this.configuredSkills)) {
+      $dara.Model.validateArray(this.configuredSkills);
+    }
     if(this.externalAgentStatus && typeof (this.externalAgentStatus as any).validate === 'function') {
       (this.externalAgentStatus as any).validate();
     }
@@ -613,7 +806,7 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
 export class CreateExternalAgentResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The business status code. The value is SUCCESS when the request succeeds.
+   * The business status code. The value is SUCCESS when the operation is successful.
    * 
    * @example
    * SUCCESS
@@ -626,7 +819,7 @@ export class CreateExternalAgentResponseBody extends $dara.Model {
   data?: CreateExternalAgentResponseBodyData;
   /**
    * @remarks
-   * The HTTP status code. The value is 200 when the request succeeds.
+   * The HTTP status code. A value of 200 indicates success.
    * 
    * @example
    * 200
@@ -650,7 +843,7 @@ export class CreateExternalAgentResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * Indicates whether the request was successful.
+   * Indicates whether the request is successful.
    */
   success?: boolean;
   static names(): { [key: string]: string } {

package/src/models/CreateExternalAgentShrinkRequest.ts

@@ -10,7 +10,7 @@ export class CreateExternalAgentShrinkRequest extends $dara.Model {
   bodyShrink?: string;
   /**
    * @remarks
-   * The reserved idempotency token. The backend does not provide idempotency guarantee in the current phase.
+   * The reserved idempotency token. The backend does not provide idempotency guarantees in the current phase.
    * 
    * @example
    * client-token-1