@gitlab/opencode-gitlab-plugin 1.5.4 → 1.5.6

package/dist/index.js

@@ -2086,33 +2086,6 @@ Returns the list of files changed with their diffs.`,
       return JSON.stringify(changes, null, 2);
     }
   }),
-  gitlab_list_mr_notes: tool({
-    description: `List all notes/comments on a merge request using GraphQL API with pagination support.
-Returns all comments including system notes, code review comments, and general discussion.
-This is easier to read than discussions which have nested structure.
-
-The response includes pagination information (pageInfo) with cursors for fetching additional pages.
-Use 'after' with the 'endCursor' from pageInfo to get the next page.
-Use 'before' with the 'startCursor' from pageInfo to get the previous page.`,
-    args: {
-      project_id: z.string().describe("The project ID or URL-encoded path"),
-      mr_iid: z.number().describe("The internal ID of the merge request"),
-      first: z.number().optional().describe("Number of items to return from the beginning (default: 20, max: 100)"),
-      after: z.string().optional().describe("Cursor for forward pagination - use endCursor from previous response"),
-      last: z.number().optional().describe("Number of items to return from the end (for backward pagination)"),
-      before: z.string().optional().describe("Cursor for backward pagination - use startCursor from previous response")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const result = await client.listMrNotes(args.project_id, args.mr_iid, {
-        first: args.first,
-        after: args.after,
-        last: args.last,
-        before: args.before
-      });
-      return JSON.stringify(result, null, 2);
-    }
-  }),
   gitlab_create_merge_request: tool({
     description: `Create a new merge request.
 Returns the created merge request with all details.`,
@@ -2330,47 +2303,6 @@ Can filter by state, labels, assignee, milestone.`,
       });
       return JSON.stringify(issues, null, 2);
     }
-  }),
-  gitlab_list_issue_notes: tool2({
-    description: `List all notes/comments on an issue using GraphQL API with pagination support.
-Returns all comments including system notes in chronological order.
-
-The response includes pagination information (pageInfo) with cursors for fetching additional pages.
-Use 'after' with the 'endCursor' from pageInfo to get the next page.
-Use 'before' with the 'startCursor' from pageInfo to get the previous page.`,
-    args: {
-      project_id: z2.string().describe("The project ID or URL-encoded path"),
-      issue_iid: z2.number().describe("The internal ID of the issue"),
-      first: z2.number().optional().describe("Number of items to return from the beginning (default: 20, max: 100)"),
-      after: z2.string().optional().describe("Cursor for forward pagination - use endCursor from previous response"),
-      last: z2.number().optional().describe("Number of items to return from the end (for backward pagination)"),
-      before: z2.string().optional().describe("Cursor for backward pagination - use startCursor from previous response")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const result = await client.listIssueNotes(args.project_id, args.issue_iid, {
-        first: args.first,
-        after: args.after,
-        last: args.last,
-        before: args.before
-      });
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  gitlab_get_issue_note: tool2({
-    description: `Get a single note/comment from an issue by its ID.
-Returns the full details of a specific note including author, body, timestamps, and metadata.
-Useful when you need to retrieve a specific comment without fetching all notes.`,
-    args: {
-      project_id: z2.string().describe("The project ID or URL-encoded path"),
-      issue_iid: z2.number().describe("The internal ID of the issue"),
-      note_id: z2.number().describe("The ID of the note to retrieve")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const note = await client.getIssueNote(args.project_id, args.issue_iid, args.note_id);
-      return JSON.stringify(note, null, 2);
-    }
   })
 };
 
@@ -2514,47 +2446,6 @@ Removes the association between the issue and the epic.`,
       );
       return JSON.stringify(result, null, 2);
     }
-  }),
-  gitlab_list_epic_notes: tool3({
-    description: `List all comments/notes on an epic using GraphQL API with pagination support.
-Returns all comments in chronological order.
-
-The response includes pagination information (pageInfo) with cursors for fetching additional pages.
-Use 'after' with the 'endCursor' from pageInfo to get the next page.
-Use 'before' with the 'startCursor' from pageInfo to get the previous page.`,
-    args: {
-      group_id: z3.string().describe("The group ID or URL-encoded path"),
-      epic_iid: z3.number().describe("The internal ID of the epic"),
-      first: z3.number().optional().describe("Number of items to return from the beginning (default: 20, max: 100)"),
-      after: z3.string().optional().describe("Cursor for forward pagination - use endCursor from previous response"),
-      last: z3.number().optional().describe("Number of items to return from the end (for backward pagination)"),
-      before: z3.string().optional().describe("Cursor for backward pagination - use startCursor from previous response")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const result = await client.listEpicNotes(args.group_id, args.epic_iid, {
-        first: args.first,
-        after: args.after,
-        last: args.last,
-        before: args.before
-      });
-      return JSON.stringify(result, null, 2);
-    }
-  }),
-  gitlab_get_epic_note: tool3({
-    description: `Get a single note/comment from an epic by its ID.
-Returns the full details of a specific note including author, body, timestamps, and metadata.
-Useful when you need to retrieve a specific comment without fetching all notes.`,
-    args: {
-      group_id: z3.string().describe("The group ID or URL-encoded path"),
-      epic_iid: z3.number().describe("The internal ID of the epic"),
-      note_id: z3.number().describe("The ID of the note to retrieve")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const note = await client.getEpicNote(args.group_id, args.epic_iid, args.note_id);
-      return JSON.stringify(note, null, 2);
-    }
   })
 };
 
@@ -2843,10 +2734,83 @@ This is different from discussions - it returns individual comments in a flat st
 // src/tools/search.ts
 import { tool as tool6 } from "@opencode-ai/plugin";
 var z6 = tool6.schema;
+var GENERIC_SEARCH_SCOPES = ["projects", "issues", "merge_requests", "blobs"];
+var SPECIALIZED_SCOPES = [
+  "milestones",
+  "users",
+  "commits",
+  "notes",
+  "wiki_blobs",
+  "group_projects"
+];
+var ALL_SCOPES = [...GENERIC_SEARCH_SCOPES, ...SPECIALIZED_SCOPES];
+var REF_SUPPORTED_SCOPES = ["commits", "wiki_blobs"];
+var STATE_SUPPORTED_SCOPES = ["milestones"];
+function validationError(param, scope) {
+  return new Error(`Missing required parameter: '${param}' is required for scope '${scope}'`);
+}
+function invalidParamError(param, validScopes) {
+  return new Error(
+    `Invalid parameter: '${param}' is only valid for scopes: ${validScopes.join(", ")}`
+  );
+}
+function validateSearchParams(scope, args) {
+  switch (scope) {
+    case "notes":
+      if (!args.project_id) throw validationError("project_id", scope);
+      break;
+    case "group_projects":
+      if (!args.group_id) throw validationError("group_id", scope);
+      break;
+  }
+  if (args.ref && !REF_SUPPORTED_SCOPES.includes(scope)) {
+    throw invalidParamError("ref", REF_SUPPORTED_SCOPES);
+  }
+  if (args.state && !STATE_SUPPORTED_SCOPES.includes(scope)) {
+    throw invalidParamError("state", STATE_SUPPORTED_SCOPES);
+  }
+}
 var searchTools = {
+  /**
+   * Unified search across all GitLab resources
+   *
+   * @example
+   * // Search for issues in a project
+   * gitlab_search({ scope: "issues", search: "bug", project_id: "my-group/project" })
+   *
+   * @example
+   * // Search commits on specific branch
+   * gitlab_search({ scope: "commits", search: "fix", ref: "main" })
+   *
+   * @example
+   * // Search for projects within a group
+   * gitlab_search({ scope: "group_projects", group_id: "gitlab-org", search: "runner" })
+   *
+   * @example
+   * // Search notes/comments in a project
+   * gitlab_search({ scope: "notes", search: "LGTM", project_id: "my-group/project" })
+   */
   gitlab_search: tool6({
-    description: `Search across GitLab for various resources.
-Scopes: projects, issues, merge_requests, milestones, users, blobs (code), commits, notes, wiki_blobs`,
+    description: `Search across GitLab for various resources with scope-specific options.
+
+Scopes and their requirements:
+- projects: Search projects by name/description
+- issues: Search issues by title/description
+- merge_requests: Search MRs by title/description
+- milestones: Search milestones (supports state filter)
+- users: Search users by name/email
+- blobs: Search file content (code search)
+- commits: Search commits by message/author/SHA (supports ref filter)
+- notes: Search comments/notes (requires project_id)
+- wiki_blobs: Search wiki content (supports ref filter)
+- group_projects: Search projects within a group (requires group_id)
+
+Examples:
+- Issues: scope="issues", search="bug", project_id="my-group/my-project"
+- Code: scope="blobs", search="function calculateTotal"
+- Commits: scope="commits", search="fix login", ref="main"
+- Group projects: scope="group_projects", group_id="gitlab-org", search="runner"
+- Notes: scope="notes", search="LGTM", project_id="my-group/my-project"`,
     args: {
       scope: z6.enum([
         "projects",
@@ -2857,238 +2821,104 @@ Scopes: projects, issues, merge_requests, milestones, users, blobs (code), commi
         "blobs",
         "commits",
         "notes",
-        "wiki_blobs"
-      ]).describe("The scope of the search"),
+        "wiki_blobs",
+        "group_projects"
+      ]).describe("The type of resource to search"),
       search: z6.string().describe("The search query"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.search(args.scope, args.search, args.project_id, args.limit);
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_issue_search: tool6({
-    description: `Search issues by keyword across GitLab.
-Specialized search for issues with better filtering than the generic search.`,
-    args: {
-      search: z6.string().describe("The search query"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      state: z6.enum(["opened", "closed", "all"]).optional().describe("Filter by issue state"),
-      labels: z6.string().optional().describe("Comma-separated list of labels to filter by"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.search("issues", args.search, args.project_id, args.limit);
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_blob_search: tool6({
-    description: `Search file content in repositories.
-Search for code/text within files across projects.`,
-    args: {
-      search: z6.string().describe("The search query (code/text to find)"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.search("blobs", args.search, args.project_id, args.limit);
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_merge_request_search: tool6({
-    description: `Search merge requests by keyword.
-Specialized search for merge requests with better filtering than the generic search.`,
-    args: {
-      search: z6.string().describe("The search query"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      state: z6.enum(["opened", "closed", "merged", "all"]).optional().describe("Filter by MR state"),
-      labels: z6.string().optional().describe("Comma-separated list of labels to filter by"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.search(
-        "merge_requests",
-        args.search,
-        args.project_id,
-        args.limit
-      );
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_commit_search: tool6({
-    description: `Search for commits in a project or across GitLab.
-Returns commits matching the search query with commit details including SHA, title, message, author, and dates.
-
-Supports searching by:
-- Commit message content
-- Author name or email
-- Commit SHA (partial or full)
-
-Note: Advanced search features (Premium/Ultimate) provide better commit search capabilities.`,
-    args: {
-      search: z6.string().describe("The search query (commit message, author, or SHA)"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      ref: z6.string().optional().describe("Branch or tag name to search on (defaults to default branch)"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
+      // Context parameters
+      project_id: z6.string().optional().describe("Limit search to a specific project. Required for notes scope"),
+      group_id: z6.string().optional().describe("Group ID or path. Required for group_projects scope"),
+      // Common options
+      limit: z6.number().optional().describe("Maximum number of results (default: 20)"),
+      order_by: z6.enum(["created_at"]).optional().describe(
+        "Order results by field (for milestones, users, commits, notes, wiki_blobs, group_projects)"
+      ),
+      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (for milestones, users, commits, notes, wiki_blobs, group_projects)"),
+      // Scope-specific options
+      ref: z6.string().optional().describe("Branch or tag name (for commits, wiki_blobs scopes)"),
+      state: z6.enum(["active", "closed", "all"]).optional().describe("Filter by state (for milestones scope)")
     },
     execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.searchCommits(args.search, args.project_id, {
+      validateSearchParams(args.scope, {
+        project_id: args.project_id,
+        group_id: args.group_id,
         ref: args.ref,
-        order_by: args.order_by,
-        sort: args.sort,
-        limit: args.limit
-      });
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_group_project_search: tool6({
-    description: `Search for projects within a specific group.
-Returns projects matching the search query within the specified group and its subgroups.
-
-Useful for:
-- Finding projects by name or description within a group
-- Discovering projects in large group hierarchies
-- Filtering group projects by keywords`,
-    args: {
-      group_id: z6.string().describe("The group ID or URL-encoded path"),
-      search: z6.string().describe("The search query (project name or description)"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.searchGroupProjects(args.group_id, args.search, {
-        order_by: args.order_by,
-        sort: args.sort,
-        limit: args.limit
-      });
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_milestone_search: tool6({
-    description: `Search for milestones in a project or across GitLab.
-Returns milestones matching the search query with details including title, description, state, and dates.
-
-Useful for:
-- Finding milestones by title or description
-- Discovering active or closed milestones
-- Planning and tracking project milestones`,
-    args: {
-      search: z6.string().describe("The search query (milestone title or description)"),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      state: z6.enum(["active", "closed", "all"]).optional().describe("Filter by milestone state"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.searchMilestones(args.search, args.project_id, {
-        state: args.state,
-        order_by: args.order_by,
-        sort: args.sort,
-        limit: args.limit
-      });
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_note_search: tool6({
-    description: `Search for notes/comments in a project.
-Returns notes (comments) matching the search query from issues, merge requests, commits, and snippets.
-
-Useful for:
-- Finding specific comments or discussions
-- Tracking feedback and review comments
-- Searching for mentions or keywords in conversations
-
-Note: This scope requires Premium or Ultimate tier with advanced search enabled.`,
-    args: {
-      search: z6.string().describe("The search query (comment text)"),
-      project_id: z6.string().describe("The project ID or URL-encoded path to search in"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.searchNotes(args.search, args.project_id, {
-        order_by: args.order_by,
-        sort: args.sort,
-        limit: args.limit
+        state: args.state
       });
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_user_search: tool6({
-    description: `Search for users by name or email across GitLab.
-Returns users matching the search query with details including username, name, state, and avatar.
-
-Useful for:
-- Finding users to assign to issues or merge requests
-- Looking up user information by name or email
-- Discovering team members and collaborators`,
-    args: {
-      search: z6.string().describe("The search query (user name or email)"),
-      project_id: z6.string().optional().describe("Limit search to project members (optional)"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const results = await client.searchUsers(args.search, args.project_id, {
-        order_by: args.order_by,
-        sort: args.sort,
-        limit: args.limit
-      });
-      return JSON.stringify(results, null, 2);
-    }
-  }),
-  gitlab_wiki_blob_search: tool6({
-    description: `Search for wiki content (blobs) in a project or across GitLab.
-Returns wiki pages matching the search query with content snippets and file information.
-
-Supports advanced filters (use in search query):
-- filename:some_name* - Filter by filename with wildcards
-- path:some/path* - Filter by path with wildcards
-- extension:md - Filter by file extension
-
-Examples:
-- "installation" - Search for "installation" in wiki content
-- "setup filename:getting-started*" - Search in files starting with "getting-started"
-- "api extension:md" - Search for "api" in markdown files
-
-Note: Advanced search (Premium/Ultimate) provides better wiki search capabilities.`,
-    args: {
-      search: z6.string().describe(
-        "The search query (supports filters: filename:, path:, extension: with wildcards)"
-      ),
-      project_id: z6.string().optional().describe("Limit search to a specific project (optional)"),
-      ref: z6.string().optional().describe("Branch or tag name to search on (defaults to default branch)"),
-      order_by: z6.enum(["created_at"]).optional().describe("Order results by created_at (default: created_at desc)"),
-      sort: z6.enum(["asc", "desc"]).optional().describe("Sort order (asc or desc)"),
-      limit: z6.number().optional().describe("Maximum number of results (default: 20)")
-    },
-    execute: async (args, _ctx) => {
       const client = getGitLabClient();
-      const results = await client.searchWikiBlobs(args.search, args.project_id, {
-        ref: args.ref,
+      const commonOptions = {
         order_by: args.order_by,
         sort: args.sort,
         limit: args.limit
-      });
-      return JSON.stringify(results, null, 2);
+      };
+      switch (args.scope) {
+        // Generic search API scopes
+        case "projects":
+        case "issues":
+        case "merge_requests":
+        case "blobs":
+          return JSON.stringify(
+            await client.search(args.scope, args.search, args.project_id, args.limit),
+            null,
+            2
+          );
+        // Specialized scopes with dedicated client methods
+        case "milestones":
+          return JSON.stringify(
+            await client.searchMilestones(args.search, args.project_id, {
+              ...commonOptions,
+              state: args.state
+            }),
+            null,
+            2
+          );
+        case "users":
+          return JSON.stringify(
+            await client.searchUsers(args.search, args.project_id, commonOptions),
+            null,
+            2
+          );
+        case "commits":
+          return JSON.stringify(
+            await client.searchCommits(args.search, args.project_id, {
+              ...commonOptions,
+              ref: args.ref
+            }),
+            null,
+            2
+          );
+        case "notes":
+          return JSON.stringify(
+            await client.searchNotes(args.search, args.project_id, commonOptions),
+            null,
+            2
+          );
+        case "wiki_blobs":
+          return JSON.stringify(
+            await client.searchWikiBlobs(args.search, args.project_id, {
+              ...commonOptions,
+              ref: args.ref
+            }),
+            null,
+            2
+          );
+        case "group_projects":
+          return JSON.stringify(
+            await client.searchGroupProjects(args.group_id, args.search, commonOptions),
+            null,
+            2
+          );
+        default:
+          throw new Error(
+            `Invalid scope '${args.scope}'. Must be one of: ${ALL_SCOPES.join(", ")}`
+          );
+      }
     }
   }),
+  /**
+   * Search GitLab official documentation
+   * Separate tool because it uses a completely different API (docs.gitlab.com)
+   */
   gitlab_documentation_search: tool6({
     description: `Search GitLab official documentation at docs.gitlab.com.
 Returns relevant documentation pages matching the search query.
@@ -3320,43 +3150,11 @@ Requires Developer role or higher.`,
   })
 };
 
-// src/tools/snippets.ts
+// src/tools/todos.ts
 import { tool as tool9 } from "@opencode-ai/plugin";
 var z9 = tool9.schema;
-var snippetTools = {
-  gitlab_list_snippet_notes: tool9({
-    description: `List all notes/comments on a project snippet using GraphQL API with pagination support.
-Returns all comments including system notes in chronological order.
-
-The response includes pagination information (pageInfo) with cursors for fetching additional pages.
-Use 'after' with the 'endCursor' from pageInfo to get the next page.
-Use 'before' with the 'startCursor' from pageInfo to get the previous page.`,
-    args: {
-      project_id: z9.string().describe("The project ID or URL-encoded path"),
-      snippet_id: z9.number().describe("The ID of the snippet"),
-      first: z9.number().optional().describe("Number of items to return from the beginning (default: 20, max: 100)"),
-      after: z9.string().optional().describe("Cursor for forward pagination - use endCursor from previous response"),
-      last: z9.number().optional().describe("Number of items to return from the end (for backward pagination)"),
-      before: z9.string().optional().describe("Cursor for backward pagination - use startCursor from previous response")
-    },
-    execute: async (args, _ctx) => {
-      const client = getGitLabClient();
-      const result = await client.listSnippetNotes(args.project_id, args.snippet_id, {
-        first: args.first,
-        after: args.after,
-        last: args.last,
-        before: args.before
-      });
-      return JSON.stringify(result, null, 2);
-    }
-  })
-};
-
-// src/tools/todos.ts
-import { tool as tool10 } from "@opencode-ai/plugin";
-var z10 = tool10.schema;
 var todoTools = {
-  gitlab_list_todos: tool10({
+  gitlab_list_todos: tool9({
     description: `List TODO items for the current user using GraphQL API with pagination support.
 Returns a list of pending or done TODO items assigned to the authenticated user.
 TODOs are created when you are assigned to an issue/MR, mentioned in a comment, or when someone requests your review.
@@ -3365,7 +3163,7 @@ The response includes pagination information (pageInfo) with cursors for fetchin
 Use 'after' with the 'endCursor' from pageInfo to get the next page.
 Use 'before' with the 'startCursor' from pageInfo to get the previous page.`,
     args: {
-      action: z10.enum([
+      action: z9.enum([
         "assigned",
         "mentioned",
         "build_failed",
@@ -3376,15 +3174,15 @@ Use 'before' with the 'startCursor' from pageInfo to get the previous page.`,
         "merge_train_removed",
         "review_requested"
       ]).optional().describe("Filter by action type"),
-      author_id: z10.number().optional().describe("Filter by author ID"),
-      project_id: z10.string().optional().describe("Filter by project ID or path"),
-      group_id: z10.string().optional().describe("Filter by group ID"),
-      state: z10.enum(["pending", "done"]).optional().describe("Filter by state (default: pending)"),
-      type: z10.enum(["Issue", "MergeRequest", "DesignManagement::Design", "Alert", "Epic", "Commit"]).optional().describe("Filter by target type"),
-      first: z10.number().optional().describe("Number of items to return from the beginning (default: 20, max: 100)"),
-      after: z10.string().optional().describe("Cursor for forward pagination - use endCursor from previous response"),
-      last: z10.number().optional().describe("Number of items to return from the end (for backward pagination)"),
-      before: z10.string().optional().describe("Cursor for backward pagination - use startCursor from previous response")
+      author_id: z9.number().optional().describe("Filter by author ID"),
+      project_id: z9.string().optional().describe("Filter by project ID or path"),
+      group_id: z9.string().optional().describe("Filter by group ID"),
+      state: z9.enum(["pending", "done"]).optional().describe("Filter by state (default: pending)"),
+      type: z9.enum(["Issue", "MergeRequest", "DesignManagement::Design", "Alert", "Epic", "Commit"]).optional().describe("Filter by target type"),
+      first: z9.number().optional().describe("Number of items to return from the beginning (default: 20, max: 100)"),
+      after: z9.string().optional().describe("Cursor for forward pagination - use endCursor from previous response"),
+      last: z9.number().optional().describe("Number of items to return from the end (for backward pagination)"),
+      before: z9.string().optional().describe("Cursor for backward pagination - use startCursor from previous response")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3403,11 +3201,11 @@ Use 'before' with the 'startCursor' from pageInfo to get the previous page.`,
       return JSON.stringify(result, null, 2);
     }
   }),
-  gitlab_mark_todo_done: tool10({
+  gitlab_mark_todo_done: tool9({
     description: `Mark a specific TODO item as done.
 Use this to mark a single TODO as completed.`,
     args: {
-      todo_id: z10.number().describe("The ID of the TODO item to mark as done")
+      todo_id: z9.number().describe("The ID of the TODO item to mark as done")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3415,7 +3213,7 @@ Use this to mark a single TODO as completed.`,
       return JSON.stringify(result, null, 2);
     }
   }),
-  gitlab_mark_all_todos_done: tool10({
+  gitlab_mark_all_todos_done: tool9({
     description: `Mark all TODO items as done.
 Use this to mark all pending TODOs for the current user as completed.`,
     args: {},
@@ -3425,7 +3223,7 @@ Use this to mark all pending TODOs for the current user as completed.`,
       return JSON.stringify(result, null, 2);
     }
   }),
-  gitlab_get_todo_count: tool10({
+  gitlab_get_todo_count: tool9({
     description: `Get the count of pending TODO items.
 Returns the total number of pending TODOs for the current user.`,
     args: {},
@@ -3438,15 +3236,15 @@ Returns the total number of pending TODOs for the current user.`,
 };
 
 // src/tools/wikis.ts
-import { tool as tool11 } from "@opencode-ai/plugin";
-var z11 = tool11.schema;
+import { tool as tool10 } from "@opencode-ai/plugin";
+var z10 = tool10.schema;
 var wikiTools = {
-  gitlab_get_wiki_page: tool11({
+  gitlab_get_wiki_page: tool10({
     description: `Get a wiki page with its content.
 Returns the wiki page content and metadata.`,
     args: {
-      project_id: z11.string().describe("The project ID or URL-encoded path"),
-      slug: z11.string().describe("The slug (URL-friendly name) of the wiki page")
+      project_id: z10.string().describe("The project ID or URL-encoded path"),
+      slug: z10.string().describe("The slug (URL-friendly name) of the wiki page")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3457,15 +3255,15 @@ Returns the wiki page content and metadata.`,
 };
 
 // src/tools/work-items.ts
-import { tool as tool12 } from "@opencode-ai/plugin";
-var z12 = tool12.schema;
+import { tool as tool11 } from "@opencode-ai/plugin";
+var z11 = tool11.schema;
 var workItemTools = {
-  gitlab_get_work_item: tool12({
+  gitlab_get_work_item: tool11({
     description: `Get a single work item (issue, epic, task, etc.).
 Work items are the new unified model for issues, epics, tasks, and other work tracking items in GitLab.`,
     args: {
-      project_id: z12.string().describe("The project ID or URL-encoded path"),
-      work_item_id: z12.number().describe("The ID of the work item")
+      project_id: z11.string().describe("The project ID or URL-encoded path"),
+      work_item_id: z11.number().describe("The ID of the work item")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3473,17 +3271,17 @@ Work items are the new unified model for issues, epics, tasks, and other work tr
       return JSON.stringify(workItem, null, 2);
     }
   }),
-  gitlab_list_work_items: tool12({
+  gitlab_list_work_items: tool11({
     description: `List work items in a project or group.
 Work items include issues, epics, tasks, and other work tracking items.`,
     args: {
-      project_id: z12.string().optional().describe("The project ID or URL-encoded path"),
-      group_id: z12.string().optional().describe("The group ID or URL-encoded path"),
-      state: z12.enum(["opened", "closed", "all"]).optional().describe("Filter by state (default: opened)"),
-      search: z12.string().optional().describe("Search work items by title or description"),
-      labels: z12.string().optional().describe("Comma-separated list of labels to filter by"),
-      work_item_type: z12.string().optional().describe("Filter by work item type (e.g., 'Issue', 'Epic', 'Task')"),
-      limit: z12.number().optional().describe("Maximum number of results (default: 20)")
+      project_id: z11.string().optional().describe("The project ID or URL-encoded path"),
+      group_id: z11.string().optional().describe("The group ID or URL-encoded path"),
+      state: z11.enum(["opened", "closed", "all"]).optional().describe("Filter by state (default: opened)"),
+      search: z11.string().optional().describe("Search work items by title or description"),
+      labels: z11.string().optional().describe("Comma-separated list of labels to filter by"),
+      work_item_type: z11.string().optional().describe("Filter by work item type (e.g., 'Issue', 'Epic', 'Task')"),
+      limit: z11.number().optional().describe("Maximum number of results (default: 20)")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3499,12 +3297,12 @@ Work items include issues, epics, tasks, and other work tracking items.`,
       return JSON.stringify(workItems, null, 2);
     }
   }),
-  gitlab_get_work_item_notes: tool12({
+  gitlab_get_work_item_notes: tool11({
     description: `Get all comments for a work item.
 Returns all notes/comments on the work item in chronological order.`,
     args: {
-      project_id: z12.string().describe("The project ID or URL-encoded path"),
-      work_item_id: z12.number().describe("The ID of the work item")
+      project_id: z11.string().describe("The project ID or URL-encoded path"),
+      work_item_id: z11.number().describe("The ID of the work item")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3512,16 +3310,16 @@ Returns all notes/comments on the work item in chronological order.`,
       return JSON.stringify(notes, null, 2);
     }
   }),
-  gitlab_create_work_item: tool12({
+  gitlab_create_work_item: tool11({
     description: `Create a new work item (issue, task, etc.).
 Work items are the new unified model for issues, epics, tasks, and other work tracking items.`,
     args: {
-      project_id: z12.string().describe("The project ID or URL-encoded path"),
-      title: z12.string().describe("The title of the work item"),
-      work_item_type_id: z12.number().describe("The ID of the work item type (e.g., 1 for Issue, 2 for Task)"),
-      description: z12.string().optional().describe("The description of the work item (supports Markdown)"),
-      labels: z12.array(z12.string()).optional().describe("Array of label names"),
-      assignee_ids: z12.array(z12.number()).optional().describe("Array of user IDs to assign")
+      project_id: z11.string().describe("The project ID or URL-encoded path"),
+      title: z11.string().describe("The title of the work item"),
+      work_item_type_id: z11.number().describe("The ID of the work item type (e.g., 1 for Issue, 2 for Task)"),
+      description: z11.string().optional().describe("The description of the work item (supports Markdown)"),
+      labels: z11.array(z11.string()).optional().describe("Array of label names"),
+      assignee_ids: z11.array(z11.number()).optional().describe("Array of user IDs to assign")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3535,17 +3333,17 @@ Work items are the new unified model for issues, epics, tasks, and other work tr
       return JSON.stringify(workItem, null, 2);
     }
   }),
-  gitlab_update_work_item: tool12({
+  gitlab_update_work_item: tool11({
     description: `Update an existing work item.
 Can update title, description, state, labels, and assignees.`,
     args: {
-      project_id: z12.string().describe("The project ID or URL-encoded path"),
-      work_item_id: z12.number().describe("The ID of the work item"),
-      title: z12.string().optional().describe("The new title"),
-      description: z12.string().optional().describe("The new description (supports Markdown)"),
-      state_event: z12.enum(["close", "reopen"]).optional().describe("Change the state (close or reopen)"),
-      labels: z12.array(z12.string()).optional().describe("Array of label names"),
-      assignee_ids: z12.array(z12.number()).optional().describe("Array of user IDs to assign")
+      project_id: z11.string().describe("The project ID or URL-encoded path"),
+      work_item_id: z11.number().describe("The ID of the work item"),
+      title: z11.string().optional().describe("The new title"),
+      description: z11.string().optional().describe("The new description (supports Markdown)"),
+      state_event: z11.enum(["close", "reopen"]).optional().describe("Change the state (close or reopen)"),
+      labels: z11.array(z11.string()).optional().describe("Array of label names"),
+      assignee_ids: z11.array(z11.number()).optional().describe("Array of user IDs to assign")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3559,12 +3357,12 @@ Can update title, description, state, labels, and assignees.`,
       return JSON.stringify(workItem, null, 2);
     }
   }),
-  gitlab_create_work_item_note: tool12({
+  gitlab_create_work_item_note: tool11({
     description: `Create a comment on a work item.`,
     args: {
-      project_id: z12.string().describe("The project ID or URL-encoded path"),
-      work_item_id: z12.number().describe("The ID of the work item"),
-      body: z12.string().describe("The content of the note/comment (supports Markdown)")
+      project_id: z11.string().describe("The project ID or URL-encoded path"),
+      work_item_id: z11.number().describe("The ID of the work item"),
+      body: z11.string().describe("The content of the note/comment (supports Markdown)")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3575,17 +3373,17 @@ Can update title, description, state, labels, and assignees.`,
 };
 
 // src/tools/discussions-unified.ts
-import { tool as tool13 } from "@opencode-ai/plugin";
-var z13 = tool13.schema;
-var positionSchema = z13.object({
-  base_sha: z13.string().describe("SHA of the base commit"),
-  start_sha: z13.string().describe("SHA of the start commit"),
-  head_sha: z13.string().describe("SHA of the head commit"),
-  position_type: z13.enum(["text", "image"]).describe("Type of position"),
-  old_path: z13.string().optional().describe("Path of the file before changes"),
-  new_path: z13.string().optional().describe("Path of the file after changes"),
-  old_line: z13.number().optional().describe("Line number in the old version"),
-  new_line: z13.number().optional().describe("Line number in the new version")
+import { tool as tool12 } from "@opencode-ai/plugin";
+var z12 = tool12.schema;
+var positionSchema = z12.object({
+  base_sha: z12.string().describe("SHA of the base commit"),
+  start_sha: z12.string().describe("SHA of the start commit"),
+  head_sha: z12.string().describe("SHA of the head commit"),
+  position_type: z12.enum(["text", "image"]).describe("Type of position"),
+  old_path: z12.string().optional().describe("Path of the file before changes"),
+  new_path: z12.string().optional().describe("Path of the file after changes"),
+  old_line: z12.number().optional().describe("Line number in the old version"),
+  new_line: z12.number().optional().describe("Line number in the new version")
 });
 function validateResourceParams(resourceType, args) {
   switch (resourceType) {
@@ -3612,7 +3410,7 @@ var discussionsUnifiedTools = {
   /**
    * List discussions for any GitLab resource type
    */
-  gitlab_list_discussions: tool13({
+  gitlab_list_discussions: tool12({
     description: `List discussions (comment threads) on any GitLab resource.
 Supports: merge_requests, issues, epics, commits, snippets.
 
@@ -3628,17 +3426,17 @@ Examples:
 - Commit: resource_type="commit", project_id="group/project", sha="abc123"
 - Snippet: resource_type="snippet", project_id="group/project", snippet_id=789`,
     args: {
-      resource_type: z13.enum(["merge_request", "issue", "epic", "commit", "snippet"]).describe("Type of GitLab resource"),
-      project_id: z13.string().optional().describe("Project ID or path. Required for merge_request, issue, commit, snippet"),
-      group_id: z13.string().optional().describe("Group ID or path. Required for epic"),
-      iid: z13.number().optional().describe("Internal ID of the resource (for merge_request, issue, epic)"),
-      sha: z13.string().optional().describe("Commit SHA (required for commit)"),
-      snippet_id: z13.number().optional().describe("Snippet ID (required for snippet)"),
+      resource_type: z12.enum(["merge_request", "issue", "epic", "commit", "snippet"]).describe("Type of GitLab resource"),
+      project_id: z12.string().optional().describe("Project ID or path. Required for merge_request, issue, commit, snippet"),
+      group_id: z12.string().optional().describe("Group ID or path. Required for epic"),
+      iid: z12.number().optional().describe("Internal ID of the resource (for merge_request, issue, epic)"),
+      sha: z12.string().optional().describe("Commit SHA (required for commit)"),
+      snippet_id: z12.number().optional().describe("Snippet ID (required for snippet)"),
       // Pagination
-      first: z13.number().optional().describe("Number of items to return (default: 20)"),
-      after: z13.string().optional().describe("Cursor for pagination - use endCursor from previous response"),
-      before: z13.string().optional().describe("Cursor for backward pagination"),
-      last: z13.number().optional().describe("Number of items from the end")
+      first: z12.number().optional().describe("Number of items to return (default: 20)"),
+      after: z12.string().optional().describe("Cursor for pagination - use endCursor from previous response"),
+      before: z12.string().optional().describe("Cursor for backward pagination"),
+      last: z12.number().optional().describe("Number of items from the end")
     },
     execute: async (args, _ctx) => {
       validateResourceParams(args.resource_type, args);
@@ -3692,7 +3490,7 @@ Examples:
   /**
    * Get a specific discussion thread from any GitLab resource
    */
-  gitlab_get_discussion: tool13({
+  gitlab_get_discussion: tool12({
     description: `Get a specific discussion thread with all its replies.
 Returns the discussion with its 'notes' array containing all comments.
 
@@ -3705,13 +3503,13 @@ Required parameters vary by resource type:
 - commit: project_id, sha, discussion_id
 - snippet: project_id, snippet_id, discussion_id`,
     args: {
-      resource_type: z13.enum(["merge_request", "issue", "epic", "commit", "snippet"]).describe("Type of GitLab resource"),
-      discussion_id: z13.string().describe("The ID of the discussion thread"),
-      project_id: z13.string().optional().describe("Project ID or path"),
-      group_id: z13.string().optional().describe("Group ID or path (for epic)"),
-      iid: z13.number().optional().describe("Internal ID (for merge_request, issue, epic)"),
-      sha: z13.string().optional().describe("Commit SHA (for commit)"),
-      snippet_id: z13.number().optional().describe("Snippet ID (for snippet)")
+      resource_type: z12.enum(["merge_request", "issue", "epic", "commit", "snippet"]).describe("Type of GitLab resource"),
+      discussion_id: z12.string().describe("The ID of the discussion thread"),
+      project_id: z12.string().optional().describe("Project ID or path"),
+      group_id: z12.string().optional().describe("Group ID or path (for epic)"),
+      iid: z12.number().optional().describe("Internal ID (for merge_request, issue, epic)"),
+      sha: z12.string().optional().describe("Commit SHA (for commit)"),
+      snippet_id: z12.number().optional().describe("Snippet ID (for snippet)")
     },
     execute: async (args, _ctx) => {
       validateResourceParams(args.resource_type, args);
@@ -3759,7 +3557,7 @@ Required parameters vary by resource type:
   /**
    * Create a new discussion thread or reply to an existing one
    */
-  gitlab_create_discussion: tool13({
+  gitlab_create_discussion: tool12({
     description: `Create a new discussion thread or reply to an existing one.
 
 For NEW discussion: Omit discussion_id
@@ -3772,14 +3570,14 @@ Examples:
 - Reply to thread: resource_type="merge_request", ..., discussion_id="...", body="..."  
 - Code comment: resource_type="merge_request", ..., body="...", position={base_sha, head_sha, ...}`,
     args: {
-      resource_type: z13.enum(["merge_request", "issue", "epic", "commit", "snippet"]).describe("Type of GitLab resource"),
-      body: z13.string().describe("The comment text (Markdown supported)"),
-      project_id: z13.string().optional().describe("Project ID or path"),
-      group_id: z13.string().optional().describe("Group ID or path (for epic)"),
-      iid: z13.number().optional().describe("Internal ID (for merge_request, issue, epic)"),
-      sha: z13.string().optional().describe("Commit SHA (for commit)"),
-      snippet_id: z13.number().optional().describe("Snippet ID (for snippet)"),
-      discussion_id: z13.string().optional().describe("If provided, replies to existing discussion. If omitted, creates new thread"),
+      resource_type: z12.enum(["merge_request", "issue", "epic", "commit", "snippet"]).describe("Type of GitLab resource"),
+      body: z12.string().describe("The comment text (Markdown supported)"),
+      project_id: z12.string().optional().describe("Project ID or path"),
+      group_id: z12.string().optional().describe("Group ID or path (for epic)"),
+      iid: z12.number().optional().describe("Internal ID (for merge_request, issue, epic)"),
+      sha: z12.string().optional().describe("Commit SHA (for commit)"),
+      snippet_id: z12.number().optional().describe("Snippet ID (for snippet)"),
+      discussion_id: z12.string().optional().describe("If provided, replies to existing discussion. If omitted, creates new thread"),
       position: positionSchema.optional().describe("Position for code-specific comments (MR/commit only)")
     },
     execute: async (args, _ctx) => {
@@ -3844,17 +3642,17 @@ Examples:
   /**
    * Resolve or unresolve a discussion thread
    */
-  gitlab_resolve_discussion: tool13({
+  gitlab_resolve_discussion: tool12({
     description: `Mark a discussion thread as resolved or unresolve it.
 Only works for resolvable discussions (MRs and issues only).
 
 Use after addressing feedback to indicate the discussion is complete.`,
     args: {
-      resource_type: z13.enum(["merge_request", "issue"]).describe("Type of resource (only MR and issue discussions can be resolved)"),
-      action: z13.enum(["resolve", "unresolve"]).describe("Whether to resolve or unresolve"),
-      discussion_id: z13.string().describe("The ID of the discussion thread"),
-      project_id: z13.string().describe("Project ID or path"),
-      iid: z13.number().describe("Internal ID of the MR or issue")
+      resource_type: z12.enum(["merge_request", "issue"]).describe("Type of resource (only MR and issue discussions can be resolved)"),
+      action: z12.enum(["resolve", "unresolve"]).describe("Whether to resolve or unresolve"),
+      discussion_id: z12.string().describe("The ID of the discussion thread"),
+      project_id: z12.string().describe("Project ID or path"),
+      iid: z12.number().describe("Internal ID of the MR or issue")
     },
     execute: async (args, _ctx) => {
       const client = getGitLabClient();
@@ -3893,6 +3691,224 @@ Use after addressing feedback to indicate the discussion is complete.`,
   })
 };
 
+// src/tools/notes-unified.ts
+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) {
+  return new Error(
+    `Missing required parameter: '${param}' is required for resource_type '${resourceType}'`
+  );
+}
+function validateListCreateParams(resourceType, args) {
+  if (!VALID_LIST_CREATE_TYPES.includes(resourceType)) {
+    throw new Error(
+      `Invalid resource_type '${resourceType}'. Must be one of: ${VALID_LIST_CREATE_TYPES.join(", ")}`
+    );
+  }
+  switch (resourceType) {
+    case "merge_request":
+    case "issue":
+      if (!args.project_id) throw validationError2("project_id", resourceType);
+      if (args.iid == null) throw validationError2("iid", resourceType);
+      break;
+    case "epic":
+      if (!args.group_id) throw validationError2("group_id", resourceType);
+      if (args.iid == null) throw validationError2("iid", resourceType);
+      break;
+    case "snippet":
+      if (!args.project_id) throw validationError2("project_id", resourceType);
+      if (args.snippet_id == null) throw validationError2("snippet_id", resourceType);
+      break;
+  }
+}
+function validateGetNoteParams(resourceType, args) {
+  if (!VALID_GET_NOTE_TYPES.includes(resourceType)) {
+    throw new Error(
+      `Invalid resource_type '${resourceType}'. Must be one of: ${VALID_GET_NOTE_TYPES.join(", ")}`
+    );
+  }
+  if (args.note_id == null) throw validationError2("note_id", resourceType);
+  switch (resourceType) {
+    case "issue":
+      if (!args.project_id) throw validationError2("project_id", resourceType);
+      if (args.iid == null) throw validationError2("iid", resourceType);
+      break;
+    case "epic":
+      if (!args.group_id) throw validationError2("group_id", resourceType);
+      if (args.iid == null) throw validationError2("iid", resourceType);
+      break;
+  }
+}
+var notesUnifiedTools = {
+  /**
+   * List notes/comments for any GitLab resource type
+   */
+  gitlab_list_notes: tool13({
+    description: `List all notes/comments on any GitLab resource using GraphQL API with pagination support.
+Returns all comments including system notes in chronological order.
+This is easier to read than discussions which have nested structure.
+
+The response includes pagination information (pageInfo) with cursors for fetching additional pages.
+Use 'after' with the 'endCursor' from pageInfo to get the next page.
+Use 'before' with the 'startCursor' from pageInfo to get the previous page.
+
+Examples:
+- MR: resource_type="merge_request", project_id="group/project", iid=123
+- Issue: resource_type="issue", project_id="group/project", iid=456  
+- Epic: resource_type="epic", group_id="my-group", iid=1
+- Snippet: resource_type="snippet", project_id="group/project", snippet_id=789`,
+    args: {
+      resource_type: z13.enum(["merge_request", "issue", "epic", "snippet"]).describe("Type of GitLab resource"),
+      project_id: z13.string().optional().describe("Project ID or path. Required for merge_request, issue, snippet"),
+      group_id: z13.string().optional().describe("Group ID or path. Required for epic"),
+      iid: z13.number().optional().describe("Internal ID of the resource (for merge_request, issue, epic)"),
+      snippet_id: z13.number().optional().describe("Snippet ID (required for snippet)"),
+      // Pagination
+      first: z13.number().optional().describe("Number of items to return from the beginning (default: 20, max: 100)"),
+      after: z13.string().optional().describe("Cursor for forward pagination - use endCursor from previous response"),
+      last: z13.number().optional().describe("Number of items to return from the end (for backward pagination)"),
+      before: z13.string().optional().describe("Cursor for backward pagination - use startCursor from previous response")
+    },
+    execute: async (args, _ctx) => {
+      validateListCreateParams(args.resource_type, args);
+      const client = getGitLabClient();
+      const paginationOptions = {
+        first: args.first,
+        after: args.after,
+        last: args.last,
+        before: args.before
+      };
+      switch (args.resource_type) {
+        case "merge_request":
+          return JSON.stringify(
+            await client.listMrNotes(args.project_id, args.iid, paginationOptions),
+            null,
+            2
+          );
+        case "issue":
+          return JSON.stringify(
+            await client.listIssueNotes(args.project_id, args.iid, paginationOptions),
+            null,
+            2
+          );
+        case "epic":
+          return JSON.stringify(
+            await client.listEpicNotes(args.group_id, args.iid, paginationOptions),
+            null,
+            2
+          );
+        case "snippet":
+          return JSON.stringify(
+            await client.listSnippetNotes(args.project_id, args.snippet_id, paginationOptions),
+            null,
+            2
+          );
+        default:
+          throw new Error(`Unsupported resource type: ${args.resource_type}`);
+      }
+    }
+  }),
+  /**
+   * Get a single note/comment by its ID
+   */
+  gitlab_get_note: tool13({
+    description: `Get a single note/comment from an issue or epic by its ID.
+Returns the full details of a specific note including author, body, timestamps, and metadata.
+Useful when you need to retrieve a specific comment without fetching all notes.
+
+Supports: issues, epics (MR notes use discussions API)
+
+Examples:
+- Issue note: resource_type="issue", project_id="group/project", iid=456, note_id=123
+- Epic note: resource_type="epic", group_id="my-group", iid=1, note_id=456`,
+    args: {
+      resource_type: z13.enum(["issue", "epic"]).describe("Type of GitLab resource (issue or epic only)"),
+      note_id: z13.number().describe("The ID of the note to retrieve"),
+      project_id: z13.string().optional().describe("Project ID or path. Required for issue"),
+      group_id: z13.string().optional().describe("Group ID or path. Required for epic"),
+      iid: z13.number().describe("Internal ID of the issue or epic")
+    },
+    execute: async (args, _ctx) => {
+      validateGetNoteParams(args.resource_type, args);
+      const client = getGitLabClient();
+      switch (args.resource_type) {
+        case "issue":
+          return JSON.stringify(
+            await client.getIssueNote(args.project_id, args.iid, args.note_id),
+            null,
+            2
+          );
+        case "epic":
+          return JSON.stringify(
+            await client.getEpicNote(args.group_id, args.iid, args.note_id),
+            null,
+            2
+          );
+        default:
+          throw new Error(`Unsupported resource type: ${args.resource_type}`);
+      }
+    }
+  }),
+  /**
+   * Create a simple note/comment on any GitLab resource
+   */
+  gitlab_create_note: tool13({
+    description: `Add a simple comment/note to any GitLab resource.
+Creates a standalone comment (not part of a thread).
+
+For replying to existing discussion threads, use gitlab_create_discussion 
+with discussion_id parameter instead.
+
+Examples:
+- MR comment: resource_type="merge_request", project_id="group/project", iid=123, body="LGTM!"
+- Issue comment: resource_type="issue", project_id="group/project", iid=456, body="Working on this"
+- Epic comment: resource_type="epic", group_id="my-group", iid=1, body="Planning complete"
+- Snippet comment: resource_type="snippet", project_id="group/project", snippet_id=789, body="Nice code!"`,
+    args: {
+      resource_type: z13.enum(["merge_request", "issue", "epic", "snippet"]).describe("Type of GitLab resource"),
+      body: z13.string().describe("The content of the note/comment (supports Markdown)"),
+      project_id: z13.string().optional().describe("Project ID or path. Required for merge_request, issue, snippet"),
+      group_id: z13.string().optional().describe("Group ID or path. Required for epic"),
+      iid: z13.number().optional().describe("Internal ID of the resource (for merge_request, issue, epic)"),
+      snippet_id: z13.number().optional().describe("Snippet ID (required for snippet)")
+    },
+    execute: async (args, _ctx) => {
+      validateListCreateParams(args.resource_type, args);
+      const client = getGitLabClient();
+      switch (args.resource_type) {
+        case "merge_request":
+          return JSON.stringify(
+            await client.createMrNote(args.project_id, args.iid, args.body),
+            null,
+            2
+          );
+        case "issue":
+          return JSON.stringify(
+            await client.createIssueNote(args.project_id, args.iid, args.body),
+            null,
+            2
+          );
+        case "epic":
+          return JSON.stringify(
+            await client.createEpicNote(args.group_id, args.iid, args.body),
+            null,
+            2
+          );
+        case "snippet":
+          return JSON.stringify(
+            await client.createSnippetNote(args.project_id, args.snippet_id, args.body),
+            null,
+            2
+          );
+        default:
+          throw new Error(`Unsupported resource type: ${args.resource_type}`);
+      }
+    }
+  })
+};
+
 // src/tools/git.ts
 import { tool as tool14 } from "@opencode-ai/plugin";
 
@@ -4249,8 +4265,6 @@ var gitlabPlugin = async (_input) => {
       ...userTools,
       // Security Tools
       ...securityTools,
-      // Snippet Tools
-      ...snippetTools,
       // TODO Tools
       ...todoTools,
       // Wiki Tools
@@ -4259,6 +4273,8 @@ var gitlabPlugin = async (_input) => {
       ...workItemTools,
       // Unified Discussion Tools (covers MR, issue, epic, commit, snippet discussions)
       ...discussionsUnifiedTools,
+      // Unified Notes Tools (covers MR, issue, epic, snippet notes)
+      ...notesUnifiedTools,
       // Git Tools
       ...gitTools,
       // Audit Tools