@structured-world/gitlab-mcp 6.1.0 → 6.2.0

package/README.md

@@ -464,6 +464,7 @@ When OAuth is enabled, the following endpoints are available:
 - `USE_MRS`: When set to 'true', enables the merge request-related tools (browse_merge_requests, browse_mr_discussions, manage_merge_request, manage_mr_discussion, manage_draft_notes). These 5 CQRS tools consolidate all MR operations. By default, merge request features are enabled.
 - `USE_FILES`: When set to 'true', enables the file-related tools (browse_files, manage_files). These 2 CQRS tools consolidate all file operations. By default, file operation features are enabled.
 - `USE_VARIABLES`: When set to 'true', enables the CI/CD variables-related tools (list_variables, get_variable, create_variable, update_variable, delete_variable). Supports both project-level and group-level variables. By default, variables features are enabled.
+- `USE_WORKITEMS`: When set to 'true', enables the work items-related tools (browse_work_items, manage_work_item). These 2 CQRS tools consolidate all work item operations using GitLab GraphQL API. By default, work items features are enabled.
 - `GITLAB_AUTH_COOKIE_PATH`: Path to an authentication cookie file for GitLab instances that require cookie-based authentication. When provided, the cookie will be included in all GitLab API requests.
 - `SKIP_TLS_VERIFY`: When set to 'true', skips TLS certificate verification for all GitLab API requests (both REST and GraphQL). **WARNING**: This bypasses SSL certificate validation and should only be used for testing with self-signed certificates or trusted internal GitLab instances. Never use this in production environments.
 - `SSL_CERT_PATH`: Path to PEM certificate file for direct HTTPS/TLS termination. Requires `SSL_KEY_PATH` to also be set.
@@ -502,7 +503,7 @@ export GITLAB_TOOL_GET_FILE_CONTENTS="Read source code files from the repository
 # Multiple customizations
 export GITLAB_TOOL_LIST_PROJECTS="List user projects"
 export GITLAB_TOOL_GET_PROJECT="Get project details including settings"
-export GITLAB_TOOL_CREATE_WORK_ITEM="Create tickets for our sprint planning"
+export GITLAB_TOOL_MANAGE_WORK_ITEM="Create and manage tickets for our sprint planning"
 ```
 
 #### Usage in Configuration Files
@@ -532,11 +533,11 @@ export GITLAB_TOOL_CREATE_WORK_ITEM="Create tickets for our sprint planning"
 - **Case Sensitivity**: Tool names in environment variables must be UPPERCASE (e.g., `LIST_PROJECTS` not `list_projects`)
 - **Invalid Names**: Invalid tool names in environment variables are ignored with a warning in debug logs
 - **Content Guidelines**: Descriptions can be any valid string but should be kept concise for better UX
-- **Scope**: Works with all 61 available tools across all entities (Core, Work Items, Merge Requests, Files, etc.)
+- **Scope**: Works with all 58 available tools across all entities (Core, Work Items, Merge Requests, Files, etc.)
 
 ## Tools 🛠️
 
-**61 Tools Available** - Organized by entity and functionality below.
+**58 Tools Available** - Organized by entity and functionality below.
 
 ### Key Features:
 - **CQRS Pattern** - Consolidated action-based tools: `browse_*` for reads, `manage_*` for writes
@@ -617,14 +618,14 @@ Requires USE_VARIABLES=true environment variable (enabled by default). Supports
 - ✏️ **`update_variable`**: Update an existing CI/CD variable's value, security settings, or configuration in a project or group
 - ✏️ **`delete_variable`**: Remove a CI/CD variable from a project or group
 
-### Work Items (5 tools)
-Modern GraphQL API for issues, epics, tasks, and more. Requires USE_WORKITEMS=true (enabled by default).
+### Work Items (2 CQRS tools)
+Modern GraphQL API for issues, epics, tasks, and more. Requires USE_WORKITEMS=true (enabled by default). Uses CQRS pattern with action-based tools.
 
-- ✏️ **`create_work_item`**: Create a new work item (epic, issue, task, etc.) in a GitLab group
-- ✏️ **`update_work_item`**: Update an existing work item
-- ✏️ **`delete_work_item`**: Delete a work item
-- 📖 **`get_work_item`**: Get details of a specific work item by ID
-- 📖 **`list_work_items`**: List work items from a GitLab group with optional filtering by type
+#### Work Item Browsing (Query)
+- 📖 **`browse_work_items`**: BROWSE work items. Actions: "list" shows work items with filtering (groups return epics, projects return issues/tasks), "get" retrieves single work item by ID with full widget details.
+
+#### Work Item Management (Command)
+- ✏️ **`manage_work_item`**: MANAGE work items. Actions: "create" creates new work item (Epics need GROUP namespace, Issues/Tasks need PROJECT), "update" modifies properties/widgets, "delete" permanently removes.
 
 ### Wiki Management (5 tools)
 Requires USE_GITLAB_WIKI=true environment variable. Supports both project-level and group-level wikis.
@@ -775,9 +776,9 @@ For rapid testing of individual MCP tools:
 
 ```bash
 # Test specific tools directly
-./scripts/test_mcp.sh '{"name": "list_work_items", "arguments": {"namespacePath": "test"}}'
-./scripts/test_mcp.sh '{"name": "get_work_item_types", "arguments": {"namespacePath": "test"}}'
-./scripts/test_mcp.sh '{"name": "create_work_item", "arguments": {"namespacePath": "test", "workItemType": "EPIC", "title": "Test Epic"}}'
+./scripts/test_mcp.sh '{"name": "browse_work_items", "arguments": {"action": "list", "namespace": "test"}}'
+./scripts/test_mcp.sh '{"name": "browse_work_items", "arguments": {"action": "get", "id": "gid://gitlab/WorkItem/123"}}'
+./scripts/test_mcp.sh '{"name": "manage_work_item", "arguments": {"action": "create", "namespace": "test", "workItemType": "EPIC", "title": "Test Epic"}}'
 ```
 
 The `test_mcp.sh` script automatically:

package/dist/src/entities/workitems/registry.js

@@ -44,278 +44,266 @@ const ConnectionManager_1 = require("../../services/ConnectionManager");
 const workItemTypes_1 = require("../../utils/workItemTypes");
 const idConversion_1 = require("../../utils/idConversion");
 const workItems_1 = require("../../graphql/workItems");
+const simplifyWorkItem = (workItem, simple) => {
+    if (!simple)
+        return workItem;
+    const simplified = {
+        id: workItem.id,
+        iid: workItem.iid,
+        title: workItem.title,
+        state: workItem.state,
+        workItemType: typeof workItem.workItemType === "string"
+            ? workItem.workItemType
+            : workItem.workItemType?.name || "Unknown",
+        webUrl: workItem.webUrl,
+        createdAt: workItem.createdAt,
+        updatedAt: workItem.updatedAt,
+    };
+    if (workItem.description && typeof workItem.description === "string") {
+        simplified.description =
+            workItem.description.length > 200
+                ? workItem.description.substring(0, 200) + "..."
+                : workItem.description;
+    }
+    if (workItem.widgets && Array.isArray(workItem.widgets)) {
+        const essentialWidgets = [];
+        for (const widget of workItem.widgets) {
+            const flexWidget = widget;
+            switch (flexWidget.type) {
+                case "ASSIGNEES":
+                    if (flexWidget.assignees?.nodes && flexWidget.assignees.nodes.length > 0) {
+                        essentialWidgets.push({
+                            type: "ASSIGNEES",
+                            assignees: flexWidget.assignees.nodes.map(assignee => ({
+                                id: assignee.id,
+                                username: assignee.username,
+                                name: assignee.name,
+                            })),
+                        });
+                    }
+                    break;
+                case "LABELS":
+                    if (flexWidget.labels?.nodes && flexWidget.labels.nodes.length > 0) {
+                        essentialWidgets.push({
+                            type: "LABELS",
+                            labels: flexWidget.labels.nodes.map(label => ({
+                                id: label.id,
+                                title: label.title,
+                                color: label.color,
+                            })),
+                        });
+                    }
+                    break;
+                case "MILESTONE":
+                    if (flexWidget.milestone) {
+                        essentialWidgets.push({
+                            type: "MILESTONE",
+                            milestone: {
+                                id: flexWidget.milestone.id,
+                                title: flexWidget.milestone.title,
+                                state: flexWidget.milestone.state,
+                            },
+                        });
+                    }
+                    break;
+                case "HIERARCHY":
+                    if (flexWidget.parent || flexWidget.hasChildren) {
+                        essentialWidgets.push({
+                            type: "HIERARCHY",
+                            parent: flexWidget.parent
+                                ? {
+                                    id: flexWidget.parent.id,
+                                    iid: flexWidget.parent.iid,
+                                    title: flexWidget.parent.title,
+                                    workItemType: flexWidget.parent.workItemType,
+                                }
+                                : null,
+                            hasChildren: flexWidget.hasChildren,
+                        });
+                    }
+                    break;
+            }
+        }
+        if (essentialWidgets && essentialWidgets.length > 0) {
+            simplified.widgets = essentialWidgets;
+        }
+    }
+    return simplified;
+};
 exports.workitemsToolRegistry = new Map([
     [
-        "list_work_items",
+        "browse_work_items",
         {
-            name: "list_work_items",
-            description: "List work items from a namespace (groups or projects). Core tool for tracking issues, epics, tasks, and incidents. Returns open items by default. Filter by type, state, with pagination support.",
-            inputSchema: z.toJSONSchema(schema_readonly_1.ListWorkItemsSchema),
+            name: "browse_work_items",
+            description: 'BROWSE work items. Actions: "list" shows work items with filtering (groups return epics, projects return issues/tasks), "get" retrieves single work item by ID with full widget details.',
+            inputSchema: z.toJSONSchema(schema_readonly_1.BrowseWorkItemsSchema),
             handler: async (args) => {
-                console.log("list_work_items called with args:", JSON.stringify(args, null, 2));
-                const options = schema_readonly_1.ListWorkItemsSchema.parse(args);
-                const { namespace, types, state, first, after, simple, active } = options;
-                console.log("Parsed options:", {
-                    namespace,
-                    types,
-                    state,
-                    first,
-                    after,
-                    simple,
-                    active,
-                });
-                const simplifyWorkItem = (workItem) => {
-                    if (!simple)
-                        return workItem;
-                    const simplified = {
-                        id: workItem.id,
-                        iid: workItem.iid,
-                        title: workItem.title,
-                        state: workItem.state,
-                        workItemType: typeof workItem.workItemType === "string"
-                            ? workItem.workItemType
-                            : workItem.workItemType?.name || "Unknown",
-                        webUrl: workItem.webUrl,
-                        createdAt: workItem.createdAt,
-                        updatedAt: workItem.updatedAt,
-                    };
-                    if (workItem.description && typeof workItem.description === "string") {
-                        simplified.description =
-                            workItem.description.length > 200
-                                ? workItem.description.substring(0, 200) + "..."
-                                : workItem.description;
+                const input = schema_readonly_1.BrowseWorkItemsSchema.parse(args);
+                switch (input.action) {
+                    case "list": {
+                        const { namespace, types, state, first, after, simple } = input;
+                        console.log("browse_work_items list called with:", {
+                            namespace,
+                            types,
+                            state,
+                            first,
+                            after,
+                            simple,
+                        });
+                        const connectionManager = ConnectionManager_1.ConnectionManager.getInstance();
+                        const client = connectionManager.getClient();
+                        const resolvedTypes = types;
+                        const workItemsResponse = await client.request(workItems_1.GET_NAMESPACE_WORK_ITEMS, {
+                            namespacePath: namespace,
+                            types: resolvedTypes,
+                            first: first || 20,
+                            after: after,
+                        });
+                        const workItemsData = workItemsResponse.namespace?.workItems;
+                        const allItems = workItemsData?.nodes ?? [];
+                        const pageInfo = {
+                            hasNextPage: workItemsData?.pageInfo?.hasNextPage ?? false,
+                            endCursor: workItemsData?.pageInfo?.endCursor ?? null,
+                        };
+                        const namespaceType = workItemsResponse.namespace?.__typename ?? "Unknown";
+                        console.log(`Found ${allItems.length} work items from ${namespaceType} query`);
+                        const filteredItems = allItems.filter((item) => {
+                            return state.includes(item.state);
+                        });
+                        console.log(`State filtering: ${allItems.length} -> ${filteredItems.length} items (keeping: ${state.join(", ")})`);
+                        const finalResults = filteredItems.map((item) => {
+                            const cleanedItem = (0, idConversion_1.cleanWorkItemResponse)(item);
+                            return simplifyWorkItem(cleanedItem, simple);
+                        });
+                        console.log("Final result - total work items found:", finalResults.length);
+                        return {
+                            items: finalResults,
+                            hasMore: pageInfo.hasNextPage ?? false,
+                            endCursor: pageInfo.endCursor ?? null,
+                        };
                     }
-                    if (workItem.widgets && Array.isArray(workItem.widgets)) {
-                        const essentialWidgets = [];
-                        for (const widget of workItem.widgets) {
-                            const flexWidget = widget;
-                            switch (flexWidget.type) {
-                                case "ASSIGNEES":
-                                    if (flexWidget.assignees?.nodes && flexWidget.assignees.nodes.length > 0) {
-                                        essentialWidgets.push({
-                                            type: "ASSIGNEES",
-                                            assignees: flexWidget.assignees.nodes.map(assignee => ({
-                                                id: assignee.id,
-                                                username: assignee.username,
-                                                name: assignee.name,
-                                            })),
-                                        });
-                                    }
-                                    break;
-                                case "LABELS":
-                                    if (flexWidget.labels?.nodes && flexWidget.labels.nodes.length > 0) {
-                                        essentialWidgets.push({
-                                            type: "LABELS",
-                                            labels: flexWidget.labels.nodes.map(label => ({
-                                                id: label.id,
-                                                title: label.title,
-                                                color: label.color,
-                                            })),
-                                        });
-                                    }
-                                    break;
-                                case "MILESTONE":
-                                    if (flexWidget.milestone) {
-                                        essentialWidgets.push({
-                                            type: "MILESTONE",
-                                            milestone: {
-                                                id: flexWidget.milestone.id,
-                                                title: flexWidget.milestone.title,
-                                                state: flexWidget.milestone.state,
-                                            },
-                                        });
-                                    }
-                                    break;
-                                case "HIERARCHY":
-                                    if (flexWidget.parent || flexWidget.hasChildren) {
-                                        essentialWidgets.push({
-                                            type: "HIERARCHY",
-                                            parent: flexWidget.parent
-                                                ? {
-                                                    id: flexWidget.parent.id,
-                                                    iid: flexWidget.parent.iid,
-                                                    title: flexWidget.parent.title,
-                                                    workItemType: flexWidget.parent.workItemType,
-                                                }
-                                                : null,
-                                            hasChildren: flexWidget.hasChildren,
-                                        });
-                                    }
-                                    break;
-                            }
-                        }
-                        if (essentialWidgets && essentialWidgets.length > 0) {
-                            simplified.widgets = essentialWidgets;
+                    case "get": {
+                        const { id } = input;
+                        const connectionManager = ConnectionManager_1.ConnectionManager.getInstance();
+                        const client = connectionManager.getClient();
+                        const workItemGid = (0, idConversion_1.toGid)(id, "WorkItem");
+                        const response = await client.request(workItems_1.GET_WORK_ITEM, { id: workItemGid });
+                        if (!response.workItem) {
+                            throw new Error(`Work item with ID "${id}" not found`);
                         }
+                        return (0, idConversion_1.cleanWorkItemResponse)(response.workItem);
+                    }
+                    default: {
+                        const _exhaustive = input;
+                        throw new Error(`Unknown action: ${_exhaustive.action}`);
                     }
-                    return simplified;
-                };
-                const connectionManager = ConnectionManager_1.ConnectionManager.getInstance();
-                const client = connectionManager.getClient();
-                console.log("Querying namespace:", namespace);
-                let resolvedTypes = types;
-                const workItemsResponse = await client.request(workItems_1.GET_NAMESPACE_WORK_ITEMS, {
-                    namespacePath: namespace,
-                    types: resolvedTypes,
-                    first: first || 20,
-                    after: after,
-                });
-                const workItemsData = workItemsResponse.namespace?.workItems;
-                const allItems = workItemsData?.nodes ?? [];
-                const pageInfo = {
-                    hasNextPage: workItemsData?.pageInfo?.hasNextPage ?? false,
-                    endCursor: workItemsData?.pageInfo?.endCursor ?? null,
-                };
-                const namespaceType = workItemsResponse.namespace?.__typename ?? "Unknown";
-                console.log(`Found ${allItems.length} work items from ${namespaceType} query`);
-                const filteredItems = allItems.filter((item) => {
-                    return state.includes(item.state);
-                });
-                console.log(`State filtering: ${allItems.length} → ${filteredItems.length} items (keeping: ${state.join(", ")})`);
-                const finalResults = filteredItems.map((item) => {
-                    const cleanedItem = (0, idConversion_1.cleanWorkItemResponse)(item);
-                    return simplifyWorkItem(cleanedItem);
-                });
-                console.log("Final result - total work items found:", finalResults.length);
-                if (simple) {
-                    console.log("Using simplified structure for agent consumption");
-                }
-                return {
-                    items: finalResults,
-                    hasMore: pageInfo.hasNextPage ?? false,
-                    endCursor: pageInfo.endCursor ?? null,
-                };
-            },
-        },
-    ],
-    [
-        "get_work_item",
-        {
-            name: "get_work_item",
-            description: "Get complete work item details by ID. Returns full data including widgets (assignees, labels, milestones, hierarchy, time tracking, custom fields). Essential for issue/epic management and tracking project progress. Each work item type has different widget capabilities.",
-            inputSchema: z.toJSONSchema(schema_readonly_1.GetWorkItemSchema),
-            handler: async (args) => {
-                const options = schema_readonly_1.GetWorkItemSchema.parse(args);
-                const { id } = options;
-                const connectionManager = ConnectionManager_1.ConnectionManager.getInstance();
-                const client = connectionManager.getClient();
-                const workItemGid = (0, idConversion_1.toGid)(id, "WorkItem");
-                const response = await client.request(workItems_1.GET_WORK_ITEM, { id: workItemGid });
-                if (!response.workItem) {
-                    throw new Error(`Work item with ID "${id}" not found`);
-                }
-                return (0, idConversion_1.cleanWorkItemResponse)(response.workItem);
-            },
-        },
-    ],
-    [
-        "create_work_item",
-        {
-            name: "create_work_item",
-            description: "Create work items for issue tracking and project management. LABEL WORKFLOW: Run list_labels first to discover existing labels, then use label IDs from response. CRITICAL: Epics require GROUP namespace, Issues/Tasks/Incidents require PROJECT namespace. Supports 9 types: Epic, Issue, Task, Incident, Test Case, Requirement, Objective, Key Result, Ticket. NOTE: Test Cases and Requirements do not support labels widget. Automatically assigns widgets (assignees, labels, milestones) based on type capabilities.",
-            inputSchema: z.toJSONSchema(schema_1.CreateWorkItemSchema),
-            handler: async (args) => {
-                const options = schema_1.CreateWorkItemSchema.parse(args);
-                const { namespace, title, workItemType, description, assigneeIds, labelIds, milestoneId } = options;
-                const connectionManager = ConnectionManager_1.ConnectionManager.getInstance();
-                const client = connectionManager.getClient();
-                const workItemTypes = await (0, workItemTypes_1.getWorkItemTypes)(namespace);
-                const workItemTypeObj = workItemTypes.find((t) => t.name.toUpperCase().replace(/\s+/g, "_") ===
-                    workItemType.toUpperCase().replace(/\s+/g, "_"));
-                if (!workItemTypeObj) {
-                    throw new Error(`Work item type "${workItemType}" not found in namespace "${namespace}". Available types: ${workItemTypes.map(t => t.name).join(", ")}`);
-                }
-                const input = {
-                    namespacePath: namespace,
-                    title,
-                    workItemTypeId: workItemTypeObj.id,
-                };
-                if (description !== undefined) {
-                    input.description = description;
-                }
-                if (assigneeIds !== undefined && assigneeIds.length > 0) {
-                    input.assigneesWidget = { assigneeIds: (0, idConversion_1.toGids)(assigneeIds, "User") };
-                }
-                if (labelIds !== undefined && labelIds.length > 0) {
-                    input.labelsWidget = { labelIds: (0, idConversion_1.toGids)(labelIds, "Label") };
-                }
-                if (milestoneId !== undefined) {
-                    input.milestoneWidget = { milestoneId: (0, idConversion_1.toGid)(milestoneId, "Milestone") };
-                }
-                const response = await client.request(workItems_1.CREATE_WORK_ITEM_WITH_WIDGETS, { input });
-                if (response.workItemCreate?.errors?.length && response.workItemCreate.errors.length > 0) {
-                    throw new Error(`GitLab GraphQL errors: ${response.workItemCreate.errors.join(", ")}`);
-                }
-                if (!response.workItemCreate?.workItem) {
-                    throw new Error("Work item creation failed - no work item returned");
-                }
-                return (0, idConversion_1.cleanWorkItemResponse)(response.workItemCreate.workItem);
-            },
-        },
-    ],
-    [
-        "update_work_item",
-        {
-            name: "update_work_item",
-            description: "Update work item properties for issue/epic management. LABEL WORKFLOW: Run list_labels first to discover existing labels, then use label IDs from response. Modify title, description, assignees, labels, milestones, and state (open/close). Supports widget updates including clearing assignees with empty arrays. NOTE: Test Cases and Requirements do not support labels widget. Essential for project workflow and status tracking.",
-            inputSchema: z.toJSONSchema(schema_1.UpdateWorkItemSchema),
-            handler: async (args) => {
-                const options = schema_1.UpdateWorkItemSchema.parse(args);
-                const { id, title, description, state, assigneeIds, labelIds, milestoneId } = options;
-                const connectionManager = ConnectionManager_1.ConnectionManager.getInstance();
-                const client = connectionManager.getClient();
-                const workItemGid = (0, idConversion_1.toGid)(id, "WorkItem");
-                const input = { id: workItemGid };
-                if (title !== undefined)
-                    input.title = title;
-                if (state !== undefined)
-                    input.stateEvent = state;
-                if (description !== undefined) {
-                    input.descriptionWidget = { description };
-                }
-                if (assigneeIds !== undefined) {
-                    input.assigneesWidget = { assigneeIds: (0, idConversion_1.toGids)(assigneeIds, "User") };
-                }
-                if (labelIds !== undefined) {
-                    input.labelsWidget = { addLabelIds: (0, idConversion_1.toGids)(labelIds, "Label") };
-                }
-                if (milestoneId !== undefined) {
-                    input.milestoneWidget = { milestoneId: (0, idConversion_1.toGid)(milestoneId, "Milestone") };
-                }
-                const response = await client.request(workItems_1.UPDATE_WORK_ITEM, { input });
-                if (response.workItemUpdate?.errors?.length && response.workItemUpdate.errors.length > 0) {
-                    throw new Error(`GitLab GraphQL errors: ${response.workItemUpdate.errors.join(", ")}`);
-                }
-                if (!response.workItemUpdate?.workItem) {
-                    throw new Error("Work item update failed - no work item returned");
                 }
-                return (0, idConversion_1.cleanWorkItemResponse)(response.workItemUpdate.workItem);
             },
         },
     ],
     [
-        "delete_work_item",
+        "manage_work_item",
         {
-            name: "delete_work_item",
-            description: "Permanently delete work items. WARNING: Cannot be undone. Removes all data, comments, time tracking, and references. Use for cleanup or removing invalid issues/epics. Consider closing instead of deleting for audit trails.",
-            inputSchema: z.toJSONSchema(schema_1.DeleteWorkItemSchema),
+            name: "manage_work_item",
+            description: 'MANAGE work items. Actions: "create" creates new work item (Epics need GROUP namespace, Issues/Tasks need PROJECT), "update" modifies properties/widgets, "delete" permanently removes.',
+            inputSchema: z.toJSONSchema(schema_1.ManageWorkItemSchema),
             handler: async (args) => {
-                const options = schema_1.DeleteWorkItemSchema.parse(args);
-                const { id } = options;
-                const connectionManager = ConnectionManager_1.ConnectionManager.getInstance();
-                const client = connectionManager.getClient();
-                const workItemGid = (0, idConversion_1.toGid)(id, "WorkItem");
-                const response = await client.request(workItems_1.DELETE_WORK_ITEM, { id: workItemGid });
-                if (response.workItemDelete?.errors?.length && response.workItemDelete.errors.length > 0) {
-                    throw new Error(`GitLab GraphQL errors: ${response.workItemDelete.errors.join(", ")}`);
+                const input = schema_1.ManageWorkItemSchema.parse(args);
+                switch (input.action) {
+                    case "create": {
+                        const { namespace, title, workItemType, description, assigneeIds, labelIds, milestoneId, } = input;
+                        const connectionManager = ConnectionManager_1.ConnectionManager.getInstance();
+                        const client = connectionManager.getClient();
+                        const workItemTypes = await (0, workItemTypes_1.getWorkItemTypes)(namespace);
+                        const workItemTypeObj = workItemTypes.find((t) => t.name.toUpperCase().replace(/\s+/g, "_") ===
+                            workItemType.toUpperCase().replace(/\s+/g, "_"));
+                        if (!workItemTypeObj) {
+                            throw new Error(`Work item type "${workItemType}" not found in namespace "${namespace}". Available types: ${workItemTypes.map(t => t.name).join(", ")}`);
+                        }
+                        const createInput = {
+                            namespacePath: namespace,
+                            title,
+                            workItemTypeId: workItemTypeObj.id,
+                        };
+                        if (description !== undefined) {
+                            createInput.description = description;
+                        }
+                        if (assigneeIds !== undefined && assigneeIds.length > 0) {
+                            createInput.assigneesWidget = { assigneeIds: (0, idConversion_1.toGids)(assigneeIds, "User") };
+                        }
+                        if (labelIds !== undefined && labelIds.length > 0) {
+                            createInput.labelsWidget = { labelIds: (0, idConversion_1.toGids)(labelIds, "Label") };
+                        }
+                        if (milestoneId !== undefined) {
+                            createInput.milestoneWidget = { milestoneId: (0, idConversion_1.toGid)(milestoneId, "Milestone") };
+                        }
+                        const response = await client.request(workItems_1.CREATE_WORK_ITEM_WITH_WIDGETS, {
+                            input: createInput,
+                        });
+                        if (response.workItemCreate?.errors?.length &&
+                            response.workItemCreate.errors.length > 0) {
+                            throw new Error(`GitLab GraphQL errors: ${response.workItemCreate.errors.join(", ")}`);
+                        }
+                        if (!response.workItemCreate?.workItem) {
+                            throw new Error("Work item creation failed - no work item returned");
+                        }
+                        return (0, idConversion_1.cleanWorkItemResponse)(response.workItemCreate.workItem);
+                    }
+                    case "update": {
+                        const { id, title, description, state, assigneeIds, labelIds, milestoneId } = input;
+                        const connectionManager = ConnectionManager_1.ConnectionManager.getInstance();
+                        const client = connectionManager.getClient();
+                        const workItemGid = (0, idConversion_1.toGid)(id, "WorkItem");
+                        const updateInput = { id: workItemGid };
+                        if (title !== undefined)
+                            updateInput.title = title;
+                        if (state !== undefined)
+                            updateInput.stateEvent = state;
+                        if (description !== undefined) {
+                            updateInput.descriptionWidget = { description };
+                        }
+                        if (assigneeIds !== undefined) {
+                            updateInput.assigneesWidget = { assigneeIds: (0, idConversion_1.toGids)(assigneeIds, "User") };
+                        }
+                        if (labelIds !== undefined) {
+                            updateInput.labelsWidget = { addLabelIds: (0, idConversion_1.toGids)(labelIds, "Label") };
+                        }
+                        if (milestoneId !== undefined) {
+                            updateInput.milestoneWidget = { milestoneId: (0, idConversion_1.toGid)(milestoneId, "Milestone") };
+                        }
+                        const response = await client.request(workItems_1.UPDATE_WORK_ITEM, { input: updateInput });
+                        if (response.workItemUpdate?.errors?.length &&
+                            response.workItemUpdate.errors.length > 0) {
+                            throw new Error(`GitLab GraphQL errors: ${response.workItemUpdate.errors.join(", ")}`);
+                        }
+                        if (!response.workItemUpdate?.workItem) {
+                            throw new Error("Work item update failed - no work item returned");
+                        }
+                        return (0, idConversion_1.cleanWorkItemResponse)(response.workItemUpdate.workItem);
+                    }
+                    case "delete": {
+                        const { id } = input;
+                        const connectionManager = ConnectionManager_1.ConnectionManager.getInstance();
+                        const client = connectionManager.getClient();
+                        const workItemGid = (0, idConversion_1.toGid)(id, "WorkItem");
+                        const response = await client.request(workItems_1.DELETE_WORK_ITEM, { id: workItemGid });
+                        if (response.workItemDelete?.errors?.length &&
+                            response.workItemDelete.errors.length > 0) {
+                            throw new Error(`GitLab GraphQL errors: ${response.workItemDelete.errors.join(", ")}`);
+                        }
+                        return { deleted: true };
+                    }
+                    default: {
+                        const _exhaustive = input;
+                        throw new Error(`Unknown action: ${_exhaustive.action}`);
+                    }
                 }
-                return { deleted: true };
             },
         },
     ],
 ]);
 function getWorkitemsReadOnlyToolNames() {
-    return ["list_work_items", "get_work_item"];
+    return ["browse_work_items"];
 }
 function getWorkitemsToolDefinitions() {
     return Array.from(exports.workitemsToolRegistry.values());