yuque-ai-mcp 2.7.4

package/dist/statistic/book-statistics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"book-statistics.js","sourceRoot":"","sources":["../../src/statistic/book-statistics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,oGAAoG;IAEjH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACtE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;YAClE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;YACvG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YAC/D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;YACvE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+GAA+G,EAAE;YAC3J,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;SAC/E;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,EAAE,IAA0B,CAAC;QAC9C,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAI,IAAI,EAAE,IAAe,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,EAAE,SAA+B,CAAC;QACxD,MAAM,SAAS,GAAI,IAAI,EAAE,SAAoB,IAAI,MAAM,CAAC;QAExD,MAAM,MAAM,GAA2B;YACrC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;YACxC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS;SAC9C,CAAC;QACF,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QAC7B,IAAI,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAE5C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,KAAK,mBAAmB,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;QACzF,OAAO,aAAa,CAAC,IAAI,EAAE,SAAgB,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC"}

package/dist/statistic/doc-statistics.d.ts

@@ -0,0 +1,7 @@
+/**
+ * statistic/docs — 团队文档统计数据
+ *
+ * 端点：GET /api/v2/groups/:login/statistics/docs
+ */
+import type { McpTool } from "../common/types.js";
+export declare const docStatistics: McpTool;

package/dist/statistic/doc-statistics.js

@@ -0,0 +1,53 @@
+/**
+ * statistic/docs — 团队文档统计数据
+ *
+ * 端点：GET /api/v2/groups/:login/statistics/docs
+ */
+import { apiGet } from "../common/api-client.js";
+import { handleApiCall } from "../common/format.js";
+import { requiredString } from "../common/validate.js";
+export const docStatistics = {
+    name: "yuque_get_doc_statistics",
+    description: "Get group document statistics. GET /groups/:login/statistics/docs. 详见 references/api/statistic_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            login: { type: "string", description: "Group login or ID (required)" },
+            bookId: { type: "number", description: "Filter by repository ID" },
+            name: { type: "string", description: "Filter by document name" },
+            range: { type: "number", description: "Date range: 0=all, 30=last 30 days, 365=last year (default 0)" },
+            page: { type: "number", description: "Page number, default 1" },
+            limit: { type: "number", description: "Page size, max 20, default 10" },
+            sortField: { type: "string", description: "Sort field: content_updated_at, word_count, read_count, like_count, comment_count, created_at" },
+            sortOrder: { type: "string", description: "Sort order: desc (default) / asc" },
+        },
+        required: ["login"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.login, "login");
+        if (__v)
+            return __v;
+        const login = args?.login;
+        const bookId = args?.bookId;
+        const name = args?.name;
+        const range = args?.range ?? 0;
+        const page = args?.page ?? 1;
+        const limit = args?.limit ?? 10;
+        const sortField = args?.sortField;
+        const sortOrder = args?.sortOrder ?? "desc";
+        const params = {
+            range: String(range), page: String(page),
+            limit: String(Math.min(limit, 20)), sortOrder,
+        };
+        if (bookId !== undefined)
+            params.bookId = String(bookId);
+        if (name)
+            params.name = name;
+        if (sortField)
+            params.sortField = sortField;
+        const data = await apiGet(`/groups/${login}/statistics/docs`, params, "Get doc stats");
+        return handleApiCall(data, undefined);
+    },
+};
+//# sourceMappingURL=doc-statistics.js.map

package/dist/statistic/doc-statistics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-statistics.js","sourceRoot":"","sources":["../../src/statistic/doc-statistics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,uGAAuG;IAEpH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACtE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;YAClE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yBAAyB,EAAE;YAChE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;YACvG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YAC/D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;YACvE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+FAA+F,EAAE;YAC3I,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;SAC/E;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,EAAE,MAA4B,CAAC;QAClD,MAAM,IAAI,GAAG,IAAI,EAAE,IAA0B,CAAC;QAC9C,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAI,IAAI,EAAE,IAAe,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,EAAE,SAA+B,CAAC;QACxD,MAAM,SAAS,GAAI,IAAI,EAAE,SAAoB,IAAI,MAAM,CAAC;QAExD,MAAM,MAAM,GAA2B;YACrC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;YACxC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS;SAC9C,CAAC;QACF,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QAC7B,IAAI,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAE5C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,KAAK,kBAAkB,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;QACvF,OAAO,aAAa,CAAC,IAAI,EAAE,SAAgB,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC"}

package/dist/statistic/group-statistics.d.ts

@@ -0,0 +1,8 @@
+/**
+ * statistic/group — 团队汇总统计数据
+ *
+ * 端点：GET /api/v2/groups/:login/statistics
+ * 职责：返回团队维度的汇总统计数据
+ */
+import type { McpTool } from "../common/types.js";
+export declare const groupStatistics: McpTool;

package/dist/statistic/group-statistics.js

@@ -0,0 +1,30 @@
+/**
+ * statistic/group — 团队汇总统计数据
+ *
+ * 端点：GET /api/v2/groups/:login/statistics
+ * 职责：返回团队维度的汇总统计数据
+ */
+import { apiGet } from "../common/api-client.js";
+import { handleApiCall } from "../common/format.js";
+import { requiredString } from "../common/validate.js";
+export const groupStatistics = {
+    name: "yuque_get_group_statistics",
+    description: "Get group summary statistics. GET /groups/:login/statistics. 详见 references/api/statistic_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            login: { type: "string", description: "Group login or ID (required)" },
+        },
+        required: ["login"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.login, "login");
+        if (__v)
+            return __v;
+        const login = args?.login;
+        const data = await apiGet(`/groups/${login}/statistics`, undefined, "Get group stats");
+        return handleApiCall(data, undefined);
+    },
+};
+//# sourceMappingURL=group-statistics.js.map

package/dist/statistic/group-statistics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-statistics.js","sourceRoot":"","sources":["../../src/statistic/group-statistics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,iGAAiG;IAE9G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;SACvE;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,KAAK,aAAa,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;QACvF,OAAO,aAAa,CAAC,IAAI,EAAE,SAAgB,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC"}

package/dist/statistic/index.d.ts

@@ -0,0 +1,6 @@
+export { groupStatistics } from "./group-statistics.js";
+export { memberStatistics } from "./member-statistics.js";
+export { bookStatistics } from "./book-statistics.js";
+export { docStatistics } from "./doc-statistics.js";
+import type { McpTool } from "../common/types.js";
+export declare const statisticTools: McpTool[];

package/dist/statistic/index.js

@@ -0,0 +1,10 @@
+export { groupStatistics } from "./group-statistics.js";
+export { memberStatistics } from "./member-statistics.js";
+export { bookStatistics } from "./book-statistics.js";
+export { docStatistics } from "./doc-statistics.js";
+import { groupStatistics } from "./group-statistics.js";
+import { memberStatistics } from "./member-statistics.js";
+import { bookStatistics } from "./book-statistics.js";
+import { docStatistics } from "./doc-statistics.js";
+export const statisticTools = [groupStatistics, memberStatistics, bookStatistics, docStatistics];
+//# sourceMappingURL=index.js.map

package/dist/statistic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/statistic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,MAAM,cAAc,GAAc,CAAC,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC"}

package/dist/statistic/member-statistics.d.ts

@@ -0,0 +1,7 @@
+/**
+ * statistic/members — 团队成员统计数据
+ *
+ * 端点：GET /api/v2/groups/:login/statistics/members
+ */
+import type { McpTool } from "../common/types.js";
+export declare const memberStatistics: McpTool;

package/dist/statistic/member-statistics.js

@@ -0,0 +1,49 @@
+/**
+ * statistic/members — 团队成员统计数据
+ *
+ * 端点：GET /api/v2/groups/:login/statistics/members
+ */
+import { apiGet } from "../common/api-client.js";
+import { handleApiCall } from "../common/format.js";
+import { requiredString } from "../common/validate.js";
+export const memberStatistics = {
+    name: "yuque_get_member_statistics",
+    description: "Get group member statistics. GET /groups/:login/statistics/members. 详见 references/api/statistic_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            login: { type: "string", description: "Group login or ID (required)" },
+            name: { type: "string", description: "Filter by member name" },
+            range: { type: "number", description: "Date range: 0=all, 30=last 30 days, 365=last year (default 0)" },
+            page: { type: "number", description: "Page number, default 1" },
+            limit: { type: "number", description: "Page size, max 20, default 10" },
+            sortField: { type: "string", description: "Sort field: write_doc_count, write_count, read_count, like_count" },
+            sortOrder: { type: "string", description: "Sort order: desc (default) / asc" },
+        },
+        required: ["login"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.login, "login");
+        if (__v)
+            return __v;
+        const login = args?.login;
+        const name = args?.name;
+        const range = args?.range ?? 0;
+        const page = args?.page ?? 1;
+        const limit = args?.limit ?? 10;
+        const sortField = args?.sortField;
+        const sortOrder = args?.sortOrder ?? "desc";
+        const params = {
+            range: String(range), page: String(page),
+            limit: String(Math.min(limit, 20)), sortOrder,
+        };
+        if (name)
+            params.name = name;
+        if (sortField)
+            params.sortField = sortField;
+        const data = await apiGet(`/groups/${login}/statistics/members`, params, "Get member stats");
+        return handleApiCall(data, undefined);
+    },
+};
+//# sourceMappingURL=member-statistics.js.map

package/dist/statistic/member-statistics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-statistics.js","sourceRoot":"","sources":["../../src/statistic/member-statistics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,CAAC,MAAM,gBAAgB,GAAY;IACvC,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,wGAAwG;IAErH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACtE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;YAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;YACvG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE;YAC/D,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;YACvE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kEAAkE,EAAE;YAC9G,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;SAC/E;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,EAAE,KAAe,CAAC;QACpC,MAAM,IAAI,GAAG,IAAI,EAAE,IAA0B,CAAC;QAC9C,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,GAAI,IAAI,EAAE,IAAe,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,EAAE,SAA+B,CAAC;QACxD,MAAM,SAAS,GAAI,IAAI,EAAE,SAAoB,IAAI,MAAM,CAAC;QAExD,MAAM,MAAM,GAA2B;YACrC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;YACxC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS;SAC9C,CAAC;QACF,IAAI,IAAI;YAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QAC7B,IAAI,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAE5C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,KAAK,qBAAqB,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;QAC7F,OAAO,aAAa,CAAC,IAAI,EAAE,SAAgB,CAAC,CAAC;IAC/C,CAAC;CACF,CAAC"}

package/dist/toc/batch-update.d.ts

@@ -0,0 +1,11 @@
+/**
+ * toc/batch-update — 批量更新知识库目录
+ *
+ * Agent 出变更计划（ops），Tool 原样执行，零决策。
+ * 纯 TOC 操作，跨库复制请用 yuque_copy_doc。
+ * 端点：PUT /api/v2/repos/:book_id/toc
+ *
+ * TOC 缓存 + 目录创建复用 common/toc-cache.ts。
+ */
+import type { McpTool } from "../common/types.js";
+export declare const tocBatchUpdate: McpTool;

package/dist/toc/batch-update.js

@@ -0,0 +1,274 @@
+/**
+ * toc/batch-update — 批量更新知识库目录
+ *
+ * Agent 出变更计划（ops），Tool 原样执行，零决策。
+ * 纯 TOC 操作，跨库复制请用 yuque_copy_doc。
+ * 端点：PUT /api/v2/repos/:book_id/toc
+ *
+ * TOC 缓存 + 目录创建复用 common/toc-cache.ts。
+ */
+import { apiPut, isErrorResult } from "../common/api-client.js";
+import { check, requiredString } from "../common/validate.js";
+import { getTocCached, invalidateTocCache, ensureTitle, resolveTarget, } from "../common/toc-cache.js";
+// ─── 工具定义 ─────────────────────────────────────────────
+export const tocBatchUpdate = {
+    name: "yuque_batch_update_toc",
+    description: "Batch update repo TOC. Agent provides ops plan, tool executes only. createTitle auto-reuses existing dirs. appendNode/moveNode support target_title. ⚠️ Remove/move ops require confirm='RESTRUCTURE'. For cross-book copy, use yuque_copy_doc instead.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            book_id: {
+                type: "string",
+                description: "Repository ID or namespace (required)",
+            },
+            ops: {
+                type: "string",
+                description: "JSON array of operations. Supported: createTitle, appendNode, removeNode, moveNode. createTitle auto-reuses existing dirs. appendNode/moveNode support target_title for name-based lookup.",
+            },
+            confirm: {
+                type: "string",
+                description: "Must be 'RESTRUCTURE' to proceed with any operation that modifies TOC.",
+            },
+        },
+        required: ["book_id", "ops", "confirm"],
+    },
+    async handler(args) {
+        const v = check(requiredString(args?.book_id, "book_id"), requiredString(args?.ops, "ops"), requiredString(args?.confirm, "confirm"));
+        if (v)
+            return v;
+        const confirmVal = args?.confirm;
+        if (confirmVal !== "RESTRUCTURE") {
+            return {
+                content: [{ type: "text", text: "⚠️ 批量目录操作需二次确认，请将参数 `confirm` 设为 'RESTRUCTURE' 后重试" }],
+                isError: true,
+            };
+        }
+        const bookId = args?.book_id;
+        let ops;
+        try {
+            ops = JSON.parse(args?.ops);
+            if (!Array.isArray(ops) || ops.length === 0) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({
+                                error: "INVALID_OPS", message: "ops 必须是非空 JSON 数组",
+                            }, null, 2) }],
+                    isError: true,
+                };
+            }
+        }
+        catch {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            error: "INVALID_OPS", message: "ops 必须是有效的 JSON 数组",
+                        }, null, 2) }],
+                isError: true,
+            };
+        }
+        const results = [];
+        for (let i = 0; i < ops.length; i++) {
+            const op = ops[i];
+            try {
+                const result = await executeOp(op, bookId);
+                results.push({ index: i, action: op.action, ...result });
+            }
+            catch (err) {
+                results.push({
+                    index: i, action: op.action, success: false,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        const success = results.filter((r) => r.success).length;
+        const failed = results.filter((r) => !r.success).length;
+        return {
+            content: [{ type: "text", text: JSON.stringify({
+                        book_id: bookId,
+                        total: results.length,
+                        success,
+                        failed,
+                        results,
+                    }, null, 2) }],
+        };
+    },
+};
+// ─── 执行单个 op ─────────────────────────────────────────
+async function executeOp(op, bookId) {
+    switch (op.action) {
+        case "createTitle": {
+            const opBookId = op.book_id || bookId;
+            const title = op.title;
+            if (!title)
+                return { success: false, error: "createTitle 缺少 title 字段" };
+            const { uuid, created } = await ensureTitle(opBookId, title, op.target_uuid);
+            if (created) {
+                return { success: true, detail: `创建目录: ${title}`, new_node_uuid: uuid };
+            }
+            else {
+                return { success: true, detail: `复用已有目录: ${title}`, new_node_uuid: uuid };
+            }
+        }
+        case "appendNode": {
+            const opBookId = op.book_id || bookId;
+            let docIds;
+            try {
+                docIds = JSON.parse(op.doc_ids);
+                if (!Array.isArray(docIds) || docIds.length === 0) {
+                    return { success: false, error: "appendNode doc_ids 必须是非空 JSON 数组" };
+                }
+            }
+            catch {
+                return { success: false, error: "appendNode doc_ids 格式无效" };
+            }
+            const targetUuid = await resolveTarget(opBookId, op);
+            // 有目标目录时：先挂根再移（语雀 API 的 target_uuid 对 DOC 类型不可靠）
+            if (targetUuid) {
+                // Step 1: 挂到根目录
+                const rootResult = await apiPut(`/repos/${opBookId}/toc`, {
+                    action: "appendNode",
+                    action_mode: "child",
+                    type: "DOC",
+                    doc_ids: docIds,
+                }, `Append docs to root`);
+                if (isErrorResult(rootResult)) {
+                    return { success: false, error: `挂载文档到根目录失败: ${docIds.join(",")}` };
+                }
+                // Step 2: 从 PUT 响应提取新节点 uuid，逐个 remove + append 到目标
+                const rootToc = rootResult.data || [];
+                invalidateTocCache(opBookId);
+                const moved = [];
+                for (const docId of docIds) {
+                    const newNode = rootToc.find((n) => n.doc_id === docId && !n.parent_uuid);
+                    if (!newNode?.uuid)
+                        continue;
+                    await apiPut(`/repos/${opBookId}/toc`, {
+                        action: "removeNode",
+                        action_mode: "sibling",
+                        node_uuid: newNode.uuid,
+                    }, `Move: remove ${newNode.uuid}`);
+                    await apiPut(`/repos/${opBookId}/toc`, {
+                        action: "appendNode",
+                        action_mode: "child",
+                        type: "DOC",
+                        doc_ids: [docId],
+                        target_uuid: targetUuid,
+                    }, `Move: append ${docId}`);
+                    moved.push(docId);
+                }
+                invalidateTocCache(opBookId);
+                return { success: true, detail: `挂载文档 ${moved.join(",")} 到目录（先挂根再移）` };
+            }
+            // 无目标目录：直接挂到根目录
+            const payload = {
+                action: "appendNode",
+                action_mode: op.action_mode || "child",
+                type: "DOC",
+                doc_ids: docIds,
+            };
+            const data = await apiPut(`/repos/${opBookId}/toc`, payload, `Append docs to TOC`);
+            if (isErrorResult(data)) {
+                return { success: false, error: `挂载文档失败: ${docIds.join(",")}` };
+            }
+            invalidateTocCache(opBookId);
+            return { success: true, detail: `挂载文档 ${docIds.join(",")} 到根目录` };
+        }
+        case "removeNode": {
+            const opBookId = op.book_id || bookId;
+            if (!op.node_uuid)
+                return { success: false, error: "removeNode 缺少 node_uuid 字段" };
+            const data = await apiPut(`/repos/${opBookId}/toc`, {
+                action: "removeNode",
+                action_mode: "sibling",
+                node_uuid: op.node_uuid,
+            }, `Remove TOC node: ${op.node_uuid}`);
+            if (isErrorResult(data)) {
+                return { success: false, error: `删除节点失败: ${op.node_uuid}` };
+            }
+            invalidateTocCache(opBookId);
+            return { success: true, detail: `删除节点: ${op.node_uuid}` };
+        }
+        case "moveNode": {
+            const opBookId = op.book_id || bookId;
+            if (!op.node_uuid)
+                return { success: false, error: "moveNode 缺少 node_uuid 字段" };
+            const targetUuid = await resolveTarget(opBookId, op);
+            let nodeUuid = op.node_uuid;
+            let nodeType;
+            let nodeTitle;
+            let nodeDocId;
+            const nodes = await getTocCached(opBookId);
+            const node = nodes.find((n) => n.uuid === op.node_uuid);
+            if (!node) {
+                // 节点不在 TOC 中：需要 doc_id 来先挂根再移
+                const docId = op.doc_id;
+                if (!docId) {
+                    return { success: false, error: `节点不在 TOC 中: ${op.node_uuid}。请提供 doc_id 字段，工具会自动挂根再移` };
+                }
+                // 先挂到根目录
+                const rootResult = await apiPut(`/repos/${opBookId}/toc`, {
+                    action: "appendNode",
+                    action_mode: "child",
+                    type: "DOC",
+                    doc_ids: [docId],
+                }, `Move orphan: append to root ${docId}`);
+                if (isErrorResult(rootResult)) {
+                    return { success: false, error: `游离文档挂根失败: ${docId}` };
+                }
+                // 从 PUT 响应提取新节点 uuid
+                const rootToc = rootResult.data || [];
+                invalidateTocCache(opBookId);
+                const newNode = rootToc.find((n) => n.doc_id === docId && !n.parent_uuid);
+                if (!newNode?.uuid) {
+                    return { success: false, error: `挂根后找不到文档: ${docId}` };
+                }
+                nodeUuid = newNode.uuid;
+                nodeType = "DOC";
+                nodeTitle = newNode.title;
+                nodeDocId = docId;
+            }
+            else {
+                nodeType = node.type;
+                nodeTitle = node.title;
+                nodeDocId = node.doc_id;
+            }
+            // 先删原节点
+            const removeResult = await apiPut(`/repos/${opBookId}/toc`, {
+                action: "removeNode",
+                action_mode: "sibling",
+                node_uuid: nodeUuid,
+            }, `Move node: remove ${nodeUuid}`);
+            if (isErrorResult(removeResult)) {
+                return { success: false, error: `移动节点 remove 失败: ${nodeUuid}` };
+            }
+            // 再 append 到目标位置
+            const appendPayload = {
+                action: "appendNode",
+                action_mode: op.action_mode || "child",
+                type: nodeType,
+            };
+            if (nodeType === "DOC" && nodeDocId) {
+                appendPayload.doc_ids = [nodeDocId];
+            }
+            else if (nodeType === "TITLE") {
+                appendPayload.title = nodeTitle;
+            }
+            else if (nodeType === "LINK") {
+                appendPayload.title = nodeTitle;
+                appendPayload.url = node?.url;
+            }
+            if (targetUuid)
+                appendPayload.target_uuid = targetUuid;
+            const appendResult = await apiPut(`/repos/${opBookId}/toc`, appendPayload, `Move node: append ${nodeUuid}`);
+            if (isErrorResult(appendResult)) {
+                return { success: false, error: `移动节点 append 失败: ${nodeUuid}（remove 已执行，文档可能游离在根目录）` };
+            }
+            invalidateTocCache(opBookId);
+            const detail = !node
+                ? `移动游离节点: doc_id=${nodeDocId} → 目标目录`
+                : `移动节点: ${nodeUuid}`;
+            return { success: true, detail };
+        }
+        default:
+            return { success: false, error: `未知操作: ${op.action}` };
+    }
+}
+//# sourceMappingURL=batch-update.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * toc/get — 获取知识库目录
+ *
+ * 端点：GET /api/v2/repos/:book_id/toc
+ * 职责：返回知识库完整目录树（扁平数组，通过 uuid 父子关系导航）
+ */
+import type { McpTool } from "../common/types.js";
+export declare const tocGet: McpTool;

package/dist/toc/get-toc.js

@@ -0,0 +1,33 @@
+/**
+ * toc/get — 获取知识库目录
+ *
+ * 端点：GET /api/v2/repos/:book_id/toc
+ * 职责：返回知识库完整目录树（扁平数组，通过 uuid 父子关系导航）
+ */
+import { apiGet } from "../common/api-client.js";
+import { requiredString } from "../common/validate.js";
+import { formatToc, handleApiCall } from "../common/format.js";
+export const tocGet = {
+    name: "yuque_get_toc",
+    description: "Get repo TOC tree (flat array, navigable via uuid/parent_uuid/child_uuid). GET /repos/:id/toc. 详见 references/api/toc_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            book_id: { type: "string", description: "Repository ID (numeric) or namespace like group/book_slug (required)" },
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
+        },
+        required: ["book_id"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = requiredString(args?.book_id, "book_id");
+        if (__v)
+            return __v;
+        const raw = args?.raw;
+        const bookId = args?.book_id;
+        const data = await apiGet(`/repos/${bookId}/toc`, undefined, "Get TOC");
+        const items = data?.data ?? data;
+        return handleApiCall(items, formatToc, raw);
+    },
+};
+//# sourceMappingURL=get-toc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-toc.js","sourceRoot":"","sources":["../../src/toc/get-toc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG/D,MAAM,CAAC,MAAM,MAAM,GAAY;IAC7B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,6HAA6H;IAE1I,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sEAAsE,EAAE;YAChH,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,8DAA8D,EAAE;SACtG;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IAED,KAAK,CAAC,OAAO,CAAC,IAAI;QAChB,YAAY;QACZ,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACrD,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,EAAE,GAA0B,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,EAAE,OAAiB,CAAC;QAEvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,MAAM,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACxE,MAAM,KAAK,GAAI,IAA2B,EAAE,IAAI,IAAI,IAAI,CAAC;QACzD,OAAO,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAC"}

package/dist/toc/index.d.ts

@@ -0,0 +1,5 @@
+export { tocGet } from "./get-toc.js";
+export { tocUpdate } from "./update-toc.js";
+export { tocBatchUpdate } from "./batch-update.js";
+import type { McpTool } from "../common/types.js";
+export declare const tocTools: McpTool[];

package/dist/toc/index.js

@@ -0,0 +1,8 @@
+export { tocGet } from "./get-toc.js";
+export { tocUpdate } from "./update-toc.js";
+export { tocBatchUpdate } from "./batch-update.js";
+import { tocGet } from "./get-toc.js";
+import { tocUpdate } from "./update-toc.js";
+import { tocBatchUpdate } from "./batch-update.js";
+export const tocTools = [tocGet, tocUpdate, tocBatchUpdate];
+//# sourceMappingURL=index.js.map

package/dist/toc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/toc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,CAAC,MAAM,QAAQ,GAAc,CAAC,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC"}

package/dist/toc/update-toc.d.ts

@@ -0,0 +1,8 @@
+/**
+ * toc/update — 更新知识库目录
+ *
+ * 端点：PUT /api/v2/repos/:book_id/toc
+ * 职责：创建/移动/编辑/删除目录节点
+ */
+import type { McpTool } from "../common/types.js";
+export declare const tocUpdate: McpTool;