@salesforce/b2c-dx-mcp 0.0.1 → 0.3.2

package/dist/tools/cartridges/index.js

@@ -0,0 +1,101 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Cartridges toolset for B2C Commerce code operations.
+ *
+ * This toolset provides MCP tools for cartridge and code version management.
+ *
+ * @module tools/cartridges
+ */
+import { z } from 'zod';
+import { createToolAdapter, jsonResult } from '../adapter.js';
+import { findAndDeployCartridges } from '@salesforce/b2c-tooling-sdk/operations/code';
+import { getLogger } from '@salesforce/b2c-tooling-sdk/logging';
+/**
+ * Creates the cartridge_deploy tool.
+ *
+ * Deploys cartridges to a B2C Commerce instance via WebDAV:
+ * 1. Finds cartridges by `.project` files in the specified directory
+ * 2. Creates a zip archive of all cartridge directories
+ * 3. Uploads the zip to WebDAV and triggers server-side unzip
+ * 4. Optionally reloads the code version after deploy
+ *
+ * @param services - MCP services
+ * @param injections - Optional dependency injections for testing
+ * @returns The cartridge_deploy tool
+ */
+function createCartridgeDeployTool(services, injections) {
+    const findAndDeployCartridgesFn = injections?.findAndDeployCartridges || findAndDeployCartridges;
+    return createToolAdapter({
+        name: 'cartridge_deploy',
+        description: 'Finds and deploys cartridges to a B2C Commerce instance via WebDAV. ' +
+            'Searches the directory for cartridges (by .project files), applies include/exclude filters, ' +
+            'creates a zip archive, uploads via WebDAV, and optionally reloads the code version. ' +
+            'Use this tool to deploy custom code cartridges for SFRA or other B2C Commerce code. ' +
+            'Requires the instance to have a code version configured.',
+        toolsets: ['CARTRIDGES'],
+        isGA: false,
+        requiresInstance: true,
+        inputSchema: {
+            directory: z
+                .string()
+                .optional()
+                .describe('Path to directory to search for cartridges. Defaults to current working directory if not specified. ' +
+                'The tool will recursively search this directory for .project files to identify cartridges.'),
+            cartridges: z
+                .array(z.string())
+                .optional()
+                .describe('Array of cartridge names to include in the deployment. If not specified, all cartridges found in the directory are deployed. ' +
+                'Use this to selectively deploy specific cartridges when you have multiple cartridges but only want to update some.'),
+            exclude: z
+                .array(z.string())
+                .optional()
+                .describe('Array of cartridge names to exclude from the deployment. Use this to skip deploying certain cartridges, ' +
+                'such as third-party or unchanged cartridges. Applied after the include filter.'),
+            reload: z
+                .boolean()
+                .optional()
+                .describe('Whether to reload (re-activate) the code version after deployment. ' +
+                'Set to true to make the deployed code immediately active on the instance. ' +
+                'Defaults to false. Use this when you want changes to take effect right away.'),
+        },
+        async execute(args, context) {
+            // Get instance from context (guaranteed by adapter when requiresInstance is true)
+            const instance = context.b2cInstance;
+            // Default directory to current directory
+            const directory = args.directory || '.';
+            // Parse options
+            const options = {
+                include: args.cartridges,
+                exclude: args.exclude,
+                reload: args.reload,
+            };
+            // Log all computed variables before deploying
+            const logger = getLogger();
+            logger.debug({
+                directory,
+                include: options.include,
+                exclude: options.exclude,
+                reload: options.reload,
+            }, '[Cartridges] Deploying cartridges with computed options');
+            // Deploy cartridges
+            const result = await findAndDeployCartridgesFn(instance, directory, options);
+            return result;
+        },
+        formatOutput: (output) => jsonResult(output),
+    }, services);
+}
+/**
+ * Creates all tools for the CARTRIDGES toolset.
+ *
+ * @param services - MCP services
+ * @param injections - Optional dependency injections for testing
+ * @returns Array of MCP tools
+ */
+export function createCartridgesTools(services, injections) {
+    return [createCartridgeDeployTool(services, injections)];
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP Tools for B2C Commerce developer experience.
+ *
+ * This module exports all available tools and utilities.
+ * Tools use the @salesforce/b2c-tooling-sdk operations layer directly.
+ *
+ * > ⚠️ **PLACEHOLDER - ACTIVE DEVELOPMENT**
+ * > Tools are currently placeholder implementations that return mock responses.
+ * > Actual implementations are coming soon. Use `--allow-non-ga-tools` flag to enable.
+ *
+ * @module tools
+ */
+export * from './adapter.js';
+export * from './cartridges/index.js';
+export * from './mrt/index.js';
+export * from './pwav3/index.js';
+export * from './storefrontnext/index.js';

package/dist/tools/index.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * MCP Tools for B2C Commerce developer experience.
+ *
+ * This module exports all available tools and utilities.
+ * Tools use the @salesforce/b2c-tooling-sdk operations layer directly.
+ *
+ * > ⚠️ **PLACEHOLDER - ACTIVE DEVELOPMENT**
+ * > Tools are currently placeholder implementations that return mock responses.
+ * > Actual implementations are coming soon. Use `--allow-non-ga-tools` flag to enable.
+ *
+ * @module tools
+ */
+// Tool adapter utilities
+export * from './adapter.js';
+// Toolset exports
+export * from './cartridges/index.js';
+export * from './mrt/index.js';
+export * from './pwav3/index.js';
+export * from './storefrontnext/index.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/mrt/index.d.ts

@@ -0,0 +1,20 @@
+import type { McpTool } from '../../utils/index.js';
+import type { Services } from '../../services.js';
+import type { PushResult, PushOptions } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+import type { AuthStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+/**
+ * Optional dependency injections for testing.
+ */
+interface MrtToolInjections {
+    /** Mock pushBundle function for testing */
+    pushBundle?: (options: PushOptions, auth: AuthStrategy) => Promise<PushResult>;
+}
+/**
+ * Creates all tools for the MRT toolset.
+ *
+ * @param services - MCP services
+ * @param injections - Optional dependency injections for testing
+ * @returns Array of MCP tools
+ */
+export declare function createMrtTools(services: Services, injections?: MrtToolInjections): McpTool[];
+export {};

package/dist/tools/mrt/index.js

@@ -0,0 +1,101 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * MRT (Managed Runtime) toolset for B2C Commerce.
+ *
+ * This toolset provides MCP tools for Managed Runtime operations.
+ *
+ * @module tools/mrt
+ */
+import { z } from 'zod';
+import { createToolAdapter, jsonResult } from '../adapter.js';
+import { pushBundle } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+import { getLogger } from '@salesforce/b2c-tooling-sdk/logging';
+/**
+ * Creates the mrt_bundle_push tool.
+ *
+ * Creates a bundle from a pre-built PWA Kit project and pushes it to
+ * Managed Runtime (MRT). Optionally deploys to a target environment after push.
+ * Expects the project to already be built (e.g., `npm run build` completed).
+ * Shared across MRT, PWAV3, and STOREFRONTNEXT toolsets.
+ *
+ * @param services - MCP services
+ * @param injections - Optional dependency injections for testing
+ * @returns The mrt_bundle_push tool
+ */
+function createMrtBundlePushTool(services, injections) {
+    const pushBundleFn = injections?.pushBundle || pushBundle;
+    return createToolAdapter({
+        name: 'mrt_bundle_push',
+        description: 'Bundle a pre-built PWA Kit project and push to Managed Runtime. Optionally deploy to a target environment.',
+        toolsets: ['MRT', 'PWAV3', 'STOREFRONTNEXT'],
+        isGA: false,
+        // MRT operations use ApiKeyStrategy from SFCC_MRT_API_KEY or ~/.mobify
+        requiresMrtAuth: true,
+        inputSchema: {
+            buildDirectory: z.string().optional().describe('Path to build directory (default: ./build)'),
+            message: z.string().optional().describe('Deployment message'),
+            ssrOnly: z
+                .string()
+                .optional()
+                .describe('Glob patterns for server-only files, comma-separated (default: ssr.js,ssr.mjs,server/**/*)'),
+            ssrShared: z
+                .string()
+                .optional()
+                .describe('Glob patterns for shared files, comma-separated (default: static/**/*,client/**/*)'),
+        },
+        async execute(args, context) {
+            // Get project from --project flag (required)
+            const project = context.mrtConfig?.project;
+            if (!project) {
+                throw new Error('MRT project error: Project is required. Provide --project flag or set SFCC_MRT_PROJECT environment variable.');
+            }
+            // Get environment from --environment flag (optional)
+            const environment = context.mrtConfig?.environment;
+            // Get origin from --cloud-origin flag or mrtOrigin config (optional)
+            const origin = context.mrtConfig?.origin;
+            // Parse comma-separated glob patterns (same as CLI defaults)
+            const ssrOnly = (args.ssrOnly || 'ssr.js,ssr.mjs,server/**/*').split(',').map((s) => s.trim());
+            const ssrShared = (args.ssrShared || 'static/**/*,client/**/*').split(',').map((s) => s.trim());
+            const buildDirectory = args.buildDirectory || './build';
+            // Log all computed variables before pushing bundle
+            const logger = getLogger();
+            logger.debug({
+                project,
+                environment,
+                origin,
+                buildDirectory,
+                message: args.message,
+                ssrOnly,
+                ssrShared,
+            }, '[MRT] Pushing bundle with computed options');
+            // Push bundle to MRT
+            // Note: auth is guaranteed to be present by the adapter when requiresMrtAuth is true
+            const result = await pushBundleFn({
+                projectSlug: project,
+                buildDirectory,
+                ssrOnly, // files that run only on SSR server (never sent to browser)
+                ssrShared, // files served from CDN and also available to SSR
+                message: args.message,
+                target: environment,
+                origin, // MRT API origin URL (optional, defaults to https://cloud.mobify.com)
+            }, context.mrtConfig.auth);
+            return result;
+        },
+        formatOutput: (output) => jsonResult(output),
+    }, services);
+}
+/**
+ * Creates all tools for the MRT toolset.
+ *
+ * @param services - MCP services
+ * @param injections - Optional dependency injections for testing
+ * @returns Array of MCP tools
+ */
+export function createMrtTools(services, injections) {
+    return [createMrtBundlePushTool(services, injections)];
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/pwav3/index.d.ts

@@ -0,0 +1,13 @@
+import type { McpTool } from '../../utils/index.js';
+import type { Services } from '../../services.js';
+/**
+ * Creates all tools for the PWAV3 toolset.
+ *
+ * Note: mrt_bundle_push is defined in the MRT toolset with
+ * toolsets: ["MRT", "PWAV3", "STOREFRONTNEXT"] and will
+ * automatically appear in PWAV3.
+ *
+ * @param services - MCP services
+ * @returns Array of MCP tools
+ */
+export declare function createPwav3Tools(services: Services): McpTool[];

package/dist/tools/pwav3/index.js

@@ -0,0 +1,78 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * PWA Kit v3 toolset for B2C Commerce.
+ *
+ * This toolset provides MCP tools for PWA Kit v3 development.
+ *
+ * > ⚠️ **PLACEHOLDER - ACTIVE DEVELOPMENT**
+ * > Tools in this module are placeholder implementations that return mock responses.
+ * > Actual implementations are coming soon. Use `--allow-non-ga-tools` flag to enable.
+ *
+ * @module tools/pwav3
+ */
+import { z } from 'zod';
+import { createToolAdapter, jsonResult } from '../adapter.js';
+/**
+ * Creates a placeholder tool for PWA Kit development.
+ *
+ * Placeholder tools log invocations and return mock responses until
+ * the actual implementation is available.
+ *
+ * @param name - Tool name
+ * @param description - Tool description
+ * @param toolsets - Toolsets this tool belongs to
+ * @param services - MCP services
+ * @returns The configured MCP tool
+ */
+function createPlaceholderTool(name, description, toolsets, services) {
+    return createToolAdapter({
+        name,
+        description: `[PLACEHOLDER] ${description}`,
+        toolsets,
+        isGA: false,
+        requiresInstance: false,
+        inputSchema: {
+            message: z.string().optional().describe('Optional message to echo'),
+        },
+        async execute(args) {
+            // Placeholder implementation
+            const timestamp = new Date().toISOString();
+            return {
+                tool: name,
+                status: 'placeholder',
+                message: `This is a placeholder implementation for '${name}'. The actual implementation is coming soon.`,
+                input: args,
+                timestamp,
+            };
+        },
+        formatOutput: (output) => jsonResult(output),
+    }, services);
+}
+/**
+ * Creates all tools for the PWAV3 toolset.
+ *
+ * Note: mrt_bundle_push is defined in the MRT toolset with
+ * toolsets: ["MRT", "PWAV3", "STOREFRONTNEXT"] and will
+ * automatically appear in PWAV3.
+ *
+ * @param services - MCP services
+ * @returns Array of MCP tools
+ */
+export function createPwav3Tools(services) {
+    return [
+        // PWA Kit development tools
+        createPlaceholderTool('pwakit_create_storefront', 'Create a new PWA Kit storefront project', ['PWAV3'], services),
+        createPlaceholderTool('pwakit_create_page', 'Create a new page component in PWA Kit project', ['PWAV3'], services),
+        createPlaceholderTool('pwakit_create_component', 'Create a new React component in PWA Kit project', ['PWAV3'], services),
+        createPlaceholderTool('pwakit_get_dev_guidelines', 'Get PWA Kit development guidelines and best practices', ['PWAV3'], services),
+        createPlaceholderTool('pwakit_recommend_hooks', 'Recommend appropriate React hooks for PWA Kit use cases', ['PWAV3'], services),
+        createPlaceholderTool('pwakit_run_site_test', 'Run site tests for PWA Kit project', ['PWAV3'], services),
+        createPlaceholderTool('pwakit_install_agent_rules', 'Install AI agent rules for PWA Kit development', ['PWAV3'], services),
+        createPlaceholderTool('pwakit_explore_scapi_shop_api', 'Explore SCAPI Shop API endpoints and capabilities', ['PWAV3'], services),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/scapi/index.d.ts

@@ -0,0 +1,9 @@
+import type { McpTool } from '../../utils/index.js';
+import type { Services } from '../../services.js';
+/**
+ * Creates all tools for the SCAPI toolset.
+ *
+ * @param services - MCP services
+ * @returns Array of MCP tools
+ */
+export declare function createScapiTools(services: Services): McpTool[];

package/dist/tools/scapi/index.js

@@ -0,0 +1,68 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * SCAPI toolset for B2C Commerce.
+ *
+ * This toolset provides MCP tools for Salesforce Commerce API (SCAPI) discovery and exploration.
+ *
+ * > ⚠️ **PLACEHOLDER - ACTIVE DEVELOPMENT**
+ * > Tools in this module are placeholder implementations that return mock responses.
+ * > Actual implementations are coming soon. Use `--allow-non-ga-tools` flag to enable.
+ *
+ * @module tools/scapi
+ */
+import { z } from 'zod';
+import { createToolAdapter, jsonResult } from '../adapter.js';
+/**
+ * Creates a placeholder tool for SCAPI operations.
+ *
+ * Placeholder tools log invocations and return mock responses until
+ * the actual implementation is available.
+ *
+ * @param name - Tool name
+ * @param description - Tool description
+ * @param toolsets - Toolsets this tool belongs to
+ * @param services - MCP services
+ * @returns The configured MCP tool
+ */
+function createPlaceholderTool(name, description, toolsets, services) {
+    return createToolAdapter({
+        name,
+        description: `[PLACEHOLDER] ${description}`,
+        toolsets,
+        isGA: false,
+        requiresInstance: true,
+        inputSchema: {
+            message: z.string().optional().describe('Optional message to echo'),
+        },
+        async execute(args) {
+            // Placeholder implementation
+            const timestamp = new Date().toISOString();
+            return {
+                tool: name,
+                status: 'placeholder',
+                message: `This is a placeholder implementation for '${name}'. The actual implementation is coming soon.`,
+                input: args,
+                timestamp,
+            };
+        },
+        formatOutput: (output) => jsonResult(output),
+    }, services);
+}
+/**
+ * Creates all tools for the SCAPI toolset.
+ *
+ * @param services - MCP services
+ * @returns Array of MCP tools
+ */
+export function createScapiTools(services) {
+    return [
+        createPlaceholderTool('scapi_discovery', 'Discover available SCAPI endpoints and capabilities', ['PWAV3', 'SCAPI', 'STOREFRONTNEXT'], services),
+        createPlaceholderTool('scapi_customapi_scaffold', 'Scaffold a new custom SCAPI API', ['SCAPI'], services),
+        createPlaceholderTool('scapi_custom_api_discovery', 'Discover custom SCAPI API endpoints', ['PWAV3', 'SCAPI', 'STOREFRONTNEXT'], services),
+    ];
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/storefrontnext/developer-guidelines.d.ts

@@ -0,0 +1,9 @@
+import type { McpTool } from '../../utils/index.js';
+import type { Services } from '../../services.js';
+/**
+ * Creates the developer guidelines tool for Storefront Next.
+ *
+ * @param services - MCP services
+ * @returns The configured MCP tool
+ */
+export declare function createDeveloperGuidelinesTool(services: Services): McpTool;

package/dist/tools/storefrontnext/developer-guidelines.js

@@ -0,0 +1,140 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Developer Guidelines tool for Storefront Next.
+ *
+ * Provides critical development guidelines and best practices for building
+ * Storefront Next applications with React Server Components.
+ *
+ * @module tools/storefrontnext/developer-guidelines
+ */
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { z } from 'zod';
+import { createToolAdapter, textResult } from '../adapter.js';
+// Resolve the content directory from the package root
+// Uses createRequire to find the package.json location, which is robust
+// regardless of where this module is located in the build output
+const require = createRequire(import.meta.url);
+const packageRoot = path.dirname(require.resolve('@salesforce/b2c-dx-mcp/package.json'));
+const CONTENT_DIR = path.join(packageRoot, 'content');
+/**
+ * Section metadata with key and optional description.
+ * Single source of truth for all available sections.
+ */
+const SECTIONS_METADATA = [
+    { key: 'quick-reference', description: null }, // Meta-section, excluded from topics list
+    {
+        key: 'data-fetching',
+        description: 'server-only data loading (no client loaders), synchronous loaders for streaming, data fetching patterns',
+    },
+    { key: 'state-management', description: 'state management patterns' },
+    { key: 'auth', description: 'authentication and session management' },
+    { key: 'config', description: 'configuration' },
+    { key: 'i18n', description: 'i18n patterns and internationalization' },
+    { key: 'components', description: 'component best practices' },
+    { key: 'styling', description: 'Tailwind CSS 4, Shadcn/ui, styling guidelines' },
+    { key: 'page-designer', description: 'Page Designer integration' },
+    { key: 'performance', description: 'performance optimization' },
+    { key: 'testing', description: 'testing strategies' },
+    { key: 'extensions', description: 'framework extensions' },
+    { key: 'pitfalls', description: 'common pitfalls' },
+];
+/**
+ * Derived: array of section keys for validation.
+ */
+const _SECTIONS = SECTIONS_METADATA.map((s) => s.key);
+/**
+ * Generates the topics list for the tool description.
+ * Excludes meta-sections (like quick-reference) that don't have descriptions.
+ * @returns Comma-separated list of topics
+ */
+function generateTopicsList() {
+    return SECTIONS_METADATA.filter((s) => s.description !== null)
+        .map((s) => s.description)
+        .join(', ');
+}
+/**
+ * Detailed section content loaded from markdown files.
+ * Built dynamically from SECTIONS_METADATA to avoid duplication.
+ */
+const SECTION_CONTENT = Object.fromEntries(SECTIONS_METADATA.map((section) => {
+    const filename = `${section.key}.md`;
+    const filePath = path.join(CONTENT_DIR, filename);
+    const content = readFileSync(filePath, 'utf8');
+    return [section.key, content];
+}));
+/**
+ * Default sections to return when no sections are specified.
+ * Includes quick-reference plus the most critical detailed sections
+ * to provide comprehensive guidelines by default.
+ */
+const DEFAULT_SECTIONS = ['quick-reference', 'data-fetching', 'components', 'testing'];
+/**
+ * Creates the developer guidelines tool for Storefront Next.
+ *
+ * @param services - MCP services
+ * @returns The configured MCP tool
+ */
+export function createDeveloperGuidelinesTool(services) {
+    return createToolAdapter({
+        name: 'storefront_next_development_guidelines',
+        description: 'ESSENTIAL FIRST STEP for Storefront Next development. Returns critical architecture rules, coding standards, and best practices. ' +
+            'Use this tool FIRST before writing any Storefront Next code to understand non-negotiable patterns for React Server Components, ' +
+            'data loading, and framework constraints. Returns comprehensive guidelines by default (quick-reference + key sections); ' +
+            'supports retrieving specific topic sections. ' +
+            'CRITICAL INSTRUCTION: ALWAYS present ALL returned content in FULL - DO NOT SUMMARIZE, DO NOT ADD SUMMARIES, ' +
+            'DO NOT ADD OVERVIEWS. The returned content IS the complete answer - display it exactly as provided.',
+        toolsets: ['STOREFRONTNEXT'],
+        isGA: false,
+        requiresInstance: false,
+        inputSchema: {
+            sections: z
+                .array(z.enum([..._SECTIONS]))
+                .optional()
+                .describe('Optional array of specific sections to retrieve. If not specified, returns comprehensive guidelines ' +
+                '(quick-reference, data-fetching, components, testing). ' +
+                'CRITICAL: Present ALL returned content in FULL - DO NOT SUMMARIZE. ' +
+                'Available sections: quick-reference, data-fetching, state-management, auth, config, i18n, ' +
+                'components, page-designer, performance, testing, extensions, pitfalls. ' +
+                `Topics covered: ${generateTopicsList()}. ` +
+                'Content is complete - present exactly as provided, no summaries.'),
+        },
+        async execute(args) {
+            // Handle empty array case explicitly
+            if (args.sections && args.sections.length === 0) {
+                return '';
+            }
+            // Default to comprehensive set of key sections if no sections specified
+            const sections = args.sections || DEFAULT_SECTIONS;
+            // Multiple sections: combine with separators
+            const combinedContent = sections.map((section) => SECTION_CONTENT[section]).join('\n\n---\n\n');
+            // Apply instructions for all multi-section responses to ensure full content display
+            // Single sections are typically smaller and don't need heavy instructions
+            const isMultiSection = sections.length > 1;
+            // Prepend explicit instruction to present full content (not summarized)
+            // This helps AI assistants understand they should show the complete guidelines without summarization
+            const fullContentInstruction = isMultiSection
+                ? '⚠️ CRITICAL: Display the FULL content below. DO NOT summarize, condense, or add overviews.\n\n' +
+                    '📋 STOREFRONT NEXT DEVELOPMENT GUIDELINES\n\n' +
+                    '---\n\n'
+                : '';
+            // Add footer instruction to reinforce the message for multi-section responses
+            const footerInstruction = isMultiSection
+                ? '\n\n---\n\n⚠️ END OF CONTENT - Full content displayed above. Do not add summaries.\n'
+                : '';
+            // For single sections, return directly (backward compatible)
+            // For multiple sections, wrap with instructions
+            if (sections.length === 1) {
+                return SECTION_CONTENT[sections[0]];
+            }
+            return fullContentInstruction + combinedContent + footerInstruction;
+        },
+        formatOutput: (output) => textResult(output),
+    }, services);
+}
+//# sourceMappingURL=developer-guidelines.js.map

package/dist/tools/storefrontnext/index.d.ts

@@ -0,0 +1,13 @@
+import type { McpTool } from '../../utils/index.js';
+import type { Services } from '../../services.js';
+/**
+ * Creates all tools for the STOREFRONTNEXT toolset.
+ *
+ * Note: mrt_bundle_push is defined in the MRT toolset with
+ * toolsets: ["MRT", "PWAV3", "STOREFRONTNEXT"] and will
+ * automatically appear in STOREFRONTNEXT.
+ *
+ * @param services - MCP services
+ * @returns Array of MCP tools
+ */
+export declare function createStorefrontNextTools(services: Services): McpTool[];