devops-mcp-server-extension 1.0.0

package/dist/operations/flow/vmDeployOrder.js

@@ -0,0 +1,171 @@
+import * as utils from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { z } from "zod";
+// 定义VM部署单相关的Zod模式
+export const DeployOrderMachineActionSchema = z.object({
+    type: z.string().nullable().optional().describe("类型 RetryVMDeployMachine重试机器部署 SkipVMDeployMachine跳过机器部署 LogVMDeployMachine查看机器部署日志"),
+    disable: z.boolean().nullable().optional().describe("当前用户是否有权限进行后续 action"),
+    params: z.object({}).nullable().optional().describe("参数"),
+});
+export const DeployOrderMachineSchema = z.object({
+    createTime: z.number().int().nullable().optional().describe("创建时间"),
+    updateTime: z.number().int().nullable().optional().describe("更新时间"),
+    status: z.string().nullable().optional().describe("状态 Success成功 Pending待部署 Running部署中 Cancelled取消 Queued部署等待中 Failed失败 Skipped已跳过"),
+    machineSn: z.string().nullable().optional().describe("机器sn"),
+    clientStatus: z.string().nullable().optional().describe("机器状态 ok(正常) error(连接失败)"),
+    ip: z.string().nullable().optional().describe("机器ip"),
+    batchNum: z.number().int().nullable().optional().describe("部署批次"),
+    actions: z.array(DeployOrderMachineActionSchema).nullable().optional().describe("操作列表"),
+});
+export const DeployOrderDeployMachinesSchema = z.object({
+    hostGroupId: z.number().int().nullable().optional().describe("主机组Id"),
+    batchNum: z.number().int().nullable().optional().describe("发布批次"),
+    deployMachines: z.array(DeployOrderMachineSchema).nullable().optional().describe("部署机器列表"),
+});
+export const DeployOrderActionSchema = z.object({
+    type: z.string().nullable().optional().describe("类型 StopVMDeployOrder 取消部署单 ResumeVMDeployOrder 继续部署单运行"),
+    disable: z.boolean().nullable().optional().describe("当前用户是否有权限进行后续 action"),
+    params: z.object({}).nullable().optional().describe("参数"),
+});
+export const DeployOrderSchema = z.object({
+    deployOrderId: z.number().int().nullable().optional().describe("部署单id"),
+    createTime: z.number().int().nullable().optional().describe("创建时间"),
+    updateTime: z.number().int().nullable().optional().describe("更新时间"),
+    creator: z.string().nullable().optional().describe("创建人"),
+    currentBatch: z.number().int().nullable().optional().describe("当前发布批次"),
+    totalBatch: z.number().int().nullable().optional().describe("总发布批次"),
+    status: z.string().nullable().optional().describe("发布状态 Waiting暂停 Running部署中 Cancelled已取消 Success成功"),
+    exceptionCode: z.string().nullable().optional().describe("错误码"),
+    actions: z.array(DeployOrderActionSchema).nullable().optional().describe("操作列表"),
+    deployMachineInfo: DeployOrderDeployMachinesSchema.nullable().optional().describe("部署机器信息"),
+});
+export const DeployOrderLogSchema = z.object({
+    deployLog: z.string().nullable().optional().describe("部署日志"),
+    aliyunRegion: z.string().nullable().optional().describe("部署地域"),
+    deployLogPath: z.string().nullable().optional().describe("部署日志路径"),
+    deployBeginTime: z.string().nullable().optional().describe("部署开始时间"),
+    deployEndTime: z.string().nullable().optional().describe("部署结束时间"),
+});
+// 定义API请求参数的Zod模式
+export const BaseVMDeployOrderSchema = z.object({
+    organizationId: z.string().describe("企业Id"),
+    pipelineId: z.string().describe("流水线Id"),
+    deployOrderId: z.string().describe("部署单Id"),
+});
+export const StopVMDeployOrderSchema = BaseVMDeployOrderSchema;
+export const SkipVMDeployMachineSchema = BaseVMDeployOrderSchema.extend({
+    machineSn: z.string().describe("机器sn"),
+});
+export const RetryVMDeployMachineSchema = BaseVMDeployOrderSchema.extend({
+    machineSn: z.string().describe("机器sn"),
+});
+export const ResumeVMDeployOrderSchema = BaseVMDeployOrderSchema;
+export const GetVMDeployOrderSchema = BaseVMDeployOrderSchema;
+export const GetVMDeployMachineLogSchema = BaseVMDeployOrderSchema.extend({
+    machineSn: z.string().describe("机器sn"),
+});
+/**
+ * 终止机器部署
+ * @param organizationId 企业Id
+ * @param pipelineId 流水线Id
+ * @param deployOrderId 部署单Id
+ * @returns 是否成功
+ */
+export async function stopVMDeployOrderFunc(organizationId, pipelineId, deployOrderId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = utils.isRegionEdition()
+        ? `/oapi/v1/flow/pipelines/${pipelineId}/deploy/${deployOrderId}/stop`
+        : `/oapi/v1/flow/organizations/${finalOrgId}/pipelines/${pipelineId}/deploy/${deployOrderId}/stop`;
+    const response = await utils.yunxiaoRequest(url, {
+        method: "PUT",
+    });
+    return Boolean(response);
+}
+/**
+ * 跳过机器部署
+ * @param organizationId 企业Id
+ * @param pipelineId 流水线Id
+ * @param deployOrderId 部署单Id
+ * @param machineSn 机器sn
+ * @returns 是否成功
+ */
+export async function skipVMDeployMachineFunc(organizationId, pipelineId, deployOrderId, machineSn) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = utils.isRegionEdition()
+        ? `/oapi/v1/flow/pipelines/${pipelineId}/deploy/${deployOrderId}/machine/${machineSn}/skip`
+        : `/oapi/v1/flow/organizations/${finalOrgId}/pipelines/${pipelineId}/deploy/${deployOrderId}/machine/${machineSn}/skip`;
+    const response = await utils.yunxiaoRequest(url, {
+        method: "PUT",
+    });
+    return Boolean(response);
+}
+/**
+ * 重试机器部署
+ * @param organizationId 企业Id
+ * @param pipelineId 流水线Id
+ * @param deployOrderId 部署单Id
+ * @param machineSn 机器sn
+ * @returns 是否成功
+ */
+export async function retryVMDeployMachineFunc(organizationId, pipelineId, deployOrderId, machineSn) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = utils.isRegionEdition()
+        ? `/oapi/v1/flow/pipelines/${pipelineId}/deploy/${deployOrderId}/machine/${machineSn}/retry`
+        : `/oapi/v1/flow/organizations/${finalOrgId}/pipelines/${pipelineId}/deploy/${deployOrderId}/machine/${machineSn}/retry`;
+    const response = await utils.yunxiaoRequest(url, {
+        method: "PUT",
+    });
+    return Boolean(response);
+}
+/**
+ * 继续部署单运行
+ * @param organizationId 企业Id
+ * @param pipelineId 流水线Id
+ * @param deployOrderId 部署单Id
+ * @returns 是否成功
+ */
+export async function resumeVMDeployOrderFunc(organizationId, pipelineId, deployOrderId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = utils.isRegionEdition()
+        ? `/oapi/v1/flow/pipelines/${pipelineId}/deploy/${deployOrderId}/resume`
+        : `/oapi/v1/flow/organizations/${finalOrgId}/pipelines/${pipelineId}/deploy/${deployOrderId}/resume`;
+    const response = await utils.yunxiaoRequest(url, {
+        method: "PUT",
+    });
+    return Boolean(response);
+}
+/**
+ * 获取部署单详情
+ * @param organizationId 企业Id
+ * @param pipelineId 流水线id
+ * @param deployOrderId 部署Id
+ * @returns 部署单详情
+ */
+export async function getVMDeployOrderFunc(organizationId, pipelineId, deployOrderId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = utils.isRegionEdition()
+        ? `/oapi/v1/flow/pipelines/${pipelineId}/deploy/${deployOrderId}`
+        : `/oapi/v1/flow/organizations/${finalOrgId}/pipelines/${pipelineId}/deploy/${deployOrderId}`;
+    const response = await utils.yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return DeployOrderSchema.parse(response);
+}
+/**
+ * 查询机器部署日志
+ * @param organizationId 企业Id
+ * @param pipelineId 流水线Id
+ * @param deployOrderId 部署单Id
+ * @param machineSn 机器sn
+ * @returns 机器部署日志
+ */
+export async function getVMDeployMachineLogFunc(organizationId, pipelineId, deployOrderId, machineSn) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = utils.isRegionEdition()
+        ? `/oapi/v1/flow/pipelines/${pipelineId}/deploy/${deployOrderId}/machine/${machineSn}/log`
+        : `/oapi/v1/flow/organizations/${finalOrgId}/pipelines/${pipelineId}/deploy/${deployOrderId}/machine/${machineSn}/log`;
+    const response = await utils.yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return DeployOrderLogSchema.parse(response);
+}

package/dist/operations/organization/members.js

@@ -0,0 +1,106 @@
+import { OrganizationMembersSchema, MemberInfoSchema, SearchOrganizationMembersResultSchema, } from './types.js';
+import { buildUrl, yunxiaoRequest, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "./organization.js";
+/**
+ * 查询组织成员列表
+ * @param organizationId 组织ID
+ * @param page 当前页，默认1
+ * @param perPage 每页数据条数，默认100
+ * @returns 组织成员列表
+ */
+export const getOrganizationMembersFunc = async (organizationId, page = 1, perPage = 100) => {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/platform/members`
+        : `/oapi/v1/platform/organizations/${finalOrgId}/members`;
+    const params = {
+        page: page,
+        perPage: perPage
+    };
+    const urlWithParams = buildUrl(url, params);
+    const response = await yunxiaoRequest(urlWithParams, {
+        method: "GET",
+    });
+    // 验证响应数据结构
+    return OrganizationMembersSchema.parse(response);
+};
+/**
+ * 查询组织成员详细信息
+ * @param organizationId 组织ID
+ * @param memberId 成员ID
+ * @returns 组织成员详细信息
+ */
+export const getOrganizationMemberInfoFunc = async (organizationId, memberId) => {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/platform/members/${memberId}`
+        : `/oapi/v1/platform/organizations/${finalOrgId}/members/${memberId}`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return MemberInfoSchema.parse(response);
+};
+/**
+ * 搜索组织成员
+ * @param organizationId 组织ID
+ * @param includeChildren
+ * @param page 当前页，默认1
+ * @param perPage 每页数据条数，默认100
+ * @param deptIds
+ * @param nextToken
+ * @param query
+ * @param roleIds
+ * @param statuses
+ * @returns 搜索到的组织成员列表
+ */
+export const searchOrganizationMembersFunc = async (organizationId, includeChildren = false, page = 1, perPage = 100, deptIds, nextToken, query, roleIds, statuses) => {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/platform/members:search`
+        : `/oapi/v1/platform/organizations/${finalOrgId}/members:search`;
+    const payload = {
+        page: page,
+        perPage: perPage
+    };
+    if (deptIds) {
+        payload.deptIds = deptIds;
+    }
+    if (nextToken) {
+        payload.nextToken = nextToken;
+    }
+    if (query) {
+        payload.query = query;
+    }
+    if (roleIds) {
+        payload.roleIds = roleIds;
+    }
+    if (statuses) {
+        payload.statuses = statuses;
+    }
+    const response = await yunxiaoRequest(url, {
+        method: "POST",
+        body: payload,
+    });
+    // 验证响应数据结构
+    return SearchOrganizationMembersResultSchema.parse(response);
+};
+/**
+ * 通过用户ID查询组织成员详细信息
+ * @param organizationId 组织ID
+ * @param userId 用户ID
+ * @returns 组织成员详细信息
+ */
+export const getOrganizationMemberByUserIdInfoFunc = async (organizationId, userId) => {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/platform/members:readByUser`
+        : `/oapi/v1/platform/organizations/${finalOrgId}/members:readByUser`;
+    const params = {
+        userId: userId
+    };
+    const urlWithParams = buildUrl(url, params);
+    const response = await yunxiaoRequest(urlWithParams, {
+        method: "GET",
+    });
+    return MemberInfoSchema.parse(response);
+};

package/dist/operations/organization/organization.js

@@ -0,0 +1,110 @@
+import { buildUrl, yunxiaoRequest, isRegionEdition, getRegionDefaultOrganizationId } from "../../common/utils.js";
+import { CurrentOrganizationInfoSchema, UserOrganizationsInfoSchema, CurrentUserSchema, OrganizationDepartmentsSchema, DepartmentInfoSchema, OrganizationRoleSchema, OrganizationRole, } from "./types.js";
+export async function getCurrentOrganizationInfoFunc() {
+    const url = "/oapi/v1/platform/user";
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    const responseData = response;
+    const mappedResponse = {
+        lastOrganization: responseData.lastOrganization, // Organization ID
+        userId: responseData.id, // Map API's "id" to userId
+        userName: responseData.name // Map API's "name" to userName
+    };
+    return CurrentOrganizationInfoSchema.parse(mappedResponse);
+}
+export async function getUserOrganizationsFunc() {
+    const url = "/oapi/v1/platform/organizations";
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    return UserOrganizationsInfoSchema.parse(response);
+}
+export async function getOrganizationDepartmentsFunc(organizationId, parentId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/platform/departments`
+        : `/oapi/v1/platform/organizations/${finalOrgId}/departments`;
+    const params = {};
+    if (parentId) {
+        params.parentId = parentId;
+    }
+    const url = buildUrl(baseUrl, params);
+    const response = await yunxiaoRequest(url, {
+        method: "GET"
+    });
+    return OrganizationDepartmentsSchema.parse(response);
+}
+export async function getOrganizationDepartmentInfoFunc(organizationId, id) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/platform/departments/${id}`
+        : `/oapi/v1/platform/organizations/${finalOrgId}/departments/${id}`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return DepartmentInfoSchema.parse(response);
+}
+export async function getOrganizationDepartmentAncestorsFunc(organizationId, id) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/platform/departments/${id}/ancestors`
+        : `/oapi/v1/platform/organizations/${finalOrgId}/departments/${id}/ancestors`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return OrganizationDepartmentsSchema.parse(response);
+}
+;
+export async function listOrganizationRolesFunc(organizationId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/platform/roles`
+        : `/oapi/v1/platform/organizations/${finalOrgId}/roles`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET"
+    });
+    return OrganizationRole.parse(response);
+}
+export async function getOrganizationRoleFunc(organizationId, roleId) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const url = isRegionEdition()
+        ? `/oapi/v1/platform/roles/${roleId}`
+        : `/oapi/v1/platform/organizations/${finalOrgId}/roles/${roleId}`;
+    const response = await yunxiaoRequest(url, {
+        method: "GET"
+    });
+    return OrganizationRoleSchema.parse(response);
+}
+export async function getCurrentUserFunc() {
+    const url = "/oapi/v1/platform/user";
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    return CurrentUserSchema.parse(response);
+}
+/**
+ * 统一解析 organizationId：
+ * - region 站：无论传什么 / 不传，最终统一用 getRegionDefaultOrganizationId()
+ * - 中心站：
+ *   - 传入 explicitOrgId 则使用
+ *   - 未传则从 /platform/user 的 lastOrganization 补充
+ */
+export async function resolveOrganizationId(explicitOrgId) {
+    if (isRegionEdition()) {
+        // region 模式：统一使用默认占位 orgId
+        return getRegionDefaultOrganizationId();
+    }
+    // 中心站模式
+    if (explicitOrgId && explicitOrgId !== "default") {
+        return explicitOrgId;
+    }
+    const info = await getCurrentOrganizationInfoFunc();
+    if (!info.lastOrganization) {
+        throw new Error("organizationId is required when using Yunxiao central edition");
+    }
+    return info.lastOrganization;
+}

package/dist/operations/organization/types.js

@@ -0,0 +1,111 @@
+import { z } from "zod";
+// Organization Role related types
+export const OrganizationRoleSchema = z.object({
+    id: z.string().describe("Role ID"),
+    name: z.string().describe("Role name"),
+    organizationId: z.string().describe("Organization ID"),
+    permissions: z.array(z.string()).describe("Role permission list")
+});
+export const OrganizationRole = z.array(OrganizationRoleSchema);
+export const ListOrganizationRolesSchema = z.object({
+    organizationId: z.string().describe("Organization ID")
+});
+export const GetOrganizationRoleSchema = z.object({
+    organizationId: z.string().describe("Organization ID"),
+    roleId: z.string().describe("Role ID")
+});
+// Organization Department related types
+export const GetOrganizationDepartmentAncestorsSchema = z.object({
+    organizationId: z.string().describe("Organization ID"),
+    id: z.string().describe("Department ID"),
+});
+export const GetOrganizationDepartmentInfoSchema = z.object({
+    organizationId: z.string().describe("Organization ID"),
+    id: z.string().describe("Department ID"),
+});
+export const GetOrganizationDepartmentsSchema = z.object({
+    organizationId: z.string().describe("Organization ID"),
+    parentId: z.string().optional().describe("Parent department ID"),
+});
+// Organization related types
+export const CurrentOrganizationInfoSchema = z.object({
+    lastOrganization: z.string().optional().describe("Organization ID of the most recent login, used for subsequent API calls, should be used as organizationId"),
+    userId: z.string().optional().describe("Current user ID, not the organization ID"),
+    userName: z.string().optional().describe("Current user name"),
+});
+export const OrganizationInfoSchema = z.object({
+    id: z.string().optional().describe("Organization ID"),
+    name: z.string().optional().describe("Organization name"),
+    description: z.string().optional().describe("Organization description"),
+});
+export const UserOrganizationsInfoSchema = z.array(OrganizationInfoSchema);
+// User related types
+export const UserInfoSchema = z.object({
+    id: z.string().nullable().optional().describe("User ID"),
+    name: z.string().nullable().optional().describe("User name"),
+});
+// Current user information schema
+export const CurrentUserSchema = z.object({
+    id: z.string().nullable().optional().describe("User ID"),
+    name: z.string().optional().describe("Display name"),
+    email: z.string().optional().describe("Email address"),
+    username: z.string().optional().describe("Login account name"),
+    lastOrganization: z.string().optional().describe("Last login organization ID"),
+    staffId: z.string().optional().describe("Staff ID"),
+    nickName: z.string().optional().describe("Nickname"),
+    sysDeptIds: z.array(z.string()).optional().describe("Department IDs"),
+    createdAt: z.string().optional().describe("Creation time (ISO 8601格式)"),
+    deletedAt: z.string().optional().describe("Deletion time (ISO 8601格式)")
+});
+// Organization Department related types
+export const DepartmentInfoSchema = z.object({
+    creatorId: z.string().optional().describe("创建人 ID"),
+    id: z.string().optional().describe("部门 ID"),
+    name: z.string().optional().describe("部门名称"),
+    organizationId: z.string().optional().describe("组织 ID"),
+    parentId: z.string().optional().describe("父部门 ID"),
+    hasSub: z.boolean().optional().describe("是否有子部门")
+});
+export const OrganizationDepartmentsSchema = z.array(DepartmentInfoSchema);
+// Organization Member related types
+export const MemberInfoSchema = z.object({
+    deptIds: z.array(z.string()).optional().describe("所属组织部门列表"),
+    id: z.string().optional().describe("成员 ID"),
+    joined: z.string().optional().describe("加入时间 (ISO 8601格式)"),
+    name: z.string().optional().describe("成员名"),
+    organizationId: z.string().optional().describe("组织 ID"),
+    roleIds: z.array(z.string()).optional().describe("角色信息"),
+    status: z.string().optional().describe("成员状态，可选值：ENABLED,DISABLED,UNDELETED,DELETED,NORMAL_USING,UNVISITED"),
+    userId: z.string().optional().describe("用户 ID"),
+    visited: z.string().optional().describe("最后访问时间 (ISO 8601格式)"),
+});
+export const OrganizationMembersSchema = z.array(MemberInfoSchema);
+// Organization Member detail types
+export const GetOrganizationMemberInfoSchema = z.object({
+    organizationId: z.string().describe("组织 ID"),
+    memberId: z.string().describe("成员 ID"),
+});
+// Get organization member by user ID types
+export const GetOrganizationMemberByUserIdInfoSchema = z.object({
+    organizationId: z.string().describe("组织 ID"),
+    userId: z.string().describe("用户 ID"),
+});
+// Search organization members types
+export const SearchOrganizationMembersSchema = z.object({
+    organizationId: z.string().describe("Organization ID, can be found in the basic information page of the organization admin console"),
+    deptIds: z.array(z.string()).optional().describe("Department IDs to search for"),
+    query: z.string().optional().describe("Search query"),
+    includeChildren: z.boolean().optional().describe("Whether to include sub-departments"),
+    nextToken: z.string().optional().describe("Next token for pagination"),
+    roleIds: z.array(z.string()).optional().describe("Role IDs to search for"),
+    statuses: z.array(z.string()).optional().describe("User statuses, posibble values: ENABLED,DISABLED,UNDELETED,DELETED,NORMAL_USING,UNVISITED。ENABLED=NORMAL_USING+UNVISITED;UNDELETED=ENABLED+DISABLED"),
+    page: z.number().int().optional().describe("Current page number, defaults to 1"),
+    perPage: z.number().int().optional().describe("Number of items per page, defaults to 100")
+});
+export const SearchOrganizationMembersResultSchema = z.array(MemberInfoSchema);
+// Get organization members schema
+export const GetOrganizationMembersSchema = z.object({
+    organizationId: z.string().describe("Organization ID"),
+    page: z.number().int().optional().describe("Page number"),
+    perPage: z.number().int().optional().describe("Page size"),
+});

package/dist/operations/packages/artifacts.js

@@ -0,0 +1,71 @@
+import { yunxiaoRequest, buildUrl, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { ArtifactSchema, } from "./types.js";
+/**
+ * 查询制品信息
+ * @param organizationId
+ * @param repoId
+ * @param repoType
+ * @param page
+ * @param perPage
+ * @param search
+ * @param orderBy
+ * @param sort
+ * @returns 制品信息列表
+ */
+export async function listArtifactsFunc(organizationId, repoId, repoType, page, perPage, search, orderBy = "latestUpdate", sort = "desc") {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/packages/repositories/${repoId}/artifacts`
+        : `/oapi/v1/packages/organizations/${finalOrgId}/repositories/${repoId}/artifacts`;
+    const queryParams = {
+        repoType,
+    };
+    if (page !== undefined) {
+        queryParams.page = page;
+    }
+    if (perPage !== undefined) {
+        queryParams.perPage = perPage;
+    }
+    if (search !== undefined) {
+        queryParams.search = search;
+    }
+    queryParams.orderBy = orderBy;
+    queryParams.sort = sort;
+    const url = buildUrl(baseUrl, queryParams);
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    return response.map(artifact => ArtifactSchema.parse(artifact));
+}
+/**
+ * 查看单个制品信息
+ * @param organizationId
+ * @param repoId
+ * @param id
+ * @param repoType
+ * @returns 制品信息
+ */
+export async function getArtifactFunc(organizationId, repoId, id, repoType) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/packages/repositories/${repoId}/artifacts/${id}`
+        : `/oapi/v1/packages/organizations/${finalOrgId}/repositories/${repoId}/artifacts/${id}`;
+    const queryParams = {
+        repoType,
+    };
+    const url = buildUrl(baseUrl, queryParams);
+    try {
+        const response = await yunxiaoRequest(url, {
+            method: "GET",
+        });
+        return ArtifactSchema.parse(response);
+    }
+    catch (error) {
+        console.error(`Error fetching artifact: ${error}`);
+        return null;
+    }
+}

package/dist/operations/packages/repositories.js

@@ -0,0 +1,39 @@
+import { yunxiaoRequest, buildUrl, isRegionEdition } from "../../common/utils.js";
+import { resolveOrganizationId } from "../organization/organization.js";
+import { PackageRepositorySchema, } from "./types.js";
+/**
+ * 查看制品仓库信息
+ * @param organizationId
+ * @param repoTypes
+ * @param repoCategories
+ * @param perPage
+ * @param page
+ * @returns 制品仓库信息列表
+ */
+export async function listPackageRepositoriesFunc(organizationId, repoTypes, repoCategories, perPage, page) {
+    const finalOrgId = await resolveOrganizationId(organizationId);
+    const baseUrl = isRegionEdition()
+        ? `/oapi/v1/packages/repositories`
+        : `/oapi/v1/packages/organizations/${finalOrgId}/repositories`;
+    const queryParams = {};
+    if (repoTypes !== undefined) {
+        queryParams.repoTypes = repoTypes;
+    }
+    if (repoCategories !== undefined) {
+        queryParams.repoCategories = repoCategories;
+    }
+    if (perPage !== undefined) {
+        queryParams.perPage = perPage;
+    }
+    if (page !== undefined) {
+        queryParams.page = page;
+    }
+    const url = buildUrl(baseUrl, queryParams);
+    const response = await yunxiaoRequest(url, {
+        method: "GET",
+    });
+    if (!Array.isArray(response)) {
+        return [];
+    }
+    return response.map(repo => PackageRepositorySchema.parse(repo));
+}

package/dist/operations/packages/types.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+// Package Repository related schemas
+export const PackageRepositorySchema = z.object({
+    accessLevel: z.string().nullable().optional().describe("Access level: PRIVATE - Private repository (only accessible to repository members), INTERNAL - Organization-wide visibility (accessible to all organization members)"),
+    latestUpdate: z.number().int().nullable().optional().describe("Latest update time in milliseconds"),
+    repoCategory: z.string().nullable().optional().describe("Repository mode: Hybrid/Local/Proxy/ProxyCache/Group"),
+    repoDesc: z.string().nullable().optional().describe("Repository description"),
+    repoDescriptor: z.string().nullable().optional().describe("Repository descriptor file"),
+    repoId: z.string().nullable().optional().describe("Repository ID"),
+    repoName: z.string().nullable().optional().describe("Repository name"),
+    repoType: z.string().nullable().optional().describe("Repository type: GENERIC/DOCKER/MAVEN/NPM/NUGET"),
+    star: z.boolean().nullable().optional().describe("Whether the repository is favorited"),
+});
+export const ListPackageRepositoriesSchema = z.object({
+    organizationId: z.string().describe("Organization ID"),
+    repoTypes: z.string().optional().describe("Repository types, available values: GENERIC/DOCKER/MAVEN/NPM/NUGET, multiple types can be separated by commas"),
+    repoCategories: z.string().optional().describe("Repository modes, available values: Hybrid/Local/Proxy/ProxyCache/Group, multiple modes can be separated by commas"),
+    perPage: z.number().int().optional().default(8).describe("Number of items per page, default value is 8"),
+    page: z.number().int().optional().default(1).describe("Current page number"),
+});
+// Artifact related schemas
+export const ArtifactVersionSchema = z.object({
+    createTime: z.number().int().nullable().optional().describe("Creation time in milliseconds"),
+    creator: z.string().nullable().optional().describe("Creator"),
+    gmtDownload: z.number().int().nullable().optional().describe("Latest download time in milliseconds"),
+    id: z.number().int().nullable().optional().describe("Artifact version ID"),
+    modifier: z.string().nullable().optional().describe("Modifier"),
+    updateTime: z.number().int().nullable().optional().describe("Modification time in milliseconds"),
+    version: z.string().nullable().optional().describe("Version number"),
+});
+export const ArtifactSchema = z.object({
+    downloadCount: z.number().int().nullable().optional().describe("Download count"),
+    gmtDownload: z.number().int().nullable().optional().describe("Latest download time in milliseconds"),
+    id: z.number().int().nullable().optional().describe("Artifact ID"),
+    latestUpdate: z.number().int().nullable().optional().describe("Latest update time in milliseconds"),
+    module: z.string().nullable().optional().describe("Module name"),
+    organization: z.string().nullable().optional().describe("Organization information"),
+    repositoryId: z.string().nullable().optional().describe("Repository ID"),
+    versions: z.array(ArtifactVersionSchema).nullable().optional().describe("Version list"),
+});
+export const ListArtifactsSchema = z.object({
+    organizationId: z.string().describe("Organization ID"),
+    repoId: z.string().describe("Repository ID"),
+    repoType: z.string().describe("Repository type, available values: GENERIC/DOCKER/MAVEN/NPM/NUGET"),
+    page: z.number().int().optional().default(1).describe("Current page number"),
+    perPage: z.number().int().optional().default(8).describe("Number of items per page, default is 10"),
+    search: z.string().optional().describe("Search by package name"),
+    orderBy: z.string().optional().default("latestUpdate").describe("Sort method: latestUpdate - by latest update time in milliseconds; gmtDownload - by latest download time in milliseconds"),
+    sort: z.string().optional().default("desc").describe("Sort order: asc - ascending; desc - descending"),
+});
+export const GetArtifactSchema = z.object({
+    organizationId: z.string().describe("Organization ID"),
+    repoId: z.string().describe("Repository ID"),
+    id: z.number().int().describe("Artifact ID, can be obtained from ListArtifacts API"),
+    repoType: z.string().describe("Repository type, available values: GENERIC/DOCKER/MAVEN/NPM/NUGET/PYPI"),
+});