@alicloud/agentcore20260804 2.1.0 → 2.2.0

package/dist/client.js

@@ -1516,7 +1516,7 @@ class Client extends openapi_core_1.default {
      * Deletes a skill and its related version data from a specified workspace. This operation is irreversible.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Deletes a skill and its related version data from a specified workspace. This operation is irreversible.
      *
      * @param request - DeleteSkillRequest
@@ -1546,7 +1546,7 @@ class Client extends openapi_core_1.default {
      * Deletes a skill and its related version data from a specified workspace. This operation is irreversible.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Deletes a skill and its related version data from a specified workspace. This operation is irreversible.
      *
      * @param request - DeleteSkillRequest
@@ -1921,11 +1921,11 @@ class Client extends openapi_core_1.default {
         return await this.enableConnectorWithOptions(workspaceId, connectorName, request, headers, runtime);
     }
     /**
-     * Skips the regular review process and forcibly publishes the specified Skill version.
+     * Skips the regular review process and forcibly publishes a specified Skill version.
      *
      * @remarks
-     * ## Request description
-     * Skips the regular review process and forcibly publishes the specified Skill version.
+     * ## Operation description
+     * Skips the regular review process and forcibly publishes a specified Skill version.
      *
      * @param tmpReq - ForcePublishSkillVersionRequest
      * @param headers - map
@@ -1961,11 +1961,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ForcePublishSkillVersionResponse({}));
     }
     /**
-     * Skips the regular review process and forcibly publishes the specified Skill version.
+     * Skips the regular review process and forcibly publishes a specified Skill version.
      *
      * @remarks
-     * ## Request description
-     * Skips the regular review process and forcibly publishes the specified Skill version.
+     * ## Operation description
+     * Skips the regular review process and forcibly publishes a specified Skill version.
      *
      * @param request - ForcePublishSkillVersionRequest
      * @returns ForcePublishSkillVersionResponse
@@ -2407,11 +2407,11 @@ class Client extends openapi_core_1.default {
         return await this.getManagedAgentWithOptions(workspaceId, agentId, request, headers, runtime);
     }
     /**
-     * Queries the details of a specified MCP service, including the address, type, status, authentication configuration, and protocol.
+     * Queries the details of a specified MCP server, including the address, type, status, authentication configuration, and protocol.
      *
      * @remarks
      * ## Operation description
-     * Queries the details of a specified MCP service, including the address, type, status, authentication configuration, and protocol.
+     * Queries the details of a specified MCP server, including the address, type, status, authentication configuration, and protocol.
      *
      * @param request - GetMcpRequest
      * @param headers - map
@@ -2437,11 +2437,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetMcpResponse({}));
     }
     /**
-     * Queries the details of a specified MCP service, including the address, type, status, authentication configuration, and protocol.
+     * Queries the details of a specified MCP server, including the address, type, status, authentication configuration, and protocol.
      *
      * @remarks
      * ## Operation description
-     * Queries the details of a specified MCP service, including the address, type, status, authentication configuration, and protocol.
+     * Queries the details of a specified MCP server, including the address, type, status, authentication configuration, and protocol.
      *
      * @param request - GetMcpRequest
      * @returns GetMcpResponse
@@ -2965,6 +2965,60 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.getWorkspaceAcrRamAuthorizeUrlWithOptions(workspaceId, request, headers, runtime);
     }
+    /**
+     * Queries the RAM authorization URL for mounting AgenticFS in a workspace.
+     *
+     * @remarks
+     * The workspace determines the account, region, and shared role. The resource ARN is constructed based on the specified fileSystemId and accessPointId. The server parameter is used to generate the policy name. This operation does not query NAS or check resource status. The response contains only the authorization URL for the target NAS policy. After completing RAM authorization, call the verification operation.
+     *
+     * @param request - GetWorkspaceAgenticFsMountRamAuthorizeUrlRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns GetWorkspaceAgenticFsMountRamAuthorizeUrlResponse
+     */
+    async getWorkspaceAgenticFsMountRamAuthorizeUrlWithOptions(workspaceId, request, headers, runtime) {
+        request.validate();
+        let query = {};
+        if (!$dara.isNull(request.accessPointId)) {
+            query["accessPointId"] = request.accessPointId;
+        }
+        if (!$dara.isNull(request.fileSystemId)) {
+            query["fileSystemId"] = request.fileSystemId;
+        }
+        if (!$dara.isNull(request.server)) {
+            query["server"] = request.server;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            query: openapi_core_2.OpenApiUtil.query(query),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "GetWorkspaceAgenticFsMountRamAuthorizeUrl",
+            version: "2026-08-04",
+            protocol: "HTTPS",
+            pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/agentic-fs/authorize`,
+            method: "GET",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetWorkspaceAgenticFsMountRamAuthorizeUrlResponse({}));
+    }
+    /**
+     * Queries the RAM authorization URL for mounting AgenticFS in a workspace.
+     *
+     * @remarks
+     * The workspace determines the account, region, and shared role. The resource ARN is constructed based on the specified fileSystemId and accessPointId. The server parameter is used to generate the policy name. This operation does not query NAS or check resource status. The response contains only the authorization URL for the target NAS policy. After completing RAM authorization, call the verification operation.
+     *
+     * @param request - GetWorkspaceAgenticFsMountRamAuthorizeUrlRequest
+     * @returns GetWorkspaceAgenticFsMountRamAuthorizeUrlResponse
+     */
+    async getWorkspaceAgenticFsMountRamAuthorizeUrl(workspaceId, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.getWorkspaceAgenticFsMountRamAuthorizeUrlWithOptions(workspaceId, request, headers, runtime);
+    }
     /**
      * Queries the plug-in status of a specified workspace.
      *
@@ -3012,7 +3066,7 @@ class Client extends openapi_core_1.default {
      * Installs an MCP marketplace template.
      *
      * @remarks
-     * Validates input based on the specified template version and creates an MCP in the workspace.
+     * Validates the input based on the specified template version and creates an MCP in the workspace.
      *
      * @param tmpReq - InstallMcpMarketItemRequest
      * @param headers - map
@@ -3059,7 +3113,7 @@ class Client extends openapi_core_1.default {
      * Installs an MCP marketplace template.
      *
      * @remarks
-     * Validates input based on the specified template version and creates an MCP in the workspace.
+     * Validates the input based on the specified template version and creates an MCP in the workspace.
      *
      * @param request - InstallMcpMarketItemRequest
      * @returns InstallMcpMarketItemResponse
@@ -3185,11 +3239,11 @@ class Client extends openapi_core_1.default {
         return await this.listAgentIMChannelsWithOptions(workspaceId, agentId, request, headers, runtime);
     }
     /**
-     * Queries AgentSpec resources in a specified workspace by using paging, supporting name search, sorting, and filtering by owner, visibility scope, and business labels.
+     * Queries AgentSpec resources in a specified workspace by using paging, and supports name-based search, sorting, and filtering by owner, visibility scope, and business labels.
      *
      * @remarks
      * ## Operation description
-     * Queries AgentSpec resources in a specified workspace by using paging, supporting name search, sorting, and filtering by owner, visibility scope, and business labels.
+     * Queries AgentSpec resources in a specified workspace by using paging, and supports name-based search, sorting, and filtering by owner, visibility scope, and business labels.
      *
      * @param request - ListAgentSpecsRequest
      * @param headers - map
@@ -3244,11 +3298,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListAgentSpecsResponse({}));
     }
     /**
-     * Queries AgentSpec resources in a specified workspace by using paging, supporting name search, sorting, and filtering by owner, visibility scope, and business labels.
+     * Queries AgentSpec resources in a specified workspace by using paging, and supports name-based search, sorting, and filtering by owner, visibility scope, and business labels.
      *
      * @remarks
      * ## Operation description
-     * Queries AgentSpec resources in a specified workspace by using paging, supporting name search, sorting, and filtering by owner, visibility scope, and business labels.
+     * Queries AgentSpec resources in a specified workspace by using paging, and supports name-based search, sorting, and filtering by owner, visibility scope, and business labels.
      *
      * @param request - ListAgentSpecsRequest
      * @returns ListAgentSpecsResponse
@@ -3745,6 +3799,9 @@ class Client extends openapi_core_1.default {
     async listMcpsWithOptions(workspaceId, request, headers, runtime) {
         request.validate();
         let query = {};
+        if (!$dara.isNull(request.customTag)) {
+            query["customTag"] = request.customTag;
+        }
         if (!$dara.isNull(request.maxResults)) {
             query["maxResults"] = request.maxResults;
         }
@@ -4163,6 +4220,57 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.listServiceEndpointsWithOptions(workspaceId, request, headers, runtime);
     }
+    /**
+     * Queries the reference relationships of a skill.
+     *
+     * @param request - ListSkillReferencesRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns ListSkillReferencesResponse
+     */
+    async listSkillReferencesWithOptions(workspaceId, skillName, request, headers, runtime) {
+        request.validate();
+        let query = {};
+        if (!$dara.isNull(request.pageNo)) {
+            query["pageNo"] = request.pageNo;
+        }
+        if (!$dara.isNull(request.pageSize)) {
+            query["pageSize"] = request.pageSize;
+        }
+        if (!$dara.isNull(request.selectorType)) {
+            query["selectorType"] = request.selectorType;
+        }
+        if (!$dara.isNull(request.selectorValue)) {
+            query["selectorValue"] = request.selectorValue;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            query: openapi_core_2.OpenApiUtil.query(query),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "ListSkillReferences",
+            version: "2026-08-04",
+            protocol: "HTTPS",
+            pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/skills/${$dara.URL.percentEncode(skillName)}/references`,
+            method: "GET",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListSkillReferencesResponse({}));
+    }
+    /**
+     * Queries the reference relationships of a skill.
+     *
+     * @param request - ListSkillReferencesRequest
+     * @returns ListSkillReferencesResponse
+     */
+    async listSkillReferences(workspaceId, skillName, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.listSkillReferencesWithOptions(workspaceId, skillName, request, headers, runtime);
+    }
     /**
      * Performs a paged query of Skills in a specified workspace, and returns basic Skill information, version status, and paging details.
      *
@@ -4394,7 +4502,7 @@ class Client extends openapi_core_1.default {
      * Takes the online version of a specified Skill offline so that it is no longer used as the online version.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Takes the online version of a specified Skill offline so that it is no longer used as the online version.
      *
      * @param tmpReq - OfflineSkillRequest
@@ -4434,7 +4542,7 @@ class Client extends openapi_core_1.default {
      * Takes the online version of a specified Skill offline so that it is no longer used as the online version.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Takes the online version of a specified Skill offline so that it is no longer used as the online version.
      *
      * @param request - OfflineSkillRequest
@@ -4504,7 +4612,7 @@ class Client extends openapi_core_1.default {
      * Parses and checks one or more Skill ZIP packages uploaded to OSS, and returns the name, version, and conflict check results.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Parses and checks one or more Skill ZIP packages uploaded to OSS, and returns the name, version, and conflict check results.
      *
      * @param tmpReq - PrecheckSkillUploadViaOssRequest
@@ -4544,7 +4652,7 @@ class Client extends openapi_core_1.default {
      * Parses and checks one or more Skill ZIP packages uploaded to OSS, and returns the name, version, and conflict check results.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Parses and checks one or more Skill ZIP packages uploaded to OSS, and returns the name, version, and conflict check results.
      *
      * @param request - PrecheckSkillUploadViaOssRequest
@@ -4556,11 +4664,11 @@ class Client extends openapi_core_1.default {
         return await this.precheckSkillUploadViaOssWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * Publishes a specified Skill version to change its state to published.
+     * Publishes a specified Skill version to transition it to the published state.
      *
      * @remarks
      * ## Operation description
-     * Publishes a specified Skill version to change its state to published.
+     * Publishes a specified Skill version to transition it to the published state.
      *
      * @param tmpReq - PublishSkillVersionRequest
      * @param headers - map
@@ -4596,11 +4704,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.PublishSkillVersionResponse({}));
     }
     /**
-     * Publishes a specified Skill version to change its state to published.
+     * Publishes a specified Skill version to transition it to the published state.
      *
      * @remarks
      * ## Operation description
-     * Publishes a specified Skill version to change its state to published.
+     * Publishes a specified Skill version to transition it to the published state.
      *
      * @param request - PublishSkillVersionRequest
      * @returns PublishSkillVersionResponse
@@ -5325,7 +5433,7 @@ class Client extends openapi_core_1.default {
      * Updates MCP parameters by template.
      *
      * @remarks
-     * Updates the schema-exposed parameters by using the same template version that was bound when the MCP was created. This operation does not upgrade the template version.
+     * Updates the schema-exposed parameters by using the same template version that was bound when the MCP was created, without upgrading the template version.
      *
      * @param tmpReq - UpdateMcpTemplateConfigRequest
      * @param headers - map
@@ -5372,7 +5480,7 @@ class Client extends openapi_core_1.default {
      * Updates MCP parameters by template.
      *
      * @remarks
-     * Updates the schema-exposed parameters by using the same template version that was bound when the MCP was created. This operation does not upgrade the template version.
+     * Updates the schema-exposed parameters by using the same template version that was bound when the MCP was created, without upgrading the template version.
      *
      * @param request - UpdateMcpTemplateConfigRequest
      * @returns UpdateMcpTemplateConfigResponse
@@ -5555,7 +5663,7 @@ class Client extends openapi_core_1.default {
      * Updates the version labels and their mappings for a specified Skill.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Updates the version labels and their mappings for a specified Skill.
      *
      * @param tmpReq - UpdateSkillLabelsRequest
@@ -5595,7 +5703,7 @@ class Client extends openapi_core_1.default {
      * Updates the version labels and their mappings for a specified Skill.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Updates the version labels and their mappings for a specified Skill.
      *
      * @param request - UpdateSkillLabelsRequest
@@ -6040,6 +6148,54 @@ class Client extends openapi_core_1.default {
         let headers = {};
         return await this.verifyWorkspaceAcrRamAuthorizationWithOptions(workspaceId, request, headers, runtime);
     }
+    /**
+     * Queries the RAM authorization status of AgenticFS mounting for a workspace.
+     *
+     * @remarks
+     * Determines the shared role and target access point based on the workspace and server, checks whether the role has a mounted policy with the expected name and a type of Custom, and returns AUTHORIZED or UNAUTHORIZED. Consistent with OSS/ACR, this operation does not verify the policy body, role trust, or actual mount read/write permissions. If the upstream query fails, an error is returned.
+     *
+     * @param request - VerifyWorkspaceAgenticFsMountRamAuthorizationRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns VerifyWorkspaceAgenticFsMountRamAuthorizationResponse
+     */
+    async verifyWorkspaceAgenticFsMountRamAuthorizationWithOptions(workspaceId, request, headers, runtime) {
+        request.validate();
+        let query = {};
+        if (!$dara.isNull(request.server)) {
+            query["server"] = request.server;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            query: openapi_core_2.OpenApiUtil.query(query),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "VerifyWorkspaceAgenticFsMountRamAuthorization",
+            version: "2026-08-04",
+            protocol: "HTTPS",
+            pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/agentic-fs/authorize/verify`,
+            method: "GET",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "json",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.VerifyWorkspaceAgenticFsMountRamAuthorizationResponse({}));
+    }
+    /**
+     * Queries the RAM authorization status of AgenticFS mounting for a workspace.
+     *
+     * @remarks
+     * Determines the shared role and target access point based on the workspace and server, checks whether the role has a mounted policy with the expected name and a type of Custom, and returns AUTHORIZED or UNAUTHORIZED. Consistent with OSS/ACR, this operation does not verify the policy body, role trust, or actual mount read/write permissions. If the upstream query fails, an error is returned.
+     *
+     * @param request - VerifyWorkspaceAgenticFsMountRamAuthorizationRequest
+     * @returns VerifyWorkspaceAgenticFsMountRamAuthorizationResponse
+     */
+    async verifyWorkspaceAgenticFsMountRamAuthorization(workspaceId, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.verifyWorkspaceAgenticFsMountRamAuthorizationWithOptions(workspaceId, request, headers, runtime);
+    }
     /**
      * Verifies the RAM authorization for a workspace to access an OSS bucket and returns the current authorization status. When bucketName is specified, verifies the authorization for an agent-mounted bucket. When bucketName is not specified, verifies and updates the authorization status of the workspace\\"s private OSS storage.
      *