@xihe-lab/tapd-core 2.0.0-rc.1

package/dist/tools/timesheet.js

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+import { TapdClient } from '../tapd-client.js';
+export const timesheetTools = [
+    {
+        name: "tapd_get_timesheets",
+        description: "Get timesheet records from TAPD",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe("项目ID（可省略，使用默认配置）"),
+            id: z.string().optional().describe('Timesheet ID, supports multiple IDs；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            entity_type: z.string().optional().describe("Entity type: story, task, or bug"),
+            entity_id: z.string().optional().describe('Entity ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            timespent: z.string().optional().describe("Hours spent"),
+            spentdate: z.string().optional().describe("Spent date, supports time query"),
+            modified: z.string().optional().describe("Last modified time, supports time query"),
+            owner: z.string().optional().describe("Timesheet owner"),
+            created: z.string().optional().describe("Creation time, supports time query"),
+            memo: z.string().optional().describe("Work description"),
+            is_delete: z.number().optional().describe("Is deleted: 0-active (default), 1-deleted"),
+            workflow_step: z.string().optional().describe("Workflow step name"),
+            relation_type: z.string().optional().describe("Relation type: entity or workflow"),
+            include_parent_story_timesheet: z.number().optional().describe("Include parent story timesheet: 0-no, 1-yes"),
+            limit: z.number().optional().describe("Number of results to return, max 200"),
+            page: z.number().optional().describe("Page number, default 1"),
+            order: z.string().optional().describe("Sort order, e.g., 'created desc'"),
+            fields: z.string().optional().describe("Comma-separated list of fields to return"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/timesheets", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_create_timesheet",
+        description: "Create a new timesheet entry",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe("项目ID（可省略，使用默认配置）"),
+            owner: z.string().optional().describe("Owner (defaults to TAPD_NICK_NAME env)"),
+            entity_type: z.string().describe("Type: story, task, or bug"),
+            entity_id: z.string().describe('ID of the story, bug, or task；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            spentdate: z.string().describe("Date of work (YYYY-MM-DD)"),
+            timespent: z.number().describe("Hours spent"),
+            memo: z.string().optional().describe("Work description"),
+            timeremain: z.string().optional().describe("Remaining hours"),
+            cc: z.string().optional().describe("Copy to users, separated by |"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const finalParams = {
+                ...params,
+                workspace_id: workspaceId,
+                owner: params.owner ?? TapdClient.getNickName(),
+            };
+            return client.post("/timesheets", finalParams);
+        },
+    },
+    {
+        name: "tapd_get_timesheet_count",
+        description: "Get the count of timesheet records matching criteria",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe("项目ID（可省略，使用默认配置）"),
+            entity_type: z.string().optional().describe("Entity type: story, task, or bug"),
+            entity_id: z.string().optional().describe('Entity ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            owner: z.string().optional().describe("Timesheet owner"),
+            spentdate: z.string().optional().describe("Spent date, supports time query"),
+            created: z.string().optional().describe("Creation time, supports time query"),
+            modified: z.string().optional().describe("Last modified time, supports time query"),
+            is_delete: z.number().optional().describe("Is deleted"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/timesheets/count", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_update_timesheet",
+        description: "更新工时记录",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe("项目ID（可省略，使用默认配置）"),
+            id: z.string().describe('工时记录ID (必填)；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            timespent: z.number().optional().describe("工时"),
+            memo: z.string().optional().describe("工作描述"),
+            spentdate: z.string().optional().describe("工作日期 YYYY-MM-DD"),
+            timeremain: z.string().optional().describe("剩余工时"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.post("/timesheets", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_delete_timesheets",
+        description: "删除工时记录",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe("项目ID（可省略，使用默认配置）"),
+            id: z.string().describe('工时记录ID (必填)；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.post("/timesheets/delete", { ...params, workspace_id: workspaceId });
+        },
+    },
+];
+//# sourceMappingURL=timesheet.js.map

package/dist/tools/timesheet.js.map

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

package/dist/tools/user.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from '../types.js';
+export declare const userTools: ToolDef[];
+//# sourceMappingURL=user.d.ts.map

package/dist/tools/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/tools/user.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,eAAO,MAAM,SAAS,EAAE,OAAO,EAqD9B,CAAC"}

package/dist/tools/user.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { TapdClient } from '../tapd-client.js';
+export const userTools = [
+    {
+        name: "tapd_get_personal_setting",
+        description: "Get personal settings for the current user",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            nick: z.string().describe("用户唯一标识 (必填)"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/users/get_personal_setting", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_roles",
+        description: "Get role list for a workspace",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/roles", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_third_user_mapping",
+        description: "获取第三方用户映射",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            third_type: z.string().optional().describe("第三方类型"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/users/third_user_mapping", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_current_user",
+        description: "获取当前认证用户的信息",
+        inputSchema: z.object({}),
+        handler: async (client) => {
+            return client.get("/users/info");
+        },
+    },
+];
+//# sourceMappingURL=user.js.map

package/dist/tools/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/tools/user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC;QACE,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,4CAA4C;QACzD,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YAChE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;SACzC,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,MAAkB,EAAE,MAAM,EAAE,EAAE;YAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,IAAI,UAAU,CAAC,qBAAqB,EAAE,CAAC;YAC9E,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;YACvG,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,6BAA6B,EAAE,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7F,CAAC;KACF;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,+BAA+B;QAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;SACjE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,MAAkB,EAAE,MAAM,EAAE,EAAE;YAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,IAAI,UAAU,CAAC,qBAAqB,EAAE,CAAC;YAC9E,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;YACvG,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;QACxE,CAAC;KACF;IACD;QACE,IAAI,EAAE,6BAA6B;QACnC,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YAChE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;SACpD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,MAAkB,EAAE,MAAM,EAAE,EAAE;YAC5C,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,IAAI,UAAU,CAAC,qBAAqB,EAAE,CAAC;YAC9E,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;YACvG,CAAC;YACD,OAAO,MAAM,CAAC,GAAG,CAAC,2BAA2B,EAAE,EAAE,GAAG,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;QAC3F,CAAC;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,MAAkB,EAAE,EAAE;YACpC,OAAO,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACnC,CAAC;KACF;CACF,CAAC"}

package/dist/tools/utility.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from '../types.js';
+export declare const utilityTools: ToolDef[];
+//# sourceMappingURL=utility.d.ts.map

package/dist/tools/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../src/tools/utility.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAiG3C,eAAO,MAAM,YAAY,EAAE,OAAO,EAwFjC,CAAC"}

package/dist/tools/utility.js

@@ -0,0 +1,165 @@
+import { z } from 'zod';
+import MarkdownIt from 'markdown-it';
+import TurndownService from 'turndown';
+import { gfm } from 'turndown-plugin-gfm';
+import { TapdClient } from '../tapd-client.js';
+const markdownIt = new MarkdownIt({ html: false, breaks: true });
+const turndown = new TurndownService({ headingStyle: 'atx', codeBlockStyle: 'fenced' });
+turndown.use(gfm);
+const mdToHtmlSchema = z.object({
+    content: z.string().describe('Markdown 内容'),
+});
+const htmlToMdSchema = z.object({
+    html: z.string().describe('TAPD 富文本 HTML（description/comment 等）'),
+});
+// eslint-disable-next-line @typescript-eslint/require-await
+const mdToHtmlHandler = async (_client, params) => {
+    return { html: markdownIt.render(params.content) };
+};
+// eslint-disable-next-line @typescript-eslint/require-await
+const htmlToMdHandler = async (_client, params) => {
+    return { markdown: turndown.turndown(params.html) };
+};
+const shortToLongIdSchema = z.object({
+    short_id: z.string().describe('短 ID（纯数字，≤9 位）；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+    workspace_id: z.union([z.string(), z.number()]).describe('项目 ID'),
+    is_cloud: z.boolean().optional().default(true).describe('是否云环境（默认 true）'),
+});
+// eslint-disable-next-line @typescript-eslint/require-await
+const shortToLongIdHandler = async (_client, params) => {
+    const result = TapdClient.toLongId(params.short_id, params.workspace_id, params.is_cloud);
+    return {
+        short_id: params.short_id,
+        workspace_id: params.workspace_id,
+        long_id: result,
+        is_converted: result !== params.short_id,
+    };
+};
+/**
+ * Run promises with limited concurrency
+ */
+async function runWithConcurrency(tasks, maxConcurrency) {
+    const results = [];
+    const executing = [];
+    for (const task of tasks) {
+        const promise = task().then(result => {
+            results.push(result);
+        });
+        executing.push(promise);
+        if (executing.length >= maxConcurrency) {
+            await Promise.race(executing);
+            // Remove completed promises
+            for (let i = executing.length - 1; i >= 0; i--) {
+                const p = executing[i];
+                const settled = await Promise.race([p, Promise.resolve('pending')]);
+                if (settled !== 'pending') {
+                    void executing.splice(i, 1);
+                }
+            }
+        }
+    }
+    await Promise.all(executing);
+    return results;
+}
+const batchFetchStoriesSchema = z.object({
+    ids: z.array(z.string()).describe('需求 ID 列表（支持短 ID 和长 ID）'),
+    workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+    fields: z.string().optional().describe('返回字段'),
+    max_workers: z.number().optional().default(3).describe('最大并发数（默认 3）'),
+});
+const batchFetchBugsSchema = z.object({
+    ids: z.array(z.string()).describe('缺陷 ID 列表（支持短 ID 和长 ID）'),
+    workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+    fields: z.string().optional().describe('返回字段'),
+    max_workers: z.number().optional().default(3).describe('最大并发数（默认 3）'),
+});
+const batchFetchTasksSchema = z.object({
+    ids: z.array(z.string()).describe('任务 ID 列表（支持短 ID 和长 ID）'),
+    workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+    fields: z.string().optional().describe('返回字段'),
+    max_workers: z.number().optional().default(3).describe('最大并发数（默认 3）'),
+});
+export const utilityTools = [
+    {
+        name: 'tapd_md_to_html',
+        description: '将 Markdown 转为 TAPD 富文本 HTML（description/comment 字段专用），模型产 md 省 token，先转再传。',
+        inputSchema: mdToHtmlSchema,
+        handler: mdToHtmlHandler,
+    },
+    {
+        name: 'tapd_html_to_md',
+        description: '将 TAPD 富文本 HTML 转为 Markdown（读取 description/comment 后消费专用），HTML 转 md 省 input token。',
+        inputSchema: htmlToMdSchema,
+        handler: htmlToMdHandler,
+    },
+    {
+        name: 'tapd_short_to_long_id',
+        description: '将短 ID 转换为长 ID。规则：纯数字且 ≤9 位视为短 ID，云环境前缀 "11"，补零到 9 位拼接 workspace_id。',
+        inputSchema: shortToLongIdSchema,
+        handler: shortToLongIdHandler,
+    },
+    {
+        name: 'tapd_batch_fetch_stories',
+        description: '批量并发获取多个需求详情。支持短 ID 自动转换，默认并发数为 3。',
+        inputSchema: batchFetchStoriesSchema,
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const maxConcurrency = params.max_workers ?? 3;
+            const tasks = params.ids.map(id => () => {
+                const longId = TapdClient.toLongId(id, workspaceId);
+                return client.get('/stories', {
+                    workspace_id: workspaceId,
+                    id: longId,
+                    ...(params.fields ? { fields: params.fields } : {}),
+                });
+            });
+            return runWithConcurrency(tasks, maxConcurrency);
+        },
+    },
+    {
+        name: 'tapd_batch_fetch_bugs',
+        description: '批量并发获取多个缺陷详情。支持短 ID 自动转换，默认并发数为 3。',
+        inputSchema: batchFetchBugsSchema,
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const maxConcurrency = params.max_workers ?? 3;
+            const tasks = params.ids.map(id => () => {
+                const longId = TapdClient.toLongId(id, workspaceId);
+                return client.get('/bugs', {
+                    workspace_id: workspaceId,
+                    id: longId,
+                    ...(params.fields ? { fields: params.fields } : {}),
+                });
+            });
+            return runWithConcurrency(tasks, maxConcurrency);
+        },
+    },
+    {
+        name: 'tapd_batch_fetch_tasks',
+        description: '批量并发获取多个任务详情。支持短 ID 自动转换，默认并发数为 3。',
+        inputSchema: batchFetchTasksSchema,
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const maxConcurrency = params.max_workers ?? 3;
+            const tasks = params.ids.map(id => () => {
+                const longId = TapdClient.toLongId(id, workspaceId);
+                return client.get('/tasks', {
+                    workspace_id: workspaceId,
+                    id: longId,
+                    ...(params.fields ? { fields: params.fields } : {}),
+                });
+            });
+            return runWithConcurrency(tasks, maxConcurrency);
+        },
+    },
+];
+//# sourceMappingURL=utility.js.map

package/dist/tools/utility.js.map

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

package/dist/tools/wiki.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDef } from '../types.js';
+export declare const wikiTools: ToolDef[];
+//# sourceMappingURL=wiki.d.ts.map

package/dist/tools/wiki.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.d.ts","sourceRoot":"","sources":["../../src/tools/wiki.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,eAAO,MAAM,SAAS,EAAE,OAAO,EA+N9B,CAAC"}

package/dist/tools/wiki.js

@@ -0,0 +1,227 @@
+import { z } from 'zod';
+import { TapdClient } from '../tapd-client.js';
+export const wikiTools = [
+    {
+        name: "tapd_get_wikis",
+        description: "Get wiki pages from TAPD",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().optional().describe('Wiki ID, supports multiple IDs；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            name: z.string().optional().describe("Wiki page name, supports fuzzy matching"),
+            creator: z.string().optional().describe("Creator name"),
+            modifier: z.string().optional().describe("Last modifier name"),
+            note: z.string().optional().describe("Note/remark"),
+            view_count: z.string().optional().describe("View count"),
+            created: z.string().optional().describe("Creation time, supports time query"),
+            modified: z.string().optional().describe("Last modified time, supports time query"),
+            status: z.string().optional().describe("Status of the wiki page"),
+            category_id: z.string().optional().describe('Category ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            limit: z.number().optional().describe("Number of results to return, max 200"),
+            page: z.number().optional().describe("Page number, default 1"),
+            order: z.string().optional().describe("Sort order, e.g., 'created desc'"),
+            fields: z.string().optional().describe("Comma-separated list of fields to return"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/tapd_wikis", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_create_wiki",
+        description: "Create a new wiki page in TAPD",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            name: z.string().describe("Wiki page title"),
+            creator: z.string().optional().describe("Creator name (defaults to TAPD_NICK_NAME env)"),
+            description: z.string().optional().describe("Rich text content"),
+            markdown_description: z.string().optional().describe("Markdown content"),
+            note: z.string().optional().describe("Note/remark"),
+            parent_wiki_id: z.string().optional().describe('Parent wiki ID for nested pages；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const creator = params.creator ?? process.env.TAPD_NICK_NAME;
+            if (!creator) {
+                throw new Error("creator is required. Set TAPD_NICK_NAME environment variable or provide creator parameter.");
+            }
+            return client.post("/tapd_wikis", {
+                ...params,
+                workspace_id: workspaceId,
+                creator,
+            });
+        },
+    },
+    {
+        name: "tapd_update_wiki",
+        description: "Update an existing wiki page in TAPD",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().describe('Wiki ID (required)；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            name: z.string().optional().describe("Wiki page title"),
+            modifier: z.string().optional().describe("Modifier name (defaults to TAPD_NICK_NAME env)"),
+            description: z.string().optional().describe("Rich text content"),
+            markdown_description: z.string().optional().describe("Markdown content"),
+            note: z.string().optional().describe("Note/remark"),
+            parent_wiki_id: z.string().optional().describe('Parent wiki ID for nested pages；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const modifier = params.modifier ?? process.env.TAPD_NICK_NAME;
+            if (!modifier) {
+                throw new Error("modifier is required. Set TAPD_NICK_NAME environment variable or provide modifier parameter.");
+            }
+            return client.post("/tapd_wikis", {
+                ...params,
+                workspace_id: workspaceId,
+                modifier,
+            });
+        },
+    },
+    {
+        name: "tapd_get_wiki_count",
+        description: "Get the count of wiki pages matching filters",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().optional().describe('Wiki ID, supports multiple IDs；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            name: z.string().optional().describe("Wiki page name, supports fuzzy matching"),
+            creator: z.string().optional().describe("Creator name"),
+            modifier: z.string().optional().describe("Last modifier name"),
+            note: z.string().optional().describe("Note/remark"),
+            view_count: z.string().optional().describe("View count"),
+            created: z.string().optional().describe("Creation time, supports time query"),
+            modified: z.string().optional().describe("Last modified time, supports time query"),
+            status: z.string().optional().describe("Status of the wiki page"),
+            category_id: z.string().optional().describe('Category ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/tapd_wikis/count", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_wiki_attachments_count",
+        description: "Get the count of wiki attachments",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            wiki_id: z.string().optional().describe('Wiki ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/tapd_wikis_attachments/count", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_wiki_drawios",
+        description: "Get DrawIO data from wiki pages",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().optional().describe('Wiki ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/tapd_wikis_drawios", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_wiki_entity_permissions",
+        description: "Get entity permissions of wiki pages",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().optional().describe('Wiki ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/tapd_wikis_entity_permissions", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_wiki_followers",
+        description: "Get followers of wiki pages",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            wiki_id: z.string().optional().describe('Wiki ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            user: z.string().optional().describe("User name"),
+            limit: z.number().optional().describe("Number of results to return, max 200"),
+            page: z.number().optional().describe("Page number, default 1"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/tapd_wikis_followers", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_wiki_followers_count",
+        description: "Get the count of wiki followers",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            wiki_id: z.string().optional().describe('Wiki ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            user: z.string().optional().describe("User name"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/tapd_wikis_followers/count", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_wiki_tags",
+        description: "Get tags of wiki pages",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            wiki_id: z.string().optional().describe('Wiki ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            name: z.string().optional().describe("Tag name"),
+            limit: z.number().optional().describe("Number of results to return, max 200"),
+            page: z.number().optional().describe("Page number, default 1"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/tapd_wikis_tags", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_wiki_tags_count",
+        description: "Get the count of wiki tags",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            wiki_id: z.string().optional().describe('Wiki ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            name: z.string().optional().describe("Tag name"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/tapd_wikis_tags/count", { ...params, workspace_id: workspaceId });
+        },
+    },
+];
+//# sourceMappingURL=wiki.js.map