@brxce/mcp-server 1.0.0 → 1.0.2

package/dist/tools/workspace-list-tool.js

@@ -0,0 +1,113 @@
+/**
+ * Register Workspace List tool for LLM-invoked queries
+ * This tool allows the LLM to list all workspaces the user has access to
+ */
+export function registerWorkspaceListTool(server, apiClient) {
+    server.registerTool('brxce_list_workspaces', {
+        description: `List all workspaces the authenticated user has access to.
+
+⚠️ **IMPORTANT: When to use this tool vs user://me resource**
+
+**Use this tool when:**
+- User explicitly asks to "list workspaces" or "show all workspaces"
+- You need workspace details beyond basic info (description, type, role)
+- You want to filter workspaces by specific criteria
+
+**Use user://me resource when:**
+- You just need workspace IDs and names for context
+- You're about to call another MCP tool that needs workspaceId
+- You want both user info AND workspaces in one call
+
+**Common Use Cases:**
+- "Show me all my workspaces" → Use this tool
+- "What workspaces do I have access to?" → Use this tool
+- "I need the workspace ID for BRXCE Development" → Use user://me resource instead
+- Before calling brxce_workspace_overview → Use user://me resource instead
+
+**Output Format:**
+Returns JSON with:
+- workspaces: Array of workspace objects with full details
+  - id: Workspace ID
+  - name: Workspace name
+  - slug: URL-friendly identifier
+  - description: Workspace description
+  - workspaceType: Type of workspace (e.g., "team", "personal")
+  - planType: Subscription plan (e.g., "free", "pro")
+  - spaceId: Parent space ID (if applicable)
+  - userRole: User's role in this workspace (e.g., "owner", "member")
+- total: Total number of workspaces
+
+**Best Practices:**
+1. Prefer user://me resource for simple workspace lookups
+2. Use this tool when user explicitly asks for workspace list
+3. Cache workspace data to avoid repeated calls
+4. Use workspace slug for user-friendly URLs
+
+**Example Workflow:**
+\`\`\`
+User: "Show me all my workspaces"
+LLM:
+  1. Calls brxce_list_workspaces
+  2. Formats response in readable list
+  3. Shows workspace names, types, and roles
+\`\`\`
+
+⏰ **TIMEZONE HANDLING:**
+All timestamps in the response are in UTC (ISO 8601 format).
+Convert to user's local timezone when presenting results.`,
+        inputSchema: {},
+    }, async (args) => {
+        try {
+            const response = await apiClient.get('/mcp/workspaces');
+            if (!response.success || !response.data) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'Failed to fetch workspaces',
+                                message: 'API returned unsuccessful response',
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const workspaces = response.data;
+            // Return structured JSON for LLM to format
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            total: workspaces.length,
+                            workspaces: workspaces.map((ws) => ({
+                                id: ws.id,
+                                name: ws.name,
+                                slug: ws.slug,
+                                type: ws.workspaceType,
+                                plan: ws.planType,
+                                userRole: ws.userRole,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to fetch workspaces',
+                            message: error.message,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=workspace-list-tool.js.map

package/dist/tools/workspace-list-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-list-tool.js","sourceRoot":"","sources":["../../src/tools/workspace-list-tool.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,SAAoB;IAC/E,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0DAkDuC;QACpD,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,EAAE,IAAyB,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAwB,iBAAiB,CAAC,CAAC;YAE/E,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,4BAA4B;gCACnC,OAAO,EAAE,oCAAoC;6BAC9C,CAAC;yBACH;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC;YAEjC,2CAA2C;YAC3C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,KAAK,EAAE,UAAU,CAAC,MAAM;4BACxB,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gCAClC,EAAE,EAAE,EAAE,CAAC,EAAE;gCACT,IAAI,EAAE,EAAE,CAAC,IAAI;gCACb,IAAI,EAAE,EAAE,CAAC,IAAI;gCACb,IAAI,EAAE,EAAE,CAAC,aAAa;gCACtB,IAAI,EAAE,EAAE,CAAC,QAAQ;gCACjB,QAAQ,EAAE,EAAE,CAAC,QAAQ;6BACtB,CAAC,CAAC;yBACJ,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,4BAA4B;4BACnC,OAAO,EAAE,KAAK,CAAC,OAAO;yBACvB,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/workspace-members-list-tool.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ApiClient } from '../services/api-client.js';
+/**
+ * Register Workspace Members List tool for LLM-invoked queries
+ * This tool allows the LLM to list all members of a specific workspace
+ */
+export declare function registerWorkspaceMembersListTool(server: McpServer, apiClient: ApiClient): void;
+//# sourceMappingURL=workspace-members-list-tool.d.ts.map

package/dist/tools/workspace-members-list-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-members-list-tool.d.ts","sourceRoot":"","sources":["../../src/tools/workspace-members-list-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAqB3D;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,QAwNvF"}

package/dist/tools/workspace-members-list-tool.js

@@ -0,0 +1,207 @@
+import { z } from 'zod';
+/**
+ * Register Workspace Members List tool for LLM-invoked queries
+ * This tool allows the LLM to list all members of a specific workspace
+ */
+export function registerWorkspaceMembersListTool(server, apiClient) {
+    server.registerTool('brxce_list_workspace_members', {
+        description: `List all members of a specific workspace.
+
+⚠️ **CRITICAL: Workspace Verification Required**
+Before calling this tool, you MUST:
+1. Read the \`user://me\` resource to get available workspaces
+2. Identify the correct workspaceId from the resource data
+3. If user doesn't specify workspace, use their default workspace
+4. NEVER assume or guess workspaceId values
+
+**Example Workflow:**
+\`\`\`
+User: "Who are the members of BRXCE Development workspace?"
+LLM:
+  1. Reads user://me resource
+  2. Finds workspace: {id: 138, name: "BRXCE Development"}
+  3. Calls brxce_list_workspace_members with workspaceId: 138
+\`\`\`
+
+**When to use this tool:**
+The LLM should call this tool when the user asks about:
+- "Who are the members of workspace X?"
+- "Show me team members"
+- "Who can I assign this task to?"
+- "List all people in this workspace"
+- When creating meetings and need to select participants
+
+**Output Format:**
+Returns JSON with:
+- workspaceId: The workspace ID
+- workspaceName: The workspace name
+- totalMembers: Total number of members
+- members: Array of member objects
+  - userId: User ID (use this for assignee/participant fields)
+  - email: Email address
+  - name: Display name
+  - role: Role in workspace (e.g., "owner", "admin", "member")
+  - joinedAt: When they joined (ISO 8601, UTC)
+
+**Best Practices:**
+1. Always verify workspaceId exists via user://me resource first
+2. Use userId when assigning WorkNodes or adding meeting participants
+3. Show user-friendly names (name or username) in UI, but use userId internally
+4. Cache member list to avoid repeated calls during task assignment
+
+**Common Use Cases:**
+1. **Meeting Creation**: Get member list to select participants
+   \`\`\`
+   User: "Create a meeting with the team"
+   LLM:
+     1. Get workspace ID from context
+     2. Call brxce_list_workspace_members
+     3. Show member list for user to select
+     4. Use selected userId values in brxce_create_meeting
+   \`\`\`
+
+2. **Task Assignment**: Get member list to assign WorkNode
+   \`\`\`
+   User: "Assign this task to someone"
+   LLM:
+     1. Get workspace ID from WorkNode context
+     2. Call brxce_list_workspace_members
+     3. Show member list
+     4. Use selected userId in brxce_update_worknodes
+   \`\`\`
+
+3. **Team Overview**: Show who's in the workspace
+   \`\`\`
+   User: "Who's on the team?"
+   LLM:
+     1. Get default workspace ID
+     2. Call brxce_list_workspace_members
+     3. Format as readable list with roles
+   \`\`\`
+
+⏰ **TIMEZONE HANDLING:**
+The \`joinedAt\` field is in UTC (ISO 8601 format).
+When presenting to the user, convert to their local timezone:
+1. Check the current date/time from the <env> tag
+2. Identify the user's timezone (e.g., Asia/Seoul = UTC+9)
+3. Convert UTC timestamps to local time
+4. Format in user-friendly way (e.g., "가입: 2025-10-20")
+
+Example conversion (Korea Time, UTC+9):
+- API returns: "joinedAt": "2025-10-20T08:16:25.556Z" (UTC)
+- Display to user: "가입: 2025-10-20 오후 5:16" (KST)`,
+        inputSchema: {
+            workspaceId: z
+                .string()
+                .uuid()
+                .describe('Workspace ID (get from user://me resource)'),
+        },
+    }, async (args) => {
+        const { workspaceId } = args;
+        // Validate workspaceId
+        if (!workspaceId || typeof workspaceId !== 'string') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Invalid workspace ID',
+                            message: 'workspaceId is required and must be a UUID string',
+                            hint: 'Use user://me resource to get valid workspace IDs',
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const response = await apiClient.get(`/mcp/workspaces/${workspaceId}/members`);
+            if (!response.success || !response.data) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'Failed to fetch workspace members',
+                                message: response.message || 'API returned unsuccessful response',
+                                workspaceId,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const { workspaceId: wsId, workspaceName, members } = response.data;
+            // Return structured JSON for LLM to format
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            workspaceId: wsId,
+                            workspaceName,
+                            totalMembers: members.length,
+                            members: members.map((member) => ({
+                                userId: member.userId,
+                                name: member.name,
+                                email: member.email,
+                                role: member.role,
+                                joinedAt: member.joinedAt,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            // Handle 404 - workspace not found or no access
+            if (error.response?.status === 404) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'Workspace not found',
+                                message: `Workspace with ID ${workspaceId} does not exist or you don't have access to it`,
+                                workspaceId,
+                                hint: 'Use user://me resource to get valid workspace IDs',
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Handle 403 - access denied
+            if (error.response?.status === 403) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'Access denied',
+                                message: `You don't have permission to view members of workspace ${workspaceId}`,
+                                workspaceId,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // General error
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to fetch workspace members',
+                            message: error.message,
+                            workspaceId,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=workspace-members-list-tool.js.map

package/dist/tools/workspace-members-list-tool.js.map

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

package/dist/tools/workspace-statistics-tool.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ApiClient } from '../services/api-client.js';
+/**
+ * Register Workspace Statistics tool for analytics and insights
+ * Provides comprehensive statistics about workspace progress and team performance
+ */
+export declare function registerWorkspaceStatisticsTool(server: McpServer, apiClient: ApiClient): void;
+//# sourceMappingURL=workspace-statistics-tool.d.ts.map

package/dist/tools/workspace-statistics-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-statistics-tool.d.ts","sourceRoot":"","sources":["../../src/tools/workspace-statistics-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AA0D3D;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,QAuTtF"}

package/dist/tools/workspace-statistics-tool.js

@@ -0,0 +1,300 @@
+import { z } from 'zod';
+/**
+ * Register Workspace Statistics tool for analytics and insights
+ * Provides comprehensive statistics about workspace progress and team performance
+ */
+export function registerWorkspaceStatisticsTool(server, apiClient) {
+    server.registerTool('brxce_workspace_statistics', {
+        description: `Get comprehensive statistics and analytics for a workspace.
+
+⚠️ **CRITICAL: Workspace Verification Required**
+Before calling this tool, you MUST:
+1. Read the \`user://me\` resource to get available workspaces
+2. Identify the correct workspaceId from the resource data
+3. If user doesn't specify workspace, use their default workspace
+4. NEVER assume or guess workspaceId values
+
+**Example Workflow:**
+\`\`\`
+User: "이번 주 우리 팀 진행 상황 정리해줘"
+LLM:
+  1. Reads user://me resource
+  2. Finds workspace: {id: 138, name: "BRXCE Development"}
+  3. Calls brxce_workspace_statistics with workspaceId: 138, period: "this-week"
+  4. Formats statistics in readable Korean format
+\`\`\`
+
+**When to use this tool:**
+The LLM should call this tool when the user asks about:
+- "우리 팀 진행 상황 어때?" → Use with period: "all"
+- "이번 주 완료한 작업 몇 개야?" → Use with period: "this-week"
+- "누가 제일 많이 작업하고 있어?" → Check memberStats
+- "마감 임박한 작업 있어?" → Check dueDates.dueToday, dueDates.dueThisWeek
+- "전체적인 통계 보여줘" → Use with period: "all"
+
+**Time Periods:**
+- \`today\`: 오늘 생성/완료된 작업 중심 통계
+- \`this-week\`: 이번 주 작업 중심 통계
+- \`this-month\`: 이번 달 작업 중심 통계
+- \`all\`: 전체 작업 통계 (default)
+
+**Output Format:**
+Returns comprehensive statistics including:
+
+1. **Overview** - 전체 개요
+   - totalNodes: 전체 작업 수
+   - activeNodes: 진행 중인 작업 수 (완료/취소 제외)
+   - completedNodes: 완료된 작업 수
+   - completionRate: 완료율 (%)
+
+2. **By Status** - 상태별 분포
+   - backlog: 백로그 (인박스)
+   - not_started: 시작 전
+   - in_progress: 진행 중
+   - in_review: 리뷰 중
+   - completed: 완료
+   - cancelled: 취소
+
+3. **By Priority** - 우선순위별 분포
+   - critical: 긴급
+   - urgent: 시급
+   - high: 높음
+   - medium: 보통
+   - low: 낮음
+
+4. **By Node Type** - 타입별 분포
+   - goal: 목표
+   - project: 프로젝트
+   - subproject: 하위 프로젝트
+   - task: 작업
+   - subtask: 하위 작업
+
+5. **Member Stats** - 팀원별 통계
+   - userId: 사용자 ID
+   - name: 이름
+   - email: 이메일
+   - totalAssigned: 할당된 총 작업 수
+   - inProgress: 진행 중인 작업 수
+   - completed: 완료한 작업 수
+   - completionRate: 완료율 (%)
+
+6. **Due Dates** - 마감일 현황
+   - overdue: 마감 지난 작업 수
+   - dueToday: 오늘 마감 작업 수
+   - dueThisWeek: 이번 주 마감 작업 수
+   - dueThisMonth: 이번 달 마감 작업 수
+
+**Best Practices:**
+1. Always verify workspaceId via user://me resource first
+2. Use appropriate period based on user's question
+3. Format statistics in user-friendly Korean when presenting
+4. Highlight important metrics (overdue, high completion rates, etc.)
+5. Suggest actionable insights based on statistics
+
+**Common Use Cases:**
+
+1. **Team Progress Review**:
+   \`\`\`
+   User: "우리 팀 이번 주 진행 상황 보고서 만들어줘"
+   LLM:
+     1. Get workspace ID from context
+     2. Call brxce_workspace_statistics(workspaceId: 138, period: "this-week")
+     3. Format as progress report:
+        - "이번 주 총 15개 작업 중 8개 완료 (53% 완료율)"
+        - "3개 진행 중, 4개 대기 중"
+        - "마감 지난 작업: 2개 (주의 필요)"
+   \`\`\`
+
+2. **Team Member Workload**:
+   \`\`\`
+   User: "누가 제일 바빠?"
+   LLM:
+     1. Call brxce_workspace_statistics
+     2. Sort memberStats by totalAssigned
+     3. Present: "김개발님이 현재 12개 작업 진행 중 (가장 많음)"
+   \`\`\`
+
+3. **Priority Analysis**:
+   \`\`\`
+   User: "긴급한 작업 얼마나 남았어?"
+   LLM:
+     1. Call brxce_workspace_statistics
+     2. Check byPriority.critical and byPriority.urgent
+     3. Present: "긴급 작업 5개, 시급 작업 3개 남아있습니다"
+   \`\`\`
+
+4. **Deadline Tracking**:
+   \`\`\`
+   User: "이번 주 마감 작업 있어?"
+   LLM:
+     1. Call brxce_workspace_statistics
+     2. Check dueDates
+     3. Present: "오늘 마감 2개, 이번 주 마감 5개 있습니다"
+   \`\`\`
+
+⏰ **TIMEZONE HANDLING:**
+All date calculations are performed in UTC on the backend.
+When presenting results to the user, dates are already processed relative to the server's timezone.
+
+**Example Output:**
+\`\`\`json
+{
+  "workspaceId": 138,
+  "workspaceName": "BRXCE Development",
+  "period": "this-week",
+  "overview": {
+    "totalNodes": 45,
+    "activeNodes": 23,
+    "completedNodes": 18,
+    "completionRate": 40
+  },
+  "byStatus": {
+    "backlog": 5,
+    "not_started": 8,
+    "in_progress": 10,
+    "in_review": 4,
+    "completed": 18,
+    "cancelled": 0
+  },
+  "memberStats": [
+    {
+      "userId": "user-123",
+      "name": "김개발",
+      "email": "dev@example.com",
+      "totalAssigned": 12,
+      "inProgress": 5,
+      "completed": 7,
+      "completionRate": 58
+    }
+  ],
+  "dueDates": {
+    "overdue": 2,
+    "dueToday": 3,
+    "dueThisWeek": 5,
+    "dueThisMonth": 8
+  }
+}
+\`\`\``,
+        inputSchema: {
+            workspaceId: z
+                .string()
+                .uuid()
+                .describe('Workspace ID (get from user://me resource)'),
+            period: z
+                .enum(['today', 'this-week', 'this-month', 'all'])
+                .optional()
+                .describe('Time period for statistics (default: all)'),
+        },
+    }, async (args) => {
+        const { workspaceId, period = 'all' } = args;
+        // Validate workspaceId
+        if (!workspaceId || typeof workspaceId !== 'string') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Invalid workspace ID',
+                            message: 'workspaceId is required and must be a UUID string',
+                            hint: 'Use user://me resource to get valid workspace IDs',
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const queryParams = new URLSearchParams();
+            if (period) {
+                queryParams.append('period', period);
+            }
+            const url = `/mcp/workspaces/${workspaceId}/statistics?${queryParams.toString()}`;
+            const response = await apiClient.get(url);
+            if (!response.success || !response.data) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'Failed to fetch workspace statistics',
+                                message: response.message || 'API returned unsuccessful response',
+                                workspaceId,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const stats = response.data;
+            // Return structured JSON for LLM to format
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            workspaceId: stats.workspaceId,
+                            workspaceName: stats.workspaceName,
+                            period: stats.period,
+                            overview: stats.overview,
+                            byStatus: stats.byStatus,
+                            byPriority: stats.byPriority,
+                            byNodeType: stats.byNodeType,
+                            memberStats: stats.memberStats,
+                            dueDates: stats.dueDates,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            // Handle 404 - workspace not found or no access
+            if (error.response?.status === 404) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'Workspace not found',
+                                message: `Workspace with ID ${workspaceId} does not exist or you don't have access to it`,
+                                workspaceId,
+                                hint: 'Use user://me resource to get valid workspace IDs',
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Handle 403 - access denied
+            if (error.response?.status === 403) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'Access denied',
+                                message: `You don't have permission to view statistics for workspace ${workspaceId}`,
+                                workspaceId,
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // General error
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: 'Failed to fetch workspace statistics',
+                            message: error.message,
+                            workspaceId,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=workspace-statistics-tool.js.map

package/dist/tools/workspace-statistics-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-statistics-tool.js","sourceRoot":"","sources":["../../src/tools/workspace-statistics-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyDxB;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAAiB,EAAE,SAAoB;IACrF,MAAM,CAAC,YAAY,CACjB,4BAA4B,EAC5B;QACE,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyKZ;QACD,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,IAAI,EAAE;iBACN,QAAQ,CAAC,4CAA4C,CAAC;YACzD,MAAM,EAAE,CAAC;iBACN,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;iBACjD,QAAQ,EAAE;iBACV,QAAQ,CAAC,2CAA2C,CAAC;SACzD;KACF,EACD,KAAK,EAAE,IAAyB,EAAE,EAAE;QAClC,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,IAGvC,CAAC;QAEF,uBAAuB;QACvB,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,sBAAsB;4BAC7B,OAAO,EAAE,mDAAmD;4BAC5D,IAAI,EAAE,mDAAmD;yBAC1D,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;YAC1C,IAAI,MAAM,EAAE,CAAC;gBACX,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YAED,MAAM,GAAG,GAAG,mBAAmB,WAAW,eAAe,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC;YAClF,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,CAAqB,GAAG,CAAC,CAAC;YAE9D,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,sCAAsC;gCAC7C,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,oCAAoC;gCACjE,WAAW;6BACZ,CAAC;yBACH;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC;YAE5B,2CAA2C;YAC3C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;4BACE,WAAW,EAAE,KAAK,CAAC,WAAW;4BAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;4BAClC,MAAM,EAAE,KAAK,CAAC,MAAM;4BACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;4BACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;4BACxB,UAAU,EAAE,KAAK,CAAC,UAAU;4BAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;4BAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;4BAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ;yBACzB,EACD,IAAI,EACJ,CAAC,CACF;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,gDAAgD;YAChD,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,qBAAqB;gCAC5B,OAAO,EAAE,qBAAqB,WAAW,gDAAgD;gCACzF,WAAW;gCACX,IAAI,EAAE,mDAAmD;6BAC1D,CAAC;yBACH;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,6BAA6B;YAC7B,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;gBACnC,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,eAAe;gCACtB,OAAO,EAAE,8DAA8D,WAAW,EAAE;gCACpF,WAAW;6BACZ,CAAC;yBACH;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,gBAAgB;YAChB,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,sCAAsC;4BAC7C,OAAO,EAAE,KAAK,CAAC,OAAO;4BACtB,WAAW;yBACZ,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/workspace-tree-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-tree-tool.d.ts","sourceRoot":"","sources":["../../src/tools/workspace-tree-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAiCtD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,QAwbhF"}
+{"version":3,"file":"workspace-tree-tool.d.ts","sourceRoot":"","sources":["../../src/tools/workspace-tree-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAgCtD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,QAmbhF"}