@alicloud/agentcore20260804 2.1.1 → 2.2.1

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
@@ -1561,7 +1561,7 @@ class Client extends openapi_core_1.default {
      * Deletes the draft version currently being edited for a specified Skill.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Deletes the draft version currently being edited for a specified Skill.
      *
      * @param request - DeleteSkillDraftRequest
@@ -1591,7 +1591,7 @@ class Client extends openapi_core_1.default {
      * Deletes the draft version currently being edited for a specified Skill.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Deletes the draft version currently being edited for a specified Skill.
      *
      * @param request - DeleteSkillDraftRequest
@@ -1826,7 +1826,7 @@ class Client extends openapi_core_1.default {
      * Retrieves a pre-signed OSS download URL for a specified Skill version, which is used to download the corresponding Skill ZIP package.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Retrieves a pre-signed OSS download URL for a specified Skill version, which is used to download the corresponding Skill ZIP package.
      *
      * @param request - DownloadSkillVersionViaOssRequest
@@ -1856,7 +1856,7 @@ class Client extends openapi_core_1.default {
      * Retrieves a pre-signed OSS download URL for a specified Skill version, which is used to download the corresponding Skill ZIP package.
      *
      * @remarks
-     * ## Request description
+     * ## Operation description
      * Retrieves a pre-signed OSS download URL for a specified Skill version, which is used to download the corresponding Skill ZIP package.
      *
      * @param request - DownloadSkillVersionViaOssRequest
@@ -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
@@ -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.
      *
@@ -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
@@ -4167,11 +4221,62 @@ class Client extends openapi_core_1.default {
         return await this.listServiceEndpointsWithOptions(workspaceId, request, headers, runtime);
     }
     /**
-     * Performs a paged query of Skills in a specified workspace, and returns basic Skill information, version status, and paging details.
+     * 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 information.
      *
      * @remarks
      * ## Operation description
-     * Performs a paged query of Skills in a specified workspace, and returns basic Skill information, version status, and paging details.
+     * Performs a paged query of Skills in a specified workspace and returns basic Skill information, version status, and paging information.
      *
      * @param request - ListSkillsRequest
      * @param headers - map
@@ -4226,11 +4331,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListSkillsResponse({}));
     }
     /**
-     * Performs a paged query of Skills in a specified workspace, and returns basic Skill information, version status, and paging details.
+     * Performs a paged query of Skills in a specified workspace and returns basic Skill information, version status, and paging information.
      *
      * @remarks
      * ## Operation description
-     * Performs a paged query of Skills in a specified workspace, and returns basic Skill information, version status, and paging details.
+     * Performs a paged query of Skills in a specified workspace and returns basic Skill information, version status, and paging information.
      *
      * @param request - ListSkillsRequest
      * @returns ListSkillsResponse
@@ -4397,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
@@ -4437,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
@@ -4507,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
@@ -4547,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
@@ -4559,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
@@ -4599,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
@@ -4614,11 +4719,11 @@ class Client extends openapi_core_1.default {
         return await this.publishSkillVersionWithOptions(workspaceId, skillName, skillVersion, request, headers, runtime);
     }
     /**
-     * Converts a specified Skill version back into an editable draft for further modifications.
+     * Converts a specified Skill version back to an editable draft so that you can continue to modify it.
      *
      * @remarks
-     * ## Operation description
-     * Converts a specified Skill version back into an editable draft for further modifications.
+     * ## Request description
+     * Converts a specified Skill version back to an editable draft so that you can continue to modify it.
      *
      * @param tmpReq - RedraftSkillVersionRequest
      * @param headers - map
@@ -4654,11 +4759,11 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.RedraftSkillVersionResponse({}));
     }
     /**
-     * Converts a specified Skill version back into an editable draft for further modifications.
+     * Converts a specified Skill version back to an editable draft so that you can continue to modify it.
      *
      * @remarks
-     * ## Operation description
-     * Converts a specified Skill version back into an editable draft for further modifications.
+     * ## Request description
+     * Converts a specified Skill version back to an editable draft so that you can continue to modify it.
      *
      * @param request - RedraftSkillVersionRequest
      * @returns RedraftSkillVersionResponse
@@ -5558,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
@@ -5598,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
@@ -6043,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.
      *