@gitlab/opencode-gitlab-plugin 1.5.6 → 1.5.7

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.5.7](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/compare/v1.5.6...v1.5.7) (2026-02-03)
+
+
+### ♻️ Code Refactoring
+
+* consolidate epic issue management tools into unified interface ([b8708d7](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/commit/b8708d7fa65e4fcc5fda0e46daaf2391d8bbc094))
+
 ## [1.5.6](https://gitlab.com/gitlab-org/editor-extensions/opencode-gitlab-plugin/compare/v1.5.5...v1.5.6) (2026-02-03)
 
 

package/README.md

@@ -287,7 +287,7 @@ Or for API tokens:
 
 ## 🛠️ Available Tools
 
-The plugin provides **69 tools** organized into the following categories:
+The plugin provides **67 tools** organized into the following categories:
 
 ### Merge Request Tools (9 tools)
 
@@ -311,17 +311,15 @@ The plugin provides **69 tools** organized into the following categories:
 | `gitlab_get_issue`    | Get issue details including state, author, assignees, labels, and comments   |
 | `gitlab_list_issues`  | List issues with filtering by state, labels, assignee, and milestone         |
 
-### Epic Tools (7 tools)
-
-| Tool                            | Description                                                                   |
-| ------------------------------- | ----------------------------------------------------------------------------- |
-| `gitlab_get_epic`               | Get epic details with title, description, state, dates, and associated issues |
-| `gitlab_list_epics`             | List epics with filtering by state, author, and labels                        |
-| `gitlab_create_epic`            | Create a new epic in a group                                                  |
-| `gitlab_update_epic`            | Update epic title, description, labels, dates, and state                      |
-| `gitlab_list_epic_issues`       | Get all issues linked to an epic                                              |
-| `gitlab_add_issue_to_epic`      | Link an issue to an epic                                                      |
-| `gitlab_remove_issue_from_epic` | Unlink an issue from an epic                                                  |
+### Epic Tools (5 tools)
+
+| Tool                        | Description                                                                   |
+| --------------------------- | ----------------------------------------------------------------------------- |
+| `gitlab_get_epic`           | Get epic details with title, description, state, dates, and associated issues |
+| `gitlab_list_epics`         | List epics with filtering by state, author, and labels                        |
+| `gitlab_create_epic`        | Create a new epic in a group                                                  |
+| `gitlab_update_epic`        | Update epic title, description, labels, dates, and state                      |
+| `gitlab_manage_epic_issues` | Manage issues linked to an epic (list, add, remove) with action parameter     |
 
 ### Pipeline Tools (8 tools)
 

package/dist/index.js

@@ -2309,6 +2309,9 @@ Can filter by state, labels, assignee, milestone.`,
 // src/tools/epics.ts
 import { tool as tool3 } from "@opencode-ai/plugin";
 var z3 = tool3.schema;
+function validationError(message) {
+  return JSON.stringify({ error: message }, null, 2);
+}
 var epicTools = {
   gitlab_get_epic: tool3({
     description: `Get details of a specific epic by group and epic IID.
@@ -2402,49 +2405,55 @@ Can update title, description, labels, dates, state, and confidentiality.`,
       return JSON.stringify(epic, null, 2);
     }
   }),
-  gitlab_list_epic_issues: tool3({
-    description: `Get all issues associated with an epic.
-Returns the list of issues that are linked to the epic.`,
-    args: {
-      group_id: z3.string().describe("The group ID or URL-encoded path"),
-      epic_iid: z3.number().describe("The internal ID of the epic")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const issues = await client.listEpicIssues(args.group_id, args.epic_iid);
-      return JSON.stringify(issues, null, 2);
-    }
-  }),
-  gitlab_add_issue_to_epic: tool3({
-    description: `Link an existing issue to an epic.
-The issue can be from any project within the group hierarchy.`,
-    args: {
-      group_id: z3.string().describe("The group ID or URL-encoded path"),
-      epic_iid: z3.number().describe("The internal ID of the epic"),
-      issue_id: z3.number().describe("The global ID of the issue to add")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const result = await client.addIssueToEpic(args.group_id, args.epic_iid, args.issue_id);
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  gitlab_remove_issue_from_epic: tool3({
-    description: `Unlink an issue from an epic.
-Removes the association between the issue and the epic.`,
+  gitlab_manage_epic_issues: tool3({
+    description: `Manage issues linked to a GitLab epic.
+
+Actions:
+- list: Get all issues associated with the epic
+- add: Link an existing issue to the epic (issue can be from any project within the group hierarchy)
+- remove: Unlink an issue from the epic
+
+Examples:
+- List issues: action="list", group_id="gitlab-org", epic_iid=123
+- Add issue: action="add", group_id="gitlab-org", epic_iid=123, issue_id=456
+- Remove issue: action="remove", group_id="gitlab-org", epic_iid=123, epic_issue_id=789
+
+Note: The epic_issue_id (for remove) is the ID of the epic-issue association, which can be obtained from the list action response.`,
     args: {
+      action: z3.enum(["list", "add", "remove"]).describe("The action to perform"),
       group_id: z3.string().describe("The group ID or URL-encoded path"),
-      epic_iid: z3.number().describe("The internal ID of the epic"),
-      epic_issue_id: z3.number().describe("The ID of the epic-issue association (from list_epic_issues)")
+      epic_iid: z3.number().describe("The internal ID of the epic within the group"),
+      issue_id: z3.number().optional().describe('The global ID of the issue to add (required for "add" action)'),
+      epic_issue_id: z3.number().optional().describe(
+        'The ID of the epic-issue association to remove (required for "remove" action, from list response)'
+      )
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
-      const result = await client.removeIssueFromEpic(
-        args.group_id,
-        args.epic_iid,
-        args.epic_issue_id
-      );
-      return JSON.stringify(result, null, 2);
+      switch (args.action) {
+        case "list": {
+          const issues = await client.listEpicIssues(args.group_id, args.epic_iid);
+          return JSON.stringify(issues, null, 2);
+        }
+        case "add": {
+          if (args.issue_id === void 0) {
+            return validationError('issue_id is required for "add" action');
+          }
+          const result = await client.addIssueToEpic(args.group_id, args.epic_iid, args.issue_id);
+          return JSON.stringify(result, null, 2);
+        }
+        case "remove": {
+          if (args.epic_issue_id === void 0) {
+            return validationError('epic_issue_id is required for "remove" action');
+          }
+          const result = await client.removeIssueFromEpic(
+            args.group_id,
+            args.epic_iid,
+            args.epic_issue_id
+          );
+          return JSON.stringify(result, null, 2);
+        }
+      }
     }
   })
 };
@@ -2746,7 +2755,7 @@ var SPECIALIZED_SCOPES = [
 var ALL_SCOPES = [...GENERIC_SEARCH_SCOPES, ...SPECIALIZED_SCOPES];
 var REF_SUPPORTED_SCOPES = ["commits", "wiki_blobs"];
 var STATE_SUPPORTED_SCOPES = ["milestones"];
-function validationError(param, scope) {
+function validationError2(param, scope) {
   return new Error(`Missing required parameter: '${param}' is required for scope '${scope}'`);
 }
 function invalidParamError(param, validScopes) {
@@ -2757,10 +2766,10 @@ function invalidParamError(param, validScopes) {
 function validateSearchParams(scope, args) {
   switch (scope) {
     case "notes":
-      if (!args.project_id) throw validationError("project_id", scope);
+      if (!args.project_id) throw validationError2("project_id", scope);
       break;
     case "group_projects":
-      if (!args.group_id) throw validationError("group_id", scope);
+      if (!args.group_id) throw validationError2("group_id", scope);
       break;
   }
   if (args.ref && !REF_SUPPORTED_SCOPES.includes(scope)) {
@@ -3696,7 +3705,7 @@ import { tool as tool13 } from "@opencode-ai/plugin";
 var z13 = tool13.schema;
 var VALID_LIST_CREATE_TYPES = ["merge_request", "issue", "epic", "snippet"];
 var VALID_GET_NOTE_TYPES = ["issue", "epic"];
-function validationError2(param, resourceType) {
+function validationError3(param, resourceType) {
   return new Error(
     `Missing required parameter: '${param}' is required for resource_type '${resourceType}'`
   );
@@ -3710,16 +3719,16 @@ function validateListCreateParams(resourceType, args) {
   switch (resourceType) {
     case "merge_request":
     case "issue":
-      if (!args.project_id) throw validationError2("project_id", resourceType);
-      if (args.iid == null) throw validationError2("iid", resourceType);
+      if (!args.project_id) throw validationError3("project_id", resourceType);
+      if (args.iid == null) throw validationError3("iid", resourceType);
       break;
     case "epic":
-      if (!args.group_id) throw validationError2("group_id", resourceType);
-      if (args.iid == null) throw validationError2("iid", resourceType);
+      if (!args.group_id) throw validationError3("group_id", resourceType);
+      if (args.iid == null) throw validationError3("iid", resourceType);
       break;
     case "snippet":
-      if (!args.project_id) throw validationError2("project_id", resourceType);
-      if (args.snippet_id == null) throw validationError2("snippet_id", resourceType);
+      if (!args.project_id) throw validationError3("project_id", resourceType);
+      if (args.snippet_id == null) throw validationError3("snippet_id", resourceType);
       break;
   }
 }
@@ -3729,15 +3738,15 @@ function validateGetNoteParams(resourceType, args) {
       `Invalid resource_type '${resourceType}'. Must be one of: ${VALID_GET_NOTE_TYPES.join(", ")}`
     );
   }
-  if (args.note_id == null) throw validationError2("note_id", resourceType);
+  if (args.note_id == null) throw validationError3("note_id", resourceType);
   switch (resourceType) {
     case "issue":
-      if (!args.project_id) throw validationError2("project_id", resourceType);
-      if (args.iid == null) throw validationError2("iid", resourceType);
+      if (!args.project_id) throw validationError3("project_id", resourceType);
+      if (args.iid == null) throw validationError3("iid", resourceType);
       break;
     case "epic":
-      if (!args.group_id) throw validationError2("group_id", resourceType);
-      if (args.iid == null) throw validationError2("iid", resourceType);
+      if (!args.group_id) throw validationError3("group_id", resourceType);
+      if (args.iid == null) throw validationError3("iid", resourceType);
       break;
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitlab/opencode-gitlab-plugin",
-  "version": "1.5.6",
+  "version": "1.5.7",
   "description": "GitLab tools plugin for OpenCode - provides GitLab API access for merge requests, issues, pipelines, and more",
   "type": "module",
   "main": "dist/index.js",