npm - @structured-world/gitlab-mcp - Versions diffs - 6.6.0 → 6.7.0 - Mend

@structured-world/gitlab-mcp 6.6.0 → 6.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

package/README.md +22 -3
package/dist/src/config.d.ts +1 -0
package/dist/src/config.js +2 -1
package/dist/src/config.js.map +1 -1
package/dist/src/entities/snippets/index.d.ts +7 -0
package/dist/src/entities/snippets/index.js +31 -0
package/dist/src/entities/snippets/index.js.map +1 -0
package/dist/src/entities/snippets/registry.d.ts +5 -0
package/dist/src/entities/snippets/registry.js +186 -0
package/dist/src/entities/snippets/registry.js.map +1 -0
package/dist/src/entities/snippets/schema-readonly.d.ts +26 -0
package/dist/src/entities/snippets/schema-readonly.js +51 -0
package/dist/src/entities/snippets/schema-readonly.js.map +1 -0
package/dist/src/entities/snippets/schema.d.ts +60 -0
package/dist/src/entities/snippets/schema.js +123 -0
package/dist/src/entities/snippets/schema.js.map +1 -0
package/dist/src/registry-manager.js +10 -0
package/dist/src/registry-manager.js.map +1 -1
package/dist/src/server.js +4 -2
package/dist/src/server.js.map +1 -1
package/dist/structured-world-gitlab-mcp-6.7.0.tgz +0 -0
package/dist/tsconfig.build.tsbuildinfo +1 -1
package/package.json +1 -1
package/dist/structured-world-gitlab-mcp-6.6.0.tgz +0 -0

package/README.md CHANGED Viewed

@@ -54,6 +54,7 @@ env = { "GITLAB_TOKEN" = "mytoken", "GITLAB_API_URL" = "https://gitlab.com" }
         "USE_PIPELINE": "false", // use pipeline api?
         "USE_VARIABLES": "true", // use variables api?
         "USE_WEBHOOKS": "true", // use webhooks api?
+        "USE_SNIPPETS": "true", // use snippets api?
         "SKIP_TLS_VERIFY": "false" // skip SSL cert verification (dev only)
       }
     }
@@ -123,6 +124,8 @@ env = { "GITLAB_TOKEN" = "mytoken", "GITLAB_API_URL" = "https://gitlab.com" }
         "USE_VARIABLES",
         "-e",
         "USE_WEBHOOKS",
+        "-e",
+        "USE_SNIPPETS",
         "ghcr.io/structured-world/gitlab-mcp:latest"
       ],
       "env": {
@@ -133,7 +136,8 @@ env = { "GITLAB_TOKEN" = "mytoken", "GITLAB_API_URL" = "https://gitlab.com" }
         "USE_MILESTONE": "true",
         "USE_PIPELINE": "true",
         "USE_VARIABLES": "true",
-        "USE_WEBHOOKS": "true"
+        "USE_WEBHOOKS": "true",
+        "USE_SNIPPETS": "true"
       }
     }
   }
@@ -470,6 +474,7 @@ When OAuth is enabled, the following endpoints are available:
 - `USE_VARIABLES`: When set to 'true', enables the CI/CD variables-related tools (browse_variables, manage_variable). These 2 CQRS tools consolidate all variable operations. Supports both project-level and group-level variables. By default, variables features are enabled.
 - `USE_WORKITEMS`: When set to 'true', enables the work items-related tools (browse_work_items, manage_work_item). These 2 CQRS tools consolidate all work item operations using GitLab GraphQL API. By default, work items features are enabled.
 - `USE_WEBHOOKS`: When set to 'true', enables the webhooks-related tools (list_webhooks, manage_webhook). These 2 tools provide full CRUD operations plus testing for both project and group webhooks. Group webhooks require GitLab Premium tier. By default, webhooks features are enabled.
+- `USE_SNIPPETS`: When set to 'true', enables the snippets-related tools (list_snippets, manage_snippet). These 2 CQRS tools provide full listing and CRUD operations for both personal and project snippets. Supports multi-file snippets, visibility control, and flexible scoping. By default, snippets features are enabled.
 - `GITLAB_AUTH_COOKIE_PATH`: Path to an authentication cookie file for GitLab instances that require cookie-based authentication. When provided, the cookie will be included in all GitLab API requests.
 - `SKIP_TLS_VERIFY`: When set to 'true', skips TLS certificate verification for all GitLab API requests (both REST and GraphQL). **WARNING**: This bypasses SSL certificate validation and should only be used for testing with self-signed certificates or trusted internal GitLab instances. Never use this in production environments.
 - `SSL_CERT_PATH`: Path to PEM certificate file for direct HTTPS/TLS termination. Requires `SSL_KEY_PATH` to also be set.
@@ -538,11 +543,11 @@ export GITLAB_TOOL_MANAGE_WORK_ITEM="Create and manage tickets for our sprint pl
 - **Case Sensitivity**: Tool names in environment variables must be UPPERCASE (e.g., `LIST_PROJECTS` not `list_projects`)
 - **Invalid Names**: Invalid tool names in environment variables are ignored with a warning in debug logs
 - **Content Guidelines**: Descriptions can be any valid string but should be kept concise for better UX
-- **Scope**: Works with all 58 available tools across all entities (Core, Work Items, Merge Requests, Files, etc.)
+- **Scope**: Works with all 59 available tools across all entities (Core, Work Items, Merge Requests, Files, Snippets, etc.)
 ## Tools 🛠️
-**57 Tools Available** - Organized by entity and functionality below.
+**59 Tools Available** - Organized by entity and functionality below.
 ### Key Features:
 - **CQRS Pattern** - Consolidated action-based tools: `browse_*` for reads, `manage_*` for writes
@@ -696,6 +701,20 @@ Webhooks can be configured to trigger on:
 - **Subgroup events** - Subgroup created/removed (group webhooks only)
 - **Project events** - Project created/removed (group webhooks only)
+### Snippets Management (2 tools)
+Requires USE_SNIPPETS=true environment variable (enabled by default). Uses CQRS pattern with action-based tools. Supports personal, project, and public snippets with multi-file support.
+#### Snippet Browsing (Query)
+- 📖 **`list_snippets`**: 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. Supports pagination.
+#### Snippet Management (Command)
+- ✏️ **`manage_snippet`**: MANAGE GitLab snippets with full CRUD operations via action parameter. Actions: "read" retrieves snippet metadata or raw content, "create" creates new snippet with multiple files and visibility control, "update" modifies title/description/visibility/files (supports file create/update/delete/move actions), "delete" permanently removes snippet. Supports both personal and project snippets.
+#### Multi-file Snippet Support
+Snippets can contain multiple files with individual operations:
+- **Create action** - Files array with `file_path` and `content` for each file
+- **Update action** - Files array with `action` field: "create" (add new), "update" (modify existing), "delete" (remove), "move" (rename with `previous_path`)
 ## CLI Tools 🔧
 ### list-tools - Browse Available Tools

package/dist/src/config.d.ts CHANGED Viewed

@@ -11,6 +11,7 @@ export declare const USE_LABELS: boolean;
 export declare const USE_MRS: boolean;
 export declare const USE_FILES: boolean;
 export declare const USE_VARIABLES: boolean;
+export declare const USE_SNIPPETS: boolean;
 export declare const USE_WEBHOOKS: boolean;
 export declare const HOST: string;
 export declare const PORT: string | number;

package/dist/src/config.js CHANGED Viewed

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.packageVersion = exports.packageName = exports.GITLAB_ALLOWED_PROJECT_IDS = exports.GITLAB_PROJECT_ID = exports.GITLAB_API_URL = exports.GITLAB_BASE_URL = exports.GITLAB_CA_CERT_PATH = exports.NODE_TLS_REJECT_UNAUTHORIZED = exports.HTTPS_PROXY = exports.HTTP_PROXY = exports.SKIP_TLS_VERIFY = exports.RATE_LIMIT_SESSION_MAX_REQUESTS = exports.RATE_LIMIT_SESSION_WINDOW_MS = exports.RATE_LIMIT_SESSION_ENABLED = exports.RATE_LIMIT_IP_MAX_REQUESTS = exports.RATE_LIMIT_IP_WINDOW_MS = exports.RATE_LIMIT_IP_ENABLED = exports.API_TIMEOUT_MS = exports.TRUST_PROXY = exports.SSL_PASSPHRASE = exports.SSL_CA_PATH = exports.SSL_KEY_PATH = exports.SSL_CERT_PATH = exports.PORT = exports.HOST = exports.USE_WEBHOOKS = exports.USE_VARIABLES = exports.USE_FILES = exports.USE_MRS = exports.USE_LABELS = exports.USE_WORKITEMS = exports.USE_PIPELINE = exports.USE_MILESTONE = exports.USE_GITLAB_WIKI = exports.GITLAB_DENIED_TOOLS_REGEX = exports.GITLAB_READ_ONLY_MODE = exports.IS_OLD = exports.GITLAB_AUTH_COOKIE_PATH = exports.GITLAB_TOKEN = void 0;
+exports.packageVersion = exports.packageName = exports.GITLAB_ALLOWED_PROJECT_IDS = exports.GITLAB_PROJECT_ID = exports.GITLAB_API_URL = exports.GITLAB_BASE_URL = exports.GITLAB_CA_CERT_PATH = exports.NODE_TLS_REJECT_UNAUTHORIZED = exports.HTTPS_PROXY = exports.HTTP_PROXY = exports.SKIP_TLS_VERIFY = exports.RATE_LIMIT_SESSION_MAX_REQUESTS = exports.RATE_LIMIT_SESSION_WINDOW_MS = exports.RATE_LIMIT_SESSION_ENABLED = exports.RATE_LIMIT_IP_MAX_REQUESTS = exports.RATE_LIMIT_IP_WINDOW_MS = exports.RATE_LIMIT_IP_ENABLED = exports.API_TIMEOUT_MS = exports.TRUST_PROXY = exports.SSL_PASSPHRASE = exports.SSL_CA_PATH = exports.SSL_KEY_PATH = exports.SSL_CERT_PATH = exports.PORT = exports.HOST = exports.USE_WEBHOOKS = exports.USE_SNIPPETS = exports.USE_VARIABLES = exports.USE_FILES = exports.USE_MRS = exports.USE_LABELS = exports.USE_WORKITEMS = exports.USE_PIPELINE = exports.USE_MILESTONE = exports.USE_GITLAB_WIKI = exports.GITLAB_DENIED_TOOLS_REGEX = exports.GITLAB_READ_ONLY_MODE = exports.IS_OLD = exports.GITLAB_AUTH_COOKIE_PATH = exports.GITLAB_TOKEN = void 0;
 exports.getEffectiveProjectId = getEffectiveProjectId;
 exports.getToolDescriptionOverrides = getToolDescriptionOverrides;
 const path = __importStar(require("path"));
@@ -54,6 +54,7 @@ exports.USE_LABELS = process.env.USE_LABELS !== "false";
 exports.USE_MRS = process.env.USE_MRS !== "false";
 exports.USE_FILES = process.env.USE_FILES !== "false";
 exports.USE_VARIABLES = process.env.USE_VARIABLES !== "false";
+exports.USE_SNIPPETS = process.env.USE_SNIPPETS !== "false";
 exports.USE_WEBHOOKS = process.env.USE_WEBHOOKS !== "false";
 exports.HOST = process.env.HOST ?? "0.0.0.0";
 exports.PORT = process.env.PORT ?? 3002;

package/dist/src/config.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~AA+FA~~,sDAcC;AAwBD,kEAgBC;~~AArJD~~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"}
1	+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}

package/dist/src/entities/snippets/index.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+export * from "../shared";
+export * from "./schema-readonly";
+export * from "./schema";
+export * from "./registry";
+import type { ToolDefinition } from "../../types";
+export declare const snippetsTools: ToolDefinition[];
+export declare const snippetsReadOnlyTools: string[];

package/dist/src/entities/snippets/index.js ADDED Viewed

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snippetsReadOnlyTools = exports.snippetsTools = void 0;
+__exportStar(require("../shared"), exports);
+__exportStar(require("./schema-readonly"), exports);
+__exportStar(require("./schema"), exports);
+__exportStar(require("./registry"), exports);
+const registry_1 = require("./registry");
+const isReadOnly = process.env.GITLAB_READONLY === "true";
+const snippetsToolsFromRegistry = (0, registry_1.getFilteredSnippetsTools)(isReadOnly);
+exports.snippetsTools = snippetsToolsFromRegistry.map((tool) => ({
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.inputSchema,
+}));
+exports.snippetsReadOnlyTools = (0, registry_1.getSnippetsReadOnlyToolNames)();
+//# sourceMappingURL=index.js.map

package/dist/src/entities/snippets/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/entities/snippets/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,4CAA0B;AAG1B,oDAAkC;AAGlC,2CAAyB;AAGzB,6CAA2B;AAG3B,yCAAoF;AAIpF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,CAAC;AAG1D,MAAM,yBAAyB,GAAG,IAAA,mCAAwB,EAAC,UAAU,CAAC,CAAC;AAG1D,QAAA,aAAa,GAAqB,yBAAyB,CAAC,GAAG,CAC1E,CAAC,IAAI,EAAkB,EAAE,CAAC,CAAC;IACzB,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;CAC9B,CAAC,CACH,CAAC;AAGW,QAAA,qBAAqB,GAAG,IAAA,uCAA4B,GAAE,CAAC"}

package/dist/src/entities/snippets/registry.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import { ToolRegistry, EnhancedToolDefinition } from "../../types";
+export declare const snippetsToolRegistry: ToolRegistry;
+export declare function getSnippetsReadOnlyToolNames(): string[];
+export declare function getSnippetsToolDefinitions(): EnhancedToolDefinition[];
+export declare function getFilteredSnippetsTools(readOnlyMode?: boolean): EnhancedToolDefinition[];

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

@@ -0,0 +1,186 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.snippetsToolRegistry = void 0;
+exports.getSnippetsReadOnlyToolNames = getSnippetsReadOnlyToolNames;
+exports.getSnippetsToolDefinitions = getSnippetsToolDefinitions;
+exports.getFilteredSnippetsTools = getFilteredSnippetsTools;
+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,
+]);
+exports.snippetsToolRegistry = new Map([
+    [
+        "list_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),
+            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";
+                }
+                else {
+                    if (!options.projectId) {
+                        throw new Error("projectId is required for project scope");
+                    }
+                    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();
+                        let path;
+                        if (options.projectId) {
+                            const encodedProjectId = encodeURIComponent(options.projectId);
+                            path = `projects/${encodedProjectId}/snippets/${encodedId}`;
+                        }
+                        else {
+                            path = `snippets/${encodedId}`;
+                        }
+                        if (options.raw) {
+                            path = `${path}/raw`;
+                        }
+                        return gitlab_api_1.gitlab.get(path);
+                    }
+                    case "create": {
+                        const body = {
+                            title: options.title,
+                            visibility: options.visibility,
+                            files: options.files,
+                        };
+                        if (options.description) {
+                            body.description = options.description;
+                        }
+                        let path;
+                        if (options.projectId) {
+                            const encodedProjectId = encodeURIComponent(options.projectId);
+                            path = `projects/${encodedProjectId}/snippets`;
+                        }
+                        else {
+                            path = "snippets";
+                        }
+                        return gitlab_api_1.gitlab.post(path, {
+                            body,
+                            contentType: "json",
+                        });
+                    }
+                    case "update": {
+                        const encodedId = options.id.toString();
+                        const body = {};
+                        if (options.title !== undefined) {
+                            body.title = options.title;
+                        }
+                        if (options.description !== undefined) {
+                            body.description = options.description;
+                        }
+                        if (options.visibility !== undefined) {
+                            body.visibility = options.visibility;
+                        }
+                        if (options.files !== undefined) {
+                            body.files = options.files;
+                        }
+                        let path;
+                        if (options.projectId) {
+                            const encodedProjectId = encodeURIComponent(options.projectId);
+                            path = `projects/${encodedProjectId}/snippets/${encodedId}`;
+                        }
+                        else {
+                            path = `snippets/${encodedId}`;
+                        }
+                        return gitlab_api_1.gitlab.put(path, {
+                            body,
+                            contentType: "json",
+                        });
+                    }
+                    case "delete": {
+                        const encodedId = options.id.toString();
+                        let path;
+                        if (options.projectId) {
+                            const encodedProjectId = encodeURIComponent(options.projectId);
+                            path = `projects/${encodedProjectId}/snippets/${encodedId}`;
+                        }
+                        else {
+                            path = `snippets/${encodedId}`;
+                        }
+                        await gitlab_api_1.gitlab.delete(path);
+                        return { deleted: true, id: options.id };
+                    }
+                    default:
+                        throw new Error(`Unknown action: ${options.action}`);
+                }
+            },
+        },
+    ],
+]);
+function getSnippetsReadOnlyToolNames() {
+    return ["list_snippets"];
+}
+function getSnippetsToolDefinitions() {
+    return Array.from(exports.snippetsToolRegistry.values());
+}
+function getFilteredSnippetsTools(readOnlyMode = false) {
+    if (readOnlyMode) {
+        const readOnlyNames = getSnippetsReadOnlyToolNames();
+        return Array.from(exports.snippetsToolRegistry.values()).filter(tool => readOnlyNames.includes(tool.name));
+    }
+    return getSnippetsToolDefinitions();
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@

+ {"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 ADDED Viewed

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export declare const ListSnippetsSchema: z.ZodObject<{
+    scope: z.ZodEnum<{
+        project: "project";
+        public: "public";
+        personal: "personal";
+    }>;
+    projectId: z.ZodOptional<z.ZodString>;
+    visibility: z.ZodOptional<z.ZodEnum<{
+        private: "private";
+        internal: "internal";
+        public: "public";
+    }>>;
+    created_after: z.ZodOptional<z.ZodString>;
+    created_before: z.ZodOptional<z.ZodString>;
+    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;
+    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>;

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

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetSnippetSchema = exports.ListSnippetsSchema = 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"),
+    created_after: zod_1.z
+        .string()
+        .optional()
+        .describe("Return snippets created after this date (ISO 8601 format). 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"],
+});
+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"),
+    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"],
+});
+//# sourceMappingURL=schema-readonly.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,60 @@
+import { z } from "zod";
+declare const SnippetFileSchema: z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodEnum<{
+        create: "create";
+        update: "update";
+        delete: "delete";
+        move: "move";
+    }>>;
+    previous_path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const CreateSnippetSchema: z.ZodObject<{
+    action: z.ZodLiteral<"create">;
+    projectId: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    visibility: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
+        private: "private";
+        internal: "internal";
+        public: "public";
+    }>>>>;
+    files: z.ZodArray<z.ZodObject<{
+        file_path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const UpdateSnippetSchema: z.ZodObject<{
+    action: z.ZodLiteral<"update">;
+    id: z.ZodNumber;
+    projectId: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    visibility: z.ZodOptional<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodEnum<{
+        private: "private";
+        internal: "internal";
+        public: "public";
+    }>>>;
+    files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        file_path: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        action: z.ZodOptional<z.ZodEnum<{
+            create: "create";
+            update: "update";
+            delete: "delete";
+            move: "move";
+        }>>;
+        previous_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const DeleteSnippetSchema: z.ZodObject<{
+    action: z.ZodLiteral<"delete">;
+    id: z.ZodNumber;
+    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>;
+export type SnippetFile = z.infer<typeof SnippetFileSchema>;
+export {};

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

@@ -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