@alicloud/agentcore20260804 1.2.2 → 2.0.0

package/dist/models/CreateMcpRequest.d.ts

@@ -1,4 +1,32 @@
 import * as $dara from '@darabonba/typescript';
+export declare class CreateMcpRequestBodyAuthCodePackage 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 CreateMcpRequestBodyAuthDirectProxy extends $dara.Model {
     /**
      * @remarks
@@ -80,6 +108,11 @@ export declare class CreateMcpRequestBodyAuthHttpToMcp extends $dara.Model {
     });
 }
 export declare class CreateMcpRequestBodyAuth extends $dara.Model {
+    /**
+     * @remarks
+     * The API key authentication configuration for callers of code-deployed MCP.
+     */
+    codePackage?: CreateMcpRequestBodyAuthCodePackage;
     /**
      * @remarks
      * The authentication configuration for direct proxy.
@@ -87,7 +120,7 @@ export declare class CreateMcpRequestBodyAuth extends $dara.Model {
     directProxy?: CreateMcpRequestBodyAuthDirectProxy;
     /**
      * @remarks
-     * Specifies whether to enable authentication.
+     * Specifies whether to enable this configuration.
      */
     enabled?: boolean;
     /**
@@ -106,19 +139,759 @@ export declare class CreateMcpRequestBodyAuth extends $dara.Model {
         [key: string]: any;
     });
 }
-export declare class CreateMcpRequestBody extends $dara.Model {
+export declare class CreateMcpRequestBodyDeploymentConfigAccessControl extends $dara.Model {
     /**
      * @remarks
-     * The list of MCP service addresses.
+     * The AgentCore Credential referenced when mode is set to CREDENTIAL.
      *
-     * This parameter is required.
+     * @example
+     * credential-id
      */
-    addresses?: string[];
+    credentialId?: 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. For apiKey, position/name are also required). 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.
+     * Specifies whether to enable ingress access control.
      */
-    auth?: CreateMcpRequestBodyAuth;
+    enabled?: boolean;
+    /**
+     * @remarks
+     * The access control mode. Valid values:
+     * - ANONYMOUS: anonymous access.
+     * - CREDENTIAL: access using 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 CreateMcpRequestBodyDeploymentConfigAgentIdentityConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * Specifies whether to enable authorization.
+     */
+    authorizationEnabled?: boolean;
+    /**
+     * @remarks
+     * The 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 CreateMcpRequestBodyDeploymentConfigCodeConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The temporary code package token returned by GetMcpCodePackageUploadUrl. Use this token to create a code deployment after completing the pre-signed upload. Specify either this parameter or CodePackageUrl.
+     *
+     * @example
+     * upload-token
+     */
+    codePackageToken?: string;
+    /**
+     * @remarks
+     * The public Alibaba Cloud OSS HTTP(S) address that you can directly pass in when creating a code deployment. Specify either this parameter or CodePackageToken. Only CreateMcp supports this parameter. Update and query operations do not support this parameter.
+     *
+     * @example
+     * https://example-bucket.oss-cn-hangzhou.aliyuncs.com/server.zip
+     */
+    codePackageUrl?: string;
+    /**
+     * @remarks
+     * The full startup command, with arguments passed in order by parameter boundary. For example, when using supergateway to start a stdio MCP, pass in supergateway, --stdio, the full subcommand, and 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 CreateMcpRequestBodyDeploymentConfigContainerConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The ACR instance ID.
+     *
+     * @example
+     * cri-example
+     */
+    acrInstanceId?: string;
+    /**
+     * @remarks
+     * The startup command.
+     */
+    command?: string[];
+    /**
+     * @remarks
+     * The container entrypoint arguments.
+     */
+    entrypoint?: string[];
+    /**
+     * @remarks
+     * The container image address.
+     *
+     * @example
+     * registry.cn-hangzhou.aliyuncs.com/example/mcp:1.0.0
+     */
+    image?: string;
+    /**
+     * @remarks
+     * The image registry type.
+     *
+     * @example
+     * ACR
+     */
+    imageRegistryType?: string;
+    /**
+     * @remarks
+     * The MCP Runtime mode. Custom containers must expose a standard MCP on their own. Set this parameter to SELF_HOSTED.
+     *
+     * @example
+     * SELF_HOSTED
+     */
+    mcpRuntimeMode?: string;
+    /**
+     * @remarks
+     * The container source type. 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 CreateMcpRequestBodyDeploymentConfigHookConfigurationHooks extends $dara.Model {
+    /**
+     * @remarks
+     * The hook API version.
+     *
+     * @example
+     * 1.0
+     */
+    apiVersion?: string;
+    /**
+     * @remarks
+     * The hook description.
+     *
+     * @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 hook request headers.
+     */
+    headers?: {
+        [key: string]: string;
+    };
+    /**
+     * @remarks
+     * The hook timeout period. Unit: milliseconds.
+     *
+     * @example
+     * 3000
+     */
+    timeout?: number;
+    /**
+     * @remarks
+     * The hook callback URL.
+     *
+     * @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 CreateMcpRequestBodyDeploymentConfigHookConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The hooks executed in array order: PRE_LIST_TOOLS, PRE_CALL_TOOL, POST_LIST_TOOLS, and POST_CALL_TOOL.
+     */
+    hooks?: CreateMcpRequestBodyDeploymentConfigHookConfigurationHooks[];
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class CreateMcpRequestBodyDeploymentConfigLogConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * Specifies whether to collect instance metrics.
+     */
+    enableInstanceMetrics?: boolean;
+    /**
+     * @remarks
+     * Specifies whether to collect request metrics.
+     */
+    enableRequestMetrics?: boolean;
+    /**
+     * @remarks
+     * The log splitting begin rule for Function Compute (FC).
+     *
+     * @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 CreateMcpRequestBodyDeploymentConfigMcpConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * For example, /mcp or /sse.
+     *
+     * @example
+     * /mcp
+     */
+    endpointPath?: string;
+    /**
+     * @remarks
+     * Currently fixed to 1.
+     *
+     * @example
+     * 1
+     */
+    sessionConcurrencyPerInstance?: number;
+    /**
+     * @remarks
+     * Unit: seconds. Default value: 1800.
+     *
+     * @example
+     * 1800
+     */
+    sessionIdleTimeoutSeconds?: number;
+    /**
+     * @remarks
+     * 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 CreateMcpRequestBodyDeploymentConfigNasConfigurationMountPoints 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 CreateMcpRequestBodyDeploymentConfigNasConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The runtime user group ID.
+     *
+     * @example
+     * 1000
+     */
+    groupId?: number;
+    /**
+     * @remarks
+     * The list of NAS mount points.
+     */
+    mountPoints?: CreateMcpRequestBodyDeploymentConfigNasConfigurationMountPoints[];
+    /**
+     * @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 CreateMcpRequestBodyDeploymentConfigNetworkConfiguration 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 virtual private cloud (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 CreateMcpRequestBodyDeploymentConfigOssMountConfigurationMountPoints 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 CreateMcpRequestBodyDeploymentConfigOssMountConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * The list of OSS mount points.
+     */
+    mountPoints?: CreateMcpRequestBodyDeploymentConfigOssMountConfigurationMountPoints[];
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class CreateMcpRequestBodyDeploymentConfigParameterTransformConfiguration 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 CreateMcpRequestBodyDeploymentConfigProxyConfiguration 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 CreateMcpRequestBodyDeploymentConfigRuntimeConfiguration extends $dara.Model {
+    /**
+     * @remarks
+     * Unit: cores. Default value: 0.25.
+     *
+     * @example
+     * 0.25
+     */
+    cpu?: number;
+    /**
+     * @remarks
+     * 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 CreateMcpRequestBodyDeploymentConfig extends $dara.Model {
+    /**
+     * @remarks
+     * The MCP ingress access control configuration.
+     */
+    accessControl?: CreateMcpRequestBodyDeploymentConfigAccessControl;
+    /**
+     * @remarks
+     * The Agent Identity configuration.
+     */
+    agentIdentityConfiguration?: CreateMcpRequestBodyDeploymentConfigAgentIdentityConfiguration;
+    /**
+     * @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?: CreateMcpRequestBodyDeploymentConfigCodeConfiguration;
+    /**
+     * @remarks
+     * The custom container configuration.
+     */
+    containerConfiguration?: CreateMcpRequestBodyDeploymentConfigContainerConfiguration;
+    /**
+     * @remarks
+     * The hook configuration.
+     */
+    hookConfiguration?: CreateMcpRequestBodyDeploymentConfigHookConfiguration;
+    /**
+     * @remarks
+     * The log configuration.
+     */
+    logConfiguration?: CreateMcpRequestBodyDeploymentConfigLogConfiguration;
+    /**
+     * @remarks
+     * The MCP session configuration.
+     */
+    mcpConfiguration?: CreateMcpRequestBodyDeploymentConfigMcpConfiguration;
+    /**
+     * @remarks
+     * The NAS storage configuration.
+     */
+    nasConfiguration?: CreateMcpRequestBodyDeploymentConfigNasConfiguration;
+    /**
+     * @remarks
+     * The network configuration.
+     */
+    networkConfiguration?: CreateMcpRequestBodyDeploymentConfigNetworkConfiguration;
+    /**
+     * @remarks
+     * The OSS mount configuration.
+     */
+    ossMountConfiguration?: CreateMcpRequestBodyDeploymentConfigOssMountConfiguration;
+    /**
+     * @remarks
+     * The parameter transformation and result enhancement configuration.
+     */
+    parameterTransformConfiguration?: CreateMcpRequestBodyDeploymentConfigParameterTransformConfiguration;
+    /**
+     * @remarks
+     * The MCP proxy configuration.
+     */
+    proxyConfiguration?: CreateMcpRequestBodyDeploymentConfigProxyConfiguration;
+    /**
+     * @remarks
+     * The runtime and resource configuration.
+     */
+    runtimeConfiguration?: CreateMcpRequestBodyDeploymentConfigRuntimeConfiguration;
+    static names(): {
+        [key: string]: string;
+    };
+    static types(): {
+        [key: string]: any;
+    };
+    validate(): void;
+    constructor(map?: {
+        [key: string]: any;
+    });
+}
+export declare class CreateMcpRequestBody 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. For apiKey, position/name are also required). 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?: CreateMcpRequestBodyAuth;
+    /**
+     * @remarks
+     * Custom tags. Multiple tags are supported.
+     */
+    customTags?: string[];
+    /**
+     * @remarks
+     * The code deployment configuration. Required when Type is set to CODE_PACKAGE. When creating a Code artifact, you must specify either CodeConfiguration.CodePackageToken or CodePackageUrl, but not both. CodePackageUrl supports only public Alibaba Cloud OSS HTTP(S) addresses.
+     */
+    deploymentConfig?: CreateMcpRequestBodyDeploymentConfig;
     /**
      * @remarks
      * The description.
@@ -147,7 +920,7 @@ export declare class CreateMcpRequestBody extends $dara.Model {
     protocol?: 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"}
@@ -182,7 +955,7 @@ export declare class CreateMcpRequest extends $dara.Model {
     body?: CreateMcpRequestBody;
     /**
      * @remarks
-     * The client idempotency token.
+     * The client token that ensures idempotency of the request.
      *
      * @example
      * 123e4567-e89b-12d3-a456-426614174000