@structured-world/gitlab-mcp 6.5.0 → 6.7.0

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

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteSnippetSchema = exports.UpdateSnippetSchema = exports.CreateSnippetSchema = void 0;
+const zod_1 = require("zod");
+const flexibleVisibility = zod_1.z.preprocess(val => {
+    if (typeof val === "string") {
+        const normalized = val.toLowerCase().trim();
+        if (["private", "priv"].includes(normalized)) {
+            return "private";
+        }
+        if (["internal", "intern"].includes(normalized)) {
+            return "internal";
+        }
+        if (["public", "pub"].includes(normalized)) {
+            return "public";
+        }
+    }
+    return val;
+}, zod_1.z.enum(["private", "internal", "public"]));
+const SnippetFileSchema = zod_1.z.object({
+    file_path: zod_1.z
+        .string()
+        .min(1)
+        .describe("The path/name of the file within the snippet. Can include subdirectories (e.g., 'src/main.py'). Must be unique within the snippet"),
+    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"),
+    action: zod_1.z
+        .enum(["create", "update", "delete", "move"])
+        .optional()
+        .describe("Action to perform on the file (only for update operations): 'create' adds a new file, 'update' modifies existing file, 'delete' removes file, 'move' renames file (requires previous_path)"),
+    previous_path: zod_1.z
+        .string()
+        .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"),
+    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"),
+    description: zod_1.z
+        .string()
+        .optional()
+        .describe("Optional description explaining the purpose of the snippet. Supports markdown formatting"),
+    visibility: flexibleVisibility
+        .optional()
+        .default("private")
+        .describe("Visibility level: 'private' (only author), 'internal' (authenticated users), or '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"],
+});
+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"),
+    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)",
+});
+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"),
+});
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"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,103 +42,84 @@ 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");
 exports.variablesToolRegistry = new Map([
     [
-        "list_variables",
+        "browse_variables",
         {
-            name: "list_variables",
-            description: "View all CI/CD environment variables configured for pipelines. Use to audit secrets, review configuration, or understand pipeline environment. Shows variable keys (values are masked for security). Returns protection status, masking, and environment scopes. Group variables are inherited by all projects.",
-            inputSchema: z.toJSONSchema(schema_readonly_1.ListVariablesSchema),
+            name: "browse_variables",
+            description: 'BROWSE CI/CD variables. Actions: "list" shows all variables in project/group with pagination, "get" retrieves single variable details by key with optional environment scope filter.',
+            inputSchema: z.toJSONSchema(schema_readonly_1.BrowseVariablesSchema),
             handler: async (args) => {
-                const options = schema_readonly_1.ListVariablesSchema.parse(args);
-                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(options.namespace);
-                return gitlab_api_1.gitlab.get(`${entityType}/${encodedPath}/variables`, {
-                    query: (0, gitlab_api_1.toQuery)(options, ["namespace"]),
-                });
-            },
-        },
-    ],
-    [
-        "get_variable",
-        {
-            name: "get_variable",
-            description: "Retrieve specific CI/CD variable details including value (if not masked), type, and security settings. Use for debugging pipeline issues, verifying configuration, or checking environment-specific values. Supports scoped variables for different environments (production/staging).",
-            inputSchema: z.toJSONSchema(schema_readonly_1.GetVariableSchema),
-            handler: async (args) => {
-                const options = schema_readonly_1.GetVariableSchema.parse(args);
-                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(options.namespace);
-                const query = {};
-                if (options.filter?.environment_scope) {
-                    query["filter[environment_scope]"] = options.filter.environment_scope;
-                }
-                return gitlab_api_1.gitlab.get(`${entityType}/${encodedPath}/variables/${encodeURIComponent(options.key)}`, {
-                    query,
-                });
-            },
-        },
-    ],
-    [
-        "create_variable",
-        {
-            name: "create_variable",
-            description: "Add new CI/CD environment variable for pipeline configuration, secrets, or deployment settings. Use for API keys, database URLs, feature flags. Supports masking sensitive values, protection for specific branches, environment scoping, and file type for certificates/configs. Group variables apply to all child projects.",
-            inputSchema: z.toJSONSchema(schema_1.CreateVariableSchema),
-            handler: async (args) => {
-                const options = schema_1.CreateVariableSchema.parse(args);
-                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(options.namespace);
-                const { namespace: _namespace, ...body } = options;
-                return gitlab_api_1.gitlab.post(`${entityType}/${encodedPath}/variables`, {
-                    body,
-                    contentType: "json",
-                });
-            },
-        },
-    ],
-    [
-        "update_variable",
-        {
-            name: "update_variable",
-            description: "Modify CI/CD variable value or configuration. Use to rotate secrets, update endpoints, change security settings, or adjust environment scopes. Can convert between env_var and file types. Changes take effect in next pipeline run. Be cautious with production variables.",
-            inputSchema: z.toJSONSchema(schema_1.UpdateVariableSchema),
-            handler: async (args) => {
-                const options = schema_1.UpdateVariableSchema.parse(args);
-                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(options.namespace);
-                const { namespace: _namespace, key, filter, ...body } = options;
-                const query = {};
-                if (filter?.environment_scope) {
-                    query["filter[environment_scope]"] = filter.environment_scope;
+                const input = schema_readonly_1.BrowseVariablesSchema.parse(args);
+                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 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;
+                        }
+                        return gitlab_api_1.gitlab.get(`${entityType}/${encodedPath}/variables/${encodeURIComponent(input.key)}`, { query });
+                    }
+                    default:
+                        throw new Error(`Unknown action: ${input.action}`);
                 }
-                return gitlab_api_1.gitlab.put(`${entityType}/${encodedPath}/variables/${encodeURIComponent(key)}`, {
-                    query,
-                    body,
-                    contentType: "json",
-                });
             },
         },
     ],
     [
-        "delete_variable",
+        "manage_variable",
         {
-            name: "delete_variable",
-            description: "Delete CI/CD variable permanently from configuration. Use to remove unused secrets, clean up after migrations, or revoke access. Can target specific environment-scoped variants. Warning: may break pipelines depending on the variable. Cannot be undone.",
-            inputSchema: z.toJSONSchema(schema_1.DeleteVariableSchema),
+            name: "manage_variable",
+            description: 'MANAGE CI/CD variables. Actions: "create" adds new variable (requires key and value), "update" modifies existing variable, "delete" removes variable permanently. Supports environment scoping and protection settings.',
+            inputSchema: z.toJSONSchema(schema_1.ManageVariableSchema),
             handler: async (args) => {
-                const options = schema_1.DeleteVariableSchema.parse(args);
-                const { entityType, encodedPath } = await (0, namespace_1.resolveNamespaceForAPI)(options.namespace);
-                const query = {};
-                if (options.filter?.environment_scope) {
-                    query["filter[environment_scope]"] = options.filter.environment_scope;
+                const input = schema_1.ManageVariableSchema.parse(args);
+                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;
+                        return gitlab_api_1.gitlab.post(`${entityType}/${encodedPath}/variables`, {
+                            body,
+                            contentType: "json",
+                        });
+                    }
+                    case "update": {
+                        const { action: _action, namespace: _namespace, key, filter, ...body } = input;
+                        const query = {};
+                        if (filter?.environment_scope) {
+                            query["filter[environment_scope]"] = filter.environment_scope;
+                        }
+                        return gitlab_api_1.gitlab.put(`${entityType}/${encodedPath}/variables/${encodeURIComponent(key)}`, {
+                            query,
+                            body,
+                            contentType: "json",
+                        });
+                    }
+                    case "delete": {
+                        const query = {};
+                        if (input.filter?.environment_scope) {
+                            query["filter[environment_scope]"] = input.filter.environment_scope;
+                        }
+                        await gitlab_api_1.gitlab.delete(`${entityType}/${encodedPath}/variables/${encodeURIComponent(input.key)}`, { query });
+                        return { deleted: true };
+                    }
+                    default:
+                        throw new Error(`Unknown action: ${input.action}`);
                 }
-                await gitlab_api_1.gitlab.delete(`${entityType}/${encodedPath}/variables/${encodeURIComponent(options.key)}`, {
-                    query,
-                });
-                return { deleted: true };
             },
         },
     ],
 ]);
 function getVariablesReadOnlyToolNames() {
-    return ["list_variables", "get_variable"];
+    return ["browse_variables"];
 }
 function getVariablesToolDefinitions() {
     return Array.from(exports.variablesToolRegistry.values());

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

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/entities/variables/registry.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6HA,sEAEC;AAED,kEAEC;AAED,8DAQC;AA7ID,uCAAyB;AACzB,uDAA2E;AAC3E,qCAA4F;AAC5F,uDAAyD;AACzD,qDAA+D;AAMlD,QAAA,qBAAqB,GAAiB,IAAI,GAAG,CAAiC;IACzF;QACE,gBAAgB;QAChB;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,iTAAiT;YACnT,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,qCAAmB,CAAC;YAChD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,OAAO,GAAG,qCAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChD,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,IAAA,kCAAsB,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAEpF,OAAO,mBAAM,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,WAAW,YAAY,EAAE;oBAC1D,KAAK,EAAE,IAAA,oBAAO,EAAC,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC;iBACvC,CAAC,CAAC;YACL,CAAC;SACF;KACF;IACD;QACE,cAAc;QACd;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,wRAAwR;YAC1R,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,mCAAiB,CAAC;YAC9C,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,OAAO,GAAG,mCAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC9C,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,IAAA,kCAAsB,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAEpF,MAAM,KAAK,GAAuC,EAAE,CAAC;gBACrD,IAAI,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;oBACtC,KAAK,CAAC,2BAA2B,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC;gBACxE,CAAC;gBAED,OAAO,mBAAM,CAAC,GAAG,CACf,GAAG,UAAU,IAAI,WAAW,cAAc,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAC3E;oBACE,KAAK;iBACN,CACF,CAAC;YACJ,CAAC;SACF;KACF;IACD;QACE,iBAAiB;QACjB;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,gUAAgU;YAClU,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,6BAAoB,CAAC;YACjD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,OAAO,GAAG,6BAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjD,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,IAAA,kCAAsB,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACpF,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;gBAEnD,OAAO,mBAAM,CAAC,IAAI,CAAC,GAAG,UAAU,IAAI,WAAW,YAAY,EAAE;oBAC3D,IAAI;oBACJ,WAAW,EAAE,MAAM;iBACpB,CAAC,CAAC;YACL,CAAC;SACF;KACF;IACD;QACE,iBAAiB;QACjB;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,6QAA6Q;YAC/Q,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,6BAAoB,CAAC;YACjD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,OAAO,GAAG,6BAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjD,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,IAAA,kCAAsB,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACpF,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;gBAEhE,MAAM,KAAK,GAAuC,EAAE,CAAC;gBACrD,IAAI,MAAM,EAAE,iBAAiB,EAAE,CAAC;oBAC9B,KAAK,CAAC,2BAA2B,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC;gBAChE,CAAC;gBAED,OAAO,mBAAM,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,WAAW,cAAc,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE;oBACrF,KAAK;oBACL,IAAI;oBACJ,WAAW,EAAE,MAAM;iBACpB,CAAC,CAAC;YACL,CAAC;SACF;KACF;IACD;QACE,iBAAiB;QACjB;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,6PAA6P;YAC/P,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,6BAAoB,CAAC;YACjD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;gBAC/B,MAAM,OAAO,GAAG,6BAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjD,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,IAAA,kCAAsB,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAEpF,MAAM,KAAK,GAAuC,EAAE,CAAC;gBACrD,IAAI,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC;oBACtC,KAAK,CAAC,2BAA2B,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC;gBACxE,CAAC;gBAED,MAAM,mBAAM,CAAC,MAAM,CACjB,GAAG,UAAU,IAAI,WAAW,cAAc,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAC3E;oBACE,KAAK;iBACN,CACF,CAAC;gBACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC3B,CAAC;SACF;KACF;CACF,CAAC,CAAC;AAEH,SAAgB,6BAA6B;IAC3C,OAAO,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;AAC5C,CAAC;AAED,SAAgB,2BAA2B;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,6BAAqB,CAAC,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,yBAAyB,CAAC,eAAwB,KAAK;IACrE,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,aAAa,GAAG,6BAA6B,EAAE,CAAC;QACtD,OAAO,KAAK,CAAC,IAAI,CAAC,6BAAqB,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAC9D,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAClC,CAAC;IACJ,CAAC;IACD,OAAO,2BAA2B,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/entities/variables/registry.ts"],"names":[],"mappings":"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"}

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

@@ -1,15 +1,15 @@
 import { z } from "zod";
-export declare const ListVariablesSchema: z.ZodObject<{
+export declare const BrowseVariablesSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        list: "list";
+        get: "get";
+    }>;
     namespace: z.ZodString;
-    page: z.ZodOptional<z.ZodNumber>;
-    per_page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-}, z.core.$strip>;
-export declare const GetVariableSchema: z.ZodObject<{
-    namespace: z.ZodString;
-    key: z.ZodString;
+    key: z.ZodOptional<z.ZodString>;
     filter: z.ZodOptional<z.ZodObject<{
         environment_scope: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    per_page: z.ZodOptional<z.ZodNumber>;
+    page: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
-export type ListVariablesOptions = z.infer<typeof ListVariablesSchema>;
-export type GetVariableOptions = z.infer<typeof GetVariableSchema>;
+export type BrowseVariablesInput = z.infer<typeof BrowseVariablesSchema>;

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

@@ -1,26 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetVariableSchema = exports.ListVariablesSchema = void 0;
+exports.BrowseVariablesSchema = void 0;
 const zod_1 = require("zod");
-const shared_1 = require("../shared");
-exports.ListVariablesSchema = zod_1.z
+exports.BrowseVariablesSchema = zod_1.z
     .object({
-    namespace: zod_1.z.string().describe("Namespace path (group or project) to list variables from"),
-})
-    .merge(shared_1.PaginationOptionsSchema);
-exports.GetVariableSchema = zod_1.z.object({
-    namespace: zod_1.z.string().describe("Namespace path (group or project) containing the variable"),
+    action: zod_1.z.enum(["list", "get"]).describe("Action to perform"),
+    namespace: zod_1.z.string().describe("Namespace path (group or project)"),
     key: zod_1.z
         .string()
-        .describe("The key of the CI/CD variable. Maximum 255 characters, alphanumeric and underscore only"),
+        .optional()
+        .describe("The key of the CI/CD variable. Required for 'get' action. Maximum 255 characters, alphanumeric and underscore only."),
     filter: zod_1.z
         .object({
         environment_scope: zod_1.z
             .string()
             .optional()
-            .describe('The environment scope filter for the variable. Use "*" for all environments or specific environment name'),
+            .describe('The environment scope filter. Use "*" for all environments or specific environment name like "production".'),
     })
         .optional()
-        .describe("Filter parameters for the variable lookup"),
+        .describe("Filter parameters for variable lookup (for 'get' action)"),
+    per_page: zod_1.z.number().optional().describe("Number of items per page"),
+    page: zod_1.z.number().optional().describe("Page number"),
+})
+    .refine(data => data.action !== "get" || data.key !== undefined, {
+    message: "key is required for 'get' action",
+    path: ["key"],
 });
 //# sourceMappingURL=schema-readonly.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema-readonly.js","sourceRoot":"","sources":["../../../../src/entities/variables/schema-readonly.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sCAAoD;AAKvC,QAAA,mBAAmB,GAAG,OAAC;KACjC,MAAM,CAAC;IACN,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;CAC3F,CAAC;KACD,KAAK,CAAC,gCAAuB,CAAC,CAAC;AAGrB,QAAA,iBAAiB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;IAC3F,GAAG,EAAE,OAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,yFAAyF,CAC1F;IACH,MAAM,EAAE,OAAC;SACN,MAAM,CAAC;QACN,iBAAiB,EAAE,OAAC;aACjB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,0GAA0G,CAC3G;KACJ,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,2CAA2C,CAAC;CACzD,CAAC,CAAC"}
+{"version":3,"file":"schema-readonly.js","sourceRoot":"","sources":["../../../../src/entities/variables/schema-readonly.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AASX,QAAA,qBAAqB,GAAG,OAAC;KACnC,MAAM,CAAC;IACN,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC7D,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAEnE,GAAG,EAAE,OAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,qHAAqH,CACtH;IAEH,MAAM,EAAE,OAAC;SACN,MAAM,CAAC;QACN,iBAAiB,EAAE,OAAC;aACjB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,4GAA4G,CAC7G;KACJ,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;IAEvE,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;KACD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE;IAC/D,OAAO,EAAE,kCAAkC;IAC3C,IAAI,EAAE,CAAC,KAAK,CAAC;CACd,CAAC,CAAC"}

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

@@ -1,22 +1,13 @@
 import { z } from "zod";
-export declare const CreateVariableSchema: z.ZodObject<{
-    namespace: z.ZodString;
-    key: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>;
-    value: z.ZodString;
-    variable_type: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
-        file: "file";
-        env_var: "env_var";
-    }>>>>;
-    environment_scope: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    protected: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>>>;
-    masked: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>>>;
-    raw: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodTransform<boolean, unknown>, z.ZodBoolean>>>;
-    description: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const UpdateVariableSchema: z.ZodObject<{
+export declare const ManageVariableSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        create: "create";
+        update: "update";
+        delete: "delete";
+    }>;
     namespace: z.ZodString;
     key: z.ZodString;
-    value: z.ZodString;
+    value: z.ZodOptional<z.ZodString>;
     variable_type: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
         file: "file";
         env_var: "env_var";
@@ -30,13 +21,4 @@ export declare const UpdateVariableSchema: z.ZodObject<{
         environment_scope: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-export declare const DeleteVariableSchema: z.ZodObject<{
-    namespace: z.ZodString;
-    key: z.ZodString;
-    filter: z.ZodOptional<z.ZodObject<{
-        environment_scope: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type CreateVariableOptions = z.infer<typeof CreateVariableSchema>;
-export type UpdateVariableOptions = z.infer<typeof UpdateVariableSchema>;
-export type DeleteVariableOptions = z.infer<typeof DeleteVariableSchema>;
+export type ManageVariableInput = z.infer<typeof ManageVariableSchema>;

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DeleteVariableSchema = exports.UpdateVariableSchema = exports.CreateVariableSchema = void 0;
+exports.ManageVariableSchema = void 0;
 const zod_1 = require("zod");
 const utils_1 = require("../utils");
 const flexibleVariableType = zod_1.z.preprocess(val => {
@@ -15,98 +15,49 @@ const flexibleVariableType = zod_1.z.preprocess(val => {
     }
     return val;
 }, zod_1.z.enum(["env_var", "file"]));
-const variableKey = zod_1.z.preprocess(val => {
-    if (typeof val === "string") {
-        return val.trim().replace(/[^a-zA-Z0-9_]/g, "");
-    }
-    return val;
-}, zod_1.z
-    .string()
-    .max(255)
-    .regex(/^[a-zA-Z0-9_]+$/, "Key must contain only alphanumeric characters and underscores"));
-exports.CreateVariableSchema = zod_1.z.object({
-    namespace: zod_1.z.string().describe("Namespace path (group or project) to create variable in"),
-    key: variableKey.describe("The unique key for the CI/CD variable. Maximum 255 characters, only alphanumeric and underscore characters allowed. Used to reference the variable in CI/CD pipelines (e.g., $MY_API_KEY)"),
-    value: zod_1.z
-        .string()
-        .describe("The value of the CI/CD variable. This is the actual content that will be available in your CI/CD pipeline. For file type variables, this should be the file content"),
-    variable_type: flexibleVariableType
-        .optional()
-        .default("env_var")
-        .describe('The type of variable: "env_var" for environment variables (default) or "file" for file variables. File variables create temporary files with the variable content during pipeline execution'),
-    environment_scope: zod_1.z
-        .string()
-        .optional()
-        .default("*")
-        .describe('The environment scope for this variable. Use "*" for all environments (default), or specify environment names like "production", "staging", "review/*" for environment-specific values'),
-    protected: utils_1.flexibleBoolean
-        .optional()
-        .default(false)
-        .describe("Whether this variable is protected. Protected variables are only available to protected branches/tags (typically main/master). Enhances security for sensitive production variables"),
-    masked: utils_1.flexibleBoolean
-        .optional()
-        .default(false)
-        .describe("Whether this variable should be masked in job logs. MASKING REQUIREMENTS: Value must be (1) at least 8 characters, (2) single line with NO SPACES, (3) contain only these characters: A-Z a-z 0-9 + / = . ~ - _ @ : (tested on GitLab 18.4.0). FORBIDDEN characters include: spaces, commas, dollar signs, most special symbols. Common API keys, tokens, and UUIDs typically work. If masking fails with 400 error, set masked=false."),
-    raw: utils_1.flexibleBoolean
-        .optional()
-        .default(false)
-        .describe("Whether variable expansion is disabled. When true, variables like $OTHER_VAR in the value will NOT be expanded/substituted. Useful for values containing literal dollar signs"),
-    description: zod_1.z
-        .string()
-        .optional()
-        .describe("Optional description explaining the purpose and usage of this variable. Helps team members understand what this variable is for and how it should be used (Available in GitLab 16.2+)"),
-});
-exports.UpdateVariableSchema = zod_1.z.object({
-    namespace: zod_1.z.string().describe("Namespace path (group or project) containing the variable"),
+exports.ManageVariableSchema = zod_1.z
+    .object({
+    action: zod_1.z.enum(["create", "update", "delete"]).describe("Action to perform"),
+    namespace: zod_1.z.string().describe("Namespace path (group or project)"),
     key: zod_1.z
         .string()
-        .describe("The key of the existing CI/CD variable to update. Must match an existing variable key exactly"),
+        .describe("The key of the CI/CD variable. Maximum 255 characters, only alphanumeric and underscore characters allowed."),
     value: zod_1.z
         .string()
-        .describe("The new value for the CI/CD variable. This will replace the current value completely"),
+        .optional()
+        .describe("The value of the CI/CD variable. Required for 'create' action. For file type variables, this is the file content."),
     variable_type: flexibleVariableType
         .optional()
-        .describe('Update the variable type: "env_var" for environment variables or "file" for file variables. Changing type may affect how the variable is used in pipelines'),
+        .describe('The type of variable: "env_var" for environment variables (default) or "file" for file variables.'),
     environment_scope: zod_1.z
         .string()
         .optional()
-        .describe('Update the environment scope. Use "*" for all environments, or specify environment names. Changing scope may create a new variable instance'),
+        .describe('The environment scope. Use "*" for all environments (default), or specify like "production", "staging".'),
     protected: utils_1.flexibleBoolean
         .optional()
-        .describe("Update the protected status. Protected variables are only available to protected branches/tags for enhanced security"),
+        .describe("Whether this variable is protected. Protected variables are only available to protected branches/tags."),
     masked: utils_1.flexibleBoolean
         .optional()
-        .describe("Update the masked status. MASKING REQUIREMENTS: If enabling, value must be (1) at least 8 characters, (2) single line with NO SPACES, (3) contain only these characters: A-Z a-z 0-9 + / = . ~ - _ @ : (tested on GitLab 18.4.0). FORBIDDEN: spaces, commas, dollar signs. If current value has forbidden characters, this will fail with 400 error."),
+        .describe("Whether this variable should be masked in job logs. MASKING REQUIREMENTS: Value must be at least 8 characters, single line with no spaces, only A-Z a-z 0-9 + / = . ~ - _ @ : characters."),
     raw: utils_1.flexibleBoolean
         .optional()
-        .describe("Update the raw status. When true, disables variable expansion (no substitution of $OTHER_VAR patterns)"),
+        .describe("Whether variable expansion is disabled. When true, variables like $OTHER_VAR in the value will NOT be expanded."),
     description: zod_1.z
         .string()
         .optional()
-        .describe("Update the description of this variable to help team members understand its purpose (Available in GitLab 16.2+)"),
-    filter: zod_1.z
-        .object({
-        environment_scope: zod_1.z
-            .string()
-            .optional()
-            .describe("Filter to specify which environment scope variant to update when multiple variables exist with the same key"),
-    })
-        .optional()
-        .describe("Filter parameters to identify the specific variable to update"),
-});
-exports.DeleteVariableSchema = zod_1.z.object({
-    namespace: zod_1.z.string().describe("Namespace path (group or project) containing the variable"),
-    key: zod_1.z
-        .string()
-        .describe("The key of the CI/CD variable to delete. This will permanently remove the variable from the project"),
+        .describe("Optional description explaining the purpose of this variable (GitLab 16.2+)."),
     filter: zod_1.z
         .object({
         environment_scope: zod_1.z
             .string()
             .optional()
-            .describe('Filter to specify which environment scope variant to delete when multiple variables exist with the same key. If not specified, deletes the "*" (all environments) variant'),
+            .describe("Filter to specify which environment scope variant to update/delete when multiple variables exist with the same key."),
     })
         .optional()
-        .describe("Filter parameters to identify the specific variable to delete"),
+        .describe("Filter parameters to identify the specific variable (for 'update' and 'delete' actions)"),
+})
+    .refine(data => data.action !== "create" || data.value !== undefined, {
+    message: "value is required for 'create' action",
+    path: ["value"],
 });
 //# sourceMappingURL=schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/entities/variables/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/entities/variables/schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,oCAA2C;AAU3C,MAAM,oBAAoB,GAAG,OAAC,CAAC,UAAU,CACvC,GAAG,CAAC,EAAE;IACJ,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9E,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9C,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,EACD,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAC5B,CAAC;AAEW,QAAA,oBAAoB,GAAG,OAAC;KAClC,MAAM,CAAC;IACN,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC5E,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAEnE,GAAG,EAAE,OAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,6GAA6G,CAC9G;IAEH,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mHAAmH,CACpH;IACH,aAAa,EAAE,oBAAoB;SAChC,QAAQ,EAAE;SACV,QAAQ,CACP,mGAAmG,CACpG;IACH,iBAAiB,EAAE,OAAC;SACjB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,yGAAyG,CAC1G;IACH,SAAS,EAAE,uBAAe;SACvB,QAAQ,EAAE;SACV,QAAQ,CACP,wGAAwG,CACzG;IACH,MAAM,EAAE,uBAAe;SACpB,QAAQ,EAAE;SACV,QAAQ,CACP,2LAA2L,CAC5L;IACH,GAAG,EAAE,uBAAe;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,iHAAiH,CAClH;IACH,WAAW,EAAE,OAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;IAE3F,MAAM,EAAE,OAAC;SACN,MAAM,CAAC;QACN,iBAAiB,EAAE,OAAC;aACjB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,qHAAqH,CACtH;KACJ,CAAC;SACD,QAAQ,EAAE;SACV,QAAQ,CACP,yFAAyF,CAC1F;CACJ,CAAC;KACD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE;IACpE,OAAO,EAAE,uCAAuC;IAChD,IAAI,EAAE,CAAC,OAAO,CAAC;CAChB,CAAC,CAAC"}