@alicloud/agentcore20260804 2.0.0 → 2.1.0

package/src/models/CreateWorkspaceRequest.ts

@@ -100,6 +100,15 @@ export class CreateWorkspaceRequestBody extends $dara.Model {
    * The network configuration of the workspace.
    */
   networkConfiguration?: CreateWorkspaceRequestBodyNetworkConfiguration;
+  /**
+   * @remarks
+   * The storage type of the workspace. Valid values:
+   * - PLATFORM: Platform-managed storage.
+   * - PRIVATE: User-owned private OSS storage.
+   * 
+   * @example
+   * PRIVATE
+   */
   storageType?: string;
   static names(): { [key: string]: string } {
     return {

package/src/models/CreateWorkspaceResponseBody.ts

@@ -129,7 +129,7 @@ export class CreateWorkspaceResponseBodyDataTags extends $dara.Model {
 export class CreateWorkspaceResponseBodyData extends $dara.Model {
   /**
    * @remarks
-   * The AI Registry namespace ID. This value is returned after the related resource binding is complete and may be empty during initialization.
+   * The AI Registry namespace ID. This value is returned after the related resources are bound. It may be empty during initialization.
    * 
    * @example
    * namespace-0123456789abcdef
@@ -141,16 +141,22 @@ export class CreateWorkspaceResponseBodyData extends $dara.Model {
   /**
    * @remarks
    * The OSS storage authorization status.
+   * 
+   * @example
+   * AUTHORIZED
    */
   authorizationStatus?: string;
   /**
    * @remarks
    * The name of the private OSS bucket.
+   * 
+   * @example
+   * bucket-001
    */
   bucketName?: string;
   /**
    * @remarks
-   * The CloudMonitor workspace ID. This value is returned after the related resource binding is complete and may be empty during initialization.
+   * The CloudMonitor workspace ID. This value is returned after the related resources are bound. It may be empty during initialization.
    * 
    * @example
    * cms-ws-0123456789abcdef
@@ -161,7 +167,7 @@ export class CreateWorkspaceResponseBodyData extends $dara.Model {
   cmsWorkspaceId?: string;
   /**
    * @remarks
-   * The time when the workspace was created, in ISO-8601 format.
+   * The time when the workspace was created, in ISO 8601 format.
    * 
    * This parameter is required.
    * 
@@ -211,7 +217,7 @@ export class CreateWorkspaceResponseBodyData extends $dara.Model {
   status?: string;
   /**
    * @remarks
-   * The supplementary reason for the current workspace status. This value is used to display the specific reason when initialization fails or authorization is pending, and may be empty under normal conditions.
+   * The supplementary reason for the current workspace status. This value is used to display the specific reason when initialization fails or authorization is pending. It may be empty under normal conditions.
    * 
    * @example
    * Waiting for OSS RAM authorization
@@ -223,6 +229,9 @@ export class CreateWorkspaceResponseBodyData extends $dara.Model {
   /**
    * @remarks
    * The storage type of the workspace.
+   * 
+   * @example
+   * PRIVATE
    */
   storageType?: string;
   /**

package/src/models/DeleteAgentImchannelRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DeleteAgentIMChannelRequest extends $dara.Model {
   /**
    * @remarks
-   * A reserved idempotence token. The backend does not provide persistent idempotence guarantee in the current version.
+   * The reserved idempotence token. The backend does not provide persistent idempotence guarantee in the current version.
    * 
    * @example
    * client-token-1

package/src/models/DisableConnectorResponseBody.ts

@@ -21,7 +21,7 @@ export class DisableConnectorResponseBodyData extends $dara.Model {
   enabledAt?: string;
   /**
    * @remarks
-   * A JSON string. For qodercli: {"site":"global|cn","organizationId":"...","apiKey":"...","serviceAccountKeys":[{"id":"ckey-xxx","name":"default","serviceAccountKey":"..."}]}. This field is empty when the Connector is not enabled.
+   * The Connector configuration JSON string before the Connector was disabled. This is sensitive data.
    * 
    * @example
    * {"site":"global","organizationId":"org-xxxx"}
@@ -29,7 +29,7 @@ export class DisableConnectorResponseBodyData extends $dara.Model {
   metadata?: string;
   /**
    * @remarks
-   * The Connector name.
+   * The Connector name. Currently, the value is qodercli.
    * 
    * @example
    * qodercli

package/src/models/DownloadAgentSpecViaOssRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DownloadAgentSpecViaOssRequest extends $dara.Model {
   /**
    * @remarks
-   * The version number. If not specified, the version corresponding to the latest label is downloaded.
+   * The version number. If this parameter is not specified, the version corresponding to the latest label is downloaded.
    * 
    * @example
    * 1.0.0

package/src/models/DownloadAgentSpecViaOssResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class DownloadAgentSpecViaOssResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The response data.
+   * The returned data.
    * 
    * @example
    * https://example.com/artifacts/example.zip

package/src/models/EnableConnectorRequest.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class EnableConnectorRequestBody extends $dara.Model {
   /**
    * @remarks
-   * A JSON string. qodercli uses apiKey. This field is write-only and is not returned in responses.
+   * The Connector configuration JSON string. Set site to global or cn. apiKey is required. serviceAccountKeys must contain at least one named service account key. organizationId is optional.
    * 
    * This parameter is required.
    * 

package/src/models/EnableConnectorResponseBody.ts

@@ -5,7 +5,7 @@ import * as $dara from '@darabonba/typescript';
 export class EnableConnectorResponseBodyData extends $dara.Model {
   /**
    * @remarks
-   * The number of agents attached to the Connector.
+   * The number of bound agents.
    * 
    * @example
    * 3
@@ -21,7 +21,7 @@ export class EnableConnectorResponseBodyData extends $dara.Model {
   enabledAt?: string;
   /**
    * @remarks
-   * A JSON string. For qodercli: {"site":"global|cn","organizationId":"...","apiKey":"...","serviceAccountKeys":[{"id":"ckey-xxx","name":"default","serviceAccountKey":"..."}]}. This field is empty when the Connector is not enabled.
+   * The Connector configuration JSON string. This is sensitive information.
    * 
    * @example
    * {"site":"global","organizationId":"org-xxxx"}
@@ -29,7 +29,7 @@ export class EnableConnectorResponseBodyData extends $dara.Model {
   metadata?: string;
   /**
    * @remarks
-   * The Connector name.
+   * The Connector name. The current value is qodercli.
    * 
    * @example
    * qodercli
@@ -112,7 +112,7 @@ export class EnableConnectorResponseBody extends $dara.Model {
   requestId?: string;
   /**
    * @remarks
-   * Indicates whether the request is successful.
+   * Indicates whether the request was successful.
    * 
    * @example
    * true

package/src/models/GetExternalAgentResponseBody.ts

@@ -16,7 +16,7 @@ export class GetExternalAgentResponseBodyDataExternalAgentStatus extends $dara.M
   heartbeatStatus?: string;
   /**
    * @remarks
-   * The last active time of the external agent in RFC 3339 format.
+   * The most recent active time of the external agent in RFC 3339 format.
    * 
    * @example
    * 2026-01-01T00:00:00Z
@@ -24,7 +24,7 @@ export class GetExternalAgentResponseBodyDataExternalAgentStatus extends $dara.M
   lastActiveAt?: string;
   /**
    * @remarks
-   * The last heartbeat time of the external agent in RFC 3339 format.
+   * The most recent heartbeat time of the external agent in RFC 3339 format.
    * 
    * @example
    * 2026-01-01T00:00:00Z
@@ -75,13 +75,101 @@ export class GetExternalAgentResponseBodyDataExternalAgentStatus extends $dara.M
   }
 }
 
+export class GetExternalAgentResponseBodyDataModelQuota extends $dara.Model {
+  /**
+   * @remarks
+   * Indicates whether the quota is enabled. This parameter is not returned if no quota is configured.
+   * 
+   * @example
+   * true
+   */
+  enabled?: boolean;
+  /**
+   * @remarks
+   * The quota limit type. Currently, only token is supported.
+   * 
+   * @example
+   * token
+   */
+  limitType?: string;
+  /**
+   * @remarks
+   * Indicates whether the quota has been exceeded in the current cycle. This is a read-only field returned by the backend.
+   * 
+   * @example
+   * false
+   */
+  overLimit?: boolean;
+  /**
+   * @remarks
+   * The quota statistical period. day indicates daily and month indicates monthly.
+   * 
+   * @example
+   * day
+   */
+  periodType?: string;
+  /**
+   * @remarks
+   * The gateway quota rule status. This is a read-only field returned by the backend.
+   * 
+   * @example
+   * ACTIVE
+   */
+  ruleStatus?: string;
+  /**
+   * @remarks
+   * The maximum number of tokens that can be consumed within a single cycle.
+   * 
+   * @example
+   * 1000000
+   */
+  usageLimit?: number;
+  /**
+   * @remarks
+   * The number of tokens consumed in the current cycle. This is a read-only field returned by the backend.
+   * 
+   * @example
+   * 12345
+   */
+  usedAmount?: number;
+  static names(): { [key: string]: string } {
+    return {
+      enabled: 'enabled',
+      limitType: 'limitType',
+      overLimit: 'overLimit',
+      periodType: 'periodType',
+      ruleStatus: 'ruleStatus',
+      usageLimit: 'usageLimit',
+      usedAmount: 'usedAmount',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      enabled: 'boolean',
+      limitType: 'string',
+      overLimit: 'boolean',
+      periodType: 'string',
+      ruleStatus: 'string',
+      usageLimit: 'number',
+      usedAmount: 'number',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class GetExternalAgentResponseBodyDataModel extends $dara.Model {
   /**
    * @remarks
    * The model connection ID.
    * 
-   * This parameter is required.
-   * 
    * @example
    * mc-1
    */
@@ -90,16 +178,20 @@ export class GetExternalAgentResponseBodyDataModel extends $dara.Model {
    * @remarks
    * The upstream model name.
    * 
-   * This parameter is required.
-   * 
    * @example
    * qwen-max
    */
   modelName?: string;
+  /**
+   * @remarks
+   * The model token quota configuration and the quota usage status in the current cycle. This parameter is empty if no quota is configured.
+   */
+  quota?: GetExternalAgentResponseBodyDataModelQuota;
   static names(): { [key: string]: string } {
     return {
       modelConnectionId: 'modelConnectionId',
       modelName: 'modelName',
+      quota: 'quota',
     };
   }
 
@@ -107,10 +199,14 @@ export class GetExternalAgentResponseBodyDataModel extends $dara.Model {
     return {
       modelConnectionId: 'string',
       modelName: 'string',
+      quota: GetExternalAgentResponseBodyDataModelQuota,
     };
   }
 
   validate() {
+    if(this.quota && typeof (this.quota as any).validate === 'function') {
+      (this.quota as any).validate();
+    }
     super.validate();
   }
 
@@ -363,7 +459,7 @@ export class GetExternalAgentResponseBodyData extends $dara.Model {
   model?: GetExternalAgentResponseBodyDataModel;
   /**
    * @remarks
-   * The source of the model configuration. PLATFORM indicates that the model configuration is parsed and delivered by the platform. RUNTIME indicates that the model is managed by the external runtime, and the model parameter cannot be specified at the same time. Valid values:
+   * The model configuration source. PLATFORM indicates that the model configuration is parsed and distributed by the platform. RUNTIME indicates that the model is managed by the external runtime, and the model parameter cannot be specified at the same time. Valid values:
    * - PLATFORM: Platform model.
    * - RUNTIME: Runtime model.
    * 
@@ -517,7 +613,7 @@ export class GetExternalAgentResponseBodyData extends $dara.Model {
 export class GetExternalAgentResponseBody extends $dara.Model {
   /**
    * @remarks
-   * The business status code. The value SUCCESS is returned when the request succeeds.
+   * The business status code. The value is SUCCESS when the request succeeds.
    * 
    * @example
    * SUCCESS
@@ -530,7 +626,7 @@ export class GetExternalAgentResponseBody extends $dara.Model {
   data?: GetExternalAgentResponseBodyData;
   /**
    * @remarks
-   * The HTTP status code. The value 200 is returned when the request succeeds.
+   * The HTTP status code. The value is 200 when the request succeeds.
    * 
    * @example
    * 200
@@ -538,7 +634,7 @@ export class GetExternalAgentResponseBody extends $dara.Model {
   httpStatusCode?: number;
   /**
    * @remarks
-   * The message that indicates the result of the request.
+   * The request processing result message.
    * 
    * @example
    * success

package/src/models/GetManagedAgentResponseBody.ts

@@ -121,7 +121,7 @@ export class GetManagedAgentResponseBodyDataEnvironment extends $dara.Model {
 export class GetManagedAgentResponseBodyDataHarnessConfiguration extends $dara.Model {
   /**
    * @remarks
-   * The Service Account Key bound to the QoderCLI Connector by Key ID. This parameter can be omitted when only one key exists, but is required when multiple keys exist.
+   * The connector service account key.
    * 
    * @example
    * key-xxxx
@@ -129,7 +129,7 @@ export class GetManagedAgentResponseBodyDataHarnessConfiguration extends $dara.M
   connectorServiceAccountKey?: string;
   /**
    * @remarks
-   * The Connector Key name populated during queries. This value is not used as a binding reference during writes.
+   * The connector service account name.
    * 
    * @example
    * my-connector-key
@@ -161,12 +161,12 @@ export class GetManagedAgentResponseBodyDataHarnessConfiguration extends $dara.M
 export class GetManagedAgentResponseBodyDataHarness extends $dara.Model {
   /**
    * @remarks
-   * The Connector binding configuration for the qodercli harness.
+   * The runtime harness configuration.
    */
   configuration?: GetManagedAgentResponseBodyDataHarnessConfiguration;
   /**
    * @remarks
-   * The runtime harness type. Valid values: qwenpaw and qodercli. When the type is qodercli, binding is based on configuration.connectorServiceAccountKey, and the name is also populated during queries.
+   * The runtime harness type.
    * 
    * @example
    * qodercli
@@ -198,13 +198,101 @@ export class GetManagedAgentResponseBodyDataHarness extends $dara.Model {
   }
 }
 
+export class GetManagedAgentResponseBodyDataModelQuota extends $dara.Model {
+  /**
+   * @remarks
+   * Indicates whether the quota is enabled. Not returned if no quota is configured.
+   * 
+   * @example
+   * true
+   */
+  enabled?: boolean;
+  /**
+   * @remarks
+   * The quota limit type. Currently only token is supported.
+   * 
+   * @example
+   * token
+   */
+  limitType?: string;
+  /**
+   * @remarks
+   * Indicates whether the quota has been exceeded in the current period. Read-only, returned by the backend.
+   * 
+   * @example
+   * false
+   */
+  overLimit?: boolean;
+  /**
+   * @remarks
+   * The quota statistical period. Valid values: day (daily) and month (monthly).
+   * 
+   * @example
+   * day
+   */
+  periodType?: string;
+  /**
+   * @remarks
+   * The gateway quota rule status. Read-only, returned by the backend.
+   * 
+   * @example
+   * ACTIVE
+   */
+  ruleStatus?: string;
+  /**
+   * @remarks
+   * The maximum number of tokens allowed per period.
+   * 
+   * @example
+   * 1000000
+   */
+  usageLimit?: number;
+  /**
+   * @remarks
+   * The number of tokens consumed in the current period. Read-only, returned by the backend.
+   * 
+   * @example
+   * 12345
+   */
+  usedAmount?: number;
+  static names(): { [key: string]: string } {
+    return {
+      enabled: 'enabled',
+      limitType: 'limitType',
+      overLimit: 'overLimit',
+      periodType: 'periodType',
+      ruleStatus: 'ruleStatus',
+      usageLimit: 'usageLimit',
+      usedAmount: 'usedAmount',
+    };
+  }
+
+  static types(): { [key: string]: any } {
+    return {
+      enabled: 'boolean',
+      limitType: 'string',
+      overLimit: 'boolean',
+      periodType: 'string',
+      ruleStatus: 'string',
+      usageLimit: 'number',
+      usedAmount: 'number',
+    };
+  }
+
+  validate() {
+    super.validate();
+  }
+
+  constructor(map?: { [key: string]: any }) {
+    super(map);
+  }
+}
+
 export class GetManagedAgentResponseBodyDataModel extends $dara.Model {
   /**
    * @remarks
    * The model connection ID.
    * 
-   * This parameter is required.
-   * 
    * @example
    * mc-1
    */
@@ -217,10 +305,16 @@ export class GetManagedAgentResponseBodyDataModel extends $dara.Model {
    * qwen-max
    */
   modelName?: string;
+  /**
+   * @remarks
+   * The model token quota configuration and usage status for the current period. Empty if no quota is configured.
+   */
+  quota?: GetManagedAgentResponseBodyDataModelQuota;
   static names(): { [key: string]: string } {
     return {
       modelConnectionId: 'modelConnectionId',
       modelName: 'modelName',
+      quota: 'quota',
     };
   }
 
@@ -228,10 +322,14 @@ export class GetManagedAgentResponseBodyDataModel extends $dara.Model {
     return {
       modelConnectionId: 'string',
       modelName: 'string',
+      quota: GetManagedAgentResponseBodyDataModelQuota,
     };
   }
 
   validate() {
+    if(this.quota && typeof (this.quota as any).validate === 'function') {
+      (this.quota as any).validate();
+    }
     super.validate();
   }
 
@@ -343,17 +441,26 @@ export class GetManagedAgentResponseBodyDataNetwork extends $dara.Model {
 export class GetManagedAgentResponseBodyDataOssMounts extends $dara.Model {
   /**
    * @remarks
-   * The OSS bucket name. This parameter is required for each mount entry as validated by the backend.
+   * The OSS bucket name. Required for each mount entry, validated by the backend.
+   * 
+   * @example
+   * bucket-001
    */
   bucketName?: string;
   /**
    * @remarks
-   * The absolute mount path in the container. This parameter is required for each mount entry as validated by the backend.
+   * The absolute mount path in the container. Required for each mount entry, validated by the backend.
+   * 
+   * @example
+   * /mnt/oss/datasets
    */
   mountPath?: string;
   /**
    * @remarks
    * The relative object prefix in the bucket. If not specified, the entire bucket is mounted.
+   * 
+   * @example
+   * datasets
    */
   path?: string;
   /**
@@ -391,7 +498,7 @@ export class GetManagedAgentResponseBodyDataOssMounts extends $dara.Model {
 export class GetManagedAgentResponseBodyDataRuntimeCompute extends $dara.Model {
   /**
    * @remarks
-   * The compute class.
+   * The compute specification.
    * 
    * This parameter is required.
    * 
@@ -423,27 +530,39 @@ export class GetManagedAgentResponseBodyDataRuntimeCompute extends $dara.Model {
 export class GetManagedAgentResponseBodyDataRuntimeHpa extends $dara.Model {
   /**
    * @remarks
-   * Specifies whether to enable auto scaling. This parameter is required when hpa is present as validated by the backend.
+   * Specifies whether auto-scaling is enabled. Required when hpa is present, validated by the backend.
    */
   enabled?: boolean;
   /**
    * @remarks
-   * The maximum number of active sessions per sandbox. This parameter is required when hpa is present as validated by the backend.
+   * The maximum number of active sessions per sandbox. Required when hpa is present, validated by the backend.
+   * 
+   * @example
+   * 5
    */
   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. Required when HPA is enabled and must be no less than the minimum value.
+   * 
+   * @example
+   * 3
    */
   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
    */
   minSandboxCount?: number;
   /**
    * @remarks
-   * The session reclamation time after inactivity, in seconds. This parameter is required when hpa is present as validated by the backend.
+   * The session reclamation time after inactivity, in seconds. Required when hpa is present, validated by the backend.
+   * 
+   * @example
+   * 3600
    */
   sessionTtlSeconds?: number;
   static names(): { [key: string]: string } {
@@ -478,7 +597,7 @@ export class GetManagedAgentResponseBodyDataRuntimeHpa extends $dara.Model {
 export class GetManagedAgentResponseBodyDataRuntimeSessionPolicy extends $dara.Model {
   /**
    * @remarks
-   * The HTTP header name used for session affinity. This parameter takes effect when sessionPolicy.type is set to ISOLATED_HEADER_FIELD.
+   * The HTTP header name used for session affinity. Takes effect when sessionPolicy.type is set to ISOLATED_HEADER_FIELD.
    * 
    * @example
    * X-Session-Id
@@ -527,7 +646,7 @@ export class GetManagedAgentResponseBodyDataRuntime extends $dara.Model {
   compute?: GetManagedAgentResponseBodyDataRuntimeCompute;
   /**
    * @remarks
-   * The sandbox auto scaling and session configuration.
+   * The sandbox auto-scaling and session configuration.
    */
   hpa?: GetManagedAgentResponseBodyDataRuntimeHpa;
   /**
@@ -616,7 +735,7 @@ export class GetManagedAgentResponseBodyDataSkills extends $dara.Model {
 export class GetManagedAgentResponseBodyDataSubAgents extends $dara.Model {
   /**
    * @remarks
-   * The sub-agent instruction.
+   * The instruction for the sub-agent.
    * 
    * This parameter is required.
    * 
@@ -823,7 +942,7 @@ export class GetManagedAgentResponseBodyData extends $dara.Model {
   environment?: GetManagedAgentResponseBodyDataEnvironment;
   /**
    * @remarks
-   * The runtime harness of the managed agent. Valid values: qwenpaw and qodercli.
+   * The agent runtime harness.
    */
   harness?: GetManagedAgentResponseBodyDataHarness;
   /**
@@ -888,7 +1007,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. Use FAILED > 0 to determine whether 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 should be 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 };
   /**
@@ -921,7 +1040,7 @@ export class GetManagedAgentResponseBodyData extends $dara.Model {
   tools?: GetManagedAgentResponseBodyDataTools[];
   /**
    * @remarks
-   * The update time in RFC 3339 format.
+   * The time when the agent was last updated, in RFC 3339 format.
    * 
    * @example
    * 2026-01-01T00:00:00Z