@agiflowai/scaffold-mcp 1.0.1 → 1.0.3

package/dist/cli.cjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-const require_stdio = require('./stdio-TGsG8akc.cjs');
+const require_stdio = require('./stdio-DM_C4xbZ.cjs');
 require('./ScaffoldConfigLoader-BrmvENTo.cjs');
 require('./ScaffoldService-BwDmXt83.cjs');
 const require_TemplateService = require('./TemplateService-DRubcvS9.cjs');
@@ -19,7 +19,7 @@ __modelcontextprotocol_sdk_types_js = require_chunk.__toESM(__modelcontextprotoc
 //#region package.json
 var name = "@agiflowai/scaffold-mcp";
 var description = "MCP server for scaffolding applications with boilerplate templates";
-var version = "1.0.0";
+var version = "1.0.2";
 var license = "AGPL-3.0";
 var author = "AgiflowIO";
 var repository = {
@@ -118,9 +118,9 @@ var package_default = {
 * Boilerplate CLI command
 */
 const boilerplateCommand = new commander.Command("boilerplate").description("Manage boilerplate templates");
-boilerplateCommand.command("list").description("List all available boilerplate templates").action(async () => {
+boilerplateCommand.command("list").description("List all available boilerplate templates").option("-c, --cursor <cursor>", "Pagination cursor for next page").action(async (options) => {
 	try {
-		const { boilerplates } = await new require_stdio.BoilerplateService(await __agiflowai_aicode_utils.TemplatesManagerService.findTemplatesPath()).listBoilerplates();
+		const { boilerplates, nextCursor } = await new require_stdio.BoilerplateService(await __agiflowai_aicode_utils.TemplatesManagerService.findTemplatesPath()).listBoilerplates(options.cursor);
 		if (boilerplates.length === 0) {
 			__agiflowai_aicode_utils.messages.warning("No boilerplate templates found.");
 			return;
@@ -134,6 +134,11 @@ boilerplateCommand.command("list").description("List all available boilerplate t
 			if (required && required.length > 0) __agiflowai_aicode_utils.print.debug(`    Required: ${required.join(", ")}`);
 			__agiflowai_aicode_utils.print.newline();
 		}
+		if (nextCursor) {
+			__agiflowai_aicode_utils.print.newline();
+			__agiflowai_aicode_utils.print.info(`${__agiflowai_aicode_utils.icons.info} More results available. Use --cursor to fetch next page:`);
+			__agiflowai_aicode_utils.print.debug(`  scaffold-mcp boilerplate list --cursor "${nextCursor}"`);
+		}
 	} catch (error) {
 		__agiflowai_aicode_utils.messages.error("Error listing boilerplates:", error);
 		process.exit(1);
@@ -152,9 +157,15 @@ boilerplateCommand.command("create <boilerplateName>").description("Create a new
 		}
 		const boilerplate = await boilerplateService.getBoilerplate(boilerplateName);
 		if (!boilerplate) {
-			const { boilerplates } = await boilerplateService.listBoilerplates();
+			let allBoilerplates = [];
+			let cursor;
+			do {
+				const result$1 = await boilerplateService.listBoilerplates(cursor);
+				allBoilerplates = allBoilerplates.concat(result$1.boilerplates);
+				cursor = result$1.nextCursor;
+			} while (cursor);
 			__agiflowai_aicode_utils.messages.error(`Boilerplate '${boilerplateName}' not found.`);
-			__agiflowai_aicode_utils.print.warning(`Available boilerplates: ${boilerplates.map((b) => b.name).join(", ")}`);
+			__agiflowai_aicode_utils.print.warning(`Available boilerplates: ${allBoilerplates.map((b) => b.name).join(", ")}`);
 			process.exit(1);
 		}
 		const required = typeof boilerplate.variables_schema === "object" && boilerplate.variables_schema !== null && "required" in boilerplate.variables_schema ? boilerplate.variables_schema.required : [];
@@ -601,7 +612,7 @@ const mcpServeCommand = new commander.Command("mcp-serve").description("Start MC
 * Scaffold CLI command
 */
 const scaffoldCommand = new commander.Command("scaffold").description("Add features to existing projects");
-scaffoldCommand.command("list [projectPath]").description("List available scaffolding methods for a project or template").option("-t, --template <name>", "Template name (e.g., nextjs-15, typescript-mcp-package)").action(async (projectPath, options) => {
+scaffoldCommand.command("list [projectPath]").description("List available scaffolding methods for a project or template").option("-t, --template <name>", "Template name (e.g., nextjs-15, typescript-mcp-package)").option("-c, --cursor <cursor>", "Pagination cursor for next page").action(async (projectPath, options) => {
 	try {
 		if (!projectPath && !options.template) {
 			__agiflowai_aicode_utils.messages.error("Either projectPath or --template option must be provided");
@@ -621,10 +632,10 @@ scaffoldCommand.command("list [projectPath]").description("List available scaffo
 				__agiflowai_aicode_utils.messages.hint("For monorepo: ensure project.json exists with sourceTemplate field\nFor monolith: ensure toolkit.yaml exists at workspace root\nOr use --template option to list methods for a specific template");
 				process.exit(1);
 			}
-			result = await scaffoldingMethodsService.listScaffoldingMethods(absolutePath);
+			result = await scaffoldingMethodsService.listScaffoldingMethods(absolutePath, options.cursor);
 			displayName = projectPath;
 		} else {
-			result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate(options.template);
+			result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate(options.template, options.cursor);
 			displayName = `template: ${options.template}`;
 		}
 		const methods = result.methods;
@@ -639,6 +650,13 @@ scaffoldCommand.command("list [projectPath]").description("List available scaffo
 			if (method.variables_schema.required && method.variables_schema.required.length > 0) __agiflowai_aicode_utils.print.debug(`    Required: ${method.variables_schema.required.join(", ")}`);
 			__agiflowai_aicode_utils.print.newline();
 		}
+		if (result.nextCursor) {
+			__agiflowai_aicode_utils.print.newline();
+			__agiflowai_aicode_utils.print.info(`${__agiflowai_aicode_utils.icons.info} More results available. Use --cursor to fetch next page:`);
+			const cursorOption = `--cursor "${result.nextCursor}"`;
+			if (projectPath) __agiflowai_aicode_utils.print.debug(`  scaffold-mcp scaffold list ${projectPath} ${cursorOption}`);
+			else __agiflowai_aicode_utils.print.debug(`  scaffold-mcp scaffold list --template ${options.template} ${cursorOption}`);
+		}
 	} catch (error) {
 		__agiflowai_aicode_utils.messages.error("Error listing scaffolding methods:", error);
 		process.exit(1);
@@ -662,11 +680,17 @@ scaffoldCommand.command("add <featureName>").description("Add a feature to an ex
 		}
 		const templatesDir = await __agiflowai_aicode_utils.TemplatesManagerService.findTemplatesPath();
 		const scaffoldingMethodsService = new require_stdio.ScaffoldingMethodsService(new require_stdio.FileSystemService(), templatesDir);
-		const methods = (await scaffoldingMethodsService.listScaffoldingMethods(projectPath)).methods;
-		const method = methods.find((m) => m.name === featureName);
+		let allMethods = [];
+		let cursor;
+		do {
+			const listResult = await scaffoldingMethodsService.listScaffoldingMethods(projectPath, cursor);
+			allMethods = allMethods.concat(listResult.methods);
+			cursor = listResult.nextCursor;
+		} while (cursor);
+		const method = allMethods.find((m) => m.name === featureName);
 		if (!method) {
 			__agiflowai_aicode_utils.messages.error(`Scaffold method '${featureName}' not found.`);
-			__agiflowai_aicode_utils.print.warning(`Available methods: ${methods.map((m) => m.name).join(", ")}`);
+			__agiflowai_aicode_utils.print.warning(`Available methods: ${allMethods.map((m) => m.name).join(", ")}`);
 			__agiflowai_aicode_utils.print.debug(`Run 'scaffold-mcp scaffold list ${options.project}' to see all available methods`);
 			process.exit(1);
 		}
@@ -727,7 +751,8 @@ scaffoldCommand.command("info <featureName>").description("Show detailed informa
 		}
 		const templatesDir = await __agiflowai_aicode_utils.TemplatesManagerService.findTemplatesPath();
 		const scaffoldingMethodsService = new require_stdio.ScaffoldingMethodsService(new require_stdio.FileSystemService(), templatesDir);
-		let result;
+		let allMethods = [];
+		let cursor;
 		if (options.project) {
 			const projectPath = node_path.default.resolve(options.project);
 			if (!await __agiflowai_aicode_utils.ProjectConfigResolver.hasConfiguration(projectPath)) {
@@ -735,9 +760,17 @@ scaffoldCommand.command("info <featureName>").description("Show detailed informa
 				__agiflowai_aicode_utils.messages.hint("For monorepo: ensure project.json exists with sourceTemplate field\nFor monolith: ensure toolkit.yaml exists at workspace root\nOr use --template option to view info for a specific template");
 				process.exit(1);
 			}
-			result = await scaffoldingMethodsService.listScaffoldingMethods(projectPath);
-		} else result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate(options.template);
-		const method = result.methods.find((m) => m.name === featureName);
+			do {
+				const result = await scaffoldingMethodsService.listScaffoldingMethods(projectPath, cursor);
+				allMethods = allMethods.concat(result.methods);
+				cursor = result.nextCursor;
+			} while (cursor);
+		} else do {
+			const result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate(options.template, cursor);
+			allMethods = allMethods.concat(result.methods);
+			cursor = result.nextCursor;
+		} while (cursor);
+		const method = allMethods.find((m) => m.name === featureName);
 		if (!method) {
 			__agiflowai_aicode_utils.messages.error(`❌ Scaffold method '${featureName}' not found.`);
 			process.exit(1);

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { BoilerplateService, FileSystemService, GenerateBoilerplateFileTool, GenerateBoilerplateTool, GenerateFeatureScaffoldTool, HttpTransportHandler, ListBoilerplatesTool, ListScaffoldingMethodsTool, ScaffoldingMethodsService, SseTransportHandler, StdioTransportHandler, UseBoilerplateTool, UseScaffoldMethodTool, WriteToFileTool } from "./stdio-Bxn4A1IU.js";
+import { BoilerplateService, FileSystemService, GenerateBoilerplateFileTool, GenerateBoilerplateTool, GenerateFeatureScaffoldTool, HttpTransportHandler, ListBoilerplatesTool, ListScaffoldingMethodsTool, ScaffoldingMethodsService, SseTransportHandler, StdioTransportHandler, UseBoilerplateTool, UseScaffoldMethodTool, WriteToFileTool } from "./stdio-BheRzmRj.js";
 import "./ScaffoldConfigLoader-CI0T6zdG.js";
 import "./ScaffoldService-DB7-Cyod.js";
 import { TemplateService } from "./TemplateService-CiZJA06s.js";
@@ -13,7 +13,7 @@ import { CallToolRequestSchema, GetPromptRequestSchema, ListPromptsRequestSchema
 //#region package.json
 var name = "@agiflowai/scaffold-mcp";
 var description = "MCP server for scaffolding applications with boilerplate templates";
-var version = "1.0.0";
+var version = "1.0.2";
 var license = "AGPL-3.0";
 var author = "AgiflowIO";
 var repository = {
@@ -112,9 +112,9 @@ var package_default = {
 * Boilerplate CLI command
 */
 const boilerplateCommand = new Command("boilerplate").description("Manage boilerplate templates");
-boilerplateCommand.command("list").description("List all available boilerplate templates").action(async () => {
+boilerplateCommand.command("list").description("List all available boilerplate templates").option("-c, --cursor <cursor>", "Pagination cursor for next page").action(async (options) => {
 	try {
-		const { boilerplates } = await new BoilerplateService(await TemplatesManagerService.findTemplatesPath()).listBoilerplates();
+		const { boilerplates, nextCursor } = await new BoilerplateService(await TemplatesManagerService.findTemplatesPath()).listBoilerplates(options.cursor);
 		if (boilerplates.length === 0) {
 			messages.warning("No boilerplate templates found.");
 			return;
@@ -128,6 +128,11 @@ boilerplateCommand.command("list").description("List all available boilerplate t
 			if (required && required.length > 0) print.debug(`    Required: ${required.join(", ")}`);
 			print.newline();
 		}
+		if (nextCursor) {
+			print.newline();
+			print.info(`${icons.info} More results available. Use --cursor to fetch next page:`);
+			print.debug(`  scaffold-mcp boilerplate list --cursor "${nextCursor}"`);
+		}
 	} catch (error) {
 		messages.error("Error listing boilerplates:", error);
 		process.exit(1);
@@ -146,9 +151,15 @@ boilerplateCommand.command("create <boilerplateName>").description("Create a new
 		}
 		const boilerplate = await boilerplateService.getBoilerplate(boilerplateName);
 		if (!boilerplate) {
-			const { boilerplates } = await boilerplateService.listBoilerplates();
+			let allBoilerplates = [];
+			let cursor;
+			do {
+				const result$1 = await boilerplateService.listBoilerplates(cursor);
+				allBoilerplates = allBoilerplates.concat(result$1.boilerplates);
+				cursor = result$1.nextCursor;
+			} while (cursor);
 			messages.error(`Boilerplate '${boilerplateName}' not found.`);
-			print.warning(`Available boilerplates: ${boilerplates.map((b) => b.name).join(", ")}`);
+			print.warning(`Available boilerplates: ${allBoilerplates.map((b) => b.name).join(", ")}`);
 			process.exit(1);
 		}
 		const required = typeof boilerplate.variables_schema === "object" && boilerplate.variables_schema !== null && "required" in boilerplate.variables_schema ? boilerplate.variables_schema.required : [];
@@ -595,7 +606,7 @@ const mcpServeCommand = new Command("mcp-serve").description("Start MCP server w
 * Scaffold CLI command
 */
 const scaffoldCommand = new Command("scaffold").description("Add features to existing projects");
-scaffoldCommand.command("list [projectPath]").description("List available scaffolding methods for a project or template").option("-t, --template <name>", "Template name (e.g., nextjs-15, typescript-mcp-package)").action(async (projectPath, options) => {
+scaffoldCommand.command("list [projectPath]").description("List available scaffolding methods for a project or template").option("-t, --template <name>", "Template name (e.g., nextjs-15, typescript-mcp-package)").option("-c, --cursor <cursor>", "Pagination cursor for next page").action(async (projectPath, options) => {
 	try {
 		if (!projectPath && !options.template) {
 			messages.error("Either projectPath or --template option must be provided");
@@ -615,10 +626,10 @@ scaffoldCommand.command("list [projectPath]").description("List available scaffo
 				messages.hint("For monorepo: ensure project.json exists with sourceTemplate field\nFor monolith: ensure toolkit.yaml exists at workspace root\nOr use --template option to list methods for a specific template");
 				process.exit(1);
 			}
-			result = await scaffoldingMethodsService.listScaffoldingMethods(absolutePath);
+			result = await scaffoldingMethodsService.listScaffoldingMethods(absolutePath, options.cursor);
 			displayName = projectPath;
 		} else {
-			result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate(options.template);
+			result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate(options.template, options.cursor);
 			displayName = `template: ${options.template}`;
 		}
 		const methods = result.methods;
@@ -633,6 +644,13 @@ scaffoldCommand.command("list [projectPath]").description("List available scaffo
 			if (method.variables_schema.required && method.variables_schema.required.length > 0) print.debug(`    Required: ${method.variables_schema.required.join(", ")}`);
 			print.newline();
 		}
+		if (result.nextCursor) {
+			print.newline();
+			print.info(`${icons.info} More results available. Use --cursor to fetch next page:`);
+			const cursorOption = `--cursor "${result.nextCursor}"`;
+			if (projectPath) print.debug(`  scaffold-mcp scaffold list ${projectPath} ${cursorOption}`);
+			else print.debug(`  scaffold-mcp scaffold list --template ${options.template} ${cursorOption}`);
+		}
 	} catch (error) {
 		messages.error("Error listing scaffolding methods:", error);
 		process.exit(1);
@@ -656,11 +674,17 @@ scaffoldCommand.command("add <featureName>").description("Add a feature to an ex
 		}
 		const templatesDir = await TemplatesManagerService.findTemplatesPath();
 		const scaffoldingMethodsService = new ScaffoldingMethodsService(new FileSystemService(), templatesDir);
-		const methods = (await scaffoldingMethodsService.listScaffoldingMethods(projectPath)).methods;
-		const method = methods.find((m) => m.name === featureName);
+		let allMethods = [];
+		let cursor;
+		do {
+			const listResult = await scaffoldingMethodsService.listScaffoldingMethods(projectPath, cursor);
+			allMethods = allMethods.concat(listResult.methods);
+			cursor = listResult.nextCursor;
+		} while (cursor);
+		const method = allMethods.find((m) => m.name === featureName);
 		if (!method) {
 			messages.error(`Scaffold method '${featureName}' not found.`);
-			print.warning(`Available methods: ${methods.map((m) => m.name).join(", ")}`);
+			print.warning(`Available methods: ${allMethods.map((m) => m.name).join(", ")}`);
 			print.debug(`Run 'scaffold-mcp scaffold list ${options.project}' to see all available methods`);
 			process.exit(1);
 		}
@@ -721,7 +745,8 @@ scaffoldCommand.command("info <featureName>").description("Show detailed informa
 		}
 		const templatesDir = await TemplatesManagerService.findTemplatesPath();
 		const scaffoldingMethodsService = new ScaffoldingMethodsService(new FileSystemService(), templatesDir);
-		let result;
+		let allMethods = [];
+		let cursor;
 		if (options.project) {
 			const projectPath = path.resolve(options.project);
 			if (!await ProjectConfigResolver.hasConfiguration(projectPath)) {
@@ -729,9 +754,17 @@ scaffoldCommand.command("info <featureName>").description("Show detailed informa
 				messages.hint("For monorepo: ensure project.json exists with sourceTemplate field\nFor monolith: ensure toolkit.yaml exists at workspace root\nOr use --template option to view info for a specific template");
 				process.exit(1);
 			}
-			result = await scaffoldingMethodsService.listScaffoldingMethods(projectPath);
-		} else result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate(options.template);
-		const method = result.methods.find((m) => m.name === featureName);
+			do {
+				const result = await scaffoldingMethodsService.listScaffoldingMethods(projectPath, cursor);
+				allMethods = allMethods.concat(result.methods);
+				cursor = result.nextCursor;
+			} while (cursor);
+		} else do {
+			const result = await scaffoldingMethodsService.listScaffoldingMethodsByTemplate(options.template, cursor);
+			allMethods = allMethods.concat(result.methods);
+			cursor = result.nextCursor;
+		} while (cursor);
+		const method = allMethods.find((m) => m.name === featureName);
 		if (!method) {
 			messages.error(`❌ Scaffold method '${featureName}' not found.`);
 			process.exit(1);

package/dist/index.cjs

@@ -1,5 +1,5 @@
 const require_chunk = require('./chunk-CUT6urMc.cjs');
-const require_stdio = require('./stdio-TGsG8akc.cjs');
+const require_stdio = require('./stdio-DM_C4xbZ.cjs');
 const require_ScaffoldConfigLoader = require('./ScaffoldConfigLoader-BrmvENTo.cjs');
 const require_ScaffoldService = require('./ScaffoldService-BwDmXt83.cjs');
 const require_TemplateService = require('./TemplateService-DRubcvS9.cjs');

package/dist/index.d.cts

@@ -108,6 +108,12 @@ interface UseBoilerplateRequest {
 }
 interface ListBoilerplateResponse {
   boilerplates: BoilerplateInfo[];
+  nextCursor?: string;
+  _meta?: {
+    total: number;
+    offset: number;
+    limit: number;
+  };
 }
 //#endregion
 //#region src/types/interfaces.d.ts
@@ -226,9 +232,11 @@ declare class BoilerplateService {
   private scaffoldService;
   constructor(templatesPath: string);
   /**
-   * Scans all scaffold.yaml files and returns available boilerplates
+   * Scans all scaffold.yaml files and returns available boilerplates with pagination
+   * @param cursor - Optional pagination cursor
+   * @returns Paginated list of boilerplates
    */
-  listBoilerplates(): Promise<ListBoilerplateResponse>;
+  listBoilerplates(cursor?: string): Promise<ListBoilerplateResponse>;
   /**
    * Dynamically discovers template directories by finding all directories
    * that contain both package.json and scaffold.yaml files
@@ -353,6 +361,12 @@ interface ListScaffoldingMethodsResult {
   sourceTemplate: string;
   templatePath: string;
   methods: ScaffoldMethod[];
+  nextCursor?: string;
+  _meta?: {
+    total: number;
+    offset: number;
+    limit: number;
+  };
 }
 interface UseScaffoldMethodRequest {
   projectPath: string;
@@ -364,12 +378,12 @@ declare class ScaffoldingMethodsService {
   private templatesRootPath;
   private templateService;
   constructor(fileSystem: IFileSystemService, templatesRootPath: string);
-  listScaffoldingMethods(projectPath: string): Promise<ListScaffoldingMethodsResult>;
-  listScaffoldingMethodsByTemplate(templateName: string): Promise<ListScaffoldingMethodsResult>;
+  listScaffoldingMethods(projectPath: string, cursor?: string): Promise<ListScaffoldingMethodsResult>;
+  listScaffoldingMethodsByTemplate(templateName: string, cursor?: string): Promise<ListScaffoldingMethodsResult>;
   /**
    * Gets scaffolding methods with instructions rendered using provided variables
    */
-  listScaffoldingMethodsWithVariables(projectPath: string, variables: Record<string, any>): Promise<ListScaffoldingMethodsResult>;
+  listScaffoldingMethodsWithVariables(projectPath: string, variables: Record<string, any>, cursor?: string): Promise<ListScaffoldingMethodsResult>;
   /**
    * Processes scaffold instruction with template service
    */
@@ -591,7 +605,7 @@ declare class ListBoilerplatesTool {
   /**
    * Execute the tool
    */
-  execute(_args?: Record<string, any>): Promise<CallToolResult>;
+  execute(args?: Record<string, any>): Promise<CallToolResult>;
 }
 //#endregion
 //#region src/tools/ListScaffoldingMethodsTool.d.ts

package/dist/index.d.ts

@@ -109,6 +109,12 @@ interface UseBoilerplateRequest {
 }
 interface ListBoilerplateResponse {
   boilerplates: BoilerplateInfo[];
+  nextCursor?: string;
+  _meta?: {
+    total: number;
+    offset: number;
+    limit: number;
+  };
 }
 //#endregion
 //#region src/types/interfaces.d.ts
@@ -227,9 +233,11 @@ declare class BoilerplateService {
   private scaffoldService;
   constructor(templatesPath: string);
   /**
-   * Scans all scaffold.yaml files and returns available boilerplates
+   * Scans all scaffold.yaml files and returns available boilerplates with pagination
+   * @param cursor - Optional pagination cursor
+   * @returns Paginated list of boilerplates
    */
-  listBoilerplates(): Promise<ListBoilerplateResponse>;
+  listBoilerplates(cursor?: string): Promise<ListBoilerplateResponse>;
   /**
    * Dynamically discovers template directories by finding all directories
    * that contain both package.json and scaffold.yaml files
@@ -354,6 +362,12 @@ interface ListScaffoldingMethodsResult {
   sourceTemplate: string;
   templatePath: string;
   methods: ScaffoldMethod[];
+  nextCursor?: string;
+  _meta?: {
+    total: number;
+    offset: number;
+    limit: number;
+  };
 }
 interface UseScaffoldMethodRequest {
   projectPath: string;
@@ -365,12 +379,12 @@ declare class ScaffoldingMethodsService {
   private templatesRootPath;
   private templateService;
   constructor(fileSystem: IFileSystemService, templatesRootPath: string);
-  listScaffoldingMethods(projectPath: string): Promise<ListScaffoldingMethodsResult>;
-  listScaffoldingMethodsByTemplate(templateName: string): Promise<ListScaffoldingMethodsResult>;
+  listScaffoldingMethods(projectPath: string, cursor?: string): Promise<ListScaffoldingMethodsResult>;
+  listScaffoldingMethodsByTemplate(templateName: string, cursor?: string): Promise<ListScaffoldingMethodsResult>;
   /**
    * Gets scaffolding methods with instructions rendered using provided variables
    */
-  listScaffoldingMethodsWithVariables(projectPath: string, variables: Record<string, any>): Promise<ListScaffoldingMethodsResult>;
+  listScaffoldingMethodsWithVariables(projectPath: string, variables: Record<string, any>, cursor?: string): Promise<ListScaffoldingMethodsResult>;
   /**
    * Processes scaffold instruction with template service
    */
@@ -592,7 +606,7 @@ declare class ListBoilerplatesTool {
   /**
    * Execute the tool
    */
-  execute(_args?: Record<string, any>): Promise<CallToolResult>;
+  execute(args?: Record<string, any>): Promise<CallToolResult>;
 }
 //#endregion
 //#region src/tools/ListScaffoldingMethodsTool.d.ts

package/dist/index.js

@@ -1,4 +1,4 @@
-import { BoilerplateGeneratorService, BoilerplateService, FileSystemService, GenerateBoilerplateFileTool, GenerateBoilerplateTool, GenerateFeatureScaffoldTool, HttpTransportHandler, ListBoilerplatesTool, ListScaffoldingMethodsTool, ScaffoldGeneratorService, ScaffoldingMethodsService, SseTransportHandler, StdioTransportHandler, UseBoilerplateTool, UseScaffoldMethodTool, WriteToFileTool } from "./stdio-Bxn4A1IU.js";
+import { BoilerplateGeneratorService, BoilerplateService, FileSystemService, GenerateBoilerplateFileTool, GenerateBoilerplateTool, GenerateFeatureScaffoldTool, HttpTransportHandler, ListBoilerplatesTool, ListScaffoldingMethodsTool, ScaffoldGeneratorService, ScaffoldingMethodsService, SseTransportHandler, StdioTransportHandler, UseBoilerplateTool, UseScaffoldMethodTool, WriteToFileTool } from "./stdio-BheRzmRj.js";
 import { ScaffoldConfigLoader } from "./ScaffoldConfigLoader-CI0T6zdG.js";
 import { ScaffoldProcessingService, ScaffoldService } from "./ScaffoldService-DB7-Cyod.js";
 import { TemplateService } from "./TemplateService-CiZJA06s.js";

package/dist/{stdio-Bxn4A1IU.js → stdio-BheRzmRj.js}

@@ -18,6 +18,56 @@ import express from "express";
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
+//#region src/utils/pagination.ts
+var PaginationHelper = class PaginationHelper {
+	/**
+	* Default page size for pagination
+	*/
+	static DEFAULT_PAGE_SIZE = 10;
+	/**
+	* Decodes a cursor string to extract the start index
+	* @param cursor - String representing the start index (e.g., "10")
+	* @returns Start index or 0 if invalid/undefined
+	*/
+	static decodeCursor(cursor) {
+		if (!cursor) return 0;
+		const index = Number.parseInt(cursor, 10);
+		if (Number.isNaN(index) || index < 0) return 0;
+		return index;
+	}
+	/**
+	* Encodes an index into a cursor string
+	* @param index - Start index to encode
+	* @returns Cursor string (e.g., "10")
+	*/
+	static encodeCursor(index) {
+		return index.toString();
+	}
+	/**
+	* Paginates an array of items
+	* @param items - All items to paginate
+	* @param cursor - Optional cursor representing the start index
+	* @param pageSize - Number of items per page (default: 10)
+	* @param includeMeta - Whether to include metadata in response (default: true)
+	* @returns Paginated result with items and optional nextCursor
+	*/
+	static paginate(items, cursor, pageSize = PaginationHelper.DEFAULT_PAGE_SIZE, includeMeta = true) {
+		const startIndex = PaginationHelper.decodeCursor(cursor);
+		const endIndex = startIndex + pageSize;
+		const result = {
+			items: items.slice(startIndex, endIndex),
+			nextCursor: endIndex < items.length ? PaginationHelper.encodeCursor(endIndex) : void 0
+		};
+		if (includeMeta) result._meta = {
+			total: items.length,
+			offset: startIndex,
+			limit: pageSize
+		};
+		return result;
+	}
+};
+
+//#endregion
 //#region src/services/FileSystemService.ts
 var FileSystemService = class {
 	async pathExists(path$2) {
@@ -59,9 +109,11 @@ var BoilerplateService = class {
 		this.scaffoldService = new ScaffoldService(fileSystemService, new ScaffoldConfigLoader(fileSystemService, this.templateService), new VariableReplacementService(fileSystemService, this.templateService), templatesPath);
 	}
 	/**
-	* Scans all scaffold.yaml files and returns available boilerplates
+	* Scans all scaffold.yaml files and returns available boilerplates with pagination
+	* @param cursor - Optional pagination cursor
+	* @returns Paginated list of boilerplates
 	*/
-	async listBoilerplates() {
+	async listBoilerplates(cursor) {
 		const boilerplates = [];
 		const templateDirs = await this.discoverTemplateDirectories();
 		for (const templatePath of templateDirs) {
@@ -88,7 +140,12 @@ var BoilerplateService = class {
 				log.warn(`Failed to load scaffold.yaml for ${templatePath}:`, error);
 			}
 		}
-		return { boilerplates };
+		const paginatedResult = PaginationHelper.paginate(boilerplates, cursor);
+		return {
+			boilerplates: paginatedResult.items,
+			nextCursor: paginatedResult.nextCursor,
+			_meta: paginatedResult._meta
+		};
 	}
 	/**
 	* Dynamically discovers template directories by finding all directories
@@ -175,9 +232,12 @@ var BoilerplateService = class {
 				const projectPath = path$1.join(targetFolder, folderName);
 				await ProjectConfigResolver.createProjectJson(projectPath, folderName, boilerplate.template_path);
 			}
+			const processedInstruction = boilerplate.instruction ? this.processBoilerplateInstruction(boilerplate.instruction, variables) : "";
+			let enhancedMessage = result.message;
+			if (processedInstruction) enhancedMessage += `\n\nPlease follow this **instruction**:\n${processedInstruction}`;
 			return {
 				success: result.success,
-				message: result.message,
+				message: enhancedMessage,
 				warnings: result.warnings,
 				createdFiles: result.createdFiles,
 				existingFiles: result.existingFiles
@@ -1223,7 +1283,10 @@ var ListBoilerplatesTool = class ListBoilerplatesTool {
 			description: description.trim(),
 			inputSchema: {
 				type: "object",
-				properties: {},
+				properties: { cursor: {
+					type: "string",
+					description: "Optional pagination cursor to fetch the next page of results. Omit to fetch the first page."
+				} },
 				additionalProperties: false
 			}
 		};
@@ -1231,9 +1294,10 @@ var ListBoilerplatesTool = class ListBoilerplatesTool {
 	/**
 	* Execute the tool
 	*/
-	async execute(_args = {}) {
+	async execute(args = {}) {
 		try {
-			const result = await this.boilerplateService.listBoilerplates();
+			const { cursor } = args;
+			const result = await this.boilerplateService.listBoilerplates(cursor);
 			return { content: [{
 				type: "text",
 				text: JSON.stringify(result, null, 2)
@@ -1263,12 +1327,12 @@ var ScaffoldingMethodsService = class {
 		this.templatesRootPath = templatesRootPath;
 		this.templateService = new TemplateService();
 	}
-	async listScaffoldingMethods(projectPath) {
+	async listScaffoldingMethods(projectPath, cursor) {
 		const absoluteProjectPath = path.resolve(projectPath);
 		const sourceTemplate = (await ProjectConfigResolver.resolveProjectConfig(absoluteProjectPath)).sourceTemplate;
-		return this.listScaffoldingMethodsByTemplate(sourceTemplate);
+		return this.listScaffoldingMethodsByTemplate(sourceTemplate, cursor);
 	}
-	async listScaffoldingMethodsByTemplate(templateName) {
+	async listScaffoldingMethodsByTemplate(templateName, cursor) {
 		const templatePath = await this.findTemplatePath(templateName);
 		if (!templatePath) throw new Error(`Template not found for sourceTemplate: ${templateName}`);
 		const fullTemplatePath = path.join(this.templatesRootPath, templatePath);
@@ -1292,17 +1356,20 @@ var ScaffoldingMethodsService = class {
 				generator: feature.generator
 			});
 		});
+		const paginatedResult = PaginationHelper.paginate(methods, cursor);
 		return {
 			sourceTemplate: templateName,
 			templatePath,
-			methods
+			methods: paginatedResult.items,
+			nextCursor: paginatedResult.nextCursor,
+			_meta: paginatedResult._meta
 		};
 	}
 	/**
 	* Gets scaffolding methods with instructions rendered using provided variables
 	*/
-	async listScaffoldingMethodsWithVariables(projectPath, variables) {
-		const result = await this.listScaffoldingMethods(projectPath);
+	async listScaffoldingMethodsWithVariables(projectPath, variables, cursor) {
+		const result = await this.listScaffoldingMethods(projectPath, cursor);
 		const processedMethods = result.methods.map((method) => ({
 			...method,
 			instruction: method.instruction ? this.processScaffoldInstruction(method.instruction, variables) : void 0
@@ -1414,7 +1481,7 @@ var ScaffoldingMethodsService = class {
 			success: true,
 			message: `
 Successfully scaffolded ${scaffold_feature_name} in ${projectPath}.
-Please follow this **instruction**: \n ${method.instruction}.
+Please follow this **instruction**: \n ${method.instruction ? this.processScaffoldInstruction(method.instruction, variables) : ""}.
 -> Create or update the plan based on the instruction.
 `,
 			warnings: result.warnings,
@@ -1443,7 +1510,10 @@ var ListScaffoldingMethodsTool = class ListScaffoldingMethodsTool {
 	*/
 	getDefinition() {
 		const description = this.templateService.renderString(description_default$1, { isMonolith: this.isMonolith });
-		const properties = {};
+		const properties = { cursor: {
+			type: "string",
+			description: "Optional pagination cursor to fetch the next page of results. Omit to fetch the first page."
+		} };
 		if (!this.isMonolith) {
 			properties.projectPath = {
 				type: "string",
@@ -1469,18 +1539,18 @@ var ListScaffoldingMethodsTool = class ListScaffoldingMethodsTool {
 	*/
 	async execute(args) {
 		try {
-			const { projectPath, templateName } = args;
+			const { projectPath, templateName, cursor } = args;
 			let result;
 			if (this.isMonolith) try {
 				const resolvedTemplateName = (await ProjectConfigResolver.resolveProjectConfig(process.cwd())).sourceTemplate;
-				result = await this.scaffoldingMethodsService.listScaffoldingMethodsByTemplate(resolvedTemplateName);
+				result = await this.scaffoldingMethodsService.listScaffoldingMethodsByTemplate(resolvedTemplateName, cursor);
 			} catch (error) {
 				throw new Error(`Failed to read template name from configuration: ${error instanceof Error ? error.message : String(error)}`);
 			}
 			else {
 				if (!projectPath && !templateName) throw new Error("Either projectPath or templateName must be provided");
-				if (projectPath) result = await this.scaffoldingMethodsService.listScaffoldingMethods(projectPath);
-				else result = await this.scaffoldingMethodsService.listScaffoldingMethodsByTemplate(templateName);
+				if (projectPath) result = await this.scaffoldingMethodsService.listScaffoldingMethods(projectPath, cursor);
+				else result = await this.scaffoldingMethodsService.listScaffoldingMethodsByTemplate(templateName, cursor);
 			}
 			return { content: [{
 				type: "text",

package/dist/{stdio-TGsG8akc.cjs → stdio-DM_C4xbZ.cjs}

@@ -28,6 +28,56 @@ __modelcontextprotocol_sdk_server_sse_js = require_chunk.__toESM(__modelcontextp
 let __modelcontextprotocol_sdk_server_stdio_js = require("@modelcontextprotocol/sdk/server/stdio.js");
 __modelcontextprotocol_sdk_server_stdio_js = require_chunk.__toESM(__modelcontextprotocol_sdk_server_stdio_js);
 
+//#region src/utils/pagination.ts
+var PaginationHelper = class PaginationHelper {
+	/**
+	* Default page size for pagination
+	*/
+	static DEFAULT_PAGE_SIZE = 10;
+	/**
+	* Decodes a cursor string to extract the start index
+	* @param cursor - String representing the start index (e.g., "10")
+	* @returns Start index or 0 if invalid/undefined
+	*/
+	static decodeCursor(cursor) {
+		if (!cursor) return 0;
+		const index = Number.parseInt(cursor, 10);
+		if (Number.isNaN(index) || index < 0) return 0;
+		return index;
+	}
+	/**
+	* Encodes an index into a cursor string
+	* @param index - Start index to encode
+	* @returns Cursor string (e.g., "10")
+	*/
+	static encodeCursor(index) {
+		return index.toString();
+	}
+	/**
+	* Paginates an array of items
+	* @param items - All items to paginate
+	* @param cursor - Optional cursor representing the start index
+	* @param pageSize - Number of items per page (default: 10)
+	* @param includeMeta - Whether to include metadata in response (default: true)
+	* @returns Paginated result with items and optional nextCursor
+	*/
+	static paginate(items, cursor, pageSize = PaginationHelper.DEFAULT_PAGE_SIZE, includeMeta = true) {
+		const startIndex = PaginationHelper.decodeCursor(cursor);
+		const endIndex = startIndex + pageSize;
+		const result = {
+			items: items.slice(startIndex, endIndex),
+			nextCursor: endIndex < items.length ? PaginationHelper.encodeCursor(endIndex) : void 0
+		};
+		if (includeMeta) result._meta = {
+			total: items.length,
+			offset: startIndex,
+			limit: pageSize
+		};
+		return result;
+	}
+};
+
+//#endregion
 //#region src/services/FileSystemService.ts
 var FileSystemService = class {
 	async pathExists(path$2) {
@@ -69,9 +119,11 @@ var BoilerplateService = class {
 		this.scaffoldService = new require_ScaffoldService.ScaffoldService(fileSystemService, new require_ScaffoldConfigLoader.ScaffoldConfigLoader(fileSystemService, this.templateService), new require_VariableReplacementService.VariableReplacementService(fileSystemService, this.templateService), templatesPath);
 	}
 	/**
-	* Scans all scaffold.yaml files and returns available boilerplates
+	* Scans all scaffold.yaml files and returns available boilerplates with pagination
+	* @param cursor - Optional pagination cursor
+	* @returns Paginated list of boilerplates
 	*/
-	async listBoilerplates() {
+	async listBoilerplates(cursor) {
 		const boilerplates = [];
 		const templateDirs = await this.discoverTemplateDirectories();
 		for (const templatePath of templateDirs) {
@@ -98,7 +150,12 @@ var BoilerplateService = class {
 				__agiflowai_aicode_utils.log.warn(`Failed to load scaffold.yaml for ${templatePath}:`, error);
 			}
 		}
-		return { boilerplates };
+		const paginatedResult = PaginationHelper.paginate(boilerplates, cursor);
+		return {
+			boilerplates: paginatedResult.items,
+			nextCursor: paginatedResult.nextCursor,
+			_meta: paginatedResult._meta
+		};
 	}
 	/**
 	* Dynamically discovers template directories by finding all directories
@@ -185,9 +242,12 @@ var BoilerplateService = class {
 				const projectPath = node_path.join(targetFolder, folderName);
 				await __agiflowai_aicode_utils.ProjectConfigResolver.createProjectJson(projectPath, folderName, boilerplate.template_path);
 			}
+			const processedInstruction = boilerplate.instruction ? this.processBoilerplateInstruction(boilerplate.instruction, variables) : "";
+			let enhancedMessage = result.message;
+			if (processedInstruction) enhancedMessage += `\n\nPlease follow this **instruction**:\n${processedInstruction}`;
 			return {
 				success: result.success,
-				message: result.message,
+				message: enhancedMessage,
 				warnings: result.warnings,
 				createdFiles: result.createdFiles,
 				existingFiles: result.existingFiles
@@ -1233,7 +1293,10 @@ var ListBoilerplatesTool = class ListBoilerplatesTool {
 			description: description.trim(),
 			inputSchema: {
 				type: "object",
-				properties: {},
+				properties: { cursor: {
+					type: "string",
+					description: "Optional pagination cursor to fetch the next page of results. Omit to fetch the first page."
+				} },
 				additionalProperties: false
 			}
 		};
@@ -1241,9 +1304,10 @@ var ListBoilerplatesTool = class ListBoilerplatesTool {
 	/**
 	* Execute the tool
 	*/
-	async execute(_args = {}) {
+	async execute(args = {}) {
 		try {
-			const result = await this.boilerplateService.listBoilerplates();
+			const { cursor } = args;
+			const result = await this.boilerplateService.listBoilerplates(cursor);
 			return { content: [{
 				type: "text",
 				text: JSON.stringify(result, null, 2)
@@ -1273,12 +1337,12 @@ var ScaffoldingMethodsService = class {
 		this.templatesRootPath = templatesRootPath;
 		this.templateService = new require_TemplateService.TemplateService();
 	}
-	async listScaffoldingMethods(projectPath) {
+	async listScaffoldingMethods(projectPath, cursor) {
 		const absoluteProjectPath = node_path.default.resolve(projectPath);
 		const sourceTemplate = (await __agiflowai_aicode_utils.ProjectConfigResolver.resolveProjectConfig(absoluteProjectPath)).sourceTemplate;
-		return this.listScaffoldingMethodsByTemplate(sourceTemplate);
+		return this.listScaffoldingMethodsByTemplate(sourceTemplate, cursor);
 	}
-	async listScaffoldingMethodsByTemplate(templateName) {
+	async listScaffoldingMethodsByTemplate(templateName, cursor) {
 		const templatePath = await this.findTemplatePath(templateName);
 		if (!templatePath) throw new Error(`Template not found for sourceTemplate: ${templateName}`);
 		const fullTemplatePath = node_path.default.join(this.templatesRootPath, templatePath);
@@ -1302,17 +1366,20 @@ var ScaffoldingMethodsService = class {
 				generator: feature.generator
 			});
 		});
+		const paginatedResult = PaginationHelper.paginate(methods, cursor);
 		return {
 			sourceTemplate: templateName,
 			templatePath,
-			methods
+			methods: paginatedResult.items,
+			nextCursor: paginatedResult.nextCursor,
+			_meta: paginatedResult._meta
 		};
 	}
 	/**
 	* Gets scaffolding methods with instructions rendered using provided variables
 	*/
-	async listScaffoldingMethodsWithVariables(projectPath, variables) {
-		const result = await this.listScaffoldingMethods(projectPath);
+	async listScaffoldingMethodsWithVariables(projectPath, variables, cursor) {
+		const result = await this.listScaffoldingMethods(projectPath, cursor);
 		const processedMethods = result.methods.map((method) => ({
 			...method,
 			instruction: method.instruction ? this.processScaffoldInstruction(method.instruction, variables) : void 0
@@ -1424,7 +1491,7 @@ var ScaffoldingMethodsService = class {
 			success: true,
 			message: `
 Successfully scaffolded ${scaffold_feature_name} in ${projectPath}.
-Please follow this **instruction**: \n ${method.instruction}.
+Please follow this **instruction**: \n ${method.instruction ? this.processScaffoldInstruction(method.instruction, variables) : ""}.
 -> Create or update the plan based on the instruction.
 `,
 			warnings: result.warnings,
@@ -1453,7 +1520,10 @@ var ListScaffoldingMethodsTool = class ListScaffoldingMethodsTool {
 	*/
 	getDefinition() {
 		const description = this.templateService.renderString(description_default$1, { isMonolith: this.isMonolith });
-		const properties = {};
+		const properties = { cursor: {
+			type: "string",
+			description: "Optional pagination cursor to fetch the next page of results. Omit to fetch the first page."
+		} };
 		if (!this.isMonolith) {
 			properties.projectPath = {
 				type: "string",
@@ -1479,18 +1549,18 @@ var ListScaffoldingMethodsTool = class ListScaffoldingMethodsTool {
 	*/
 	async execute(args) {
 		try {
-			const { projectPath, templateName } = args;
+			const { projectPath, templateName, cursor } = args;
 			let result;
 			if (this.isMonolith) try {
 				const resolvedTemplateName = (await __agiflowai_aicode_utils.ProjectConfigResolver.resolveProjectConfig(process.cwd())).sourceTemplate;
-				result = await this.scaffoldingMethodsService.listScaffoldingMethodsByTemplate(resolvedTemplateName);
+				result = await this.scaffoldingMethodsService.listScaffoldingMethodsByTemplate(resolvedTemplateName, cursor);
 			} catch (error) {
 				throw new Error(`Failed to read template name from configuration: ${error instanceof Error ? error.message : String(error)}`);
 			}
 			else {
 				if (!projectPath && !templateName) throw new Error("Either projectPath or templateName must be provided");
-				if (projectPath) result = await this.scaffoldingMethodsService.listScaffoldingMethods(projectPath);
-				else result = await this.scaffoldingMethodsService.listScaffoldingMethodsByTemplate(templateName);
+				if (projectPath) result = await this.scaffoldingMethodsService.listScaffoldingMethods(projectPath, cursor);
+				else result = await this.scaffoldingMethodsService.listScaffoldingMethodsByTemplate(templateName, cursor);
 			}
 			return { content: [{
 				type: "text",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@agiflowai/scaffold-mcp",
   "description": "MCP server for scaffolding applications with boilerplate templates",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "license": "AGPL-3.0",
   "author": "AgiflowIO",
   "repository": {
@@ -48,7 +48,7 @@
     "pino": "^10.0.0",
     "pino-pretty": "^13.1.1",
     "zod": "3.25.76",
-    "@agiflowai/aicode-utils": "1.0.1"
+    "@agiflowai/aicode-utils": "1.0.3"
   },
   "devDependencies": {
     "@types/express": "^5.0.0",