@alicloud/agentcore20260804 1.2.1 → 2.0.0

package/src/models/CreateAgentSpecResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class CreateAgentSpecResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The response data.
+   * The returned data.
    * 
    * @example
    * agentspec-1234567890abcdef

package/src/models/CreateCredentialRequest.ts

@@ -2,9 +2,61 @@
 import * as $dara from '@darabonba/typescript';
 
 
+export class CreateCredentialRequestBodyResourceRefs extends $dara.Model {
+  /**
+   * @remarks
+   * The unique identifier of the resource.
+   * 
+   * @example
+   * agent-xxxx
+   */
+  resourceId?: string;
+  /**
+   * @remarks
+   * The resource name. This value is empty if the resource has been deleted.
+   * 
+   * @example
+   * my-agent
+   */
+  resourceName?: string;
+  /**
+   * @remarks
+   * The resource type, such as agent.
+   * 
+   * @example
+   * agent
+   */
+  resourceType?: string;
+  static names(): { [key: string]: string } {
+    return {
+      resourceId: 'resourceId',
+      resourceName: 'resourceName',
+      resourceType: 'resourceType',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      resourceId: 'string',
+      resourceName: 'string',
+      resourceType: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class CreateCredentialRequestBody extends $dara.Model {
   /**
    * @remarks
+   * The credential content. The value is a JSON string. When credentialType is set to apiKey, the content can contain only the apiKey field, and the value cannot be empty. After being written, the content can only be queried in masked form.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -13,6 +65,8 @@ export class CreateCredentialRequestBody extends $dara.Model {
   credentialMetadata?: string;
   /**
    * @remarks
+   * The credential type. Currently, only apiKey is supported.
+   * 
    * This parameter is required.
    * 
    * @example
@@ -20,24 +74,44 @@ export class CreateCredentialRequestBody extends $dara.Model {
    */
   credentialType?: string;
   /**
+   * @remarks
+   * The credential description. The description can be up to 256 characters in length.
+   * 
    * @example
-   * 线上环境调用模型服务使用的 API Key
+   * API Key used for calling model services in the production environment
    */
   description?: string;
   /**
    * @remarks
+   * The credential name. The name must be unique within the workspace and can contain only letters, digits, periods (.), underscores (_), and hyphens (-). The name must be 3 to 128 characters in length and cannot use runtime reserved names.
+   * 
    * This parameter is required.
    * 
    * @example
    * model-api-key
    */
   name?: string;
+  /**
+   * @remarks
+   * This parameter is required and must be a non-empty array when resourceScope is set to SPECIFIED. Each item contains resourceType and resourceId. resourceName is optional.
+   */
+  resourceRefs?: CreateCredentialRequestBodyResourceRefs[];
+  /**
+   * @remarks
+   * ALL indicates all resources. SPECIFIED indicates that the credential applies only to the resources specified in resourceRefs.
+   * 
+   * @example
+   * ALL
+   */
+  resourceScope?: string;
   static names(): { [key: string]: string } {
     return {
       credentialMetadata: 'credentialMetadata',
       credentialType: 'credentialType',
       description: 'description',
       name: 'name',
+      resourceRefs: 'resourceRefs',
+      resourceScope: 'resourceScope',
     };
   }
 
@@ -47,10 +121,15 @@ export class CreateCredentialRequestBody extends $dara.Model {
       credentialType: 'string',
       description: 'string',
       name: 'string',
+      resourceRefs: { 'type': 'array', 'itemType': CreateCredentialRequestBodyResourceRefs },
+      resourceScope: 'string',
     };
   }
 
   validate() {
+    if(Array.isArray(this.resourceRefs)) {
+      $dara.Model.validateArray(this.resourceRefs);
+    }
     super.validate();
   }
 
@@ -60,10 +139,17 @@ export class CreateCredentialRequestBody extends $dara.Model {
 }
 
 export class CreateCredentialRequest extends $dara.Model {
+  /**
+   * @remarks
+   * The request body for creating a credential.
+   */
   body?: CreateCredentialRequestBody;
   /**
+   * @remarks
+   * Not supported.
+   * 
    * @example
-   * 暂不支持
+   * Not supported
    */
   clientToken?: string;
   static names(): { [key: string]: string } {

package/src/models/CreateCredentialResponseBody.ts

@@ -2,48 +2,138 @@
 import * as $dara from '@darabonba/typescript';
 
 
+export class CreateCredentialResponseBodyDataResourceRefs extends $dara.Model {
+  /**
+   * @remarks
+   * The unique identifier of the resource.
+   * 
+   * @example
+   * agent-xxxx
+   */
+  resourceId?: string;
+  /**
+   * @remarks
+   * The resource name. This value is empty if the resource has been deleted.
+   * 
+   * @example
+   * my-agent
+   */
+  resourceName?: string;
+  /**
+   * @remarks
+   * The resource type, such as agent.
+   * 
+   * @example
+   * agent
+   */
+  resourceType?: string;
+  static names(): { [key: string]: string } {
+    return {
+      resourceId: 'resourceId',
+      resourceName: 'resourceName',
+      resourceType: 'resourceType',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      resourceId: 'string',
+      resourceName: 'string',
+      resourceType: 'string',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class CreateCredentialResponseBodyData extends $dara.Model {
   /**
+   * @remarks
+   * The creation time in UTC, formatted in RFC 3339.
+   * 
    * @example
    * 2026-08-12T03:04:05Z
    */
   createdAt?: string;
   /**
+   * @remarks
+   * The credential ID.
+   * 
    * @example
    * cred-123456
    */
   credentialId?: string;
   /**
+   * @remarks
+   * The masked credential content. When credentialType is apiKey, the apiKey value is returned as asterisks (*) of equal length.
+   * 
    * @example
    * {"apiKey":"****************"}
    */
   credentialMetadata?: string;
   /**
+   * @remarks
+   * The credential type. Currently, only apiKey is supported.
+   * 
    * @example
    * apiKey
    */
   credentialType?: string;
   /**
+   * @remarks
+   * The credential description. The description can be up to 256 characters in length.
+   * 
    * @example
-   * 线上环境调用模型服务使用的 API Key
+   * API Key used for calling model services in the production environment
    */
   description?: string;
   /**
+   * @remarks
+   * The credential name. The name must be unique within the workspace and can contain only letters, digits, periods (.), underscores (_), and hyphens (-). The name must be 3 to 128 characters in length and cannot use runtime reserved names.
+   * 
    * @example
    * model-api-key
    */
   name?: string;
   /**
+   * @remarks
+   * The region ID where the resource resides.
+   * 
    * @example
    * cn-hangzhou
    */
   regionId?: string;
   /**
+   * @remarks
+   * Each item contains resourceType, resourceId, and resourceName. resourceName is empty if the resource has been deleted.
+   */
+  resourceRefs?: CreateCredentialResponseBodyDataResourceRefs[];
+  /**
+   * @remarks
+   * The credential resource scope.
+   * 
+   * @example
+   * ALL
+   */
+  resourceScope?: string;
+  /**
+   * @remarks
+   * The time of the last modification in UTC, formatted in RFC 3339.
+   * 
    * @example
    * 2026-08-12T03:04:05Z
    */
   updatedAt?: string;
   /**
+   * @remarks
+   * The workspace ID.
+   * 
    * @example
    * ws-123456
    */
@@ -57,6 +147,8 @@ export class CreateCredentialResponseBodyData extends $dara.Model {
       description: 'description',
       name: 'name',
       regionId: 'regionId',
+      resourceRefs: 'resourceRefs',
+      resourceScope: 'resourceScope',
       updatedAt: 'updatedAt',
       workspaceId: 'workspaceId',
     };
@@ -71,12 +163,17 @@ export class CreateCredentialResponseBodyData extends $dara.Model {
       description: 'string',
       name: 'string',
       regionId: 'string',
+      resourceRefs: { 'type': 'array', 'itemType': CreateCredentialResponseBodyDataResourceRefs },
+      resourceScope: 'string',
       updatedAt: 'string',
       workspaceId: 'string',
     };
   }
 
   validate() {
+    if(Array.isArray(this.resourceRefs)) {
+      $dara.Model.validateArray(this.resourceRefs);
+    }
     super.validate();
   }
 
@@ -87,26 +184,46 @@ export class CreateCredentialResponseBodyData extends $dara.Model {
 
 export class CreateCredentialResponseBody extends $dara.Model {
   /**
+   * @remarks
+   * The business status code.
+   * 
    * @example
    * SUCCESS
    */
   code?: string;
+  /**
+   * @remarks
+   * The created credential information.
+   */
   data?: CreateCredentialResponseBodyData;
   /**
+   * @remarks
+   * The HTTP status code.
+   * 
    * @example
    * 200
    */
   httpStatusCode?: number;
   /**
+   * @remarks
+   * The response message. An error description is returned if the request fails.
+   * 
    * @example
    * success
    */
   message?: string;
   /**
+   * @remarks
+   * The request ID.
+   * 
    * @example
    * request-123456
    */
   requestId?: string;
+  /**
+   * @remarks
+   * Indicates whether the request was successful.
+   */
   success?: boolean;
   static names(): { [key: string]: string } {
     return {

package/src/models/CreateCredentialShrinkRequest.ts

@@ -3,10 +3,17 @@ import * as $dara from '@darabonba/typescript';
 
 
 export class CreateCredentialShrinkRequest extends $dara.Model {
+  /**
+   * @remarks
+   * The request body for creating a credential.
+   */
   bodyShrink?: string;
   /**
+   * @remarks
+   * Not supported.
+   * 
    * @example
-   * 暂不支持
+   * Not supported
    */
   clientToken?: string;
   static names(): { [key: string]: string } {

package/src/models/CreateExternalAgentRequest.ts

@@ -103,6 +103,8 @@ export class CreateExternalAgentRequestBodyTemplateAiRegistry extends $dara.Mode
    * @remarks
    * The version of the template in AI Registry.
    * 
+   * This parameter is required.
+   * 
    * @example
    * 1.0.0
    */
@@ -225,15 +227,15 @@ export class CreateExternalAgentRequestBody extends $dara.Model {
   instruction?: string;
   /**
    * @remarks
-   * The model configuration. This parameter is available only when modelSource is set to PLATFORM.
+   * The model configuration. Available only when modelSource is set to PLATFORM.
    */
   model?: CreateExternalAgentRequestBodyModel;
   /**
    * @remarks
    * The source of the model configuration. Valid values:
    * 
-   * - PLATFORM: The platform parses and delivers the model configuration. You can specify the model parameter.
-   * - RUNTIME: The external runtime manages the model on its own. You cannot specify the model parameter at the same time.
+   * - PLATFORM: The platform parses and delivers the model configuration.
+   * - RUNTIME: The external runtime manages the model on its own. You cannot specify model at the same time.
    * 
    * @example
    * PLATFORM
@@ -319,7 +321,7 @@ export class CreateExternalAgentRequest extends $dara.Model {
   body?: CreateExternalAgentRequestBody;
   /**
    * @remarks
-   * The reserved idempotency token. The backend does not guarantee idempotence in the current version.
+   * The reserved idempotency token. The backend does not provide idempotency guarantees in the current version.
    * 
    * @example
    * client-token-1

package/src/models/CreateExternalAgentResponseBody.ts

@@ -2,86 +2,6 @@
 import * as $dara from '@darabonba/typescript';
 
 
-export class CreateExternalAgentResponseBodyDataEffectiveResult extends $dara.Model {
-  /**
-   * @remarks
-   * The user ID of the agent in Matrix.
-   * 
-   * @example
-   * @agent-1:matrix.example.com
-   */
-  matrixUserId?: string;
-  /**
-   * @remarks
-   * The Matrix personal room ID of the agent.
-   * 
-   * @example
-   * !room:matrix.example.com
-   */
-  personalRoomId?: string;
-  /**
-   * @remarks
-   * The acceptance status of the runtime for the current request version.
-   * 
-   * @example
-   * ACCEPTED
-   */
-  runtimeAcceptStatus?: string;
-  /**
-   * @remarks
-   * The runtime instance ID.
-   * 
-   * @example
-   * runtime-123
-   */
-  runtimeId?: string;
-  /**
-   * @remarks
-   * The runtime request version number.
-   * 
-   * @example
-   * 5
-   */
-  runtimeRequestVersion?: number;
-  /**
-   * @remarks
-   * The storage prefix of the agent in the workspace.
-   * 
-   * @example
-   * agents/agent-1
-   */
-  workspacePrefix?: string;
-  static names(): { [key: string]: string } {
-    return {
-      matrixUserId: 'matrixUserId',
-      personalRoomId: 'personalRoomId',
-      runtimeAcceptStatus: 'runtimeAcceptStatus',
-      runtimeId: 'runtimeId',
-      runtimeRequestVersion: 'runtimeRequestVersion',
-      workspacePrefix: 'workspacePrefix',
-    };
-  }
-
-  static types(): { [key: string]: any } {
-    return {
-      matrixUserId: 'string',
-      personalRoomId: 'string',
-      runtimeAcceptStatus: 'string',
-      runtimeId: 'string',
-      runtimeRequestVersion: 'number',
-      workspacePrefix: 'string',
-    };
-  }
-
-  validate() {
-    super.validate();
-  }
-
-  constructor(map?: { [key: string]: any }) {
-    super(map);
-  }
-}
-
 export class CreateExternalAgentResponseBodyDataExternalAgentStatus extends $dara.Model {
   /**
    * @remarks
@@ -96,7 +16,7 @@ export class CreateExternalAgentResponseBodyDataExternalAgentStatus extends $dar
   heartbeatStatus?: string;
   /**
    * @remarks
-   * The most recent active time of the external agent in RFC 3339 format.
+   * The last active time of the external agent in RFC 3339 format.
    * 
    * @example
    * 2026-01-01T00:00:00Z
@@ -104,7 +24,7 @@ export class CreateExternalAgentResponseBodyDataExternalAgentStatus extends $dar
   lastActiveAt?: string;
   /**
    * @remarks
-   * The most recent heartbeat time of the external agent in RFC 3339 format.
+   * The last heartbeat time of the external agent in RFC 3339 format.
    * 
    * @example
    * 2026-01-01T00:00:00Z
@@ -256,6 +176,8 @@ export class CreateExternalAgentResponseBodyDataTemplateAiRegistry extends $dara
    * @remarks
    * The version of the template in AI Registry.
    * 
+   * This parameter is required.
+   * 
    * @example
    * 1.0.0
    */
@@ -400,19 +322,6 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
    * A code review agent running in the user environment
    */
   description?: string;
-  /**
-   * @remarks
-   * The runtime result corresponding to the currently effective specification.
-   */
-  effectiveResult?: CreateExternalAgentResponseBodyDataEffectiveResult;
-  /**
-   * @remarks
-   * The currently effective specification version number.
-   * 
-   * @example
-   * 1
-   */
-  effectiveSpecVersion?: number;
   /**
    * @remarks
    * The runtime status information reported by the external agent.
@@ -437,8 +346,8 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   /**
    * @remarks
    * The processing status of the latest specification version. Valid values:
-   * - pending: Pending processing.
-   * - processing: Being processed.
+   * - pending: Pending.
+   * - processing: Processing.
    * - waiting_retry: Waiting for retry.
    * - succeeded: Succeeded.
    * - failed: Failed.
@@ -450,15 +359,15 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   latestVersionStatus?: string;
   /**
    * @remarks
-   * The model configuration. This parameter is available only when modelSource is set to PLATFORM.
+   * The model configuration. Available only when modelSource is set to PLATFORM.
    */
   model?: CreateExternalAgentResponseBodyDataModel;
   /**
    * @remarks
    * The source of the model configuration. Valid values:
    * 
-   * - PLATFORM: The platform parses and delivers the model configuration. You can specify the model parameter.
-   * - RUNTIME: The external runtime manages the model on its own. You cannot specify the model parameter at the same time.
+   * - PLATFORM: The platform parses and delivers the model configuration.
+   * - RUNTIME: The external runtime manages the model on its own. You cannot specify model at the same time.
    * 
    * @example
    * PLATFORM
@@ -495,13 +404,13 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   skills?: CreateExternalAgentResponseBodyDataSkills[];
   /**
    * @remarks
-   * The status of the external agent. Valid values:
-   * - Creating: The agent is being created.
-   * - Running: The agent is running.
-   * - Failed: The agent creation failed.
-   * - Updating: The agent is being updated.
-   * - Deleting: The agent is being deleted.
-   * - Deleted: The agent has been deleted.
+   * The external agent status. Valid values:
+   * - Creating: Being created.
+   * - Running: Running.
+   * - Failed: Failed.
+   * - Updating: Being updated.
+   * - Deleting: Being deleted.
+   * - Deleted: Deleted.
    * 
    * @example
    * Running
@@ -540,8 +449,6 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
       createdAt: 'createdAt',
       deployType: 'deployType',
       description: 'description',
-      effectiveResult: 'effectiveResult',
-      effectiveSpecVersion: 'effectiveSpecVersion',
       externalAgentStatus: 'externalAgentStatus',
       instruction: 'instruction',
       latestSpecVersion: 'latestSpecVersion',
@@ -567,8 +474,6 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
       createdAt: 'string',
       deployType: 'string',
       description: 'string',
-      effectiveResult: CreateExternalAgentResponseBodyDataEffectiveResult,
-      effectiveSpecVersion: 'number',
       externalAgentStatus: CreateExternalAgentResponseBodyDataExternalAgentStatus,
       instruction: 'string',
       latestSpecVersion: 'number',
@@ -588,9 +493,6 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
   }
 
   validate() {
-    if(this.effectiveResult && typeof (this.effectiveResult as any).validate === 'function') {
-      (this.effectiveResult as any).validate();
-    }
     if(this.externalAgentStatus && typeof (this.externalAgentStatus as any).validate === 'function') {
       (this.externalAgentStatus as any).validate();
     }
@@ -617,7 +519,7 @@ export class CreateExternalAgentResponseBodyData extends $dara.Model {
 export class CreateExternalAgentResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The business status code. The value SUCCESS indicates success.
+   * The business status code. The value is SUCCESS when the request succeeds.
    * 
    * @example
    * SUCCESS
@@ -625,12 +527,12 @@ export class CreateExternalAgentResponseBody extends $dara.Model {
   code?: string;
   /**
    * @remarks
-   * The information about the external agent after creation.
+   * The information about the created external agent.
    */
   data?: CreateExternalAgentResponseBodyData;
   /**
    * @remarks
-   * The HTTP status code. The value 200 indicates success.
+   * The HTTP status code. The value is 200 when the request succeeds.
    * 
    * @example
    * 200
@@ -638,7 +540,7 @@ export class CreateExternalAgentResponseBody extends $dara.Model {
   httpStatusCode?: number;
   /**
    * @remarks
-   * The result message of the request processing.
+   * The message that indicates the result of the request.
    * 
    * @example
    * success

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 guarantee idempotence in the current version.
+   * The reserved idempotency token. The backend does not provide idempotency guarantees in the current version.
    * 
    * @example
    * client-token-1