devops-mcp-server-extension 1.0.0

package/dist/operations/appstack/changeOrders.js

@@ -0,0 +1,320 @@
+import { z } from 'zod';
+import { yunxiaoRequest, buildUrl, isRegionEdition } from '../../common/utils.js';
+import { resolveOrganizationId } from '../organization/organization.js';
+// Schema for EnvDeployRequest
+export const EnvDeployRequestSchema = z.object({
+    values: z.record(z.string()).optional().describe("环境部署参数键值对"),
+});
+// Schema for CreateChangeOrderReq
+export const CreateChangeOrderReqSchema = z.object({
+    changeOrderName: z.string().describe("部署单名称"),
+    description: z.string().optional().describe("描述"),
+    envs: z.record(EnvDeployRequestSchema).describe("环境信息，key为环境名称，value为对应环境部署单参数（当前仅支持单环境部署）"),
+    orchestrationRevisionSha: z.string().optional().describe("编排版本sha值，部署单类型为Deploy时必填"),
+    rollbackChangeOrderVersion: z.string().optional().describe("部署单类型为Rollback时必填，指定回滚时使用的部署版本号"),
+    type: z.string().describe("部署单类型：Deploy-部署，Scale-扩缩，Rollback-回滚，Destroy-删除资源"),
+});
+// Schema for JobSummary
+export const JobSummarySchema = z.object({
+    operator: z.string().nullable().optional().describe("操作人"),
+    action: z.string().nullable().optional().describe("操作类型"),
+    state: z.string().nullable().optional().describe("环境部署单状态"),
+    jobSn: z.string().nullable().optional().describe("环境部署单编号"),
+    message: z.string().nullable().optional().describe("消息"),
+    gmtCreate: z.string().nullable().optional().describe("创建时间"),
+    sn: z.string().nullable().optional().describe("环境部署单唯一标识"),
+    envName: z.string().nullable().optional().describe("环境名称"),
+});
+// Schema for ChangeOrderSummary
+export const ChangeOrderSummarySchema = z.object({
+    creator: z.string().describe("创建人"),
+    description: z.string().nullable().optional().describe("描述"),
+    endedAt: z.string().nullable().optional().describe("部署单结束时间"),
+    gmtCreate: z.string().describe("部署单最后修改时间"),
+    jobs: z.array(JobSummarySchema).describe("环境部署单列表"),
+    name: z.string().describe("部署单名称"),
+    sn: z.string().describe("部署单唯一标识"),
+    startedAt: z.string().nullable().optional().describe("部署单开始时间"),
+    state: z.enum(["INIT", "PREPARING", "RUNNING", "SUSPENDED", "CANCELED", "SUCCESS", "FAILED"]).describe("部署单状态"),
+    type: z.enum(["Deploy", "Scale", "Rollback", "Destroy"]).describe("部署单类型"),
+    version: z.string().describe("使用版本"),
+});
+// Schema for ChangeOrderVersionRecord
+export const ChangeOrderVersionRecordSchema = z.object({
+    // Based on the reference in the swagger, we'll define a basic structure
+    // You may need to update this with the actual fields from ChangeOrderVersionRecord
+    version: z.string().optional().describe("部署单版本"),
+    changeOrderSn: z.string().optional().describe("部署单编号"),
+});
+// Schema for JobLog
+export const JobLogSchema = z.object({
+    content: z.string().nullable().optional().describe("日志内容"),
+    timestamp: z.string().nullable().optional().describe("日志时间戳"),
+});
+// Schema for ActionContext
+export const ActionContextSchema = z.object({
+    comment: z.string().describe("操作备注"),
+});
+// Schema for ChangeJobActionReq
+export const ChangeJobActionReqSchema = z.object({
+    actionType: z.string().describe("操作类型:SUSPEND-暂停，RESUME-恢复，ROLLBACK-回滚，STOP-终止"),
+    context: ActionContextSchema.optional().describe("操作上下文，comment 为操作备注"),
+});
+// Schema for CreateChangeOrder API
+export const CreateChangeOrderRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    changeOrder: CreateChangeOrderReqSchema,
+});
+export const CreateChangeOrderResponseSchema = ChangeOrderSummarySchema;
+// Schema for ListChangeOrderVersions API
+export const ListChangeOrderVersionsRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    envNames: z.array(z.string()).optional().describe("环境标识列表，如不需按环境过滤，请置空"),
+    creators: z.array(z.string()).optional().describe("创建人云效账号id列表，如不需按创建人过滤，请置空"),
+    current: z.number().default(1).describe("当前页号（从 1 开始，默认取 1）"),
+    pageSize: z.number().default(10).describe("分页记录数（默认 10 条）"),
+});
+export const PaginationChangeOrderVersionRecordSchema = z.object({
+    current: z.number().describe("当前页数"),
+    pageSize: z.number().describe("每页大小"),
+    pages: z.number().describe("总页数"),
+    records: z.array(ChangeOrderVersionRecordSchema).describe("数据列表"),
+    total: z.number().describe("总数"),
+});
+export const ListChangeOrderVersionsResponseSchema = PaginationChangeOrderVersionRecordSchema;
+// Schema for GetChangeOrder API
+export const GetChangeOrderRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    changeOrderSn: z.string().describe("部署单编号"),
+});
+export const GetChangeOrderResponseSchema = ChangeOrderSummarySchema;
+// Schema for ListChangeOrderJobLogs API
+export const ListChangeOrderJobLogsRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    changeOrderSn: z.string().describe("部署单号"),
+    jobSn: z.string().describe("作业单号"),
+    current: z.number().default(1),
+    pageSize: z.number().default(10),
+});
+export const PaginationJobLogSchema = z.object({
+    current: z.number().describe("当前页数"),
+    pageSize: z.number().describe("每页大小"),
+    pages: z.number().describe("总页数"),
+    records: z.array(JobLogSchema).describe("数据列表"),
+    total: z.number().describe("总数"),
+});
+export const ListChangeOrderJobLogsResponseSchema = PaginationJobLogSchema;
+// Schema for FindTaskOperationLog API
+export const FindTaskOperationLogRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string(),
+    changeOrderSn: z.string(),
+    jobSn: z.string(),
+    stageSn: z.string(),
+    taskSn: z.string(),
+});
+export const FindTaskOperationLogResponseSchema = z.string();
+// Schema for ExecuteJobAction API
+export const ExecuteJobActionRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    changeOrderSn: z.string().describe("部署单编号，即 changeOrder.sn"),
+    jobSn: z.string().describe("环境部署单编号，即 job.sn"),
+    action: ChangeJobActionReqSchema,
+});
+export const ExecuteJobActionResponseSchema = ChangeOrderSummarySchema;
+// Schema for ListChangeOrdersByOrigin API
+export const ListChangeOrdersByOriginRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    originType: z.string().describe("创建来源类型"),
+    originId: z.string().describe("创建来源标识"),
+    appName: z.string().optional().describe("应用名"),
+    envName: z.string().optional().describe("环境名"),
+});
+export const ListChangeOrdersByOriginResponseSchema = z.array(ChangeOrderSummarySchema);
+/**
+ * Create a change order (deployment order)
+ *
+ * @param params - The request parameters
+ * @returns The created change order summary
+ */
+export async function createChangeOrder(params) {
+    const { organizationId, appName, changeOrder } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeOrders`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeOrders`;
+        const response = await yunxiaoRequest(url, {
+            method: 'POST',
+            body: changeOrder,
+        });
+        return CreateChangeOrderResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * List change order versions
+ *
+ * @param params - The request parameters
+ * @returns The paginated list of change order versions
+ */
+export async function listChangeOrderVersions(params) {
+    const { organizationId, appName, envNames, creators, current, pageSize } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const query = {
+            current,
+            pageSize
+        };
+        if (envNames && envNames.length > 0) {
+            query.envNames = envNames;
+        }
+        if (creators && creators.length > 0) {
+            query.creators = creators;
+        }
+        const baseUrl = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeOrders/versions`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeOrders/versions`;
+        const url = buildUrl(baseUrl, query);
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return ListChangeOrderVersionsResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Get a change order by its serial number
+ *
+ * @param params - The request parameters
+ * @returns The change order summary
+ */
+export async function getChangeOrder(params) {
+    const { organizationId, appName, changeOrderSn } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeOrders/${changeOrderSn}`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeOrders/${changeOrderSn}`;
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return GetChangeOrderResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * List change order job logs
+ *
+ * @param params - The request parameters
+ * @returns The paginated list of job logs
+ */
+export async function listChangeOrderJobLogs(params) {
+    const { organizationId, appName, changeOrderSn, jobSn, current, pageSize } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const baseUrl = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeOrders/${changeOrderSn}/jobs/${jobSn}/logs`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeOrders/${changeOrderSn}/jobs/${jobSn}/logs`;
+        const url = buildUrl(baseUrl, {
+            current,
+            pageSize
+        });
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return ListChangeOrderJobLogsResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Find task operation log
+ *
+ * @param params - The request parameters
+ * @returns The task operation log content
+ */
+export async function findTaskOperationLog(params) {
+    const { organizationId, appName, changeOrderSn, jobSn, stageSn, taskSn } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeOrders/${changeOrderSn}/jobs/${jobSn}/stages/${stageSn}/tasks/${taskSn}/operationLog`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeOrders/${changeOrderSn}/jobs/${jobSn}/stages/${stageSn}/tasks/${taskSn}/operationLog`;
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return FindTaskOperationLogResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Execute a job action
+ *
+ * @param params - The request parameters
+ * @returns The updated change order summary
+ */
+export async function executeJobAction(params) {
+    const { organizationId, appName, changeOrderSn, jobSn, action } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeOrders/${changeOrderSn}/jobs/${jobSn}:execute`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeOrders/${changeOrderSn}/jobs/${jobSn}:execute`;
+        const response = await yunxiaoRequest(url, {
+            method: 'PUT',
+            body: action,
+        });
+        return ExecuteJobActionResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * List change orders by origin
+ *
+ * @param params - The request parameters
+ * @returns The list of change orders
+ */
+export async function listChangeOrdersByOrigin(params) {
+    const { organizationId, originType, originId, appName, envName } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const query = {
+            originType,
+            originId
+        };
+        if (appName) {
+            query.appName = appName;
+        }
+        if (envName) {
+            query.envName = envName;
+        }
+        const baseUrl = isRegionEdition()
+            ? `/oapi/v1/appstack/changeOrders:byOrigin`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/changeOrders:byOrigin`;
+        const url = buildUrl(baseUrl, query);
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return ListChangeOrdersByOriginResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}

package/dist/operations/appstack/changeRequests.js

@@ -0,0 +1,288 @@
+import { z } from 'zod';
+import { yunxiaoRequest, buildUrl, isRegionEdition } from '../../common/utils.js';
+import { resolveOrganizationId } from '../organization/organization.js';
+// Define the referenced schemas based on their definitions in appstack.swagger.json
+const AuditItemSchema = z.object({
+    auditOrderSn: z.string().optional(),
+    refSn: z.string(),
+    refType: z.enum(["CR"]),
+    state: z.string(),
+    type: z.enum(["CODE_SPLC", "CODE_REVIEW"]),
+}).describe("审批项");
+const StageMetadataCommitVOSchema = z.object({
+    committedDate: z.string().describe("提交时间"),
+    committerId: z.string().describe("提交人"),
+    id: z.string().describe("变更执行记录版本ID"),
+}).describe("变更执行记录版本");
+const ChangeRequestExecutionVOSchema = z.object({
+    commit: StageMetadataCommitVOSchema.describe("变更执行记录版本"),
+    runNumber: z.string().describe("运行序号"),
+    state: z.enum(["RUNNING", "SUCCESS", "FAILED", "CANCELED", "UNKNOWN"]).describe("阶段执行状态"),
+}).describe("变更执行记录");
+const CodeReviewAuditItemSchema = AuditItemSchema.extend({
+    auditOrderSn: z.string().optional().describe("审批单编号"),
+    commitId: z.string().optional().describe("代码提交 ID"),
+    crId: z.string().describe("变更 ID"),
+    operatorId: z.string().describe("代码提交人 ID"),
+    refSn: z.string().optional(),
+    refType: z.string().optional(),
+    sourceVersion: z.string().describe("代码来源分支版本"),
+    state: z.string().describe("审批状态"),
+    targetVersion: z.string().describe("代码目标分支版本"),
+    type: z.string().describe("审批类型"),
+    url: z.string().optional().describe("代码提交 URL"),
+}).describe("代码审核审批项");
+const CodeSplcAuditItemSchema = AuditItemSchema.extend({
+    auditOrderSn: z.string().optional().describe("审批单编号"),
+    commitDate: z.string().describe("提交时间"),
+    commitEmployeeId: z.string().describe("提交人"),
+    commitMsg: z.string().optional().describe("提交信息"),
+    crId: z.string().describe("变更 ID"),
+    refSn: z.string().optional(),
+    refType: z.string().optional(),
+    state: z.string().describe("审批状态"),
+    trunkVersion: z.string().describe("主干版本"),
+    type: z.string().describe("审批类型"),
+    url: z.string().optional().describe("提交地址"),
+    version: z.string().describe("变更版本"),
+}).describe("代码扫描审批项");
+// Schema for the CreateChangeRequest API
+export const CreateChangeRequestRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    appCodeRepoSn: z.string().describe("应用代码仓库标识符"),
+    autoDeleteBranchWhenEnd: z.boolean().describe("变更结束时候是否自动删除分支"),
+    branchName: z.string().describe("应用代码分支名称"),
+    createBranch: z.boolean().describe("是否创建分支"),
+    ownerAccountId: z.string().optional().describe("变更负责人账号"),
+    ownerId: z.string().optional().describe("变更负责人"),
+    title: z.string().describe("变更标题"),
+});
+export const CreateChangeRequestResponseSchema = z.object({
+    appCodeRepoSn: z.string().optional().describe("代码仓库唯一标识"),
+    appName: z.string().describe("应用名"),
+    autoDeleteBranchWhenEnd: z.boolean().describe("结束后是否自动删除分支"),
+    branch: z.string().optional().describe("变更代码分支"),
+    creatorAccountId: z.string().optional().describe("创建者的阿里云账号pk"),
+    creatorId: z.string().optional().describe("创建者者云效id"),
+    gmtCreate: z.string().describe("创建时间"),
+    gmtModified: z.string().describe("修改时间"),
+    name: z.string().optional().describe("变更名称"),
+    originBranch: z.string().optional().describe("代码分支源分支"),
+    originBranchRevisionSha: z.string().optional().describe("代码分支源分支版本"),
+    ownerAccountId: z.string().optional().describe("拥有者的阿里云账号pk"),
+    ownerId: z.string().optional().describe("拥有者ID"),
+    sn: z.string().describe("唯一标识符"),
+    state: z.string().describe("状态"),
+    type: z.string().describe("变更类型"),
+});
+// Schema for the GetChangeRequestAuditItems API
+export const GetChangeRequestAuditItemsRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    sn: z.string().describe("变更标识符"),
+    refType: z.string().describe("关联类型"),
+});
+export const GetChangeRequestAuditItemsResponseSchema = z.array(z.union([
+    CodeReviewAuditItemSchema,
+    CodeSplcAuditItemSchema
+]));
+// Schema for the ListChangeRequestExecutions API
+export const ListChangeRequestExecutionsRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    sn: z.string().describe("变更标识符"),
+    perPage: z.number().min(1).max(100).default(20).optional().describe("分页尺寸参数，决定一页最多返回多少对象"),
+    page: z.number().optional().describe("页面分页时使用，用于获取下一页内容，默认第1页"),
+    orderBy: z.enum(["id", "gmtCreate"]).optional().describe("分页排序属性，决定根据何种属性进行记录排序；推荐在实现严格遍历时，使用 id 属性"),
+    sort: z.enum(["asc", "desc"]).optional().describe("分页排序升降序，asc 为升序，desc 为降序；推荐在实现严格遍历时，使用升序"),
+    releaseWorkflowSn: z.string().describe("流程唯一标识"),
+    releaseStageSn: z.string().describe("阶段唯一标识"),
+});
+export const ListChangeRequestExecutionsResponseSchema = z.object({
+    current: z.number().describe("当前页数"),
+    pageSize: z.number().describe("每页大小"),
+    pages: z.number().describe("总页数"),
+    records: z.array(ChangeRequestExecutionVOSchema).describe("数据列表"),
+    total: z.number().describe("总数"),
+});
+// Schema for the ListChangeRequestWorkItems API
+export const ListChangeRequestWorkItemsRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    sn: z.string().describe("变更标识符"),
+});
+export const ListChangeRequestWorkItemsResponseSchema = z.array(z.object({
+    description: z.string().optional().describe("变更工作项描述"),
+    name: z.string().optional().describe("变更工作项名称"),
+    sn: z.string().optional().describe("变更工作项唯一标识"),
+    type: z.string().optional().describe("变更工作项类型"),
+    value: z.string().optional().describe("变更工作项内容"),
+}));
+// Schema for the CancelChangeRequest API
+export const CancelChangeRequestRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    sn: z.string().describe("变更标识符"),
+});
+export const CancelChangeRequestResponseSchema = z.boolean().describe("调用是否成功");
+// Schema for the CloseChangeRequest API
+export const CloseChangeRequestRequestSchema = z.object({
+    organizationId: z.string().describe("组织ID"),
+    appName: z.string().describe("应用名"),
+    sn: z.string().describe("变更标识符"),
+});
+export const CloseChangeRequestResponseSchema = z.boolean().describe("调用是否成功");
+/**
+ * Create a change request
+ *
+ * @param params - The request parameters
+ * @returns The created change request
+ */
+export async function createChangeRequest(params) {
+    const { organizationId, appName, ...body } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeRequests`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeRequests`;
+        const response = await yunxiaoRequest(url, {
+            method: 'POST',
+            body: body,
+        });
+        return CreateChangeRequestResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Get audit items for a change request
+ *
+ * @param params - The request parameters
+ * @returns The list of audit items
+ */
+export async function getChangeRequestAuditItems(params) {
+    const { organizationId, appName, sn, refType } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    // Build query string properly
+    const query = {};
+    if (refType)
+        query.refType = refType;
+    try {
+        const baseUrl = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeRequests/${sn}/auditItems`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeRequests/${sn}/auditItems`;
+        const url = buildUrl(baseUrl, query);
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return GetChangeRequestAuditItemsResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * List change request executions
+ *
+ * @param params - The request parameters
+ * @returns The list of change request executions
+ */
+export async function listChangeRequestExecutions(params) {
+    const { organizationId, appName, sn, perPage, page, orderBy, sort, releaseWorkflowSn, releaseStageSn } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    // Build query string properly
+    const query = {};
+    if (perPage !== undefined)
+        query.perPage = perPage;
+    if (page !== undefined)
+        query.page = page;
+    if (orderBy)
+        query.orderBy = orderBy;
+    if (sort)
+        query.sort = sort;
+    if (releaseWorkflowSn)
+        query.releaseWorkflowSn = releaseWorkflowSn;
+    if (releaseStageSn)
+        query.releaseStageSn = releaseStageSn;
+    try {
+        const baseUrl = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeRequests/${sn}/executions`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeRequests/${sn}/executions`;
+        const url = buildUrl(baseUrl, query);
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return ListChangeRequestExecutionsResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * List work items for a change request
+ *
+ * @param params - The request parameters
+ * @returns The list of work items
+ */
+export async function listChangeRequestWorkItems(params) {
+    const { organizationId, appName, sn } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeRequests/${sn}/workItems`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeRequests/${sn}/workItems`;
+        const response = await yunxiaoRequest(url, {
+            method: 'GET',
+        });
+        return ListChangeRequestWorkItemsResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Cancel a change request
+ *
+ * @param params - The request parameters
+ * @returns Whether the cancellation was successful
+ */
+export async function cancelChangeRequest(params) {
+    const { organizationId, appName, sn } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeRequests/${sn}:cancel`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeRequests/${sn}:cancel`;
+        const response = await yunxiaoRequest(url, {
+            method: 'POST',
+        });
+        return CancelChangeRequestResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}
+/**
+ * Close a change request
+ *
+ * @param params - The request parameters
+ * @returns Whether the close operation was successful
+ */
+export async function closeChangeRequest(params) {
+    const { organizationId, appName, sn } = params;
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    try {
+        const url = isRegionEdition()
+            ? `/oapi/v1/appstack/apps/${appName}/changeRequests/${sn}:finish`
+            : `/oapi/v1/appstack/organizations/${finalOrgId}/apps/${appName}/changeRequests/${sn}:finish`;
+        const response = await yunxiaoRequest(url, {
+            method: 'POST',
+        });
+        return CloseChangeRequestResponseSchema.parse(response);
+    }
+    catch (error) {
+        throw error;
+    }
+}