@structured-world/gitlab-mcp 6.8.0 → 6.9.0

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

@@ -41,77 +41,87 @@ const z = __importStar(require("zod"));
 const schema_readonly_1 = require("./schema-readonly");
 const schema_1 = require("./schema");
 const gitlab_api_1 = require("../../utils/gitlab-api");
-const ManageSnippetSchema = z.discriminatedUnion("action", [
-    schema_readonly_1.GetSnippetSchema,
-    schema_1.CreateSnippetSchema,
-    schema_1.UpdateSnippetSchema,
-    schema_1.DeleteSnippetSchema,
-]);
+const config_1 = require("../../config");
 exports.snippetsToolRegistry = new Map([
     [
-        "list_snippets",
+        "browse_snippets",
         {
-            name: "list_snippets",
-            description: "List GitLab code snippets with flexible scoping. Use scope='personal' for current user's snippets, scope='project' for project-specific snippets (requires projectId), or scope='public' to discover all public snippets. Filter by visibility level (private/internal/public) and creation date. Snippets are reusable code blocks, configs, or text that support versioning and can be shared.",
-            inputSchema: z.toJSONSchema(schema_readonly_1.ListSnippetsSchema),
+            name: "browse_snippets",
+            description: 'BROWSE GitLab code snippets. Actions: "list" shows snippets by scope (personal/project/public) with filtering, "get" retrieves single snippet metadata or raw content. Snippets are reusable code blocks, configs, or text with versioning support.',
+            inputSchema: z.toJSONSchema(schema_readonly_1.BrowseSnippetsSchema),
             handler: async (args) => {
-                const options = schema_readonly_1.ListSnippetsSchema.parse(args);
-                let path;
-                if (options.scope === "personal") {
-                    path = "snippets";
-                }
-                else if (options.scope === "public") {
-                    path = "snippets/public";
+                const input = schema_readonly_1.BrowseSnippetsSchema.parse(args);
+                if ((0, config_1.isActionDenied)("browse_snippets", input.action)) {
+                    throw new Error(`Action '${input.action}' is not allowed for browse_snippets tool`);
                 }
-                else {
-                    if (!options.projectId) {
-                        throw new Error("projectId is required for project scope");
+                switch (input.action) {
+                    case "list": {
+                        const { action: _action, scope, projectId, ...queryOptions } = input;
+                        let path;
+                        if (scope === "personal") {
+                            path = "snippets";
+                        }
+                        else if (scope === "public") {
+                            path = "snippets/public";
+                        }
+                        else {
+                            if (!projectId) {
+                                throw new Error("projectId is required when scope is 'project'");
+                            }
+                            const encodedProjectId = encodeURIComponent(projectId);
+                            path = `projects/${encodedProjectId}/snippets`;
+                        }
+                        return gitlab_api_1.gitlab.get(path, {
+                            query: (0, gitlab_api_1.toQuery)(queryOptions, []),
+                        });
                     }
-                    const encodedProjectId = encodeURIComponent(options.projectId);
-                    path = `projects/${encodedProjectId}/snippets`;
-                }
-                return gitlab_api_1.gitlab.get(path, {
-                    query: (0, gitlab_api_1.toQuery)(options, ["scope", "projectId"]),
-                });
-            },
-        },
-    ],
-    [
-        "manage_snippet",
-        {
-            name: "manage_snippet",
-            description: "Manage GitLab snippets with full CRUD operations via action parameter. action='read': retrieve snippet metadata or raw content. action='create': create new snippet with multiple files, visibility control. action='update': modify title, description, visibility, or files (supports create/update/delete/move file actions). action='delete': permanently remove snippet. Supports both personal and project snippets. Multi-file snippets enable organizing related code in one place.",
-            inputSchema: z.toJSONSchema(ManageSnippetSchema),
-            handler: async (args) => {
-                const options = ManageSnippetSchema.parse(args);
-                switch (options.action) {
-                    case "read": {
-                        const encodedId = options.id.toString();
+                    case "get": {
+                        const { id, projectId, raw } = input;
+                        const encodedId = id.toString();
                         let path;
-                        if (options.projectId) {
-                            const encodedProjectId = encodeURIComponent(options.projectId);
+                        if (projectId) {
+                            const encodedProjectId = encodeURIComponent(projectId);
                             path = `projects/${encodedProjectId}/snippets/${encodedId}`;
                         }
                         else {
                             path = `snippets/${encodedId}`;
                         }
-                        if (options.raw) {
+                        if (raw) {
                             path = `${path}/raw`;
                         }
                         return gitlab_api_1.gitlab.get(path);
                     }
+                    default:
+                        throw new Error(`Unknown action: ${input.action}`);
+                }
+            },
+        },
+    ],
+    [
+        "manage_snippet",
+        {
+            name: "manage_snippet",
+            description: 'MANAGE GitLab snippets. Actions: "create" creates new snippet with multiple files and visibility control, "update" modifies title/description/visibility/files (supports file create/update/delete/move), "delete" permanently removes snippet. Supports personal and project snippets.',
+            inputSchema: z.toJSONSchema(schema_1.ManageSnippetSchema),
+            handler: async (args) => {
+                const input = schema_1.ManageSnippetSchema.parse(args);
+                if ((0, config_1.isActionDenied)("manage_snippet", input.action)) {
+                    throw new Error(`Action '${input.action}' is not allowed for manage_snippet tool`);
+                }
+                switch (input.action) {
                     case "create": {
+                        const { projectId, title, description, visibility, files } = input;
                         const body = {
-                            title: options.title,
-                            visibility: options.visibility,
-                            files: options.files,
+                            title,
+                            visibility,
+                            files,
                         };
-                        if (options.description) {
-                            body.description = options.description;
+                        if (description) {
+                            body.description = description;
                         }
                         let path;
-                        if (options.projectId) {
-                            const encodedProjectId = encodeURIComponent(options.projectId);
+                        if (projectId) {
+                            const encodedProjectId = encodeURIComponent(projectId);
                             path = `projects/${encodedProjectId}/snippets`;
                         }
                         else {
@@ -123,23 +133,24 @@ exports.snippetsToolRegistry = new Map([
                         });
                     }
                     case "update": {
-                        const encodedId = options.id.toString();
+                        const { id, projectId, title, description, visibility, files } = input;
+                        const encodedId = id.toString();
                         const body = {};
-                        if (options.title !== undefined) {
-                            body.title = options.title;
+                        if (title !== undefined) {
+                            body.title = title;
                         }
-                        if (options.description !== undefined) {
-                            body.description = options.description;
+                        if (description !== undefined) {
+                            body.description = description;
                         }
-                        if (options.visibility !== undefined) {
-                            body.visibility = options.visibility;
+                        if (visibility !== undefined) {
+                            body.visibility = visibility;
                         }
-                        if (options.files !== undefined) {
-                            body.files = options.files;
+                        if (files !== undefined) {
+                            body.files = files;
                         }
                         let path;
-                        if (options.projectId) {
-                            const encodedProjectId = encodeURIComponent(options.projectId);
+                        if (projectId) {
+                            const encodedProjectId = encodeURIComponent(projectId);
                             path = `projects/${encodedProjectId}/snippets/${encodedId}`;
                         }
                         else {
@@ -151,27 +162,28 @@ exports.snippetsToolRegistry = new Map([
                         });
                     }
                     case "delete": {
-                        const encodedId = options.id.toString();
+                        const { id, projectId } = input;
+                        const encodedId = id.toString();
                         let path;
-                        if (options.projectId) {
-                            const encodedProjectId = encodeURIComponent(options.projectId);
+                        if (projectId) {
+                            const encodedProjectId = encodeURIComponent(projectId);
                             path = `projects/${encodedProjectId}/snippets/${encodedId}`;
                         }
                         else {
                             path = `snippets/${encodedId}`;
                         }
                         await gitlab_api_1.gitlab.delete(path);
-                        return { deleted: true, id: options.id };
+                        return { deleted: true, id };
                     }
                     default:
-                        throw new Error(`Unknown action: ${options.action}`);
+                        throw new Error(`Unknown action: ${input.action}`);
                 }
             },
         },
     ],
 ]);
 function getSnippetsReadOnlyToolNames() {
-    return ["list_snippets"];
+    return ["browse_snippets"];
 }
 function getSnippetsToolDefinitions() {
     return Array.from(exports.snippetsToolRegistry.values());

package/dist/src/entities/snippets/registry.js.map

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

package/dist/src/entities/snippets/schema-readonly.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
-export declare const ListSnippetsSchema: z.ZodObject<{
+export declare const BrowseSnippetsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"list">;
     scope: z.ZodEnum<{
         project: "project";
         public: "public";
@@ -13,14 +14,12 @@ export declare const ListSnippetsSchema: z.ZodObject<{
     }>>;
     created_after: z.ZodOptional<z.ZodString>;
     created_before: z.ZodOptional<z.ZodString>;
+    per_page: z.ZodOptional<z.ZodNumber>;
     page: z.ZodOptional<z.ZodNumber>;
-    per_page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-}, z.core.$strip>;
-export declare const GetSnippetSchema: z.ZodObject<{
-    action: z.ZodLiteral<"read">;
-    id: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"get">;
+    id: z.ZodPipe<z.ZodTransform<{}, unknown>, z.ZodCoercedString<unknown>>;
     projectId: z.ZodOptional<z.ZodString>;
     raw: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, z.core.$strip>;
-export type ListSnippetsOptions = z.infer<typeof ListSnippetsSchema>;
-export type GetSnippetOptions = z.infer<typeof GetSnippetSchema>;
+}, z.core.$strip>], "action">;
+export type BrowseSnippetsInput = z.infer<typeof BrowseSnippetsSchema>;

package/dist/src/entities/snippets/schema-readonly.js

@@ -1,51 +1,46 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetSnippetSchema = exports.ListSnippetsSchema = void 0;
+exports.BrowseSnippetsSchema = void 0;
 const zod_1 = require("zod");
-const shared_1 = require("../shared");
-const SnippetScopeSchema = zod_1.z.enum(["personal", "project", "public"]);
-exports.ListSnippetsSchema = zod_1.z
-    .object({
-    scope: SnippetScopeSchema.describe('The scope of snippets to list: "personal" for current user snippets, "project" for project-specific snippets, "public" for all public snippets'),
-    projectId: zod_1.z
-        .string()
-        .optional()
-        .describe("Project ID or URL-encoded path (required when scope is 'project'). Example: '123' or 'group/project'"),
-    visibility: zod_1.z
-        .enum(["private", "internal", "public"])
-        .optional()
-        .describe("Filter snippets by visibility level. Private: only author can see. Internal: authenticated users can see. Public: anyone can see"),
+const utils_1 = require("../utils");
+const SnippetScopeSchema = zod_1.z
+    .enum(["personal", "project", "public"])
+    .describe("The scope of snippets");
+const SnippetVisibilitySchema = zod_1.z
+    .enum(["private", "internal", "public"])
+    .describe("Visibility level of snippets");
+const projectIdField = zod_1.z
+    .string()
+    .optional()
+    .describe("Project ID or URL-encoded path (e.g., '123' or 'group/project')");
+const ListSnippetsSchema = zod_1.z.object({
+    action: zod_1.z.literal("list").describe("List snippets with filtering by scope and visibility"),
+    scope: SnippetScopeSchema.describe('Scope of snippets: "personal" for current user, "project" for project-specific (requires projectId), "public" for all public snippets'),
+    projectId: projectIdField.describe("Project ID or URL-encoded path. Required when scope is 'project'"),
+    visibility: SnippetVisibilitySchema.optional().describe("Filter by visibility: private (author only), internal (authenticated users), public (everyone)"),
     created_after: zod_1.z
         .string()
         .optional()
-        .describe("Return snippets created after this date (ISO 8601 format). Example: '2024-01-01T00:00:00Z'"),
+        .describe("Return snippets created after this date (ISO 8601). Example: '2024-01-01T00:00:00Z'"),
     created_before: zod_1.z
         .string()
         .optional()
-        .describe("Return snippets created before this date (ISO 8601 format). Example: '2024-12-31T23:59:59Z'"),
-})
-    .merge(shared_1.PaginationOptionsSchema)
-    .refine(data => data.scope !== "project" || data.projectId, {
-    message: "projectId is required when scope is 'project'",
-    path: ["projectId"],
+        .describe("Return snippets created before this date (ISO 8601). Example: '2024-12-31T23:59:59Z'"),
+    per_page: zod_1.z.number().optional().describe("Number of items per page"),
+    page: zod_1.z.number().optional().describe("Page number"),
 });
-const GetSnippetActionSchema = zod_1.z.literal("read");
-exports.GetSnippetSchema = zod_1.z
-    .object({
-    action: GetSnippetActionSchema.describe("Must be 'read' for retrieving snippet details"),
-    id: zod_1.z.number().int().positive().describe("The ID of the snippet to retrieve"),
-    projectId: zod_1.z
-        .string()
-        .optional()
-        .describe("Project ID or URL-encoded path (required for project snippets). Leave empty for personal snippets"),
+const GetSnippetSchema = zod_1.z.object({
+    action: zod_1.z.literal("get").describe("Get single snippet details or raw content"),
+    id: utils_1.requiredId.describe("The ID of the snippet to retrieve"),
+    projectId: projectIdField.describe("Project ID or URL-encoded path. Required for project snippets, leave empty for personal snippets"),
     raw: zod_1.z
         .boolean()
         .optional()
         .default(false)
-        .describe("Return raw content of the snippet files instead of metadata. Useful for downloading snippet content directly"),
-})
-    .refine(data => !data.projectId || typeof data.projectId === "string", {
-    message: "projectId must be a string when provided",
-    path: ["projectId"],
+        .describe("Return raw content of snippet files instead of metadata"),
 });
+exports.BrowseSnippetsSchema = zod_1.z.discriminatedUnion("action", [
+    ListSnippetsSchema,
+    GetSnippetSchema,
+]);
 //# sourceMappingURL=schema-readonly.js.map

package/dist/src/entities/snippets/schema-readonly.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema-readonly.js","sourceRoot":"","sources":["../../../../src/entities/snippets/schema-readonly.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sCAAoD;AAKpD,MAAM,kBAAkB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGxD,QAAA,kBAAkB,GAAG,OAAC;KAChC,MAAM,CAAC;IACN,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAChC,gJAAgJ,CACjJ;IACD,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sGAAsG,CACvG;IACH,UAAU,EAAE,OAAC;SACV,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;SACvC,QAAQ,EAAE;SACV,QAAQ,CACP,kIAAkI,CACnI;IACH,aAAa,EAAE,OAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,4FAA4F,CAC7F;IACH,cAAc,EAAE,OAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,6FAA6F,CAC9F;CACJ,CAAC;KACD,KAAK,CAAC,gCAAuB,CAAC;KAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE;IAC1D,OAAO,EAAE,+CAA+C;IACxD,IAAI,EAAE,CAAC,WAAW,CAAC;CACpB,CAAC,CAAC;AAGL,MAAM,sBAAsB,GAAG,OAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AAGpC,QAAA,gBAAgB,GAAG,OAAC;KAC9B,MAAM,CAAC;IACN,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACxF,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC7E,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mGAAmG,CACpG;IACH,GAAG,EAAE,OAAC;SACH,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,8GAA8G,CAC/G;CACJ,CAAC;KACD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE;IACrE,OAAO,EAAE,0CAA0C;IACnD,IAAI,EAAE,CAAC,WAAW,CAAC;CACpB,CAAC,CAAC"}
+{"version":3,"file":"schema-readonly.js","sourceRoot":"","sources":["../../../../src/entities/snippets/schema-readonly.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,oCAAsC;AAStC,MAAM,kBAAkB,GAAG,OAAC;KACzB,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;KACvC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;AAErC,MAAM,uBAAuB,GAAG,OAAC;KAC9B,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;KACvC,QAAQ,CAAC,8BAA8B,CAAC,CAAC;AAG5C,MAAM,cAAc,GAAG,OAAC;KACrB,MAAM,EAAE;KACR,QAAQ,EAAE;KACV,QAAQ,CAAC,iEAAiE,CAAC,CAAC;AAG/E,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,OAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IAC1F,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAChC,uIAAuI,CACxI;IACD,SAAS,EAAE,cAAc,CAAC,QAAQ,CAChC,kEAAkE,CACnE;IACD,UAAU,EAAE,uBAAuB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACrD,gGAAgG,CACjG;IACD,aAAa,EAAE,OAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qFAAqF,CACtF;IACH,cAAc,EAAE,OAAC;SACd,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,sFAAsF,CACvF;IACH,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACpE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;CACpD,CAAC,CAAC;AAGH,MAAM,gBAAgB,GAAG,OAAC,CAAC,MAAM,CAAC;IAChC,MAAM,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC9E,EAAE,EAAE,kBAAU,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAC5D,SAAS,EAAE,cAAc,CAAC,QAAQ,CAChC,kGAAkG,CACnG;IACD,GAAG,EAAE,OAAC;SACH,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC,CAAC;AAGU,QAAA,oBAAoB,GAAG,OAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IACjE,kBAAkB;IAClB,gBAAgB;CACjB,CAAC,CAAC"}

package/dist/src/entities/snippets/schema.d.ts

@@ -10,7 +10,7 @@ declare const SnippetFileSchema: z.ZodObject<{
     }>>;
     previous_path: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export declare const CreateSnippetSchema: z.ZodObject<{
+export declare const ManageSnippetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     action: z.ZodLiteral<"create">;
     projectId: z.ZodOptional<z.ZodString>;
     title: z.ZodString;
@@ -24,10 +24,9 @@ export declare const CreateSnippetSchema: z.ZodObject<{
         file_path: z.ZodString;
         content: z.ZodString;
     }, z.core.$strip>>;
-}, z.core.$strip>;
-export declare const UpdateSnippetSchema: z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     action: z.ZodLiteral<"update">;
-    id: z.ZodNumber;
+    id: z.ZodPipe<z.ZodTransform<{}, unknown>, z.ZodCoercedString<unknown>>;
     projectId: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
@@ -47,14 +46,11 @@ export declare const UpdateSnippetSchema: z.ZodObject<{
         }>>;
         previous_path: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
-}, z.core.$strip>;
-export declare const DeleteSnippetSchema: z.ZodObject<{
+}, z.core.$strip>, z.ZodObject<{
     action: z.ZodLiteral<"delete">;
-    id: z.ZodNumber;
+    id: z.ZodPipe<z.ZodTransform<{}, unknown>, z.ZodCoercedString<unknown>>;
     projectId: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type CreateSnippetOptions = z.infer<typeof CreateSnippetSchema>;
-export type UpdateSnippetOptions = z.infer<typeof UpdateSnippetSchema>;
-export type DeleteSnippetOptions = z.infer<typeof DeleteSnippetSchema>;
+}, z.core.$strip>], "action">;
+export type ManageSnippetInput = z.infer<typeof ManageSnippetSchema>;
 export type SnippetFile = z.infer<typeof SnippetFileSchema>;
 export {};

package/dist/src/entities/snippets/schema.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeleteSnippetSchema = exports.UpdateSnippetSchema = exports.CreateSnippetSchema = void 0;
+exports.ManageSnippetSchema = void 0;
 const zod_1 = require("zod");
+const utils_1 = require("../utils");
 const flexibleVisibility = zod_1.z.preprocess(val => {
     if (typeof val === "string") {
         const normalized = val.toLowerCase().trim();
@@ -25,7 +26,7 @@ const SnippetFileSchema = zod_1.z.object({
     content: zod_1.z
         .string()
         .optional()
-        .describe("The content of the file. Required for 'create' and 'update' actions. Can be empty string for placeholder files. For binary content, use base64 encoding"),
+        .describe("The content of the file. Required for 'create' and 'update' actions. Can be empty string for placeholder files"),
     action: zod_1.z
         .enum(["create", "update", "delete", "move"])
         .optional()
@@ -35,89 +36,54 @@ const SnippetFileSchema = zod_1.z.object({
         .optional()
         .describe("Original file path when using 'move' action to rename a file. Must match an existing file in the snippet"),
 });
-const CreateSnippetActionSchema = zod_1.z.literal("create");
-exports.CreateSnippetSchema = zod_1.z
-    .object({
-    action: CreateSnippetActionSchema.describe("Must be 'create' for creating a new snippet"),
-    projectId: zod_1.z
-        .string()
-        .optional()
-        .describe("Project ID or URL-encoded path to create a project snippet. Leave empty for a personal snippet"),
+const projectIdField = zod_1.z
+    .string()
+    .optional()
+    .describe("Project ID or URL-encoded path. Leave empty for personal snippets");
+const CreateSnippetSchema = zod_1.z.object({
+    action: zod_1.z.literal("create").describe("Create a new snippet with one or more files"),
+    projectId: projectIdField.describe("Project ID or URL-encoded path to create a project snippet. Leave empty for personal snippet"),
     title: zod_1.z
         .string()
         .min(1)
         .max(255)
-        .describe("The title of the snippet. This is displayed in the snippet list and as the page title. Maximum 255 characters"),
+        .describe("The title of the snippet. Displayed in snippet list and as page title. Max 255 chars"),
     description: zod_1.z
         .string()
         .optional()
-        .describe("Optional description explaining the purpose of the snippet. Supports markdown formatting"),
+        .describe("Optional description explaining the snippet purpose. Supports markdown"),
     visibility: flexibleVisibility
         .optional()
         .default("private")
-        .describe("Visibility level: 'private' (only author), 'internal' (authenticated users), or 'public' (everyone). Defaults to 'private'"),
+        .describe("Visibility: 'private' (author only), 'internal' (authenticated users), 'public' (everyone). Defaults to 'private'"),
     files: zod_1.z
         .array(zod_1.z.object({
         file_path: zod_1.z.string().min(1),
         content: zod_1.z.string(),
     }))
         .min(1)
-        .describe("Array of files to include in the snippet. At least one file is required. Each file needs file_path and content"),
-})
-    .refine(data => data.files.length > 0, {
-    message: "At least one file is required",
-    path: ["files"],
+        .describe("Array of files to include. At least one file required. Each needs file_path and content"),
 });
-const UpdateSnippetActionSchema = zod_1.z.literal("update");
-exports.UpdateSnippetSchema = zod_1.z
-    .object({
-    action: UpdateSnippetActionSchema.describe("Must be 'update' for updating an existing snippet"),
-    id: zod_1.z
-        .number()
-        .int()
-        .positive()
-        .describe("The ID of the snippet to update. Must be an existing snippet"),
-    projectId: zod_1.z
-        .string()
-        .optional()
-        .describe("Project ID or URL-encoded path (required for project snippets). Leave empty for personal snippets"),
-    title: zod_1.z
-        .string()
-        .min(1)
-        .max(255)
-        .optional()
-        .describe("Update the title of the snippet. Maximum 255 characters"),
-    description: zod_1.z
-        .string()
-        .optional()
-        .describe("Update the description of the snippet. Supports markdown formatting"),
-    visibility: flexibleVisibility
-        .optional()
-        .describe("Update the visibility level of the snippet"),
+const UpdateSnippetSchema = zod_1.z.object({
+    action: zod_1.z.literal("update").describe("Update an existing snippet metadata or files"),
+    id: utils_1.requiredId.describe("The ID of the snippet to update"),
+    projectId: projectIdField.describe("Project ID or URL-encoded path. Required for project snippets, leave empty for personal"),
+    title: zod_1.z.string().min(1).max(255).optional().describe("Update the snippet title. Max 255 chars"),
+    description: zod_1.z.string().optional().describe("Update the snippet description. Supports markdown"),
+    visibility: flexibleVisibility.optional().describe("Update the visibility level"),
     files: zod_1.z
         .array(SnippetFileSchema)
         .optional()
-        .describe("Array of file operations to perform. Each file must specify an 'action': 'create' (add new file), 'update' (modify existing), 'delete' (remove file), or 'move' (rename file with previous_path)"),
-})
-    .refine(data => {
-    return (data.title !== undefined ||
-        data.description !== undefined ||
-        data.visibility !== undefined ||
-        (data.files !== undefined && data.files.length > 0));
-}, {
-    message: "At least one field must be provided to update (title, description, visibility, or files)",
+        .describe("Array of file operations. Each file must specify 'action': create/update/delete/move. Move requires previous_path"),
 });
-const DeleteSnippetActionSchema = zod_1.z.literal("delete");
-exports.DeleteSnippetSchema = zod_1.z.object({
-    action: DeleteSnippetActionSchema.describe("Must be 'delete' for deleting a snippet"),
-    id: zod_1.z
-        .number()
-        .int()
-        .positive()
-        .describe("The ID of the snippet to delete. This operation is permanent and cannot be undone"),
-    projectId: zod_1.z
-        .string()
-        .optional()
-        .describe("Project ID or URL-encoded path (required for project snippets). Leave empty for personal snippets"),
+const DeleteSnippetSchema = zod_1.z.object({
+    action: zod_1.z.literal("delete").describe("Permanently delete a snippet"),
+    id: utils_1.requiredId.describe("The ID of the snippet to delete. This operation cannot be undone"),
+    projectId: projectIdField.describe("Project ID or URL-encoded path. Required for project snippets, leave empty for personal"),
 });
+exports.ManageSnippetSchema = zod_1.z.discriminatedUnion("action", [
+    CreateSnippetSchema,
+    UpdateSnippetSchema,
+    DeleteSnippetSchema,
+]);
 //# sourceMappingURL=schema.js.map

package/dist/src/entities/snippets/schema.js.map

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

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

@@ -42,7 +42,7 @@ const schema_readonly_1 = require("./schema-readonly");
 const schema_1 = require("./schema");
 const gitlab_api_1 = require("../../utils/gitlab-api");
 const namespace_1 = require("../../utils/namespace");
-const utils_1 = require("../utils");
+const config_1 = require("../../config");
 exports.variablesToolRegistry = new Map([
     [
         "browse_variables",
@@ -52,15 +52,17 @@ exports.variablesToolRegistry = new Map([
             inputSchema: z.toJSONSchema(schema_readonly_1.BrowseVariablesSchema),
             handler: async (args) => {
                 const input = schema_readonly_1.BrowseVariablesSchema.parse(args);
+                if ((0, config_1.isActionDenied)("browse_variables", input.action)) {
+                    throw new Error(`Action '${input.action}' is not allowed for browse_variables tool`);
+                }
                 const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(input.namespace);
                 switch (input.action) {
                     case "list": {
-                        const { action: _action, namespace: _namespace, key: _key, filter: _filter, ...rest } = input;
+                        const { action: _action, namespace: _namespace, ...rest } = input;
                         const query = (0, gitlab_api_1.toQuery)(rest, []);
                         return gitlab_api_1.gitlab.get(`${entityType}/${encodedPath}/variables`, { query });
                     }
                     case "get": {
-                        (0, utils_1.assertDefined)(input.key, "key");
                         const query = {};
                         if (input.filter?.environment_scope) {
                             query["filter[environment_scope]"] = input.filter.environment_scope;
@@ -81,11 +83,13 @@ exports.variablesToolRegistry = new Map([
             inputSchema: z.toJSONSchema(schema_1.ManageVariableSchema),
             handler: async (args) => {
                 const input = schema_1.ManageVariableSchema.parse(args);
+                if ((0, config_1.isActionDenied)("manage_variable", input.action)) {
+                    throw new Error(`Action '${input.action}' is not allowed for manage_variable tool`);
+                }
                 const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(input.namespace);
                 switch (input.action) {
                     case "create": {
-                        (0, utils_1.assertDefined)(input.value, "value");
-                        const { action: _action, namespace: _namespace, filter: _filter, ...body } = input;
+                        const { action: _action, namespace: _namespace, ...body } = input;
                         return gitlab_api_1.gitlab.post(`${entityType}/${encodedPath}/variables`, {
                             body,
                             contentType: "json",