@alicloud/agentcore20260804 2.0.0 → 2.1.0

package/src/models/ListConnectorModelsResponseBody.ts

@@ -8,7 +8,7 @@ export class ListConnectorModelsResponseBodyItems extends $dara.Model {
    * The description of the model.
    * 
    * @example
-   * 通义千问旗舰模型
+   * Qwen flagship model
    */
   description?: string;
   /**
@@ -21,7 +21,7 @@ export class ListConnectorModelsResponseBodyItems extends $dara.Model {
   displayName?: string;
   /**
    * @remarks
-   * Key ID
+   * The associated Connector Key ID. This field is not returned in the current version.
    * 
    * @example
    * ckey-xxxx
@@ -29,7 +29,7 @@ export class ListConnectorModelsResponseBodyItems extends $dara.Model {
   keyId?: string;
   /**
    * @remarks
-   * The key name.
+   * The associated Connector Key name. This field is not returned in the current version.
    * 
    * @example
    * default
@@ -45,9 +45,7 @@ export class ListConnectorModelsResponseBodyItems extends $dara.Model {
   modelId?: string;
   /**
    * @remarks
-   * The source of the model. Valid values:
-   * - official: an official model.
-   * - enterprise: an enterprise-specific model.
+   * The source of the model.
    * 
    * @example
    * official
@@ -108,7 +106,7 @@ export class ListConnectorModelsResponseBody extends $dara.Model {
   items?: ListConnectorModelsResponseBodyItems[];
   /**
    * @remarks
-   * The number of entries returned in this request.
+   * The number of models returned in this request.
    * 
    * @example
    * 10
@@ -124,7 +122,7 @@ export class ListConnectorModelsResponseBody extends $dara.Model {
   message?: string;
   /**
    * @remarks
-   * The pagination token for the next page.
+   * The next page token. This field is not returned in the current version.
    * 
    * @example
    * dGVzdA==
@@ -148,7 +146,7 @@ export class ListConnectorModelsResponseBody extends $dara.Model {
   success?: boolean;
   /**
    * @remarks
-   * The total number of models.
+   * The total number of models returned.
    * 
    * @example
    * 100

package/src/models/ListConnectorsRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListConnectorsRequest extends $dara.Model {
   /**
    * @remarks
-   * The number of entries per page.
+   * The page size. The current version does not support this parameter.
    * 
    * @example
    * 10
@@ -13,7 +13,7 @@ export class ListConnectorsRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The pagination token for the next page.
+   * The next page token. The current version does not support this parameter.
    * 
    * @example
    * dGVzdA==

package/src/models/ListConnectorsResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListConnectorsResponseBodyItems extends $dara.Model {
   /**
    * @remarks
-   * The number of agents bound to the connector.
+   * The number of bound agents.
    * 
    * @example
    * 3
@@ -21,7 +21,7 @@ export class ListConnectorsResponseBodyItems extends $dara.Model {
   enabledAt?: string;
   /**
    * @remarks
-   * A JSON string. qodercli: {"site":"global|cn","organizationId":"...","apiKey":"...","serviceAccountKeys":[{"id":"ckey-xxx","name":"default","serviceAccountKey":"..."}]}. This field is absent when the connector is not enabled.
+   * The connector configuration JSON string. After the connector is enabled, this string may contain sensitive credentials.
    * 
    * @example
    * {"site":"global","organizationId":"org-xxxx"}
@@ -29,7 +29,7 @@ export class ListConnectorsResponseBodyItems extends $dara.Model {
   metadata?: string;
   /**
    * @remarks
-   * The connector name.
+   * The connector name. The current value is qodercli.
    * 
    * @example
    * qodercli
@@ -96,7 +96,7 @@ export class ListConnectorsResponseBody extends $dara.Model {
   items?: ListConnectorsResponseBodyItems[];
   /**
    * @remarks
-   * The number of entries returned in this request.
+   * The number of connectors returned in this request.
    * 
    * @example
    * 10
@@ -112,7 +112,7 @@ export class ListConnectorsResponseBody extends $dara.Model {
   message?: string;
   /**
    * @remarks
-   * The pagination token for the next page.
+   * The next page token. The current version does not return this field.
    * 
    * @example
    * dGVzdA==
@@ -136,7 +136,7 @@ export class ListConnectorsResponseBody extends $dara.Model {
   success?: boolean;
   /**
    * @remarks
-   * The total number of connectors.
+   * The total number of connectors returned.
    * 
    * @example
    * 10

package/src/models/ListCredentialsResponseBody.ts

@@ -124,7 +124,7 @@ export class ListCredentialsResponseBodyItems extends $dara.Model {
   resourceRefs?: ListCredentialsResponseBodyItemsResourceRefs[];
   /**
    * @remarks
-   * The scope of resources to which the credential can be applied.
+   * The resource scope of the credential.
    * 
    * @example
    * ALL
@@ -216,7 +216,7 @@ export class ListCredentialsResponseBody extends $dara.Model {
   items?: ListCredentialsResponseBodyItems[];
   /**
    * @remarks
-   * The maximum number of records per page that took effect for this query.
+   * The maximum number of records per page that takes effect for this query.
    * 
    * @example
    * 10

package/src/models/ListIdentityProvidersResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class ListIdentityProvidersResponseBodyItemsMetadata extends $dara.Model {
   /**
    * @remarks
-   * The App ID of the Lark application. Required when the binding type is Feishu.
+   * The App ID of the Lark application. This parameter is required when the binding type is Feishu.
    * 
    * @example
    * cli_exampleappid01
@@ -13,7 +13,7 @@ export class ListIdentityProvidersResponseBodyItemsMetadata extends $dara.Model
   appId?: string;
   /**
    * @remarks
-   * The AppKey of the DingTalk application. Required when the binding type is DingTalk.
+   * The AppKey of the DingTalk application. This parameter is required when the binding type is DingTalk.
    * 
    * @example
    * dingexampleappkey01
@@ -21,7 +21,7 @@ export class ListIdentityProvidersResponseBodyItemsMetadata extends $dara.Model
   appKey?: string;
   /**
    * @remarks
-   * The CorpId of the DingTalk enterprise. Required when the binding type is DingTalk.
+   * The CorpId of the DingTalk organization. This parameter is required when the binding type is DingTalk.
    * 
    * @example
    * dingexamplecorpid01
@@ -63,7 +63,7 @@ export class ListIdentityProvidersResponseBodyItems extends $dara.Model {
   createdAt?: string;
   /**
    * @remarks
-   * The event subscription callback URL. Configure this URL in the external identity provider application to receive organization change events. An empty string is returned if the user pool has not been provisioned.
+   * The event subscription callback URL. Configure this URL in the external identity provider application to receive organization change events. An empty string is returned if the user pool has not been activated.
    * 
    * @example
    * http://auth.cn-hangzhou.agentteams.aliyuncs.com/roa/dingtalk/event/up-123456
@@ -71,9 +71,7 @@ export class ListIdentityProvidersResponseBodyItems extends $dara.Model {
   eventSubscriptionCallbackUrl?: string;
   /**
    * @remarks
-   * The type of the external identity provider. Valid values:
-   * - DingTalk
-   * - Feishu
+   * The type of the external identity provider. Valid values: DingTalk, Feishu.
    * 
    * @example
    * DingTalk
@@ -81,7 +79,7 @@ export class ListIdentityProvidersResponseBodyItems extends $dara.Model {
   identityProviderType?: string;
   /**
    * @remarks
-   * The logon callback URL. Configure this URL in the external identity provider application. An empty string is returned if the user pool has not been provisioned.
+   * The logon callback URL. Configure this URL in the external identity provider application. An empty string is returned if the user pool has not been activated.
    * 
    * @example
    * https://signin-cn-hangzhou.aliyunagentid.com/up-123456/dingtalk/callback
@@ -99,16 +97,7 @@ export class ListIdentityProvidersResponseBodyItems extends $dara.Model {
   metadata?: ListIdentityProvidersResponseBodyItemsMetadata;
   /**
    * @remarks
-   * The binding status. Valid values:
-   * - CONFIGURED: The configuration has been accepted and is waiting for user pool provisioning.
-   * - SYNCING: Organization members are being synchronized.
-   * - SYNCED: Organization member synchronization is complete.
-   * - READY: The binding is active.
-   * - SYNC_FAILED: Organization member synchronization failed.
-   * - UPDATING: The configuration is being updated.
-   * - UPDATE_FAILED: The configuration update failed.
-   * - DISCONNECTING: The binding is being removed.
-   * - DISCONNECT_FAILED: The unbinding failed.
+   * The binding status. Valid values: CONFIGURED (The configuration has been accepted and the user pool is pending activation.), SYNCING (Organization members are being synchronized.), SYNCED (Organization member synchronization is complete.), READY (The binding is active.), SYNC_FAILED (Organization member synchronization failed.), UPDATING (The configuration is being updated.), UPDATE_FAILED (The configuration update failed.), DISCONNECTING (The binding is being removed.), DISCONNECT_FAILED (The unbinding failed.).
    * 
    * @example
    * READY
@@ -116,12 +105,12 @@ export class ListIdentityProvidersResponseBodyItems extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * Indicates whether organization member synchronization is enabled. When enabled, organization members are synchronized from this external identity provider as workspace users.
+   * Indicates whether organization member synchronization is enabled. When enabled, the external identity provider synchronizes organization members as workspace users.
    */
   syncEnabled?: boolean;
   /**
    * @remarks
-   * The last modification time in UTC, formatted according to RFC 3339.
+   * The time of the last modification in UTC, formatted according to RFC 3339.
    * 
    * @example
    * 2026-08-12T03:04:05Z
@@ -201,7 +190,7 @@ export class ListIdentityProvidersResponseBody extends $dara.Model {
   items?: ListIdentityProvidersResponseBodyItems[];
   /**
    * @remarks
-   * The maximum number of records per page that takes effect for this query.
+   * The maximum number of records per page that took effect for this query.
    * 
    * @example
    * 10
@@ -209,7 +198,7 @@ export class ListIdentityProvidersResponseBody extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The response message. An error description is returned if the request fails.
+   * The response message. An error description is returned if the request failed.
    * 
    * @example
    * success
@@ -217,7 +206,7 @@ export class ListIdentityProvidersResponseBody extends $dara.Model {
   message?: string;
   /**
    * @remarks
-   * The pagination token for the next page. This parameter is empty if no more pages exist.
+   * The pagination token for the next page. This parameter is empty if no more pages are available.
    * 
    * @example
    * aWRlbnRpdHktcHJvdmlkZXItb2Zmc2V0OjEw

package/src/models/ListManagedAgentsResponseBody.ts

@@ -13,7 +13,7 @@ export class ListManagedAgentsResponseBodyItemsHarnessConfiguration extends $dar
   connectorServiceAccountKey?: string;
   /**
    * @remarks
-   * The Connector Key name populated during queries. This parameter is not used as a binding reference during writes.
+   * The Connector Key name populated during queries. This value is not used as a binding reference during writes.
    * 
    * @example
    * my-connector-key
@@ -154,13 +154,7 @@ export class ListManagedAgentsResponseBodyItems extends $dara.Model {
   runtime?: string;
   /**
    * @remarks
-   * The status of the managed agent. Valid values:
-   * - Creating: Being created.
-   * - Failed: Failed.
-   * - Running: Running.
-   * - Updating: Being updated.
-   * - Deleted: Deleted.
-   * - Deleting: Being deleted.
+   * The status of the managed agent.
    * 
    * @example
    * Running
@@ -271,7 +265,7 @@ export class ListManagedAgentsResponseBody extends $dara.Model {
   message?: string;
   /**
    * @remarks
-   * The token for the next page. An empty value indicates that the last page has been reached.
+   * The token for the next page. An empty value indicates the last page.
    * 
    * @example
    * next-token-1

package/src/models/ListSandboxSessionsRequest.ts

@@ -13,7 +13,10 @@ export class ListSandboxSessionsRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The cursor used to query the next page.
+   * The pagination token for querying the next page.
+   * 
+   * @example
+   * next-token-1
    */
   nextToken?: string;
   static names(): { [key: string]: string } {

package/src/models/ListSandboxSessionsResponseBody.ts

@@ -6,9 +6,30 @@ export class ListSandboxSessionsResponseBodyItems extends $dara.Model {
   /**
    * @remarks
    * The external channel type, such as DINGTALK, FEISHU, or WECOM. This parameter is empty for non-external channels.
+   * 
+   * @example
+   * DINGTALK
    */
   channelType?: string;
+  /**
+   * @remarks
+   * The unique identifier of the active session.
+   * 
+   * @example
+   * sess-2
+   */
   sessionId?: string;
+  /**
+   * @remarks
+   * The session source type. Valid values:
+   * - API: API call.
+   * - CONSOLE_DEBUG: Console debugging.
+   * - EXTERNAL_CHANNEL: External channel.
+   * - UNKNOWN: Unknown source.
+   * 
+   * @example
+   * EXTERNAL_CHANNEL
+   */
   sourceType?: string;
   static names(): { [key: string]: string } {
     return {
@@ -36,14 +57,73 @@ export class ListSandboxSessionsResponseBodyItems extends $dara.Model {
 }
 
 export class ListSandboxSessionsResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * The business status code. The value SUCCESS is returned if the request was successful.
+   * 
+   * @example
+   * SUCCESS
+   */
   code?: string;
+  /**
+   * @remarks
+   * The HTTP status code. The value 200 is returned if the request was successful.
+   * 
+   * @example
+   * 200
+   */
   httpStatusCode?: number;
+  /**
+   * @remarks
+   * The list of active sessions in the sandbox.
+   */
   items?: ListSandboxSessionsResponseBodyItems[];
+  /**
+   * @remarks
+   * The maximum number of records per page for this query.
+   * 
+   * @example
+   * 20
+   */
   maxResults?: number;
+  /**
+   * @remarks
+   * The response message. The value success is returned if the request was successful.
+   * 
+   * @example
+   * success
+   */
   message?: string;
+  /**
+   * @remarks
+   * The pagination token for the next page. An empty value indicates that no more results are available.
+   * 
+   * @example
+   * next-token-1
+   */
   nextToken?: string;
+  /**
+   * @remarks
+   * The request ID, which is used to locate and troubleshoot issues.
+   * 
+   * @example
+   * 1a2b3c4d-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+   */
   requestId?: string;
+  /**
+   * @remarks
+   * Indicates whether the request was successful. Valid values:
+   * - true: The request was successful.
+   * - false: The request failed.
+   */
   success?: boolean;
+  /**
+   * @remarks
+   * The total number of records that match the query conditions.
+   * 
+   * @example
+   * 27
+   */
   totalCount?: number;
   static names(): { [key: string]: string } {
     return {

package/src/models/ListSandboxesRequest.ts

@@ -13,12 +13,15 @@ export class ListSandboxesRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The pagination token for the next page. When paginating, keep workspaceId, agentId, searchText, sessionId, and maxResults unchanged.
+   * The pagination token for querying the next page. When paginating, keep workspaceId, agentId, searchText, sessionId, and maxResults unchanged.
+   * 
+   * @example
+   * next-token-1
    */
   nextToken?: string;
   /**
    * @remarks
-   * When explicitly specified, this parameter cannot be empty or consist entirely of whitespace. The value can contain up to 36 characters and allows only hexadecimal characters and hyphens. This parameter can be used together with sessionId, combined with AND logic.
+   * Performs a case-insensitive fuzzy search by sandbox ID fragment.
    * 
    * @example
    * 2f360
@@ -26,7 +29,7 @@ export class ListSandboxesRequest extends $dara.Model {
   searchText?: string;
   /**
    * @remarks
-   * When explicitly specified, this parameter cannot be empty or consist entirely of whitespace. The value must be valid UTF-8 of 1 to 128 bytes and cannot contain forward slashes (/), vertical bars (|), control characters, or format characters. The original case and leading/trailing spaces are preserved. This parameter can be used together with searchText, combined with AND logic.
+   * Performs a case-insensitive fuzzy search by active session ID fragment.
    * 
    * @example
    * session-a

package/src/models/ListSandboxesResponseBody.ts

@@ -3,12 +3,61 @@ import * as $dara from '@darabonba/typescript';
 
 
 export class ListSandboxesResponseBodyItems extends $dara.Model {
+  /**
+   * @remarks
+   * The number of active sessions for this sandbox.
+   * 
+   * @example
+   * 1
+   */
   activeSessionCount?: number;
+  /**
+   * @remarks
+   * The time when the sandbox was created, in RFC 3339 UTC format.
+   * 
+   * @example
+   * 2026-08-29T00:00:00Z
+   */
   createdAt?: string;
+  /**
+   * @remarks
+   * The time of the last activity on the sandbox, in RFC 3339 UTC format.
+   * 
+   * @example
+   * 2026-08-29T00:02:00Z
+   */
   lastActiveAt?: string;
+  /**
+   * @remarks
+   * The time of the last heartbeat from the sandbox, in RFC 3339 UTC format.
+   * 
+   * @example
+   * 2026-08-29T00:01:00Z
+   */
   lastHeartbeatAt?: string;
+  /**
+   * @remarks
+   * The maximum number of concurrent sessions allowed for this sandbox, derived from the auto scaling configuration in effect at runtime. This value is empty if auto scaling is not enabled or the configuration is unavailable.
+   * 
+   * @example
+   * 7
+   */
   maxConcurrentSessions?: number;
+  /**
+   * @remarks
+   * The current running phase of the sandbox.
+   * 
+   * @example
+   * RUNNING
+   */
   phase?: string;
+  /**
+   * @remarks
+   * The sandbox ID. You can call the ListSandboxes operation to query sandbox IDs.
+   * 
+   * @example
+   * sbx-2
+   */
   sandboxId?: string;
   static names(): { [key: string]: string } {
     return {
@@ -44,14 +93,73 @@ export class ListSandboxesResponseBodyItems extends $dara.Model {
 }
 
 export class ListSandboxesResponseBody extends $dara.Model {
+  /**
+   * @remarks
+   * The business status code. The value SUCCESS is returned if the request was successful.
+   * 
+   * @example
+   * SUCCESS
+   */
   code?: string;
+  /**
+   * @remarks
+   * The HTTP status code. The value 200 is returned if the request was successful.
+   * 
+   * @example
+   * 200
+   */
   httpStatusCode?: number;
+  /**
+   * @remarks
+   * The list of sandboxes that match the filter conditions.
+   */
   items?: ListSandboxesResponseBodyItems[];
+  /**
+   * @remarks
+   * The maximum number of records per page for this query.
+   * 
+   * @example
+   * 20
+   */
   maxResults?: number;
+  /**
+   * @remarks
+   * The response message. The value success is returned if the request was successful.
+   * 
+   * @example
+   * success
+   */
   message?: string;
+  /**
+   * @remarks
+   * The pagination token for the next page. An empty value indicates that no more results are available.
+   * 
+   * @example
+   * next-token-1
+   */
   nextToken?: string;
+  /**
+   * @remarks
+   * The request ID, which is used to locate and troubleshoot issues.
+   * 
+   * @example
+   * 1a2b3c4d-xxxx-xxxx-xxxx-xxxxxxxxxxxx
+   */
   requestId?: string;
+  /**
+   * @remarks
+   * Indicates whether the request was successful. Valid values:
+   * - true: The request was successful.
+   * - false: The request failed.
+   */
   success?: boolean;
+  /**
+   * @remarks
+   * The total number of records that match the query conditions.
+   * 
+   * @example
+   * 27
+   */
   totalCount?: number;
   static names(): { [key: string]: string } {
     return {

package/src/models/ListServiceEndpointsRequest.ts

@@ -37,7 +37,7 @@ export class ListServiceEndpointsRequest extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The pagination token for the next page. Do not specify this parameter for the first request. For subsequent requests, specify the nextToken value returned in the previous response.
+   * The pagination token for the next page. Do not specify this parameter for the first request. For subsequent requests, set this parameter to the nextToken value returned in the previous response.
    * 
    * @example
    * djE6YWdlbnRjb3JlLnNlcnZpY2UtZW5kcG9pbnQubGlzdDoyMA

package/src/models/ListServiceEndpointsResponseBody.ts

@@ -95,7 +95,7 @@ export class ListServiceEndpointsResponseBodyItemsAuthentication extends $dara.M
 export class ListServiceEndpointsResponseBodyItemsTarget extends $dara.Model {
   /**
    * @remarks
-   * The target agent ID. This parameter is returned when the target type is AGENT_VERSION.
+   * The target agent ID. Returned when the target type is AGENT_VERSION.
    * 
    * @example
    * agent-123456
@@ -103,7 +103,7 @@ export class ListServiceEndpointsResponseBodyItemsTarget extends $dara.Model {
   agentId?: string;
   /**
    * @remarks
-   * The target agent version number. This parameter is returned when the target type is AGENT_VERSION.
+   * The target agent version number. Returned when the target type is AGENT_VERSION.
    * 
    * @example
    * v1
@@ -111,7 +111,7 @@ export class ListServiceEndpointsResponseBodyItemsTarget extends $dara.Model {
   agentVersion?: string;
   /**
    * @remarks
-   * The collaboration component type. This parameter is returned when the target type is TEAM_COLLABORATION.
+   * The collaboration component type. Returned when the target type is TEAM_COLLABORATION.
    * 
    * @example
    * ELEMENT_WEB
@@ -119,7 +119,7 @@ export class ListServiceEndpointsResponseBodyItemsTarget extends $dara.Model {
   collaborationComponent?: string;
   /**
    * @remarks
-   * The workspace resource binding ID associated with the target collaboration component. This parameter is returned when the target type is TEAM_COLLABORATION.
+   * The workspace resource binding ID associated with the target collaboration component. Returned when the target type is TEAM_COLLABORATION.
    * 
    * @example
    * wrb-123456
@@ -175,7 +175,7 @@ export class ListServiceEndpointsResponseBodyItems extends $dara.Model {
   authentication?: ListServiceEndpointsResponseBodyItemsAuthentication;
   /**
    * @remarks
-   * The creation time in UTC, formatted according to RFC 3339.
+   * The creation time in UTC, formatted in RFC 3339.
    * 
    * @example
    * 2026-08-12T03:04:05Z
@@ -199,7 +199,7 @@ export class ListServiceEndpointsResponseBodyItems extends $dara.Model {
   name?: string;
   /**
    * @remarks
-   * The region ID where the service endpoint is located.
+   * The region ID of the service endpoint.
    * 
    * @example
    * cn-hangzhou
@@ -236,7 +236,7 @@ export class ListServiceEndpointsResponseBodyItems extends $dara.Model {
   target?: ListServiceEndpointsResponseBodyItemsTarget;
   /**
    * @remarks
-   * The last modification time in UTC, formatted according to RFC 3339.
+   * The time of the last modification in UTC, formatted in RFC 3339.
    * 
    * @example
    * 2026-08-12T03:04:05Z
@@ -334,7 +334,7 @@ export class ListServiceEndpointsResponseBody extends $dara.Model {
   maxResults?: number;
   /**
    * @remarks
-   * The response message. An error description is returned if the request fails.
+   * The response message. An error description is returned when the request fails.
    * 
    * @example
    * success
@@ -342,7 +342,7 @@ export class ListServiceEndpointsResponseBody extends $dara.Model {
   message?: string;
   /**
    * @remarks
-   * The pagination token for the next page. This value is empty if no more pages exist.
+   * The pagination token for the next page. This value is empty when no more pages are available.
    * 
    * @example
    * djE6YWdlbnRjb3JlLnNlcnZpY2UtZW5kcG9pbnQubGlzdDoyMA