Merge pull request #13 from yepcode/feature/split-yc_api-tag

Split yc_api tag into basic and full variants

Author: agtraveso

README.md

@@ -160,7 +160,8 @@ You can control which tools are enabled by setting the `YEPCODE_MCP_TOOLS` envir
 
 **Built-in tool categories:**
 - `run_code`: Enables the code execution tool
-- `yc_api`: Enables all API management tools (processes, schedules, variables, storage, executions, modules)
+- `yc_api`: Enables all basic API management tools (processes, schedules, variables, storage, executions, modules)
+- `yc_api_full`: Enables all API management tools including version-related tools (extends `yc_api` with additional process and module version management tools)
 
 **Process tags:**
 - Any tag used in your YepCode processes (e.g., `mcp-tool`, `core`, `automation`, etc.)
@@ -196,7 +197,8 @@ If not specified, all built-in tools are enabled by default, but no process tool
 ```
 
 **Example scenarios:**
-- `YEPCODE_MCP_TOOLS=run_code,yc_api` - Enables built-in code execution and API management tools
+- `YEPCODE_MCP_TOOLS=run_code,yc_api` - Enables built-in code execution and basic API management tools
+- `YEPCODE_MCP_TOOLS=run_code,yc_api_full` - Enables built-in code execution and all API management tools (including version management)
 - `YEPCODE_MCP_TOOLS=core,automation` - Only exposes processes tagged with "core" or "automation" as tools
 - `YEPCODE_MCP_TOOLS=run_code,yc_api,core` - Enables built-in tools plus all processes tagged with "core"
 
@@ -348,14 +350,21 @@ For more information about process tags, see our [process tags documentation](ht
 
 ### API Management Tools
 
-The `yc_api` tool category provides comprehensive API access to manage all aspects of your YepCode workspace:
+The API management tool categories (`yc_api` and `yc_api_full`) provide comprehensive API access to manage all aspects of your YepCode workspace:
+
+**Basic API tools (`yc_api`):**
+The `yc_api` tag enables standard API management tools for core operations across your workspace.
+
+**Extended API tools (`yc_api_full`):**
+The `yc_api_full` tag includes everything from `yc_api` plus additional tools for managing process and module versions.
 
 **Processes Management:**
 - `get_processes` - List processes with optional filtering
 - `create_process` - Create new processes with source code
 - `get_process` - Get process details
+- `update_process` - Update an existing process
 - `delete_process` - Delete a process
-- `get_process_versions` - Get process versions
+- `get_process_versions` - Get process versions (requires `yc_api_full`)
 - `execute_process_async` - Execute a process asynchronously
 - `execute_process_sync` - Execute a process synchronously
 - `schedule_process` - Schedule a process to run automatically
@@ -391,7 +400,10 @@ The `yc_api` tool category provides comprehensive API access to manage all aspec
 - `create_module` - Create a new module
 - `get_module` - Get module details
 - `delete_module` - Delete a module
-- `get_module_versions` - Get module versions
+- `get_module_versions` - Get module versions (requires `yc_api_full`)
+- `get_module_version` - Get a specific module version (requires `yc_api_full`)
+- `delete_module_version` - Delete a module version (requires `yc_api_full`)
+- `get_module_aliases` - Get module version aliases (requires `yc_api_full`)
 
 ## License
 

src/server.ts

@@ -64,6 +64,7 @@ import {
   ExecuteProcessSyncSchema,
   ScheduleProcessSchema,
   processesToolDefinitions,
+  processesWithVersionsToolDefinitions,
   processesToolNames,
 } from "./tools/processes-tool-definitions.js";
 import {
@@ -85,13 +86,17 @@ import {
   DeleteModuleVersionSchema,
   GetModuleAliasesSchema,
   modulesToolDefinitions,
+  modulesWithVersionsToolDefinitions,
   modulesToolNames,
 } from "./tools/modules-tool-definitions.js";
 
 const RUN_PROCESS_TOOL_NAME_PREFIX = "yc_";
 const RUN_PROCESS_TOOL_TAG = "mcp-tool";
 const RUN_CODE_TOOL_TAG = "run_code";
-const API_TOOL_TAG = "yc_api";
+const API_TOOL_TAGS = {
+  DEFAULT: "yc_api",
+  FULL: "yc_api_full",
+};
 
 const DEFAULT_TOOL_TAGS = [RUN_CODE_TOOL_TAG, RUN_PROCESS_TOOL_TAG];
 
@@ -261,14 +266,21 @@ class YepCodeMcpServer extends Server {
     this.setRequestHandler(ListToolsRequestSchema, async () => {
       this.logger.info(`Handling ListTools request`);
       const tools = [];
-      if (this.tools.includes(API_TOOL_TAG)) {
+      if (
+        this.tools.includes(API_TOOL_TAGS.DEFAULT) ||
+        this.tools.includes(API_TOOL_TAGS.FULL)
+      ) {
         tools.push(...storageToolDefinitions);
         tools.push(...variablesToolDefinitions);
         tools.push(...schedulesToolDefinitions);
         tools.push(...processesToolDefinitions);
         tools.push(...executionsToolDefinitions);
         tools.push(...modulesToolDefinitions);
       }
+      if (this.tools.includes(API_TOOL_TAGS.FULL)) {
+        tools.push(...processesWithVersionsToolDefinitions);
+        tools.push(...modulesWithVersionsToolDefinitions);
+      }
       if (this.tools.includes(RUN_CODE_TOOL_TAG)) {
         const envVars = await this.yepCodeEnv.getEnvVars();
         tools.push(...(await runCodeToolDefinitions(envVars)));

src/tools/modules-tool-definitions.ts

@@ -2,8 +2,21 @@ import { z } from "zod";
 
 // Schema for getting modules with pagination
 export const GetModulesSchema = z.object({
-  page: z.number().int().min(0).default(0).optional().describe("Page number for pagination (0-based index)"),
-  limit: z.number().int().min(1).max(100).default(10).optional().describe("Maximum number of modules to retrieve per page"),
+  page: z
+    .number()
+    .int()
+    .min(0)
+    .default(0)
+    .optional()
+    .describe("Page number for pagination (0-based index)"),
+  limit: z
+    .number()
+    .int()
+    .min(1)
+    .max(100)
+    .default(10)
+    .optional()
+    .describe("Maximum number of modules to retrieve per page"),
 });
 
 // Schema for creating a module
@@ -18,19 +31,34 @@ export const CreateModuleSchema = z.object({
 
 // Schema for getting a specific module
 export const GetModuleSchema = z.object({
-  id: z.string().describe("Unique identifier (UUID) of the script library module to retrieve"),
+  id: z
+    .string()
+    .describe(
+      "Unique identifier (UUID) of the script library module to retrieve"
+    ),
 });
 
 // Schema for deleting a module
 export const DeleteModuleSchema = z.object({
-  id: z.string().describe("Unique identifier (UUID) of the script library module to delete"),
+  id: z
+    .string()
+    .describe(
+      "Unique identifier (UUID) of the script library module to delete"
+    ),
 });
 
 // Schema for getting module versions
 export const GetModuleVersionsSchema = z.object({
   moduleId: z.string().describe("Module ID"),
   page: z.number().int().min(0).default(0).optional().describe("Page number"),
-  limit: z.number().int().min(1).max(100).default(10).optional().describe("Amount of items to retrieve"),
+  limit: z
+    .number()
+    .int()
+    .min(1)
+    .max(100)
+    .default(10)
+    .optional()
+    .describe("Amount of items to retrieve"),
 });
 
 // Schema for getting a specific module version
@@ -50,7 +78,14 @@ export const GetModuleAliasesSchema = z.object({
   moduleId: z.string().describe("Module ID"),
   versionId: z.string().optional().describe("Version ID"),
   page: z.number().int().min(0).default(0).optional().describe("Page number"),
-  limit: z.number().int().min(1).max(100).default(10).optional().describe("Amount of items to retrieve"),
+  limit: z
+    .number()
+    .int()
+    .min(1)
+    .max(100)
+    .default(10)
+    .optional()
+    .describe("Amount of items to retrieve"),
 });
 
 // Tool names
@@ -70,7 +105,8 @@ export const modulesToolDefinitions = [
   {
     name: modulesToolNames.getModules,
     title: "Get Modules",
-    description: "Retrieves a paginated list of script library modules. Modules are reusable code libraries that can be imported and used across different processes.",
+    description:
+      "Retrieves a paginated list of script library modules. Modules are reusable code libraries that can be imported and used across different processes.",
     inputSchema: {
       type: "object",
       properties: {
@@ -92,7 +128,8 @@ export const modulesToolDefinitions = [
   {
     name: modulesToolNames.createModule,
     title: "Create Module",
-    description: "Creates a new script library module with source code and metadata. Modules can be written in JavaScript or Python and can be imported by processes.",
+    description:
+      "Creates a new script library module with source code and metadata. Modules can be written in JavaScript or Python and can be imported by processes.",
     inputSchema: {
       type: "object",
       properties: {
@@ -129,13 +166,15 @@ export const modulesToolDefinitions = [
   {
     name: modulesToolNames.getModule,
     title: "Get Module",
-    description: "Retrieves detailed information about a specific script library module including its source code, metadata, and version information.",
+    description:
+      "Retrieves detailed information about a specific script library module including its source code, metadata, and version information.",
     inputSchema: {
       type: "object",
       properties: {
         id: {
           type: "string",
-          description: "Unique identifier (UUID) of the script library module to retrieve",
+          description:
+            "Unique identifier (UUID) of the script library module to retrieve",
         },
       },
       required: ["id"],
@@ -144,22 +183,28 @@ export const modulesToolDefinitions = [
   {
     name: modulesToolNames.deleteModule,
     title: "Delete Module",
-    description: "Deletes a script library module and all its versions. This action cannot be undone.",
+    description:
+      "Deletes a script library module and all its versions. This action cannot be undone.",
     inputSchema: {
       type: "object",
       properties: {
         id: {
           type: "string",
-          description: "Unique identifier (UUID) of the script library module to delete",
+          description:
+            "Unique identifier (UUID) of the script library module to delete",
         },
       },
       required: ["id"],
     },
   },
+];
+
+export const modulesWithVersionsToolDefinitions = [
   {
     name: modulesToolNames.getModuleVersions,
     title: "Get Module Versions",
-    description: "Retrieves a paginated list of versions for a specific module.",
+    description:
+      "Retrieves a paginated list of versions for a specific module.",
     inputSchema: {
       type: "object",
       properties: {
@@ -186,7 +231,8 @@ export const modulesToolDefinitions = [
   {
     name: modulesToolNames.getModuleVersion,
     title: "Get Module Version",
-    description: "Retrieves detailed information about a specific module version.",
+    description:
+      "Retrieves detailed information about a specific module version.",
     inputSchema: {
       type: "object",
       properties: {
@@ -205,7 +251,8 @@ export const modulesToolDefinitions = [
   {
     name: modulesToolNames.deleteModuleVersion,
     title: "Delete Module Version",
-    description: "Deletes a specific module version. This action cannot be undone.",
+    description:
+      "Deletes a specific module version. This action cannot be undone.",
     inputSchema: {
       type: "object",
       properties: {
@@ -224,7 +271,8 @@ export const modulesToolDefinitions = [
   {
     name: modulesToolNames.getModuleAliases,
     title: "Get Module Aliases",
-    description: "Retrieves a paginated list of version aliases for a specific module.",
+    description:
+      "Retrieves a paginated list of version aliases for a specific module.",
     inputSchema: {
       type: "object",
       properties: {

src/tools/processes-tool-definitions.ts

@@ -499,34 +499,6 @@ export const processesToolDefinitions = [
       required: ["identifier"],
     },
   },
-  {
-    name: processesToolNames.getProcessVersions,
-    title: "Get Process Versions",
-    description:
-      "Retrieves a paginated list of versions for a specific process.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        processId: {
-          type: "string",
-          description: "Process ID",
-        },
-        page: {
-          type: "integer",
-          format: "int32",
-          default: 0,
-          description: "Page number",
-        },
-        limit: {
-          type: "integer",
-          format: "int32",
-          default: 10,
-          description: "Amount of items to retrieve",
-        },
-      },
-      required: ["processId"],
-    },
-  },
   {
     name: processesToolNames.executeProcessAsync,
     title: "Execute Process Async",
@@ -669,3 +641,34 @@ export const processesToolDefinitions = [
     },
   },
 ];
+
+export const processesWithVersionsToolDefinitions = [
+  {
+    name: processesToolNames.getProcessVersions,
+    title: "Get Process Versions",
+    description:
+      "Retrieves a paginated list of versions for a specific process.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        processId: {
+          type: "string",
+          description: "Process ID",
+        },
+        page: {
+          type: "integer",
+          format: "int32",
+          default: 0,
+          description: "Page number",
+        },
+        limit: {
+          type: "integer",
+          format: "int32",
+          default: 10,
+          description: "Amount of items to retrieve",
+        },
+      },
+      required: ["processId"],
+    },
+  },
+];