@alicloud/agentcore20260804 1.2.1 → 2.0.0

package/dist/models/UpdateMcpRequest.d.ts

@@ -1,4 +1,32 @@
 import * as $dara from '@darabonba/typescript';
+export declare class UpdateMcpRequestBodyAuthCodePackage extends $dara.Model {
+    /**
+     * @remarks
+     * The API key for authenticating MCP callers.
+     *
+     * @example
+     * example-api-key
+     */
+    apiKey?: string;
+    /**
+     * @remarks
+     * The name of the request header that carries the API key.
+     *
+     * @example
+     * X-API-Key
+     */
+    headerName?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
 export declare class UpdateMcpRequestBodyAuthDirectProxy extends $dara.Model {
     /**
      * @remarks
@@ -80,6 +108,11 @@ export declare class UpdateMcpRequestBodyAuthHttpToMcp extends $dara.Model {
     });
 }
 export declare class UpdateMcpRequestBodyAuth extends $dara.Model {
+    /**
+     * @remarks
+     * The API key authentication configuration for code-deployed MCP callers.
+     */
+    codePackage?: UpdateMcpRequestBodyAuthCodePackage;
     /**
      * @remarks
      * The direct proxy authentication configuration.
@@ -87,7 +120,7 @@ export declare class UpdateMcpRequestBodyAuth extends $dara.Model {
     directProxy?: UpdateMcpRequestBodyAuthDirectProxy;
     /**
      * @remarks
-     * Specifies whether to enable authentication.
+     * Specifies whether to enable the configuration.
      */
     enabled?: boolean;
     /**
@@ -106,17 +139,751 @@ export declare class UpdateMcpRequestBodyAuth extends $dara.Model {
         [key: string]: any;
     });
 }
-export declare class UpdateMcpRequestBody extends $dara.Model {
+export declare class UpdateMcpRequestBodyDeploymentConfigAccessControl extends $dara.Model {
     /**
      * @remarks
-     * The list of MCP service addresses.
+     * The AgentCore Credential referenced when mode is set to CREDENTIAL.
+     *
+     * @example
+     * credential-id
      */
-    addresses?: string[];
+    credentialId?: string;
     /**
      * @remarks
-     * The backend authentication configuration. When enabled=true: for DIRECT_PROXY, specify directProxy (name/value). For HTTP_TO_MCP, specify the httpToMcp array (each item contains id/type/credential; apiKey also requires position/name). Multiple authentication objects are supported, and the first one is the default upstream credential. HTTP_TO_MCP credentials are merged into the securitySchemes of the Swagger specification.
+     * Specifies whether to enable ingress access control.
      */
-    auth?: UpdateMcpRequestBodyAuth;
+    enabled?: boolean;
+    /**
+     * @remarks
+     * The access control mode. Valid values:
+     * - ANONYMOUS: anonymous access.
+     * - CREDENTIAL: access with an AgentCore credential.
+     *
+     * @example
+     * CREDENTIAL
+     */
+    mode?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigAgentIdentityConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * Specifies whether to enable authorization.
+     */
+    authorizationEnabled?: boolean;
+    /**
+     * @remarks
+     * The Alibaba Cloud Resource Name (ARN) of the credential provider.
+     *
+     * @example
+     * acs:agentidentity:cn-hangzhou:1234567890123456:provider/example
+     */
+    credentialProviderArn?: string;
+    /**
+     * @remarks
+     * The type of the credential provider.
+     *
+     * @example
+     * oauth2
+     */
+    credentialProviderType?: string;
+    /**
+     * @remarks
+     * Specifies whether to enable Agent Identity.
+     */
+    enabled?: boolean;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigCodeConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The temporary code package token returned by GetMcpCodePackageUploadUrl. After the pre-signed upload is complete, use this token to create or update a code deployment.
+     *
+     * @example
+     * upload-token
+     */
+    codePackageToken?: string;
+    /**
+     * @remarks
+     * The full startup command. Pass each argument as a separate element in order. For example, when using supergateway to start a stdio MCP, pass supergateway, --stdio, the full subcommand, and the remaining arguments.
+     */
+    command?: string[];
+    /**
+     * @remarks
+     * The code package runtime. Valid values: python3.13, nodejs22, and java17.
+     *
+     * @example
+     * python3.13
+     */
+    language?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigContainerConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The ID of the Alibaba Cloud Container Registry (ACR) instance.
+     *
+     * @example
+     * cri-example
+     */
+    acrInstanceId?: string;
+    /**
+     * @remarks
+     * The startup command.
+     */
+    command?: string[];
+    /**
+     * @remarks
+     * The container entrypoint arguments.
+     */
+    entrypoint?: string[];
+    /**
+     * @remarks
+     * The URL of the container image.
+     *
+     * @example
+     * registry.cn-hangzhou.aliyuncs.com/example/mcp:1.0.0
+     */
+    image?: string;
+    /**
+     * @remarks
+     * The type of the image registry.
+     *
+     * @example
+     * ACR
+     */
+    imageRegistryType?: string;
+    /**
+     * @remarks
+     * The MCP runtime mode for the custom container. The custom container must expose a standard MCP endpoint. Set this parameter to SELF_HOSTED.
+     *
+     * @example
+     * SELF_HOSTED
+     */
+    mcpRuntimeMode?: string;
+    /**
+     * @remarks
+     * The source type of the container. Currently fixed to CONTAINER_IMAGE.
+     *
+     * @example
+     * CONTAINER_IMAGE
+     */
+    sourceType?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigHookConfigurationHooks extends $dara.Model {
+    /**
+     * @remarks
+     * The API version of the hook.
+     *
+     * @example
+     * 1.0
+     */
+    apiVersion?: string;
+    /**
+     * @remarks
+     * The description of the hook.
+     *
+     * @example
+     * Log MCP tool invocations
+     */
+    description?: string;
+    /**
+     * @remarks
+     * Specifies whether to enable the hook.
+     */
+    enabled?: boolean;
+    /**
+     * @remarks
+     * The hook event.
+     *
+     * @example
+     * PRE_CALL_TOOL
+     */
+    event?: string;
+    /**
+     * @remarks
+     * The HTTP request headers for the hook.
+     */
+    headers?: {
+        [key: string]: string;
+    };
+    /**
+     * @remarks
+     * The timeout period, in milliseconds.
+     *
+     * @example
+     * 3000
+     */
+    timeout?: number;
+    /**
+     * @remarks
+     * The callback URL of the hook.
+     *
+     * @example
+     * https://example.com/mcp-hook
+     */
+    url?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigHookConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The list of hooks executed in array order. Supported hook events: PRE_LIST_TOOLS, PRE_CALL_TOOL, POST_LIST_TOOLS, and POST_CALL_TOOL.
+     */
+    hooks?: UpdateMcpRequestBodyDeploymentConfigHookConfigurationHooks[];
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigLogConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * Specifies whether to collect instance metrics.
+     */
+    enableInstanceMetrics?: boolean;
+    /**
+     * @remarks
+     * Specifies whether to collect request metrics.
+     */
+    enableRequestMetrics?: boolean;
+    /**
+     * @remarks
+     * The log segmentation start rule for Function Compute.
+     *
+     * @example
+     * DefaultRegex
+     */
+    logBeginRule?: string;
+    /**
+     * @remarks
+     * The Logstore name.
+     *
+     * @example
+     * mcp-logs
+     */
+    logstore?: string;
+    /**
+     * @remarks
+     * The Log Service project name.
+     *
+     * @example
+     * agentcore-mcp-logs
+     */
+    project?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigMcpConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * For example, /mcp or /sse.
+     *
+     * @example
+     * /mcp
+     */
+    endpointPath?: string;
+    /**
+     * @remarks
+     * Currently fixed to 1.
+     *
+     * @example
+     * 1
+     */
+    sessionConcurrencyPerInstance?: number;
+    /**
+     * @remarks
+     * The session idle timeout. Unit: seconds. Default value: 1800.
+     *
+     * @example
+     * 1800
+     */
+    sessionIdleTimeoutSeconds?: number;
+    /**
+     * @remarks
+     * The maximum session lifetime. Unit: seconds. Default value: 21600.
+     *
+     * @example
+     * 21600
+     */
+    sessionMaxLifetimeSeconds?: number;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigNasConfigurationMountPoints extends $dara.Model {
+    /**
+     * @remarks
+     * Specifies whether to enable TLS.
+     */
+    enableTls?: boolean;
+    /**
+     * @remarks
+     * The local mount directory.
+     *
+     * @example
+     * /mnt/data
+     */
+    mountDir?: string;
+    /**
+     * @remarks
+     * The NAS server address.
+     *
+     * @example
+     * example.cn-hangzhou.nas.aliyuncs.com
+     */
+    serverAddr?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigNasConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The runtime user group ID.
+     *
+     * @example
+     * 1000
+     */
+    groupId?: number;
+    /**
+     * @remarks
+     * The list of NAS mount points.
+     */
+    mountPoints?: UpdateMcpRequestBodyDeploymentConfigNasConfigurationMountPoints[];
+    /**
+     * @remarks
+     * The runtime user ID.
+     *
+     * @example
+     * 1000
+     */
+    userId?: number;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigNetworkConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The network mode.
+     *
+     * @example
+     * PUBLIC
+     */
+    networkMode?: string;
+    /**
+     * @remarks
+     * The security group ID.
+     *
+     * @example
+     * sg-example
+     */
+    securityGroupId?: string;
+    /**
+     * @remarks
+     * The list of vSwitch IDs.
+     */
+    vSwitchIds?: string[];
+    /**
+     * @remarks
+     * The VPC ID.
+     *
+     * @example
+     * vpc-example
+     */
+    vpcId?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigOssMountConfigurationMountPoints extends $dara.Model {
+    /**
+     * @remarks
+     * The OSS bucket name.
+     *
+     * @example
+     * example-bucket
+     */
+    bucketName?: string;
+    /**
+     * @remarks
+     * The OSS bucket path.
+     *
+     * @example
+     * /data
+     */
+    bucketPath?: string;
+    /**
+     * @remarks
+     * The OSS service endpoint.
+     *
+     * @example
+     * https://oss-cn-hangzhou.aliyuncs.com
+     */
+    endpoint?: string;
+    /**
+     * @remarks
+     * The local mount directory.
+     *
+     * @example
+     * /mnt/data
+     */
+    mountDir?: string;
+    /**
+     * @remarks
+     * Specifies whether the mount point is read-only.
+     */
+    readOnly?: boolean;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigOssMountConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The list of OSS mount points.
+     */
+    mountPoints?: UpdateMcpRequestBodyDeploymentConfigOssMountConfigurationMountPoints[];
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigParameterTransformConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * Specifies whether to enable parameter transformation and result enhancement.
+     */
+    enabled?: boolean;
+    /**
+     * @remarks
+     * The reserved reference to the parameter transformation and result enhancement rule set.
+     *
+     * @example
+     * rules-1
+     */
+    ruleSetId?: string;
+    /**
+     * @remarks
+     * The transformation rule version.
+     *
+     * @example
+     * 1.0
+     */
+    version?: string;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigProxyConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * Specifies whether to enable the MCP proxy.
+     */
+    enabled?: boolean;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfigRuntimeConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The CPU specification. Unit: cores. Default value: 0.25.
+     *
+     * @example
+     * 0.25
+     */
+    cpu?: number;
+    /**
+     * @remarks
+     * The ephemeral disk size. Unit: MB. Valid values: 512 and 10240.
+     *
+     * @example
+     * 512
+     */
+    diskSize?: number;
+    /**
+     * @remarks
+     * The environment variables.
+     */
+    environmentVariables?: {
+        [key: string]: string;
+    };
+    /**
+     * @remarks
+     * The ARN of the RAM role used when user code accesses downstream Alibaba Cloud resources.
+     *
+     * @example
+     * acs:ram::1234567890123456:role/agentcore-mcp-execution
+     */
+    executionRoleArn?: string;
+    /**
+     * @remarks
+     * Default value: 200.
+     *
+     * @example
+     * 200
+     */
+    instanceConcurrency?: number;
+    /**
+     * @remarks
+     * Unit: MB. Default value: 512.
+     *
+     * @example
+     * 512
+     */
+    memory?: number;
+    /**
+     * @remarks
+     * Default value: 9000.
+     *
+     * @example
+     * 9000
+     */
+    port?: number;
+    /**
+     * @remarks
+     * Unit: seconds. Default value: 300.
+     *
+     * @example
+     * 300
+     */
+    timeout?: number;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBodyDeploymentConfig extends $dara.Model {
+    /**
+     * @remarks
+     * The MCP ingress access control configuration.
+     */
+    accessControl?: UpdateMcpRequestBodyDeploymentConfigAccessControl;
+    /**
+     * @remarks
+     * The Agent Identity configuration.
+     */
+    agentIdentityConfiguration?: UpdateMcpRequestBodyDeploymentConfigAgentIdentityConfiguration;
+    /**
+     * @remarks
+     * The artifact type. Valid values:
+     * - Code: a ZIP code package.
+     * - Container: a custom container.
+     *
+     * @example
+     * Code
+     */
+    artifactType?: string;
+    /**
+     * @remarks
+     * The code package configuration.
+     */
+    codeConfiguration?: UpdateMcpRequestBodyDeploymentConfigCodeConfiguration;
+    /**
+     * @remarks
+     * The custom container configuration.
+     */
+    containerConfiguration?: UpdateMcpRequestBodyDeploymentConfigContainerConfiguration;
+    /**
+     * @remarks
+     * The hook configuration.
+     */
+    hookConfiguration?: UpdateMcpRequestBodyDeploymentConfigHookConfiguration;
+    /**
+     * @remarks
+     * The log configuration.
+     */
+    logConfiguration?: UpdateMcpRequestBodyDeploymentConfigLogConfiguration;
+    /**
+     * @remarks
+     * The MCP session configuration.
+     */
+    mcpConfiguration?: UpdateMcpRequestBodyDeploymentConfigMcpConfiguration;
+    /**
+     * @remarks
+     * The NAS storage configuration.
+     */
+    nasConfiguration?: UpdateMcpRequestBodyDeploymentConfigNasConfiguration;
+    /**
+     * @remarks
+     * The network configuration.
+     */
+    networkConfiguration?: UpdateMcpRequestBodyDeploymentConfigNetworkConfiguration;
+    /**
+     * @remarks
+     * The OSS mount configuration.
+     */
+    ossMountConfiguration?: UpdateMcpRequestBodyDeploymentConfigOssMountConfiguration;
+    /**
+     * @remarks
+     * The parameter transformation and result enhancement configuration.
+     */
+    parameterTransformConfiguration?: UpdateMcpRequestBodyDeploymentConfigParameterTransformConfiguration;
+    /**
+     * @remarks
+     * The MCP proxy configuration.
+     */
+    proxyConfiguration?: UpdateMcpRequestBodyDeploymentConfigProxyConfiguration;
+    /**
+     * @remarks
+     * The runtime and resource configuration.
+     */
+    runtimeConfiguration?: UpdateMcpRequestBodyDeploymentConfigRuntimeConfiguration;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class UpdateMcpRequestBody extends $dara.Model {
+    /**
+     * @remarks
+     * The list of MCP service addresses.
+     */
+    addresses?: string[];
+    /**
+     * @remarks
+     * The backend authentication configuration. When enabled is set to true: for DIRECT_PROXY, specify directProxy (name/value). For HTTP_TO_MCP, specify the httpToMcp array (each item contains id/type/credential, and apiKey also requires position/name). Multiple authentication objects are supported, and the first one is used as the default upstream credential. HTTP_TO_MCP credentials are merged into the securitySchemes of the Swagger specification.
+     */
+    auth?: UpdateMcpRequestBodyAuth;
+    /**
+     * @remarks
+     * Custom tags. Multiple tags are supported. Pass an empty list to clear all tags.
+     */
+    customTags?: string[];
+    /**
+     * @remarks
+     * Deployment configuration patch for a CODE_PACKAGE MCP. Object fields are merged hierarchically. To keep the current deployed code package, omit CodeConfiguration.CodePackageToken so the server reuses the existing package. To replace the code package, pass a new non-empty Token. CodePackageUrl is supported only for CreateMcp and is not supported during updates.
+     */
+    deploymentConfig?: UpdateMcpRequestBodyDeploymentConfig;
     /**
      * @remarks
      * The description.
@@ -127,7 +894,7 @@ export declare class UpdateMcpRequestBody extends $dara.Model {
     description?: string;
     /**
      * @remarks
-     * The Swagger configuration. Specify this field if Type is set to HTTP_TO_MCP.
+     * Required if Type is set to HTTP_TO_MCP.
      *
      * @example
      * {"type":"object"}
@@ -152,7 +919,7 @@ export declare class UpdateMcpRequest extends $dara.Model {
     body?: UpdateMcpRequestBody;
     /**
      * @remarks
-     * The client idempotency token.
+     * The client token that is used to ensure the idempotency of the request.
      *
      * @example
      * 123e4567-e89b-12d3-a456-426614174000