yuque-ai-mcp 2.7.4

package/dist/toc/update-toc.js

@@ -0,0 +1,74 @@
+/**
+ * toc/update — 更新知识库目录
+ *
+ * 端点：PUT /api/v2/repos/:book_id/toc
+ * 职责：创建/移动/编辑/删除目录节点
+ */
+import { confirmationParam, checkConfirmation } from "../common/errors.js";
+import { check, requiredString } from "../common/validate.js";
+import { apiPut } from "../common/api-client.js";
+import { handleApiCall } from "../common/format.js";
+export const tocUpdate = {
+    name: "yuque_update_toc",
+    description: "Update repo TOC (create/move/edit/delete nodes). ⚠️ Deleting requires confirm='DELETE'. PUT /repos/:id/toc. 详见 references/api/toc_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            book_id: { type: "string", description: "Repository ID or namespace (required)" },
+            action: { type: "string", description: "Action type (required): appendNode, prependNode, editNode, removeNode" },
+            action_mode: { type: "string", description: "Action mode (required): sibling, child" },
+            type: { type: "string", description: "Node type: DOC, LINK, TITLE (required for create, optional for edit)" },
+            doc_ids: { type: "string", description: "Document ID array as JSON, e.g. [123,456] (required for creating doc nodes)" },
+            title: { type: "string", description: "Node title (required for creating group/link, optional for edit)" },
+            url: { type: "string", description: "Node URL (required for creating link, optional for edit)" },
+            open_window: { type: "number", description: "Open in new window: 0=same page, 1=new window (optional for links, default 0)" },
+            visible: { type: "number", description: "Visible: 0=hidden, 1=visible (default 1)" },
+            target_uuid: { type: "string", description: "Target node UUID, defaults to root if omitted" },
+            node_uuid: { type: "string", description: "Target node UUID (required for move/edit/delete)" },
+            confirm: confirmationParam.confirm,
+        },
+        required: ["book_id", "action", "action_mode"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = check(requiredString(args?.book_id, "book_id"), requiredString(args?.action, "action"), requiredString(args?.action_mode, "action_mode"));
+        if (__v)
+            return __v;
+        const bookId = args?.book_id;
+        const action = args?.action;
+        if (action === "removeNode") {
+            const confirmed = checkConfirmation(args);
+            if (confirmed)
+                return confirmed;
+        }
+        const payload = {
+            action: args?.action,
+            action_mode: args?.action_mode,
+        };
+        if (args?.type !== undefined)
+            payload.type = args.type;
+        if (args?.title !== undefined)
+            payload.title = args.title;
+        if (args?.url !== undefined)
+            payload.url = args.url;
+        if (args?.open_window !== undefined)
+            payload.open_window = args.open_window;
+        if (args?.visible !== undefined)
+            payload.visible = args.visible;
+        if (args?.target_uuid !== undefined)
+            payload.target_uuid = args.target_uuid;
+        if (args?.node_uuid !== undefined)
+            payload.node_uuid = args.node_uuid;
+        if (args?.doc_ids !== undefined) {
+            try {
+                payload.doc_ids = JSON.parse(args.doc_ids);
+            }
+            catch {
+                payload.doc_ids = args.doc_ids;
+            }
+        }
+        const data = await apiPut(`/repos/${bookId}/toc`, payload, "Update TOC");
+        return handleApiCall(data, undefined);
+    },
+};
+//# sourceMappingURL=update-toc.js.map

package/dist/toc/update-toc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-toc.js","sourceRoot":"","sources":["../../src/toc/update-toc.ts"],"names":[],"mappings":"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"}

package/dist/upload/index.d.ts

@@ -0,0 +1,3 @@
+export { uploadAttachment } from "./upload-attachment.js";
+import type { McpTool } from "../common/types.js";
+export declare const uploadTools: McpTool[];

package/dist/upload/index.js

@@ -0,0 +1,4 @@
+export { uploadAttachment } from "./upload-attachment.js";
+import { uploadAttachment } from "./upload-attachment.js";
+export const uploadTools = [uploadAttachment];
+//# sourceMappingURL=index.js.map

package/dist/upload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/upload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,CAAC,MAAM,WAAW,GAAc,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/upload/upload-attachment.d.ts

@@ -0,0 +1,11 @@
+/**
+ * upload/attachment — 上传文件到语雀 CDN
+ *
+ * 端点：POST /api/upload/attach（Web API，Cookie 认证）
+ * 职责：上传图片/附件/视频到语雀 CDN，返回 CDN URL
+ *
+ * 上限（超级会员）：图片 50MB / 附件 2GB / 视频 2GB
+ * 失败自动重试一次，再失败报错
+ */
+import type { McpTool } from "../common/types.js";
+export declare const uploadAttachment: McpTool;

package/dist/upload/upload-attachment.js

@@ -0,0 +1,162 @@
+/**
+ * upload/attachment — 上传文件到语雀 CDN
+ *
+ * 端点：POST /api/upload/attach（Web API，Cookie 认证）
+ * 职责：上传图片/附件/视频到语雀 CDN，返回 CDN URL
+ *
+ * 上限（超级会员）：图片 50MB / 附件 2GB / 视频 2GB
+ * 失败自动重试一次，再失败报错
+ */
+import { readFileSync, statSync } from "fs";
+import { loadConfig } from "../common/config.js";
+const LIMITS = {
+    image: { max: 50, label: "50MB" },
+    attachment: { max: 2048, label: "2GB" },
+    video: { max: 2048, label: "2GB" },
+};
+async function doUpload(filePath, fileName, fileBuffer, type, userId, cookie, ctoken) {
+    const form = new FormData();
+    form.append("file", new Blob([new Uint8Array(fileBuffer)]), fileName);
+    const url = `https://www.yuque.com/api/upload/attach?attachable_type=User&attachable_id=${userId}&type=${type}&ctoken=${ctoken}`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 30_000);
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                Cookie: cookie,
+                "x-csrf-token": ctoken,
+                Referer: "https://www.yuque.com/",
+                Origin: "https://www.yuque.com",
+                "User-Agent": "Mozilla/5.0",
+            },
+            body: form,
+            signal: controller.signal,
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            return {
+                ok: false,
+                result: { error: "UPLOAD_FAILED", status: res.status, message: text.slice(0, 200) },
+            };
+        }
+        const data = JSON.parse(text);
+        const filekey = data?.data?.filekey || data?.filekey || "";
+        const extname = data?.data?.extname || "";
+        const urlResult = filekey ? `https://cdn.nlark.com/${filekey}` : "";
+        return {
+            ok: true,
+            result: { success: true, url: urlResult, filekey, extname, type },
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export const uploadAttachment = {
+    name: "yuque_upload_attachment",
+    description: "Upload a file to Yuque CDN (image≤50MB, attachment/video≤2GB, requires cookie+ctoken). POST /upload/attach. 详见 references/api/upload_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            file_path: { type: "string", description: "Local file path (required)" },
+            type: { type: "string", description: "File type: image, attachment, video, default attachment" },
+            user_id: { type: "string", description: "User ID, auto-detected from token if omitted" },
+        },
+        required: ["file_path"],
+    },
+    async handler(args) {
+        const cfg = loadConfig();
+        const filePath = args?.file_path;
+        const type = args?.type || "attachment";
+        const cookie = cfg.cookie || "";
+        const ctoken = cfg.ctoken || "";
+        if (!cookie || !ctoken) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "MISSING_COOKIE",
+                            message: "文件上传需要 Cookie 登录态，请在 config/config.json 中配置 cookie 和 ctoken 字段 / File upload requires Cookie auth. Please configure cookie and ctoken in config/config.json." +
+                                "获取方式：浏览器打开 yuque.com 登录 → F12 → Application → Cookies → 复制 _yuque_session 和 yuque_ctoken",
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // 读取文件
+        let fileBuffer;
+        let fileName;
+        try {
+            fileBuffer = readFileSync(filePath);
+            fileName = filePath.split("/").pop() || "file";
+            const sizeMB = statSync(filePath).size / 1024 / 1024;
+            const limit = LIMITS[type] || LIMITS.attachment;
+            if (sizeMB > limit.max) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: "FILE_TOO_LARGE",
+                                message: `${type} 文件过大 (${sizeMB.toFixed(1)}MB)，${type} 上限 ${limit.label}`,
+                                path: filePath,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        catch (e) {
+            const err = e;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: "FILE_NOT_FOUND",
+                            message: `文件不存在或无法读取: ${filePath}`,
+                            detail: err.message,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // 获取 user_id：传了直接用，没传自动获取
+        let userId = args?.user_id || "";
+        if (!userId) {
+            try {
+                const userRes = await fetch(`${cfg.api_base}/user`, {
+                    headers: { "X-Auth-Token": cfg.token },
+                });
+                if (userRes.ok) {
+                    const userData = (await userRes.json());
+                    userId = String(userData.data.id);
+                }
+            }
+            catch {
+                // 获取失败，继续用空字符串尝试
+            }
+        }
+        // 上传 + 失败重试一次
+        let lastResult;
+        for (let attempt = 0; attempt < 2; attempt++) {
+            lastResult = await doUpload(filePath, fileName, fileBuffer, type, userId, cookie, ctoken);
+            if (lastResult.ok) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify(lastResult.result, null, 2) }],
+                };
+            }
+        }
+        // 两次都失败
+        return {
+            content: [{ type: "text", text: JSON.stringify(lastResult.result, null, 2) }],
+            isError: true,
+        };
+    },
+};
+//# sourceMappingURL=upload-attachment.js.map

package/dist/upload/upload-attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-attachment.js","sourceRoot":"","sources":["../../src/upload/upload-attachment.ts"],"names":[],"mappings":"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"}

package/dist/user/get-groups.d.ts

@@ -0,0 +1,8 @@
+/**
+ * user/groups — 获取用户所属的团队列表
+ *
+ * 端点：GET /api/v2/users/:id/groups
+ * 职责：获取指定用户加入的所有团队
+ */
+import type { McpTool } from "../common/types.js";
+export declare const userGetGroups: McpTool;

package/dist/user/get-groups.js

@@ -0,0 +1,41 @@
+/**
+ * user/groups — 获取用户所属的团队列表
+ *
+ * 端点：GET /api/v2/users/:id/groups
+ * 职责：获取指定用户加入的所有团队
+ */
+import { apiGet } from "../common/api-client.js";
+import { requiredString } from "../common/validate.js";
+import { formatUserGroup, handleApiCall } from "../common/format.js";
+export const userGetGroups = {
+    name: "yuque_get_user_groups",
+    description: "List groups the user belongs to. GET /users/:id/groups. 详见 references/api/user_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string", description: "User login or ID (required)" },
+            role: { type: "number", description: "Role filter: 0=admin, 1=member" },
+            offset: { type: "number", description: "Pagination offset, default 0" },
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
+        },
+        required: ["id"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.id, "id");
+        if (__v)
+            return __v;
+        const id = args?.id;
+        const role = args?.role;
+        const offset = args?.offset ?? 0;
+        const raw = args?.raw;
+        const params = { offset: String(offset) };
+        if (role !== undefined)
+            params.role = String(role);
+        const data = await apiGet(`/users/${id}/groups`, params, "Get user groups");
+        const items = data?.data ?? data;
+        const formatted = Array.isArray(items) ? items.map(formatUserGroup) : items;
+        return handleApiCall(raw ? data : formatted, undefined, raw);
+    },
+};
+//# sourceMappingURL=get-groups.js.map

package/dist/user/get-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-groups.js","sourceRoot":"","sources":["../../src/user/get-groups.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAErE,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,uFAAuF;IAEpG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;YAClE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACvE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACvE,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;KACjB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,EAAE,GAAG,IAAI,EAAE,EAAY,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,EAAE,IAA0B,CAAC;QAC9C,MAAM,MAAM,GAAI,IAAI,EAAE,MAAiB,IAAI,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAE7C,MAAM,MAAM,GAA2B,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAClE,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAEnD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAE5E,MAAM,KAAK,GAAI,IAA6B,EAAE,IAAI,IAAI,IAAI,CAAC;QAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5E,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,SAAgB,EAAE,GAAG,CAAC,CAAC;IACtE,CAAC;CACF,CAAC"}

package/dist/user/get-user.d.ts

@@ -0,0 +1,8 @@
+/**
+ * user/user — 获取当前 Token 的用户详情
+ *
+ * 端点：GET /api/v2/user
+ * 职责：返回当前 Token 对应的用户完整信息
+ */
+import type { McpTool } from "../common/types.js";
+export declare const userGet: McpTool;

package/dist/user/get-user.js

@@ -0,0 +1,24 @@
+/**
+ * user/user — 获取当前 Token 的用户详情
+ *
+ * 端点：GET /api/v2/user
+ * 职责：返回当前 Token 对应的用户完整信息
+ */
+import { apiGet } from "../common/api-client.js";
+import { formatUser, handleApiCall } from "../common/format.js";
+export const userGet = {
+    name: "yuque_get_user",
+    description: "Get current user profile (id,login,name,avatar_url,books_count,description,created_at). GET /user. 详见 references/api/user_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
+        },
+    },
+    async handler(args) {
+        const raw = args?.raw;
+        const data = await apiGet("/user", undefined, "Get user");
+        return handleApiCall(data, formatUser, raw);
+    },
+};
+//# sourceMappingURL=get-user.js.map

package/dist/user/get-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-user.js","sourceRoot":"","sources":["../../src/user/get-user.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAiB,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,CAAC,MAAM,OAAO,GAAY;IAC9B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE,kIAAkI;IAE/I,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAC1D,OAAO,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}

package/dist/user/hello.d.ts

@@ -0,0 +1,8 @@
+/**
+ * user/hello — 心跳检测
+ *
+ * 端点：GET /api/v2/hello
+ * 职责：测试 Token 有效性和 API 连通性
+ */
+import type { McpTool } from "../common/types.js";
+export declare const userHello: McpTool;

package/dist/user/hello.js

@@ -0,0 +1,17 @@
+/**
+ * user/hello — 心跳检测
+ *
+ * 端点：GET /api/v2/hello
+ * 职责：测试 Token 有效性和 API 连通性
+ */
+import { apiGet } from "../common/api-client.js";
+import { handleApiCall } from "../common/format.js";
+export const userHello = {
+    name: "yuque_hello",
+    description: "Health check — verify Yuque API token validity. GET /hello. 详见 references/api/user_api.md",
+    async handler() {
+        const data = await apiGet("/hello");
+        return handleApiCall(data, undefined);
+    },
+};
+//# sourceMappingURL=hello.js.map

package/dist/user/hello.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hello.js","sourceRoot":"","sources":["../../src/user/hello.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,CAAC,MAAM,SAAS,GAAY;IAChC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,2FAA2F;IAExG,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,aAAa,CAAC,IAAI,EAAE,SAAgB,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC"}

package/dist/user/index.d.ts

@@ -0,0 +1,5 @@
+export { userGet } from "./get-user.js";
+export { userHello } from "./hello.js";
+export { userGetGroups } from "./get-groups.js";
+import type { McpTool } from "../common/types.js";
+export declare const userTools: McpTool[];

package/dist/user/index.js

@@ -0,0 +1,8 @@
+export { userGet } from "./get-user.js";
+export { userHello } from "./hello.js";
+export { userGetGroups } from "./get-groups.js";
+import { userGet } from "./get-user.js";
+import { userHello } from "./hello.js";
+import { userGetGroups } from "./get-groups.js";
+export const userTools = [userGet, userHello, userGetGroups];
+//# sourceMappingURL=index.js.map

package/dist/user/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/user/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,CAAC,MAAM,SAAS,GAAc,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "yuque-ai-mcp",
+  "version": "2.7.4",
+  "description": "Full-featured Yuque MCP Server — 61 fine-grained tools covering the entire Yuque OpenAPI",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "yuque-mcp": "dist/cli.js",
+    "yuque-mcp-http": "dist/cli-http.js"
+  },
+  "files": [
+    "dist/",
+    "config/config.example.json",
+    "references/api/",
+    "SKILL.md",
+    "README.md",
+    "README_CN.md"
+  ],
+  "keywords": [
+    "yuque",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "claude",
+    "语雀"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "dev:http": "tsx watch src/http.ts",
+    "start": "node dist/index.js",
+    "start:http": "node dist/http.js",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yehuoshun/yuque-ai-mcp"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.22.4",
+    "typescript": "^5.4.0"
+  }
+}