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

package/dist/tapd-client.d.ts

@@ -0,0 +1,99 @@
+export declare class TapdClient {
+    private authHeader;
+    private baseUrl;
+    private authType;
+    private apiUser?;
+    private apiPassword?;
+    private accessToken?;
+    private sdk?;
+    private readonly sdkEnabled;
+    private readonly verbose;
+    private constructor();
+    /**
+     * Create client from OAuth access token
+     */
+    static fromAccessToken(accessToken: string, baseUrl?: string): TapdClient;
+    /**
+     * Create client from Basic Auth credentials
+     */
+    static fromBasicAuth(apiUser: string, apiPassword: string, baseUrl?: string): TapdClient;
+    /**
+     * Create client from environment variables
+     * Priority: TAPD_ACCESS_TOKEN > (TAPD_API_USER + TAPD_API_PASSWORD)
+     */
+    static fromEnv(): TapdClient;
+    /**
+     * Get user nickname from environment variable TAPD_NICK_NAME
+     */
+    static getNickName(): string | undefined;
+    /**
+     * Get default workspace ID from environment variable TAPD_DEFAULT_WORKSPACE_ID
+     */
+    static getDefaultWorkspaceId(): number | undefined;
+    /**
+     * Get default STORY workitem type ID from environment variable
+     */
+    static getDefaultStoryWorkitemTypeId(): string | undefined;
+    /**
+     * Get default TASK workitem type ID from environment variable
+     */
+    static getDefaultTaskWorkitemTypeId(): string | undefined;
+    /**
+     * Convert short ID to long ID
+     *
+     * Rules:
+     * - Pure numeric ID with ≤9 digits is treated as short ID
+     * - For cloud environment (is_cloud=true), prefix is '11'
+     * - Pad short ID to 9 digits and concatenate with workspace_id
+     * - Non-short IDs are returned unchanged
+     *
+     * @param id - Story/bug/task ID (short or long format)
+     * @param workspaceId - Workspace ID for constructing long ID
+     * @param isCloud - Whether it's cloud environment (default: true)
+     */
+    static toLongId(id: string | number, workspaceId: string | number, isCloud?: boolean): string;
+    /**
+   * Make HTTP request to TAPD API with retry support
+   *
+   * Retry policy:
+   * - Retry on 429/500/502/503 status codes
+   * - Max 3 retries with exponential backoff (1s, 2s, 4s)
+   * - POST requests do NOT retry (avoid duplicate creation)
+   */
+    /**
+     * Encode request params shared by the fetch path and the SDK path.
+     * - undefined values are dropped
+     * - POST restores literal "\n" to real newlines (unchanged v1 behavior)
+     */
+    private static encodeParams;
+    private unwrap;
+    /**
+     * Lazily create the SDK instance matching the current auth mode.
+     * - oauth: reuses the existing access token (no authenticate() round-trip)
+     * - basic: SDK builds the Basic header from client/secret
+     */
+    private getSdk;
+    /**
+     * Route a request through the SDK when the method+path is mapped,
+     * otherwise (and on read-only SDK failure) through the fetch client.
+     */
+    private route;
+    request<T>(method: 'GET' | 'POST', path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
+    /**
+     * GET request to TAPD API
+     */
+    get<T>(path: string, params?: Record<string, string | number | boolean>): Promise<T>;
+    /**
+     * POST request to TAPD API
+     */
+    post<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
+}
+/**
+ * TAPD API response structure
+ */
+export interface TapdResponse<T> {
+    status: number;
+    data: T;
+    info: string;
+}
+//# sourceMappingURL=tapd-client.d.ts.map

package/dist/tapd-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tapd-client.d.ts","sourceRoot":"","sources":["../src/tapd-client.ts"],"names":[],"mappings":"AAgBA,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,GAAG,CAAC,CAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAEhE,OAAO;IAgBP;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAIzE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAWxF;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,UAAU;IAmB5B;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,SAAS;IAIxC;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,MAAM,GAAG,SAAS;IAKlD;;OAEG;IACH,MAAM,CAAC,6BAA6B,IAAI,MAAM,GAAG,SAAS;IAI1D;;OAEG;IACH,MAAM,CAAC,4BAA4B,IAAI,MAAM,GAAG,SAAS;IAIzD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,UAAO,GAAG,MAAM;IAc1F;;;;;;;KAOC;IACD;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAe3B,OAAO,CAAC,MAAM;IAQd;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAOd;;;OAGG;YACW,KAAK;IAyBb,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC;IAwEb;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1F;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAGxG;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/tapd-client.js

@@ -0,0 +1,252 @@
+/**
+ * TAPD API Client
+ *
+ * Supports dual authentication modes:
+ * - Basic Auth: using api_user + api_password
+ * - OAuth/Bearer Token: using access_token
+ *
+ * Routes requests through @opentapd/tapd-node-sdk when the method+path is
+ * listed in SDK_ROUTES, otherwise falls back to the custom fetch client.
+ * - GET SDK failures fall back to fetch (read-only, idempotent)
+ * - POST SDK failures throw directly (never fallback, avoid duplicate writes)
+ * - Set TAPD_SDK_DISABLED=1 to bypass the SDK entirely (rollback switch)
+ */
+import TapdSdk from '@opentapd/tapd-node-sdk';
+import { SDK_ROUTES } from './sdk-routes.js';
+export class TapdClient {
+    authHeader;
+    baseUrl;
+    authType;
+    apiUser;
+    apiPassword;
+    accessToken;
+    sdk;
+    sdkEnabled = process.env.TAPD_SDK_DISABLED !== '1';
+    verbose = process.env.TAPD_LOG_VERBOSE === '1';
+    constructor(authHeader, baseUrl, authType, apiUser, apiPassword, accessToken) {
+        this.authHeader = authHeader;
+        this.baseUrl = baseUrl ?? process.env.TAPD_API_BASE_URL ?? 'https://api.tapd.cn';
+        this.authType = authType ?? 'basic';
+        this.apiUser = apiUser;
+        this.apiPassword = apiPassword;
+        this.accessToken = accessToken;
+    }
+    /**
+     * Create client from OAuth access token
+     */
+    static fromAccessToken(accessToken, baseUrl) {
+        return new TapdClient(`Bearer ${accessToken}`, baseUrl, 'oauth', undefined, undefined, accessToken);
+    }
+    /**
+     * Create client from Basic Auth credentials
+     */
+    static fromBasicAuth(apiUser, apiPassword, baseUrl) {
+        const credentials = `${apiUser}:${apiPassword}`;
+        return new TapdClient(`Basic ${Buffer.from(credentials).toString('base64')}`, baseUrl, 'basic', apiUser, apiPassword);
+    }
+    /**
+     * Create client from environment variables
+     * Priority: TAPD_ACCESS_TOKEN > (TAPD_API_USER + TAPD_API_PASSWORD)
+     */
+    static fromEnv() {
+        const apiUser = process.env.TAPD_API_USER;
+        const apiPassword = process.env.TAPD_API_PASSWORD;
+        const accessToken = process.env.TAPD_ACCESS_TOKEN;
+        const baseUrl = process.env.TAPD_API_BASE_URL;
+        if (accessToken) {
+            return TapdClient.fromAccessToken(accessToken, baseUrl);
+        }
+        if (apiUser && apiPassword) {
+            return TapdClient.fromBasicAuth(apiUser, apiPassword, baseUrl);
+        }
+        throw new Error('Authentication required. Set TAPD_ACCESS_TOKEN or (TAPD_API_USER + TAPD_API_PASSWORD) environment variables.');
+    }
+    /**
+     * Get user nickname from environment variable TAPD_NICK_NAME
+     */
+    static getNickName() {
+        return process.env.TAPD_NICK_NAME;
+    }
+    /**
+     * Get default workspace ID from environment variable TAPD_DEFAULT_WORKSPACE_ID
+     */
+    static getDefaultWorkspaceId() {
+        const id = process.env.TAPD_DEFAULT_WORKSPACE_ID;
+        return id ? parseInt(id, 10) : undefined;
+    }
+    /**
+     * Get default STORY workitem type ID from environment variable
+     */
+    static getDefaultStoryWorkitemTypeId() {
+        return process.env.TAPD_DEFAULT_STORY_WORKITEM_TYPE_ID;
+    }
+    /**
+     * Get default TASK workitem type ID from environment variable
+     */
+    static getDefaultTaskWorkitemTypeId() {
+        return process.env.TAPD_DEFAULT_TASK_WORKITEM_TYPE_ID;
+    }
+    /**
+     * Convert short ID to long ID
+     *
+     * Rules:
+     * - Pure numeric ID with ≤9 digits is treated as short ID
+     * - For cloud environment (is_cloud=true), prefix is '11'
+     * - Pad short ID to 9 digits and concatenate with workspace_id
+     * - Non-short IDs are returned unchanged
+     *
+     * @param id - Story/bug/task ID (short or long format)
+     * @param workspaceId - Workspace ID for constructing long ID
+     * @param isCloud - Whether it's cloud environment (default: true)
+     */
+    static toLongId(id, workspaceId, isCloud = true) {
+        const idStr = String(id).trim();
+        const workspaceIdStr = String(workspaceId);
+        // Check if it's a pure numeric short ID (≤9 digits)
+        if (/^\d+$/.test(idStr) && idStr.length <= 9) {
+            const prefix = isCloud ? '11' : '10';
+            const paddedId = idStr.padStart(9, '0');
+            return `${prefix}${workspaceIdStr}${paddedId}`;
+        }
+        return idStr;
+    }
+    /**
+   * Make HTTP request to TAPD API with retry support
+   *
+   * Retry policy:
+   * - Retry on 429/500/502/503 status codes
+   * - Max 3 retries with exponential backoff (1s, 2s, 4s)
+   * - POST requests do NOT retry (avoid duplicate creation)
+   */
+    /**
+     * Encode request params shared by the fetch path and the SDK path.
+     * - undefined values are dropped
+     * - POST restores literal "\n" to real newlines (unchanged v1 behavior)
+     */
+    static encodeParams(method, params) {
+        const restoreNewline = method === 'POST';
+        return new URLSearchParams(Object.entries(params ?? {})
+            .filter(([, value]) => value !== undefined)
+            .map(([key, value]) => [
+            key,
+            restoreNewline ? String(value).replace(/\\n/g, '\n') : String(value),
+        ]));
+    }
+    unwrap(response) {
+        const result = response;
+        if (result.status !== 1) {
+            throw new Error(`TAPD API error: ${result.info ?? 'Unknown error'}`);
+        }
+        return result.data;
+    }
+    /**
+     * Lazily create the SDK instance matching the current auth mode.
+     * - oauth: reuses the existing access token (no authenticate() round-trip)
+     * - basic: SDK builds the Basic header from client/secret
+     */
+    getSdk() {
+        this.sdk ??= this.authType === 'oauth'
+            ? new TapdSdk({ accessToken: this.accessToken, address: this.baseUrl })
+            : new TapdSdk({ client: this.apiUser, secret: this.apiPassword, address: this.baseUrl });
+        return this.sdk;
+    }
+    /**
+     * Route a request through the SDK when the method+path is mapped,
+     * otherwise (and on read-only SDK failure) through the fetch client.
+     */
+    async route(method, path, params) {
+        const sdkMethod = this.sdkEnabled ? SDK_ROUTES[`${method} ${path}`] : undefined;
+        if (sdkMethod) {
+            try {
+                const encoded = TapdClient.encodeParams(method, params);
+                const sdk = this.getSdk();
+                const response = await sdk[sdkMethod](encoded);
+                return this.unwrap(response);
+            }
+            catch (error) {
+                if (method === 'POST') {
+                    throw error;
+                }
+                if (this.verbose) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    console.error(`[tapd-client] SDK ${sdkMethod} failed for ${method} ${path}, falling back to fetch: ${message}`);
+                }
+            }
+        }
+        return this.request(method, path, params);
+    }
+    async request(method, path, params) {
+        const url = new URL(path, this.baseUrl);
+        const headers = {
+            'Authorization': this.authHeader,
+        };
+        let body;
+        const encoded = TapdClient.encodeParams(method, params);
+        if (method === 'GET') {
+            for (const [key, value] of encoded) {
+                url.searchParams.append(key, value);
+            }
+        }
+        else {
+            headers['Content-Type'] = 'application/x-www-form-urlencoded';
+            body = encoded.toString();
+        }
+        // Retry configuration
+        const maxRetries = 3;
+        const retryableStatusCodes = [429, 500, 502, 503];
+        const shouldRetry = method === 'GET'; // Only retry GET requests
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                const response = await fetch(url.toString(), {
+                    method,
+                    headers,
+                    body,
+                });
+                if (!response.ok) {
+                    const errorText = await response.text();
+                    const error = new Error(`TAPD API error: ${response.status} ${response.statusText} - ${errorText.slice(0, 200)}`);
+                    // Check if we should retry
+                    if (shouldRetry && retryableStatusCodes.includes(response.status) && attempt < maxRetries) {
+                        lastError = error;
+                        const delayMs = Math.pow(2, attempt) * 1000; // 1s, 2s, 4s
+                        await new Promise(resolve => setTimeout(resolve, delayMs));
+                        continue;
+                    }
+                    throw error;
+                }
+                const contentType = response.headers.get('content-type');
+                if (!contentType?.includes('application/json')) {
+                    const text = await response.text();
+                    throw new Error(`TAPD API returned non-JSON response: ${text.slice(0, 100)}`);
+                }
+                return this.unwrap(await response.json());
+            }
+            catch (error) {
+                // For non-retryable errors or final attempt, throw immediately
+                if (!shouldRetry || attempt >= maxRetries) {
+                    throw error;
+                }
+                // For network errors, retry
+                lastError = error instanceof Error ? error : new Error(String(error));
+                const delayMs = Math.pow(2, attempt) * 1000;
+                await new Promise(resolve => setTimeout(resolve, delayMs));
+            }
+        }
+        // All retries exhausted
+        throw lastError ?? new Error('Request failed after all retries');
+    }
+    /**
+     * GET request to TAPD API
+     */
+    async get(path, params) {
+        return this.route('GET', path, params);
+    }
+    /**
+     * POST request to TAPD API
+     */
+    async post(path, params) {
+        return this.route('POST', path, params);
+    }
+}
+//# sourceMappingURL=tapd-client.js.map

package/dist/tapd-client.js.map

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

package/dist/tools/attachment.d.ts

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

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

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

package/dist/tools/attachment.js

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+import { TapdClient } from '../tapd-client.js';
+export const attachmentTools = [
+    // Standard TAPD API attachment tools
+    {
+        name: 'tapd_get_attachments',
+        description: 'Get attachment list from TAPD',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().optional().describe('Attachment ID, supports multiple IDs；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            entity_id: z.string().optional().describe('Related entity ID (story/task/bug/wiki ID)；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            entity_type: z.string().optional().describe('Entity type (story, task, bug, wiki)'),
+            filename: z.string().optional().describe('Filename'),
+            owner: z.string().optional().describe('Uploader'),
+            created: z.string().optional().describe('Creation time, supports time query'),
+            modified: z.string().optional().describe('Last modification time, supports time query'),
+            fields: z.string().optional().describe('Comma-separated list of fields to return'),
+            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"'),
+        }),
+        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('/attachments', { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: 'tapd_get_attachment',
+        description: 'Get a single attachment from TAPD',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().describe('Attachment ID (required)；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            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('/attachments/get_one', { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: 'tapd_get_attachment_download_url',
+        description: 'Get download URL for a single attachment (valid for 300s)',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().describe('Attachment ID (required)；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            filename: z.string().optional().describe('Filename for download'),
+        }),
+        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('/attachments/documents_down', { ...params, workspace_id: workspaceId });
+        },
+    },
+    // Mini (轻协作) API attachment tools
+    {
+        name: 'tapd_mini_get_attachments',
+        description: 'Get attachments from mini workspace',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().optional().describe('Attachment ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            entry_id: z.string().optional().describe('Item ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            filename: z.string().optional().describe('Filename'),
+            owner: z.string().optional().describe('Uploader'),
+            limit: z.number().optional().describe('Return count, default 30, 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('/attachments', { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: 'tapd_mini_get_attachment_download_url',
+        description: 'Get download URL for a single mini workspace attachment (valid for 300s)',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().describe('Attachment ID (required)；必须以字符串（带引号）传递，禁止传数值，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('/attachments/down', { ...params, workspace_id: workspaceId });
+        },
+    },
+];
+//# sourceMappingURL=attachment.js.map

package/dist/tools/attachment.js.map

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

package/dist/tools/board.d.ts

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

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

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

package/dist/tools/board.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { TapdClient } from '../tapd-client.js';
+export const boardTools = [
+    {
+        name: "tapd_add_board_card",
+        description: "新建看板工作项",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            board_id: z.string().describe("看板ID (必填)；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度"),
+            column_id: z.string().describe("看板列ID (必填)；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度"),
+            name: z.string().describe("工作项标题 (必填)"),
+            description: z.string().optional().describe("详细描述"),
+            owner: z.string().optional().describe("负责人，默认当前用户"),
+            creator: z.string().optional().describe("创建人，默认当前用户"),
+            priority: z.string().optional().describe("优先级"),
+            category_id: z.string().optional().describe("分类ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度"),
+            due: z.string().optional().describe("预计完成日期，格式: YYYY-MM-DD"),
+        }),
+        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("/board_cards/add", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_board_cards",
+        description: "获取看板工作项列表",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            board_id: z.string().optional().describe("看板ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度"),
+            column_id: z.string().optional().describe("看板列ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度"),
+            id: z.string().optional().describe('工作项ID，支持多ID查询；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            name: z.string().optional().describe("工作项标题，支持模糊匹配"),
+            owner: z.string().optional().describe("负责人"),
+            creator: z.string().optional().describe("创建人"),
+            status: z.string().optional().describe("状态"),
+            priority: z.string().optional().describe("优先级"),
+            category_id: z.string().optional().describe("分类ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度"),
+            created: z.string().optional().describe("创建时间，支持时间查询"),
+            modified: z.string().optional().describe("修改时间，支持时间查询"),
+            due: z.string().optional().describe("预计完成日期，支持时间查询"),
+            limit: z.number().optional().describe("返回数量限制，默认30，最大200"),
+            page: z.number().optional().describe("页码，默认1"),
+            order: z.string().optional().describe("排序规则，如 created desc"),
+            fields: 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("/board_cards", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_update_board_card",
+        description: "更新看板工作项",
+        inputSchema: z.object({
+            id: z.string().describe('工作项ID (必填)；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度'),
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            board_id: z.string().optional().describe("看板ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度"),
+            column_id: z.string().optional().describe("看板列ID（用于移动卡片）；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度"),
+            name: z.string().optional().describe("工作项标题"),
+            description: z.string().optional().describe("详细描述"),
+            owner: z.string().optional().describe("负责人"),
+            status: z.string().optional().describe("状态"),
+            priority: z.string().optional().describe("优先级"),
+            due: z.string().optional().describe("预计完成日期，格式: YYYY-MM-DD"),
+        }),
+        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("/board_cards/update", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_board_columns",
+        description: "获取看板板块",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            board_id: z.string().describe("看板ID (必填)；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度"),
+            id: z.string().optional().describe("看板列ID；必须以字符串（带引号）传递，禁止传数值，20 位 ID 超出 JS 安全整数范围会丢精度"),
+            fields: 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("/board_columns", { ...params, workspace_id: workspaceId });
+        },
+    },
+];
+//# sourceMappingURL=board.js.map

package/dist/tools/board.js.map

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

package/dist/tools/bug.d.ts

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

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

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